Difference between revisions of "LaTeX:Basics"
Line 24: | Line 24: | ||
This will open up Adobe Reader and show your finished document. You can print the document from Adobe Reader if you like. | This will open up Adobe Reader and show your finished document. You can print the document from Adobe Reader if you like. | ||
+ | ==Style== | ||
+ | You'll develop your own style of using LaTeX. The sections below outline some tips that you'll find helpful. | ||
+ | |||
+ | |||
+ | === Space === | ||
+ | In LaTeX, you can use as much space as you like--LaTeX won't see it when it compiles. If you put in three spaces, it will only see one. If you put in 6 empty lines, it's the same as one. Therefore, this: | ||
+ | |||
+ | <pre><nowiki> | ||
+ | \documentclass{article} | ||
+ | \begin{document} | ||
+ | This is a sample document. | ||
+ | |||
+ | It illustrates how \LaTeX\ treats space. | ||
+ | \end{document} | ||
+ | </nowiki></pre> | ||
+ | results in the same as this: | ||
+ | <pre><nowiki> | ||
+ | \documentclass{article} | ||
+ | \begin{document} | ||
+ | This is a sample document. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | It illustrates how \LaTeX\ treats space. | ||
+ | \end{document} | ||
+ | </nowiki></pre> | ||
+ | Generally, write so that it's easy for you to read the source code. Don't pour in tons of space, but leave enough that you can easily find parts of the source file later. | ||
+ | |||
+ | TeXnicCenter (and most editors you might use for LaTeX) treats line numbering differently than your typical text editor. If you just type and type text without ever hitting <Enter> so that your text scrolls on to the next line, TeXnicCenter sees all that text on the next line as just a continuation of the previous line. This is no big deal if you never make a mistake, but when an error occurs when you compile, you usually have to find the mistake in your source file by line number. If you have a 4 or 5 line 'line', finding the error can be a real headache. (You can see what line you are on in TeXnicCenter by looking at the bottom towards the right.) | ||
+ | |||
+ | Just as LaTeX doesn't see tons of extra space, it won't see space that isn't there. One primary example of this is that LaTeX will only see linebreaks if there is an empty line or if you use the \linebreak command. Hence, this: | ||
+ | <pre><nowiki> | ||
+ | \documentclass{article} | ||
+ | \begin{document} | ||
+ | This is a sample document. It illustrates how \LaTeX\ treats space. | ||
+ | \end{document} | ||
+ | </nowiki></pre> | ||
+ | will produce the same result as: | ||
+ | <pre><nowiki> | ||
+ | \documentclass{article} | ||
+ | \begin{document} | ||
+ | This is a sample document. | ||
+ | It illustrates how \LaTeX\ treats space. | ||
+ | \end{document} | ||
+ | </nowiki></pre> | ||
+ | |||
+ | === Comments === | ||
+ | |||
+ | You can leave yourself (or later users of your source files) notes by using %. Anything in a line after % is ignored when the file is compiled. Try this: | ||
+ | <pre><nowiki> | ||
+ | \documentclass{article} | ||
+ | \begin{document} | ||
+ | %You won't see this in the final document. | ||
+ | You do see this. | ||
+ | \end{document} | ||
+ | </nowiki></pre> | ||
+ | You'll see that comments are grayed out in TeXnicCenter. Comments are very useful to guide other readers of your source file, and to guide you in case you'll come back to a file later. You'll find comments throughout our sample files. | ||
+ | |||
+ | === Including Packages === | ||
[[LaTeX:Math | Next: Math]] | [[LaTeX:Math | Next: Math]] |
Revision as of 17:06, 10 July 2007
LaTeX |
About - Getting Started - Diagrams - Symbols - Downloads - Basics - Math - Examples - Pictures - Layout - Commands - Packages - Help |
To create your first LaTeX document, start by opening a new file in TeXnicCenter. Start TeXnicCenter if you haven't already done so. To open a new file in TeXnicCenter, click File in the upper left, then click New. A blank document should open. Type the following lines (or copy and paste them):
\documentclass{article} \begin{document} Hello, world! \end{document}
Note that it is curly braces surrounding the words "article" and "document" in the above example, not parentheses. As you will see, curly braces are used everywhere in LaTeX.
Save the document (press Ctrl-S or click File, then Save) as 'Hello' (don't include the quote marks in the name) in a folder of your choice.
The file will appear in your folder as 'Hello.tex.' We will call this the source file. In order to create a finished LaTeX document, we need to compile the source file. First, make sure that the bar near the top of the TeXnicCenter window reads "LaTeX => PDF"; if it doesn't, change it so that it does. Then to compile the file, do any one of the following:
- Select "Build" -> "Current File" -> "Build" from the top menu bar
- Click on the "Build Current File" icon (it's the down-pointing arrow over the stack of papers, just to the right of the "LaTeX => PDF" bar)
- Press Ctrl-F7
You'll see some system messages scroll in the "Output" panel at the bottom of the window, and then eventually you should (hopefully) see the line "0 Error(s), 0 Warning(s), 0 Bad Box(es), 1 Page(s)". This means that your document (a PDF file) is ready. To view your document, do any one of the following:
- Select "Build -> "View Output" from the top menu bar
- Click on the "View Output" icons (it's the magnifying glass over the sheet of paper, just to the right of the "Build Current File" icon from above)
- Press F5
This will open up Adobe Reader and show your finished document. You can print the document from Adobe Reader if you like.
Style
You'll develop your own style of using LaTeX. The sections below outline some tips that you'll find helpful.
Space
In LaTeX, you can use as much space as you like--LaTeX won't see it when it compiles. If you put in three spaces, it will only see one. If you put in 6 empty lines, it's the same as one. Therefore, this:
\documentclass{article} \begin{document} This is a sample document. It illustrates how \LaTeX\ treats space. \end{document}
results in the same as this:
\documentclass{article} \begin{document} This is a sample document. It illustrates how \LaTeX\ treats space. \end{document}
Generally, write so that it's easy for you to read the source code. Don't pour in tons of space, but leave enough that you can easily find parts of the source file later.
TeXnicCenter (and most editors you might use for LaTeX) treats line numbering differently than your typical text editor. If you just type and type text without ever hitting <Enter> so that your text scrolls on to the next line, TeXnicCenter sees all that text on the next line as just a continuation of the previous line. This is no big deal if you never make a mistake, but when an error occurs when you compile, you usually have to find the mistake in your source file by line number. If you have a 4 or 5 line 'line', finding the error can be a real headache. (You can see what line you are on in TeXnicCenter by looking at the bottom towards the right.)
Just as LaTeX doesn't see tons of extra space, it won't see space that isn't there. One primary example of this is that LaTeX will only see linebreaks if there is an empty line or if you use the \linebreak command. Hence, this:
\documentclass{article} \begin{document} This is a sample document. It illustrates how \LaTeX\ treats space. \end{document}
will produce the same result as:
\documentclass{article} \begin{document} This is a sample document. It illustrates how \LaTeX\ treats space. \end{document}
Comments
You can leave yourself (or later users of your source files) notes by using %. Anything in a line after % is ignored when the file is compiled. Try this:
\documentclass{article} \begin{document} %You won't see this in the final document. You do see this. \end{document}
You'll see that comments are grayed out in TeXnicCenter. Comments are very useful to guide other readers of your source file, and to guide you in case you'll come back to a file later. You'll find comments throughout our sample files.