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

 *

 *

 *

 * Copyright (C) 1997-2008 by Dimitri van Heesch.

 *

 * 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.

 *

 * The translation into Chinesetraditional was provided by

 *   Daniel YC Lin (dlin.tw <at> gmail.com) since v1.2.16-v1.5.5

 */

#ifndef TRANSLATOR_TW_H

#define TRANSLATOR_TW_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.

class TranslatorChinesetraditional : public TranslatorAdapter_1_6_0

{

  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 "chinese-traditional"; }

    /*! 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 "";

    }

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

    virtual QCString idLanguageCharset()

    {

      return "big5";

    }

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

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

    virtual QCString trRelatedFunctions()

    { return "相關函式"; }

    /*! subscript for the related functions. */

    virtual QCString trRelatedSubscript()

    { return "(註：這些不是成員函式)"; }

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

    virtual QCString trDetailedDescription()

    { return "詳細描述"; }

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

    virtual QCString trMemberTypedefDocumentation()

    { return "型態定義成員說明文件"; }

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

    virtual QCString trMemberEnumerationDocumentation()

    { return "列舉型態成員說明文件"; }

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

    virtual QCString trMemberFunctionDocumentation()

    { return "函式成員說明文件"; }

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

    virtual QCString trMemberDataDocumentation()

    {

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "欄位說明文件";

      }

      else

      {

        return "資料成員說明文件";

      }

    }

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

    virtual QCString trMore()

    { return "更多..."; }

    /*! put in the class documentation */

    virtual QCString trListOfAllMembers()

    { return "全部成員列表"; }

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

    virtual QCString trMemberList()

    { return "成員列表"; }

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

    virtual QCString trThisIsTheListOfAllMembers()

    { return "完整成員列表，類別為"; }

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

    virtual QCString trIncludingInheritedMembers()

    { return ", 包含所有繼承的成員"; }

    /*! 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="本文件由Doxygen";

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

      result+=" 的原始碼中自動產生.";

      return result;

    }

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

    virtual QCString trEnumName()

    { return "列舉型態名稱"; }

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

    virtual QCString trEnumValue()

    { return "列舉值"; }

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

    virtual QCString trDefinedIn()

    { return "被定義於"; }

    // 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 "模組"; }

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

    virtual QCString trClassHierarchy()

    { return "類別階層"; }

    /*! 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 "資料結構";

      }

      else

      {

        return "複合列表";

      }

    }

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

    virtual QCString trFileList()

    { return "檔案列表"; }

    /*! 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 "資料欄位";

      }

      else

      {

        return "複合成員";

      }

    }

    /*! 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 "全域資料";

      }

      else

      {

        return "檔案成員";

      }

    }

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

    virtual QCString trRelatedPages()

    { return "相關頁面"; }

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

    virtual QCString trExamples()

    { return "範例"; }

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

    virtual QCString trSearch()

    { return "搜尋"; }

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

    virtual QCString trClassHierarchyDescription()

    { return "這個繼承列表經過簡略的字母排序: ";

    }

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

    virtual QCString trFileListDescription(bool extractAll)

    {

      QCString result="這是附帶簡略說明";

      if (!extractAll) result+="且經過文件化";

      result+="的檔案列表:";

      return result;

    }

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

    virtual QCString trCompoundListDescription()

    {

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        return "這是附帶簡略說明的資料結構:";

      }

      else

      {

        return "這是附帶簡略說明的類別，結構，"

               "聯合型態(unions)及介面(interfaces):";

      }

    }

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

    virtual QCString trCompoundMembersDescription(bool extractAll)

    {

      QCString result="這是全部";

      if (!extractAll)

      {

        result+="文件化過";

      }

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        result+="結構及聯合型態欄位";

      }

      else

      {

        result+="類別成員";

      }

      result+=", 並且帶有連結至";

      if (!extractAll)

      {

        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

        {

          result+="每個欄位的結構/聯合型態說明文件:";

        }

        else

        {

          result+="每個成員的類別說明文件:";

        }

      }

      else

      {

        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

        {

          result+="這些結構/聯合型態所屬:";

        }

        else

        {

          result+="這些類別所屬:";

        }

      }

      return result;

    }

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

    virtual QCString trFileMembersDescription(bool extractAll)

    {

      QCString result="這是全部";

      if (!extractAll) result+="文件化的";

      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

      {

        result+="函式，變數，定義，列舉，及型態定義";

      }

      else

      {

        result+="檔案成員";

      }

      result+="，並且帶有連結至";

      if (extractAll)

        result+="這些檔案所屬:";

      else

        result+="說明文件:";

      return result;

    }

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

    virtual QCString trExamplesDescription()

    { return "所有範例列表:"; }

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

    virtual QCString trRelatedPagesDescription()

    { return "所有相關文件頁面列表:"; }

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

    virtual QCString trModulesDescription()

    { return "所有模組列表:"; }

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

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

    virtual QCString trDocumentation()

    { return "說明文件"; }

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

     * index of all groups.

     */

    virtual QCString trModuleIndex()

    { return "模組索引"; }

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

     * class hierarchy.

     */

    virtual QCString trHierarchicalIndex()

    { return "階層索引"; }

    /*! 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 "資料結構索引";

      }

      else

      {

        return "複合索引";

      }

    }

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

     * list of all files.

     */

    virtual QCString trFileIndex()

    { return "檔案索引"; }

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

     *  the documentation of all groups.

     */

    virtual QCString trModuleDocumentation()

    { return "模組說明文件"; }

    /*! 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 "資料結構說明文件";

      }

      else

      {

        return "類別說明文件";

      }

    }

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

     *  the documentation of all files.

     */

    virtual QCString trFileDocumentation()

    { return "檔案說明文件"; }

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

     *  the documentation of all examples.

     */

    virtual QCString trExampleDocumentation()

    { return "範例說明文件"; }

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

     *  the documentation of all related pages.

     */

    virtual QCString trPageDocumentation()

    { return "頁面說明文件"; }

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

    virtual QCString trReferenceManual()

    { return "參考手冊"; }

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

     *  list of defines

     */

    virtual QCString trDefines()

    { return "定義"; }

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

     *  list of function prototypes

     */

    virtual QCString trFuncProtos()

    { return "函式原型"; }

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

     *  list of typedefs

     */

    virtual QCString trTypedefs()

    { return "型態定義"; }

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

     *  list of enumerations

     */

    virtual QCString trEnumerations()

    { return "列舉型態"; }

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

     *  list of (global) functions

     */

    virtual QCString trFunctions()

    { return "函式"; }

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

     *  list of (global) variables

     */

    virtual QCString trVariables()

    { return "變數"; }

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

     *  list of (global) variables

     */

    virtual QCString trEnumerationValues()

    { return "列舉值"; }

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

     *  documentation blocks for defines

     */

    virtual QCString trDefineDocumentation()

    { return "定義巨集說明文件"; }

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

     *  of documentation blocks for function prototypes

     */

    virtual QCString trFunctionPrototypeDocumentation()

    { return "函式原型說明文件"; }

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

     *  of documentation blocks for typedefs

     */

    virtual QCString trTypedefDocumentation()

    { return "型態定義說明文件"; }

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

     *  of documentation blocks for enumeration types

     */

    virtual QCString trEnumerationTypeDocumentation()

    { return "列舉型態說明文件"; }

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

     *  of documentation blocks for enumeration values

     */

    virtual QCString trEnumerationValueDocumentation()

    { return "列舉值說明文件"; }

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

     *  of documentation blocks for functions

     */

    virtual QCString trFunctionDocumentation()

    { return "函式說明文件"; }

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

     *  of documentation blocks for variables

     */

    virtual QCString trVariableDocumentation()

    { return "變數說明文件"; }

    /*! 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 "資料結構";

      }

      else

      {

        return "複合項目";

      }

    }

    /*! 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)"產生日期:"+date;

      if (projName) result+=(QCString)", 專案:"+projName;

      result+=(QCString)", 產生器:";

      return result;

    }