translator_fa.h

/******************************************************************************
 *
 *
 *
 * Copyright (C) 1997-2015 by Dimitri van Heesch.
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation under the terms of the GNU General Public License is hereby
 * granted. No representations are made about the suitability of this software
 * for any purpose. It is provided "as is" without express or implied warranty.
 * See the GNU General Public License for more details.
 *
 * Documents produced by Doxygen are derivative works derived from the
 * input used in their production; they are not affected by this license.
 *
 *
 * Description : Doxygen Persian (Farsi) Translator
 * Author : Ali Nadalizadeh < nadalizadeh at gmail dot com >
 *
 * ChangeLog :
 *   Thu 06 Jul 2006 11:54:09 PM IRDT <nadalizadeh at gmail dot com>
 *   >> First version of persian language support has been completed.
 *
 *   Mon 04 Feb 2008 11:52:09 AM IRDT <nadalizadeh at gmail dot com>
 *   >> Obsolete methods removed. Translated more string(s) to persian. Upgraded to 1_5_4 adapter.
 *
 *   Fri 04 Jun 2010 04:05:24 PM IRDT <nadalizadeh at gmail dot com>
 *   >> Implement missing new methods since 1.6.0.
 *   >> Add English to Persian digit convertor. (for date/time digits)
 *
 * Translation feedbacks are really appreciated.
 */

#ifndef TRANSLATOR_FA_H
#define TRANSLATOR_FA_H

#define HtmlRightToLeft     QCString("<div dir=\"rtl\">")
#define HtmlLeftToRight     QCString("<div dir=\"ltr\">")
#define HtmlDivEnd          QCString("</div>")


class TranslatorPersian : public TranslatorAdapter_1_7_5
{
  private:
    QCString convertDigitsToFarsi(QCString str)
    {
        QCString output;
        const char * PersianDigits[] = { "۰", "۱", "۲", "۳", "۴", "۵", "۶", "۷", "۸", "۹" };
        for(unsigned i=0; i<str.length(); i++)
        {
            if (str.at(i) >= '0' && str.at(i) <= '9')
                output += PersianDigits[ str.at(i) - '0' ];
            else
                output += str.at(i);
        }

        return output;
    }

  public:

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

    virtual QCString idLanguage()
    { return "persian"; }

    virtual QCString latexLanguageSupportCommand()
    {
      return "";
    }

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

    virtual QCString trRelatedFunctions()
    { return "توابع مربوط"; }

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

    virtual QCString trDetailedDescription()
    { return "توضيحات جزئی"; }

    virtual QCString trMemberTypedefDocumentation()
    { return "مستندات تعریف گونه ها"; }

    virtual QCString trMemberEnumerationDocumentation()
    { return "های عضو Enumeration مستندات"; }

    virtual QCString trMemberFunctionDocumentation()
    { return "توضيحات توابع عضو"; }

    virtual QCString trMemberDataDocumentation()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "Field مستندات";
      }
      else
      {
        return "مستندات متغيير های عضو";
      }
    }

    virtual QCString trMore()
    { return "بيشتر..."; }

    virtual QCString trListOfAllMembers()
    { return "ليست تمام اعضاء "; }

    virtual QCString trMemberList()
    { return "ليست اعضاء"; }

    virtual QCString trThisIsTheListOfAllMembers()
    { return "اين ليستی کامل از همه اعضای  "; }

    virtual QCString trIncludingInheritedMembers()
    { return "شامل همه ی اعضای به ارث برده شده می باشد."; }

    virtual QCString trGeneratedAutomatically(const char *s)
    { QCString result="تولید شده توسط نرم افزار دی اکسیژن ";
      if (s) result+=(QCString)" برای "+s;
      result+=" از کد برنامه ";
      return result;
    }

    virtual QCString trEnumName()
    { return "enum نام"; }

    virtual QCString trEnumValue()
    { return "enum مقدار"; }

    virtual QCString trDefinedIn()
    { return "تعریف شده در"; }

    // quick reference sections

    virtual QCString trModules()
    { return "Modules"; }

    virtual QCString trClassHierarchy()
    { return "سلسله مراتب کلاس ها"; }

    virtual QCString trCompoundList()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "ساختار های داده ";
      }
      else
      {
        return "ليست کلاس ها ";
      }
    }

    virtual QCString trFileList()
    { return "ليست فايل ها"; }

    virtual QCString trCompoundMembers()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "فضاهای داده ها";
      }
      else
      {
        return "اعضاء کلاس ها";
      }
    }

    virtual QCString trFileMembers()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "Globals";
      }
      else
      {
        return "اعضاء پرونده";
      }
    }

    virtual QCString trRelatedPages()
    { return "صفحات مربوط"; }

    virtual QCString trExamples()
    { return "مثال ها"; }

    virtual QCString trSearch()
    { return "جستجو"; }

    virtual QCString trClassHierarchyDescription()
    { return "ليست و سلسله مراتب درختی کلاس ها به صورت مرتب شده :";
    }

    virtual QCString trFileListDescription(bool extractAll)
    {
      QCString result="ليست همه ي پرونده های ";
      if (!extractAll) result+="(مستند شده) ";
      result+=" :";
      return result;
    }

    virtual QCString trCompoundListDescription()
    {

      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "ليست ساختارهای داده به همراه توضيحی کوتاه :";
      }
      else
      {
        return "ليست کلاس ها ، ساختارهای داده و ... به همراه توضيحات مختصر راجع به آنها :";
      }
    }

    virtual QCString trCompoundMembersDescription(bool extractAll)
    {
      QCString result=" در ذيل ليست  ";
      if (!extractAll)
      {
        result+="آن اعضايي که مستند شده اند ";
      }
      else
      {
        result+="همه ی اعضاء ";
      }
      result+=" به همراه ارتباطشان با ";
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        result+="ساختارهای داده ";
      }
      else
      {
        result+="كلاس ها ";
      }

      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
          result+="و مستندات ساختار داده برای هر عضو ";
      }
        else
      {
          result+="و مستندات کلاس برای هر عضو ";
      }
      result+="را مشاهده ميکنيد :";
      return result;
    }

    virtual QCString trFileMembersDescription(bool extractAll)
    {
      QCString result="ليست همه ی توابع ، متغيير ها، تعاريف و ... ";
      if (!extractAll) result+="(مستند شده) ";

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

    virtual QCString trExamplesDescription()
    { return "ليست همه ی مثال ها :"; }

    virtual QCString trRelatedPagesDescription()
    { return "لیست تمام صفحات و مستندات مربوطه :"; }

    virtual QCString trModulesDescription()
    { return "لیست تمام ماژول ها:"; }

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


    virtual QCString trDocumentation()
    { return "مستندات"; }

    virtual QCString trModuleIndex()
    { return "فهرست ماژول ها"; }

    virtual QCString trHierarchicalIndex()
    { return "فهرست سلسله مراتب"; }

    virtual QCString trCompoundIndex()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "فهرست ساختار داده ها";
      }
      else
      {
        return "فهرست کلاس های";
      }
    }

    virtual QCString trFileIndex()
    { return "فهرست پرونده ها"; }

    virtual QCString trModuleDocumentation()
    { return "مستندات ماژول"; }

    virtual QCString trClassDocumentation()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "مستندات ساختار داده ها";
      }
      else
      {
        return "مستندات کلاس ها";
      }
    }

    virtual QCString trFileDocumentation()
    { return "مستندات فایل"; }

    virtual QCString trExampleDocumentation()
    { return "مستندات مثال"; }

    virtual QCString trPageDocumentation()
    { return "مستندات صفحه"; }

    virtual QCString trReferenceManual()
    { return "راهنمای مرجع"; }

    virtual QCString trDefines()
    { return "تعاريف"; }

    virtual QCString trTypedefs()
    { return "تعریف گونه ها"; }

    virtual QCString trEnumerations()
    { return "تعاريف"; }

    virtual QCString trFunctions()
    { return "توابع"; }

    virtual QCString trVariables()
    { return "متغيير ها"; }

    virtual QCString trEnumerationValues()
    { return "معرف ها"; }

    virtual QCString trDefineDocumentation()
    { return "Define Documentation"; }

    virtual QCString trTypedefDocumentation()
    { return "Typedef"; }

    virtual QCString trEnumerationTypeDocumentation()
    { return "مستندات تعريف"; }

    virtual QCString trEnumerationValueDocumentation()
    { return "مستندات معرف"; }

    virtual QCString trFunctionDocumentation()
    { return "توضيح تابع"; }

    virtual QCString trVariableDocumentation()
    { return "توضيح متغير"; }

    virtual QCString trCompounds()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "ساختارهای داده";
      }
      else
      {
        return "کلاس ها";
      }
    }

    virtual QCString trGeneratedAt(const char *date,const char *projName)
    {
      QCString result = HtmlDivEnd + HtmlRightToLeft + QCString("توليد شده در ") +date ;
      if (projName) result+=(QCString)" برای "+projName;
      result+=(QCString)" توسط";
      return result;
    }

    virtual QCString trClassDiagram(const char *clName)
    {
      return (QCString)""+clName+" نمودار وراثت برای  :";
    }

    virtual QCString trForInternalUseOnly()
    { return ".فقط برای استعمال داخلی"; }

    virtual QCString trWarning()
    { return "اخطار"; }

    virtual QCString trVersion()
    { return "نسخه"; }

    virtual QCString trDate()
    { return "تاريخ"; }

    virtual QCString trReturns()
    { return "خروجی"; }

    virtual QCString trSeeAlso()
    { return "See also"; }

    virtual QCString trParameters()
    { return "پارامترها"; }

    virtual QCString trExceptions()
    { return "استثناء ها"; }

    virtual QCString trGeneratedBy()
    { return "توليد شده توسط"; }

// new since 0.49-990307

    virtual QCString trNamespaceList()
    { return "ليست فضاهای نام"; }

    virtual QCString trNamespaceListDescription(bool extractAll)
    {
      QCString result="در ذيل ليستی از همه ی فضاهای نام  ";
      if (!extractAll) result+="(مستند سازی شده) ";
      result+="به همراه توضيح کوتاه آنها مشاهده می کنيد :";
      return result;
    }

    virtual QCString trFriends()
    { return "کلاس های دوست"; }

// new since 0.49-990405

    virtual QCString trRelatedFunctionDocumentation()
    { return "مستندات توابع مربوط و دوست"; }

// new since 0.49-990425

    virtual QCString trCompoundReference(const char *clName,
                                    ClassDef::CompoundType compType,
                                    bool isTemplate)
    {
      QCString result;
      switch(compType)
      {
        case ClassDef::Class:      result=" کلاس"; break;
        case ClassDef::Struct:     result=" ساختار داده"; break;
        case ClassDef::Union:      result=" Union"; break;
        case ClassDef::Interface:  result=" Interface"; break;
        case ClassDef::Protocol:   result=" Protocol"; break;
        case ClassDef::Category:   result=" Category"; break;
        case ClassDef::Exception:  result=" استثناء"; break;
        default: break;
      }
      if (isTemplate) result+=" قالب";
      result=QCString(clName) + " مرجع" +result ;
      return result;
    }

    virtual QCString trFileReference(const char *fileName)
    {
      QCString result=fileName;
      result+=" مرجع پرونده";
      return result;
    }

    virtual QCString trNamespaceReference(const char *namespaceName)
    {
      QCString result=namespaceName;
      result+=" مرجع فضای نام";
      return result;
    }

    virtual QCString trPublicMembers()
    { return "توابع عمومی عضو کلاس"; }
    virtual QCString trPublicSlots()
    { return "های عمومی Slot"; }
    virtual QCString trSignals()
    { return "سيگنال ها"; }
    virtual QCString trStaticPublicMembers()
    { return "توابع ثابت عمومی عضو کلاس"; }
    virtual QCString trProtectedMembers()
    { return "توابع خصوصی عضو کلاس"; }
    virtual QCString trProtectedSlots()
    { return "های محافظت شده Slot"; }
    virtual QCString trStaticProtectedMembers()
    { return "توابع ثابت محافظت شده عضو کلاس"; }
    virtual QCString trPrivateMembers()
    { return "توابع خصوصی عضو کلاس"; }
    virtual QCString trPrivateSlots()
    { return "های خصوصی Slot"; }
    virtual QCString trStaticPrivateMembers()
    { return "توابع خصوصی ثابت عضو کلاس"; }

    virtual QCString trWriteList(int numEntries)
    {
      QCString result;
      int i;
      // the inherits list contain `numEntries' classes
      for (i=0;i<numEntries;i++)
      {
        // use generateMarker to generate placeholders for the class links!
        result+=generateMarker(i); // generate marker for entry i in the list
                                   // (order is left to right)

        if (i!=numEntries-1)  // not the last entry, so we need a separator
        {
          if (i<numEntries-2) // not the fore last entry
            result+=", ";
          else                // the fore last entry
            result+=" و ";
        }
      }
      return result;
    }

    virtual QCString trInheritsList(int numEntries)
    {
      return ".را به ارث می برد "+trWriteList(numEntries)+".";
    }

    virtual QCString trInheritedByList(int numEntries)
    {
      return ".اين کلاس را به ارث برده است "+trWriteList(numEntries)+".";
    }

    virtual QCString trReimplementedFromList(int numEntries)
    {
      return "Reimplemented from "+trWriteList(numEntries)+".";
    }

    virtual QCString trReimplementedInList(int numEntries)
    {
      return "تعریف شده است "+trWriteList(numEntries)+"دوباره در ";
    }

    virtual QCString trNamespaceMembers()
    { return "اعضای فضاهای نام"; }

    virtual QCString trNamespaceMemberDescription(bool extractAll)
    {
      QCString result="ليست همه اعضای فضای نام  ";
      if (!extractAll) result+="(مستند شده) ";
      result+=" با ارتباطشان با";
      result+="فضاهای نامی که به آن مربوط اند را مشاهده ميکنيد :";
      return result;
    }
    virtual QCString trNamespaceIndex()
    { return "فهرست فضاهای نام"; }

    virtual QCString trNamespaceDocumentation()
    { return "توضيحات فضای نام"; }

// new since 0.49-990522

    virtual QCString trNamespaces()
    { return "فضاهای نام"; }

// new since 0.49-990728

    virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,
        bool single)
    { // here s is one of " Class", " Struct" or " Union"
      // single is true implies a single file
      QCString result=(QCString)"مستندات اين  ";
      switch(compType)
      {
        case ClassDef::Class:      result+="کلاس"; break;
        case ClassDef::Struct:     result+="ساختار داده"; break;
        case ClassDef::Union:      result+="union"; break;
        case ClassDef::Interface:  result+="interface"; break;
        case ClassDef::Protocol:   result+="protocol"; break;
        case ClassDef::Category:   result+="category"; break;
        case ClassDef::Exception:  result+="exception"; break;
        default: break;
      }
      result+=" از روی پرونده ";
      if (single) result+=""; else result+="های ";
      result+="زير توليد شده است :";
      return result;
    }

// new since 0.49-990901

    virtual QCString trReturnValues()
    { return "مقادير بازگشتی"; }

    virtual QCString trMainPage()
    { return "صفحه ی اصلی"; }

    virtual QCString trPageAbbreviation()
    { return "ص."; }

// new since 0.49-991003
    virtual QCString trDefinedAtLineInSourceFile()
    {
      return ".در خط @0 از پرونده @1 تعريف شده است";
    }
    virtual QCString trDefinedInSourceFile()
    {
      return ".در فايل @0 تعريف شده است";
    }

// new since 0.49-991205

    virtual QCString trDeprecated()
    {
      return "منسوخ شده";
    }

// new since 1.0.0

    virtual QCString trCollaborationDiagram(const char *clName)
    {
      return (QCString)"Collaboration diagram for "+clName+":";
    }
    virtual QCString trInclDepGraph(const char *fName)
    {
      return (QCString)"نمودار شامل شدن ها برای "+fName+":";
    }
    virtual QCString trConstructorDocumentation()
    {
      return "مستندات توباع آغازین و پایانی";
    }
    virtual QCString trGotoSourceCode()
    {
      return "کد منبع اين پرونده.";
    }
    virtual QCString trGotoDocumentation()
    {
      return "توضيحات اين پرونده.";
    }
    virtual QCString trPrecondition()
    {
      return "پیش شرط";
    }
    virtual QCString trPostcondition()
    {
      return "پس شرط";
    }
    virtual QCString trInvariant()
    {
      return "Invariant";
    }
    virtual QCString trInitialValue()
    {
      return "مقدار اوليه :";
    }
    virtual QCString trCode()
    {
      return "کد";
    }
    virtual QCString trGraphicalHierarchy()
    {
      return "سلسله مراتب گرافيکی کلاس";
    }
    virtual QCString trGotoGraphicalHierarchy()
    {
      return "نمایش نمودار درختی گرافیکی کلاس";
    }
    virtual QCString trGotoTextualHierarchy()
    {
      return "نمایش نمودار درختی متنی کلاس";
    }
    virtual QCString trPageIndex()
    {
      return "فهرست صفحات";
    }

// new since 1.1.0

    virtual QCString trNote()
    {
      return "نکته";
    }
    virtual QCString trPublicTypes()
    {
      return "های عمومی Type";
    }
    virtual QCString trPublicAttribs()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "فضاهای داده ها";
      }
      else
      {
        return "خواص (متغييرهای) عمومی";
      }
    }
    virtual QCString trStaticPublicAttribs()
    {
      return "خواص (متغييرهای) عمومی ثابت";
    }
    virtual QCString trProtectedTypes()
    {
      return "های حفاظت شده Type";
    }
    virtual QCString trProtectedAttribs()
    {
      return "خواص (متغييرهای) حفاظت شده";
    }
    virtual QCString trStaticProtectedAttribs()
    {
      return "خواص (متغييرهای) حفاظت شده ثابت";
    }
    virtual QCString trPrivateTypes()
    {
      return "های خصوصی Type";
    }
    virtual QCString trPrivateAttribs()
    {
      return "خواص (متغييرهای) خصوصی";
    }
    virtual QCString trStaticPrivateAttribs()
    {
      return "خواص (متغييرهای) خصوصی ثابت";
    }

// new since 1.1.3

    virtual QCString trTodo()
    {
      return "برای انجام";
    }
    virtual QCString trTodoList()
    {
      return "ليست کارهاي آينده";
    }

// new since 1.1.4

    virtual QCString trReferencedBy()
    {
      return " استفاده شده توسط ";
    }
    virtual QCString trRemarks()
    {
      return "ملاحظات";
    }
    virtual QCString trAttention()
    {
      return "توجه";
    }
    virtual QCString trInclByDepGraph()
    {
      return "این نمودار فایل هایی را که این فایل را به طور مستقیم یا غیر مستقیم استفاده کرده اند نشان می دهد";
    }
    virtual QCString trSince()
    {
      return "از";
    }

// new since 1.1.5

    virtual QCString trLegendTitle()
    {
      return "راهنمای نمودار";
    }
    virtual QCString trLegendDocs()
    {
      return
        "This page explains how to interpret the graphs that are generated "
        "by doxygen.<p>\n"
        "Consider the following example:\n"
        "\\code\n"
        "/*! Invisible class because of truncation */\n"
        "class Invisible { };\n\n"
        "/*! Truncated class, inheritance relation is hidden */\n"
        "class Truncated : public Invisible { };\n\n"
        "/* Class not documented with doxygen comments */\n"
        "class Undocumented { };\n\n"
        "/*! Class that is inherited using public inheritance */\n"
        "class PublicBase : public Truncated { };\n\n"
        "/*! A template class */\n"
        "template<class T> class Templ { };\n\n"
        "/*! Class that is inherited using protected inheritance */\n"
        "class ProtectedBase { };\n\n"
        "/*! Class that is inherited using private inheritance */\n"
        "class PrivateBase { };\n\n"
        "/*! Class that is used by the Inherited class */\n"
        "class Used { };\n\n"
        "/*! Super class that inherits a number of other classes */\n"
        "class Inherited : public PublicBase,\n"
        "                  protected ProtectedBase,\n"
        "                  private PrivateBase,\n"
        "                  public Undocumented\n"
        "                  public Templ<int>\n"
        "{\n"
        "  private:\n"
        "    Used *m_usedClass;\n"
        "};\n"
        "\\endcode\n"
        "If the \\c MAX_DOT_GRAPH_HEIGHT tag in the configuration file "
        "is set to 240 this will result in the following graph:"
        "<p><center><img alt=\"\" src=\"graph_legend."+getDotImageExtension()+"\"></center>\n"
        "<p>\n"
        "The boxes in the above graph have the following meaning:\n"
        "<ul>\n"
        "<li>%A filled black box represents the struct or class for which the "
        "graph is generated.\n"
        "<li>%A box with a black border denotes a documented struct or class.\n"
        "<li>%A box with a gray border denotes an undocumented struct or class.\n"
        "<li>%A box with a red border denotes a documented struct or class for"
        "which not all inheritance/containment relations are shown. %A graph is "
        "truncated if it does not fit within the specified boundaries.\n"
        "</ul>\n"
        "The arrows have the following meaning:\n"
        "<ul>\n"
        "<li>%A dark blue arrow is used to visualize a public inheritance "
        "relation between two classes.\n"
        "<li>%A dark green arrow is used for protected inheritance.\n"
        "<li>%A dark red arrow is used for private inheritance.\n"
        "<li>%A purple dashed arrow is used if a class is contained or used "
        "by another class. The arrow is labeled with the variable(s) "
        "through which the pointed class or struct is accessible.\n"
        "<li>%A yellow dashed arrow denotes a relation between a template instance and "
        "the template class it was instantiated from. The arrow is labeled with "
        "the template parameters of the instance.\n"
        "</ul>\n";
    }
    virtual QCString trLegend()
    {
      return "راهنما";
    }

// new since 1.2.0

    virtual QCString trTest()
    {
      return "تست";
    }
    virtual QCString trTestList()
    {
      return "Test List";
    }

// new since 1.2.2

    virtual QCString trProperties()
    {
      return "خاصیت ها";
    }
    virtual QCString trPropertyDocumentation()
    {
      return "مستندات خاصیت";
    }

// new since 1.2.4

    virtual QCString trClasses()
    {
      if (Config_getBool(OPTIMIZE_OUTPUT_FOR_C))
      {
        return "ساختار های داده";
      }
      else
      {
        return "كلاس ها";
      }
    }
    virtual QCString trPackage(const char *name)
    {
      return (QCString)"Package "+name;
    }
    virtual QCString trPackageList()
    {
      return "لیست بسته ها";
    }
    virtual QCString trPackageListDescription()
    {
      return "لیست بسته ها به همراه توضیح مختر در صورت وجود :";
    }
    virtual QCString trPackages()
    {
      return "بسته ها";
    }
    virtual QCString trDefineValue()
    {
      return "مقدار:";
    }

// new since 1.2.5

    virtual QCString trBug()
    {
      return "اشکال";
    }
    virtual QCString trBugList()
    {
      return "ليست اشکالات";
    }

// new since 1.2.6

    virtual QCString trRTFansicp()
    {
      return "1256";
    }


    virtual QCString trRTFCharSet()
    {
      return "178";
    }

    virtual QCString trRTFGeneralIndex()
    {
      return "فهرست";
    }

    virtual QCString trClass(bool first_capital, bool singular)
    {
      QCString result((first_capital ? "کلاس" : "کلاس"));
      if (!singular)  result+="ها";
      return result;
    }

    virtual QCString trFile(bool /*first_capital*/, bool singular)
    {
      QCString result("پرونده");
      if (!singular) result=result+" ها";
      return result;
    }

    virtual QCString trNamespace(bool first_capital, bool singular)
    {
      QCString result((first_capital ? "فضای نام " : "فضای نام "));
      if (!singular)  result+="ها";
      return result;
    }

    virtual QCString trGroup(bool first_capital, bool singular)
    {
      QCString result((first_capital ? "Group" : "group"));
      if (!singular)  result+="s";
      return result;
    }

    virtual QCString trPage(bool first_capital, bool singular)
    {
      QCString result((first_capital ? "صفحه" : "صفحه"));
      if (!singular)  result+=" ها ";
      return result;
    }

    virtual QCString trMember(bool first_capital, bool singular)
    {
      QCString result((first_capital ? "عضو" : "عضو"));
      if (!singular)  result+="ها";
      return result;
    }

    virtual QCString trGlobal(bool first_capital, bool singular)
    {
      QCString result((first_capital ? "Global" : "global"));
      if (!singular)  result+="s";
      return result;
    }

// new since 1.2.7

    virtual QCString trAuthor(bool first_capital, bool singular)
    {
      QCString result((first_capital ? "Author" : "author"));
      if (!singular)  result+="s";
      return result;
    }

// new since 1.2.11

    virtual QCString trReferences()
    {
      return "را استفاده ميکند ";
    }

// new since 1.2.13

    virtual QCString trImplementedFromList(int numEntries)
    {
      return "را تکميل می کند "+trWriteList(numEntries)+".";
    }

    virtual QCString trImplementedInList(int numEntries)
    {
      return ".تکميل شده است "+trWriteList(numEntries)+" در";
    }

// new since 1.2.16

    virtual QCString trRTFTableOfContents()
    {
      return "فهرست";
    }

// new since 1.2.17

    virtual QCString trDeprecatedList()
    {
      return "لیست آیتم های از رده خارج";
    }

// new since 1.2.18

    virtual QCString trEvents()
    {
      return "رویداد ها";
    }
    virtual QCString trEventDocumentation()
    {
      return "مستندات رویداد";
    }

// new since 1.3

    virtual QCString trPackageTypes()
    {
      return "انواع بسته ها";
    }
    virtual QCString trPackageMembers()
    {
      return "توابع بسته ها";
    }
    virtual QCString trStaticPackageMembers()
    {
      return "Static Package Functions";
    }
    virtual QCString trPackageAttribs()
    {
      return "خواص بسته ها";
    }
    virtual QCString trStaticPackageAttribs()
    {
      return "Static Package Attributes";
    }

// new since 1.3.1

    virtual QCString trAll()
    {
      return "همه";
    }
    virtual QCString trCallGraph()
    {
      return "نمودار صدا زدن برای این تابع :";
    }

// new since 1.3.3

    virtual QCString trSearchResultsTitle()
    {
      return "نتايج جستجو";
    }
    virtual QCString trSearchResults(int numDocuments)
    {
      if (numDocuments==0)
      {
        return "متاسفانه هیچ صفحه ای برای جستجو ی شما یافت نشد.";
      }
      else if (numDocuments==1)
      {
        return "یک سند برای این مورد یافت شد.";
      }
      else
      {
        return "Found <b>$num</b> documents matching your query. "
               "Showing best matches first.";
      }
    }
    virtual QCString trSearchMatches()
    {
      return "Matches:";
    }

// new since 1.3.8

    virtual QCString trSourceFile(QCString& filename)
    {
      return filename + " کد و پرونده منبع";
    }

// new since 1.3.9

    virtual QCString trDirIndex()
    { return "ساختار و سلسله مراتب شاخه ها"; }

    virtual QCString trDirDocumentation()
    { return "مستندات دايرکتوری"; }

    virtual QCString trDirectories()
    { return "شاخه ها"; }

    virtual QCString trDirDescription()
    { return "در ذيل ساختار شاخه ها و دايرکتوری ها را نسبتا مرتب شده می بينيد :";
    }

    virtual QCString trDirReference(const char *dirName)
    { QCString result=dirName; result+=" مرجع شاخه ی"; return result; }

    virtual QCString trDir(bool /*first_capital*/, bool singular)
    {
      QCString result("شاخه");
      if (singular) result+=" ها "+result;
      return result;
    }

// new since 1.4.1

    virtual QCString trOverloadText()
    {
       return "This is an overloaded member function, "
              "provided for convenience. It differs from the above "
              "function only in what argument(s) it accepts.";
    }

// new since 1.4.6

    virtual QCString trCallerGraph()
    {
      return "نمودار صدا زننده های این تابع:";
    }
// new since 1.5.4 (mainly for Fortran)

    virtual QCString trMemberFunctionDocumentationFortran()
    { return "مستندات توابع عضو"; }

    virtual QCString trCompoundListFortran()
    { return "لیست ساختار های داده"; }

    virtual QCString trCompoundMembersFortran()
    { return "فیلدهای اطلاعات"; }

    virtual QCString trCompoundListDescriptionFortran()
    { return "ساختارهای داده به همراه توضیح کوتاه :"; }

    virtual QCString trCompoundMembersDescriptionFortran(bool)
    {
      return "توضیحات اعضا ساختارها به همراه مستندات ساختار داده ی مربوطه";
    }

    virtual QCString trCompoundIndexFortran()
    { return "Data Type Index"; }

    virtual QCString trTypeDocumentation()
    { return "Data Type Documentation"; }

    virtual QCString trSubprograms()
    { return "توابع و زیربرنامه ها"; }

    virtual QCString trSubprogramDocumentation()
    { return "مستندات توابع و زیربرنامه ها"; }

     virtual QCString trDataTypes()
    { return "ساختار های داده"; }

    virtual QCString trModulesList()
    { return "لیست ماژول ها"; }

    virtual QCString trModulesListDescription(bool)
    {
      QCString result="لیست ماژول ها به همراه توضیحات کوتاه";
      return result;
    }

    virtual QCString trCompoundReferenceFortran(const char *clName,
                                    ClassDef::CompoundType compType,
                                    bool isTemplate)
    {
      QCString result=(QCString)clName;
      switch(compType)
      {
        case ClassDef::Class:      result+=" Module"; break;
        case ClassDef::Struct:     result+=" Type"; break;
        case ClassDef::Union:      result+=" Union"; break;
        case ClassDef::Interface:  result+=" Interface"; break;
        case ClassDef::Protocol:   result+=" Protocol"; break;
        case ClassDef::Category:   result+=" Category"; break;
        case ClassDef::Exception:  result+=" Exception"; break;
        default: break;
      }
      if (isTemplate) result+=" Template";
      result+=" Reference";
      return result;
    }
    virtual QCString trModuleReference(const char *namespaceName)
    {
      QCString result=namespaceName;
      result+=" Module Reference";
      return result;
    }

    virtual QCString trModulesMembers()
    { return "اعضاء ماژول"; }

    virtual QCString trModulesMemberDescription(bool)
    {
      QCString result="لیست اعضاء ماژول ها به همراه مستندات ماژول مربوطه";
      return result;
    }

    virtual QCString trModulesIndex()
    { return "Modules Index"; }

    virtual QCString trModule(bool, bool singular)
    {
      QCString result("ماژول");
      if (!singular)  result+=" ها";
      return result;
    }
    virtual QCString trGeneratedFromFilesFortran(ClassDef::CompoundType compType,
        bool single)
    { // here s is one of " Module", " Struct" or " Union"
      // single is true implies a single file
      QCString result=(QCString)"The documentation for this ";
      switch(compType)
      {
        case ClassDef::Class:      result+="module"; break;
        case ClassDef::Struct:     result+="type"; break;
        case ClassDef::Union:      result+="union"; break;
        case ClassDef::Interface:  result+="interface"; break;
        case ClassDef::Protocol:   result+="protocol"; break;
        case ClassDef::Category:   result+="category"; break;
        case ClassDef::Exception:  result+="exception"; break;
        default: break;
      }
      result+=" was generated from the following file";
      if (single) result+=":"; else result+="s:";
      return result;
    }
    virtual QCString trType(bool first_capital, bool singular)
    {
      QCString result((first_capital ? "Type" : "type"));
      if (!singular)  result+="s";
      return result;
    }
    virtual QCString trSubprogram(bool, bool singular)
    {
      QCString result("زیربرنامه");
      if (!singular)  result+=" ها ";
      return result;
    }

    virtual QCString trTypeConstraints()
    {
      return "Type Constraints";
    }

// new since 1.6.0 (mainly for the new search engine)

    virtual QCString trDirRelation(const char *name)
    {
      return QCString(name) + " Relation";
    }

    virtual QCString trLoading()
    {
      return "در حال بارگذاری...";
    }

    virtual QCString trGlobalNamespace()
    {
      return "فضای نام جهانی";
    }

    virtual QCString trSearching()
    {
      return "در حال جستجو...";
    }

    virtual QCString trNoMatches()
    {
      return "یافت نشد";
    }

// new since 1.6.3 (missing items for the directory pages)

    virtual QCString trFileIn(const char *name)
    {
      return (QCString)"پرونده ای در "+name;
    }

    virtual QCString trIncludesFileIn(const char *name)
    {
      return (QCString)"Includes file in "+name;
    }

    virtual QCString trDateTime(int year,int month,int day,int dayOfWeek,
                                int hour,int minutes,int seconds,
                                bool includeTime)
    {
      static const char *days[]   = { "دوشنبه","سه‌شنبه","چهارشنبه","پنجشنبه","جمعه","شنبه","یکشنبه" };
      static const char *months[] = { "ژانویه","فوریه","مارس","آوریل","می","جون","جولای","آگوست","سپتامبر","اکتبر","نوامبر","دسامبر" };
      QCString sdate;
      sdate.sprintf("%s %d %s %d",days[dayOfWeek-1],day,months[month-1],year);
      if (includeTime)
      {
        QCString stime;
        stime.sprintf(" %.2d:%.2d:%.2d",hour,minutes,seconds);
        sdate+=stime;
      }
      return convertDigitsToFarsi(sdate);
    }

};

#endif