.\" Copyright (c) 2024 Joost van Baal-Ilić
.TH "caspar-typesetting" 7 "18 авг 2024" "caspar-typesetting 20240818" "MISCELLANEOUS "
.po 2m
.de ZI
.\" Zoem Indent/Itemize macro I.
.br
'in +\\$1
.nr xa 0
.nr xa -\\$1
.nr xb \\$1
.nr xb -\\w'\\$2'
\h'|\\n(xau'\\$2\h'\\n(xbu'\\
..
.de ZJ
.br
.\" Zoem Indent/Itemize macro II.
'in +\\$1
'in +\\$2
.nr xa 0
.nr xa -\\$2
.nr xa -\\w'\\$3'
.nr xb \\$2
\h'|\\n(xau'\\$3\h'\\n(xbu'\\
..
.if n .ll -2m
.am SH
.ie n .in 4m
.el .in 8m
..
.SH NAME
caspar-typesetting - Makefile snippets for common typesetting tasks
.SH SYNOPSIS
In a Makefile, write

.di ZV
.in 0
.nf \fC

  include caspar/mk/docbook\&.mk
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

or

.di ZV
.in 0
.nf \fC

  include caspar/mk/pod\&.mk
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

or

.di ZV
.in 0
.nf \fC

  include caspar/mk/markdown\&.mk
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

\&.
.SH DESCRIPTION
The caspar \fIdocbook\&.mk\fP, \fIpod\&.mk\fP and \fImarkdown\&.mk\fP files are Makefile snippets for common
typesetting tasks, like typesetting LaTeX (see [3]), DocBook
XML, DocBook SGML (see [2]), POD (see [1]) and Markdown (see [4]) documents\&.
You just have to type \fCmake\fP, instead of stuff like \fCjade -t tex -d
caspar/print\&.dsl /usr/share/sgml/declaration/xml\&.dcl foobar\&.dbx\fP\&.
.SH USAGE
In a directory where you maintain \&.dbx (Docbook XML) or \&.tex (LaTeX) files, do

.di ZV
.in 0
.nf \fC

   $ echo include caspar/mk/docbook\&.mk > Makefile

   $ vi karenina\&.dbx
   $ make karenina\&.view
   $ make karenina\&.print

   $ vi svejk\&.tex
   $ make svejk\&.view
   $ make svejk\&.print

   $ make
   $ make clean
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

Other targets: \fCfilename\&.ps\fP, \fCfilename\&.pdf\fP, \fCfilename\&.2ps\fP, \fCfilename\&.html\fP,
\fCfilename\&.printbig\fP, \fCfilename\&.dvi\fP\&.

Variables you might like to set in your Makefile: \fCXMLDCL\fP (default is
\fC/usr/share/sgml/declaration/xml\&.dcl\fP; if you\&'re not on a Debian GNU/Linux
system, you\&'ll likely have to adjust this), \fCHTML_DSL\fP, \fCPRINT_DSL\fP\&.

In a directory where you maintain \&.pod files, do

.di ZV
.in 0
.nf \fC

   $ echo include caspar/mk/pod\&.mk > Makefile
   $ vi lire\&.pod
   $ perldoc \&./lire\&.pod
   $ make lire\&.pdf
   $ make
   $ less lire\&.overstrike-txt
   $ make clean
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

Other targets: \fCfilename\&.ps\fP, \fCfilename\&.html\fP, \fCfilename\&.txt\fP, \&.\&.\&.
(Similar to the ones supplied by \fIdocbook\&.mk\fP)\&.

In a directory where you maintain CommonMark \&.md files, do

.di ZV
.in 0
.nf \fC

   $ echo include caspar/mk/markdown\&.mk > Makefile
   $ vi lire\&.md
   $ make lire\&.html
   $ make
   $ make clean
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

\&.
.SH EXAMPLES

Some examples: Overriding the caspar-supplied DSSSL files: Create your own
print\&.dls and html\&.dsl, in the same directory as your Docbook XML files\&. Your
Makefile should read:

.di ZV
.in 0
.nf \fC

 PRINT_DSL = print\&.dsl
 HTML_DSL = html\&.dsl
 include caspar/mk/docbook\&.mk
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

Overriding the standard html-to-text convertor:

.di ZV
.in 0
.nf \fC

 $ W3M=lynx make svejk\&.txt
.fi \fR
.in
.di
.ne \n(dnu
.nf \fC
.ZV
.fi \fR

\&.
.SH FILES
\fIcaspar/mk/docbook\&.mk\fP, \fIcaspar/mk/pod\&.mk\fP, \fIcaspar/mk/markdown\&.mk\fP\&.
.SH ENVIRONMENT
For \fIdocbook\&.mk\fP: files: \fCXMLDCL\fP, \fCHTML_DSL\fP, \fCPRINT_DSL\fP;
utilities: \fCJADE\fP, \fCPDFJADETEX\fP, \fCPDFLATEX\fP, \fCJADETEX\fP, \fCLATEX\fP,
\fCW3M\fP, \fCDVIPS\fP, \fCPSNUP\fP, \fCLPR\fP, \fCGV\fP; settings:
\fCJADE_MAXERRORS\fP\&. These variables can get adjusted in Makefile, as well as
in the shell environment\&.

The files \fIpod\&.mk\fP and \fImarkdown\&.mk\fP use no environment variables\&.
.SH AUTHOR
Joost van Baal-Ilić
.SH SEE ALSO
\fBcaspar(7)\fP
[1]
perlpod(1) about Perl\&'s Plain Old Documentation format

[2]
\fIDocBook: The Definitive Guide\fP on http://docbook\&.org/,

[3]
The LaTeX Project Homepage on http://www\&.latex-project\&.org/\&.

[4]
John Gruber\&'s Markdown homepage on
https://daringfireball\&.net/projects/markdown/\&.

Some comments on advanced usage are in the files \fIdocbook\&.mk\fP and \fIpod\&.mk\fP
itself\&.