Vizualizare sursă pentru „LaTeX/Internaționalizare”

<noinclude>{{LaTeX/Top}}</noinclude>

LaTeX has to be configured and used appropriately when it is used to write documents in languages other than English.  This has to address three main areas:

# LaTeX needs to know how to hyphenate the language(s) to be used.
# The user needs to use language-specific typographic rules. In French for example, there is a mandatory space before each colon character (:).
# The input of special characters, especially for languages using an input system (Arab, Chinese, Japanese, Korean).

It is convenient to be able to insert language-specific special characters directly from the keyboard instead of using cumbersome coding (for example, by typing <tt>ä</tt> instead of <tt>\"{a}</tt>). This can be done by configuring input encoding properly. We will not tackle this issue here: see the [[LaTeX/Special Characters|Special Characters]] chapter.

Some languages require special fonts with the proper font encoding set. See [[LaTeX/Fonts#Font encoding|Font encoding]].

Some of the methods described in this chapter may be useful when dealing with non-English author names in bibliographies.

Here is a collection of suggestions about writing a LaTeX document in a language other than English. If you have experience in a language not listed below, please add some notes about it.

== Prerequisites ==

Most non-english language will need to input special characters very often. For a convenient writing you will need to set the input encoding and the font encoding properly.

The following configuration is optimal for many languages (most latin languages). Make sure your document is saved using the UTF-8 encoding.

<source lang="latex" enclose="none">
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
</source>


{{Warning|In the following document we will assume you are using this configuration unless otherwise specified.}}

For more details check [[LaTeX/Fonts#Font encoding|Font encoding]] and [[LaTeX/Special Characters|Special Characters]].

== Babel ==

The {{LaTeX/Package|babel}} package by Johannes Braams and Javier Bezos will take care of everything (with XeTeX and LuaTeX you should consider {{LaTeX/Package|polyglossia}}). You can load it in your preamble, providing as an argument name of the language you want to use (usually its English name, but not always):



<source lang="latex" enclose="none">
\usepackage[language]{babel}
</source>


You should place it soon after the {{LaTeX/LaTeX|code=\documentclass<!---->}} command, so that all the other packages you load afterwards will know the language you are using. Babel will automatically activate the appropriate hyphenation rules for the language you choose. If your LaTeX format does not support hyphenation in the language of your choice, babel will still work but will disable hyphenation, which has quite a negative effect on the appearance of the typeset document. Babel also specifies new commands for some languages, which simplify the input of special characters. See the sections about languages below for more information.

If you call babel with multiple languages:

<source lang="latex" enclose="none">
\usepackage[languageA,languageB]{babel}
</source>

then the last language in the option list will be active (i.e. languageB), and you can use the command

<source lang="latex" enclose="none">
\selectlanguage{languageA}
</source>
to change the active language. You can also add short pieces of text in another language using the command

<source lang="latex" enclose="none">
\foreignlanguage{languageB}{Text in another language}
</source>

Babel also offers various environments for entering larger pieces of text in another language:


<source lang="latex" enclose="none">
\begin{otherlanguage}{languageB}
Text in language B. This environment switches all language-related definitions, like the language 
specific names for figures, tables etc. to the other language.
\end{otherlanguage}
</source>

The starred version of this environment typesets the main text according to the rules of the other language, but keeps the language specific string for ancillary things like figures, in the main language of the document. The environment <tt>hyphenrules</tt> switches only the hyphenation patterns used; it can also be used to disallow hyphenation by using the language name 'nohyphenation' (but note <tt>selectlanguage*</tt> is preferred).

The [http://ftp.snt.utwente.nl/pub/software/tex/macros/latex/required/babel/base/babel.pdf babel manual] provides much more information on these and many other options.

== Multilingual versions ==

It is possible in LaTeX to typeset the content of one document in several languages and to choose upon compilation which language to output. This might be convenient to keep a consistent sectioning and formatting across the different languages. It is also useful if you make use of multiple proper nouns and other untranslated content. Using the commands above in multilingual documents can be cumbersome, and therefore {{LaTeX/Package|babel}}  provides a way to define shorter names. With 
{{LaTeX/Usage|code=
\babeltags{de = german}
}}
You can write:
{{LaTeX/Usage|code=
text \textde{German text} text
text
\begin{de}
German text
\end{de}
text}}

===Alternative choice using iflang ===
The current language can also be tested by using the {{LaTeX/Package|iflang}} package by Heiko Oberdiek (the built-in feature from the babel package is not reliable). Here comes a simple example:
 \IfLanguageName{ngerman}{Hallo}{Hello}
This allows to easily distinguish between two languages without the need of defining own commands.
The babel language is changed by setting
 \selectlanguage{english}

== Specific languages ==
<!-- please keep the list in alphabetical order-->

===Arabic script===

For languages which use the Arabic script, including Arabic, Persian, Urdu, Pashto, Kurdish, Uyghur, etc., add the following code to your preamble:

{{LaTeX/Usage|code=
\usepackage{arabtex}
}}
You can input text in either romanized characters or native Arabic script encodings.  Use any of the following commands and environments to enter in text:

{{LaTeX/Usage|code=
\< ... >
\RL{ ... }
\begin{arabtext} ... \end{arabtext}.
}}

See the [[w:ArabTeX|ArabTeX]] Wikipedia article for further details.

You may also use the {{LaTeX/Package|Arabi}} package within Babel to typeset Arabic and Persian

{{LaTeX/Usage|code=
\usepackage{cmap}
\usepackage[LAE,LFE]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[farsi,arabic]{babel}
}}

You may also copy and paste from PDF files produced with Arabi thanks to the support of the {{LaTeX/Package|cmap}} package.
You may use Arabi with LyX, or with tex4ht to produce HTML. 

See [http://www.ctan.org/tex-archive/language/arabic/arabi/ Arabi page on CTAN]

===Armenian===

The Armenian script uses its own characters, which will require you to install a text editor that supports [[w:Unicode|Unicode]] and will allow you to enter UTF-8 text, such as [http://www.xm1math.net/texmaker/ Texmaker] or [http://www.winedt.com/ WinEdt]. These text editors should then be configured to compile using XeLaTeX.

Once the text editor is set up to compile with XeLaTeX, the {{LaTeX/Package|fontspec}} package can be used to write in Armenian:

{{LaTeX/Usage|code=
\usepackage{fontspec}
\setmainfont{DejaVu Serif}
}}

or

{{LaTeX/Usage|code=
\usepackage{fontspec}
\setmainfont{Sylfaen}
}}

The Sylfaen font lacks italic and bold, but DejaVu Serif supports them.

See [[:hy:ԼաՏեԽ/Բարև աշխարհ|Armenian Wikibooks]] for further details, especially on how to configure the Unicode supporting text editors to compile with XeLaTeX.

===Cyrillic script===

Version 3.7h of {{LaTeX/Package|babel}} includes support for the <tt>T2*</tt> encodings and for typesetting Bulgarian, Russian and Ukrainian texts using Cyrillic letters<ref name="notSoShortIntro">[http://www.ctan.org/tex-archive/info/lshort/english/lshort.pdf The Not So Short Introduction to LaTeX], 2.5.6 Support for Cyrillic, Maksym Polyakov</ref>. Support for Cyrillic is based on standard LaTeX mechanisms plus the {{LaTeX/Package|fontenc}} and {{LaTeX/Package|inputenc}} packages. AMS-LaTeX packages should be loaded before {{LaTeX/Package|fontenc}} and {{LaTeX/Package|babel}}. If you are going to use Cyrillics in mathmode, you also need to load {{LaTeX/Package|mathtext}} package before {{LaTeX/Package|fontenc}}:</tt>

{{LaTeX/Usage|code=
\usepackage{amsmath,amsthm,amssymb}
\usepackage{mathtext}

\usepackage[T1,T2A]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[english,bulgarian,russian,ukrainian]{babel}
}}

Generally, {{LaTeX/Package|babel}} will automatically choose the default font encoding, for the above three languages this is <tt>T2A.</tt> However, documents are not restricted to a single font encoding. For multilingual documents using Cyrillic and Latin-based languages it makes sense to include Latin font encoding explicitly. Babel will take care of switching to the appropriate font encoding when a different language is selected within the document.

On modern operating systems it is beneficial to use Unicode ({{LaTeX/Parameter|utf8}} or {{LaTeX/Parameter|utf8x}}) instead of KOI8-RU ({{LaTeX/Parameter|koi8-ru}}) as an input encoding for Cyrillic text.

In addition to enabling hyphenations, translating automatically generated text strings, and activating some language specific typographic rules (like {{LaTeX/LaTeX|code=\frenchspacing<!---->}}), {{LaTeX/Package|babel}} provides some commands allowing typesetting according to the standards of Bulgarian, Russian, or Ukrainian languages.

For all three languages, language specific punctuation is provided: the Cyrillic dash for the text (it is little narrower than Latin dash and surrounded by tiny spaces), a dash for direct speech, quotes, and commands to facilitate hyphenation:

{| class="wikitable"
|-
! Key combination !! Action
|-
|| {{LaTeX/LaTeX|code="{{!}}<!---->}} || No ligature at this position.
|-
|| {{LaTeX/LaTeX|code="-<!---->}} || Explicit hyphen sign, allowing hyphenation in the rest of the word.
|-
|| {{LaTeX/LaTeX|code="---<!---->}} || Cyrillic emdash in plain text.
|-
|| {{LaTeX/LaTeX|code="--~<!---->}} || Cyrillic emdash in compound names (surnames).
|-
|| {{LaTeX/LaTeX|code="--*<!---->}} || Cyrillic emdash for denoting direct speech.
|-
|| {{LaTeX/LaTeX|code=""<!---->}} || Similar to {{LaTeX/LaTeX|code="-,<!---->}} but it produces no hyphen sign (used for compound words with hyphen, e.g. {{LaTeX/LaTeX|code=x-""y<!---->}} or some other signs as “disable/enable”).
|-
|| {{LaTeX/LaTeX|code="~<!---->}} || Compound word mark without a breakpoint.
|-
|| {{LaTeX/LaTeX|code="=<!---->}} || Compound word mark with a breakpoint, allowing hyphenation in the composing words.
|-
|| {{LaTeX/LaTeX|code=",<!---->}} || Thinspace for initials with a breakpoint in a following surname.
|-
|| {{LaTeX/LaTeX|code="‘<!---->}} || German opening double quote (,,).
|-
|| {{LaTeX/LaTeX|code="’<!---->}} || German closing double quote (“).
|-
|| {{LaTeX/LaTeX|code="<<!---->}} || French opening double quote (<<).
|-
|| {{LaTeX/LaTeX|code="><!---->}} || French closing double quote (>>).
|-
|}

The Russian and Ukrainian options of {{LaTeX/Package|babel}} define the commands
{{LaTeX/Usage|code=
\Asbuk
\asbuk
}}
which act like {{LaTeX/LaTeX|code=\Alph<!---->}} and {{LaTeX/LaTeX|code=\alph<!---->}} (commands for turning counters into letters, ''e.g.'' {{LaTeX/LaTeX|code=a, b, c...<!---->}}), but produce capital and small letters of Russian or Ukrainian alphabets (whichever is the active language of the document).

The Bulgarian option of {{LaTeX/Package|babel}} provides the commands
{{LaTeX/Usage|code=
\enumBul
\enumLat
\enumEng
}}
which make {{LaTeX/LaTeX|code=\Alph<!---->}} and {{LaTeX/LaTeX|code=\alph<!---->}} produce letters of either Bulgarian or Latin (English) alphabets. The default behaviour of {{LaTeX/LaTeX|code=\Alph<!---->}} and {{LaTeX/LaTeX|code=\alph<!---->}} for the Bulgarian language option is to produce letters from the Bulgarian alphabet.

See the Bulgarian translation of "The Not So Short Introduction to LaTeX" <ref name="notSoShortIntroBg">[http://www.ctan.org/tex-archive/info/lshort/bulgarian/lshort-bg.pdf The Not So Short Introduction to LaTeX], Bulgarian translation</ref> for a method to type Cyrillic letters directly from the keyboard using a different distribution.

=== Chinese ===

One possible Chinese support is made available thanks to the {{LaTeX/Package|CJK}} package collection. If you are using a package manager or a portage tree, the CJK collection is usually in a separate package because of its size (mainly due to fonts).

Make sure your document is saved using the UTF-8 character encoding. See [[LaTeX/Special Characters|Special Characters]] for more details.
Put the parts where you want to write chinese characters in a {{LaTeX/Environment|CJK}} environment.

{{LaTeX/Usage|code=
\documentclass{article}
\usepackage{CJK}

\begin{document}

\begin{CJK}{UTF8}{gbsn}
你好
You can mix latin letters and chinese.
\end{CJK}

\end{document}
}}

The last argument specifies the font. It must fit the desired language, since fonts are different for Chinese, Japanese and Korean. Possible choices for Chinese include:
* gbsn (简体宋体, simplified Chinese)
* gkai (简体楷体, simplified Chinese)
* bsmi (繁体细上海宋体, traditional Chinese)
* bkai (繁体标楷体, traditional Chinese)

=== Czech ===

Czech is fine using
{{LaTeX/Usage|code=
\usepackage[czech]{babel}
}}
UTF-8 allows you to have „czech quotation marks“ directly in your text. Otherwise, there are macros ''\clqq'' and ''\crqq'' to produce left and right quote. You can place quotated text inside {{LaTeX/LaTeX|code=\uv<!---->}}.

=== Finnish ===

Finnish language hyphenation is enabled with:
{{LaTeX/Usage|code=
\usepackage[finnish]{babel}
}}
This will also automatically change document language (section names, etc.) to Finnish.

=== French ===

You can load French language support with the following command:

{{LaTeX/Usage|code=
\usepackage[frenchb]{babel}
}}

There are multiple options for typesetting French documents, depending on the flavor of French: {{LaTeX/Parameter|french}}, {{LaTeX/Parameter|frenchb}}, and {{LaTeX/Parameter|francais}} for Parisian French, and {{LaTeX/Parameter|acadian}} and {{LaTeX/Parameter|canadien}} for new-world French. If you do not know or do not really care, we would recommend using {{LaTeX/LaTeX|code=frenchb<!---->}}.

All enable French hyphenation, if you have configured your LaTeX system accordingly. All of these also change all automatic text into French: {{LaTeX/LaTeX|code=\chapter<!---->}} prints ''Chapitre'', {{LaTeX/LaTeX|code=\today<!---->}} prints the current date in French and so on. A set of new commands also becomes available, which allows you to write French input files more easily. Check out the following table for inspiration:

{| class="wikitable"
!input code
!rendered output
|-
|<tt>\og guillemets \fg{}</tt>
|« guillemets »
|-
|<tt>M\up{me}, D\up{r}</tt>
|M<sup>me</sup>, D<sup>r</sup>
|-
|<tt>1\ier{}, 1\iere{}, 1\ieres{}</tt>
|1<sup>er</sup>, 1<sup>re</sup>, 1<sup>res</sup>
|-
|<tt>2\ieme{} 4\iemes{}</tt>
|2<sup>e</sup> 4<sup>es</sup>
|-
|<tt>\No 1, \no 2</tt>
|N° 1, n° 2
|-
|<tt>20~\degres C, 45\degres</tt>
|20 °C, 45°
|-
|<tt>M. \bsc{Durand}</tt>
| M. <span style="font-variant: small-caps;">Durand</span>
|-
|<tt>\nombre{1234,56789}</tt>
|1 234,567 89
|-
|}

You may want to typeset guillemets and other French characters directly if your keyboard have them. Running Xorg (*BSD and GNU/Linux), you may want to use the <tt>oss</tt> variant which features some nice shortcuts, like

{| class="wikitable"
!Key combination
!Character
|-
|<tt>Alt Gr + w</tt> || «
|-
|<tt>Alt Gr + x</tt> || »
|-
|<tt>Alt Gr + Shift + é</tt> || É
|-
|<tt>Alt Gr + Shift + è</tt> || È
|-
|<tt>Alt Gr + Shift + ç</tt> || Ç
|-
|}

You will need the T1 font encoding for guillemets to print properly.

For the degree character you will get an error like
 ! Package inputenc Error: Unicode char \u8:° not set up for use with LaTeX.

The {{LaTeX/Package|textcomp}} package will fix it for you.

The great advantage of Babel for French is that it will handle some elements of French typography for you, especially non-breaking spaces before all two-parts punctuation marks. So now you can write:

{{LaTeX/Usage|code=
Il répondit: «Ce pain coûte-t-il 2~€?»
}}

The non-breaking space before the euro symbol is still necessary because currency symbols and other units or not supported in general (that's not specific to French).

You can use the {{LaTeX/Package|numprint}} package along Babel. It will let you print numbers the French way.
{{LaTeX/Example|code=
\usepackage[frenchb]{babel}
\usepackage[autolanguage]{numprint} % Must be loaded *after* babel.

% ...

\nombre{123456.123456 e-17}
|render=
<math>123~456,123~456\cdot 10^{-17}</math>
}}


You will also notice that the layout of lists changes when switching to the French language. This is customizable using the {{LaTeX/LaTeX|code=\frenchbsetup<!---->}} command. For more information on what the {{LaTeX/Parameter|frenchb}} option of {{LaTeX/Package|babel}} does and how you can customize its behavior, run LaTeX on file <tt>frenchb.dtx</tt> and read the produced file <tt>frenchb.pdf</tt> or <tt>frenchb.dvi</tt>. You can get the PDF version on [http://mirrors.ctan.org/macros/latex/contrib/babel-contrib/frenchb/frenchb.pdf CTAN].

=== German ===

You can load German language support using ''either one'' of the two following commands.

For traditional ("old") German orthography use
{{LaTeX/Usage|code=
\usepackage[german]{babel}
}}

'''or''' for reform ("new") German orthography use

{{LaTeX/Usage|code=
\usepackage[ngerman]{babel}
}}

This enables German hyphenation, if you have configured your LaTeX
system accordingly. It also changes all automatic text into German, e.g.
“Chapter” becomes “Kapitel”. A set of new commands also becomes available,
which allows you to write German input files more quickly even when
you don't use the inputenc package. Check out the table below for inspiration.
With inputenc, all this becomes moot, but your text also is locked in a
particular encoding world.

{| class="wikitable"
|+German Special Characters.
|-
|<tt>"A "O "U</tt> || Ä Ö Ü
|-
|<tt>"a "o "u "s</tt> || ä ö ü ß
|-
|<tt>"`</tt> or <tt>\glqq</tt> || „ 
|-
|<tt>"'</tt> or <tt>\grqq</tt> || “
|-
|<tt>\glq \grq</tt> || 
|-
|<tt>"<</tt> or <tt>\flqq</tt> || «
|- 
|<tt>"></tt> or <tt>\frqq</tt> || »
|-
|<tt>\flq \frq</tt> || ‹ ›
|-
|<tt>\dq</tt> || "
|-
|}

In German books you sometimes find French quotation marks («guillemets»). German typesetters, however, use them differently. A quote in a German book would look like »this«. In the German speaking part of Switzerland, typesetters use «guillemets» the same way the French do. A major problem arises from the use of commands like {{LaTeX/LaTeX|code=\flq<!---->}}: If you use the OT1 font encoding (which is the default) the guillemets will look like the math symbol "<math>\ll</math>", which turns a typesetter's stomach. T1 encoded fonts, on the other hand, do contain the required symbols. So if you are using this type of quote, make sure you use the T1 encoding.

Decimal numbers usually have to be written like <tt>0{,}5</tt> (not just 0,5). Packages like <tt>ziffer</tt> enable input like <tt>0,5</tt>.

=== Greek ===

This is the preamble you need to write in the Greek language. Note the particular input encoding.

{{LaTeX/Usage|code=
\usepackage[english,greek]{babel}
\usepackage[iso-8859-7]{inputenc}
}}

This preamble enables hyphenation and changes all automatic text to Greek. A set of new commands also becomes available, which allows you to write Greek input files more easily. In order to temporarily switch to English and vice versa, one can use the commands {{LaTeX/LaTeX|code=\textlatin{english text}<!---->}} and {{LaTeX/LaTeX|code=\textgreek{greek text}<!---->}} that both take one argument which is then typeset using the requested font encoding. Otherwise you can use the command {{LaTeX/LaTeX|code=\selectlanguage{...}<!---->}} described in a previous section. Use {{LaTeX/LaTeX|code=\euro<!---->}} for the Euro symbol.

=== Hungarian ===

Use the following lines:
{{LaTeX/Usage|code=
\usepackage[magyar]{babel}
}}

More information [http://www.math.bme.hu/latex/ in hungarian].

=== Icelandic and Faroese ===

The following lines can be added to write Icelandic text:

{{LaTeX/Usage|code=
\usepackage[icelandic]{babel}
}}

This changes text like ''Part'' into ''Hluti''. It makes additional commands available:

{| class="wikitable"
|+Icelandic special commands
|-
|<tt>"`</tt> or <tt>\glqq</tt> || „ 
|-
|<tt>\grqq</tt> || “
|- 
|<tt>\TH</tt> || Þ
|-
|<tt>\th</tt> || þ
|-
|<tt>\DH</tt> || Ð
|-
|<tt>\dh</tt> || ð
|-
|}

To make special characters such as Þ and Æ become available just add:

{{LaTeX/Usage|code=
\usepackage[T1]{fontenc}
}}

The default LATEX font encoding is OT1, but it contains only the 128 characters. The T1 encoding contains letters and punctuation characters for most of the European languages using Latin script.

=== Italian ===

Italian is well supported by LaTeX. Just add 
{{LaTeX/Usage|code=
\usepackage[italian]{babel}
}}
at the beginning of your document and the output of all the commands will be translated properly.

=== Japanese ===

There is a variant of TeX intended for Japanese named [http://ascii.asciimw.jp/pb/ptex/ pTeX], which supports vertical typesetting.

Another possible way to write in japanese is to use Lualatex and the luatex-ja package. An example from the Luatexja documentation :
{{LaTeX/Usage|code=
\documentclass{ltjsarticle}
\usepackage{luatexja} % ltjclasses, ltjsclasses を使うときはこの行不要
\begin{document}
\section{はじめてのLua\TeX-ja}
ちゃんと日本語が出るかな？
\subsection{出たかな？}
長い文章を入力するとちゃんと右端のところで折り返されるかな？
大丈夫そうな気がするけど．ちょっと不安だけど何事も挑戦だよね．
\end{document}
}}

You can also use capabilities provided by the Fontspec package and those provided by Luatexja-fontspec to declare the font you want to use in your paper. Let us take an example :
{{LaTeX/Usage|code=
% **********************************
% Basic setup
\documentclass[10pt,a4paper]{article}
\usepackage{luatextra}%this package calls fontspec, luatexbase, lualibs, metalogo, luacode and fixltx2e
\setmainfont[Ligatures=Rare,Numbers=OldStyle]{Arno Pro} %setup of western font
\usepackage{luatexja}
\usepackage{luatexja-fontspec}%needed to call \setmainjfont bellow
\setmainjfont[BoldFont=KozGoPr6N-Bold]{KozGoPr6N-Regular} %setup of japanese font
%***********************************
\begin{document}
It is a test to show japanese and english mix. テスト中です。どうですか皆さん。
\end{document}
}}
Use UTF-8 as your encoding. In case you don't know how to do this, take a look at Texmaker, a LaTeX editor which use UTF-8 by default.


Another (but old) possible Japanese support is made available thanks to the {{LaTeX/Package|CJK}} package collection. If you are using a package manager or a portage tree, the CJK collection is usually in a separate package because of its size (mainly due to fonts).

Make sure your document is saved using the UTF-8 character encoding. See [[LaTeX/Special Characters|Special Characters]] for more details.
Put the parts where you want to write japanese characters in a {{LaTeX/Environment|CJK}} environment.
{{LaTeX/Usage|code=
\documentclass{article}
\usepackage{CJK}

\begin{document}

\begin{CJK}{UTF8}{min}
こんにちは
You can mix latin letters as well as hiragana, katakana and kanji.
\end{CJK}

\end{document}
}}
The last argument specifies the font. It must fit the desired language, since fonts are different for Chinese, Japanese and Korean. {{LaTeX/Parameter|min}} is an example for Japanese.

=== Korean ===

The two most widely used encodings for Korean text files are EUC-KR and its upward compatible extension used in Korean MS-Windows, CP949/Windows-949/UHC. In these encodings each US-ASCII character represents its normal ASCII character similar to other ASCII compatible encodings such as ISO-8859-x, EUC-JP, Big5, or Shift_JIS. On the other hand, Hangul syllables, Hanjas (Chinese characters as used in Korea), Hangul Jamos, Hiraganas, Katakanas, Greek and Cyrillic characters and other symbols and letters drawn from KS X 1001 are represented by two consecutive octets. The first has its MSB set. Until the mid-1990's, it took a considerable amount of time and effort to set up a Korean-capable environment under a non-localized (non-Korean) operating system. You can skim through the now much-outdated http://jshin.net/faq to get a glimpse of what it was like to use Korean under non-Korean OS in mid-1990's. 

TeX and LaTeX were originally written for scripts with no more than 256 characters in their alphabet. To make them work for languages with considerably more characters such as Korean or Chinese, a subfont mechanism was developed. It divides a single CJK font with thousands or tens of thousands of glyphs into a set of subfonts with 256 glyphs each.

For Korean, there are three widely used packages.
* HLATEX by UN Koaunghi
* hLATEXp by CHA Jaechoon 
* the CJK package by Werner Lemberg

HLATEX and hLATEXp are specific to Korean and provide Korean localization on top of the font support. They both can process Korean input text files encoded in EUC-KR. HLATEX can even process input files encoded in CP949/Windows-949/UHC and UTF-8 when used along with Λ, Ω.

The CJK package is not specific to Korean. It can process input files in UTF-8 as well as in various CJK encodings including EUC-KR and CP949/Windows-949/UHC, it can be used to typeset documents with multilingual content (especially Chinese, Japanese and Korean). The CJK package has no Korean localization such as the one offered by HLATEX and it does not come with as many special Korean fonts as HLATEX.

The ultimate purpose of using typesetting programs like TeX and LaTeX is to get documents typeset in an ''aesthetically'' satisfying way. Arguably the most important element in typesetting is a set of welldesigned fonts. The HLATEX distribution includes UHC PostScript fonts of 10 different families and Munhwabu fonts (TrueType) of 5 different families. The CJK package works with a set of fonts used by earlier versions of HLATEX and it can use Bitstream's cyberbit True-Type font.

To use the HLATEX package for typesetting your Korean text, put the following declaration into the preamble of your document:
{{LaTeX/Usage|code=
\usepackage{hangul}
}}
This command turns the Korean localization on. The headings of chapters, sections, subsections, table of content and table of figures are all translated into Korean and the formatting of the document is changed to follow Korean conventions. The package also provides automatic ''particle selection''. In Korean, there are pairs of post-fix particles grammatically equivalent but different in form. Which of any given pair is correct depends on whether the preceding syllable ends with a vowel or a consonant. (It is a bit more complex than this, but this should give you a good picture.) Native Korean speakers have no problem picking the right particle, but it cannot be determined which particle to use for references and other automatic text that will change while you edit the document. It takes a painstaking effort to place appropriate particles manually every time you add/remove references or simply shuffle parts of your document around. HLATEX relieves its users from this boring and error-prone process. 

In case you don't need Korean localization features but just want to typeset Korean text, you can put the following line in the preamble, instead.
{{LaTeX/Usage|code=
\usepackage{hfont}
}}
For more details on typesetting Korean with HLATEX, refer to the HLATEX Guide. Check out the web site of the [http://www.ktug.or.kr/ Korean TeX User Group (KTUG)].

===Persian script===

For Persian language, there is a dedicated package called XePersian which uses XeLaTeX as the typesetting engine. Just add the following code to your preamble:

{{LaTeX/Usage|code=
\usepackage{xepersian}
}}

See [http://www.ctan.org/tex-archive/macros/xetex/latex/xepersian/ XePersian page on CTAN]

Moreover, Arabic script can be used to type Persian as illustrated in the [[#Arabic|corresponding section]].

=== Polish ===

If you plan to use Polish in your UTF-8 encoded document, use the following code
{{LaTeX/Usage|code=
\usepackage[utf8]{inputenc}
\usepackage{polski}
\usepackage[polish]{babel}
}}

The above code merely allows to use Polish letters and translates the automatic text to Polish, so that "chapter" becomes "rozdział".
There are a few additional things one must remember about.

==== Connectives ====

Polish has many single letter connectives: "a", "o", "w", "i", "u", "z", etc., grammar and typography rules don't allow for them to end a printed line.
To ensure that LaTeX won't set them as last letter in the line, you have to use non breakable space:

{{LaTeX/Usage|code=
Noc była sierpniowa, ciepła i~słodka, Księżyc oświecał srebrnem światłem wgłębienie, tak,
że twarze małego rycerza i~Basi były skąpane w blasku.
Poniżej, na podwórzu zamkowem, widać było uśpione kupy żołnierzy, a~także i~ciała zabitych
podczas dziennej strzelaniny, bo nie znaleziono dotąd czasu na ich pogrzebanie.
}}


==== Numerals ====

According to Polish grammar rules, you have to put dots after numerals in chapter, section, subsection, etc. headers.

This is achieved by redefining few LaTeX macros.

For books:
{{LaTeX/Usage|code=
\renewcommand\thechapter{\arabic{chapter}.}
\renewcommand\thesection{\arabic{chapter}.\arabic{section}.}
\renewcommand\thesubsection{\arabic{chapter}.\arabic{section}.\arabic{subsection}.}
\renewcommand\thesubsubsection{\arabic{chapter}.\arabic{section}.\arabic{subsection}.\arabic{subsubsection}.}
}}

For articles:
{{LaTeX/Usage|code=
\renewcommand\thesection{\arabic{section}.}
\renewcommand\thesubsection{\arabic{section}.\arabic{subsection}.}
\renewcommand\thesubsubsection{\arabic{section}.\arabic{subsection}.\arabic{subsubsection}.}
}}


Alternatively you can use dedicated document classes:
* the {{LaTeX/Environment|mwart}} class instead of {{LaTeX/Environment|article}},
* {{LaTeX/Environment|mwbk}} instead of {{LaTeX/Environment|book}}
* and {{LaTeX/Environment|mwrep}} instead of {{LaTeX/Environment|report}}.
Those classes have much more European typography settings but ''do not'' require the use of Polish babel settings or character encoding.

Simple usage:
{{LaTeX/Usage|code=
\documentclass{mwart}
\usepackage[polish]{babel}
\usepackage{polski}
\begin{document}
Pójdź kińże tę chmurność w głąb flaszy.
\end{document}
}}

Full documentation for those classes is available at http://web.archive.org/web/20040609034031/http://www.ci.pwr.wroc.pl/~pmazur/LaTeX/mwclsdoc.pdf (Polish).

==== Indentation ====

It may be customary (depending on publisher) to indent the first paragraph in sections and chapters:
{{LaTeX/Usage|code=
\usepackage{indentfirst}
}}

==== Hyphenation and typography ====

It's much more frowned upon to set pages with hyphenation between pages than it is customary in American typesetting.

To adjust penalties for hyphenation spanning pages, use this command:
{{LaTeX/Usage|code=
\brokenpenalty=1000
}}

To adjust penalties for leaving widows and orphans (clubs in TeX nomenclature) use those commands:
{{LaTeX/Usage|code=
\clubpenalty=1000
\widowpenalty=1000
}}

==== Commas in math ====

According to Polish typography rules, fractional parts of numbers should be delimited by a comma, not a dot.
To make LaTeX not insert additional space in math mode after a comma (unless there is a space after the comma), use the {{LaTeX/Package|icomma}} package.

{{LaTeX/Usage|code=
\usepackage{icomma}
}}

Unfortunately, it is partially incompatible with the {{LaTeX/Package|dcolumn}} package.
One needs to either use dots in columns with numerical data in the source file and make {{LaTeX/Package|dcolumn}} switch them to commas for display ''or'' define the column as follows:
{{LaTeX/Usage|code=
\begin{tabular}{... D{,}{\mathord\mathcomma}{2} ...}
}}

The alternative is to use the {{LaTeX/Package|numprint}} package, but it is much less convenient.

==== Further information ====

Refer the [http://so.pwn.pl/zasady.php Słownik Ortograficzny] (in Polish) for additional information on Polish grammar and typography rules.

Good extract is available at [http://dtp.msstudio.com.pl/typo.html Zasady Typograficzne Składania Tekstu] (in Polish).

=== Portuguese ===

Add the following code to your preamble:

{{LaTeX/Usage|code=
\usepackage[portuguese]{babel}
}}

You can substitute the language for brazilian portuguese by choosing {{LaTeX/Parameter|brazilian}}.

=== Slovak ===

Basic settings are fine when left the same as Czech, but Slovak needs special signs for 'ď', 'ť', 'ľ'. To be able to type them from keyboard use the following settings:
{{LaTeX/Usage|code=
\usepackage[slovak]{babel}
\usepackage[IL2]{fontenc}
}}

=== Spanish ===

Include the appropriate Babel option:
{{LaTeX/Usage|code=
\usepackage[spanish]{babel}
}}

The trick is that Spanish has several options and commands to control the layout. The options may be loaded either at the call to Babel, or before, by defining the command {{LaTeX/LaTeX|code=\spanishoptions<!---->}}. Therefore, the following commands are roughly equivalent:

{{LaTeX/Usage|code=
\def\spanishoptions{mexico}
\usepackage[spanish]{babel}
}}

{{LaTeX/Usage|code=
\usepackage[spanish,mexico]{babel}
}}

On average, the former syntax should be preferred, as the latter is a deviation from standard Babel behavior, and thus may break other programs (LyX, latex2rtf) interacting with LaTeX.

Spanish also defines shorthands for the dot and << >> so that they are used as logical markup: the former is used as decimal marker in math mode, and the output is typically either a comma or a dot; the latter is used for quoted text, and the output is typically either «» or “”. This allows different typographical conventions with the same input, as preferences may be quite different from, say, Spain and Mexico.

Two particularly useful options are {{LaTeX/Parameter|es-noquoting,es-nolists}}: some packages and classes are known to collide with Spanish in the way they handle active characters, and these options disable the internal workings of Spanish to allow you to overcome these common pitfalls. Moreover, these options may simplify the way LyX customizes some features of the Spanish layout from inside the GUI.

The options {{LaTeX/Parameter|mexico,mexico-com}} provide support for local custom in Mexico: the former using decimal dot, as customary, and the latter allowing decimal comma, as required by the Mexican Official Norm (NOM) of the Department of Economy for labels in foods and goods. More localizations are in the making.

The other commands modify the spanish layout after loading Babel. Two particularly useful commands are {{LaTeX/LaTeX|code=\spanishoperators<!---->}} and {{LaTeX/LaTeX|code=\spanishdeactivate<!---->}}. 

The macro {{LaTeX/LaTeX|code=\spanishoperators{<list of operators>}{<!---->}} contains a list of spanish mathematical operators, and may be redefined at will. For instance, the command
{{LaTeX/Usage|code=
\def\spanishoperators{sen}
}}
only defines {{LaTeX/Parameter|sen}}, overriding all other definitions; the command {{LaTeX/LaTeX|code=\let\spanishoperators\relax<!---->}} disables them all. This command supports accented or spaced operators: the {{LaTeX/LaTeX|code=\acute{<letter>}<!---->}} command puts an accent, and the {{LaTeX/LaTeX|code=\,<!---->}} command adds a small space. 
For instance, the following operators are defined by default.

{{LaTeX/Usage|code=
l\acute{i}m l\acute{i}m\,sup l\acute{i}m\,inf m\acute{a}x 
\acute{i}nf m\acute{i}n sen tg arc\,sen arc\,cos arc\,tg 
cotg cosec senh tgh
}}

Finally, the macro {{LaTeX/LaTeX|code=\spanishdeactivate{<list of characters>}<!---->}} disables some active characters, to keep you out of trouble if they are redefined by other packages. The candidates for deactivation are the set {<>."'}. Please, beware that some option preempt the availability of some active characters. In particular, you should not combine the {{LaTeX/Parameter|es-noquoting}} option with {{LaTeX/LaTeX|code=\spanishdeactivate{<>}<!---->}}, or the {{LaTeX/Parameter|es-noshorthands}} with {{LaTeX/LaTeX|code=\spanishdeactivate{<>."}<!---->}}. 

Please check the documentation for Babel or <tt>spanish.dtx</tt> for further details.

=== Tibetan ===
One option to use Tibetan script in LaTeX is to add
{{LaTeX/Usage|code=
\usepackage{ctib}
}}
to your preamble and use a slightly modified Wylie transliteration for input. Refer to the excellent package documentation for details.
More information can be found on [http://www.thlib.org/tools/scripts/wiki/latex.html]

==References==
<references/>

<noinclude>
{{LaTeX/Bottom|Gestiunea bibliografiei|Tabele}}
</noinclude>