Hi Frank, as you may see from the lack of responses, it seems that nobody is really excited with the proposed syntax. In my opinion, it is too heavy and has too many unspecified or redundant elements (like specifying level by indentation and asterisks, and both title and filename of included documents).
The toctree directive is simple at the moment, and I'd like to leave it at that. cheers, Georg Frank schrieb: > Sorry, for the maybe unclear example. Here is one that I edited > with VIM, which is emphasizes the idea of the proposed grammar > better (due to constant character width). This is how the TOC > file for some python documentation might look like. As I said: > All in one place and everything is transparent: > > > -- itoctree:: > > (*) Command line and environment ........... > CommandLineAndEnvironment.txt > (**) Command line ...................... CommandLine.txt > (***) Interface options ........... InterfaceOptions.txt > (***) Generic options ............. GenericOptions.txt > (***) Miscellaneous options ....... > MiscellaneousOptions.txt > (**) Environment variables ............. > EnvironmentVariables.txt > (***) Debug-mode variables ........ DebugModeVariables.txt > > (*) Using Python on Unix platforms ......... UsingPythonOnUnix.txt > (**) Getting and installing the latest > version of Python ................. > GettingAndInstalling.txt > (***) On Linux .................... OnLinux.txt > (***) On FreeBSD and OpenBSD ...... OnFreeBSDAndOpenBSD.txt > (***) On OpenSolaris .............. OnOpenSolaris.txt > (**) Building Python ................... BuildingPython.txt > (**) Python-related paths and files .... Python-relatedPaths.txt > (**) Miscellaneous ..................... Miscellaneous.txt > (**) Editors ........................... Editors.txt > > (*) Using Python on Windows ....................... > PythonWindows.txt > (**) Installing Python ........................ > InstallingPython.txt > (**) Alternative bundles ...................... Alternative.txt > (**) Configuring Python ....................... > ConfiguringPython.txt > (***) Excursus: Setting environment > variables .......................... > ExcursusSettingEnv.txt > (***) Finding the Python executable ...... > FindingThePythonExe.txt > (***) Finding modules .................... > FindingModules.txt > (***) Executing scripts .................. > ExecutingScripts.txt > (**) Additional modules ....................... > AdditionalModules.txt > (***) PyWin32 ............................ PyWin32.txt > (***) Py2exe ............................. Py2exe.txt > (***) WConi(**) ......................... WConio.txt > (**) Compiling Python on Windows .............. > CompilingPythonOnWin.txt > (**) Other resources .......................... > OtherResources.txt > > (*) Using Python on a Macintosh ................... UsingPythonOnA > Mac.txt > (**) Getting and Installing MacPython ......... > GettingAndInstallingMac.txt > (***) How t(**) run a Python script ...... > HowToRunAPythonScript.txt > (***) Running scripts with a GUI ......... > RunningScriptsGUI.txt > (***) Configuration ...................... > Configuration.txt > (**) The IDE .................................. TheIDE.txt > (**) Installing Additional Python Packages .... > InstallingAddPythonPacks.txt > (**) GUI Programming on the Mac ............... > GUIProgrammingOnTheMac.txt > (**) Distributing Python Applications on > the Mac .................................. > DistributingPythonApplMac.txt > (**) Application Scripting .................... > ApplicationScripting.txt > (**) Other Resources .......................... > OtherResources.txt > > > > > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
