/******************************************************************************

 *

 * 

 *

 *

 * Permission to use, copy, modify, and distribute this software and its

 * documentation under the terms of the GNU General Public License is hereby 

 * granted. No representations are made about the suitability of this software 

 * for any purpose. It is provided "as is" without express or implied warranty.

 * See the GNU General Public License for more details.

 *

 * Documents produced by Doxygen are derivative works derived from the

 * input used in their production; they are not affected by this license.

 *

 */

#ifndef TRANSLATOR_EO_H

#define TRANSLATOR_EO_H

/*! 

 When defining a translator class for the new language, follow

 the description in the documentation.  One of the steps says

 that you should copy the translator_en.h (this) file to your

 translator_xx.h new file.  Your new language should use the

 Translator class as the base class.  This means that you need to

 implement exactly the same (pure virtual) methods as the

 TranslatorEnglish does.  Because of this, it is a good idea to

 start with the copy of TranslatorEnglish and replace the strings

 one by one.

 It is not necessary to include "translator.h" or

 "translator_adapter.h" here.  The files are included in the

 language.cpp correctly.  Not including any of the mentioned

 files frees the maintainer from thinking about whether the

 first, the second, or both files should be included or not, and

 why.  This holds namely for localized translators because their

 base class is changed occasionaly to adapter classes when the

 Translator class changes the interface, or back to the

 Translator class (by the local maintainer) when the localized

 translator is made up-to-date again.

*/

{

  public:

    // --- Language control methods -------------------

    /*! Used for identification of the language. The identification 

     * should not be translated. It should be replaced by the name 

     * of the language in English using lower-case characters only

     * (e.g. "czech", "japanese", "russian", etc.). It should be equal to 

     * the identification used in language.cpp.

     */

    virtual QCString idLanguage()

    { return "esperanto"; }

    /*! Used to get the LaTeX command(s) for the language support. 

     *  This method should return string with commands that switch

     *  LaTeX to the desired language.  For example 

     *  <pre>"\\usepackage[german]{babel}\n"

     *  </pre>

     *  or

     *  <pre>"\\usepackage{polski}\n"

     *  "\\usepackage[latin2]{inputenc}\n"

     *  "\\usepackage[T1]{fontenc}\n"

     *  </pre>

     * 

     * The English LaTeX does not use such commands.  Because of this

     * the empty string is returned in this implementation.

     */

    virtual QCString latexLanguageSupportCommand()

    {

      return "\\usepackage[esperanto]{babel}\n";

    }

    /*! return the language charset. This will be used for the HTML output */

    virtual QCString idLanguageCharset()

    {

      return "utf-8";

    }

    // --- Language translation methods -------------------

    /*! used in the compound documentation before a list of related functions. */

    virtual QCString trRelatedFunctions()

    { return "Rilataj Funkcioj"; }

    /*! subscript for the related functions. */

    virtual QCString trRelatedSubscript()

    { return "(Atentu ke tiuj ĉi ne estas membraj funkcioj.)"; }

    /*! header that is put before the detailed description of files, classes and namespaces. */

    virtual QCString trDetailedDescription()

    { return "Detala Priskribo"; }

    /*! header that is put before the list of typedefs. */

    virtual QCString trMemberTypedefDocumentation()

    { return "Dokumentado de la Membraj Tipodifinoj"; }

    /*! header that is put before the list of enumerations. */

    virtual QCString trMemberEnumerationDocumentation()

    { return "Dokumentado de la Membraj Enumeracioj"; }

    /*! header that is put before the list of member functions. */

    virtual QCString trMemberFunctionDocumentation()

    { return "Dokumentado de la Membraj Funkcioj"; }

    /*! header that is put before the list of member attributes. */

    virtual QCString trMemberDataDocumentation()

    { 

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "Kampa Dokumentado"; 

      }

      else

      {

        return "Dokumentado de la Membraj Datumoj"; 

      }

    }

    /*! this is the text of a link put after brief descriptions. */

    virtual QCString trMore() 

    { return "Pli..."; }

    /*! put in the class documentation */

    virtual QCString trListOfAllMembers()

    { return "Listo de ĉiuj membroj."; }

    /*! used as the title of the "list of all members" page of a class */

    virtual QCString trMemberList()

    { return "Membra Listo"; }

    /*! this is the first part of a sentence that is followed by a class name */

    virtual QCString trThisIsTheListOfAllMembers()

    { return "Tiu ĉi estas la kompleta membraro de "; }

    /*! this is the remainder of the sentence after the class name */

    virtual QCString trIncludingInheritedMembers()

    { return ", inkluzive ĉiujn hereditajn membrojn."; }

    /*! this is put at the author sections at the bottom of man pages.

     *  parameter s is name of the project name.

     */

    virtual QCString trGeneratedAutomatically(const char *s)

    { QCString result="Generita aŭtomate de Doxygen";

      if (s) result+=(QCString)" por "+s;

      result+=" el la fontkodo."; 

      return result;

    }

    /*! put after an enum name in the list of all members */

    virtual QCString trEnumName()

    { return "enum nomo"; }

    /*! put after an enum value in the list of all members */

    virtual QCString trEnumValue()

    { return "enum valoro"; }

    /*! put after an undocumented member in the list of all members */

    virtual QCString trDefinedIn()

    { return "difinita en"; }

    // quick reference sections

    /*! This is put above each page as a link to the list of all groups of 

     *  compounds or files (see the \\group command).

     */

    virtual QCString trModules()

    { return "Moduloj"; }

    /*! This is put above each page as a link to the class hierarchy */

    virtual QCString trClassHierarchy()

    { return "Klasa Hierarkio"; }

    /*! This is put above each page as a link to the list of annotated classes */

    virtual QCString trCompoundList()

    { 

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "Datumstruktoroj";

      }

      else

      {

        return "Klasaro"; 

      }

    }

    /*! This is put above each page as a link to the list of documented files */

    virtual QCString trFileList()

    { return "Dosieraro"; }

    /*! This is put above each page as a link to all members of compounds. */

    virtual QCString trCompoundMembers()

    { 

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "Datumkampoj"; 

      }

      else

      {

        return "Klasaj membroj"; 

      }

    }

    /*! This is put above each page as a link to all members of files. */

    virtual QCString trFileMembers()

    { 

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "Mallokalaĵoj"; 

      }

      else

      {

        return "Dosieraj Membroj"; 

      }

    }

    /*! This is put above each page as a link to all related pages. */

    virtual QCString trRelatedPages()

    { return "Rilataj Paĝoj"; }

    /*! This is put above each page as a link to all examples. */

    virtual QCString trExamples()

    { return "Ekzemploj"; }

    /*! This is put above each page as a link to the search engine. */

    virtual QCString trSearch()

    { return "Serĉi"; }

    /*! This is an introduction to the class hierarchy. */

    virtual QCString trClassHierarchyDescription()

    { return "Tiu ĉi heredada listo estas plimalpli, "

             "sed ne tute, ordigita alfabete:";

    }

    /*! This is an introduction to the list with all files. */

    virtual QCString trFileListDescription(bool extractAll)

    {

      QCString result="Jen listo de ĉiuj ";

      if (!extractAll) result+="dokumentitaj ";

      result+="dosieroj kun mallongaj priskriboj:";

      return result;

    }

    /*! This is an introduction to the annotated compound list. */

    virtual QCString trCompoundListDescription()

    { 

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "Jen datumstrukturoj kun mallongaj priskriboj:"; 

      }

      else

      {

        return "Jen la klasoj, strukturoj, kunigoj kaj interfacoj "

               "kun mallongaj priskriboj:"; 

      }

    }

    /*! This is an introduction to the page with all class members. */

    virtual QCString trCompoundMembersDescription(bool extractAll)

    {

      QCString result="Jen listo de ĉiuj ";

      if (!extractAll)

      {

        result+="dokumentitaj ";

      }

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        result+="strukturaj kaj kunigaj kampoj";

      }

      else

      {

        result+="klasaj membroj";

      }

      result+=" kun ligiloj al ";

      if (!extractAll) 

      {

        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

        {

          result+="la struktura/kuniga dokumentado por ĉiu kampo:";

        }

        else

        {

          result+="la klasa dokumentado por ĉiu membro:";

        }

      }

      else 

      {

        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

        {

          result+="la strukturoj/kunigoj al kiuj ili apartenas:";

        }

        else

        {

          result+="la klasoj al kiuj ili apartenas:";

        }

      }

      return result;

    }

    /*! This is an introduction to the page with all file members. */

    virtual QCString trFileMembersDescription(bool extractAll)

    {

      QCString result="Jen listo de ĉiuj ";

      if (!extractAll) result+="dokumentitaj ";

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        result+="funkcioj, variabloj, difinoj, enumeracioj kaj tipodifinoj";

      }

      else

      {

        result+="dosieraj membroj";

      }

      result+=" kun ligiloj al ";

      if (extractAll) 

        result+="la dosieroj al kiuj ili apartenas:";

      else 

        result+="la dokumentado:";

      return result;

    }

    /*! This is an introduction to the page with the list of all examples */

    virtual QCString trExamplesDescription()

    { return "Jen listo de ĉiuj la ekzemploj:"; }

    /*! This is an introduction to the page with the list of related pages */

    virtual QCString trRelatedPagesDescription()

    { return "Jen listo de ĉiuj rilataj dokumentadaj paĝoj:"; }

    /*! This is an introduction to the page with the list of class/file groups */

    virtual QCString trModulesDescription()

    { return "Jen listo de ĉiuj la moduloj:"; }

    // index titles (the project name is prepended for these) 

    /*! This is used in HTML as the title of index.html. */

    virtual QCString trDocumentation()

    { return "Dokumentado"; }

    /*! This is used in LaTeX as the title of the chapter with the 

     * index of all groups.

     */

    virtual QCString trModuleIndex()

    { return "Modula Indekso"; }

    /*! This is used in LaTeX as the title of the chapter with the 

     * class hierarchy.

     */

    virtual QCString trHierarchicalIndex()

    { return "Hierarkia Indekso"; }

    /*! This is used in LaTeX as the title of the chapter with the 

     * annotated compound index.

     */

    virtual QCString trCompoundIndex()

    {

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      { 

        return "Datumstruktura Indekso";

      }

      else

      {

        return "Klasa Indekso"; 

      }

    }

    /*! This is used in LaTeX as the title of the chapter with the

     * list of all files.

     */

    virtual QCString trFileIndex() 

    { return "Dosiera Indekso"; }

    /*! This is used in LaTeX as the title of the chapter containing

     *  the documentation of all groups.

     */

    virtual QCString trModuleDocumentation()

    { return "Modula Dokumentado"; }

    /*! This is used in LaTeX as the title of the chapter containing

     *  the documentation of all classes, structs and unions.

     */

    virtual QCString trClassDocumentation()

    { 

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "Datumstruktura Dokumentado"; 

      }

      else

      {

        return "Klasa Dokumentado"; 

      }

    }

    /*! This is used in LaTeX as the title of the chapter containing

     *  the documentation of all files.

     */

    virtual QCString trFileDocumentation()

    { return "Dosiera Dokumentado"; }

    /*! This is used in LaTeX as the title of the chapter containing

     *  the documentation of all examples.

     */

    virtual QCString trExampleDocumentation()

    { return "Ekzempla Dokumentado"; }

    /*! This is used in LaTeX as the title of the chapter containing

     *  the documentation of all related pages.

     */

    virtual QCString trPageDocumentation()

    { return "Paĝa Dokumentado"; }

    /*! This is used in LaTeX as the title of the document */

    virtual QCString trReferenceManual()

    { return "Referenca Manlibro"; }

    /*! This is used in the documentation of a file as a header before the 

     *  list of defines

     */

    virtual QCString trDefines()

    { return "Difinoj"; }

    /*! This is used in the documentation of a file as a header before the 

     *  list of function prototypes

     */

    virtual QCString trFuncProtos()

    { return "Funkciaj Prototipoj"; }

    /*! This is used in the documentation of a file as a header before the 

     *  list of typedefs

     */

    virtual QCString trTypedefs()

    { return "Tipdifinoj"; }

    /*! This is used in the documentation of a file as a header before the 

     *  list of enumerations

     */

    virtual QCString trEnumerations()

    { return "Enumeracioj"; }

    /*! This is used in the documentation of a file as a header before the 

     *  list of (global) functions

     */

    virtual QCString trFunctions()

    { return "Funkcioj"; }

    /*! This is used in the documentation of a file as a header before the 

     *  list of (global) variables

     */

    virtual QCString trVariables()

    { return "Variabloj"; }

    /*! This is used in the documentation of a file as a header before the 

     *  list of (global) variables

     */

    virtual QCString trEnumerationValues()

    { return "Enumeraciilo"; }

    /*! This is used in the documentation of a file before the list of

     *  documentation blocks for defines

     */

    virtual QCString trDefineDocumentation()

    { return "Difina Dokumentado"; }

    /*! This is used in the documentation of a file/namespace before the list 

     *  of documentation blocks for function prototypes

     */

    virtual QCString trFunctionPrototypeDocumentation()

    { return "Dokumentado de Funkciaj Prototipoj"; }

    /*! This is used in the documentation of a file/namespace before the list 

     *  of documentation blocks for typedefs

     */

    virtual QCString trTypedefDocumentation()

    { return "Tipdifina Dokumentado"; }

    /*! This is used in the documentation of a file/namespace before the list 

     *  of documentation blocks for enumeration types

     */

    virtual QCString trEnumerationTypeDocumentation()

    { return "Enumeracitipa Dokumentado"; }

    /*! This is used in the documentation of a file/namespace before the list 

     *  of documentation blocks for functions

     */

    virtual QCString trFunctionDocumentation()

    { return "Funkcia Dokumentado"; }

    /*! This is used in the documentation of a file/namespace before the list 

     *  of documentation blocks for variables

     */

    virtual QCString trVariableDocumentation()

    { return "Variabla Dokumentado"; }

    /*! This is used in the documentation of a file/namespace/group before 

     *  the list of links to documented compounds

     */

    virtual QCString trCompounds()

    { 

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "Datumstrukturoj"; 

      }

      else

      {

        return "Klasoj"; 

      }

    }

    /*! This is used in the standard footer of each page and indicates when 

     *  the page was generated 

     */

    virtual QCString trGeneratedAt(const char *date,const char *projName)

    { 

      QCString result=(QCString)"Generita la "+date;

      if (projName) result+=(QCString)" por "+projName;

      result+=(QCString)" de";

      return result;

    }

    /*! This is part of the sentence used in the standard footer of each page.

     */

    virtual QCString trWrittenBy()

    {

      return "skribita de";

    }