DocBook BarCamp session FUDConF11

From FedoraProject

Revision as of 21:10, 10 January 2009 by Laubersm (Talk | contribs)

Jump to: navigation, search

Contents

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