• View
• Edit
• Upload
• History
• Print

I18nLabels

<< Tables | Page list | DocumentationDevelopment >>

About internationalized labels

Introduction

Most of the labels, like "Table of contents", are automatically translated into the document language. This is done by the LaTeX-package babel, that is always loaded by LyX in the background. But babel doesn't translate all labels, that are introduced by some document classes. These labels need to be translated manually.
This page will give an overview about the necessary preamble commands to translate labels in dependence of the used document classes.

Method of translation

Environments

Labels are often part of a LaTeX-environment. Environments appear in LaTeX as

\begin{environment name}
\end{environment name}

To translate a label, we have to redefine the environment. This is done in the preamble with the command

\renewenvironment{environment name}{begin command}{end command}

For begin and end we need a new environment with the new label.
E.g. to translate the label "Example" to german "Beispiel", define a new environment:

\newtheorem{exa}{Beispiel}

A theorem is a special form of an environment. exa is the name of our environment and Beispiel its label.
We can now redefine the existing environment "example":

\renewenvironment{example}{\begin{exa}}{\end{exa}}

In summary we overwrote the existing environment with a new one. All that we have to know, is the name of the existing environment and the form of its definition (theorem or not).

Floats

Labels of floats can easily be changed with the command

\floatname{name of float}{label}

Labels

To change labels that are automatically translated by the LaTeX-package babel, you need to load it in the preamble together with the language options used in your document. For example when you have a document that uses the new german ortography call babel with the preamble line

\usepackage[ngerman]{babel}

The new label name is set by this preamble line construct:

\addto\captionsngerman{\renewcommand{\indexname}{Stichwortverzeichnis}}

This preamble line replaces babels german index name with "Stichwortverzeichnis". The command \captions<language> must be adjusted according to the used language. So it is for an english document the command \captionsenglish.

To change another label than the index, replace the command \indexname by \<label>name. A list of the possible names can be found here:

http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fixnam

To change for example the name of the label "Figure" in french by "Image" you need these preamble lines:

\usepackage[french]{babel}
\addto\captionsfrench{\renewcommand{\figurename}{Image}}

Preamble commands for special LaTeX-classes

In the following, all labels are translated into french. Every section includes a downloadable example file, so that you can easily copy the code from the preamble and replace the french names by the one you need.

Algorithm-float

Example file: lang-algorithm.lyx

\floatname{algorithm}{Algorithme}

AMS-documentclasses

Example file: lang-ams.lyx --this example file doesn't work correctly in LyX 1.5 because of Case environment

In the original definition, all environments are numbered within the section number. To have this for the redefined environments, add a \numberwithin command for every environment, e.g.

\numberwithin{theo}{section}

as it is done in the example file.

• Theorem:
  \newtheorem{theo}{Théorème}
  \renewenvironment{thm}{\begin{theo}}{\end{theo}}
• Corollary:
  \newtheorem{coro}{Corollaire}
  \renewenvironment{cor}{\begin{coro}}{\end{coro}}
• Lemma:
  \newtheorem{lemm}{Lemme}
  \renewenvironment{lem}{\begin{lemm}}{\end{lemm}}
• Proposition:
  \newtheorem{propo}{Proposition}
  \renewenvironment{prop}{\begin{propo}}{\end{propo}}
• Conjecture:
  \newtheorem{conje}{Conjecture}
  \renewenvironment{conjecture}{\begin{conje}}{\end{conje}}
• Criterion:
  \newtheorem{crit}{Critère}
  \renewenvironment{criterion}{\begin{crit}}{\end{crit}}
• Algorithm:
  \newtheorem{algo}{Algorithme}
  \renewenvironment{algorithm}{\begin{algo}}{\end{algo}}
• Fact:
  \newtheorem{facte}{Fait}
  \renewenvironment{fact}{\begin{facte}}{\end{facte}}
• Axiom:
  \newtheorem{axi}{Axiome}
  \renewenvironment{ax}{\begin{axi}}{\end{axi}}
• Definition:
  \newtheorem{defi}{Définition}
  \renewenvironment{defn}{\begin{defi}}{\end{defi}}
• Example:
  \newtheorem{exa}{Exemple}
  \renewenvironment{example}{\begin{exa}}{\end{exa}}
• Problem:
  \newtheorem{prob}{Problème}
  \renewenvironment{problem}{\begin{prob}}{\end{prob}}
• Condition:
  \newtheorem{condi}{Condition}
  \renewenvironment{condition}{\begin{condi}}{\end{condi}}
• Exercise:
  \newtheorem{exer}{Exercice}
  \renewenvironment{xca}{\begin{exer}}{\end{exer}}
• Remark:
  \newtheorem{rema}{Remarque}
  \renewenvironment{rem}{\begin{rema}}{\end{rema}}
• Claim:
  \newtheorem{claime}{Assertion}
  \renewenvironment{claim}{\begin{claime}}{\end{claime}}
• Note:
  \newtheorem{nota}{Renseignement}
  \renewenvironment{note}{\begin{nota}}{\end{nota}}
• Notation:
  \newtheorem{notat}{Notation}
  \renewenvironment{notation}{\begin{notat}}{\end{notat}}
• Summary:
  \newtheorem{suma}{Résumé}
  \renewenvironment{summary}{\begin{suma}}{\end{suma}}
• Acknowledgement:
  \newtheorem{ackno}{Action de grâce}
  \renewenvironment{acknowledgement}{\begin{ackno}}{\end{ackno}}
• Case:
  \newtheorem{casa}{Cas}
  \renewenvironment{case}{\begin{casa}}{\end{casa}}
• Conclusion:
  \newtheorem{conc}{Conclusion}
  \renewenvironment{conclusion}{\begin{conc}}{\end{conc}}

Beamer-presentations

First approach

Example file: lang-beamer.lyx

• Definition:
  \newtheorem{defi}{Définition}
  \renewenvironment{definition}{\begin{defi}}{\end{defi}}
• Definitions:
  \newtheorem{defis}{Définitions}
  \renewenvironment{definitions}{\begin{defis}}{\end{defis}}
• Fact:
  \newtheorem{facte}{Fait}
  \renewenvironment{fact}{\begin{facte}}{\end{facte}}
• Corollary:
  \newtheorem{coro}{Corollaire}
  \renewenvironment{corollary}{\begin{coro}}{\end{coro}}
• Theorem:
  \newtheorem{theo}{Théorème}
  \renewenvironment{theorem}{\begin{theo}}{\end{theo}}
• Example:
  \newtheorem{exa}{Exemple}
  \renewenvironment{example}{\begin{exa}}{\end{exa}}

Second solution (no redefinitions needed)

Till Tantau created a package name translator, currently not sufficiently documented to deserve a real publication as a package.

To have it working:

• download translator from Beamer CVS http://latex-beamer.cvs.sourceforge.net/latex-beamer/ in texmf-local or similar, update the search path;
• be sure to have a recent version of beamerbasetheorems.sty (v>=1.8, Nov 28, 2005). It's one

revision after the last stable release (3.06);

• nothing else needed.
• but currently, only German language supported, French coming soon.

i18n