skribilo/doc, branch v0.10.0

reader: Add Gemtext reader.

2022-04-12T19:34:47+00:00

* src/guile/skribilo/reader/gemtext.scm: New file. * configure.ac: Set BUILD_GEMTEXT_READER automake conditional to true if (srfi srfi-171) is found. Else, set it to false. * src/guile/Makefile.am (readers): Add skribilo/reader/gemtext.scm if BUILD_GEMTEXT_READER is true. (EXTRA_DIST): Add skribilo/reader/gemtext.scm if BUILD_GEMTEXT_READER is false. * doc/user/syntax.skb (The Gemtext Syntax): New section. * tests/readers/gemtext.test: New file. * tests/Makefile.am (TESTS): Add readers/gemtext.test if BUILD_GEMTEXT_READER is true. (EXTRA_DIST): Add readers/gemtext.text if BUILD_GEMTEXT_READER is false.

doc: Document the skribilo emacs mode.

2021-10-01T18:27:37+00:00

* doc/user/emacs.skb (Skribe Emacs Mode): Rename to ... (Skribilo Emacs Mode): ... this. Document the skribilo emacs mode.

doc: Re-indent and re-fill paragraph.

2021-10-01T18:27:12+00:00

* doc/user/emacs.skb: Re-indent and re-fill paragraph. Start block comments with double semicolons. Replace double spaces between sentences with a single space.

doc: Remove redundant footnote.

2021-10-01T09:37:16+00:00

The text already says that any valid Scheme code is allowed. It is redundant to mention again that any valid GNU Guile Scheme code is allowed. * doc/user/start.skb (Dynamic Documents)[Simple Computations]: Remove redundant footnote.

doc: Replace unreproducible date->string computation.

2021-10-01T09:36:52+00:00

The date->string computation is unreproducible. A slightly different version of the documentation is built each time. Also, the output of date->string is locale dependent, and does not render correctly in all locales. * doc/user/start.skb (Dynamic Documents)[Simple Computations]: Replace unreproducible date->string computation with a square root computation.

justify: Turn 'margin' into a parameter.

2020-11-01T14:53:46+00:00

* src/guile/skribilo/utils/justify.scm (*margin*): Turn into a parameter. (with-justification, with-justification/noflush): Use 'parameterize' instead of 'set!'. * src/guile/skribilo/engine/info.scm: Adjust accordingly. * doc/modules/skribilo/documentation/api.scm (doc-markup): Likewise.

info: Emit dir-category and dir-entry.

2020-11-01T13:50:03+00:00

Reported by nly . * src/guile/skribilo/package/base.scm (document): Add :info-dir-category and :info-dir-entry. * doc/user/document.skb: Document them. * doc/user/user.skb: Pass :info-dir-category. * src/guile/skribilo/engine/info.scm (scribe-document->info): Create INFO-DIR-CATEGORY and START-INFO-DIR-ENTRY.

Use '_' as the 'match' wildcard.

2020-08-02T08:08:13+00:00

This addresses '-Wunused-variable' warnings. * doc/modules/skribilo/documentation/api.scm (define-markup?) (make-engine?, make-engine-custom) (define-markup-formals, define-markup-options) (define-markup-rest, exp->skribe): Use '_' instead of 'else' as the 'match' wildcard. * src/guile/skribilo/package/slide/latex.scm (%slide-advi-setup!): Likewise. * src/guile/skribilo/source/lisp.scm (lisp-extractor) (scheme-extractor, stklos-extractor, skribe-extractor) (bigloo-extractor): Likewise. * src/guile/skribilo/sui.scm (load-sui): Likewise. (sui-title, sui-key, sui-find-ref, sui-filter): Likewise.

Write '#:use-module', '#:export', etc. instead of ':use-module', etc.

2020-08-01T15:00:12+00:00

Changes made by running: for i in $(git ls-tree -r HEAD --name-only) ; do sed -i $i -e's/:use-module/#:use-module/g ; s/:autoload/#:autoload/g ; s/:export/#:export/g' ; done

doc: Remove reference to non-existent CSS file.

2018-04-29T21:41:18+00:00

* doc/user/static/main.css: Remove reference to "base.css".