On 2008 Feb 21, at 03:38, Alejandro Forero Cuervo wrote:
Sure, good thinking. I've created this document:
http://chicken.wiki.br/wiki-syntax-chicken
...
Suggestions would be appreciated. :-)
The page is much appreciated, and I now have a much better vision of
how the markup is
going.
I hesitate to bring it up again, but can we please have some kind of
indexing markup?
I agree that much of the indexing can be done automatically from the
<procedure> and
similar tags, but, especially if we're going to use the new markup for
the CHICKEN
manual, custom index entries will be absolutely necessary.
Here's my suggested syntax, keeping it XML-compliant:
<indexentry major="List procedures" [minor="{{append}}"]
[bold="yes|no"] [see="other topic"]/>
where the major and minor attributes refer to the major and minor
levels of the
index entry, bold indicates whether the current page number shall be
boldfaced
(representing a definition of the topic and see replaces the page
number with
its operand, for `see also' type entries).
These entries would just be written to a file, and external code would
then process
them to produce index pages or whatever.
Perhaps Alejandro's database of `where symbols in the wiki are
documented' could
also be added to this external file?
Thanks for considering this! -- v
_______________________________________________
Chicken-users mailing list
Chicken-users@nongnu.org
http://lists.nongnu.org/mailman/listinfo/chicken-users