[TYPO3-doc] DocBook: customizing the schema

François Suter fsu-lists at cobweb.ch
Fri Jun 10 09:22:11 CEST 2011


Hi all,

On the road to having the first rendering done, there's one important 
step: customizing the DocBook schema that we use.

Indeed DocBook is very rich and we will not need every single tag. The 
schema customization lets us define tags that we don't use. This 
simplifies the life of editors, as it reduces the number of tags they 
are faced with while writing a manual. It also reduces the amount of 
work needed for setting up the rendering scripts, as we know what tags 
we don't need to worry about.

Tom already made a proposal [1] and started spelling out a list of do's 
and don'ts [2].

You are welcome to comment on that.

Cheers

-- 

Francois Suter
Cobweb Development Sarl - http://www.cobweb.ch

[1] 
https://svn.typo3.org/TYPO3v4/Documentation/official_template/trunk/DocBook/docbook51b2/typo3.rnc
[2] 
http://wiki.typo3.org/DocTeam/DocBook_migration/DocBook_Design_Elements#Does_and_Don.27ts_.28When_Writing_DocBook_Texts.29


More information about the TYPO3-project-documentation mailing list