What would you think about a syntax for the table of contents in the
following form (or something similar):
(*) Introduction ...................................... intro/
intro.txt
(**) My Ideas ......................................... intro/
ideas.txt
(***) My Philosophies .......................... intro/philo.txt
....
(*) Basics ............................. basics/intro.txt
(**) Complicated Terms ..... basics/complicated.txt
(**) Simple Terms ............... basics/simple-things.txt
....
Grammar:
'(' '*'+ ')' [non-dot]+ '....' [non-whitespace]+
(assume the whitespace has been skipped)
-- A pattern '(**)', or something like that determines section
depth,
where the number of '*' determines the depth of the section.
-- Anything until the first dot is interpreted as section title.
-- The include statementl '....' where four or more dots trigger the
'include'
command.
-- and thecharacter sequence until newline is the name of the file to
be included.
This has the advantage that the structure of the document and the
related
files would be very transparent.
A couple of years ago, I wrote an article which has been published in
Springer Lecturer Notes on Source Code Esthetics for Automatic
Typesetters. There, I tried to collect some rationals for the design
of a human readable markup language. If you are interested, I would be
glad to have you look at it.
Best Regards
Frank
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
