suzanne.soy/hyper-literate
1
0
Fork 0
Code Issues 4 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

scribble: fix `--redirect{-main}' and non-HTML mode

Browse Source 
original commit: 4ac6a6b3e3d381bc0e20ecb19258cf8b520a8437
This commit is contained in:
Matthew Flatt 2013-05-07 10:03:53 -04:00
parent 8a3c287eb6
commit 76a79e3536
2 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
collects/scribble/run.rkt
View File

@ -14,6 +14,7 @@
(lambda (%) (html:render-multi-mixin (html:render-mixin %))))
(define current-render-mixin (make-parameter text:render-mixin))
(define current-html (make-parameter #f))
(define current-dest-directory (make-parameter #f))
(define current-dest-name (make-parameter #f))
(define current-info-output-file (make-parameter #f))
@ -41,8 +42,10 @@
#:program (short-program+command-name)
#:once-any
[("--html") "generate HTML-format output file (the default)"
(current-html #t)
(current-render-mixin html:render-mixin)]
[("--htmls") "generate HTML-format output directory"
(current-html #t)
(current-render-mixin multi-html:render-mixin)]
[("--latex") "generate LaTeX-format output"
(current-render-mixin latex:render-mixin)]
@ -129,8 +132,8 @@
#:style-extra-files (reverse (current-style-extra-files))
#:extra-files (reverse (current-extra-files))
#:helper-file-prefix (helper-file-prefix)
#:redirect (current-redirect)
#:redirect-main (current-redirect-main)
#:redirect (and (current-html) (current-redirect))
#:redirect-main (and (current-html) (current-redirect-main))
#:quiet? (current-quiet)
#:info-in-files (reverse (current-info-input-files))
#:xrefs (for/list ([mod+id (in-list (reverse (current-xref-input-modules)))])

5
collects/scribblings/scribble/running.scrbl
View File

@ -129,15 +129,16 @@ information for all installed documentation, and @PFlag{m} or
@DPFlag{main-xref-in} is just a shorthand for @exec{++xref-in
setup/xref load-collections-xref}.
The @DFlag{redirect-main} flag redirects links to the local
The @DFlag{redirect-main} flag for HTML output redirects links to the local
installation's documentation to a given URL, such as
@tt{http://docs.racket-lang.org/}. Beware that documentation links
sometimes change (although Scribble generates HTML paths and anchors
in a relatively stable way), so
@tt{http://download.racket-lang.org/docs/@italic{version}/html/} may be
more reliable when building with an installation for @italic{version}.
The @DFlag{redirect-main} flag is ignored for non-HTML output.
The @DFlag{redirect} flag is similar to @DFlag{redirect-main}, except
The @DFlag{redirect} flag is like @DFlag{redirect-main}, except
that it builds on the given URL to indicate a cross-reference tag that
is more stable than an HTML path and anchor (in case the documentation
for a function changes sections, for example). No server currently