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

     2  *

     3  * 

     4  *

     5  * Copyright (C) 1997-2007 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  *

    17  * Description : Doxygen Persian Translator

    18  * Author : Ali Nadalizadeh < nadalizadeh @ gmail dot com >

    19  * ChangeLog :

    20  *   Thu 06 Jul 2006 11:54:09 PM IRDT <nadalizadeh at gmail dot com>

    21  *   >> First version of persian language support has been completed.

    22  *   Mon Feb  4 11:52:09 IRST 2008 <nadalizadeh at gmail dot com>

    23  *   >> Obsolete methods removed. Translated more string(s) to persian. Upgraded to 1_5_4 adapter.

    24  *

    25  */

    26 

    27 #ifndef TRANSLATOR_FA_H

    28 #define TRANSLATOR_FA_H

    29 

    30 #define HtmlRightToLeft     QCString("<div dir=rtl>")

    31 #define HtmlLeftToRight     QCString("<div dir=rtl>")

    32 #define HtmlDivEnd          QCString("</div>")

    33 

    34 

    35 class TranslatorPersian : public TranslatorAdapter_1_6_0

    36 {

    37   public:

    38 

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

    40     

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

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

    43      * of the language in Persian using lower-case characters only

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

    45      * the identification used in language.cpp.

    46      */

    47     virtual QCString idLanguage()

    48     { return "persian"; }

    49     

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

    51      *  This method should return string with commands that switch

    52      *  LaTeX to the desired language.  For example 

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

    54      *  </pre>

    55      *  or

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

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

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

    59      *  </pre>

    60      * 

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

    62      * the empty string is returned in this implementation.

    63      */

    64     virtual QCString latexLanguageSupportCommand()

    65     {

    66       return "";

    67     }

    68 

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

    70     virtual QCString idLanguageCharset()

    71     {

    72       return "utf-8";

    73     }

    74 

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

    76 

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

    78     virtual QCString trRelatedFunctions()

    79     { return "توابع مربوط"; }

    80 

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

    82     virtual QCString trRelatedSubscript()

    83     { return "(لازم به ذکر است که اينها توابع عضو نيستند)"; }

    84 

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

    86     virtual QCString trDetailedDescription()

    87     { return "توضيحات جزئی"; }

    88 

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

    90     virtual QCString trMemberTypedefDocumentation()

    91     { return "های عضو Typedef مستندات"; }

    92     

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

    94     virtual QCString trMemberEnumerationDocumentation()

    95     { return "Member Enumeration Documentation"; }

    96     

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

    98     virtual QCString trMemberFunctionDocumentation()

    99     { return "توضيحات توابع عضو"; }

   100     

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

   102     virtual QCString trMemberDataDocumentation()

   103     { 

   104       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   105       {

   106         return "Field مستندات"; 

   107       }

   108       else

   109       {

   110         return "مستندات متغيير های عضو"; 

   111       }

   112     }

   113 

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

   115     virtual QCString trMore() 

   116     { return "بيشتر..."; }

   117 

   118     /*! put in the class documentation */

   119     virtual QCString trListOfAllMembers()

   120     { return "ليست تمام اعضاء ."; }

   121 

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

   123     virtual QCString trMemberList()

   124     { return "ليست اعضاء"; }

   125 

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

   127     virtual QCString trThisIsTheListOfAllMembers()

   128     { return "اين ليستی کامل از همه اعضای  "; }

   129 

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

   131     virtual QCString trIncludingInheritedMembers()

   132     { return "شامل همه ی اعضای به ارث برده شده می باشد."; }

   133     

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

   135      *  parameter s is name of the project name.

   136      */

   137     virtual QCString trGeneratedAutomatically(const char *s)

   138     { QCString result="تولید شده توسط نرم افزار دی اکسیژن ";

   139       if (s) result+=(QCString)" برای "+s;

   140       result+=" از کد برنامه "; 

   141       return result;

   142     }

   143 

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

   145     virtual QCString trEnumName()

   146     { return "enum نام"; }

   147     

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

   149     virtual QCString trEnumValue()

   150     { return "enum مقدار"; }

   151     

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

   153     virtual QCString trDefinedIn()

   154     { return "تعریف شده در"; }

   155 

   156     // quick reference sections

   157 

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

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

   160      */

   161     virtual QCString trModules()

   162     { return "Modules"; }

   163     

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

   165     virtual QCString trClassHierarchy()

   166     { return "سلسله مراتب کلاس ها"; }

   167     

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

   169     virtual QCString trCompoundList()

   170     { 

   171       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   172       {

   173         return "ساختار های داده ";

   174       }

   175       else

   176       {

   177         return "ليست کلاس ها "; 

   178       }

   179     }

   180     

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

   182     virtual QCString trFileList()

   183     { return "ليست فايل ها"; }

   184 

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

   186     virtual QCString trCompoundMembers()

   187     { 

   188       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   189       {

   190         return "فضاهای داده ها"; 

   191       }

   192       else

   193       {

   194         return "اعضاء کلاس ها"; 

   195       }

   196     }

   197 

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

   199     virtual QCString trFileMembers()

   200     { 

   201       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   202       {

   203         return "Globals"; 

   204       }

   205       else

   206       {

   207         return "اعضاء فايل"; 

   208       }

   209     }

   210 

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

   212     virtual QCString trRelatedPages()

   213     { return "صفحات مربوط"; }

   214 

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

   216     virtual QCString trExamples()

   217     { return "مثال ها"; }

   218 

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

   220     virtual QCString trSearch()

   221     { return "جستجو"; }

   222 

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

   224     virtual QCString trClassHierarchyDescription()

   225     { return "ليست و سلسله مراتب درختی کلاس ها به صورت مرتب شده :";

   226     }

   227 

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

   229     virtual QCString trFileListDescription(bool extractAll)

   230     {

   231       QCString result="ليست همه ي پرونده های ";

   232       if (!extractAll) result+="(مستند شده) ";

   233       result+=" :";

   234       return result;

   235     }

   236 

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

   238     virtual QCString trCompoundListDescription()

   239     { 

   240       

   241       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   242       {

   243         return "ليست ساختارهای داده به همراه توضيحی کوتاه :"; 

   244       }

   245       else

   246       {

   247         return "ليست کلاس ها ، ساختارهای داده و ... به همراه توضيحات مختصر راجع به آنها :";

   248       }

   249     }

   250 

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

   252     virtual QCString trCompoundMembersDescription(bool extractAll)

   253     {

   254       QCString result=" در ذيل ليست  ";

   255       if (!extractAll)

   256       {

   257         result+="آن اعضايي که مستند شده اند ";

   258       }

   259       else

   260       {

   261         result+="همه ی اعضاء ";

   262       }

   263       result+=" به همراه ارتباطشان با ";

   264       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   265       {

   266         result+="ساختارهای داده ";

   267       }

   268       else

   269       {

   270         result+="كلاس ها ";

   271       }

   272 

   273       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   274       {

   275           result+="و مستندات ساختار داده برای هر عضو ";

   276       }

   277         else

   278       {

   279           result+="و مستندات کلاس برای هر عضو ";

   280       }

   281       result+="را مشاهده ميکنيد :";

   282       return result;

   283     }

   284 

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

   286     virtual QCString trFileMembersDescription(bool extractAll)

   287     {

   288       QCString result="ليست همه ی توابع ، متغيير ها، تعاريف و ... ";

   289       if (!extractAll) result+="(مستند شده) ";

   290       

   291       result+=" به همراه ارتباط آنها ";

   292       result+="با پرونده هايی که به آن مربوط اند :";

   293       return result;

   294     }

   295 

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

   297     virtual QCString trExamplesDescription()

   298     { return "ليست همه ی مثال ها :"; }

   299 

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

   301     virtual QCString trRelatedPagesDescription()

   302     { return "لیست تمام صفحات و مستندات مربوطه :"; }

   303 

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

   305     virtual QCString trModulesDescription()

   306     { return "لیست تمام ماژول ها:"; }

   307 

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

   309 

   310 

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

   312     virtual QCString trDocumentation()

   313     { return "مستند سازی"; }

   314 

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

   316      * index of all groups.

   317      */

   318     virtual QCString trModuleIndex()

   319     { return "فهرست ماژول ها"; }

   320 

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

   322      * class hierarchy.

   323      */

   324     virtual QCString trHierarchicalIndex()

   325     { return "فهرست سلسله مراتب"; }

   326 

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

   328      * annotated compound index.

   329      */

   330     virtual QCString trCompoundIndex()

   331     {

   332       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   333       { 

   334         return "فهرست ساختار داده ها";

   335       }

   336       else

   337       {

   338         return "فهرست کلاس های"; 

   339       }

   340     }

   341 

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

   343      * list of all files.

   344      */

   345     virtual QCString trFileIndex() 

   346     { return "فهرست پرونده ها"; }

   347 

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

   349      *  the documentation of all groups.

   350      */

   351     virtual QCString trModuleDocumentation()

   352     { return "مستندات ماژول"; }

   353 

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

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

   356      */

   357     virtual QCString trClassDocumentation()

   358     { 

   359       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   360       {

   361         return "مستندات ساختار داده ها"; 

   362       }

   363       else

   364       {

   365         return "مستندات کلاس ها"; 

   366       }

   367     }

   368 

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

   370      *  the documentation of all files.

   371      */

   372     virtual QCString trFileDocumentation()

   373     { return "مستندات فایل"; }

   374 

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

   376      *  the documentation of all examples.

   377      */

   378     virtual QCString trExampleDocumentation()

   379     { return "مستندات مثال"; }

   380 

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

   382      *  the documentation of all related pages.

   383      */

   384     virtual QCString trPageDocumentation()

   385     { return "مستندات صفحه"; }

   386 

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

   388     virtual QCString trReferenceManual()

   389     { return "راهنمای مرجع"; }

   390     

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

   392      *  list of defines

   393      */

   394     virtual QCString trDefines()

   395     { return "تعاريف"; }

   396 

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

   398      *  list of function prototypes

   399      */

   400     virtual QCString trFuncProtos()

   401     { return "پیش تعریف های توابع"; }

   402 

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

   404      *  list of typedefs

   405      */

   406     virtual QCString trTypedefs()

   407     { return "Typedefs"; }

   408 

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

   410      *  list of enumerations

   411      */

   412     virtual QCString trEnumerations()

   413     { return "تعاريف"; }

   414 

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

   416      *  list of (global) functions

   417      */

   418     virtual QCString trFunctions()

   419     { return "توابع"; }

   420 

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

   422      *  list of (global) variables

   423      */

   424     virtual QCString trVariables()

   425     { return "متغيير ها"; }

   426 

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

   428      *  list of (global) variables

   429      */

   430     virtual QCString trEnumerationValues()

   431     { return "معرف ها"; }

   432     

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

   434      *  documentation blocks for defines

   435      */

   436     virtual QCString trDefineDocumentation()

   437     { return "Define Documentation"; }

   438 

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

   440      *  of documentation blocks for function prototypes

   441      */

   442     virtual QCString trFunctionPrototypeDocumentation()

   443     { return "مستندات تعاریف اولیه توابع"; }

   444 

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

   446      *  of documentation blocks for typedefs

   447      */

   448     virtual QCString trTypedefDocumentation()

   449     { return "Typedef Documentation"; }

   450 

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

   452      *  of documentation blocks for enumeration types

   453      */

   454     virtual QCString trEnumerationTypeDocumentation()

   455     { return "مستندات تعريف"; }

   456 

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

   458      *  of documentation blocks for enumeration values

   459      */

   460     virtual QCString trEnumerationValueDocumentation()

   461     { return "مستندات معرف"; }

   462 

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

   464      *  of documentation blocks for functions

   465      */

   466     virtual QCString trFunctionDocumentation()

   467     { return "توضيح تابع"; }

   468 

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

   470      *  of documentation blocks for variables

   471      */

   472     virtual QCString trVariableDocumentation()

   473     { return "توضيح متغير"; }

   474 

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

   476      *  the list of links to documented compounds

   477      */

   478     virtual QCString trCompounds()

   479     { 

   480       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   481       {

   482         return "ساختارهای داده"; 

   483       }

   484       else

   485       {

   486         return "کلاس ها"; 

   487       }

   488     }

   489 

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

   491      *  the page was generated 

   492      */

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

   494     { 

   495       QCString result = HtmlDivEnd + HtmlRightToLeft + QCString("توليد شده در ") +date ;

   496       if (projName) result+=(QCString)" برای "+projName;

   497       result+=(QCString)" توسط";

   498       return result;

   499     }

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

   501      */

   502     virtual QCString trWrittenBy()

   503     {

   504       return "نوشته شده توسط";

   505     }

   506 

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

   508     virtual QCString trClassDiagram(const char *clName)

   509     {

   510       return (QCString)""+clName+" نمودار وراثت برای  :";

   511     }

   512     

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

   514     virtual QCString trForInternalUseOnly()

   515     { return ".فقط برای استعمال داخلی"; }

   516 

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

   518     virtual QCString trWarning()

   519     { return "اخطار"; }

   520 

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

   522     virtual QCString trVersion()

   523     { return "نسخه"; }

   524 

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

   526     virtual QCString trDate()

   527     { return "تاريخ"; }

   528 

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

   530     virtual QCString trReturns()

   531     { return "خروجی"; }

   532 

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

   534     virtual QCString trSeeAlso()

   535     { return "See also"; }

   536 

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

   538     virtual QCString trParameters()

   539     { return "پارامترها"; }

   540 

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

   542     virtual QCString trExceptions()

   543     { return "استثناء ها"; }

   544     

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

   546     virtual QCString trGeneratedBy()

   547     { return "توليد شده توسط"; }

   548 

   549 //////////////////////////////////////////////////////////////////////////

   550 // new since 0.49-990307

   551 //////////////////////////////////////////////////////////////////////////

   552     

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

   554     virtual QCString trNamespaceList()

   555     { return "ليست فضاهای نام"; }

   556 

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

   558     virtual QCString trNamespaceListDescription(bool extractAll)

   559     {

   560       QCString result="در ذيل ليستی از همه ی فضاهای نام  ";

   561       if (!extractAll) result+="(مستند سازی شده) ";

   562       result+="به همراه توضيح کوتاه آنها مشاهده می کنيد :";

   563       return result;

   564     }

   565 

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

   567      *  friends of a class

   568      */

   569     virtual QCString trFriends()

   570     { return "کلاس های دوست"; }

   571     

   572 //////////////////////////////////////////////////////////////////////////

   573 // new since 0.49-990405

   574 //////////////////////////////////////////////////////////////////////////

   575     

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

   577      * related classes 

   578      */

   579     virtual QCString trRelatedFunctionDocumentation()

   580     { return "مستندات توابع مربوط و دوست"; }

   581     

   582 //////////////////////////////////////////////////////////////////////////

   583 // new since 0.49-990425

   584 //////////////////////////////////////////////////////////////////////////

   585 

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

   587     virtual QCString trCompoundReference(const char *clName,

   588                                     ClassDef::CompoundType compType,

   589                                     bool isTemplate)

   590     {

   591       QCString result;

   592       switch(compType)

   593       {

   594         case ClassDef::Class:      result=" کلاس"; break;

   595         case ClassDef::Struct:     result=" ساختار داده"; break;

   596         case ClassDef::Union:      result=" Union"; break;

   597         case ClassDef::Interface:  result=" Interface"; break;

   598         case ClassDef::Protocol:   result=" Protocol"; break;

   599         case ClassDef::Category:   result=" Category"; break;

   600         case ClassDef::Exception:  result=" استثناء"; break;

   601       }

   602       if (isTemplate) result+=" قالب";

   603       result=QCString(clName) + " مرجع" +result ;

   604       return result;

   605     }

   606 

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

   608     virtual QCString trFileReference(const char *fileName)

   609     {

   610       QCString result=fileName;

   611       result+=" مرجع پرونده"; 

   612       return result;

   613     }

   614 

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

   616     virtual QCString trNamespaceReference(const char *namespaceName)

   617     {

   618       QCString result=namespaceName;

   619       result+=" مرجع فضای نام";

   620       return result;

   621     }

   622     

   623     virtual QCString trPublicMembers()

   624     { return "توابع عمومی عضو کلاس"; }

   625     virtual QCString trPublicSlots()

   626     { return "های عمومی Slot"; }

   627     virtual QCString trSignals()

   628     { return "سيگنال ها"; }

   629     virtual QCString trStaticPublicMembers()

   630     { return "توابع ثابت عمومی عضو کلاس"; }

   631     virtual QCString trProtectedMembers()

   632     { return "توابع خصوصی عضو کلاس"; }

   633     virtual QCString trProtectedSlots()

   634     { return "های محافظت شده Slot"; }

   635     virtual QCString trStaticProtectedMembers()

   636     { return "توابع ثابت محافظت شده عضو کلاس"; }

   637     virtual QCString trPrivateMembers()

   638     { return "توابع خصوصی عضو کلاس"; }

   639     virtual QCString trPrivateSlots()

   640     { return "های خصوصی Slot"; }

   641     virtual QCString trStaticPrivateMembers()

   642     { return "توابع خصوصی ثابت عضو کلاس"; }

   643     

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

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

   646      */

   647     virtual QCString trWriteList(int numEntries)

   648     {

   649       QCString result;

   650       int i;

   651       // the inherits list contain `numEntries' classes

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

   653       {

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

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

   656                                    // (order is left to right)

   657         

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

   659         {

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

   661             result+=", ";

   662           else                // the fore last entry

   663             result+=" و ";

   664         }

   665       }

   666       return result; 

   667     }

   668     

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

   670      *  if class diagrams are disabled.

   671      */

   672     virtual QCString trInheritsList(int numEntries)

   673     {

   674       return ".را به ارث می برد "+trWriteList(numEntries)+".";

   675     }

   676 

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

   678      *  if class diagrams are disabled.

   679      */

   680     virtual QCString trInheritedByList(int numEntries)

   681     {

   682       return ".اين کلاس را به ارث برده است "+trWriteList(numEntries)+".";

   683     }

   684 

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

   686      *  members that are hidden by this one.

   687      */

   688     virtual QCString trReimplementedFromList(int numEntries)

   689     {

   690       return "Reimplemented from "+trWriteList(numEntries)+".";

   691     }

   692 

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

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

   695      */

   696     virtual QCString trReimplementedInList(int numEntries)

   697     {

   698       return "تعریف شده است "+trWriteList(numEntries)+"دوباره در ";

   699     }

   700 

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

   702     virtual QCString trNamespaceMembers()

   703     { return "اعضای فضاهای نام"; }

   704 

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

   706     virtual QCString trNamespaceMemberDescription(bool extractAll)

   707     { 

   708       QCString result="ليست همه اعضای فضای نام  ";

   709       if (!extractAll) result+="(مستند شده) ";

   710       result+=" با ارتباطشان با";

   711       result+="فضاهای نامی که به آن مربوط اند را مشاهده ميکنيد :";

   712       return result;

   713     }

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

   715      *  index of all namespaces.

   716      */

   717     virtual QCString trNamespaceIndex()

   718     { return "فهرست فضاهای نام"; }

   719 

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

   721      *  the documentation of all namespaces.

   722      */

   723     virtual QCString trNamespaceDocumentation()

   724     { return "توضيحات فضای نام"; }

   725 

   726 //////////////////////////////////////////////////////////////////////////

   727 // new since 0.49-990522

   728 //////////////////////////////////////////////////////////////////////////

   729 

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

   731      *  namespaces in a file.

   732      */

   733     virtual QCString trNamespaces()

   734     { return "فضاهای نام"; }

   735 

   736 //////////////////////////////////////////////////////////////////////////

   737 // new since 0.49-990728

   738 //////////////////////////////////////////////////////////////////////////

   739 

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

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

   742      */

   743     virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,

   744         bool single)

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

   746       // single is true implies a single file

   747       QCString result=(QCString)"مستندات اين  ";

   748       switch(compType)

   749       {

   750         case ClassDef::Class:      result+="کلاس"; break;

   751         case ClassDef::Struct:     result+="ساختار داده"; break;

   752         case ClassDef::Union:      result+="union"; break;

   753         case ClassDef::Interface:  result+="interface"; break;

   754         case ClassDef::Protocol:   result+="protocol"; break;

   755         case ClassDef::Category:   result+="category"; break;

   756         case ClassDef::Exception:  result+="exception"; break;

   757       }

   758       result+=" از روی پرونده ";

   759       if (single) result+=""; else result+="های ";

   760       result+="زير توليد شده است :";

   761       return result;

   762     }

   763 

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

   765      * list.

   766      */

   767     virtual QCString trAlphabeticalList()

   768     { return "ليست الفبايي"; }

   769 

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

   771 // new since 0.49-990901

   772 //////////////////////////////////////////////////////////////////////////

   773 

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

   775     virtual QCString trReturnValues()

   776     { return "مقادير بازگشتی"; }

   777 

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

   779      */

   780     virtual QCString trMainPage()

   781     { return "صفحه ی اصلی"; }

   782 

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

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

   785      */

   786     virtual QCString trPageAbbreviation()

   787     { return "ص."; }

   788 

   789 //////////////////////////////////////////////////////////////////////////

   790 // new since 0.49-991003

   791 //////////////////////////////////////////////////////////////////////////

   792     virtual QCString trDefinedAtLineInSourceFile()

   793     {

   794       return ".در خط @0 از پرونده @1 تعريف شده است";

   795     }

   796     virtual QCString trDefinedInSourceFile()

   797     {

   798       return ".در فايل @0 تعريف شده است";

   799     }

   800 

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

   802 // new since 0.49-991205

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

   804 

   805     virtual QCString trDeprecated()

   806     {

   807       return "منسوخ شده";

   808     }

   809 

   810 //////////////////////////////////////////////////////////////////////////

   811 // new since 1.0.0

   812 //////////////////////////////////////////////////////////////////////////

   813 

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

   815     virtual QCString trCollaborationDiagram(const char *clName)

   816     {

   817       return (QCString)"Collaboration diagram for "+clName+":";

   818     }

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

   820     virtual QCString trInclDepGraph(const char *fName)

   821     {

   822       return (QCString)"Include dependency graph for "+fName+":";

   823     }

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

   825     virtual QCString trConstructorDocumentation()

   826     {

   827       return "Constructor و Destructor مستندات"; 

   828     }

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

   830     virtual QCString trGotoSourceCode()

   831     {

   832       return "کد منبع اين پرونده.";

   833     }

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

   835     virtual QCString trGotoDocumentation()

   836     {

   837       return "توضيحات اين پرونده.";

   838     }

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

   840     virtual QCString trPrecondition()

   841     {

   842       return "پیش شرط";

   843     }

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

   845     virtual QCString trPostcondition()

   846     {

   847       return "پس شرط";

   848     }

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

   850     virtual QCString trInvariant()

   851     {

   852       return "Invariant";

   853     }

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

   855     virtual QCString trInitialValue()

   856     {

   857       return "مقدار اوليه :";

   858     }

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

   860     virtual QCString trCode()

   861     {

   862       return "کد";

   863     }

   864     virtual QCString trGraphicalHierarchy()

   865     {

   866       return "سلسله مراتب گرافيکی کلاس";

   867     }

   868     virtual QCString trGotoGraphicalHierarchy()

   869     {

   870       return "Go to the graphical class hierarchy";

   871     }

   872     virtual QCString trGotoTextualHierarchy()

   873     {

   874       return "Go to the textual class hierarchy";

   875     }

   876     virtual QCString trPageIndex()

   877     {

   878       return "فهرست صفحات";

   879     }

   880 

   881 //////////////////////////////////////////////////////////////////////////

   882 // new since 1.1.0

   883 //////////////////////////////////////////////////////////////////////////

   884     

   885     virtual QCString trNote()

   886     {

   887       return "نکته";

   888     }

   889     virtual QCString trPublicTypes()

   890     {

   891       return "های عمومی Type";

   892     }

   893     virtual QCString trPublicAttribs()

   894     {

   895       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   896       {

   897         return "فضاهای داده ها";

   898       }

   899       else

   900       {

   901         return "خواص (متغييرهای) عمومی";

   902       }

   903     }

   904     virtual QCString trStaticPublicAttribs()

   905     {

   906       return "خواص (متغييرهای) عمومی ثابت";

   907     }

   908     virtual QCString trProtectedTypes()

   909     {

   910       return "های حفاظت شده Type";

   911     }

   912     virtual QCString trProtectedAttribs()

   913     {

   914       return "خواص (متغييرهای) حفاظت شده";

   915     }

   916     virtual QCString trStaticProtectedAttribs()

   917     {

   918       return "خواص (متغييرهای) حفاظت شده ثابت";

   919     }

   920     virtual QCString trPrivateTypes()

   921     {

   922       return "های خصوصی Type";

   923     }

   924     virtual QCString trPrivateAttribs()

   925     {

   926       return "خواص (متغييرهای) خصوصی";

   927     }

   928     virtual QCString trStaticPrivateAttribs()

   929     {

   930       return "خواص (متغييرهای) خصوصی ثابت";

   931     }

   932 

   933 //////////////////////////////////////////////////////////////////////////

   934 // new since 1.1.3

   935 //////////////////////////////////////////////////////////////////////////

   936 

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

   938     virtual QCString trTodo()

   939     {

   940       return "برای انجام";

   941     }

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

   943     virtual QCString trTodoList()

   944     {

   945       return "ليست کارهاي آينده";

   946     }

   947 

   948 //////////////////////////////////////////////////////////////////////////

   949 // new since 1.1.4

   950 //////////////////////////////////////////////////////////////////////////

   951 

   952     virtual QCString trReferencedBy()

   953     {

   954       return " استفاده شده توسط ";

   955     }

   956     virtual QCString trRemarks()

   957     {

   958       return "Remarks";

   959     }

   960     virtual QCString trAttention()

   961     {

   962       return "توجه";

   963     }

   964     virtual QCString trInclByDepGraph()

   965     {

   966       return "این نمودار فایل هایی را که این فایل را به طور مستقیم یا غیر مستقیم استفاده کرده اند نشان می دهد";

   967     }

   968     virtual QCString trSince()

   969     {

   970       return "از";

   971     }

   972     

   973 //////////////////////////////////////////////////////////////////////////

   974 // new since 1.1.5

   975 //////////////////////////////////////////////////////////////////////////

   976 

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

   978     virtual QCString trLegendTitle()

   979     {

   980       return "راهنمای نمودار";

   981     }

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

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

   984      */

   985     virtual QCString trLegendDocs()

   986     {

   987       return 

   988         "This page explains how to interpret the graphs that are generated "

   989         "by doxygen.<p>\n"

   990         "Consider the following example:\n"

   991         "\\code\n"

   992         "/*! Invisible class because of truncation */\n"

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

   994         "/*! Truncated class, inheritance relation is hidden */\n"

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

   996         "/* Class not documented with doxygen comments */\n"

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

   998         "/*! Class that is inherited using public inheritance */\n"

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

  1000         "/*! A template class */\n"

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

  1002         "/*! Class that is inherited using protected inheritance */\n"

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

  1004         "/*! Class that is inherited using private inheritance */\n"

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

  1006         "/*! Class that is used by the Inherited class */\n"

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

  1008         "/*! Super class that inherits a number of other classes */\n"

  1009         "class Inherited : public PublicBase,\n"

  1010         "                  protected ProtectedBase,\n"

  1011         "                  private PrivateBase,\n"

  1012         "                  public Undocumented\n"

  1013         "                  public Templ<int>\n"

  1014         "{\n"

  1015         "  private:\n"

  1016         "    Used *m_usedClass;\n"

  1017         "};\n"

  1018         "\\endcode\n"

  1019         "If the \\c MAX_DOT_GRAPH_HEIGHT tag in the configuration file "

  1020         "is set to 240 this will result in the following graph:"

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

  1022         "<p>\n"

  1023         "The boxes in the above graph have the following meaning:\n"

  1024         "<ul>\n"

  1025         "<li>%A filled black box represents the struct or class for which the "

  1026         "graph is generated.\n"

  1027         "<li>%A box with a black border denotes a documented struct or class.\n"

  1028         "<li>%A box with a grey border denotes an undocumented struct or class.\n"

  1029         "<li>%A box with a red border denotes a documented struct or class for"

  1030         "which not all inheritance/containment relations are shown. %A graph is "

  1031         "truncated if it does not fit within the specified boundaries.\n"

  1032         "</ul>\n"

  1033         "The arrows have the following meaning:\n"

  1034         "<ul>\n"

  1035         "<li>%A dark blue arrow is used to visualize a public inheritance "

  1036         "relation between two classes.\n"

  1037         "<li>%A dark green arrow is used for protected inheritance.\n"

  1038         "<li>%A dark red arrow is used for private inheritance.\n"

  1039         "<li>%A purple dashed arrow is used if a class is contained or used "

  1040         "by another class. The arrow is labeled with the variable(s) "

  1041         "through which the pointed class or struct is accessible.\n"

  1042         "<li>%A yellow dashed arrow denotes a relation between a template instance and "

  1043         "the template class it was instantiated from. The arrow is labeled with "

  1044         "the template parameters of the instance.\n"

  1045         "</ul>\n";

  1046     }

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

  1048     virtual QCString trLegend()

  1049     {

  1050       return "راهنما";

  1051     }

  1052     

  1053 //////////////////////////////////////////////////////////////////////////

  1054 // new since 1.2.0

  1055 //////////////////////////////////////////////////////////////////////////

  1056     

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

  1058     virtual QCString trTest()

  1059     {

  1060       return "Test";

  1061     }

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

  1063     virtual QCString trTestList()

  1064     {

  1065       return "Test List";

  1066     }

  1067 

  1068 //////////////////////////////////////////////////////////////////////////

  1069 // new since 1.2.1

  1070 //////////////////////////////////////////////////////////////////////////

  1071 

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

  1073     virtual QCString trDCOPMethods()

  1074     {

  1075       return "DCOP توابع عضو";

  1076     }

  1077 

  1078 //////////////////////////////////////////////////////////////////////////

  1079 // new since 1.2.2

  1080 //////////////////////////////////////////////////////////////////////////

  1081 

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

  1083     virtual QCString trProperties()

  1084     {

  1085       return "خاصیت ها";

  1086     }

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

  1088     virtual QCString trPropertyDocumentation()

  1089     {

  1090       return "مستندات خاصیت";

  1091     }

  1092 

  1093 //////////////////////////////////////////////////////////////////////////

  1094 // new since 1.2.4

  1095 //////////////////////////////////////////////////////////////////////////

  1096 

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

  1098     virtual QCString trClasses()

  1099     {

  1100       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

  1101       {

  1102         return "ساختار های داده";

  1103       }

  1104       else

  1105       {

  1106         return "كلاس ها";

  1107       }

  1108     }

  1109     /*! Used as the title of a Java package */

  1110     virtual QCString trPackage(const char *name)

  1111     {

  1112       return (QCString)"Package "+name;

  1113     }

  1114     /*! Title of the package index page */

  1115     virtual QCString trPackageList()

  1116     {

  1117       return "لیست بسته ها";

  1118     }

  1119     /*! The description of the package index page */

  1120     virtual QCString trPackageListDescription()

  1121     {

  1122       return "Here are the packages with brief descriptions (if available):";

  1123     }

  1124     /*! The link name in the Quick links header for each page */

  1125     virtual QCString trPackages()

  1126     {

  1127       return "بسته ها";

  1128     }

  1129     /*! Text shown before a multi-line define */

  1130     virtual QCString trDefineValue()

  1131     {

  1132       return "Value:";

  1133     }

  1134