Languages and Unicode
Write in languages other than English: type accented letters directly, get the right hyphenation, quotation marks, and fixed words such as "Chapter" with babel, and set right-to-left and CJK text with XeLaTeX or LuaLaTeX.
Type characters directly
LaTeX reads source files as UTF-8, so you can type accented and special letters as they are. The accent commands still work and give the same output, which helps on a keyboard that lacks a letter.
Zoë, Søren, and François met in Kraków for crème brûlée.\par
Zo\"e, S\o ren, and Fran\c{c}ois met in Krak\'ow for cr\`eme br\^ul\'ee.Under pdfLaTeX, pair this with \usepackage[T1]{fontenc}, so that accented letters are real characters in the font and words that contain them can be hyphenated. Old documents also load inputenc with the utf8 option. That has been the default since 2018 and is no longer needed.
Set the language with babel
Loading babel with a language does three things: it switches to that language's hyphenation rules, translates the words LaTeX prints for you, and applies the language's typographic conventions.
\documentclass[varwidth=9cm, border=10pt]{standalone}
\usepackage[T1]{fontenc}
\usepackage[french]{babel}
\begin{document}
\contentsname, \abstractname, \refname, \appendixname.\par
Nous sommes le \today.
\end{document}The same change reaches every heading and caption that LaTeX generates: \chapter prints "Chapitre", \tableofcontents is titled "Table des matières", and the date follows French order.
Switch languages
List every language you use. The last one is the main language of the document. \selectlanguage switches everything from that point, \foreignlanguage covers a short phrase, and the otherlanguage environment covers a longer passage.
\documentclass[varwidth=9cm, border=10pt]{standalone}
\usepackage[T1]{fontenc}
\usepackage[ngerman, french, english]{babel}
\begin{document}
English is the main language. Today is \today.
\selectlanguage{french}
Le français suit. Nous sommes le \today.
\selectlanguage{english}
A German title in passing:
\foreignlanguage{ngerman}{\emph{Die Vermessung der Gezeiten}}.
\end{document}Mark foreign passages even when nothing visible changes. The hyphenation rules change with the language, and TeX breaks a German word badly if it applies English rules to it. The spell checker in TeXeR is separate from babel: set its language under Project settings, on the Editor tab.
Hyphenation
TeX hyphenates by rule, and the rules sometimes miss, mostly on technical compounds and names. \- marks the places where one occurrence of a word may break.
\parbox[t]{3.4cm}{We sealed the datalogger before launch.}\qquad
\parbox[t]{3.4cm}{We sealed the data\-logger before launch.}To fix a word everywhere, declare it once in the preamble. Separate several words with spaces.
\hyphenation{data-logger West-haven}To stop a word from breaking at all, put it in a box: \mbox{Westhaven}.
Quotation marks with csquotes
Quotation marks differ between languages, and typing them by hand ties the text to one convention. With the csquotes package you write \enquote, and the marks follow the current babel language. Nested quotes switch to the inner style on their own.
\documentclass[varwidth=10cm, border=10pt]{standalone}
\usepackage[T1]{fontenc}
\usepackage[ngerman, french, english]{babel}
\usepackage[autostyle]{csquotes}
\begin{document}
\enquote{English quotes with \enquote{nested} ones.}
\selectlanguage{french}
\enquote{Des guillemets français.}
\selectlanguage{ngerman}
\enquote{Deutsche Anführungszeichen.}
\end{document}Right-to-left and CJK text
pdfLaTeX handles Latin, Greek, and Cyrillic scripts well. For Arabic, Hebrew, Chinese, Japanese, or Korean, compile with XeLaTeX or LuaLaTeX, which read Unicode natively and use OpenType fonts through fontspec. In TeXeR, change the engine under Project settings, on the Compiler tab.
For right-to-left scripts, polyglossia takes the place of babel. Declare the languages and give the script a font that contains it. \textarabic sets a phrase, and the Arabic environment sets whole paragraphs from right to left.
\documentclass{article}
\usepackage{polyglossia}
\setmainlanguage{english}
\setotherlanguage{arabic}
\newfontfamily\arabicfont[Script=Arabic]{Amiri}
\begin{document}
The Arabic word for ``welcome'' is \textarabic{مرحبا}.
\begin{Arabic}
هذه فقرة كاملة تُكتب من اليمين إلى اليسار.
\end{Arabic}
\end{document}For Chinese, Japanese, and Korean under XeLaTeX, the xeCJK package assigns a font to CJK characters and breaks lines between them, so you can mix them freely with Latin text.
\documentclass{article}
\usepackage{xeCJK}
\setCJKmainfont{FandolSong-Regular.otf}
\begin{document}
Chinese and English on one line: 你好,世界 (hello, world).
\end{document}The font must exist where the document compiles
Both examples name a font, and the compile fails if the machine does not have it. TeXeR's compiler includes Amiri, so the Arabic example works there. It does not include xeCJK or a CJK font, so the CJK example needs a full TeX Live installation.
Common mistakes
- Typing a character the font setup does not cover under pdfLaTeX, such as a Greek letter in English text. TeX stops with "Unicode character α (U+03B1) not set up for use with LaTeX". Use the math command (
$\alpha$), load the language withbabel, or switch to XeLaTeX or LuaLaTeX. - Assuming the first language in the
babeloptions is the main one. It is the last, so[english, french]gives a French document with "Table des matières". Put the main language last. - Typing straight double quotes.
"word"prints straight or wrongly curled marks, and with German the"character is a shorthand that changes the next letter:"oprints "ö". Use\enquote. - Loading
inputencorfontencin a XeLaTeX or LuaLaTeX document. They are for pdfLaTeX and can garble the output. Usefontspecalone.