guix/doc/build.scm, branch version-1.1.0

doc: Remove one use of 'file-append*'.

2020-08-26T20:59:39+00:00

* doc/build.scm (texinfo-manual-source)[build]: Use 'file-append', not
'file-append*', for 'htmlxref.cnf', to ensure it has the right basename.

doc: Inherit md5.scm fix in custom 'guile-lib' variant.

2020-06-29T19:22:39+00:00

* doc/build.scm (guile-lib/htmlprag-fixed)[source]: Remove.
[arguments]: Add 'fix-htmlprag' phase.

doc: Improve anchor collection.

2020-04-14T14:01:53+00:00

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.

doc: Avoid invalid 'match' pattern in 'syntax-highlighted-html'.

2020-04-14T14:01:45+00:00

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 ...).

doc: Emit hyperlinks in HTML output for @lisp snippets.

2020-04-14T14:01:39+00:00

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.

doc: Make sure 'htmlxref.cnf' is honored.

2020-01-11T23:19:10+00:00

Fixes .
Reported by Tobias Geerinckx-Rice .

* doc/build.scm (html-manual)[build]: Copy 'htmlxref.cnf' to the current
directory so that 'makeinfo' honors it.

doc: Handle right arrows in 'syntax-highlighted-html'.

2019-11-28T12:30:53+00:00

* doc/build.scm (syntax-highlighted-html)[build](entity->string): Add "rarr".

doc: Use the right title in HTML indices for the cookbook.

2019-10-22T16:32:52+00:00

* doc/build.scm (html-manual-indexes): Add #:title.
[build]: Replace "GNU Guix Reference Manual" by references to TITLE.

doc: More responsive online manual.

2019-10-21T19:17:01+00:00

* doc/build.scm (%makeinfo-html-options): Add viewport to all generated
html pages for better mobile device support.

doc: Add support for "guix-cookbook.texi" to 'build.scm'.

2019-10-21T16:16:16+00:00

* 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.