TranslateProject/sources/tech/20170623 A introduction to creating documents in LaTeX.md

translating by chenxinlong
A introduction to creating documents in LaTeX

Learn to typeset documents in the LaTeX text markup language.

Image by : opensource.com

LaTeX (pronounced  lay-tech ) is a method of creating documents using plain text, stylized using markup tags, similar to HTML/CSS or Markdown. LaTeX is most commonly used to create documents for academia, such as academic journals. In LaTeX, the author doesn't stylize the document directly, like in a word processor such as Microsoft Word, LibreOffice Writer, or Apple Pages; instead they write code in plain text that must be compiled to produce a PDF document.

intro.png

How to get started

To write in LaTeX, you'll need to install a LaTeX editor. I use a piece of free and open source software (FOSS) popular with academics called TexStudio, which runs on Windows, Unix/Linux, BSD, and Mac OS X. You'll also need to install a distribution of the Tex typesetting system. I am writing on MacOS, so I use a distribution called MacTex or BasicTex. For Windows you can use MiKTex, and Linux users should be able to find it in their repository.

Once you have downloaded TexStudio and a distribution of LaTeX, you should be ready to start typesetting your documents.

Create your first document

In this short tutorial, we'll create a simple article with a headline, a subhead, and two paragraphs.

After you launch TexStudio, save your new document. (I called mine helloworld.tex, since I'm writing this tutorial in the Hello, World! tradition from programming.) Next, you need to add some boilerplate code at the top of your .tex file that specifies the type and size of your document. This is similar to the boilerplate code used in HTML5 documents.

My code (below) sets the page size to A4 and the text size to 12pt. You can put this code into TexStudio and edit it with your own page size, font size, name, title, and other details:

\documentclass[a4paper,12pt]{article}
\begin{document}
\title{Hello World! My first LaTeX document}
\author{Aaron Cocker}
\date{\today}
\maketitle

content will go here 

\end{document}

Next, click on the large green arrow to compile the document. That's the middle button in the screenshot below.

compile.png

If there are any errors, they'll appear in the dialog box at the bottom.

After you compile the document, you can see what it will look like by viewing a PDF within the program as a sort of WYSIWYG preview. Remember it must be recompiled whenever you make a change to the code, as you would when programming in C++, for example.

To view your document, click on Tools > Commands > View PDF, as shown in the screenshot below.

view_as_pdf.png

The PDF output will be shown on the right, like this:

pdf_output.png

Now you can add a paragraph. First give it a subhead by using the **\section{}**command. Type the subhead title between the curly braces of the command; I called my subhead Introduction.

\section{Introduction}

Now that you have labeled the paragraph with its subhead, it's time to write the paragraph. For this example, I used the Lipsum lorem ipsum generator. To create the paragraph, type the \paragraph{} command, then add your text  underneath ,  NOT within , the curly braces, inserted between \maketitle and \end{document}.

This is what my paragraph code looks like:

\section{Introduction}

\paragraph{}
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem nisi, tincidunt tempus sem nec, elementum feugiat ipsum. Nulla in diam libero. Nunc tristique ex a nibh egestas sollicitudin. 

\paragraph{}
Mauris efficitur vitae ex id egestas. Vestibulum ligula felis, pulvinar a posuere id, luctus vitae leo. Sed ac imperdiet orci, non elementum leo. Nullam molestie congue placerat. Phasellus tempor et libero maximus commodo.

Your document is now finished, so you can export and save it as a PDF file by using Save As (just as you would with most programs).

Here's what my finished document and the corresponding code look like:

finished_document.png

All my code from this tutorial is available below:

\documentclass[a4paper,12pt]{article}
\begin{document}
\title{Hello World! My first LaTeX document}
\author{Aaron Cocker}
\date{\today}
\maketitle

\section{Introduction}

\paragraph{}
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cras lorem nisi, tincidunt tempus sem nec, elementum feugiat ipsum. Nulla in diam libero. Nunc tristique ex a nibh egestas sollicitudin. 

\paragraph{}
Mauris efficitur vitae ex id egestas. Vestibulum ligula felis, pulvinar a posuere id, luctus vitae leo. Sed ac imperdiet orci, non elementum leo. Nullam molestie congue placerat. Phasellus tempor et libero maximus commodo.

\end{document}

Learn more

Among the thousands of excellent resources on writing in LaTeX are the guides produced by most universities, which are indexable and can be found on Google search. Princeton University offers a good extended tutorial, and for a deeper dive, the Princeton guide's creator, Donald Knuth, offers The TexBook, the ultimate guide to LaTeX.

---

作者简介：

Aaron Cocker - BSc Computing student attending university in the UK. I am an aspiring Data Scientist. My favourite language is Python. Feel free to contact me at aaron@aaroncocker.org.uk or visit my personal website: https://aaroncocker.org.uk

---

via: https://opensource.com/article/17/6/introduction-latex

作者： Aaron Cocker 译者：chenxinlong 校对：校对者ID

本文由 LCTT 原创编译，Linux中国 荣誉推出