summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Expand)Author
2012-05-30doc: CSS: Increase interline spacing.•••* doc/user/skribilo.css (.skribilo-body): Set `line-height' to 1.6. * web/skribilo.css (.skribilo-body): Likewise. Ludovic Courtès
2012-05-30build: Remove potential `.png' files in $(infodir) before recreating them.•••* doc/user/Makefile.am (install-data-hook): Remove the symlink's target before creating it. Ludovic Courtès
2012-05-30build: Use @PACKAGE_URL@ instead of hard-coded URLs.•••* doc/user/lout/front-page.lout.in: Use @PACKAGE_URL@ instead of the hard-coded URL. * src/guile/skribilo/config.in (skribilo-url): Likewise. * substitute.am (substitute): Substitute @PACKAGE_URL@. Ludovic Courtès
2012-05-29doc: Add a `lout-illustration' example.•••* doc/modules/skribilo/documentation/api.scm (le)[inline-definitions-proc]: Add @TeX and @LaTeX definitions. * doc/user/src/lout-illustration.skb: New file. * doc/user/Makefile.am (EXTRA_DIST): Add it. * doc/user/loute.skb (Additional Markup): Add `src/lout-illustration.skb' as an example. Ludovic Courtès
2012-05-29doc: Install images alongside the Info manual.•••* configure.ac: Invoke `AC_PROG_LN_S' and `AC_PROG_MKDIR_P'. * doc/user/Makefile.am (install-data-hook): Create symlinks to the PNG files from $(infodir). Ludovic Courtès
2012-05-28doc: Improve Info rendering.•••* doc/modules/skribilo/documentation/api.scm (ie)[doc-markup]: Use a justifier to output the markup prototypes slightly indented. Prepend "-- Markup: ". (doc-markup-proto): When using the `info' engine, annihilate `code' and `bold'. * doc/modules/skribilo/documentation/manual.scm (param): When using the `info' engine, render parameters as uppercase, without `code'. Ludovic Courtès
2012-05-28doc: Represent (quote x) as 'x.•••* doc/modules/skribilo/documentation/api.scm (exp->skribe): Fix pattern for EXP as (quote SYM). Ludovic Courtès
2012-05-27doc: Improve Info rendering of the list of "See also" cross-references.•••* doc/modules/skribilo/documentation/api.scm (ie): Change "See also " to "Also, ". Ludovic Courtès
2012-05-27info: Implement the `image' markup.•••* src/guile/skribilo/engine/info.scm (image): New markup writer. * doc/user/infoe.skb (Info Engine): Mention image rendering. Ludovic Courtès
2012-05-26doc: Fix line numbers in `prgm' examples.•••* doc/user/src/prgm2.skb: Increase line numbers since the new licenses headers occupies two more lines. Ludovic Courtès
2012-05-26doc: Improve CSS using nice fonts with `@font-face'.•••* doc/user/FONTS, doc/user/junction.ttf, doc/user/lobster-1.4.otf: New files. * doc/user/Makefile.am (EXTRA_DIST): Add `FONTS'. (dist_html_DATA): Add `lobster-1.otf', and `junction.ttf'. * doc/user/skribilo.css: Use Lobster and Junction via `@font-face'. Improve other details. * web/skribilo.css: Likewise. Ludovic Courtès
2012-05-24doc: Clarify affiliations.•••* doc/user/user.skb: Add missing hyphen in "Sophia-Antipolis"; change Manuel's affiliation to "Inria". Ludovic Courtès
2012-05-24doc: Always display keywords in DSSSL style.•••* doc/modules/skribilo/documentation/manual.scm (keyword): Display ARG in DSSSL keyword style. Ludovic Courtès
2012-05-24doc: lout: Render examples in a colored box.•••* doc/modules/skribilo/documentation/api.scm (le)[inline-definitions-proc]: Add @SkribiloExample. * doc/modules/skribilo/documentation/manual.scm (example)[lout]: Use @SkribiloExample. (le): Set the `includes' custom to include `diag'. * src/guile/skribilo/engine/lout.scm (frame): Mark the trick about @Floater. Ludovic Courtès
2012-05-23doc: Give engine sections an ident and remove the mark with that ident.•••* doc/modules/skribilo/documentation/api.scm (doc-markup): Refer to engines by `ident' instead of by `mark'. * doc/user/compiler.skb, doc/user/engine.skb, doc/user/links.skb, doc/user/package.skb, doc/user/sectioning.skb: Update references accordingly. * doc/user/contexte.skb, doc/user/htmle.skb, doc/user/infoe.skb, doc/user/latexe.skb, doc/user/loute.skb, doc/user/xmle.skb: Give sections an ident, and remove the mark. Ludovic Courtès
2012-05-17Switch to GPLv3+.Ludovic Courtès
2012-05-14Mention "Guile 2.0" instead of "Guile-VM".•••* configure.ac: Remove `--enable-guile-vm' option. Check for `guild' and `guile-tools', defining `GUILD'. Rename `ENABLE_GUILE_VM' to `HAVE_GUILE2'. * guile-vm.am: Rename to... * guilec.am: ... this. * doc/modules/Makefile.am, src/guile/Makefile.am: Update accordingly. Ludovic Courtès
2012-05-12doc: Update Manuel's affiliation, email, and URL.•••* doc/user/user.skb: "Inria" instead of "INRIA". * doc/modules/skribilo/documentation/env.scm (*serrano-url*): Update. (*serrano-mail*): Shorten. Ludovic Courtès
2012-05-10info/latex/lout: Set the output port's encoding.•••* src/guile/skribilo/engine/html.scm (document): Fix typo in comment. * src/guile/skribilo/engine/info.scm (document)[guile-2]: Set the current output port's encoding to "UTF-8". * src/guile/skribilo/engine/latex.scm (latex-engine)[encoding]: New custom. (document): Set the output port's encoding to that. When that encoding is "UTF-8", add the right \usepackage. * src/guile/skribilo/engine/lout.scm (lout-engine)[encoding]: New custom. (document): Set the output encoding. Emit `@SysInclude { latin2 }' for ISO-8859-2. Ludovic Courtès
2012-04-25doc: Have `user.sui' depend on `user.html'.•••* doc/user/Makefile.am (user.sui): New dependency. Ludovic Courtès
2012-04-25Remove support for `guile-lint'.•••* guile-lint.am: Remove. * Makefile.am (EXTRA_DIST): Remove `guile-lint.am'. * doc/modules/Makefile.am (lintable): Remove. Remove inclusion of `guile-lint.am'. * src/guile/Makefile.am: Likewise. * configure.ac: Remove check for `guile-lint' and `HAVE_GUILE_LINT' conditional. Ludovic Courtès
2011-01-07Build `doc/modules' before `doc/user'.•••* doc/Makefile.am (SUBDIRS): Build `modules' first. Ludovic Courtès
2010-03-08Factorize encoding twiddling in `set-correct-file-encoding!'.•••* doc/modules/skribilo/documentation/api.scm (api-search-definition): Call `set-correct-file-encoding!'. * doc/user/src/outline.txt (Author): Remove accent from last name, as a temporary hack. * doc/user/syntax.skb: Call `set-correct-file-encoding!' in the `outline' syntax example. * doc/user/user.skb: Use `(skribilo utils syntax)'. * src/guile/skribilo.scm (skribilo): Replace encoding twiddling with `set-correct-file-encoding!' call. * src/guile/skribilo/evaluator.scm (load-document, include-document): Likewise. * src/guile/skribilo/source.scm (source-read-lines): Call `set-correct-file-encoding!'. (source-read-definition): Likewise. * src/guile/skribilo/utils/syntax.scm (set-correct-file-encoding!): New macro. Ludovic Courtès
2009-11-27Add `coding:' comments.•••Add `coding:' comments for use by both Emacs and Guile 2.x. Ludovic Courtès
2009-11-20Update `INSTALL', remove `doc/COPYING'.Ludovic Courtès
2009-11-20Compile documentation modules.•••* doc/modules/Makefile.am (moduledir, SOURCES, SUFFIXES): New variables. Include `guile-vm.am'. Ludovic Courtès
2009-11-20Define $GUILE_LOAD_COMPILED_PATH for Guile 2.x.•••* guile-vm.am (guile_warnings): New variable. (.scm.go): Set $GUILE_LOAD_COMPILED_PATH appropriately, specify Guile compilation warnings. * src/pre-inst-skribilo.in, src/skribilo.in: Set $GUILE_LOAD_COMPILED_PATH appropriately. * tests/Makefile.am (TESTS_ENVIRONMENT): Set $GUILE_AUTO_COMPILE and $GUILE_LOAD_COMPILED_PATH. * doc/user/Makefile.am (skribilo.info, .skb.html, .skb.lout, .skb.tex, .skb.ctx): Set $GUILE_LOAD_COMPILED_PATH. (load_compiled_path): New variable. Ludovic Courtès
2009-11-20Choose the right encoding for input documents.•••* src/guile/skribilo.scm (skribilo): Use the right encoding for the current input port. * src/guile/skribilo/evaluator.scm (load-document, include-document): Likewise. * doc/user/user.skb: Add a `coding:' comment for use by Guile at the top. Ludovic Courtès
2009-11-20Use `(skribilo-module-syntax)' instead of `(fluid-set! current-reader ...)'.•••* doc/modules/skribilo/documentation/api.scm, doc/modules/skribilo/documentation/extension.scm, doc/modules/skribilo/documentation/manual.scm, src/guile/skribilo/writer.scm: Use `(skribilo-module-syntax)' instead of `(fluid-set! current-reader ...)'. Ludovic Courtès
2009-05-27doc: Fix `eq' markup documentation.•••* doc/user/eq.skb (Summary): Unquote Sk-expressions. Ludovic Courtès
2009-05-27doc: Document `pie' markups.•••* doc/user/pie.skb (Syntax): Document markups. * src/guile/skribilo/package/pie.scm (pie, slice, sliceweight): Add `:class' option. (pie, slice, sliceweight)[writers]: Add `:options'. Ludovic Courtès
2009-05-26doc: Improve `slide' example.•••* doc/user/src/slides.skb (Table of Contents): Rewrite using `resolve' so that the TOC isn't empty. Reported by James Haggerty <james.haggerty@gmail.com>. Ludovic Courtès
2009-01-12doc: Minor Info documentation improvements.•••* doc/user/infoe.skb: Minor improvements. Ludovic Courtès
2009-01-07doc: Start customizing Info output.•••* doc/modules/skribilo/documentation/api.scm (doc-markup): New write for `info'. (punctuate): New optional argument PERIOD?. (doc-markup): Customize Info output. Rename `doc-markup.lout' to `doc-markup.generic'; use it. Ludovic Courtès
2009-01-07doc: Use `:info-node' to avoid name clashes; document it.•••* doc/user/eq.skb (Syntax): Add `:info-node' to avoid name clash. * doc/user/package.skb (Example): Likewise. * doc/user/pie.skb (Syntax): Likewise. * doc/user/skribilo-config.skb (Synopsis): Likewise. * doc/user/slide.skb (Example): Likewise. * doc/user/sectioning.skb: Document the `:info-node' option. Ludovic Courtès
2009-01-07doc: Document the Info engine.•••* doc/modules/skribilo/documentation/env.scm (*api-engines*): Add `info'. * doc/user/Makefile.am (EXTRA_DIST): Add `infoe.skb'. * doc/user/engine.skb: Include `infoe.skb'. Ludovic Courtès
2008-12-23Make `distcheck' happy.•••* doc/user/Makefile.am (CLEANFILES): Add `skribilo.info'. Ludovic Courtès
2008-12-22Update `.gitignore'.Ludovic Courtès
2008-12-21Add `rss-2' reader, for RSS 2.0 feeds as an input syntax.•••* src/guile/skribilo/reader/rss-2.scm: New file. * src/guile/Makefile.am (readers): Add `rss-2.scm'. * po/POTFILES.in: Add `rss-2.scm'. * doc/user/syntax.skb (rss2-syntax): New section. * NEWS: Update. Ludovic Courtès
2008-12-21Add `--custom' option to `skribilo'.•••* src/guile/skribilo.scm (skribilo-show-help): Update. (%options)[#\c]: New option. (%default-options)[:customs]: New option. (skribilo): Handle it. * doc/user/compiler.skb (Skribilo Compiler)[Options]: Add. * NEWS: Update. Ludovic Courtès
2008-12-13doc: Add "Writing New Readers".•••* doc/user/syntax.skb (syntax)[custom-syntax]: New section. Suggested by Klaus Schilling <schilling.klaus@web.de>. * doc/user/engine.skb (custom-engine): Link to `custom-syntax'. Ludovic Courtès
2008-12-13doc: Describe use of a string as `:file' for sections.•••* doc/user/sectioning.skb: Document the use of a string argument for `:file'. Reported by Klaus Schilling <schilling.klaus@web.de>. Ludovic Courtès
2008-12-07doc: Produce user manual in Info format.•••* doc/user/Makefile.am (skrinfodir, skrinfo_DATA): New. (skribilo.info): New target. * doc/user/user.skb: Don't produce a TOC nor an index when using the Info engine. Ludovic Courtès
2008-04-23Update web site, with SUI refs to the user manual.Ludovic Courtès
2008-04-22doc: Add "More on Skribilo".•••* doc/user/user.skb (Introduction)[More on Skribilo]: New section. Ludovic Courtès
2008-04-22Fix SUI documentation.•••* doc/user/htmle.skb: Add link to section `sui'. * doc/user/links.skb (sui): Fix references to Skribe and SUI production example and description. Ludovic Courtès
2008-04-21doc: Fix makefile.•••* doc/user/Makefile.am (EXTRA_DIST): Add `contexte.skb'. Ludovic Courtès
2008-04-21Document the `context' engine.•••* doc/modules/skribilo/documentation/env.scm (*api-engines*): Add `context'. * doc/user/contexte.skb: New file. * doc/user/engine.skb: Include it. * src/guile/skribilo/engine/context.scm (context-customs): Moved to the `make-engine' call so that automatic documentation extraction works. Ludovic Courtès
2008-04-21Allow builds of the user manual with LaTeX and ConTeXt.•••* doc/modules/skribilo/documentation/api.scm (doc-engine): Fix `skribe-warning' invocation. * doc/user/Makefile.am (.skb.lout): Move out of `if HAVE_LOUT'. (.skb.tex, .skb.ctx): New targets. Ludovic Courtès
2008-04-21Run Guile-Lint on documentation modules.•••* doc/modules/Makefile.am (CLEANFILES, lintable): New. Include `guile-lint.am'. * guile-lint.am: Add "-L $(top_srcdir)/doc/modules". Ludovic Courtès