From: G. M. <g....@we...> - 2005-04-07 14:38:37
|
On 6.04.05, David Goodger wrote: > [G. Milde] > Nick's suggestion about CSS seems good. Defining the navigation elements in a stylesheet? Seems reasonable. (Unfortunately it will not work with lightwight browsers that do not support CSS.) > > In order to be usable in a context where you need navigation > > elements, an alternative way to define the document title seems > > necessary. > > This seems like a roundabout way of getting the job done. If > something is needed, let's do it directly and correctly, not as an > indirect kludge. From docs/ref/rst/restructuredtext.html: ... there is no way to indicate a document title and subtitle explicitly in reStructuredText. Instead, a lone top-level section title (see Sections below) can be treated as the document title. i.e. currently, it is not possible to create a document that has a) Some printable (non-title) output on top b) a defined document title For me, providing a way to explicitly indicate a document title in the rst source doesnot look more roundabout than trying some "external means" to go around this restriction. I acknowledge, that this case is not the most common one, so the "explicit document title indication" syntax doesnot need to be simple. > > ---------------------------------------------------------------- > > My Title > > ---------------------------------------------------------------- > > > > (Under and overlined with lines exceeding the actual title, or just > > the special case that the title does not start at col 1) > > This is already valid section title syntax. Try it. Yes, but it could be given a special meaning, e.g. if the first section title of a document is adorned this way (without need to be the first non-comment part of the document), it will be transformed to the document title. This would also allow "vice-versa" explicity: if the first section title is not overlined and indented, do not propagate it to a document title. (This would allow documents with sections but without document title.) The problem with this approach is missing backwards compatibility (somewhat restricted if the distinction is done for the first section title in a document). Another solution for my navigation problem (mentioned on another post to this thread) would be a "placement" indicator (for raw html, maybe also for ".. include::"). So, ma Günter -- G.Milde web.de |