BuildingDocumentation

Differences between revisions 1 and 4 (spanning 3 versions)

Building Documentation Yourself

Docteam documents are built with GNU make.

If you set up your svn repository according to DocteamStepByStepRepository, then the makefiles required for building the GNOME and KDE docs are in ubuntu-doc/gnome and ubuntu-doc/kde respectively.

To build the docs, open a terminal and change to the appropriate directory (either ubuntu-doc/gnome or ubuntu-doc/kde). The tables below show which commands to use to build a specific document or group of documents. You will need to following packages installed: make, docbook-xsl.

Note: These documents are all available on DocteamProjects.

Note: You will see a lot of errors like the following:

No localization exists for "c" or "". Using default "en".

Do not worry about this error; it does not affect the output.

GNOME Documents

Command	Document	Output File Location
make all	builds all documents	`ubuntu-doc/build/`
make qg	Ubuntu Quick Tour	`ubuntu-doc/build/gnome/quickguide/C/index.html`
make ag	Ubuntu Administrator Guide	`ubuntu-doc/build/gnome/adminguide/C/index.html`
make in	Ubuntu Installation Guide	`ubuntu-doc/build/gnome/ubuntu-install/C/index.html`
make au	About Ubuntu	`ubuntu-doc/build/gnome/about-ubuntu/C/index.html`
make rn	Release Notes	`ubuntu-doc/build/gnome/release-notes/C/index.html`
make faq	Builds all FAQs	See individual FAQ guides
make faqi386	FAQ for Intel platform	`ubuntu-doc/build/gnome/faqi386/C/index.html`
make faqamd64	FAQ for AMD 64 bit platform	`ubuntu-doc/build/gnome/faqamd64/C/index.html`
make faqppc	FAQ for Power PC platform	`ubuntu-doc/build/gnome/faqppc/C/index.html`
make sg	Docteam Style Guide	`ubuntu-doc/build/gnome/styleguide/C/index.html`
make status	builds a status report for each document	`ubuntu-doc/build/gnome/status`

Note: The style guide is applicable to both GNOME and KDE documents. It is included in the GNOME makefile purely for convenience.

KDE Documents

Command	Document	Output File Location
make kall	builds all documents	`ubuntu-doc/build/`
make kak	About Kubuntu	`ubuntu-doc/build/kde/about-kubuntu/C/index.html`
make kug	Kubuntu User Guide	`ubuntu-doc/build/kde/kuserguide/C/index.html`
make kag	Kubuntu Administrator Guide	`ubuntu-doc/build/kde/kadminguide/C/index.html`
make krn	Release Notes	`ubuntu-doc/build/kde/krelease-notes/C/index.html`
make kqg	Kubuntu Quick Guide	`ubuntu-doc/build/kde/kquickguide/C/index.html`
make kspec	Kubuntu doc specs	`ubuntu-doc/build/kde/kadminguide/C/index.html`
make kfaq	Builds all FAQs	See individual FAQ guides
make kfaqi386	FAQ for Intel platform	`ubuntu-doc/build/kde/kfaqi386/C/index.html`
make kfaqamd64	FAQ for AMD 64 bit platform	`ubuntu-doc/build/kde/kfaqamd64/C/index.html`
make kfaqppc	FAQ for Power PC platform	`ubuntu-doc/build/kde/kfaqppc/C/index.html`
make kin	Kubuntu Installation Guide	`ubuntu-doc/build/kde/kubuntu-install/C/index.html`
make kum	Kynaptic User Manual	`ubuntu-doc/build/kde/kynaptic/C/index.html`
make kstatus	builds a status report for each document	`ubuntu-doc/build/kde/status`

CategoryDocteam

DocumentationTeam/SystemDocumentation/BuildingDocumentation (last edited 2020-04-23 19:58:36 by dsmythies)

-  ⇤ ← Revision 1 as of 2005-05-28 20:11:18 → 
  Size: 1796
  Editor: adsl-213-190-44-43
  Comment: imported from the old wiki
+   ← Revision 4 as of 2005-09-18 13:54:20 → ⇥
  Size: 3874
  Editor: 81-178-149-216
  Comment: added packages needed to make documents
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-= DocteamBuildingDocumentation =
+= Building Documentation Yourself =
 Line 3:
-The makefile found in the root of the Subversion repository trunk directory can be used to transform the Docbook XML documents into presentational formats. As of this writing the only presentational format is HTML. We expect to add PDF shortly.
+Docteam documents are built with GNU {{{make}}}.
 Line 5:
-To use the makefile you will need to install GNU make (you'll find it in the 'make' package).
+If you set up your svn repository according to DocteamStepByStepRepository, then the makefiles required for building the GNOME and KDE docs are in {{{ubuntu-doc/gnome}}} and {{{ubuntu-doc/kde}}} respectively.
 Line 7:
-Other build dependencies for most of the documentation are the packages 'docbook-xsl' and 'xsltproc'.
+To build the docs, open a terminal and change to the appropriate directory (either {{{ubuntu-doc/gnome}}} or {{{ubuntu-doc/kde}}}). The tables below show which commands to use to build a specific document or group of documents. You will need to following packages installed: {{{make}}}, {{{docbook-xsl}}}.
 Line 9:
-To transform a document using make:
+'''Note:''' These documents are all available on DocteamProjects.
 Line 11:
-. Make trunk/ your present working directory
 2. Run the command {{{
make [targetname]
}}}
+'''Note:''' You will see a lot of errors like the following:
-Line 16:
+Line 13:
-If your build is very slow trying to download things from the Internet, try running make as: {{{
XML_CATALOG_FILES=/usr/share/xml/docbook/schema/dtd/4.3/catalog.xml make [targetname]
}}}
+       {{{No localization exists for "c" or "". Using default "en".}}}
-Line 20:
+Line 15:
-== Make Targets ==
+Do not worry about this error; it does not affect the output.
-Line 22:
+Line 17:
-The makefile provides the following targets:
+== GNOME Documents ==
-Line 24:
+Line 19:
- all:: builds all documents
 ug:: build the User's Guide (UserGuide) (outputs to trunk/build/userguide/)
 qg:: builds the Quick Guide (QuickGuide) (outputs to trunk/build/quickguide/)
 faq:: builds the Frequently Asked Questions ([FAQGuide]) (outputs to trunk/build/faqguide/)
 ag:: builds the Administrators Guide (AdminGuide) (outputs to trunk/build/adminguide/)
 abt:: builds the About Ubuntu page (AboutUbuntuPage) (outputs to trunk/build/about-ubuntu/home/)
 rn:: builds the Release Notes (outputs to trunk/build/release-notes/)
 status:: builds the Project Status Reports (outputs to trunk/build/reports/)
 dist:: builds documents and prepares a source tarball (outputs to trunk/ubuntu-docs/)
 clean:: removes any mess made during the builds
+||<:#f0f5fa>'''Command'''||<:#f0f5fa>'''Document'''||<:#f0f5fa>'''Output File Location'''||
##
||<:>'''make all'''||builds all documents||{{{ubuntu-doc/build/}}}||
##
||<:>'''make qg'''||Ubuntu Quick Tour||{{{ubuntu-doc/build/gnome/quickguide/C/index.html}}}||
##
||<:>'''make ag'''||Ubuntu Administrator Guide||{{{ubuntu-doc/build/gnome/adminguide/C/index.html}}}||
##
||<:>'''make in'''||Ubuntu Installation Guide||{{{ubuntu-doc/build/gnome/ubuntu-install/C/index.html}}}||
##
||<:>'''make au'''||About Ubuntu||{{{ubuntu-doc/build/gnome/about-ubuntu/C/index.html}}}||
##
||<:>'''make rn'''||Release Notes||{{{ubuntu-doc/build/gnome/release-notes/C/index.html}}}||
##
||<:>'''make faq'''||Builds all FAQs||See individual FAQ guides||
##
||<:>'''make faqi386'''||FAQ for Intel platform||{{{ubuntu-doc/build/gnome/faqi386/C/index.html}}}||
##
||<:>'''make faqamd64'''||FAQ for AMD 64 bit platform||{{{ubuntu-doc/build/gnome/faqamd64/C/index.html}}}||
##
||<:>'''make faqppc'''||FAQ for Power PC platform||{{{ubuntu-doc/build/gnome/faqppc/C/index.html}}}||
##
||<:>'''make sg'''||Docteam Style Guide||{{{ubuntu-doc/build/gnome/styleguide/C/index.html}}}||
##
||<:>'''make status'''||builds a status report for each document||{{{ubuntu-doc/build/gnome/status}}}||
-Line 35:
+Line 45:
-Example make command and target:
+'''Note:''' The style guide is applicable to both GNOME and KDE documents. It is included in the GNOME makefile purely for convenience.
-Line 37:
+Line 47:
-{{{
 make ug
}}}
+== KDE Documents ==
-Line 41:
+Line 49:
-To view any of these documents just open index.html found in the relevant build directory.
+||<:#f0f5fa>'''Command'''||<:#f0f5fa>'''Document'''||<:#f0f5fa>'''Output File Location'''||
##
||<:>'''make kall'''||builds all documents||{{{ubuntu-doc/build/}}}||
##
||<:>'''make kak'''||About Kubuntu||{{{ubuntu-doc/build/kde/about-kubuntu/C/index.html}}}||
##
||<:>'''make kug'''||Kubuntu User Guide||{{{ubuntu-doc/build/kde/kuserguide/C/index.html}}}||
##
||<:>'''make kag'''||Kubuntu Administrator Guide||{{{ubuntu-doc/build/kde/kadminguide/C/index.html}}}||
##
||<:>'''make krn'''||Release Notes||{{{ubuntu-doc/build/kde/krelease-notes/C/index.html}}}||
##
||<:>'''make kqg'''||Kubuntu Quick Guide||{{{ubuntu-doc/build/kde/kquickguide/C/index.html}}}||
##
||<:>'''make kspec'''||Kubuntu doc specs||{{{ubuntu-doc/build/kde/kadminguide/C/index.html}}}||
##
||<:>'''make kfaq'''||Builds all FAQs||See individual FAQ guides||
##
||<:>'''make kfaqi386'''||FAQ for Intel platform||{{{ubuntu-doc/build/kde/kfaqi386/C/index.html}}}||
##
||<:>'''make kfaqamd64'''||FAQ for AMD 64 bit platform||{{{ubuntu-doc/build/kde/kfaqamd64/C/index.html}}}||
##
||<:>'''make kfaqppc'''||FAQ for Power PC platform||{{{ubuntu-doc/build/kde/kfaqppc/C/index.html}}}||
##
||<:>'''make kin'''||Kubuntu Installation Guide||{{{ubuntu-doc/build/kde/kubuntu-install/C/index.html}}}||
##
||<:>'''make kum'''||Kynaptic User Manual||{{{ubuntu-doc/build/kde/kynaptic/C/index.html}}}||
##
||<:>'''make kstatus'''||builds a status report for each document||{{{ubuntu-doc/build/kde/status}}}||

----
CategoryDocteam

Ubuntu Wiki