diff -r 000000000000 -r 42188c7ea2d9 Orb/Doxygen/src/translator_tw.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Orb/Doxygen/src/translator_tw.h Thu Jan 21 17:29:01 2010 +0000 @@ -0,0 +1,1759 @@ +/****************************************************************************** + * + * + * + * 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 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 + *
"\\usepackage[german]{babel}\n"
+     *  
+ * or + *
"\\usepackage{polski}\n"
+     *  "\\usepackage[latin2]{inputenc}\n"
+     *  "\\usepackage[T1]{fontenc}\n"
+     *  
+ * + * 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; + } + /*! This is part of the sentence used in the standard footer of each page. + */ + virtual QCString trWrittenBy() + { + return "撰寫人:"; + } + + /*! this text is put before a class diagram */ + virtual QCString trClassDiagram(const char *clName) + { + return (QCString)"類別"+clName+"的繼承圖:"; + } + + /*! this text is generated when the \\internal command is used. */ + virtual QCString trForInternalUseOnly() + { return "僅供內部使用."; } + + /*! this text is generated when the \\warning command is used. */ + virtual QCString trWarning() + { return "警告"; } + + /*! this text is generated when the \\version command is used. */ + virtual QCString trVersion() + { return "版本"; } + + /*! this text is generated when the \\date command is used. */ + virtual QCString trDate() + { return "日期"; } + + /*! this text is generated when the \\return command is used. */ + virtual QCString trReturns() + { return "傳回值"; } + + /*! this text is generated when the \\sa command is used. */ + virtual QCString trSeeAlso() + { return "參閱\"; } + + /*! this text is generated when the \\param command is used. */ + virtual QCString trParameters() + { return "參數"; } + + /*! this text is generated when the \\exception command is used. */ + virtual QCString trExceptions() + { return "例外"; } + + /*! this text is used in the title page of a LaTeX document. */ + virtual QCString trGeneratedBy() + { return "產生者:"; } + +////////////////////////////////////////////////////////////////////////// +// new since 0.49-990307 +////////////////////////////////////////////////////////////////////////// + + /*! used as the title of page containing all the index of all namespaces. */ + virtual QCString trNamespaceList() + { return "命名空間(name space)列表"; } + + /*! used as an introduction to the namespace list */ + virtual QCString trNamespaceListDescription(bool extractAll) + { + QCString result="這是所有附帶簡略說明的"; + if (!extractAll) result+="文件化的"; + result+="命名空間(namespaces):"; + return result; + } + + /*! used in the class documentation as a header before the list of all + * friends of a class + */ + virtual QCString trFriends() + { return "類別朋友(Friends)"; } + +////////////////////////////////////////////////////////////////////////// +// new since 0.49-990405 +////////////////////////////////////////////////////////////////////////// + + /*! used in the class documentation as a header before the list of all + * related classes + */ + virtual QCString trRelatedFunctionDocumentation() + { return "類別朋友及相關函式說明文件"; } + +////////////////////////////////////////////////////////////////////////// +// new since 0.49-990425 +////////////////////////////////////////////////////////////////////////// + + /*! used as the title of the HTML page of a class/struct/union */ + virtual QCString trCompoundReference(const char *clName, + ClassDef::CompoundType compType, + bool isTemplate) + { + QCString result=(QCString)clName+" "; + switch(compType) + { + case ClassDef::Class: result+=" 類別"; break; + case ClassDef::Struct: result+=" 結構"; break; + case ClassDef::Union: result+=" 聯合"; break; + case ClassDef::Interface: result+=" 介面"; break; + case ClassDef::Protocol: result+=" 協定"; break; + case ClassDef::Category: result+=" 分類"; break; + case ClassDef::Exception: result+=" 例外"; break; + } + if (isTemplate) result+=" 樣版"; + result+=" 參考文件"; + return result; + } + + /*! used as the title of the HTML page of a file */ + virtual QCString trFileReference(const char *fileName) + { + QCString result=fileName; + result+=" 檔案參考文件"; + return result; + } + + /*! used as the title of the HTML page of a namespace */ + virtual QCString trNamespaceReference(const char *namespaceName) + { + QCString result=namespaceName; + result+=" 命名空間(Namespace)參考文件"; + return result; + } + + virtual QCString trPublicMembers() + { return "公開方法(Public Methods)"; } + virtual QCString trPublicSlots() + { return "公開插槽(Public Slots)"; } + virtual QCString trSignals() + { return "訊號(Signals)"; } + virtual QCString trStaticPublicMembers() + { return "靜態公開方法(Static Public Methods)"; } + virtual QCString trProtectedMembers() + { return "保護方法(Protected Methods)"; } + virtual QCString trProtectedSlots() + { return "保護插槽(Protected Slots)"; } + virtual QCString trStaticProtectedMembers() + { return "靜態保護方法(Static Protected Methods)"; } + virtual QCString trPrivateMembers() + { return "私有方法(Private Methods)"; } + virtual QCString trPrivateSlots() + { return "私有插槽(Private Slots)"; } + virtual QCString trStaticPrivateMembers() + { return "靜態私有方法(Static Private Methods)"; } + + /*! this function is used to produce a comma-separated list of items. + * use generateMarker(i) to indicate where item i should be put. + */ + virtual QCString trWriteList(int numEntries) + { + QCString result; + int i; + // the inherits list contain `numEntries' classes + for (i=0;i