<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (c) 2012 Joost van Baal-Ilić -->
<head>
<meta name="keywords" content="manual">
<style type="text/css">
/* START aephea.base.css */
body
{ text-align: justify;
margin-left: 0%;
margin-right: 0%;
}
a:link { text-decoration: none; }
a:active { text-decoration: none; }
a:visited { text-decoration: none; }
a:link { color: #1111aa; }
a:active { color: #1111aa; }
a:visited { color: #111166; }
a.local:link { color: #11aa11; }
a.local:active { color: #11aa11; }
a.local:visited { color: #116611; }
a.intern:link { color: #1111aa; }
a.intern:active { color: #1111aa; }
a.intern:visited { color: #111166; }
a.extern:link { color: #aa1111; }
a.extern:active { color: #aa1111; }
a.extern:visited { color: #661111; }
a.quiet:link { color: black; }
a.quiet:active { color: black; }
a.quiet:visited { color: black; }
div.verbatim
{ font-family: monospace;
margin-top: 1em;
margin-bottom: 1em;
font-size: 10pt;
margin-left: 2em;
white-space: pre;
}
div.indent
{ margin-left: 8%;
margin-right: 0%;
}
.right { text-align: right; }
.left { text-align: left; }
.nowrap { white-space: nowrap; }
.item_leader
{ position: relative;
margin-left: 8%;
}
.item_compact { position: absolute; vertical-align: baseline; }
.item_cascade { position: relative; }
.item_leftalign { text-align: left; }
.item_rightalign
{ width: 2em;
text-align: right;
}
.item_compact .item_rightalign
{ position: absolute;
width: 52em;
right: -2em;
text-align: right;
}
.item_text
{ position: relative;
margin-left: 3em;
}
.smallcaps { font-size: smaller; text-transform: uppercase }
/* END aephea.base.css */
body { font-family: "Garamond", "Gill Sans", "Verdana", sans-serif; }
body
{ text-align: justify;
margin-left: 8%;
margin-right: 8%;
}
</style>
<title>caspar-typesetting</title>
</head>
<body>
<p style="text-align:right">
8 mai 2012
<a class="local" href="caspar-typesetting.ps"><b>caspar-typesetting</b></a>
20120508
</p>
<div class=" itemize " style="margin-top:1em; font-size:100%">
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">1.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#name">NAME</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">2.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#synopsis">SYNOPSIS</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">3.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#description">DESCRIPTION</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">4.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#usage">USAGE</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">5.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#examples">EXAMPLES</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">6.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#files">FILES</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">7.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#environment">ENVIRONMENT</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">8.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#author">AUTHOR</a>
</div>
<div class=" item_compact"><div class=" item_rightalign nowrap " style="right:-3em">9.</div></div>
<div class=" item_text " style="margin-left:4em">
<a class="intern" href="#seealso">SEE ALSO</a>
</div>
</div>
<a name="name"></a>
<h2>NAME</h2>
caspar-typesetting - Makefile snippets for common typesetting tasks
<a name="synopsis"></a>
<h2>SYNOPSIS</h2>
In a Makefile, write
<div class="verbatim">
include caspar/mk/docbook.mk
</div>
or
<div class="verbatim">
include caspar/mk/pod.mk
</div>
.
<a name="description"></a>
<h2>DESCRIPTION</h2>
The caspar <i>docbook.mk</i> and <i>pod.mk</i> files are Makefile snippets for common
typesetting tasks, like typesetting LaTeX (see <a class="intern" href="#latex">[3]</a>), DocBook
XML, DocBook SGML (see <a class="intern" href="#dbx">[2]</a>) and POD (see <a class="intern" href="#pod">[1]</a>) documents.
You just have to type <tt>make</tt>, instead of stuff like <tt>jade -t tex -d
caspar/print.dsl /usr/share/sgml/declaration/xml.dcl foobar.dbx</tt>.
<a name="usage"></a>
<h2>USAGE</h2>
In a directory where you maintain .dbx (Docbook XML) or .tex (LaTeX) files, do
<div class="verbatim">
$ 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
</div>
Other targets: <tt>filename.ps</tt>, <tt>filename.pdf</tt>, <tt>filename.2ps</tt>, <tt>filename.html</tt>,
<tt>filename.printbig</tt>, <tt>filename.dvi</tt>.
<p style="margin-bottom:0" class="asd_par">
Variables you might like to set in your Makefile: <tt>XMLDCL</tt> (default is
<tt>/usr/share/sgml/declaration/xml.dcl</tt>; if you're not on a Debian GNU/Linux
system, you'll likely have to adjust this), <tt>HTML_DSL</tt>, <tt>PRINT_DSL</tt>.
</p> <p style="margin-bottom:0" class="asd_par">
In a directory where you maintain .pod files, do
<div class="verbatim">
$ echo include caspar/mk/pod.mk > Makefile
$ vi lire.pod
$ perldoc ./lire.pod
$ make lire.pdf
$ make
$ less lire.overstrike-txt
$ make clean
</div>
Other targets: <tt>filename.ps</tt>, <tt>filename.html</tt>, <tt>filename.txt</tt>, ...
(Similar to the ones supplied by <i>docbook.mk</i>).
</p>
<a name="examples"></a>
<h2>EXAMPLES</h2>
<p style="margin-bottom:0" class="asd_par">
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:
<div class="verbatim">
PRINT_DSL = print.dsl
HTML_DSL = html.dsl
include caspar/mk/docbook.mk
</div>
Overriding the standard html-to-text convertor:
<div class="verbatim">
$ W3M=lynx make svejk.txt
</div>
.
</p>
<a name="files"></a>
<h2>FILES</h2>
<i>caspar/mk/docbook.mk</i>, <i>caspar/mk/pod.mk</i>
<a name="environment"></a>
<h2>ENVIRONMENT</h2>
For <i>docbook.mk</i>: files: <tt>XMLDCL</tt>, <tt>HTML_DSL</tt>, <tt>PRINT_DSL</tt>;
utilities: <tt>JADE</tt>, <tt>PDFJADETEX</tt>, <tt>PDFLATEX</tt>, <tt>JADETEX</tt>, <tt>LATEX</tt>,
<tt>W3M</tt>, <tt>DVIPS</tt>, <tt>PSNUP</tt>, <tt>LPR</tt>, <tt>GV</tt>; settings:
<tt>JADE_MAXERRORS</tt>. These variables can get adjusted in Makefile, as well as
in the shell environment.
<p style="margin-bottom:0" class="asd_par">
<i>pod.mk</i> Uses no environment variables.
</p>
<a name="author"></a>
<h2>AUTHOR</h2>
Joost van Baal-Ilić
<a name="seealso"></a>
<h2>SEE ALSO</h2>
<a class="local sibling" href="caspar.html">caspar(7)</a>
<a name="pod">[1]</a>
perlpod(1) about Perl's Plain Old Documentation format
<p style="margin-bottom:0" class="asd_par">
<a name="dbx">[2]</a>
<i>DocBook: The Definitive Guide</i> on <a class="extern" href="http://docbook.org/">http://docbook.org/</a>,
</p> <p style="margin-bottom:0" class="asd_par">
<a name="latex">[3]</a>
The LaTeX Project Homepage on <a class="extern" href="http://www.latex-project.org/">http://www.latex-project.org/</a>.
</p> <p style="margin-bottom:0" class="asd_par">
Some comments on advanced usage are in the files <i>docbook.mk</i> and <i>pod.mk</i>
itself.
</p>
</body>
</html>
distrib
>
Mageia
>
5
>
x86_64
>
media
>
core-release
>
by-pkgid
>
2d7fa9436318cac150a12ef8a1ca0c85
>
files
>
26
