Date: Thu, 2 Sep 2004 17:21:01 +0000 From: Murray Stokely <murray@FreeBSD.org> To: doc@freebsd.org Subject: [murray@FreeBSD.org: cvs commit: doc/share/mk doc.docbook.mk doc.project.mk doc.slides.mk] Message-ID: <20040902172101.GB3031@hub.freebsd.org>
next in thread | raw e-mail | index | archive | help
FYI. "make clean" doesn't work right for HTML output because I don't see how to generate a manifest of the chunked files created by the XSLT stylesheets. Please let me know if you have experience with the DocBook slides DTD. doc.slides.mk could be extended in many ways to control what type of HTML or PDF is created. I think we first need some presentations in the tree, though. =) - Murray ----- Forwarded message from Murray Stokely <murray@FreeBSD.org> ----- From: Murray Stokely <murray@FreeBSD.org> Date: Thu, 2 Sep 2004 17:12:14 +0000 (UTC) To: doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org Subject: cvs commit: doc/share/mk doc.docbook.mk doc.project.mk doc.slides.mk murray 2004-09-02 17:12:14 UTC FreeBSD doc repository Modified files: share/mk doc.docbook.mk doc.project.mk Added files: share/mk doc.slides.mk Log: Add support for building documents in our doc/ tree marked up in Norman Walsh's DocBook Slides DTD. This DTD offers the vocabulary of simplified DocBook for presentations. Initially, the supported output formats are PDF and HTML. XSL stylesheets are used so libxslt is required. PassiveTeX is used for the PDF generation to convert the XSL-FO directly to PDF. This commit moves various TeX definitions out of doc.docbook.mk and into doc.project.mk, since docbook is no longer the only back-end to utilize TeX. An example Makefile would look like : ---- DOCFORMAT= slides DOC= slides SRCS= slides.xml DOC_PREFIX?= ${.CURDIR}/../../.. .include "${DOC_PREFIX}/share/mk/doc.project.mk" --- And an example slides file (slides.xml) looks like : --- <!DOCTYPE slides PUBLIC "-//Norman Walsh//DTD Slides XML V3.3.1//EN" "http://docbook.sourceforge.net/releases/slides/3.3.1/slides.dtd"> <slides> <slidesinfo> <title>What's new in FreeBSD 5.3</title> <titleabbrev>FreeBSD 5.3</titleabbrev> </slidesinfo> <foil><title>Introduction Slide</title> <para>Content</para> </foil> </slides> --- You could then build the HTML and PDF versions of the slides by typing "make FORMATS='pdf html'". Enjoy. Please coordinate with doceng@ before importing any presentations to doc/. Revision Changes Path 1.117 +0 -5 doc/share/mk/doc.docbook.mk 1.21 +8 -0 doc/share/mk/doc.project.mk 1.1 +63 -0 doc/share/mk/doc.slides.mk (new) ----- End forwarded message -----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040902172101.GB3031>