diff --git a/en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml b/en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml index 26efed2eb4..d2ef3545dd 100644 --- a/en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml +++ b/en_US.ISO8859-1/books/fdp-primer/doc-build/chapter.xml @@ -36,6 +36,76 @@ This chapter covers organization of the documentation build process and how &man.make.1; is used to control it. + + Rendering DocBook into Output + + Different types of output can be produced from a single + DocBook source file. The type of output desired is set with the + FORMATS variable. A list of known formats is + stored in KNOWN_FORMATS: + + &prompt.user; cd ~/doc/en_US.ISO8859-1/books/handbook +&prompt.user; make -V KNOWN_FORMATS + + + Common Output Formats + + + + + FORMATS Value + File Type + Description + + + + + + html + HTML, one file + A single book.html or + article.html. + + + + html-split + HTML, multiple files + Multiple HTML files, one for + each chapter or section, for use on a typical web + site. + + + + pdf + PDF + Portable Document Format + + + +
+ + The default output format can vary by document, but is + usually html-split. Other formats are chosen + by setting FORMATS to a specific value. + Multiple output formats can be created at a single time by + setting FORMATS to a list of formats. + + + Build a Single HTML Output File + + &prompt.user; cd ~/doc/en_US.ISO8859-1/books/handbook +&prompt.user; make FORMATS=html + + + + Build HTML-Split and <acronym>PDF</acronym> Output + Files + + &prompt.user; cd ~/doc/en_US.ISO8859-1/books/handbook +&prompt.user; make FORMATS="html-split pdf" + +
+ The &os; Documentation Build Toolset