I'm a Canadian based in Berlin, Germany. My day job is a Technical Writer in the API space. I write about topics such as technology, usability, creative writing and Canadian history. All views mine. I tweet at @glennjlea. Read more about me here or at LinkedIn.
Site version: 3.0

LaTeX quickstart

LaTeX can be used to develop very good technical documentation, but it requires the use of specific document classes, packages and settings.

What follows in this and upcoming topics is entirely my own experience having to create high quality user guides and manuals using LaTeX. Much of it was trial and error until I finally landed on a good set of tools to do the job. Consultants, clients and Stack Overflow helped considerably.

So, to get you up and running quickly, here is the most basic of LaTeX projects - an Article. The simple steps that follow will guide you through generating a pdf file from a sample LaTeX file.

Note: If you have some experience with LaTeX you can skip this topic and jump right in using the more details topics that follow this topic.

## 1. Install the Distributions

You first need to install a TeX distribution such as ProTeXt and MacTeX. You will also need an editor such as TeXnicCenter, TeXworks or Eclipse. Atom probably works just as well.

For this Quick Start, we will use the MikTex distribution and TeXworks editor. For MikTex, see miktex.org. For TeXworks, see github.com/TeXworks/texworks/releases They are relatively easy to install and set up. MikTex will install the base program and, if you make the selection, automatically install missing packages. TeXworks allows you to easily compile to PDF the documents.

So, select a distribution and choose a good LaTeX editor:

• Texmaker
• Texnicle

Note: For information about TeX distributions and LaTeX editors, see Installing LaTeX distributions

## 2. Create a Sample Document

Open a LaTeX editor such as TeXworks and enter in the following exactly as shown.

Here is the document in Texworks.

Quick Start document in Texworks.

## 3. Save the file

After entering the text, create a directory called /sampleLatex. Save the file you just created in that directory and call it QuickStart.tex.

## 4. Compile (build) the LaTeX File

The file needs to be built (or compiled) to generate a PDF file. The preferred way is to use a LaTeX editor such as TeXworks or TeXnicCenter.

In TeXworks, do the following:

1. Select the build option pdfLaTeX from the Build menu, then click Build (the arrow next to the dropdown menu).
2. The resultant pdf file is in the root of your project.

Here is the output of the LaTeX file as PDF.

Quick Start document PDF output.

Note: You could also use the command line if you have MikTex in your path. To build the LaTeX file using the command line. Follow the instructions in MikTex.