Little Helpers for Scientific Writing with LaTeX

Introduction

The document preparation system LaTeX is well-suited for scientific writing. But which additional components are required? In this article, I will describe how to install all the necessary programs and packages on a Ubuntu-Linux system to write publications conveniently. The tutorial equally applies to Debian systems, Windows users have to modify the installation procedures accordingly.

Requirements, Prerequisites

  1. I would like to use vim as edi­tor.
  2. The result should be a PDF file.
  3. After changes to the manuscript, all necessary processing steps (calling latex, bibtex) shall be triggered automatically with one command.
  4. I would like to cite my references using APA Style. That is required by the journal of my choice.

Text­ Edi­tor VIM

VIM is a strong tool for editing text. You will find a version on most Linux systems. The VIM-​​LaTeX-​​Suite is a handy tool for a better integration of LaTeX.

<br /> any_directory$ sudo apt-get install vim<br />

Although there is a vim-latexsuite package, I advise not to use it. Rather install the package directly in your home directory.

latexmk

The Perl script latexmk is very useful to automate the document generation. It determines the dependencies (included images and bibliography), checks the status of all files and runs all necessary steps. Without latexmk you have to repeatedly execute the single steps (calling latex, bibtex) to get an output which reflects all changes.

You have to install Perl (if not already available on your system) and the script itself. Windows users should install Active Perl.

<br /> any_directory$ sudo apt-get install perl<br /> any_directory$ sudo apt-get install latexmk<br />

Using latexmk for PDF output looks like this:

<br /> project_directory$ latexmk -pdf dokument.tex<br />

bibla­tex

Although the biblatex package is still beta, I liked the sheer power of it and have used it for my references. Originally I was looking for a solution to use chapter-wise references, but biblatex can do much more and makes reference handling much easier as before. It combines the functionality of a variety of packages.

<br /> any_directory$ sudo apt-get install biblatex<br />

There are new macros for citing references. To make an indirect quote, which is most common for engineers, you would use \parencite{key}. The macro \printbibliography creates the list of all cited references. The appearance of the quotes and bibliography is determined by citation styles.

<br /> \usepackage[style=apa]{biblatex}<br /> \bibliography{bibfile_name}<br />

The APA style is available for biblatex but has to be installed manually. After copying the style files you have to update your texmf tree.

<br /> any_directory$ sudo texconfig rehash<br />

One problem at this stage was an outdated csquotes package. I had to correct that manually as well.

Conclusion

After some work I have a complete system ready for editing my third publication.