There are many packages to do pictures in (La)TeX itself (rather than
importing graphics created externally), ranging from simple use of
LaTeX picture
environment, through enhancements like epic, to
sophisticated (but slow) drawing with PicTeX. Depending on your type
of drawing, and setup, four systems should be at the top of your list
to look at:
\special
s. You need a decent DVI to PostScript driver
(like dvips), but the results are worth it. The
well-documented package gives you not only low-level drawing
commands (and full colour) like lines, circles, shapes at arbitrary
coordinates, but also high-level macros for framing text, drawing
trees and matrices, 3D effects, and more.
Are you producing a thesis, and trying to obey regulations that were drafted in the typewriter era? Or are you producing copy for a journal that insists on double spacing for the submitted articles?
LaTeX is a typesetting system, so the appropriate design conventions are for ``real books''. If your requirement is from thesis regulations, find whoever is responsible for the regulations, and try to get the wording changed to cater for typeset theses (e.g., to say ``if using a typesetting system, aim to make your thesis look like a well-designed book''). (If your requirement is from a journal, you're probably even less likely to be able to get the rules changed, of course.)
If you fail to convince your officials, or want some inter-line space for copy-editing:
\baselinestretch
:
\renewcommand{\baselinestretch}{1.2}
may be enough to give
officials the impression you've kept to their regulations. Don't try
changing \baselineskip
: its value is reset at any size-changing
command.
Thesis styles are usually very specific to your University, so it's usually not profitable to ask around for a package outside your own University. Since many Universities (in their eccentric way) still require double-spacing, you may care to refer to the question on double-spacing. If you want to write your own, a good place to start is the University of California style (available as macros/latex/contrib/supported/ucthesis), but it's not worth going to a lot of trouble. (If officials won't allow standard typographic conventions, you won't be able to produce an aesthetically pleasing document anyway!)
There are several LaTeX packages that purport to do this, but they all have their limitations because the TeX machine isn't really designed to solve this sort of problem. Piet van Oostrum has conducted a survey of the available packages; he recommends:
picins
\parpic(width,height)(x-off,y-off)[Options][Position]{Picture}
Paragraph text
All parameters except the Picture are optional. The picture can be positioned left or right, boxed with a rectangle, oval, shadowbox, dashed box, and a caption can be given which will be included in the list of figures.
Unfortunately (for those of us whose understanding of German is not good), the documentation is in German. Piet van Oostrum has written an English summary macros/latex209/contrib/picins/picins.txt
floatflt
\begin{floatingfigure}[options]{width of figure} figure contents \end{floatingfigure}
There is a (more or less similar) floatingtable
environment.
The tables or figures can be set left or right, or alternating on even/odd pages in a double-sided document.
The package works with the multicol
package, but doesn't work well
in the neighbourhood of list environments (unless you change your
LaTeX document).
wrapfig
\begin{wrapfigure}[height of figure in lines]{l|r}[overhang]{width} figure, caption, etc. \end{wrapfigure}
The syntax of the wraptable
environment is similar.
Height can be omitted, in which case it will be calculated by the
package; the package will use the greater of the specified and the
actual width. The {l
,r
,etc.}
parameter can also be
specified as i
(nside) or o
(utside) for two-sided
documents, and uppercase can be used to indicate that the picture
should float. The overhang allows the figure to be moved into the
margin. The figure or table will entered into the list of figures
or tables if you use the \caption
command.
The environments do not work within list environments that end before the figure or table has finished, but can be used in a parbox or minipage, and in twocolumn format.
The standard LaTeX document classes define a small set of `page styles' which (in effect) specify head- and footlines for your document. The set defined is very restricted, but LaTeX is capable of much more; people occasionally set about employing LaTeX facilities to do the job, but that's quite unnecessary - Piet van Oostrum has already done the work.
The package is found in directory macros/latex/contrib/supported/fancyhdr and provides simple mechanisms for defining pretty much every head- or footline variation you could want; the directory also contains some (rather good) documentation and one or two smaller packages. Fancyhdr also deals with the tedious behaviour of the standard styles with initial pages, by enabling you to define different page styles for initial and for body pages.
A good way is to use Rainer Schöpf's verbatim.sty,
which provides a command \verbatiminput
that takes a file name
as argument. This package is available as part of macros/latex/required/tools
Another way is to use the alltt
environment, which requires
alltt.sty (which is now part of LaTeX). alltt
interprets
its contents `mostly' verbatim, but executes any TeX commands it
finds: so one can say:
\begin{alltt} \input{verb.txt} \end{alltt}
of course, this is little use for inputting (La)TeX source code...
The moreverb package (macros/latex/contrib/supported/moreverb) extends the
facilities of verbatim package), providing a listing
environment and a \listinginput
command, which line-number the text
of the file.
The fancyvrb package (macros/latex/contrib/supported/fancyvrb) offers configurable implementations of everything verbatim and moreverb have, and more besides. It is nowadays the package of choice for the discerning typesetter of verbatim text, but its wealth of facilities makes it a complex beast and study of the documentation is strongly advised.
For general numbering of lines, there are two packages for use with LaTeX, macros/latex/contrib/supported/lineno (which permits labels attached to individual lines of typeset output) and macros/latex/contrib/supported/numline/numline.sty
Both of these packages play fast and loose with the LaTeX output routine, which can cause problems: the user should beware\dots
If the requirement is for numbering verbatim text, the macros/latex/contrib/supported/moreverb or macros/latex/contrib/supported/fancyvrb packages (see including files in verbatim) may be used.
One common use of line numbers is in critical editions of texts, and for this the edmac package (macros/plain/contrib/edmac) offers comprehensive support.
Making an index is not trivial; what to index, and how to index it, is
difficult to decide, and uniform implementation is difficult to
achieve. You will need to mark all items to be indexed in your text
(typically with \index
commands).
It is not practical to sort a large index within TeX, so a post-processing program is used to sort the output of one TeX run, to be included into the document at the next run.
The following programs are available:
The Makeindex documentation is a good source of information on how to create your own index. Makeindex can be used with some TeX macro packages other than LaTeX, such as Eplain, and \TeXsis{}, nonfree/macros/texsis (whose macros, nonfree/macros/texsis/index/index.tex, can be used independently with plain).
glotex
) in indexing/glo+idxtex
There are other programs called texindex, notably one that comes with the Texinfo distribution.
URLs tend to be very long, and contain characters that would
naturally prevent them being hyphenated even if they weren't typically
set in \ttfamily
, verbatim. Therefore, without special treatment,
they often produce wildly overfull \hbox
es, and their typeset
representation is awful.
There are two approaches to this problem:
\path
command. The command
defines each potential break character as a \discretionary
, and
offers the user the opportunity of specifying a personal list of
potential break characters. Its chief disadvantage is fragility in
the LaTeX context.
\url
command (among others,
including its own \path
command). The command gives each
potential break character a maths-mode `personality', and then sets
the URL itself in the user's choice of font, in maths mode.
It can produce (LaTeX-style) `robust' commands
(\htmlonly{see }use of \protect
) for use
within moving arguments. Note that, because the operation is
conducted in maths mode, spaces within the URL argument are
ignored unless special steps are taken.
The author of this answer prefers the (rather newer) url.sty; both packages work equally well with plain TeX (though of course, the fancy LaTeX facilities of url.sty don't have much place there).
There is no citation type for URLs, per se, in the standard BibTeX styles, though Oren Patashnik (the author of BibTeX) is considering developing one such for use with the long-awaited BibTeX version 1.0.
The actual information that need be available in a citation of an URL is discussed at some length in the publicly available on-line extracts of ISO 690-2, available via http://www.nlc-bnc.ca/iso/tc46sc9/standard/690-2e.htm; the techniques below do not satisfy all the requirements of ISO 690-2, but they offer a solution that is at least available to users of today's tools.
Until the new version arrives, the simplest technique is to use the
howpublished
field of the standard styles' @misc
function. Of
course, the strictures
\htmlonly{about }typesetting URLs
still apply, so the entry will look like:
@misc{..., ..., howpublished = "\url{http://...}" }
Another possibility is that some conventionally-published paper, technical report (or even book) is also available on the Web. In such cases, a useful technique is something like:
@techreport{..., ..., note = "Also available as \url{http://...}" }
There is good reason to use macros/latex/contrib/other/misc/url.sty in this context, since (by
default) it ignores spaces in its argument. BibTeX has a habit of
splitting lines it considers excessively long, and if there are no
space characters for it to use as `natural' breakpoints, BibTeX
will insert a comment (`\textpercent
')
character ... which is an acceptable character in an URL,
so that \url
will typeset it. The way around the problem is to
insert odd spaces inside the URL itself in the .bib
file, to
enable BibTeX to make reasonable decisions about breaking the
line.
plain
TeX
The file macros/eplain/btxmac.tex contains macros and documentation
for using BibTeX with plain
TeX, either directly or with
Eplain.
See the use of BibTeX for more
information about BibTeX itself.
A powerful package which allows the typesetting of polyphonic and other multiple-stave music is MusicTeX, written by Daniel Taupin (taupin@rsovax.lps.u-psud.fr). It is available in macros/musictex
In the recent past, Daniel (as well as with various other people, notably Ross Mitchell and Andreas Egler) have been working on a development of MusicTeX, known as MusiXTeX. MusiXTeX is a three-pass system (with a processor program that computes values for the element spacing in the music), and achieves finer control than is possible in the unmodified TeX-based mechanism that MusicTeX uses. Daniel Taupin and Andreas Egler are pursuing distinct versions of MusiXTeX; they are available, respectively, from macros/musixtex/taupin and macros/musixtex/egler
Digital music fans can typeset notation for their efforts by using midi2tex, which translates MIDI data files into MusicTeX source code. It is available from support/midi2tex
A rather simpler notation than MusicTeX is supported by abc2mtex;
this is a package designed to notate tunes stored in an ASCII format
(abc
notation). It was designed primarily for folk and traditional
tunes of Western European origin (such as Irish, English and Scottish)
which can be written on one stave in standard classical notation.
However, it should be extendable to many other types of music. It is
available from support/abc2mtex
There is a mailing list for discussion of typesetting music in TeX.
To subscribe, send mail to mutex-request@stolaf.edu containing
the word `subscribe
' in the body.
Michael Levine's macro package for drawing Feynman diagrams in LaTeX is available in macros/latex209/contrib/feynman
Another possibility is Thorsten Ohl's macros/latex/contrib/supported/feynmf, that works in combination with METAFONT (or MetaPost). The feynmf or feynmp package reads a description of the diagram written in TeX, and writes out code. METAFONT (or MetaPost) can then produce a font (or PostScript file) for use in a subsequent LaTeX run. For new users, who have access to MetaPost, the PostScript version is probably the better route, for document portability and other reasons.