From 37eedd0ae3593f759a5e9e70e9dc1191171e09d0 Mon Sep 17 00:00:00 2001 From: Beth Flanagan Date: Thu, 2 Jun 2011 10:18:35 -0700 Subject: documentation: [YOCTO #1025] build system for docs These changes fix the following issues: 1. Multiple Makefiles. There really is no need for this. 2. Unable to maintain more than one version of the docs on the webserver. This is a quick fix to enable the above. In order to build the documentation, at the top level, issue a: make all DOC= make all DOC=kernel-manual Also, some changes need to occur on the webserver to fully incorporate these fixes. http://www.yoctoproject.org/documentation/ The docs are now published to: http://www.yoctoproject.org/docs// The main page should be changed to point not only to the current doc release, but also to the prior releases. This will enable us to maintain prior release documentation without stomping over it when we publish new docs. Also, we'll need to repoint the yocto-quick-start link to yocto-project-qs. Or rename documentation/yocto-project-qs/* to support the website naming. (From yocto-docs rev: 2651790d80fd32cd4619eeb5375f6ee28e7e7fda) Signed-off-by: Beth Flanagan Signed-off-by: Richard Purdie --- documentation/kernel-manual/Makefile | 38 ---------------------- .../kernel-manual/kernel-manual-customization.xsl | 8 +++++ .../yocto-project-kernel-manual-customization.xsl | 8 ----- 3 files changed, 8 insertions(+), 46 deletions(-) delete mode 100644 documentation/kernel-manual/Makefile create mode 100644 documentation/kernel-manual/kernel-manual-customization.xsl delete mode 100644 documentation/kernel-manual/yocto-project-kernel-manual-customization.xsl (limited to 'documentation/kernel-manual') diff --git a/documentation/kernel-manual/Makefile b/documentation/kernel-manual/Makefile deleted file mode 100644 index b691da8111..0000000000 --- a/documentation/kernel-manual/Makefile +++ /dev/null @@ -1,38 +0,0 @@ -XSLTOPTS = --stringparam html.stylesheet style.css \ - --stringparam chapter.autolabel 1 \ - --stringparam appendix.autolabel A \ - --stringparam section.autolabel 1 \ - --stringparam section.label.includes.component.label 1 \ - --xinclude - -## -# These URI should be rewritten by your distribution's xml catalog to -# match your localy installed XSL stylesheets. -XSL_BASE_URI = http://docbook.sourceforge.net/release/xsl/current -XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl - -all: html pdf tarball - -pdf: - ../tools/poky-docbook-to-pdf kernel-manual.xml ../template - -html: -# See http://www.sagehill.net/docbookxsl/HtmlOutput.html - xsltproc $(XSLTOPTS) -o kernel-manual.html yocto-project-kernel-manual-customization.xsl kernel-manual.xml - -tarball: html - tar -cvzf kernel-manual.tgz kernel-manual.html kernel-manual.pdf style.css figures/kernel-title.png figures/kernel-architecture-overview.png - -validate: - xmllint --postvalid --xinclude --noout kernel-manual.xml - -MANUALS = kernel-manual.html kernel-manual.pdf -FIGURES = figures/*.png -STYLESHEET = *.css - -publish: - scp -r $(MANUALS) $(STYLESHEET) www.yoctoproject.org:/srv/www/www.yoctoproject.org-docs/kernel-manual - scp -r $(FIGURES) www.yoctoproject.org:/srv/www/www.yoctoproject.org-docs/kernel-manual/figures - -clean: - rm -f $(OUTPUTS) diff --git a/documentation/kernel-manual/kernel-manual-customization.xsl b/documentation/kernel-manual/kernel-manual-customization.xsl new file mode 100644 index 0000000000..8eb69050ba --- /dev/null +++ b/documentation/kernel-manual/kernel-manual-customization.xsl @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/documentation/kernel-manual/yocto-project-kernel-manual-customization.xsl b/documentation/kernel-manual/yocto-project-kernel-manual-customization.xsl deleted file mode 100644 index 8eb69050ba..0000000000 --- a/documentation/kernel-manual/yocto-project-kernel-manual-customization.xsl +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - - - -- cgit v1.2.3-54-g00ecf