From Fedora Project Wiki
(Added link to preso deck) |
|||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
== Presentation == | |||
The presentation found [http://jsmith.fedorapeople.org/UTOSC-DocBook.odp here] is the same one used for the BarCamp talk. | |||
==DOCTYPE declaration== | ==DOCTYPE declaration== | ||
do not forget the declaration for xml DOCTYPE docbook.dtd at the beginning. | do not forget the declaration for xml DOCTYPE docbook.dtd at the beginning. | ||
| Line 34: | Line 37: | ||
* can create template | * can create template | ||
<pre>create_book --brand=fedora --type=article --name=article2 </pre> | <pre>create_book --brand=fedora --type=article --name=article2 </pre> | ||
[[Category:FUDConF11 BarCamp sessions]] | |||
Latest revision as of 16:28, 15 January 2009
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