From owner-freebsd-doc@FreeBSD.ORG  Thu Sep  2 17:21:01 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 815)
	id DC83116A4CF; Thu,  2 Sep 2004 17:21:01 +0000 (GMT)
Date: Thu, 2 Sep 2004 17:21:01 +0000
From: Murray Stokely <murray@FreeBSD.org>
To: doc@freebsd.org
Message-ID: <20040902172101.GB3031@hub.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.4.1i
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
Subject: [murray@FreeBSD.org: cvs commit: doc/share/mk doc.docbook.mk
	doc.project.mk doc.slides.mk]
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 02 Sep 2004 17:21:02 -0000

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 -----