Certain parts of org-mode have dependencies on external packages. This file documents these dependencies. Many sections are placeholders, waiting for input. If you can, please contribute. If you think that another section should be added, please add it and fill it out. Also, if you spot any mistakes, omissions or superfluities, please fix them. If you have an account, you can clone the Worg tree and make the additions/fixes (see http://orgmode.org/worg/worg-git.php for more information), but if you don't or don't want to do it yourself, that's fine too: a note to the orgmode mailing list will also do the job. Thanks!
Version: Org-mode version 7.01trans (release_7.01h.224.gf6c09)
The LaTeX class is selected using the construct
org-latex predefines the treatment of the following LaTeX classes article, report, book, beamer - or you can roll your own. And you can, of course, customize the treatment to your heart's content. This assumes a standard LaTeX install.
On Linux/Mac OSX/BSD, the TeXlive distribution is recommended. On Windows, most people prefer MikTeX.
The best way to get these packages is by using the package manager that comes with your operating system. These generally contain many useful LaTeX packages.
If that is not possible, then you can get individual LaTeX packages from the CTAN sites (see CTAN archives for more information), but the installation process is less straightforward (but more portable): generally speaking, a LaTeX package comes in two files: a .ins file and a .dtx file (usually packed in a zip or tgz archive). Processing the .ins file through latex separates out the code from the .dtx file and produces the pieces that need to be installed on your system, but then it is up to you to figure out where to copy these files on your system for TeX and friends to find them. Processing the .dtx file directly through latex produces the documentation of the package:
Many questions are answered by the TeX FAQ site, although the search capability is fairly primitive by today's standards: you will have to search a bit more diligently.
The LaTeX packages included by default are as follows:
|LaTeX package||Ubuntu container package||Options||Comments|
|fixltx2e||texlive-latex-base||Various LaTeX fixes - fix-cm too?|
|wrapfig||texlive-latex-extra||text wrapping around figures|
|t1enc||texlive-latex-base||Obsolete - remove?|
|textcomp||texlive-latex-base||Misc text symbols|
LaTeX syntax can be used to introduce many special symbols into a document (e.g. mathematical symbols). Most of these symbols are defined by basic LaTeX, but some require the presence of extra packages.
|LaTeX macro||Rendered Symbol (approx)||LaTeX package||Ubuntu container package|
Note that marvosym is now included as part of the default setup so you do not need to include the package explicitly.
PDF export goes through LaTeX export first, so all the LaTeX dependencies apply here as well.
Certain PDF viewers have been reported to produce more or less unreadable files if Adobe Type3 fonts are used in the document. Evince has been identified as one of those. One way around this problem is to not use Type3 fonts. Another is to use a viewer that does not mistreat Type 3 fonts.
You can find more information about this problem in the TeX FAQ:
To find out whether a document uses Type3 fonts, open it with Acrobat Reader/Evince, select Properties from the File menu and then select the Fonts tab; alternatively, use the pdffonts program (part of the xpdf-reader package) from the command line.
It is probably impossible to get rid of Type3 fonts completely (particularly if you are using special symbols or languages that don't use the Latin alphabet: in such cases, font availability is more limited and you just might not be able to find Type1 fonts to do the job).
For standard latin-alphabet languages that use the Computer Modern fonts (including small variations e.g. Polish and Czech), you *can* find Type1 versions: (XXX-needs fixing) the texlive-fonts-extra package (on Ubuntu/Debian) e.g. includes the AMS CM fonts which work well. Similar packages exist for other Linux distributions and probably for other operating systems as well.
|Type1 font||LaTeX package||Ubuntu container package|
LaTeX fragments can be exported as images for inclusion into HTML documents. For example, complicated mathematical expressions can be dealt with this way. This is done by creating a LaTeX file that contains the fragment, processing it through LaTeX to produce a DVI file and then processing it through dvipng. So, in addition to LaTeX, you will need dvipng: on Ubuntu, this is available in the "dvipng" package.
The LaTeX file contains a somewhat different list of LaTeX packages. Note that this is the default list, determined by the value of the variable ``org-format-latex-header''.
|LaTeX package||Ubuntu container package||Options|