diff options
author | Beth Flanagan <elizabeth.flanagan@intel.com> | 2011-06-02 10:18:35 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2011-06-13 22:38:03 +0100 |
commit | 37eedd0ae3593f759a5e9e70e9dc1191171e09d0 (patch) | |
tree | ca2ae81c1163b3bdd7763d2e0dfcc5df282e5b72 /documentation/bsp-guide | |
parent | baf6bf4a5de176a5ad0fbaf436134c767eeed9ac (diff) | |
download | poky-37eedd0ae3593f759a5e9e70e9dc1191171e09d0.tar.gz |
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=<doc directory name>
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/<Release MM.mm>/<doc name>
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 <elizabeth.flanagan@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/bsp-guide')
-rw-r--r-- | documentation/bsp-guide/Makefile | 37 |
1 files changed, 0 insertions, 37 deletions
diff --git a/documentation/bsp-guide/Makefile b/documentation/bsp-guide/Makefile deleted file mode 100644 index 36ca48a62a..0000000000 --- a/documentation/bsp-guide/Makefile +++ /dev/null | |||
@@ -1,37 +0,0 @@ | |||
1 | XSLTOPTS = --stringparam html.stylesheet style.css \ | ||
2 | --stringparam chapter.autolabel 1 \ | ||
3 | --stringparam section.autolabel 1 \ | ||
4 | --stringparam section.label.includes.component.label 1 \ | ||
5 | --xinclude | ||
6 | |||
7 | ## | ||
8 | # These URI should be rewritten by your distribution's xml catalog to | ||
9 | # match your localy installed XSL stylesheets. | ||
10 | XSL_BASE_URI = http://docbook.sourceforge.net/release/xsl/current | ||
11 | XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl | ||
12 | |||
13 | all: html pdf tarball | ||
14 | |||
15 | pdf: | ||
16 | ../tools/poky-docbook-to-pdf bsp-guide.xml ../template | ||
17 | |||
18 | html: | ||
19 | # See http://www.sagehill.net/docbookxsl/HtmlOutput.html | ||
20 | xsltproc $(XSLTOPTS) -o bsp-guide.html bsp-guide-customization.xsl bsp-guide.xml | ||
21 | |||
22 | tarball: html | ||
23 | tar -cvzf bsp-guide.tgz style.css bsp-guide.html bsp-guide.pdf figures/bsp-title.png | ||
24 | |||
25 | validate: | ||
26 | xmllint --postvalid --xinclude --noout bsp-guide.xml | ||
27 | |||
28 | MANUALS = bsp-guide.html bsp-guide.pdf | ||
29 | FIGURES = figures/*.png | ||
30 | STYLESHEET = *.css | ||
31 | |||
32 | publish: | ||
33 | scp -r $(MANUALS) $(STYLESHEET) www.yoctoproject.org:/srv/www/www.yoctoproject.org-docs/bsp-guide | ||
34 | scp -r $(FIGURES) www.yoctoproject.org:/srv/www/www.yoctoproject.org-docs/bsp-guide/figures | ||
35 | |||
36 | clean: | ||
37 | rm -f $(OUTPUTS) | ||