skribilo/doc/skr, branch lcourtes@laas.fr--2004-libre,skribilo--devel--1.2Document production tool written in Guile Scheme (unofficial mirror)http://git.systemreboot.net/skribilo/atom?h=lcourtes%40laas.fr--2004-libre%2Cskribilo--devel--1.22006-03-19T20:08:40+00:00Various documentation fixes + completed the doc automake stuff.2006-03-19T20:08:40+00:00Ludovic Courtes2006-03-19T20:08:40+00:00urn:sha1:d43ab320c8c711aef6417d33a33d0b3d2058f690
* doc/user/Makefile.am (%.html): Added `-P ../img'.
(%.lout): Likewise.
(SUBDIRS): New.
* doc/user/char.skb (Some characters): Use the Lout-specific example for
`!' when relevant.
* doc/user/figure.skb (The figure markup): Avoid using `example-produce'.
* doc/user/slide.skb (dummy-slide-set-output): New.
(dummy-slide-output): New.
(dummy-slide-vspace-output): New.
(dummy-slide-embed-output): New.
(Example of Skribilo Slides): Use a processor, as in `document.skb', in
order to use the dummy output functions.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-50
Various fixes in the documentation code.2006-03-01T17:25:24+00:00Ludovic Court`es2006-03-01T17:25:24+00:00urn:sha1:b09b035d86267aa363430f5ff8b5900b37c15ea8
* doc/skr/manual.skr: Fixed uses of `format'.
* doc/user/document.skb (dummy-document-output): Fixed handling of
non-list author.
* doc/user/src/api2.skb: Fixed the title. ;-)
* doc/user/src/bib1.sbib (bigloo): Added a year and author as expected by
`bib5.skb'.
* doc/user/user.skb (Introduction): Explicitly added `:file #f'.
git-archimport-id: lcourtes@laas.fr--2004-libre/skribilo--devel--1.2--patch-61
First time the user manual is compiled to HTML.2006-01-31T23:23:15+00:00Ludovic Courtes2006-01-31T23:23:15+00:00urn:sha1:09039355539a79187669b688ff6a03c8a74e2099
* doc/skr/api.skr (make-engine?): Fixed.
(make-engine-custom): Likewise.
* doc/skr/manual.skr (the-index): Don't pass `:&skribe-eval-location'.
* doc/user/emacs.skb: Fixed typo.
* doc/user/htmle.skb: Documented the `file-name-proc' custom.
* doc/user/package.skb: Fixed the `prgm' example there.
* doc/user/skribe-config.skb: Commented out the `OPTIONS' section.
* doc/user/skribec.skb: Likewise.
* doc/user/slide.skb: Don't refer to HTML-ENGINE, use `find-engine'
instead.
* doc/user/src/slides.skb: Don't pass `:slide' to `toc'.
* doc/user/toc.skb: Commented the `:subsubsection' argument.
* doc/user/user.skb (Index): Set `:indent' to "Index".
* src/guile/skribilo.scm (skribilo-options): Added `--image-path'.
(skribilo): Handle it.
* src/guile/skribilo/ast.scm (ast->file-location): Exported.
* src/guile/skribilo/engine/base.scm (the-index): Don't pass
`:&skribe-eval-location'.
* src/guile/skribilo/engine/html.scm: Export `html-width' and
`html-title-authors'.
* src/guile/skribilo/engine/lout.scm (lout-width): Don't use `flonum?'.
* src/guile/skribilo/evaluator.scm (load-document): Added
`:allow-other-keys' so that the optional parameters may contain
keywords, too.
* src/guile/skribilo/package/slide.scm: Use `(skribilo engine html)'.
* src/guile/skribilo/skribe/api.scm (toc): Added `subsubsection'.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-31
More progress towards a working user manual.2006-01-25T22:57:34+00:00Ludovic Courtes2006-01-25T22:57:34+00:00urn:sha1:66e42310c0d6518abb39d52553286b5253bba6fd
* doc/skr/api.skr (define-markup?): Support `define*' and
`define*-public'.
* doc/user/bib.skb: Commented out problematic `skribebibtex'-related
things.
* doc/user/lib.skb (skribe-load): Replaced by `load-document'.
(skribe-load-options): Replaced by `*load-options*'.
(skribe-path): Replaced by `*document-path*'.
* src/guile/skribilo/coloring/lisp.scm (definition-search): Removed
debugging statement.
* src/guile/skribilo/engine.scm (find-engine): For documentation
purposes, explicitly list all keyword parameters.
* src/guile/skribilo/source.scm (source-read-lines): Start line numbers
from 0.
* src/guile/skribilo/utils/compat.scm (skribe-path-set!): New.
(skribe-image-path-set!): New.
(skribe-source-path-set!): New.
(skribe-bib-path-set!): New.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-30
More fixes in the hope to get the manual compiled.2006-01-18T23:22:29+00:00Ludovic Courtes2006-01-18T23:22:29+00:00urn:sha1:8bdcb386f3ce26a9031ca123b4d43af0b5a3721a
* doc/skr/api.skr (define-markup?): Accept `define-public'.
(define-markup-options): Accept any kind of `define' symbol.
(define-markup-rest): Likewise.
* doc/user/bib.skb (bibliography): Use `src/bib1.sbib'.
(bib-table?): Provide a definition.
(default-bib-table): Likewise.
(make-bib-table): Likewise.
(bibliography): Fixed a `ref'.
(example): Fixed file name. This example does not work yet.
* doc/user/footnote.skb (footnote): Documented `label', removed
`number'.
* doc/user/table.skb (th): Documented `rowspan'.
* src/guile/skribilo.scm (skribilo-options): Added `-S'/`--source-path'.
Honor it.
* src/guile/skribilo/coloring/lisp.scm: Use `(ice-9 match)'. Rewrote all
the `match-case' code into corresponding `match' statements.
(definition-search): Fixed, using `source-property' and `port-line'.
Does not work yet due to a bug in guile-reader's source position
recording (shows 1 line earlier). Added a READ parameter.
* src/guile/skribilo/skribe/api.scm: Mark SYMBOL as replaced instead of
blindly overriding the core binding.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-28
Towards a self-hosted user manual.2006-01-17T22:50:23+00:00Ludovic Courtes2006-01-17T22:50:23+00:00urn:sha1:46c709dc1f242fa680d4425da4dfc9314686e9cc
* doc/skr/api.skr: Use `(skribilo reader)' and `(skribilo utils syntax)'.
(api-search-definition): Added a SKRIBE-SOURCE? argument.
Determine the appropriate reader based on its value.
(keyword->symbol): Removed.
(define-markup?): Fixed.
(make-engine?): Fixed (but unverified).
(make-engine-custom): Likewise.
(sym/kw?): New.
(define-markup-formals): Fixed.
(define-markup-options): Likewise.
(define-markup-rest): Likewise.
(doc-markup): Added a SKRIBE-SOURCE? argument.
(doc-engine): Likewise.
* doc/user/*.skb: Updated the `:source' arguments to `doc-markup' and
`doc-engine'.
* src/guile/skribilo/utils/compat.scm (hashtable-update!): Fixed
according to the Bigloo manual.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-26
More SRFI-3[45] enhancements; first stab at the user documentation.2006-01-16T22:31:32+00:00Ludovic Courtes2006-01-16T22:31:32+00:00urn:sha1:2d8fa88ef04b3a6141a2b03a9671a7dd0fcc1f60
* src/guile/skribilo/biblio.scm (skribe-open-bib-file): Raise a
`&file-search-error' when needed.
* src/guile/skribilo/runtime.scm (convert-image): Likewise.
* src/guile/skribilo/source.scm (source-read-lines): Likewise.
(source-read-definition): Likewise.
* src/guile/skribilo/utils/compat.scm (skribe-load): Only look up
`%skribe-known-files' when `load-document' failed.
(find-file/path): Use `search-path'.
(find-runtime-type): Implemented.
* doc/skr/api.skr: Use `(ice-9 match)'. Use `match' instead of
`match-case'.
(api-search-definition): Search in `%load-path' and `(skribe-path)'.
(define-markup?): First stab at getting the `match' syntax right.
* doc/user/src/start[3-5].skb: Small fixes.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-25
Changes related to source-highlighting and to the manual.2005-11-01T16:19:34+00:00Ludovic Courtes2005-11-01T16:19:34+00:00urn:sha1:f553cb65b157b6df9563cefa593902d59301461b
* src/guile/skribilo/engine/lout.scm (lout-make-doc-cover-sheet): Fixed
the definition of MULTI-COLUMN? (fixes a bug when producing
multi-column documents).
(lout-definitions): `@SkribeLeaders' renamed to `@SkribiloLeaders'.
* doc/skr/api.skr (api-search-definition): Fixed calls to `format'.
* doc/skr/manual.skr (keyword): Use `write' instead of `keyword->string'.
* doc/user/start.skb: Cosmetic changes.
* src/guile/skribilo/coloring/lisp.scm: First stab at its adaptation.
* src/guile/skribilo/coloring/xml.scm: Rewritten "by hand".
* src/guile/skribilo/evaluator.scm (skribe-include): Removed debugging
statements.
* src/guile/skribilo/lib.scm (new): Added a trick such that users of this
macro don't have to use `(oop goops)' and `(skribilo types)'.
(date): New procedure.
* src/guile/skribilo/module.scm (*skribe-core-modules*): Renamed to
`%skribe-core-modules'.
(%skribe-core-modules): Removed `(oop goops)'. Added `(skribilo
source)', `(skribilo coloring lisp)' and `(skribilo coloring xml)'.
* src/guile/skribilo/skribe/api.scm (footnote): Fixed.
* src/guile/skribilo/source.scm: Cosmetic changes.
* src/guile/skribilo/types.scm: Export `language-extractor' and
`language-fontifier'.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-11
Removed useless files, integrated packages.2005-10-31T16:03:18+00:00Ludovic Courtes2005-10-31T16:03:18+00:00urn:sha1:e9509518623d016880392237a298d4561a3b6a0b
* src/guile/skribilo/packages: New directory and files.
* bin: Removed.
* skr: Removed (files moved to `src/guile/skribilo/packages').
* skribe: Removed.
* doc/skr/env.skr (*courtes-mail*): New.
* doc/user/user.skb: Removed postal addresses, added my name.
* src/guile/skribilo/engine/lout.scm: Uncommented the slide-related
markup writers.
* src/guile/skribilo/evaluator.scm (%evaluate): Try weird things with
source properties.
* src/guile/skribilo/reader/skribe.scm: Comply with the new guile-reader
API.
* src/guile/skribilo/types.scm: Removed the special `initialize' method
for ASTs which was supposed to set their location.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-7
Initial import of Skribe 1.2d.2005-06-15T13:00:39+00:00Ludovic Court`es2005-06-15T13:00:39+00:00urn:sha1:fc42fe56a57eace2dbdb31574c2e161f0eacf839
Initial import of Skribe 1.2d.
git-archimport-id: lcourtes@laas.fr--2004-libre/skribilo--devel--1.2--base-0