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

     2  *

     3  * 

     4  *

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

     6  *

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

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

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

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

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

    12  *

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

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

    15  */

    16 

    17 /*

    18  *

    19  * Nickolay Semyonov

    20  * Andrey V. Stolyarov released Feb 14, 2001

    21  * Alexandr V. Chelpanov <cav@cryptopro.ru> released Sep 25, 2004

    22  * Благодарности: Vitaly A. Repin <vitaly@radio.hop.stu.neva.ru>,

    23  *    Михаил Глушенков <bbman@mail.ru>

    24  */

    25 

    26 #ifndef TRANSLATOR_RU_H

    27 #define TRANSLATOR_RU_H

    28 

    29 class TranslatorRussian : public TranslatorAdapter_1_6_0

    30 {

    31   public:

    32     /*! Used for identification of the language. */

    33     virtual QCString idLanguage()

    34     { return "russian"; }

    35 

    36     /* Used to get the command(s) for the language support. */

    37     virtual QCString latexLanguageSupportCommand()

    38     {

    39         return "\\usepackage[T2A]{fontenc}\n\\usepackage[russian]{babel}\n"; 

    40     }

    41 

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

    43     virtual QCString idLanguageCharset()

    44     {

    45         return "utf-8"; 

    46     }

    47 

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

    49 

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

    51     virtual QCString trRelatedFunctions()

    52     { return "Относящиеся к классу функции"; }

    53 

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

    55     virtual QCString trRelatedSubscript()

    56     { return "(не члены класса)"; }

    57 

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

    59     virtual QCString trDetailedDescription()

    60     { return "Подробное описание"; }

    61 

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

    63     virtual QCString trMemberTypedefDocumentation()

    64     { return "Определения типов"; }

    65 

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

    67     virtual QCString trMemberEnumerationDocumentation()

    68     { return "Перечисления"; }

    69 

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

    71     virtual QCString trMemberFunctionDocumentation()

    72     { return "Методы"; }

    73 

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

    75     virtual QCString trMemberDataDocumentation()

    76     {

    77       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

    78       {

    79         return "Поля";

    80       }

    81       else

    82       {

    83         return "Данные класса";

    84       }

    85     }

    86 

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

    88     virtual QCString trMore()

    89     { return "Подробнее..."; }

    90 

    91     /*! put in the class documentation */

    92     /* Dosn't use when optimization for C is on. */

    93     virtual QCString trListOfAllMembers()

    94     {

    95       return "Полный список членов класса";

    96     }

    97 

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

    99     /* Dosn't use when optimization for C is on. */

   100     virtual QCString trMemberList()

   101     {

   102       return "Cписок членов класса";

   103     }

   104 

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

   106     /* Dosn't use when optimization for C is on. */

   107     virtual QCString trThisIsTheListOfAllMembers()

   108     { return "Полный список членов класса "; }

   109 

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

   111     /* Dosn't use when optimization for C is on. */

   112     virtual QCString trIncludingInheritedMembers()

   113     { return ", включая наследуемые из базового класса"; }

   114 

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

   116      *  parameter s is name of the project name.

   117      */

   118     virtual QCString trGeneratedAutomatically(const char *s)

   119     { QCString result="Автоматически создано Doxygen";

   120       if (s) result+=QCString(" для ")+s;

   121       result+=" из исходного текста."; 

   122       return result;

   123     }

   124 

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

   126     virtual QCString trEnumName()

   127     { return "перечисление"; }

   128 

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

   130     virtual QCString trEnumValue()

   131     { return "элементы перечисления"; }

   132 

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

   134     virtual QCString trDefinedIn()

   135     { return "определено в"; }

   136 

   137     // quick reference sections

   138 

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

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

   141      */

   142     virtual QCString trModules()

   143     { return "Группы"; }

   144 

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

   146     virtual QCString trClassHierarchy()

   147     { return "Иерархия классов"; }

   148 

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

   150     virtual QCString trCompoundList()

   151     {

   152       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   153       {

   154         return "Структуры данных";

   155       }

   156       else

   157       {

   158         return "Классы";

   159       }

   160     }

   161 

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

   163     virtual QCString trFileList()

   164     { return "Файлы"; }

   165 

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

   167     virtual QCString trCompoundMembers()

   168     {

   169       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   170       {

   171         return "Поля структур";

   172       }

   173       else

   174       {

   175         return "Члены классов";

   176       }

   177     }

   178 

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

   180     /*??*/

   181     virtual QCString trFileMembers()

   182     {

   183       return "Список членов всех файлов";

   184     }

   185 

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

   187     virtual QCString trRelatedPages()

   188     /* ?? Вариант перевода "См. также: " более удачный, но не в заголовке,

   189      как в данном случае. */

   190     { return "Описания"; }

   191 

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

   193     virtual QCString trExamples()

   194     { return "Примеры"; }

   195 

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

   197     virtual QCString trSearch()

   198     { return "Поиск"; }

   199 

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

   201     virtual QCString trClassHierarchyDescription()

   202     { return "Иерархия классов."; }

   203 

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

   205     virtual QCString trFileListDescription(bool extractAll)

   206     {

   207       QCString result="Полный список ";

   208       if (!extractAll) result+="документированных ";

   209       result+="файлов.";

   210       return result;

   211     }

   212 

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

   214     virtual QCString trCompoundListDescription()

   215     {

   216       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   217       {

   218         return "Структуры данных с их кратким описанием.";

   219       }

   220       else

   221       {

   222         return "Классы с их кратким описанием.";

   223       }

   224     }

   225 

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

   227     virtual QCString trCompoundMembersDescription(bool extractAll)

   228     {

   229         QCString result="Список всех ";

   230         if(!extractAll) result+="документированных ";

   231         if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   232           result+="членов структур данных со ссылками на ";

   233         else

   234           result+="членов классов со ссылками на ";

   235         if(!extractAll)

   236         {

   237           if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   238             result+="документацию по структуре для каждого члена.";

   239           else

   240             result+="документацию по классу для каждого члена.";

   241         }

   242         else

   243         {

   244           if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   245             result += "структуры";

   246           else

   247             result += "классы";

   248           result+=", к которым они принадлежат.";

   249         }

   250         return result;

   251     }

   252 

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

   254     virtual QCString trFileMembersDescription(bool extractAll)

   255     {

   256       QCString result="Список всех ";

   257       if (!extractAll) result+="документированных ";

   258 

   259       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   260       {

   261         result+="функций, переменных, макроопределений, "

   262                 "перечислений и определений типов";

   263       }

   264       else

   265       {

   266         result+="членов файлов ";

   267       }

   268       result+=" со ссылками на ";

   269       if (extractAll)

   270         result+="файлы, к которым они принадлежат.";

   271       else

   272         result+="документацию.";

   273       return result;

   274     }

   275 

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

   277     virtual QCString trExamplesDescription()

   278     { return "Полный список примеров."; }

   279 

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

   281     virtual QCString trRelatedPagesDescription()

   282     { return "Полный список дополнительных описаний."; }

   283 

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

   285     virtual QCString trModulesDescription()

   286     { return "Полный список групп."; }

   287 

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

   289 

   290 

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

   292     virtual QCString trDocumentation()

   293     { return "Документация"; }

   294 

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

   296      * index of all groups.

   297      */

   298     virtual QCString trModuleIndex()

   299     { return "Алфавитный указатель групп"; }

   300 

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

   302      * class hierarchy.

   303      */

   304     virtual QCString trHierarchicalIndex()

   305     { return "Иерархический список классов"; }

   306 

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

   308      * annotated compound index.

   309      */

   310     virtual QCString trCompoundIndex()

   311     {

   312       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   313       {

   314         return "Алфавитный указатель структур данных";

   315       }

   316       else

   317       {

   318         return "Алфавитный указатель классов";

   319       }

   320     }

   321 

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

   323      * list of all files.

   324      */

   325     virtual QCString trFileIndex()

   326     { return "Список файлов"; }

   327 

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

   329      *  the documentation of all groups.

   330      */

   331     virtual QCString trModuleDocumentation()

   332     { return "Группы"; }

   333 

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

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

   336      */

   337     virtual QCString trClassDocumentation()

   338     {

   339       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   340       {

   341         return "Структуры данных";

   342       }

   343       else

   344       {

   345         return "Классы";

   346       }

   347     }

   348 

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

   350      *  the documentation of all files.

   351      */

   352     virtual QCString trFileDocumentation()

   353     { return "Файлы"; }

   354 

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

   356      *  the documentation of all examples.

   357      */

   358     virtual QCString trExampleDocumentation()

   359     { return "Примеры"; }

   360 

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

   362      *  the documentation of all related pages.

   363      */

   364     virtual QCString trPageDocumentation()

   365     { return "Тематические описания"; }

   366 

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

   368     virtual QCString trReferenceManual()

   369     { return "Оглавление"; }

   370 

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

   372      *  list of defines

   373      */

   374     virtual QCString trDefines()

   375     { return "Макросы"; }

   376 

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

   378      *  list of function prototypes

   379      */

   380     virtual QCString trFuncProtos()

   381     { return "Прототипы функций"; }

   382 

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

   384      *  list of typedefs

   385      */

   386     virtual QCString trTypedefs()

   387     { return "Определения типов"; }

   388 

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

   390      *  list of enumerations

   391      */

   392     virtual QCString trEnumerations()

   393     { return "Перечисления"; }

   394 

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

   396      *  list of (global) functions

   397      */

   398     virtual QCString trFunctions()

   399     { return "Функции"; }

   400 

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

   402      *  list of (global) variables

   403      */

   404     virtual QCString trVariables()

   405     { return "Переменные"; }

   406 

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

   408      *  list of (global) variables

   409      */

   410     virtual QCString trEnumerationValues()

   411     { return "Элементы перечислений"; }

   412 

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

   414      *  documentation blocks for defines

   415      */

   416     virtual QCString trDefineDocumentation()

   417     { return "Макросы"; }

   418 

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

   420      *  of documentation blocks for function prototypes

   421      */

   422     virtual QCString trFunctionPrototypeDocumentation()

   423     { return "Прототипы функций"; }

   424 

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

   426      *  of documentation blocks for typedefs

   427      */

   428     virtual QCString trTypedefDocumentation()

   429     { return "Типы"; }

   430 

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

   432      *  of documentation blocks for enumeration types

   433      */

   434     virtual QCString trEnumerationTypeDocumentation()

   435     { return "Перечисления"; }

   436 

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

   438      *  of documentation blocks for functions

   439      */

   440     virtual QCString trFunctionDocumentation()

   441     { return "Функции"; }

   442 

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

   444      *  of documentation blocks for variables

   445      */

   446     virtual QCString trVariableDocumentation()

   447     { return "Переменные"; }

   448 

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

   450      *  the list of links to documented compounds

   451      */

   452     virtual QCString trCompounds()

   453     {

   454       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   455       {

   456         return "Структуры данных";

   457       }

   458       else

   459       { 

   460         return "Классы";

   461       }

   462 

   463     }

   464 

   465     /*! This is used in the documentation of a group before the list of 

   466      *  links to documented files

   467      */

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

   469      *  the page was generated 

   470      */

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

   472     { 

   473       QCString result="Документация ";

   474       if (projName) result+=QCString("по ")+projName;

   475       result+=QCString(". Последние изменения: ")+date;

   476       result+=". Создано системой";

   477       return result;

   478     }

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

   480      */

   481     virtual QCString trWrittenBy()

   482     {

   483       return "Автор:";

   484     }

   485 

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

   487     virtual QCString trClassDiagram(const char *clName)

   488     {

   489       return QCString("Граф наследования:")+clName+":";

   490     }

   491 

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

   493     virtual QCString trForInternalUseOnly()

   494     { return "Только для внутреннего использования"; }

   495 

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

   497     virtual QCString trWarning()

   498     { return "Предупреждения"; }

   499 

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

   501     virtual QCString trVersion()

   502     { return "Версия"; }

   503 

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

   505     virtual QCString trDate()

   506     { return "Дата"; }

   507 

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

   509     virtual QCString trReturns()

   510     { return "Возвращает"; }

   511 

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

   513     virtual QCString trSeeAlso()

   514     { return "См. также"; }

   515 

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

   517     virtual QCString trParameters()

   518     { return "Аргументы"; }

   519 

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

   521     virtual QCString trExceptions()

   522     { return "Исключения"; }

   523 

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

   525     virtual QCString trGeneratedBy()

   526     { return "Создано системой"; }

   527     

   528 //////////////////////////////////////////////////////////////////////////

   529 // new since 0.49-990307 

   530 //////////////////////////////////////////////////////////////////////////

   531     

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

   533     virtual QCString trNamespaceList()

   534     { return "Пространства имен"; }

   535 

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

   537     virtual QCString trNamespaceListDescription(bool extractAll)

   538     {

   539       QCString result="Полный список ";

   540       if (!extractAll) result+="документированных ";

   541       result+="пространств имен.";

   542       return result;

   543     }

   544 

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

   546      *  friends of a class

   547      */

   548     virtual QCString trFriends()

   549     { return "Друзья"; }

   550 

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

   552 // new since 0.49-990405

   553 //////////////////////////////////////////////////////////////////////////

   554     

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

   556      * related classes 

   557      */

   558     virtual QCString trRelatedFunctionDocumentation()

   559     { return "Документация по друзьям класса и функциям, отноносящимся"

   560         " к классу"; }

   561     

   562 //////////////////////////////////////////////////////////////////////////

   563 // new since 0.49-990425

   564 //////////////////////////////////////////////////////////////////////////

   565 

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

   567     virtual QCString trCompoundReference(const char *clName,

   568                                  ClassDef::CompoundType compType,

   569                                  bool isTemplate)

   570     {

   571       QCString result;

   572       if (isTemplate) 

   573       {

   574         result="Шаблон ";

   575         switch(compType)

   576         {

   577           case ClassDef::Class:  result+="класса"; break;

   578           case ClassDef::Struct: result+="структуры"; break;

   579           case ClassDef::Union:  result+="объединения"; break;

   580           case ClassDef::Interface:  result+="интерфейса"; break;

   581           case ClassDef::Protocol:   result+="протокола"; break;

   582           case ClassDef::Category:   result+="категории"; break;

   583           case ClassDef::Exception:  result+="исключения"; break;

   584         }

   585       }

   586       else

   587       {

   588         switch(compType)

   589         {

   590           case ClassDef::Class:  result+="Класс"; break;

   591           case ClassDef::Struct: result+="Структура"; break;

   592           case ClassDef::Union:  result+="Объединение"; break;

   593           case ClassDef::Interface:  result+="Интерфейс"; break;

   594           case ClassDef::Protocol:   result+="Протокол"; break;

   595           case ClassDef::Category:   result+="Категория"; break;

   596           case ClassDef::Exception:  result+="Исключение"; break;

   597         }

   598       }

   599       result+=" ";

   600       return result+clName;

   601     }

   602 

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

   604     virtual QCString trFileReference(const char *fileName)

   605     {

   606       return QCString("Файл ")+fileName;

   607     }

   608 

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

   610     virtual QCString trNamespaceReference(const char *namespaceName)

   611     {

   612       return QCString("Пространство имен ")+namespaceName;

   613     }

   614     

   615     virtual QCString trPublicMembers()

   616     { return "Открытые члены"; }

   617     virtual QCString trPublicSlots()

   618     { return "Открытые слоты"; }

   619     virtual QCString trSignals()

   620     { return "Сигналы"; }

   621     virtual QCString trStaticPublicMembers()

   622     { return "Открытые статические члены"; }

   623     virtual QCString trProtectedMembers()

   624     { return "Защищенные члены"; }

   625     virtual QCString trProtectedSlots()

   626     { return "Защищенные слоты"; }

   627     virtual QCString trStaticProtectedMembers()

   628     { return "Защищенные статические члены"; }

   629     virtual QCString trPrivateMembers()

   630     { return "Закрытые члены"; }

   631     virtual QCString trPrivateSlots()

   632     { return "Закрытые слоты"; }

   633     virtual QCString trStaticPrivateMembers()

   634     { return "Закрытые статические члены"; }

   635     

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

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

   638      */

   639     virtual QCString trWriteList(int numEntries)

   640     {

   641       QCString result;

   642       int i;

   643       // the inherits list contain `numEntries' classes

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

   645       {

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

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

   648                                    // (order is left to right)

   649         

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

   651         {

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

   653             result+=", ";

   654           else                // the fore last entry

   655             result+=" и ";

   656         }

   657       }

   658       return result; 

   659     }

   660     

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

   662      *  if class diagrams are disabled.

   663      */

   664     virtual QCString trInheritsList(int numEntries)

   665     {

   666       return "Базовые классы:"+trWriteList(numEntries)+".";

   667     }

   668 

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

   670      *  if class diagrams are disabled.

   671      */

   672     virtual QCString trInheritedByList(int numEntries)

   673     {

   674       return "Производные классы:"+trWriteList(numEntries)+".";

   675     }

   676 

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

   678      *  members that are hidden by this one.

   679      */

   680     virtual QCString trReimplementedFromList(int numEntries)

   681     {

   682       QCString result="Переопределяет метод";

   683       if(numEntries>1)

   684 	result+="ы предков";

   685       else

   686 	result+=" предка";

   687       return result+" "+trWriteList(numEntries)+".";

   688     }

   689 

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

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

   692      */

   693     virtual QCString trReimplementedInList(int numEntries)

   694     {

   695       return "Переопределяется в "+trWriteList(numEntries)+".";

   696     }

   697 

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

   699     virtual QCString trNamespaceMembers()

   700     { return "Члены пространств имен"; }

   701 

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

   703     virtual QCString trNamespaceMemberDescription(bool extractAll)

   704     {

   705       QCString result="Полный список ";

   706       if (!extractAll) result+="документированных ";

   707       result+="членов простанств имен.";

   708       return result;

   709     }

   710 

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

   712      *  index of all namespaces.

   713      */

   714     virtual QCString trNamespaceIndex()

   715     { return "Алфавитный указатель пространств имен"; }

   716 

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

   718      *  the documentation of all namespaces.

   719      */

   720     virtual QCString trNamespaceDocumentation()

   721     { return "Пространства имен"; }

   722 

   723 //////////////////////////////////////////////////////////////////////////

   724 // new since 0.49-990522

   725 //////////////////////////////////////////////////////////////////////////

   726 

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

   728      *  namespaces in a file.

   729      */

   730     virtual QCString trNamespaces()

   731     { return "Пространства имен"; }

   732 

   733 //////////////////////////////////////////////////////////////////////////

   734 // new since 0.49-990728

   735 //////////////////////////////////////////////////////////////////////////

   736 

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

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

   739      */

   740     virtual QCString trGeneratedFromFiles(ClassDef::CompoundType compType,

   741         bool single)

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

   743       // single is true implies a single file

   744       QCString result=QCString("Объявления и описания членов ");

   745       switch(compType)

   746       {

   747         case ClassDef::Class:      result+="класс"; 

   748           if (single) result+="а"; else result+="ов";

   749           break;

   750         case ClassDef::Struct:     result+="структур"; 

   751           if (single) result+="ы";

   752           break;

   753         case ClassDef::Union:      result+="объединени";

   754           if (single) result+="я"; else result+="й";

   755           break;

   756         case ClassDef::Interface:  result+="интерфейс";

   757           if (single) result+="а"; else result+="ов";

   758           break;

   759         case ClassDef::Protocol:  result+="протокол";

   760           if (single) result+="а"; else result+="ов";

   761           break;

   762         case ClassDef::Category:  result+="категори";

   763           if (single) result+="и"; else result+="й";

   764           break;

   765         case ClassDef::Exception:  result+="исключени";

   766           if (single) result+="я"; else result+="й";

   767           break;

   768       }

   769       result+=" находятся в файл";

   770       if (single) result+="е:"; else result+="ах:";

   771       return result;

   772     }

   773 

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

   775      * list.

   776      */

   777     virtual QCString trAlphabeticalList()

   778     { return "Алфавитный указатель"; }

   779 

   780 //////////////////////////////////////////////////////////////////////////

   781 // new since 0.49-990901

   782 //////////////////////////////////////////////////////////////////////////

   783 

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

   785     virtual QCString trReturnValues()

   786     { return "Возвращаемые значения"; }

   787 

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

   789      */

   790     virtual QCString trMainPage()

   791     { return "Титульная страница"; }

   792 

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

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

   795      */

   796     virtual QCString trPageAbbreviation()

   797     { return "стр."; }

   798 

   799 //////////////////////////////////////////////////////////////////////////

   800 // new since 0.49-991106

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

   802 

   803     virtual QCString trDefinedAtLineInSourceFile()

   804     {

   805       return "См. определение в файле @1 строка @0";

   806     }

   807     virtual QCString trDefinedInSourceFile()

   808     {

   809       return "См. определение в файле @0";

   810     }

   811 

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

   813 // new since 0.49-991205

   814 //////////////////////////////////////////////////////////////////////////

   815 

   816     virtual QCString trDeprecated()

   817     {

   818       return "Уст.";

   819     }

   820 

   821 //////////////////////////////////////////////////////////////////////////

   822 // new since 1.0.0

   823 //////////////////////////////////////////////////////////////////////////

   824 

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

   826     virtual QCString trCollaborationDiagram(const char *clName)

   827     {

   828       return (QCString)"Граф связей класса "+clName+":";

   829     }

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

   831     virtual QCString trInclDepGraph(const char *fName)

   832     {

   833       return (QCString)"Граф включаемых заголовочных файлов для "+fName+":";

   834     }

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

   836     virtual QCString trConstructorDocumentation()

   837     {

   838       return "Конструктор(ы)"; 

   839     }

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

   841     virtual QCString trGotoSourceCode()

   842     {

   843       return "См. исходные тексты.";

   844     }

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

   846     virtual QCString trGotoDocumentation()

   847     {

   848       return "См. документацию.";

   849     }

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

   851     virtual QCString trPrecondition()

   852     {

   853       return "Предусловие";

   854     }

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

   856     virtual QCString trPostcondition()

   857     {

   858       return "Постусловие";

   859     }

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

   861     virtual QCString trInvariant()

   862     {

   863       return "Инвариант";

   864     }

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

   866     virtual QCString trInitialValue()

   867     {

   868       return "Инициализатор";

   869     }

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

   871     virtual QCString trCode()

   872     {

   873       return "Исходные тексты";

   874     }

   875     virtual QCString trGraphicalHierarchy()

   876     {

   877       return "Иерархия классов. Графический вид.";

   878     }

   879     virtual QCString trGotoGraphicalHierarchy()

   880     {

   881       return "см. графический вид.";

   882     }

   883     virtual QCString trGotoTextualHierarchy()

   884     {

   885       return "см. текстовый вид.";

   886     }

   887     virtual QCString trPageIndex()

   888     {

   889       return "Алфавитный указатель тематических описаний";

   890     }

   891 

   892 //////////////////////////////////////////////////////////////////////////

   893 // new since 1.1.0

   894 //////////////////////////////////////////////////////////////////////////

   895     

   896     virtual QCString trNote()

   897     {

   898       return "Заметки";

   899     }

   900     virtual QCString trPublicTypes()

   901     {

   902       return "Открытые типы";

   903     }

   904     virtual QCString trPublicAttribs()

   905     {

   906       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

   907       {

   908         return "Поля данных";

   909       }

   910       else

   911       {

   912         return "Открытые атрибуты";

   913       }

   914     }

   915     virtual QCString trStaticPublicAttribs()

   916     {

   917       return "Статические открытые данные";

   918     }

   919     virtual QCString trProtectedTypes()

   920     {

   921       return "Защищенные типы";

   922     }

   923     virtual QCString trProtectedAttribs()

   924     {

   925       return "Защищенные данные";

   926     }

   927     virtual QCString trStaticProtectedAttribs()

   928     {

   929       return "Статические защищенные данные";

   930     }

   931     virtual QCString trPrivateTypes()

   932     {

   933       return "Закрытые типы";

   934     }

   935     virtual QCString trPrivateAttribs()

   936     {

   937       return "Закрытые данные";

   938     }

   939     virtual QCString trStaticPrivateAttribs()

   940     {

   941       return "Закрытые статические данные";

   942     }

   943 

   944 

   945 //////////////////////////////////////////////////////////////////////////

   946 // new since 1.1.3

   947 //////////////////////////////////////////////////////////////////////////

   948 

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

   950     virtual QCString trTodo()

   951     /*??*/

   952     {

   953       return "Необходимо сделать";

   954     }

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

   956     virtual QCString trTodoList()

   957     /*??*/

   958     {

   959       return "Список задач";

   960     }

   961 

   962 //////////////////////////////////////////////////////////////////////////

   963 // new since 1.1.4

   964 //////////////////////////////////////////////////////////////////////////

   965 

   966     virtual QCString trReferencedBy()

   967     {

   968       return "Используется в";

   969     }

   970     virtual QCString trRemarks()

   971     {

   972       return "Прим.";

   973     }

   974     virtual QCString trAttention()

   975     {

   976       return "Внимание";

   977     }

   978     virtual QCString trInclByDepGraph()

   979     {

   980       return "Граф файлов, в которые включается этот файл:";

   981     }

   982     virtual QCString trSince()

   983     /*??*/

   984     {

   985       return "Начиная с";

   986     }

   987     

   988 //////////////////////////////////////////////////////////////////////////

   989 // new since 1.1.5

   990 //////////////////////////////////////////////////////////////////////////

   991 

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

   993     virtual QCString trLegendTitle()

   994     {

   995       return "Легенда";

   996     }

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

   998     virtual QCString trLegendDocs()

   999     {

  1000       return 

  1001         "Обозначения, используемые в графах.<p>\n"

  1002         "Рассмотрим следующий пример:\n"

  1003         "\\code\n"

  1004         "/*! Невидимый класс из-за усечения */\n"

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

  1006         "/*! Усеченный класс, отношение наследования скрыто */\n"

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

  1008         "/* Недокументированный класс */\n"

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

  1010         "/*! Открытое наследование */\n"

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

  1012         "/*! Шаблон класса */\n"

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

  1014         "/*! Защищенное наследование */\n"

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

  1016         "/*! Закрытое наследование */\n"

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

  1018         "/*! Класс, используемый классом Inherited */\n"

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

  1020         "/*! Класс, порожденный от других классов */\n"

  1021         "class Inherited : public PublicBase,\n"

  1022         "                  protected ProtectedBase,\n"

  1023         "                  private PrivateBase,\n"

  1024         "                  public Undocumented,\n"

  1025         "                  public Templ<int>\n"

  1026         "{\n"

  1027         "  private:\n"

  1028         "    Used *m_usedClass;\n"

  1029         "};\n"

  1030         "\\endcode\n"

  1031         "Если \\c MAX_DOT_GRAPH_HEIGHT в конфигурационном файле "

  1032         "установлен в 240, получится следующий граф:"

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

  1034         "<p>\n"

  1035         "Прямоугольники в этом графе имеют следующее значение:\n"

  1036         "<ul>\n"

  1037         "<li>Заполненный черный прямоугольник представляет структуру или класс, "

  1038         "для которого создан граф.\n"

  1039         "<li>Прямоугольник с черной границей обозначает документированную структуру или класс.\n"

  1040         "<li>Прямоугольник с серой границей обозначает недокументированную структуру или класс.\n"

  1041         "<li>Прямоугольник с красной границей обозначает документированную структуру или класс, для которого\n"

  1042         " не все отношения наследования/содержания показаны. Граф усечен, "

  1043         "если он не поместился в указанных границах.\n"

  1044         "</ul>\n"

  1045         "Стрелки имеют следующее значение:\n"

  1046         "<ul>\n"

  1047         "<li>Темно-синяя стрелка используется для изображения отношения открытого наследования "

  1048         "между двумя классами.\n"

  1049         "<li>Темно-зеленая стрелка используется при защищенном наследовании.\n"

  1050         "<li>Темно-красная стрелка используется при закрытом наследовании.\n"

  1051         "<li>Фиолетовая стрелка используется, если класс содержится в"

  1052         "другом класе или используется другим классом."

  1053         "Со стрелкой указывается переменная, "

  1054         "через которую доступен указываемый класс или структура. \n"

  1055         "<li>Желтая стрелка используется для связи подстановки шаблона и "

  1056         "шаблона, на основе которого эта подстановка выполнена. С шаблоном"

  1057         "указывается параметр подстановки.\n"

  1058         "</ul>\n";

  1059     }

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

  1061     virtual QCString trLegend()

  1062     {

  1063       return "см. легенду";

  1064     }

  1065 

  1066 //////////////////////////////////////////////////////////////////////////

  1067 // new since 1.2.0

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

  1069     

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

  1071     virtual QCString trTest()

  1072     {

  1073       return "Тест";

  1074     }

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

  1076     virtual QCString trTestList()

  1077     {

  1078       return "Список тестов";

  1079     }

  1080 

  1081 //////////////////////////////////////////////////////////////////////////

  1082 // new since 1.2.1

  1083 //////////////////////////////////////////////////////////////////////////

  1084 

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

  1086     virtual QCString trDCOPMethods()

  1087     {

  1088       return "DCOP Методы";

  1089     }

  1090 

  1091 //////////////////////////////////////////////////////////////////////////

  1092 // new since 1.2.2

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

  1094 

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

  1096     virtual QCString trProperties()

  1097     {

  1098       return "Свойства";

  1099     }

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

  1101     virtual QCString trPropertyDocumentation()

  1102     {

  1103       return "Полный список свойств";

  1104     }

  1105 

  1106 //////////////////////////////////////////////////////////////////////////

  1107 // new since 1.2.4

  1108 //////////////////////////////////////////////////////////////////////////

  1109 

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

  1111     virtual QCString trClasses()

  1112     {

  1113       if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))

  1114       {

  1115         return "Структуры данных";

  1116       }

  1117       else

  1118       {

  1119         return "Классы";

  1120       }

  1121     }

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

  1123     virtual QCString trPackage(const char *name)

  1124     {

  1125       return QCString("Пакет ")+name;

  1126     }

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

  1128     virtual QCString trPackageList()

  1129     {

  1130       return "Полный список пакетов ";

  1131     }

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

  1133     virtual QCString trPackageListDescription()

  1134     {