From Fedora Project Wiki
Presentation
The presentation found here is the same one used for the BarCamp talk.
DOCTYPE declaration
do not forget the declaration for xml DOCTYPE docbook.dtd at the beginning.
- it may be used by tools (validators) or created by tools (Publican)
- it is used for validation
- cut and paste - but note book vs article
- first element must match declaration (book vs article)
Xincludes
- helps with repurposing content
- ie each chapter is in its own file. then the book/article just includes with appropriate chapters.
- can include any type - chapter, para, ...
ENTITY
- define the entity
!ENTITY DISTRO "The Susan spin of Fedora" - inline or through a reference to a separate file (.ent file)
- publican will auto include (and use publican-fedora rpm for branding including this)
- use as
&DISTRO;in content
tools (for any xml not just docbook)
- xmlint - does it follow the dtd
- xsltproc - transforms to other types like pdf or html
- xmltidy
toolchains
- lots of older one and custom one.
- Fedora now including and using Publican
file.xml -> xsltproc -> file.fo -> fop -> file.pdf
- xsltproc read in style sheet
- fo is about layout
publican
- can create template
create_book --brand=fedora --type=article --name=article2