From owner-cvs-doc@FreeBSD.ORG  Thu Sep  2 17:12:14 2004
Return-Path: <owner-cvs-doc@FreeBSD.ORG>
Delivered-To: cvs-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id AB15C16A4CE; Thu,  2 Sep 2004 17:12:14 +0000 (GMT)
Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 9B2DC43D49; Thu,  2 Sep 2004 17:12:14 +0000 (GMT)
	(envelope-from murray@FreeBSD.org)
Received: from repoman.freebsd.org (localhost [127.0.0.1])
	by repoman.freebsd.org (8.12.11/8.12.11) with ESMTP id i82HCEk4091625;
	Thu, 2 Sep 2004 17:12:14 GMT
	(envelope-from murray@repoman.freebsd.org)
Received: (from murray@localhost)
	by repoman.freebsd.org (8.12.11/8.12.11/Submit) id i82HCEAM091624;
	Thu, 2 Sep 2004 17:12:14 GMT
	(envelope-from murray)
Message-Id: <200409021712.i82HCEAM091624@repoman.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
X-FreeBSD-CVS-Branch: HEAD
Subject: cvs commit: doc/share/mk doc.docbook.mk doc.project.mk
 doc.slides.mk
X-BeenThere: cvs-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the doc and www trees <cvs-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-doc>,
	<mailto:cvs-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-doc>
List-Post: <mailto:cvs-doc@freebsd.org>
List-Help: <mailto:cvs-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-doc>,
	<mailto:cvs-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 02 Sep 2004 17:12:14 -0000

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)