[TYPO3-doc] DocBook: first sample manual

[Michael Bakonyi]

Hi Francois,

> Seriously, that's true. In DocBook you don't define the levels of headings. DocBook structures your publication along a hierarchy of, well, structural, elements. So you're going to have a book, with chapters and sections inside chapters, with maybe sections nested inside sections (that's just an example that matches the sample manual, there are many others structures which you can do with DocBook).

okay, so so amongst others I do have to create nested sections to get a structured document.  Maybe I formulated my question a little bit weird but this was my question at the beginning. Thanks a lot for your detailed explanation!

>> Okay for me this would be an example where "further resources" would (perfectly) fit but I don't want to keep harping about on issue.
> 
> Let's say that we had already quite some discussions about how to name this section, so if you don't mind, I would rather keep "Next steps". Is that ok?

I don't like it but sure it's okay. :) Let's finish the discussion about it, yes.

I hope to get some more screenshots done on the weekend ...

Have a nice weekend,

Cheers,
Michael






-- 
civit

Michael Bakonyi
Wieblinger Weg 19/1
69123 Heidelberg

+49 6221 7503949
http://www.civit.de

Am 31.03.2011 um 20:37 schrieb François Suter:

> Hi Michael,
> 
> Sorry again for the delay in my answers, I'm pretty busy these days.
> 
>>> I'm still not sure I understand exactly what you mean. What do you mean
>>> with "headlines"?
>> 
>> Uhm ... like h1, h2 etc. in HTML.
> 
> Forget about HTML, this is DocBook ;-)
> 
> Seriously, that's true. In DocBook you don't define the levels of headings. DocBook structures your publication along a hierarchy of, well, structural, elements. So you're going to have a book, with chapters and sections inside chapters, with maybe sections nested inside sections (that's just an example that matches the sample manual, there are many others structures which you can do with DocBook).
> 
> Each such element (book, chapter, section) can have a title (and maybe a subtitle). DocBook doesn't any other differences of "level". This will happen only upon rendering. If we consider rendering to HTML, then, yes, we're going to have h1, h2, etc., but they will derive from the DocBook structure and not from the choices made by the manual's author. Thus - again, it's an example - the book title may be rendered to h1, the chapter titles to h2, the first-level sections titles to h3, etc.
> 
> Does that make sense?
> 
>> Okay for me this would be an example where "further resources" would (perfectly) fit but I don't want to keep harping about on issue.
> 
> Let's say that we had already quite some discussions about how to name this section, so if you don't mind, I would rather keep "Next steps". Is that ok?
> 
> Cheers
> 
> -- 
> 
> Francois Suter
> Cobweb Development Sarl - http://www.cobweb.ch
> _______________________________________________
> TYPO3-project-documentation mailing list
> TYPO3-project-documentation at lists.typo3.org
> http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-project-documentation