Changeset 173

Timestamp:

05/23/07 23:16:28 (5 years ago)

Author:

kate

Message:

A makefile for generating roff manpages.

Location:

trunk/Mk

Files:

• docbook.mk (modified) (2 diffs, 1 prop)
• man.mk (copied) (copied from trunk/Mk/docbook.mk) (1 diff, 1 prop)

trunk/Mk/docbook.mk

@@ +1 @@
+# $Id$
+# This Makefile deals with articles written in docbook, and rendering
+# those articles to varius formats (namely XHTML and PDF).
 
 # XSLT
@@ -23 +26 @@
 all: xhtml xhtml-single
 
-xhtml: $(XHTMLDIR)/$(NAME)/index.html 
+xhtml: $(XHTMLDIR)/$(NAME)/index.html
 
 xhtml-single: $(XHTMLDIR)/$(NAME)-single/index.html

trunk/Mk/man.mk

@@ +1 @@
+# $Id$
+# This Makefile provides rules for building manpages with docbook,
+# and rendering those pages to various formats (namely roff).
+
+# XXX are figures supported? We only use roff for ASCII output
+# (XHTML or TeX otherwise), so is that relevant? What about
+# tables (perhaps with the tbl macros)?
+
+# Just because I always forget: groff -man -Tascii <file> | less
 
 # XSLT
-DOCBOOK_XSL =   /usr/local/share/xsl/docbook
+# Currently we have no customisations here
 XSLT =                  xsltproc --xinclude
-XHTMLSTYLE ?=   ../doctools/xsl/docbook-chunked.xsl
-XHTMLSTYLE_SINGLE ?=    ../doctools/xsl/docbook-single.xsl
+MANSTYLE ?=     http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
 
-# PDF via dblatex (so much better than XSL-FO)
-# Requires dblatex, http://dblatex.sf.net 
-DBLATEX =               /usr/local/bin/dblatex
-PDFSTYLE =              simple
+MANDIR =                ../roff
+STYLEOPT=               --stringparam man.hyphenate 1 \
+                                --stringparam man.justify 1 \
+                                --stringparam man.hyphenate.urls 0 \
+                                --stringparam man.break.after.slash 1 \
+                                --stringparam man.hyphenate.filenames 0 \
+                                --stringparam man.hyphenate.computer.inlines 0 \
+                                --stringparam man.links.are.numbered 1 \
+                                --stringparam man.links.list.enabled 1
 
-XHTMLDIR =              ../xhtml
-PDFDIR =                ../pdf
-RESOURCES ?=    ../doctools/resources/*.css ../doctools/resources/*.png
-CSSFILE ?=              docs.css        
-STYLEOPT=               --stringparam html.stylesheet $(CSSFILE) \
-                                --stringparam chunker.output.encoding UTF-8 \
-                                --stringparam chunk.section.depth 0 \
-                                --stringparam project_url $(PROJECT_URL) \
-                                --stringparam project_name $(PROJECT_NAME)
+all: man
 
-all: xhtml xhtml-single
+man: $(MANDIR)/$(NAME)
 
-xhtml: $(XHTMLDIR)/$(NAME)/index.html 
+$(MANDIR)/$(NAME): $(MANDIR)
+        $(XSLT) $(STYLEOPT) -o $(MANDIR)/$(NAME) $(MANSTYLE) $(SOURCE)
 
-xhtml-single: $(XHTMLDIR)/$(NAME)-single/index.html
-
-pdf: $(PDFDIR)
-        $(DBLATEX) -T $(PDFSTYLE) $(SOURCE) -o $(PDFDIR)/$(NAME).pdf
-
-$(XHTMLDIR)/$(NAME)/index.html: resources
-        $(XSLT) $(STYLEOPT) -o $(XHTMLDIR)/$(NAME)/ $(XHTMLSTYLE) $(SOURCE)
-
-$(XHTMLDIR)/$(NAME)-single/index.html: resources-single
-        $(XSLT) $(STYLEOPT) -o $(XHTMLDIR)/$(NAME)-single/index.html $(XHTMLSTYLE_SINGLE) $(SOURCE)
-
-$(PDFDIR)/design.fo: $(PDFDIR)
-        $(XSLT) -o $(PDFDIR)/$(NAME).fo $(FOSTYLE) $(SOURCE)
-
-$(PDFDIR):
-        mkdir -p $(PDFDIR)
-
-$(XHTMLDIR)/$(NAME):
-        mkdir -p $(XHTMLDIR)/$(NAME)
-
-$(XHTMLDIR)/$(NAME)-single:
-        mkdir -p $(XHTMLDIR)/$(NAME)-single
-
-resources: $(XHTMLDIR)/$(NAME)
-        cp -r $(RESOURCES) $(XHTMLDIR)/$(NAME)
-
-resources-single: $(XHTMLDIR)/$(NAME)-single
-        cp -r $(RESOURCES) $(XHTMLDIR)/$(NAME)-single
+$(MANDIR):
+        mkdir -p $(MANDIR)
 
 clean: 
-        rm -rf $(XHTMLDIR)/$(NAME)
-        rm -rf $(XHTMLDIR)/$(NAME)-single
-        rm -rf $(PDFDIR)
+        rm -f $(MANDIR)/$(NAME)
 
 force: