46
TableofContents
1.Introduction.....................................................................................................................................1
1.1.AboutthisBooklet...............................................................................................................1
1.2.WhyDocBook?....................................................................................................................2
1.3.YourWorldView..................................................................................................................3
1.4.Markupbasedoncontent.....................................................................................................4
2.Gettingstarted................................................................................................................................5
2.1.PresentationoftheTools......................................................................................................5
2.2.TheOldWay:theDocBook-tools........................................................................................5
2.3.TheNewWay:XSLTProcandFOP.....................................................................................7
2.4.MyFirstDocBookFile........................................................................................................8
2.5.IntroducingtheStyleSheets................................................................................................9
3.Basicnotions..................................................................................................................................11
3.1.AnatomyofaDocBookTag..............................................................................................11
3.2.TheStructureofaDocBookFile.......................................................................................11
4.TheDocumentTypeDeclaration.................................................................................................14
4.1.UsingEntitiesforSharedText...........................................................................................14
4.2.UsingEntitiestoIncludeOtherfiles ..................................................................................15
4.3.IdentifyingfileswithformalpublicIDs .............................................................................15
4.4.UsingMarkedSectionstoHandleConditionalContent....................................................17
5.MetaInformation..........................................................................................................................19
6.Lists................................................................................................................................................21
6.1.Thesimplelist.....................................................................................................................21
6.2.Theitemizedlist..................................................................................................................22
6.3.Theorderedlist...................................................................................................................22
6.4.Thevariablelist...................................................................................................................23
6.5.Thesegmentedlist...............................................................................................................24
6.6.qandaset..............................................................................................................................25
6.7.Procedures..........................................................................................................................25
7.Tables.............................................................................................................................................27
8.Graphics.........................................................................................................................................29
9.Links...............................................................................................................................................32
10.DescribingtheApplication'sInterface.....................................................................................33
10.1.Examples..........................................................................................................................33
10.2.GUIInterfaceElements....................................................................................................34
10.3.CommandLineElements.................................................................................................36
10.4.DescribinganAPI............................................................................................................38
11.MiscellaneousUsefulTags..........................................................................................................40
11.1.LabellingTags..................................................................................................................40
11.2.FormattingTags................................................................................................................40
11.3.Warnings,Tips,andNotes...............................................................................................40
12.WheretoGoNext.......................................................................................................................41
12.1.DocBookResources.........................................................................................................41
A.Licence..........................................................................................................................................42
A.1.FreeDocumentationLicence............................................................................................42
iii
