summaryrefslogtreecommitdiff
path: root/doc/build.scm
Commit message (Expand)AuthorAgeFilesLines
* doc: Syntax highlighting now handles @var within @lisp.•••* doc/build.scm (syntax-highlighted-html)[build](concatenate-pieces): Handle @var{name}. Ludovic Courtès2020-09-041-0/+2
* doc: Remove one use of 'file-append*'.•••* doc/build.scm (texinfo-manual-source)[build]: Use 'file-append', not 'file-append*', for 'htmlxref.cnf', to ensure it has the right basename. Ludovic Courtès2020-05-251-1/+1
* doc: Inherit md5.scm fix in custom 'guile-lib' variant.•••* doc/build.scm (guile-lib/htmlprag-fixed)[source]: Remove. [arguments]: Add 'fix-htmlprag' phase. Ludovic Courtès2020-05-181-20/+17
* doc: Fix building the cookbook.•••Fixes <https://debbugs.gnu.org/cgi/bugreport.cgi?bug=40803>. Reported by "operator.name" <operator.name@protonmail.com>. * doc/build.scm (%languages): Add smaller list for the cookbook. (syntax-highlighted-html): Adapt regexp for mono-node files to include the cookbook. Björn Höfling2020-05-021-2/+8
* doc: Include *.json files in the source.•••This is a followup to c9f321e52a99dea93fcc099372ea0167150b9aac. * doc/build.scm (texinfo-manual-source)[build]: Add *.json to #$output. Ludovic Courtès2020-04-211-1/+1
* doc: Improve anchor collection.•••This allows us to catch "operating_002dsystem-1", for instance. * doc/build.scm (syntax-highlighted-html)[build](anchor-id->key): Drop "-1" & co. from ID. Ludovic Courtès2020-04-131-3/+9
* doc: Avoid invalid 'match' pattern in 'syntax-highlighted-html'.•••This is a followup to da9deba13d551e316f5a99a614834efa27ddc7d1. Last-minute modification of the 'match' pattern would lead to an error: "multiple ellipsis patterns not allowed at same level" * doc/build.scm (syntax-highlighted-html)[build](collect-anchors): Add 'worthy-entry?' procedure and use it instead of the unsupported pattern for ('dt ...). Ludovic Courtès2020-04-131-7/+16
* doc: Emit hyperlinks in HTML output for @lisp snippets.•••This makes it easier to jump to the definition of a procedure or variable when looking at a code snippet. There can be false-positive because scoping rules are ignored, for example, but it should be a good approximation. * doc/build.scm (syntax-highlighted-html)[build](highlights->sxml*): Add 'anchors' parameter. Add clause for ('symbol text). (syntax-highlight): Add 'anchors' parameter. Wrap body in named let and use it in recursive calls. Pass ANCHORS to 'highlights->sxml*'. (underscore-decode, anchor-id->key, collect-anchors, html?): New procedures. (process-file): Add 'anchors' parameter. and honor it. Rewrite mono-node and multi-node HTML files separately. Ludovic Courtès2020-04-131-33/+130
* doc: Make sure 'htmlxref.cnf' is honored.•••Fixes <https://bugs.gnu.org/39060>. Reported by Tobias Geerinckx-Rice <me@tobias.gr>. * doc/build.scm (html-manual)[build]: Copy 'htmlxref.cnf' to the current directory so that 'makeinfo' honors it. Ludovic Courtès2020-01-121-1/+6
* doc: Handle right arrows in 'syntax-highlighted-html'.•••* doc/build.scm (syntax-highlighted-html)[build](entity->string): Add "rarr". Ludovic Courtès2019-11-281-0/+1
* doc: Use the right title in HTML indices for the cookbook.•••* doc/build.scm (html-manual-indexes): Add #:title. [build]: Replace "GNU Guix Reference Manual" by references to TITLE. Ludovic Courtès2019-10-221-4/+6
* doc: More responsive online manual.•••* doc/build.scm (%makeinfo-html-options): Add viewport to all generated html pages for better mobile device support. Julien Lepiller2019-10-211-1/+3
* doc: Add support for "guix-cookbook.texi" to 'build.scm'.•••* doc/build.scm (%manual): New variable. (html-manual): #:manual now defaults to %MANUAL. [build]: Define 'language->texi-file-name' and use it. Filter out items of LANGUAGES that lack a .texi file. (pdf-manual, html-manual-indexes, pdf+html-manual): #:manual now defaults to %MANUAL. Ludovic Courtès2019-10-211-13/+24
* doc: Support paren matching via CSS hover.•••* doc/build.scm (syntax-highlighted-html)[build](pair-open/close) (highlights->sxml*): New procedures. (syntax-highlight): Use 'highlights->sxml*'. Ludovic Courtès2019-09-251-3/+56
* doc: Work around (htmlprag) parser issue.•••* doc/build.scm (guile-lib/htmlprag-fixed): New variable. (syntax-highlighted-html): Use it instead of GUILE-LIB. Ludovic Courtès2019-09-071-1/+31
* doc: Highlight Scheme syntax in the HTML output.•••* doc/build.scm (syntax-highlighted-html): New procedure. (html-manual): Use it. Ludovic Courtès2019-09-071-1/+114
* doc: Add 'images' directory next to HTML pages.•••* doc/build.scm (html-manual): Add images/ symlinks. Ludovic Courtès2019-07-161-1/+12
* doc: Build a top-level index of the manuals.•••Suggested by Julien Lepiller. * doc/build.scm (html-manual-indexes)[build]: Add 'with-extensions'. (translate): Actually honor DOMAIN. Add call to 'bindtextdomain' for ISO-CODES. (%iso639-languages): New variable. (language-code->name, top-level-index): New procedures. Add call to 'write-html' for OUTPUT/index.html. Ludovic Courtès2019-07-151-156/+204
* doc: Generalize build procedures of HTML indexes.•••* doc/build.scm (html-manual-indexes)[build](sxml-index): Generalize; add a 'title' and a 'body' parameter and honor them. (language-index): New procedure. (write-index): Remove. (write-html): New procedure. Use 'write-html' and 'language-index'. Ludovic Courtès2019-07-151-41/+45
* build: Add 'doc/build.scm' to build on-line copies of the manual.•••* doc/build.scm: New file. * Makefile.am (EXTRA_DIST): Add it. Ludovic Courtès2019-07-071-0/+563