1 /******************************************************************************
5 * Copyright (C) 1997-2015 by Dimitri van Heesch.
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.
13 * Documents produced by Doxygen are derivative works derived from the
14 * input used in their production; they are not affected by this license.
16 * The translation into Chinesetraditional was provided by
17 * Daniel YC Lin (dlin.tw <at> gmail.com) since v1.2.16-v1.5.5
20 #ifndef TRANSLATOR_TW_H
21 #define TRANSLATOR_TW_H
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
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.
44 class TranslatorChinesetraditional : public TranslatorAdapter_1_8_15
48 // --- Language control methods -------------------
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.
56 virtual QCString idLanguage()
57 { return "chinese-traditional"; }
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"
65 * <pre>"\\usepackage{polski}\n"
66 * "\\usepackage[latin2]{inputenc}\n"
67 * "\\usepackage[T1]{fontenc}\n"
70 * The English LaTeX does not use such commands. Because of this
71 * the empty string is returned in this implementation.
73 virtual QCString latexLanguageSupportCommand()
75 return "\\usepackage{CJKutf8}\n";
77 virtual QCString latexFontenc()
81 virtual QCString latexDocumentPre()
83 return "\\begin{CJK}{UTF8}{min}\n";
85 virtual QCString latexDocumentPost()
87 return "\\end{CJK}\n";
90 // --- Language translation methods -------------------
92 /*! used in the compound documentation before a list of related functions. */
93 virtual QCString trRelatedFunctions()
96 /*! subscript for the related functions. */
97 virtual QCString trRelatedSubscript()
98 { return "(註:這些不是成員函式)"; }
100 /*! header that is put before the detailed description of files, classes and namespaces. */
101 virtual QCString trDetailedDescription()
104 /*! header that is put before the list of typedefs. */
105 virtual QCString trMemberTypedefDocumentation()
106 { return "型態定義成員說明文件"; }
108 /*! header that is put before the list of enumerations. */
109 virtual QCString trMemberEnumerationDocumentation()
110 { return "列舉型態成員說明文件"; }
112 /*! header that is put before the list of member functions. */
113 virtual QCString trMemberFunctionDocumentation()
114 { return "函式成員說明文件"; }
116 /*! header that is put before the list of member attributes. */
117 virtual QCString trMemberDataDocumentation()
119 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
129 /*! this is the text of a link put after brief descriptions. */
130 virtual QCString trMore()
133 /*! put in the class documentation */
134 virtual QCString trListOfAllMembers()
137 /*! used as the title of the "list of all members" page of a class */
138 virtual QCString trMemberList()
141 /*! this is the first part of a sentence that is followed by a class name */
142 virtual QCString trThisIsTheListOfAllMembers()
143 { return "完整成員列表,類別為"; }
145 /*! this is the remainder of the sentence after the class name */
146 virtual QCString trIncludingInheritedMembers()
147 { return ", 包含所有繼承的成員"; }
149 /*! this is put at the author sections at the bottom of man pages.
150 * parameter s is name of the project name.
152 virtual QCString trGeneratedAutomatically(const char *s)
153 { QCString result="本文件由Doxygen";
154 if (s) result+=(QCString)" 自 "+s;
155 result+=" 的原始碼中自動產生.";
159 /*! put after an enum name in the list of all members */
160 virtual QCString trEnumName()
163 /*! put after an enum value in the list of all members */
164 virtual QCString trEnumValue()
167 /*! put after an undocumented member in the list of all members */
168 virtual QCString trDefinedIn()
171 // quick reference sections
173 /*! This is put above each page as a link to the list of all groups of
174 * compounds or files (see the \\group command).
176 virtual QCString trModules()
179 /*! This is put above each page as a link to the class hierarchy */
180 virtual QCString trClassHierarchy()
183 /*! This is put above each page as a link to the list of annotated classes */
184 virtual QCString trCompoundList()
186 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
196 /*! This is put above each page as a link to the list of documented files */
197 virtual QCString trFileList()
200 /*! This is put above each page as a link to all members of compounds. */
201 virtual QCString trCompoundMembers()
203 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
213 /*! This is put above each page as a link to all members of files. */
214 virtual QCString trFileMembers()
216 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
226 /*! This is put above each page as a link to all related pages. */
227 virtual QCString trRelatedPages()
230 /*! This is put above each page as a link to all examples. */
231 virtual QCString trExamples()
234 /*! This is put above each page as a link to the search engine. */
235 virtual QCString trSearch()
238 /*! This is an introduction to the class hierarchy. */
239 virtual QCString trClassHierarchyDescription()
240 { return "這個繼承列表經過簡略的字母排序: ";
243 /*! This is an introduction to the list with all files. */
244 virtual QCString trFileListDescription(bool extractAll)
246 QCString result="這是附帶簡略說明";
247 if (!extractAll) result+="且經過文件化";
252 /*! This is an introduction to the annotated compound list. */
253 virtual QCString trCompoundListDescription()
256 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
258 return "這是附帶簡略說明的資料結構:";
262 return "這是附帶簡略說明的類別,結構,"
263 "聯合型態(unions)及介面(interfaces):";
267 /*! This is an introduction to the page with all class members. */
268 virtual QCString trCompoundMembersDescription(bool extractAll)
270 QCString result="這是全部";
275 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
286 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
288 result+="每個欄位的結構/聯合型態說明文件:";
292 result+="每個成員的類別說明文件:";
297 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
299 result+="這些結構/聯合型態所屬:";
309 /*! This is an introduction to the page with all file members. */
310 virtual QCString trFileMembersDescription(bool extractAll)
312 QCString result="這是全部";
313 if (!extractAll) result+="文件化的";
315 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
317 result+="函式,變數,定義,列舉,及型態定義";
331 /*! This is an introduction to the page with the list of all examples */
332 virtual QCString trExamplesDescription()
333 { return "所有範例列表:"; }
335 /*! This is an introduction to the page with the list of related pages */
336 virtual QCString trRelatedPagesDescription()
337 { return "所有相關文件頁面列表:"; }
339 /*! This is an introduction to the page with the list of class/file groups */
340 virtual QCString trModulesDescription()
341 { return "所有模組列表:"; }
343 // index titles (the project name is prepended for these)
346 /*! This is used in HTML as the title of index.html. */
347 virtual QCString trDocumentation()
350 /*! This is used in LaTeX as the title of the chapter with the
351 * index of all groups.
353 virtual QCString trModuleIndex()
356 /*! This is used in LaTeX as the title of the chapter with the
359 virtual QCString trHierarchicalIndex()
362 /*! This is used in LaTeX as the title of the chapter with the
363 * annotated compound index.
365 virtual QCString trCompoundIndex()
367 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
377 /*! This is used in LaTeX as the title of the chapter with the
380 virtual QCString trFileIndex()
383 /*! This is used in LaTeX as the title of the chapter containing
384 * the documentation of all groups.
386 virtual QCString trModuleDocumentation()
389 /*! This is used in LaTeX as the title of the chapter containing
390 * the documentation of all classes, structs and unions.
392 virtual QCString trClassDocumentation()
394 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
404 /*! This is used in LaTeX as the title of the chapter containing
405 * the documentation of all files.
407 virtual QCString trFileDocumentation()
410 /*! This is used in LaTeX as the title of the chapter containing
411 * the documentation of all examples.
413 virtual QCString trExampleDocumentation()
416 /*! This is used in LaTeX as the title of the chapter containing
417 * the documentation of all related pages.
419 virtual QCString trPageDocumentation()
422 /*! This is used in LaTeX as the title of the document */
423 virtual QCString trReferenceManual()
426 /*! This is used in the documentation of a file as a header before the
429 virtual QCString trDefines()
432 /*! This is used in the documentation of a file as a header before the
435 virtual QCString trTypedefs()
438 /*! This is used in the documentation of a file as a header before the
439 * list of enumerations
441 virtual QCString trEnumerations()
444 /*! This is used in the documentation of a file as a header before the
445 * list of (global) functions
447 virtual QCString trFunctions()
450 /*! This is used in the documentation of a file as a header before the
451 * list of (global) variables
453 virtual QCString trVariables()
456 /*! This is used in the documentation of a file as a header before the
457 * list of (global) variables
459 virtual QCString trEnumerationValues()
462 /*! This is used in the documentation of a file before the list of
463 * documentation blocks for defines
465 virtual QCString trDefineDocumentation()
466 { return "定義巨集說明文件"; }
468 /*! This is used in the documentation of a file/namespace before the list
469 * of documentation blocks for typedefs
471 virtual QCString trTypedefDocumentation()
472 { return "型態定義說明文件"; }
474 /*! This is used in the documentation of a file/namespace before the list
475 * of documentation blocks for enumeration types
477 virtual QCString trEnumerationTypeDocumentation()
478 { return "列舉型態說明文件"; }
480 /*! This is used in the documentation of a file/namespace before the list
481 * of documentation blocks for enumeration values
483 virtual QCString trEnumerationValueDocumentation()
484 { return "列舉值說明文件"; }
486 /*! This is used in the documentation of a file/namespace before the list
487 * of documentation blocks for functions
489 virtual QCString trFunctionDocumentation()
492 /*! This is used in the documentation of a file/namespace before the list
493 * of documentation blocks for variables
495 virtual QCString trVariableDocumentation()
498 /*! This is used in the documentation of a file/namespace/group before
499 * the list of links to documented compounds
501 virtual QCString trCompounds()
503 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
513 /*! This is used in the standard footer of each page and indicates when
514 * the page was generated
516 virtual QCString trGeneratedAt(const char *date,const char *projName)
518 QCString result=(QCString)"產生日期:"+date;
519 if (projName) result+=(QCString)", 專案:"+projName;
520 result+=(QCString)", 產生器:";
524 /*! this text is put before a class diagram */
525 virtual QCString trClassDiagram(const char *clName)
527 return (QCString)"類別"+clName+"的繼承圖:";
530 /*! this text is generated when the \\internal command is used. */
531 virtual QCString trForInternalUseOnly()
532 { return "僅供內部使用."; }
534 /*! this text is generated when the \\warning command is used. */
535 virtual QCString trWarning()
538 /*! this text is generated when the \\version command is used. */
539 virtual QCString trVersion()
542 /*! this text is generated when the \\date command is used. */
543 virtual QCString trDate()
546 /*! this text is generated when the \\return command is used. */
547 virtual QCString trReturns()
550 /*! this text is generated when the \\sa command is used. */
551 virtual QCString trSeeAlso()
554 /*! this text is generated when the \\param command is used. */
555 virtual QCString trParameters()
558 /*! this text is generated when the \\exception command is used. */
559 virtual QCString trExceptions()
562 /*! this text is used in the title page of a LaTeX document. */
563 virtual QCString trGeneratedBy()
566 //////////////////////////////////////////////////////////////////////////
567 // new since 0.49-990307
568 //////////////////////////////////////////////////////////////////////////
570 /*! used as the title of page containing all the index of all namespaces. */
571 virtual QCString trNamespaceList()
572 { return "命名空間(name space)列表"; }
574 /*! used as an introduction to the namespace list */
575 virtual QCString trNamespaceListDescription(bool extractAll)
577 QCString result="這是所有附帶簡略說明的";
578 if (!extractAll) result+="文件化的";
579 result+="命名空間(namespaces):";
583 /*! used in the class documentation as a header before the list of all
586 virtual QCString trFriends()
587 { return "類別朋友(Friends)"; }
589 //////////////////////////////////////////////////////////////////////////
590 // new since 0.49-990405
591 //////////////////////////////////////////////////////////////////////////
593 /*! used in the class documentation as a header before the list of all
596 virtual QCString trRelatedFunctionDocumentation()
597 { return "類別朋友及相關函式說明文件"; }
599 //////////////////////////////////////////////////////////////////////////
600 // new since 0.49-990425
601 //////////////////////////////////////////////////////////////////////////
603 /*! used as the title of the HTML page of a class/struct/union */
604 virtual QCString trCompoundReference(const char *clName,
605 ClassDef::CompoundType compType,
608 QCString result=(QCString)clName+" ";
611 case ClassDef::Class: result+=" 類別"; break;
612 case ClassDef::Struct: result+=" 結構"; break;
613 case ClassDef::Union: result+=" 聯合"; break;
614 case ClassDef::Interface: result+=" 介面"; break;
615 case ClassDef::Protocol: result+=" 協定"; break;
616 case ClassDef::Category: result+=" 分類"; break;
617 case ClassDef::Exception: result+=" 例外"; break;
620 if (isTemplate) result+=" 樣版";
625 /*! used as the title of the HTML page of a file */
626 virtual QCString trFileReference(const char *fileName)
628 QCString result=fileName;
633 /*! used as the title of the HTML page of a namespace */
634 virtual QCString trNamespaceReference(const char *namespaceName)
636 QCString result=namespaceName;
637 result+=" 命名空間(Namespace)參考文件";
641 virtual QCString trPublicMembers()
642 { return "公開方法(Public Methods)"; }
643 virtual QCString trPublicSlots()
644 { return "公開插槽(Public Slots)"; }
645 virtual QCString trSignals()
646 { return "訊號(Signals)"; }
647 virtual QCString trStaticPublicMembers()
648 { return "靜態公開方法(Static Public Methods)"; }
649 virtual QCString trProtectedMembers()
650 { return "保護方法(Protected Methods)"; }
651 virtual QCString trProtectedSlots()
652 { return "保護插槽(Protected Slots)"; }
653 virtual QCString trStaticProtectedMembers()
654 { return "靜態保護方法(Static Protected Methods)"; }
655 virtual QCString trPrivateMembers()
656 { return "私有方法(Private Methods)"; }
657 virtual QCString trPrivateSlots()
658 { return "私有插槽(Private Slots)"; }
659 virtual QCString trStaticPrivateMembers()
660 { return "靜態私有方法(Static Private Methods)"; }
662 /*! this function is used to produce a comma-separated list of items.
663 * use generateMarker(i) to indicate where item i should be put.
665 virtual QCString trWriteList(int numEntries)
669 // the inherits list contain `numEntries' classes
670 for (i=0;i<numEntries;i++)
672 // use generateMarker to generate placeholders for the class links!
673 result+=generateMarker(i); // generate marker for entry i in the list
674 // (order is left to right)
676 if (i!=numEntries-1) // not the last entry, so we need a separator
678 if (i<numEntries-2) // not the fore last entry
680 else // the fore last entry
687 /*! used in class documentation to produce a list of base classes,
688 * if class diagrams are disabled.
690 virtual QCString trInheritsList(int numEntries)
692 return "繼承自 "+trWriteList(numEntries)+".";
695 /*! used in class documentation to produce a list of super classes,
696 * if class diagrams are disabled.
698 virtual QCString trInheritedByList(int numEntries)
700 return "被 "+trWriteList(numEntries)+"繼承.";
703 /*! used in member documentation blocks to produce a list of
704 * members that are hidden by this one.
706 virtual QCString trReimplementedFromList(int numEntries)
708 return "依據"+trWriteList(numEntries)+"重新實作.";
711 /*! used in member documentation blocks to produce a list of
712 * all member that overwrite the implementation of this member.
714 virtual QCString trReimplementedInList(int numEntries)
716 return "在"+trWriteList(numEntries)+"重新實作.";
719 /*! This is put above each page as a link to all members of namespaces. */
720 virtual QCString trNamespaceMembers()
721 { return "命名空間(Namespace)成員"; }
723 /*! This is an introduction to the page with all namespace members */
724 virtual QCString trNamespaceMemberDescription(bool extractAll)
726 QCString result="此處列表為所有 ";
727 if (!extractAll) result+="文件化的 ";
728 result+="命名空間(namespace)成員,並且附帶連結至 ";
730 result+="每個成員的說明文件:";
732 result+="該命名空間所屬之處:";
735 /*! This is used in LaTeX as the title of the chapter with the
736 * index of all namespaces.
738 virtual QCString trNamespaceIndex()
739 { return "命名空間(Namespace)索引"; }
741 /*! This is used in LaTeX as the title of the chapter containing
742 * the documentation of all namespaces.
744 virtual QCString trNamespaceDocumentation()
745 { return "命名空間(Namespace)說明文件"; }
747 //////////////////////////////////////////////////////////////////////////
748 // new since 0.49-990522
749 //////////////////////////////////////////////////////////////////////////
751 /*! This is used in the documentation before the list of all
752 * namespaces in a file.
754 virtual QCString trNamespaces()
755 { return "命名空間(Namespaces)"; }
757 //////////////////////////////////////////////////////////////////////////
758 // new since 0.49-990728
759 //////////////////////////////////////////////////////////////////////////
761 /*! This is put at the bottom of a class documentation page and is
762 * followed by a list of files that were used to generate the page.
764 virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,bool)
765 { // here s is one of " Class", " Struct" or " Union"
766 // single is true implies a single file
767 QCString result=(QCString)"此";
770 case ClassDef::Class: result+="類別(class)"; break;
771 case ClassDef::Struct: result+="結構(structure)"; break;
772 case ClassDef::Union: result+="聯合(union)"; break;
773 case ClassDef::Interface: result+="介面(interface)"; break;
774 case ClassDef::Protocol: result+="協定(protocol)"; break;
775 case ClassDef::Category: result+="分類(category)"; break;
776 case ClassDef::Exception: result+="例外(exception)"; break;
779 result+=" 文件是由下列檔案中產生";
784 //////////////////////////////////////////////////////////////////////////
785 // new since 0.49-990901
786 //////////////////////////////////////////////////////////////////////////
788 /*! This is used as the heading text for the retval command. */
789 virtual QCString trReturnValues()
792 /*! This is in the (quick) index as a link to the main page (index.html)
794 virtual QCString trMainPage()
797 /*! This is used in references to page that are put in the LaTeX
798 * documentation. It should be an abbreviation of the word page.
800 virtual QCString trPageAbbreviation()
803 //////////////////////////////////////////////////////////////////////////
804 // new since 0.49-991003
805 //////////////////////////////////////////////////////////////////////////
807 virtual QCString trDefinedAtLineInSourceFile()
809 return "定義在 @1 檔案之第 @0 行.";
811 virtual QCString trDefinedInSourceFile()
816 //////////////////////////////////////////////////////////////////////////
817 // new since 0.49-991205
818 //////////////////////////////////////////////////////////////////////////
820 virtual QCString trDeprecated()
825 //////////////////////////////////////////////////////////////////////////
827 //////////////////////////////////////////////////////////////////////////
829 /*! this text is put before a collaboration diagram */
830 virtual QCString trCollaborationDiagram(const char *clName)
832 return (QCString)""+clName+"的合作圖:";
834 /*! this text is put before an include dependency graph */
835 virtual QCString trInclDepGraph(const char *fName)
837 return (QCString)""+fName+"的包含相依圖:";
839 /*! header that is put before the list of constructor/destructors. */
840 virtual QCString trConstructorDocumentation()
842 return "建構子與解構子說明文件";
844 /*! Used in the file documentation to point to the corresponding sources. */
845 virtual QCString trGotoSourceCode()
849 /*! Used in the file sources to point to the corresponding documentation. */
850 virtual QCString trGotoDocumentation()
854 /*! Text for the \\pre command */
855 virtual QCString trPrecondition()
859 /*! Text for the \\post command */
860 virtual QCString trPostcondition()
864 /*! Text for the \\invariant command */
865 virtual QCString trInvariant()
869 /*! Text shown before a multi-line variable/enum initialization */
870 virtual QCString trInitialValue()
874 /*! Text used the source code in the file index */
875 virtual QCString trCode()
879 virtual QCString trGraphicalHierarchy()
883 virtual QCString trGotoGraphicalHierarchy()
887 virtual QCString trGotoTextualHierarchy()
891 virtual QCString trPageIndex()
896 //////////////////////////////////////////////////////////////////////////
898 //////////////////////////////////////////////////////////////////////////
900 virtual QCString trNote()
904 virtual QCString trPublicTypes()
908 virtual QCString trPublicAttribs()
910 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
919 virtual QCString trStaticPublicAttribs()
923 virtual QCString trProtectedTypes()
927 virtual QCString trProtectedAttribs()
931 virtual QCString trStaticProtectedAttribs()
935 virtual QCString trPrivateTypes()
939 virtual QCString trPrivateAttribs()
943 virtual QCString trStaticPrivateAttribs()
948 //////////////////////////////////////////////////////////////////////////
950 //////////////////////////////////////////////////////////////////////////
952 /*! Used as a marker that is put before a \\todo item */
953 virtual QCString trTodo()
957 /*! Used as the header of the todo list */
958 virtual QCString trTodoList()
963 //////////////////////////////////////////////////////////////////////////
965 //////////////////////////////////////////////////////////////////////////
967 virtual QCString trReferencedBy()
971 virtual QCString trRemarks()
975 virtual QCString trAttention()
979 virtual QCString trInclByDepGraph()
981 return "本圖顯示出哪些檔案直接或間接include本檔 "
984 virtual QCString trSince()
989 //////////////////////////////////////////////////////////////////////////
991 //////////////////////////////////////////////////////////////////////////
993 /*! title of the graph legend page */
994 virtual QCString trLegendTitle()
998 /*! page explaining how the dot graph's should be interpreted
999 * The %A in the text below are to prevent link to classes called "A".
1001 virtual QCString trLegendDocs()
1004 "本頁解釋如何解譯這些由doxygen所產生的圖示 "
1008 "/*! 因為截斷而造成的不可見類別 */\n"
1009 "class Invisible { };\n\n"
1010 "/*! 截斷的類別, 繼承關係被隱藏 */\n"
1011 "class Truncated : public Invisible { };\n\n"
1012 "/* 未經過doxygen註解處理過的類別 */\n"
1013 "class Undocumented { };\n\n"
1014 "/*! 經過公開(Public)繼承的類別 */\n"
1015 "class PublicBase : public Truncated { };\n\n"
1017 "template<class T> class Templ { };\n\n"
1018 "/*! 使用保護(Protected)繼承的類別 */\n"
1019 "class ProtectedBase { };\n\n"
1020 "/*! 使用私有(Private)繼承的類別 */\n"
1021 "class PrivateBase { };\n\n"
1022 "/*! 由被繼承類別所使用的類別 */\n"
1023 "class Used { };\n\n"
1024 "/*! 由數個其他類別所繼承來的超類別(Super Class) */\n"
1025 "class Inherited : public PublicBase,\n"
1026 " protected ProtectedBase,\n"
1027 " private PrivateBase,\n"
1028 " public Undocumented,\n"
1029 " public Templ<int>\n"
1032 " Used *m_usedClass;\n"
1036 "<p><center><img alt=\"\" src=\"graph_legend."+getDotImageExtension()+"\"></center></p>\n"
1041 "<li>%A 填滿黑色的區塊代表產生這個圖示的類別或結構 "
1043 "<li>%A 黑邊的區塊代表文件化過的結構或類別.</li>\n"
1044 "<li>%A 灰邊的區塊代表未經文件化的結構或是類別.</li>\n"
1045 "<li>%A 紅邊的區塊代表文件化的結構或是類別,"
1046 "這些結構或類別的繼承或包含關係不會全部顯示. %A 圖示 "
1047 "若無法塞入指定的邊界中將會被截斷.</li>\n"
1053 "<li>%A 深藍色箭頭用來代表兩個類別間的公開繼承 "
1055 "<li>%A 深綠色箭頭代表保護繼承。</li>\n"
1056 "<li>%A 深紅色箭頭代表私有繼承。</li>\n"
1057 "<li>%A 紫色箭頭用來表示類別被另一個包含或是使用."
1058 "箭頭上標示著可存取該類別或是結構的對應變數。</li>\n"
1059 "<li>%A 黃色箭頭代表樣版實體與樣版類別之間的關係。"
1060 "箭頭上標記著樣版實體上的參數。</li>\n"
1063 /*! text for the link to the legend page */
1064 virtual QCString trLegend()
1069 //////////////////////////////////////////////////////////////////////////
1071 //////////////////////////////////////////////////////////////////////////
1073 /*! Used as a marker that is put before a test item */
1074 virtual QCString trTest()
1078 /*! Used as the header of the test list */
1079 virtual QCString trTestList()
1084 //////////////////////////////////////////////////////////////////////////
1086 //////////////////////////////////////////////////////////////////////////
1088 /*! Used as a section header for IDL properties */
1089 virtual QCString trProperties()
1091 return "屬性(properties)";
1093 /*! Used as a section header for IDL property documentation */
1094 virtual QCString trPropertyDocumentation()
1096 return "屬性(property)說明文件";
1099 //////////////////////////////////////////////////////////////////////////
1101 //////////////////////////////////////////////////////////////////////////
1103 /*! Used for Java classes in the summary section of Java packages */
1104 virtual QCString trClasses()
1106 if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
1115 /*! Used as the title of a Java package */
1116 virtual QCString trPackage(const char *name)
1118 return (QCString)"Package "+name;
1120 /*! Title of the package index page */
1121 virtual QCString trPackageList()
1125 /*! The description of the package index page */
1126 virtual QCString trPackageListDescription()
1128 return "此處為Package的概略說明(如果有的話):";
1130 /*! The link name in the Quick links header for each page */
1131 virtual QCString trPackages()
1136 /*! Text shown before a multi-line define */
1137 virtual QCString trDefineValue()
1142 //////////////////////////////////////////////////////////////////////////
1144 //////////////////////////////////////////////////////////////////////////
1146 /*! Used as a marker that is put before a \\bug item */
1147 virtual QCString trBug()
1151 /*! Used as the header of the bug list */
1152 virtual QCString trBugList()
1157 //////////////////////////////////////////////////////////////////////////
1159 //////////////////////////////////////////////////////////////////////////
1161 /*! Used as ansicpg for RTF file
1163 * The following table shows the correlation of Charset name, Charset Value and
1166 * Charset Name Charset Value(hex) Codepage number
1167 * ------------------------------------------------------
1168 * DEFAULT_CHARSET 1 (x01)
1169 * SYMBOL_CHARSET 2 (x02)
1170 * OEM_CHARSET 255 (xFF)
1171 * ANSI_CHARSET 0 (x00) 1252
1172 * RUSSIAN_CHARSET 204 (xCC) 1251
1173 * EE_CHARSET 238 (xEE) 1250
1174 * GREEK_CHARSET 161 (xA1) 1253
1175 * TURKISH_CHARSET 162 (xA2) 1254
1176 * BALTIC_CHARSET 186 (xBA) 1257
1177 * HEBREW_CHARSET 177 (xB1) 1255
1178 * ARABIC _CHARSET 178 (xB2) 1256
1179 * SHIFTJIS_CHARSET 128 (x80) 932
1180 * HANGEUL_CHARSET 129 (x81) 949
1181 * GB2313_CHARSET 134 (x86) 936
1182 * CHINESEBIG5_CHARSET 136 (x88) 950
1186 virtual QCString trRTFansicp()
1192 /*! Used as ansicpg for RTF fcharset
1193 * \see trRTFansicp() for a table of possible values.
1195 virtual QCString trRTFCharSet()
1200 /*! Used as header RTF general index */
1201 virtual QCString trRTFGeneralIndex()
1206 /*! This is used for translation of the word that will possibly
1207 * be followed by a single name or by a list of names
1210 virtual QCString trClass(bool /*first_capital*/, bool /*singular*/)
1212 return QCString("類別");
1215 /*! This is used for translation of the word that will possibly
1216 * be followed by a single name or by a list of names
1219 virtual QCString trFile(bool /*first_capital*/, bool /*singular*/)
1221 return QCString("檔案");
1224 /*! This is used for translation of the word that will possibly
1225 * be followed by a single name or by a list of names
1228 virtual QCString trNamespace(bool /*first_capital*/, bool /*singular*/)
1230 return QCString("命名空間");
1233 /*! This is used for translation of the word that will possibly
1234 * be followed by a single name or by a list of names
1237 virtual QCString trGroup(bool /*first_capital*/, bool /*singular*/)
1239 return QCString("群組");
1242 /*! This is used for translation of the word that will possibly
1243 * be followed by a single name or by a list of names
1246 virtual QCString trPage(bool /*first_capital*/, bool /*singular*/)
1248 return QCString("頁面");
1251 /*! This is used for translation of the word that will possibly
1252 * be followed by a single name or by a list of names
1255 virtual QCString trMember(bool /*first_capital*/, bool /*singular*/)
1257 return QCString("成員");
1260 /*! This is used for translation of the word that will possibly
1261 * be followed by a single name or by a list of names
1264 virtual QCString trGlobal(bool /*first_capital*/, bool /*singular*/)
1266 return QCString("全域");
1269 //////////////////////////////////////////////////////////////////////////
1271 //////////////////////////////////////////////////////////////////////////
1273 /*! This text is generated when the \\author command is used and
1274 * for the author section in man pages. */
1275 virtual QCString trAuthor(bool /*first_capital*/, bool /*singular*/)
1277 return QCString("作者");
1280 //////////////////////////////////////////////////////////////////////////
1282 //////////////////////////////////////////////////////////////////////////
1284 /*! This text is put before the list of members referenced by a member
1286 virtual QCString trReferences()
1291 //////////////////////////////////////////////////////////////////////////
1293 //////////////////////////////////////////////////////////////////////////
1295 /*! used in member documentation blocks to produce a list of
1296 * members that are implemented by this one.
1298 virtual QCString trImplementedFromList(int numEntries)
1300 return "實作 "+trWriteList(numEntries)+".";
1303 /*! used in member documentation blocks to produce a list of
1304 * all members that implement this abstract member.
1306 virtual QCString trImplementedInList(int numEntries)
1308 return "實作於 "+trWriteList(numEntries)+".";
1311 //////////////////////////////////////////////////////////////////////////
1313 //////////////////////////////////////////////////////////////////////////
1315 /*! used in RTF documentation as a heading for the Table
1318 virtual QCString trRTFTableOfContents()
1323 //////////////////////////////////////////////////////////////////////////
1325 //////////////////////////////////////////////////////////////////////////
1327 /*! Used as the header of the list of item that have been
1328 * flagged deprecated
1330 virtual QCString trDeprecatedList()
1332 return "過時項目(Deprecated) 列表";
1335 //////////////////////////////////////////////////////////////////////////
1337 //////////////////////////////////////////////////////////////////////////
1339 /*! Used as a header for declaration section of the events found in
1342 virtual QCString trEvents()
1346 /*! Header used for the documentation section of a class' events. */
1347 virtual QCString trEventDocumentation()
1352 //////////////////////////////////////////////////////////////////////////
1354 //////////////////////////////////////////////////////////////////////////
1356 /*! Used as a heading for a list of Java class types with package scope.
1358 virtual QCString trPackageTypes()
1360 return "Package 型別";
1362 /*! Used as a heading for a list of Java class functions with package
1365 virtual QCString trPackageMembers()
1367 return "Package 函數列表";
1369 /*! Used as a heading for a list of static Java class functions with
1372 virtual QCString trStaticPackageMembers()
1374 return "靜態 Package 函數列表";
1376 /*! Used as a heading for a list of Java class variables with package
1379 virtual QCString trPackageAttribs()
1381 return "Package 屬性";
1383 /*! Used as a heading for a list of static Java class variables with
1386 virtual QCString trStaticPackageAttribs()
1388 return "靜態 Package 屬性";
1391 //////////////////////////////////////////////////////////////////////////
1393 //////////////////////////////////////////////////////////////////////////
1395 /*! Used in the quick index of a class/file/namespace member list page
1396 * to link to the unfiltered list of all members.
1398 virtual QCString trAll()
1402 /*! Put in front of the call graph for a function. */
1403 virtual QCString trCallGraph()
1405 return "這是此函數的引用函數圖:";
1408 //////////////////////////////////////////////////////////////////////////
1410 //////////////////////////////////////////////////////////////////////////
1412 /*! This string is used as the title for the page listing the search
1415 virtual QCString trSearchResultsTitle()
1419 /*! This string is put just before listing the search results. The
1420 * text can be different depending on the number of documents found.
1421 * Inside the text you can put the special marker $num to insert
1422 * the number representing the actual number of search results.
1423 * The @a numDocuments parameter can be either 0, 1 or 2, where the
1424 * value 2 represents 2 or more matches. HTML markup is allowed inside
1425 * the returned string.
1427 virtual QCString trSearchResults(int numDocuments)
1429 if (numDocuments==0)
1433 else if (numDocuments==1)
1435 return "找到 <b>1</b> 筆符合的資料.";
1439 return "找到 <b>$num</b> 筆符合的資料. "
1443 /*! This string is put before the list of matched words, for each search
1444 * result. What follows is the list of words that matched the query.
1446 virtual QCString trSearchMatches()
1451 //////////////////////////////////////////////////////////////////////////
1453 //////////////////////////////////////////////////////////////////////////
1455 /*! This is used in HTML as the title of page with source code for file filename
1457 virtual QCString trSourceFile(QCString& filename)
1459 return filename + " 原始程式檔";
1462 //////////////////////////////////////////////////////////////////////////
1464 //////////////////////////////////////////////////////////////////////////
1466 /*! This is used as the name of the chapter containing the directory
1469 virtual QCString trDirIndex()
1472 /*! This is used as the name of the chapter containing the documentation
1473 * of the directories.
1475 virtual QCString trDirDocumentation()
1476 { return "目錄說明文件"; }
1478 /*! This is used as the title of the directory index and also in the
1479 * Quick links of a HTML page, to link to the directory hierarchy.
1481 virtual QCString trDirectories()
1484 /*! This returns a sentences that introduces the directory hierarchy.
1485 * and the fact that it is sorted alphabetically per level
1487 virtual QCString trDirDescription()
1488 { return "這個目錄階層經過簡略的字母排序: ";
1491 /*! This returns the title of a directory page. The name of the
1492 * directory is passed via \a dirName.
1494 virtual QCString trDirReference(const char *dirName)
1495 { QCString result=dirName; result+=" 目錄參考文件"; return result; }
1497 /*! This returns the word directory with or without starting capital
1498 * (\a first_capital) and in sigular or plural form (\a singular).
1500 virtual QCString trDir(bool /*first_capital*/, bool /*singular*/)
1502 return QCString("目錄");
1505 //////////////////////////////////////////////////////////////////////////
1507 //////////////////////////////////////////////////////////////////////////
1509 /*! This text is added to the documentation when the \\overload command
1510 * is used for a overloaded function.
1512 virtual QCString trOverloadText()
1514 return "這是一個為了便利性所提供 overload 成員函數,"
1515 "只有在接受的參數上,與前一個函數不同.";
1517 //////////////////////////////////////////////////////////////////////////
1519 //////////////////////////////////////////////////////////////////////////
1521 /*! This is used to introduce a caller (or called-by) graph */
1522 virtual QCString trCallerGraph()
1524 return "呼叫此函數的函數列表:";
1528 //////////////////////////////////////////////////////////////////////////
1529 // new since 1.5.4 (mainly for Fortran)
1530 //////////////////////////////////////////////////////////////////////////
1532 /*! header that is put before the list of member subprograms (Fortran). */
1533 virtual QCString trMemberFunctionDocumentationFortran()
1534 { return "成員函數/子程序 文件"; }
1536 /*! This is put above each page as a link to the list of annotated data types (Fortran). */
1537 virtual QCString trCompoundListFortran()
1538 { return "資料型態列表"; }
1540 /*! This is put above each page as a link to all members of compounds (Fortran). */
1541 virtual QCString trCompoundMembersFortran()
1544 /*! This is an introduction to the annotated compound list (Fortran). */
1545 virtual QCString trCompoundListDescriptionFortran()
1546 { return "資料型態簡短說明列表:"; }
1548 /*! This is an introduction to the page with all data types (Fortran). */
1549 virtual QCString trCompoundMembersDescriptionFortran(bool extractAll)
1551 QCString result="此處列出所有";
1560 result+="每個成員函數的資料結構文件";
1564 result+="他們屬於的資料型別";
1569 /*! This is used in LaTeX as the title of the chapter with the
1570 * annotated compound index (Fortran).
1572 virtual QCString trCompoundIndexFortran()
1573 { return "資料型別索引"; }
1575 /*! This is used in LaTeX as the title of the chapter containing
1576 * the documentation of all data types (Fortran).
1578 virtual QCString trTypeDocumentation()
1579 { return "資料型別文件"; }
1581 /*! This is used in the documentation of a file as a header before the
1582 * list of (global) subprograms (Fortran).
1584 virtual QCString trSubprograms()
1585 { return "函數/子程序"; }
1587 /*! This is used in the documentation of a file/namespace before the list
1588 * of documentation blocks for subprograms (Fortran)
1590 virtual QCString trSubprogramDocumentation()
1591 { return "函數/子程序 文件"; }
1593 /*! This is used in the documentation of a file/namespace/group before
1594 * the list of links to documented compounds (Fortran)
1596 virtual QCString trDataTypes()
1599 /*! used as the title of page containing all the index of all modules (Fortran). */
1600 virtual QCString trModulesList()
1603 /*! used as an introduction to the modules list (Fortran) */
1604 virtual QCString trModulesListDescription(bool extractAll)
1606 QCString result="此處列出所有";
1607 if (!extractAll) result+="有文件的";
1608 result+="模組附帶簡短說明:";
1612 /*! used as the title of the HTML page of a module/type (Fortran) */
1613 virtual QCString trCompoundReferenceFortran(const char *clName,
1614 ClassDef::CompoundType compType,
1617 QCString result=(QCString)clName;
1620 case ClassDef::Class: result+="模組"; break;
1621 case ClassDef::Struct: result+="型態"; break;
1622 case ClassDef::Union: result+="聯合"; break;
1623 case ClassDef::Interface: result+="介面"; break;
1624 case ClassDef::Protocol: result+="協議"; break;
1625 case ClassDef::Category: result+="分類"; break;
1626 case ClassDef::Exception: result+="例外"; break;
1629 if (isTemplate) result+=" Template";
1633 /*! used as the title of the HTML page of a module (Fortran) */
1634 virtual QCString trModuleReference(const char *namespaceName)
1636 QCString result=namespaceName;
1641 /*! This is put above each page as a link to all members of modules. (Fortran) */
1642 virtual QCString trModulesMembers()
1645 /*! This is an introduction to the page with all modules members (Fortran) */
1646 virtual QCString trModulesMemberDescription(bool extractAll)
1648 QCString result="此處列出所有";
1649 if (!extractAll) result+="有文件的";
1650 result+="模組成員附帶連結到";
1653 result+="每個函數的模組文件:";
1662 /*! This is used in LaTeX as the title of the chapter with the
1663 * index of all modules (Fortran).
1665 virtual QCString trModulesIndex()
1668 /*! This is used for translation of the word that will possibly
1669 * be followed by a single name or by a list of names
1672 virtual QCString trModule(bool /* first_capital */, bool /* singular */)
1674 QCString result("模組");
1677 /*! This is put at the bottom of a module documentation page and is
1678 * followed by a list of files that were used to generate the page.
1680 virtual QCString trGeneratedFromFilesFortran(ClassDef::CompoundType compType,
1682 { // here s is one of " Module", " Struct" or " Union"
1683 // single is true implies a single file
1684 QCString result=(QCString)"這個";
1687 case ClassDef::Class: result+="模組"; break;
1688 case ClassDef::Struct: result+="型態"; break;
1689 case ClassDef::Union: result+="聯合"; break;
1690 case ClassDef::Interface: result+="介面"; break;
1691 case ClassDef::Protocol: result+="協議"; break;
1692 case ClassDef::Category: result+="分類"; break;
1693 case ClassDef::Exception: result+="例外"; break;
1696 result+="文件由下列檔案產生";
1699 /*! This is used for translation of the word that will possibly
1700 * be followed by a single name or by a list of names
1703 virtual QCString trType(bool /* first_capital */, bool /* singular */)
1705 QCString result("型別");
1708 /*! This is used for translation of the word that will possibly
1709 * be followed by a single name or by a list of names
1712 virtual QCString trSubprogram(bool /* first_capital */, bool /* singular */)
1714 QCString result("子程式");
1718 /*! C# Type Constraint list */
1719 virtual QCString trTypeConstraints()
1724 //////////////////////////////////////////////////////////////////////////
1725 // new since 1.6.0 (mainly for the new search engine)
1726 //////////////////////////////////////////////////////////////////////////
1728 /*! directory relation for \a name */
1729 virtual QCString trDirRelation(const char *name)
1731 return QCString(name)+" 關連";
1734 /*! Loading message shown when loading search results */
1735 virtual QCString trLoading()
1740 /*! Label used for search results in the global namespace */
1741 virtual QCString trGlobalNamespace()
1746 /*! Message shown while searching */
1747 virtual QCString trSearching()
1752 /*! Text shown when no search results are found */
1753 virtual QCString trNoMatches()
1758 //////////////////////////////////////////////////////////////////////////
1759 // new since 1.6.3 (missing items for the directory pages)
1760 //////////////////////////////////////////////////////////////////////////
1762 /*! when clicking a directory dependency label, a page with a
1763 * table is shown. The heading for the first column mentions the
1764 * source file that has a relation to another file.
1766 virtual QCString trFileIn(const char *name)
1768 return (QCString)"檔案在"+name;
1771 /*! when clicking a directory dependency label, a page with a
1772 * table is shown. The heading for the second column mentions the
1773 * destination file that is included.
1775 virtual QCString trIncludesFileIn(const char *name)
1777 return (QCString)"含入檔案在"+name;
1780 /** Compiles a date string.
1781 * @param year Year in 4 digits
1782 * @param month Month of the year: 1=January
1783 * @param day Day of the Month: 1..31
1784 * @param dayOfWeek Day of the week: 1=Monday..7=Sunday
1785 * @param hour Hour of the day: 0..23
1786 * @param minutes Minutes in the hour: 0..59
1787 * @param seconds Seconds within the minute: 0..59
1788 * @param includeTime Include time in the result string?
1790 virtual QCString trDateTime(int year,int month,int day,int dayOfWeek,
1791 int hour,int minutes,int seconds,
1794 static const char *days[] = { "星期一","星期二","星期三","星期四","星期五","星期六","星期日" };
1795 static const char *months[] = { "1","2","3","4","5","6","7","8","9","10","11","12" };
1797 sdate.sprintf("%d年%s月%d日 %s",year,months[month-1],day,days[dayOfWeek-1]);
1801 stime.sprintf(" %.2d:%.2d:%.2d",hour,minutes,seconds);
1807 //////////////////////////////////////////////////////////////////////////
1809 //////////////////////////////////////////////////////////////////////////
1811 /*! Header for the page with bibliographic citations */
1812 virtual QCString trCiteReferences()
1813 { return "參考文獻資料"; }
1815 /*! Text for copyright paragraph */
1816 virtual QCString trCopyright()
1819 /*! Header for the graph showing the directory dependencies */
1820 virtual QCString trDirDepGraph(const char *name)
1821 { return QCString(name)+"的目錄關連圖"+":"; }
1823 //////////////////////////////////////////////////////////////////////////
1825 //////////////////////////////////////////////////////////////////////////
1827 /*! Detail level selector shown for hierarchical indices */
1828 virtual QCString trDetailLevel()
1831 /*! Section header for list of template parameters */
1832 virtual QCString trTemplateParameters()
1835 /*! Used in dot graph when UML_LOOK is enabled and there are many fields */
1836 virtual QCString trAndMore(const QCString &number)
1837 { return "及 "+number+" 個更多..."; }
1839 /*! Used file list for a Java enum */
1840 virtual QCString trEnumGeneratedFromFiles(bool single)
1841 { QCString result = "此列舉型態的文件是由下列檔案所產生";
1842 if (!single) result += "";
1847 /*! Header of a Java enum page (Java enums are represented as classes). */
1848 virtual QCString trEnumReference(const char *name)
1849 { return QCString(name)+" 列舉型態參考"; }
1851 /*! Used for a section containing inherited members */
1852 virtual QCString trInheritedFrom(const char *members,const char *what)
1853 { return QCString(members)+" 繼承自 "+what; }
1855 /*! Header of the sections with inherited members specific for the
1858 virtual QCString trAdditionalInheritedMembers()
1859 { return "額外的繼承成員"; }
1861 //////////////////////////////////////////////////////////////////////////
1863 //////////////////////////////////////////////////////////////////////////
1865 /*! Used as a tooltip for the toggle button that appears in the
1866 * navigation tree in the HTML output when GENERATE_TREEVIEW is
1867 * enabled. This tooltip explains the meaning of the button.
1869 virtual QCString trPanelSynchronisationTooltip(bool enable)
1871 QCString opt = enable ? "啟用" : "停用";
1872 return "點擊 "+opt+" 面板進行同步";
1875 /*! Used in a method of an Objective-C class that is declared in a
1876 * a category. Note that the @1 marker is required and is replaced
1879 virtual QCString trProvidedByCategory()
1881 return "由 @0 分類所提供.";
1884 /*! Used in a method of an Objective-C category that extends a class.
1885 * Note that the @1 marker is required and is replaced by a link to
1888 virtual QCString trExtendsClass()
1890 return "延伸 @0 類別 .";
1893 /*! Used as the header of a list of class methods in Objective-C.
1894 * These are similar to static public member functions in C++.
1896 virtual QCString trClassMethods()
1901 /*! Used as the header of a list of instance methods in Objective-C.
1902 * These are similar to public member functions in C++.
1904 virtual QCString trInstanceMethods()
1909 /*! Used as the header of the member functions of an Objective-C class.
1911 virtual QCString trMethodDocumentation()
1916 /*! Used as the title of the design overview picture created for the
1919 virtual QCString trDesignOverview()
1924 //////////////////////////////////////////////////////////////////////////
1926 //////////////////////////////////////////////////////////////////////////
1928 /** old style UNO IDL services: implemented interfaces */
1929 virtual QCString trInterfaces()
1932 /** old style UNO IDL services: inherited services */
1933 virtual QCString trServices()
1936 /** UNO IDL constant groups */
1937 virtual QCString trConstantGroups()
1940 /** UNO IDL constant groups */
1941 virtual QCString trConstantGroupReference(const char *namespaceName)
1943 QCString result=namespaceName;
1947 /** UNO IDL service page title */
1948 virtual QCString trServiceReference(const char *sName)
1950 QCString result=(QCString)sName;
1954 /** UNO IDL singleton page title */
1955 virtual QCString trSingletonReference(const char *sName)
1957 QCString result=(QCString)sName;
1958 result+="Singleton參考";
1961 /** UNO IDL service page */
1962 virtual QCString trServiceGeneratedFromFiles(bool)
1964 // single is true implies a single file
1965 QCString result=(QCString)"本服務的文件由以下的檔案"
1970 /** UNO IDL singleton page */
1971 virtual QCString trSingletonGeneratedFromFiles(bool)
1973 // single is true implies a single file
1974 QCString result=(QCString)"本singleton的文件由下面的檔案"
1980 //////////////////////////////////////////////////////////////////////////