1 /******************************************************************************

     2  *

     3  *

     4  *

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

     6  *

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

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

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

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

    11  * See the GNU General Public License for more details.

    12  *

    13  * Documents produced by Doxygen are derivative works derived from the

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

    15  *

    16  * The translation into Chinesetraditional was provided by

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

    18  */

    19 

    20 #ifndef TRANSLATOR_TW_H

    21 #define TRANSLATOR_TW_H

    22 

    23 // When defining a translator class for the new language, follow

    24 // the description in the documentation.  One of the steps says

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

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

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

    28 // implement exactly the same (pure virtual) methods as the

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

    30 // start with the copy of TranslatorEnglish and replace the strings

    31 // one by one.

    32 //

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

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

    35 // language.cpp correctly.  Not including any of the mentioned

    36 // files frees the maintainer from thinking about whether the

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

    38 // why.  This holds namely for localized translators because their

    39 // base class is changed occasionaly to adapter classes when the

    40 // Translator class changes the interface, or back to the

    41 // Translator class (by the local maintainer) when the localized

    42 // translator is made up-to-date again.

    43 

    44 class TranslatorChinesetraditional : public TranslatorAdapter_1_6_0

    45 {

    46   public:

    47 

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

    49 

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

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

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

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

    54      * the identification used in language.cpp.

    55      */

    56     virtual QCString idLanguage()

    57     { return "chinese-traditional"; }

    58 

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

    60      *  This method should return string with commands that switch

    61      *  LaTeX to the desired language.  For example

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

    63      *  </pre>

    64      *  or

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

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

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

    68      *  </pre>

    69      *

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

    71      * the empty string is returned in this implementation.

    72      */

    73     virtual QCString latexLanguageSupportCommand()

    74     {

    75       return "";

    76     }

    77 

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

    79     virtual QCString idLanguageCharset()

    80     {

    81       return "big5";

    82     }

    83 

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

    85 

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

    87     virtual QCString trRelatedFunctions()

    88     { return "相關函式"; }

    89 

    90     /*! subscript for the related functions. */

    91     virtual QCString trRelatedSubscript()

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

    93 

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

    95     virtual QCString trDetailedDescription()

    96     { return "詳細描述"; }

    97 

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

    99     virtual QCString trMemberTypedefDocumentation()

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

   101 

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

   103     virtual QCString trMemberEnumerationDocumentation()

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

   105 

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

   107     virtual QCString trMemberFunctionDocumentation()

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

   109 

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

   111     virtual QCString trMemberDataDocumentation()

   112     {

   113       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   114       {

   115         return "欄位說明文件";

   116       }

   117       else

   118       {

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

   120       }

   121     }

   122 

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

   124     virtual QCString trMore()

   125     { return "更多..."; }

   126 

   127     /*! put in the class documentation */

   128     virtual QCString trListOfAllMembers()

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

   130 

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

   132     virtual QCString trMemberList()

   133     { return "成員列表"; }

   134 

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

   136     virtual QCString trThisIsTheListOfAllMembers()

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

   138 

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

   140     virtual QCString trIncludingInheritedMembers()

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

   142 

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

   144      *  parameter s is name of the project name.

   145      */

   146     virtual QCString trGeneratedAutomatically(const char *s)

   147     { QCString result="本文件由Doxygen";

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

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

   150       return result;

   151     }

   152 

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

   154     virtual QCString trEnumName()

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

   156 

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

   158     virtual QCString trEnumValue()

   159     { return "列舉值"; }

   160 

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

   162     virtual QCString trDefinedIn()

   163     { return "被定義於"; }

   164 

   165     // quick reference sections

   166 

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

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

   169      */

   170     virtual QCString trModules()

   171     { return "模組"; }

   172 

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

   174     virtual QCString trClassHierarchy()

   175     { return "類別階層"; }

   176 

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

   178     virtual QCString trCompoundList()

   179     {

   180       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   181       {

   182         return "資料結構";

   183       }

   184       else

   185       {

   186         return "複合列表";

   187       }

   188     }

   189 

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

   191     virtual QCString trFileList()

   192     { return "檔案列表"; }

   193 

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

   195     virtual QCString trCompoundMembers()

   196     {

   197       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   198       {

   199         return "資料欄位";

   200       }

   201       else

   202       {

   203         return "複合成員";

   204       }

   205     }

   206 

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

   208     virtual QCString trFileMembers()

   209     {

   210       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   211       {

   212         return "全域資料";

   213       }

   214       else

   215       {

   216         return "檔案成員";

   217       }

   218     }

   219 

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

   221     virtual QCString trRelatedPages()

   222     { return "相關頁面"; }

   223 

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

   225     virtual QCString trExamples()

   226     { return "範例"; }

   227 

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

   229     virtual QCString trSearch()

   230     { return "搜尋"; }

   231 

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

   233     virtual QCString trClassHierarchyDescription()

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

   235     }

   236 

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

   238     virtual QCString trFileListDescription(bool extractAll)

   239     {

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

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

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

   243       return result;

   244     }

   245 

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

   247     virtual QCString trCompoundListDescription()

   248     {

   249 

   250       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   251       {

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

   253       }

   254       else

   255       {

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

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

   258       }

   259     }

   260 

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

   262     virtual QCString trCompoundMembersDescription(bool extractAll)

   263     {

   264       QCString result="這是全部";

   265       if (!extractAll)

   266       {

   267         result+="文件化過";

   268       }

   269       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   270       {

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

   272       }

   273       else

   274       {

   275         result+="類別成員";

   276       }

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

   278       if (!extractAll)

   279       {

   280         if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   281         {

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

   283         }

   284         else

   285         {

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

   287         }

   288       }

   289       else

   290       {

   291         if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   292         {

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

   294         }

   295         else

   296         {

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

   298         }

   299       }

   300       return result;

   301     }

   302 

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

   304     virtual QCString trFileMembersDescription(bool extractAll)

   305     {

   306       QCString result="這是全部";

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

   308 

   309       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   310       {

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

   312       }

   313       else

   314       {

   315         result+="檔案成員";

   316       }

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

   318       if (extractAll)

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

   320       else

   321         result+="說明文件:";

   322       return result;

   323     }

   324 

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

   326     virtual QCString trExamplesDescription()

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

   328 

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

   330     virtual QCString trRelatedPagesDescription()

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

   332 

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

   334     virtual QCString trModulesDescription()

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

   336 

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

   338 

   339 

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

   341     virtual QCString trDocumentation()

   342     { return "說明文件"; }

   343 

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

   345      * index of all groups.

   346      */

   347     virtual QCString trModuleIndex()

   348     { return "模組索引"; }

   349 

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

   351      * class hierarchy.

   352      */

   353     virtual QCString trHierarchicalIndex()

   354     { return "階層索引"; }

   355 

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

   357      * annotated compound index.

   358      */

   359     virtual QCString trCompoundIndex()

   360     {

   361       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   362       {

   363         return "資料結構索引";

   364       }

   365       else

   366       {

   367         return "複合索引";

   368       }

   369     }

   370 

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

   372      * list of all files.

   373      */

   374     virtual QCString trFileIndex()

   375     { return "檔案索引"; }

   376 

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

   378      *  the documentation of all groups.

   379      */

   380     virtual QCString trModuleDocumentation()

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

   382 

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

   384      *  the documentation of all classes, structs and unions.

   385      */

   386     virtual QCString trClassDocumentation()

   387     {

   388       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   389       {

   390         return "資料結構說明文件";

   391       }

   392       else

   393       {

   394         return "類別說明文件";

   395       }

   396     }

   397 

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

   399      *  the documentation of all files.

   400      */

   401     virtual QCString trFileDocumentation()

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

   403 

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

   405      *  the documentation of all examples.

   406      */

   407     virtual QCString trExampleDocumentation()

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

   409 

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

   411      *  the documentation of all related pages.

   412      */

   413     virtual QCString trPageDocumentation()

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

   415 

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

   417     virtual QCString trReferenceManual()

   418     { return "參考手冊"; }

   419 

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

   421      *  list of defines

   422      */

   423     virtual QCString trDefines()

   424     { return "定義"; }

   425 

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

   427      *  list of function prototypes

   428      */

   429     virtual QCString trFuncProtos()

   430     { return "函式原型"; }

   431 

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

   433      *  list of typedefs

   434      */

   435     virtual QCString trTypedefs()

   436     { return "型態定義"; }

   437 

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

   439      *  list of enumerations

   440      */

   441     virtual QCString trEnumerations()

   442     { return "列舉型態"; }

   443 

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

   445      *  list of (global) functions

   446      */

   447     virtual QCString trFunctions()

   448     { return "函式"; }

   449 

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

   451      *  list of (global) variables

   452      */

   453     virtual QCString trVariables()

   454     { return "變數"; }

   455 

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

   457      *  list of (global) variables

   458      */

   459     virtual QCString trEnumerationValues()

   460     { return "列舉值"; }

   461 

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

   463      *  documentation blocks for defines

   464      */

   465     virtual QCString trDefineDocumentation()

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

   467 

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

   469      *  of documentation blocks for function prototypes

   470      */

   471     virtual QCString trFunctionPrototypeDocumentation()

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

   473 

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

   475      *  of documentation blocks for typedefs

   476      */

   477     virtual QCString trTypedefDocumentation()

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

   479 

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

   481      *  of documentation blocks for enumeration types

   482      */

   483     virtual QCString trEnumerationTypeDocumentation()

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

   485 

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

   487      *  of documentation blocks for enumeration values

   488      */

   489     virtual QCString trEnumerationValueDocumentation()

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

   491 

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

   493      *  of documentation blocks for functions

   494      */

   495     virtual QCString trFunctionDocumentation()

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

   497 

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

   499      *  of documentation blocks for variables

   500      */

   501     virtual QCString trVariableDocumentation()

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

   503 

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

   505      *  the list of links to documented compounds

   506      */

   507     virtual QCString trCompounds()

   508     {

   509       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   510       {

   511         return "資料結構";

   512       }

   513       else

   514       {

   515         return "複合項目";

   516       }

   517     }

   518 

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

   520      *  the page was generated

   521      */

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

   523     {

   524       QCString result=(QCString)"產生日期:"+date;

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

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

   527       return result;

   528     }

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

   530      */

   531     virtual QCString trWrittenBy()

   532     {

   533       return "撰寫人:";

   534     }

   535 

   536     /*! this text is put before a class diagram */

   537     virtual QCString trClassDiagram(const char *clName)

   538     {

   539       return (QCString)"類別"+clName+"的繼承圖:";

   540     }

   541 

   542     /*! this text is generated when the \\internal command is used. */

   543     virtual QCString trForInternalUseOnly()

   544     { return "僅供內部使用."; }

   545 

   546     /*! this text is generated when the \\warning command is used. */

   547     virtual QCString trWarning()

   548     { return "警告"; }

   549 

   550     /*! this text is generated when the \\version command is used. */

   551     virtual QCString trVersion()

   552     { return "版本"; }

   553 

   554     /*! this text is generated when the \\date command is used. */

   555     virtual QCString trDate()

   556     { return "日期"; }

   557 

   558     /*! this text is generated when the \\return command is used. */

   559     virtual QCString trReturns()

   560     { return "傳回值"; }

   561 

   562     /*! this text is generated when the \\sa command is used. */

   563     virtual QCString trSeeAlso()

   564     { return "參閱\"; }

   565 

   566     /*! this text is generated when the \\param command is used. */

   567     virtual QCString trParameters()

   568     { return "參數"; }

   569 

   570     /*! this text is generated when the \\exception command is used. */

   571     virtual QCString trExceptions()

   572     { return "例外"; }

   573 

   574     /*! this text is used in the title page of a LaTeX document. */

   575     virtual QCString trGeneratedBy()

   576     { return "產生者:"; }

   577 

   578 //////////////////////////////////////////////////////////////////////////

   579 // new since 0.49-990307

   580 //////////////////////////////////////////////////////////////////////////

   581 

   582     /*! used as the title of page containing all the index of all namespaces. */

   583     virtual QCString trNamespaceList()

   584     { return "命名空間(name space)列表"; }

   585 

   586     /*! used as an introduction to the namespace list */

   587     virtual QCString trNamespaceListDescription(bool extractAll)

   588     {

   589       QCString result="這是所有附帶簡略說明的";

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

   591       result+="命名空間(namespaces):";

   592       return result;

   593     }

   594 

   595     /*! used in the class documentation as a header before the list of all

   596      *  friends of a class

   597      */

   598     virtual QCString trFriends()

   599     { return "類別朋友(Friends)"; }

   600 

   601 //////////////////////////////////////////////////////////////////////////

   602 // new since 0.49-990405

   603 //////////////////////////////////////////////////////////////////////////

   604 

   605     /*! used in the class documentation as a header before the list of all

   606      * related classes

   607      */

   608     virtual QCString trRelatedFunctionDocumentation()

   609     { return "類別朋友及相關函式說明文件"; }

   610 

   611 //////////////////////////////////////////////////////////////////////////

   612 // new since 0.49-990425

   613 //////////////////////////////////////////////////////////////////////////

   614 

   615     /*! used as the title of the HTML page of a class/struct/union */

   616     virtual QCString trCompoundReference(const char *clName,

   617                                     ClassDef::CompoundType compType,

   618                                     bool isTemplate)

   619     {

   620       QCString result=(QCString)clName+" ";

   621       switch(compType)

   622       {

   623         case ClassDef::Class:      result+=" 類別"; break;

   624         case ClassDef::Struct:     result+=" 結構"; break;

   625         case ClassDef::Union:      result+=" 聯合"; break;

   626         case ClassDef::Interface:  result+=" 介面"; break;

   627         case ClassDef::Protocol:   result+=" 協定"; break; 

   628         case ClassDef::Category:   result+=" 分類"; break;

   629         case ClassDef::Exception:  result+=" 例外"; break;

   630       }

   631       if (isTemplate) result+=" 樣版";

   632       result+=" 參考文件";

   633       return result;

   634     }

   635 

   636     /*! used as the title of the HTML page of a file */

   637     virtual QCString trFileReference(const char *fileName)

   638     {

   639       QCString result=fileName;

   640       result+=" 檔案參考文件";

   641       return result;

   642     }

   643 

   644     /*! used as the title of the HTML page of a namespace */

   645     virtual QCString trNamespaceReference(const char *namespaceName)

   646     {

   647       QCString result=namespaceName;

   648       result+=" 命名空間(Namespace)參考文件";

   649       return result;

   650     }

   651 

   652     virtual QCString trPublicMembers()

   653     { return "公開方法(Public Methods)"; }

   654     virtual QCString trPublicSlots()

   655     { return "公開插槽(Public Slots)"; }

   656     virtual QCString trSignals()

   657     { return "訊號(Signals)"; }

   658     virtual QCString trStaticPublicMembers()

   659     { return "靜態公開方法(Static Public Methods)"; }

   660     virtual QCString trProtectedMembers()

   661     { return "保護方法(Protected Methods)"; }

   662     virtual QCString trProtectedSlots()

   663     { return "保護插槽(Protected Slots)"; }

   664     virtual QCString trStaticProtectedMembers()

   665     { return "靜態保護方法(Static Protected Methods)"; }

   666     virtual QCString trPrivateMembers()

   667     { return "私有方法(Private Methods)"; }

   668     virtual QCString trPrivateSlots()

   669     { return "私有插槽(Private Slots)"; }

   670     virtual QCString trStaticPrivateMembers()

   671     { return "靜態私有方法(Static Private Methods)"; }

   672 

   673     /*! this function is used to produce a comma-separated list of items.

   674      *  use generateMarker(i) to indicate where item i should be put.

   675      */

   676     virtual QCString trWriteList(int numEntries)

   677     {

   678       QCString result;

   679       int i;

   680       // the inherits list contain `numEntries' classes

   681       for (i=0;i<numEntries;i++)

   682       {

   683         // use generateMarker to generate placeholders for the class links!

   684         result+=generateMarker(i); // generate marker for entry i in the list

   685                                    // (order is left to right)

   686 

   687         if (i!=numEntries-1)  // not the last entry, so we need a separator

   688         {

   689           if (i<numEntries-2) // not the fore last entry

   690             result+=", ";

   691           else                // the fore last entry

   692             result+=", 及 ";

   693         }

   694       }

   695       return result;

   696     }

   697 

   698     /*! used in class documentation to produce a list of base classes,

   699      *  if class diagrams are disabled.

   700      */

   701     virtual QCString trInheritsList(int numEntries)

   702     {

   703       return "繼承自 "+trWriteList(numEntries)+".";

   704     }

   705 

   706     /*! used in class documentation to produce a list of super classes,

   707      *  if class diagrams are disabled.

   708      */

   709     virtual QCString trInheritedByList(int numEntries)

   710     {

   711       return "被 "+trWriteList(numEntries)+"繼承.";

   712     }

   713 

   714     /*! used in member documentation blocks to produce a list of

   715      *  members that are hidden by this one.

   716      */

   717     virtual QCString trReimplementedFromList(int numEntries)

   718     {

   719       return "依據"+trWriteList(numEntries)+"重新實作.";

   720     }

   721 

   722     /*! used in member documentation blocks to produce a list of

   723      *  all member that overwrite the implementation of this member.

   724      */

   725     virtual QCString trReimplementedInList(int numEntries)

   726     {

   727       return "在"+trWriteList(numEntries)+"重新實作.";

   728     }

   729 

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

   731     virtual QCString trNamespaceMembers()

   732     { return "命名空間(Namespace)成員"; }

   733 

   734     /*! This is an introduction to the page with all namespace members */

   735     virtual QCString trNamespaceMemberDescription(bool extractAll)

   736     {

   737       QCString result="此處列表為所有 ";

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

   739       result+="命名空間(namespace)成員，並且附帶連結至 ";

   740       if (extractAll)

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

   742       else

   743         result+="該命名空間所屬之處:";

   744       return result;

   745     }

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

   747      *  index of all namespaces.

   748      */

   749     virtual QCString trNamespaceIndex()

   750     { return "命名空間(Namespace)索引"; }

   751 

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

   753      *  the documentation of all namespaces.

   754      */

   755     virtual QCString trNamespaceDocumentation()

   756     { return "命名空間(Namespace)說明文件"; }

   757 

   758 //////////////////////////////////////////////////////////////////////////

   759 // new since 0.49-990522

   760 //////////////////////////////////////////////////////////////////////////

   761 

   762     /*! This is used in the documentation before the list of all

   763      *  namespaces in a file.

   764      */

   765     virtual QCString trNamespaces()

   766     { return "命名空間(Namespaces)"; }

   767 

   768 //////////////////////////////////////////////////////////////////////////

   769 // new since 0.49-990728

   770 //////////////////////////////////////////////////////////////////////////

   771 

   772     /*! This is put at the bottom of a class documentation page and is

   773      *  followed by a list of files that were used to generate the page.

   774      */

   775     virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,

   776         bool single)

   777     { // here s is one of " Class", " Struct" or " Union"

   778       // single is true implies a single file

   779       QCString result=(QCString)"此";

   780       switch(compType)

   781       {

   782         case ClassDef::Class:      result+="類別(class)"; break;

   783         case ClassDef::Struct:     result+="結構(structure)"; break;

   784         case ClassDef::Union:      result+="聯合(union)"; break;

   785         case ClassDef::Interface:  result+="介面(interface)"; break;

   786         case ClassDef::Protocol:   result+="協定(protocol)"; break;

   787         case ClassDef::Category:   result+="分類(category)"; break;

   788         case ClassDef::Exception:  result+="例外(exception)"; break;

   789       }

   790       result+=" 文件是由下列檔案中產生";

   791       if (single) result+=":"; else result+=":";

   792       return result;

   793     }

   794 

   795     /*! This is in the (quick) index as a link to the alphabetical compound

   796      * list.

   797      */

   798     virtual QCString trAlphabeticalList()

   799     { return "字母順序列表"; }

   800 

   801 //////////////////////////////////////////////////////////////////////////

   802 // new since 0.49-990901

   803 //////////////////////////////////////////////////////////////////////////

   804 

   805     /*! This is used as the heading text for the retval command. */

   806     virtual QCString trReturnValues()

   807     { return "傳回值"; }

   808 

   809     /*! This is in the (quick) index as a link to the main page (index.html)

   810      */

   811     virtual QCString trMainPage()

   812     { return "主頁面"; }

   813 

   814     /*! This is used in references to page that are put in the LaTeX

   815      *  documentation. It should be an abbreviation of the word page.

   816      */

   817     virtual QCString trPageAbbreviation()

   818     { return "p."; }

   819 

   820 //////////////////////////////////////////////////////////////////////////

   821 // new since 0.49-991003

   822 //////////////////////////////////////////////////////////////////////////

   823 

   824     virtual QCString trDefinedAtLineInSourceFile()

   825     {

   826       return "定義在 @1 檔案之第 @0 行.";

   827     }

   828     virtual QCString trDefinedInSourceFile()

   829     {

   830       return "定義在 @0 檔.";

   831     }

   832 

   833 //////////////////////////////////////////////////////////////////////////

   834 // new since 0.49-991205

   835 //////////////////////////////////////////////////////////////////////////

   836 

   837     virtual QCString trDeprecated()

   838     {

   839       return "過時";

   840     }

   841 

   842 //////////////////////////////////////////////////////////////////////////

   843 // new since 1.0.0

   844 //////////////////////////////////////////////////////////////////////////

   845 

   846     /*! this text is put before a collaboration diagram */

   847     virtual QCString trCollaborationDiagram(const char *clName)

   848     {

   849       return (QCString)""+clName+"的合作圖:";

   850     }

   851     /*! this text is put before an include dependency graph */

   852     virtual QCString trInclDepGraph(const char *fName)

   853     {

   854       return (QCString)""+fName+"的包含相依圖:";

   855     }

   856     /*! header that is put before the list of constructor/destructors. */

   857     virtual QCString trConstructorDocumentation()

   858     {

   859       return "建構子與解構子說明文件";

   860     }

   861     /*! Used in the file documentation to point to the corresponding sources. */

   862     virtual QCString trGotoSourceCode()

   863     {

   864       return "查看本檔案的原始碼.";

   865     }

   866     /*! Used in the file sources to point to the corresponding documentation. */

   867     virtual QCString trGotoDocumentation()

   868     {

   869       return "查看本檔案說明文件.";

   870     }

   871     /*! Text for the \\pre command */

   872     virtual QCString trPrecondition()

   873     {

   874       return "前置條件";

   875     }

   876     /*! Text for the \\post command */

   877     virtual QCString trPostcondition()

   878     {

   879       return "後置條件";

   880     }

   881     /*! Text for the \\invariant command */

   882     virtual QCString trInvariant()

   883     {

   884       return "常數";

   885     }

   886     /*! Text shown before a multi-line variable/enum initialization */

   887     virtual QCString trInitialValue()

   888     {

   889       return "初值:";

   890     }

   891     /*! Text used the source code in the file index */

   892     virtual QCString trCode()

   893     {

   894       return "程式碼";

   895     }

   896     virtual QCString trGraphicalHierarchy()

   897     {

   898       return "圖形化之類別階層";

   899     }

   900     virtual QCString trGotoGraphicalHierarchy()

   901     {

   902       return "查看圖形化之類別階層";

   903     }

   904     virtual QCString trGotoTextualHierarchy()

   905     {

   906       return "查看文字化之類別階層";

   907     }

   908     virtual QCString trPageIndex()

   909     {

   910       return "頁面索引";

   911     }

   912 

   913 //////////////////////////////////////////////////////////////////////////

   914 // new since 1.1.0

   915 //////////////////////////////////////////////////////////////////////////

   916 

   917     virtual QCString trNote()

   918     {

   919       return "註";

   920     }

   921     virtual QCString trPublicTypes()

   922     {

   923       return "公開型態";

   924     }

   925     virtual QCString trPublicAttribs()

   926     {

   927       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   928       {

   929         return "資料欄位";

   930       }

   931       else

   932       {

   933         return "公開屬性";

   934       }

   935     }

   936     virtual QCString trStaticPublicAttribs()

   937     {

   938       return "靜態公開屬性";

   939     }

   940     virtual QCString trProtectedTypes()

   941     {

   942       return "保護型態";

   943     }

   944     virtual QCString trProtectedAttribs()

   945     {

   946       return "保護屬性";

   947     }

   948     virtual QCString trStaticProtectedAttribs()

   949     {

   950       return "靜態保護屬性";

   951     }

   952     virtual QCString trPrivateTypes()

   953     {

   954       return "私有型態";

   955     }

   956     virtual QCString trPrivateAttribs()

   957     {

   958       return "私有屬性";

   959     }

   960     virtual QCString trStaticPrivateAttribs()

   961     {

   962       return "靜態私有屬性";

   963     }

   964 

   965 //////////////////////////////////////////////////////////////////////////

   966 // new since 1.1.3

   967 //////////////////////////////////////////////////////////////////////////

   968 

   969     /*! Used as a marker that is put before a \\todo item */

   970     virtual QCString trTodo()

   971     {

   972       return "待辦事項";

   973     }

   974     /*! Used as the header of the todo list */

   975     virtual QCString trTodoList()

   976     {

   977       return "待辦事項列表";

   978     }

   979 

   980 //////////////////////////////////////////////////////////////////////////

   981 // new since 1.1.4

   982 //////////////////////////////////////////////////////////////////////////

   983 

   984     virtual QCString trReferencedBy()

   985     {

   986       return "被參考於";

   987     }

   988     virtual QCString trRemarks()

   989     {

   990       return "備註";

   991     }

   992     virtual QCString trAttention()

   993     {

   994       return "注意";

   995     }

   996     virtual QCString trInclByDepGraph()

   997     {

   998       return "本圖顯示出哪些檔案直接或間接include本檔 "

   999              ":";

  1000     }

  1001     virtual QCString trSince()

  1002     {

  1003       return "自";

  1004     }

  1005 

  1006 //////////////////////////////////////////////////////////////////////////

  1007 // new since 1.1.5

  1008 //////////////////////////////////////////////////////////////////////////

  1009 

  1010     /*! title of the graph legend page */

  1011     virtual QCString trLegendTitle()

  1012     {

  1013       return "圖示";

  1014     }

  1015     /*! page explaining how the dot graph's should be interpreted

  1016      *  The %A in the text below are to prevent link to classes called "A".

  1017      */

  1018     virtual QCString trLegendDocs()

  1019     {

  1020       return

  1021         "本頁解釋如何解譯這些由doxygen所產生的圖示 "

  1022         ".<p>\n"

  1023         "請看下面範例:\n"

  1024         "\\code\n"

  1025         "/*! 因為截斷的不可見類別 */\n"

  1026         "class Invisible { };\n\n"

  1027         "/*! 截斷的類別, 繼承關係被隱藏 */\n"

  1028         "class Truncated : public Invisible { };\n\n"

  1029         "/* 未經過doxygen註解處理過的類別 */\n"

  1030         "class Undocumented { };\n\n"

  1031         "/*! 經過公開(Public)繼承的類別 */\n"

  1032         "class PublicBase : public Truncated { };\n\n"

  1033         "/*! 一個樣版類別 */\n"

  1034         "template<class T> class Templ { };\n\n"

  1035         "/*! 使用保護(Protected)繼承的類別 */\n"

  1036         "class ProtectedBase { };\n\n"

  1037         "/*! 使用私有(Private)繼承的類別 */\n"

  1038         "class PrivateBase { };\n\n"

  1039         "/*! 由被繼承類別所使用的類別 */\n"

  1040         "class Used { };\n\n"

  1041         "/*! 由數個其他類別所繼承來的超類別(Super Class) */\n"

  1042         "class Inherited : public PublicBase,\n"

  1043         "                  protected ProtectedBase,\n"

  1044         "                  private PrivateBase,\n"

  1045         "                  public Undocumented,\n"

  1046         "                  public Templ<int>\n"

  1047         "{\n"

  1048         "  private:\n"

  1049         "    Used *m_usedClass;\n"

  1050         "};\n"

  1051         "\\endcode\n"

  1052         "若在組態檔中的 \\c MAX_DOT_GRAPH_HEIGHT tag "

  1053         "設為 240，將會產生下列的圖示:"

  1054         "<p><center><img src=\"graph_legend."+Config_getEnum("DOT_IMAGE_FORMAT")+"\"></center>\n"

  1055         "<p>\n"

  1056         "上圖中的各區塊意義如下:\n"

  1057         "<ul>\n"

  1058         "<li>%A 填滿黑色的區塊代表產生這個圖示的類別或結構 "

  1059         ".\n"

  1060         "<li>%A 黑邊的區塊代表文件化過的結構或類別.\n"

  1061         "<li>%A 灰邊的區塊代表未經文件化的結構或是類別.\n"

  1062         "<li>%A 紅邊的區塊代表文件化的結構或是類別，"

  1063         "這些結構或類別的繼承或包含關係不會全部顯示. %A 圖示 "

  1064         "若無法塞入指定的邊界中將會被截斷.\n"

  1065         "</ul>\n"

  1066         "箭頭具有下面的意義:\n"

  1067         "<ul>\n"

  1068         "<li>%A 深藍色箭頭用來代表兩個類別間的公開繼承 "

  1069         "關係.\n"

  1070         "<li>%A 深綠色箭頭代表保護繼承.\n"

  1071         "<li>%A 深紅色箭頭代表私有繼承.\n"

  1072         "<li>%A 紫色箭頭用來表示類別被另一個包含或是使用."

  1073         "箭頭上標示著可存取該類別或是結構的對應變數"

  1074         ".\n"

  1075         "<li>%A 黃色箭頭代表樣版實體與樣版類別之間的關係。"

  1076         "箭頭上標記著樣版實體上的參數"

  1077         ".\n"

  1078         "</ul>\n";

  1079     }

  1080     /*! text for the link to the legend page */

  1081     virtual QCString trLegend()

  1082     {

  1083       return "圖示";

  1084     }

  1085 

  1086 //////////////////////////////////////////////////////////////////////////

  1087 // new since 1.2.0

  1088 //////////////////////////////////////////////////////////////////////////

  1089 

  1090     /*! Used as a marker that is put before a test item */

  1091     virtual QCString trTest()

  1092     {

  1093       return "測試項目";

  1094     }

  1095     /*! Used as the header of the test list */

  1096     virtual QCString trTestList()

  1097     {

  1098       return "測試項目列表";

  1099     }

  1100 

  1101 //////////////////////////////////////////////////////////////////////////

  1102 // new since 1.2.1

  1103 //////////////////////////////////////////////////////////////////////////

  1104 

  1105     /*! Used as a section header for KDE-2 IDL methods */

  1106     virtual QCString trDCOPMethods()

  1107     {

  1108       return "DCOP方法";

  1109     }

  1110 

  1111 //////////////////////////////////////////////////////////////////////////

  1112 // new since 1.2.2

  1113 //////////////////////////////////////////////////////////////////////////

  1114 

  1115     /*! Used as a section header for IDL properties */

  1116     virtual QCString trProperties()

  1117     {

  1118       return "屬性(properties)";

  1119     }

  1120     /*! Used as a section header for IDL property documentation */

  1121     virtual QCString trPropertyDocumentation()

  1122     {

  1123       return "屬性(property)說明文件";

  1124     }

  1125 

  1126 //////////////////////////////////////////////////////////////////////////

  1127 // new since 1.2.4

  1128 //////////////////////////////////////////////////////////////////////////

  1129 

  1130     /*! Used for Java classes in the summary section of Java packages */

  1131     virtual QCString trClasses()

  1132     {

  1133       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

  1134       {