translator_de.h

doxygen(一个自动从源代码生成文档的工具)的源代码

/******************************************************************************
 *
 * 
 *
 * Copyright (C) 1997-2001 by Dimitri van Heesch.
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation under the terms of the GNU General Public License is hereby 
 * granted. No representations are made about the suitability of this software 
 * for any purpose. It is provided "as is" without express or implied warranty.
 * See the GNU General Public License for more details.
 *
 * Documents produced by Doxygen are derivative works derived from the
 * input used in their production; they are not affected by this license.
 *
 * The translation into German was provided by
 *   Jens Breitenstein ([e-mail])
 */

// Updates:
// --------
//   RK (who are you?)
//    - Update for "new since 1.1.3" version
//
//   2001/03/23 Jens Seidel ([e-mail])
//    - fixed typos
//    - changed trPageDocumentation() "Seitenbeschreibung" to
//      "Zus鋞zliche Informationen"
//    - removed old trGeneratedFrom()
//    - changed "/*!" to "/*" (documentation is inherited from translator.h
//      (INHERIT_DOCS = YES), there's no need to make changes twice)
//    - Update for "new since 1.2.4" version
//
//   2001/04/17 Jens Seidel ([e-mail])
//    - fixed typos ("Vererbunsbeziehung", "gesch&uumltzter")
//    - use umlauts instead of html code ("ä",...)
//      this makes it easier to read and fixes three problems (two in 
//      \code segment)
//
//   2001/04/23 Jens Seidel ([e-mail])
//    - Update for "new since 1.2.6-20010422" version
//
//   2001/05/06 Jens Seidel ([e-mail])
//    - Update for "new since 1.2.7" version
//    - Removed implementation of latexBabelPackage(), trVerbatimText(),
//      trFiles(), added latexLanguageSupportCommand().
//
//   2001/05/25 Jens Seidel ([e-mail])
//    - Update for "new since 1.2.7-20010524" version:
//      removed trAuthors(), trAuthor(), added trAuthor(bool, bool)
//
//   2001/07/24 Jens Seidel ([e-mail])
//    - trClassDocumentation() updated as in the English translator.
//
// Todo: 
//   - translation of all Config_getBool("OPTIMIZE_OUTPUT_FOR_C")
//     strings (see translator_en.h)
//   - translation of "compound"
//   - see FIXME
//   - was ist richtig: "Liste aller dokumentierter Elemente" oder
//                      "Liste aller dokumentierten Elemente" (aktuell)
//     (nach "aller" suchen)
//     "Mithilfe" oder "Mit Hilfe"

#ifndef TRANSLATOR_DE_H
#define TRANSLATOR_DE_H

class TranslatorGerman : public TranslatorAdapter_1_2_11
{
  public:

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

    /* Used for identification of the language. The identification
     * should not be translated. It should be replaced by the name
     * of the language in English using lower-case characters only
     * (e.g. "czech", "japanese", "russian", etc.). It should be equal to
     * the identification used in language.cpp.
     */
    virtual QCString idLanguage()
    { return "german"; }

    /*  Used to get the LaTeX command(s) for the language support. This method
     *  was designed for languages which do wish to use a babel package.
     */
    virtual QCString latexLanguageSupportCommand()
    {
      return "\\usepackage{german}\n";
    }

    /*  return the language charset. This will be used for the HTML output */
    virtual QCString idLanguageCharset()
    {
      return "iso-8859-1";
    }

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

    /* used in the compound documentation before a list of related functions. */
    virtual QCString trRelatedFunctions()
    { return "Verwandte Funktionen"; }

    /* subscript for the related functions. */
    virtual QCString trRelatedSubscript()
    { return "(Es handelt sich hierbei nicht um Elementfunktionen.)"; }

    /* header that is put before the detailed description of files, classes and namespaces. */
    virtual QCString trDetailedDescription()
    { return "Ausf黨rliche Beschreibung"; }

    /* header that is put before the list of typedefs. */
    virtual QCString trMemberTypedefDocumentation()
    { return "Dokumentation der benutzerdefinierten Datentypen"; }
    
    /* header that is put before the list of enumerations. */
    virtual QCString trMemberEnumerationDocumentation()
    { return "Dokumentation der Aufz鋒lungstypen"; }

    /* header that is put before the list of member functions. */
    virtual QCString trMemberFunctionDocumentation()
    { return "Dokumentation der Elementfunktionen"; }

    /* header that is put before the list of member attributes. */
    virtual QCString trMemberDataDocumentation()
    { return "Dokumentation der Datenelemente"; }

    /* this is the text of a link put after brief descriptions. */
    virtual QCString trMore()
    { return "Mehr..."; }

    /* put in the class documentation */
    virtual QCString trListOfAllMembers()
    { return "Aufstellung aller Elemente"; }

    /* used as the title of the "list of all members" page of a class */
    virtual QCString trMemberList()
    { return "Elementverzeichnis"; }

    /* this is the first part of a sentence that is followed by a class name */
    virtual QCString trThisIsTheListOfAllMembers()
    { return "Vollst鋘dige Aufstellung aller Elemente f黵 "; }

    /* this is the remainder of the sentence after the class name */
    virtual QCString trIncludingInheritedMembers()
    { return " einschlie遧ich aller geerbten Elemente."; }

    /*  this is put at the author sections at the bottom of man pages.
     *  parameter s is name of the project name.
     */
    virtual QCString trGeneratedAutomatically(const char *s)
    { QCString result="Automatisch erzeugt von Doxygen";
      if (s) result+=(QCString)" f黵 "+s;
      result+=" aus dem Quellcode.";
      return result;
    }

    /* put after an enum name in the list of all members */
    virtual QCString trEnumName()
    { return "enum Bezeichner"; }

    /* put after an enum value in the list of all members */
    virtual QCString trEnumValue()
    { return "enum Wert"; }

    /* put after an undocumented member in the list of all members */
    virtual QCString trDefinedIn()
    { return "Definiert in"; }

    // quick reference sections

    /*  This is put above each page as a link to the list of all groups of 
     *  compounds or files (see the \group command).
     */
    virtual QCString trModules()
    { return "Module"; }

    /* This is put above each page as a link to the class hierarchy */
    virtual QCString trClassHierarchy()
    { return "Klassenhierarchie"; }

    /* This is put above each page as a link to the list of annotated classes */
    virtual QCString trCompoundList()
    { return "躡ersicht"; }

    /* This is put above each page as a link to the list of documented files */
    virtual QCString trFileList()
    { return "Auflistung der Dateien"; }

    /* This is put above each page as a link to the list of all verbatim headers */
    virtual QCString trHeaderFiles()
    { return "Auflistung der Header-Dateien"; }

    /* This is put above each page as a link to all members of compounds. */
    virtual QCString trCompoundMembers()
    { return "Element黚ersicht"; }

    /* This is put above each page as a link to all members of files. */
    virtual QCString trFileMembers()
    { return "Datei-Elemente"; }

    /* This is put above each page as a link to all related pages. */
    virtual QCString trRelatedPages()
    { return "Zus鋞zliche Informationen"; }

    /* This is put above each page as a link to all examples. */
    virtual QCString trExamples()
    { return "Beispiele"; }

    /* This is put above each page as a link to the search engine. */
    virtual QCString trSearch()
    { return "Suchen"; }

    /* This is an introduction to the class hierarchy. */
    virtual QCString trClassHierarchyDescription()
    { return "Die Liste der Ableitungen ist -mit Einschr鋘kungen- "
             "alphabetisch sortiert:";
    }

    /* This is an introduction to the list with all files. */
    virtual QCString trFileListDescription(bool extractAll)
    {
      QCString result="Hier folgt die Aufz鋒lung aller ";
      if (!extractAll) result+="dokumentierten ";
      result+="Dateien mit einer Kurzbeschreibung:";
      return result;
    }

    /* This is an introduction to the annotated compound list. */
    virtual QCString trCompoundListDescription()
    { 
      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
	return "Hier folgt die Aufz鋒lung aller Datenstrukturen "
	       "mit einer Kurzbeschreibung:";
      else
	return "Hier folgt die Aufz鋒lung aller Klassen, Strukturen "
	       "und Varianten mit einer Kurzbeschreibung:"; // FIXME: "interfaces" = ??
    }

    /* This is an introduction to the page with all class members. */
    virtual QCString trCompoundMembersDescription(bool extractAll)
    {
      QCString result="Hier folgt die Aufz鋒lung aller ";
      if (!extractAll) result+="dokumentierten ";
      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
        result+="Strukturen und Varianten mit Verweisen auf ";
      else
        result+="Klassenelemente mit Verweisen auf ";
      if (extractAll) {
        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
          result+="die struct/union Dokumentation zu jedem Element:";
        else 
          result+="die Klassendokumentation zu jedem Element:";
      } else { 
        if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
          result+="die zugeh鰎igen Elemente:";
        else
          result+="die zugeh鰎igen Klassen:";
      }
      return result;
    }

    /* This is an introduction to the page with all file members. */
    virtual QCString trFileMembersDescription(bool extractAll)
    {
      QCString result="Hier folgt die Aufz鋒lung aller ";
      if (!extractAll) result+="dokumentierten ";
      result+="Dateielemente mit Verweisen auf ";
      if (extractAll) result+="die Dateidokumentation zu jedem Element:";
      else result+="die zugeh鰎igen Dateien:";
      return result;
    }

    /* This is an introduction to the page with the list of all header files. */
    virtual QCString trHeaderFilesDescription()
    { return "Hier folgen die Headerdateien, welche die API definieren:"; }

    /* This is an introduction to the page with the list of all examples */
    virtual QCString trExamplesDescription()
    { return "Hier folgt eine Liste mit allen Beispielen:"; }

    /* This is an introduction to the page with the list of related pages */
    virtual QCString trRelatedPagesDescription()
    { return "Hier folgt eine Liste mit zusammengeh鰎igen Themengebieten:"; }

    /* This is an introduction to the page with the list of class/file groups */
    virtual QCString trModulesDescription()
    { return "Hier folgt die Aufz鋒lung aller Module:"; }

    /* This sentences is used in the annotated class/file lists if no brief
     * description is given. 
     */
    virtual QCString trNoDescriptionAvailable()
    { return "Keine Beschreibung verf黦bar"; }

    // index titles (the project name is prepended for these)
  
    /* This is used in HTML as the title of index.html. */ 
    virtual QCString trDocumentation()
    { return "Dokumentation"; }

    /* This is used in LaTeX as the title of the chapter with the 
     * index of all groups.
     */
    virtual QCString trModuleIndex()
    { return "Modul-Verzeichnis"; }

    /* This is used in LaTeX as the title of the chapter with the 
     * class hierarchy.
     */
    virtual QCString trHierarchicalIndex()
    { return "Hierarchie-Verzeichnis"; }

    /* This is used in LaTeX as the title of the chapter with the 
     * annotated compound index.
     */
    virtual QCString trCompoundIndex()
    { 
      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
	return "Datenstruktur-Verzeichnis"; 
      else
	return "Datenstruktur-Verzeichnis"; // FIXME: war compound
    }

    /* This is used in LaTeX as the title of the chapter with the
     * list of all files.
     */
    virtual QCString trFileIndex()
    { return "Datei-Verzeichnis"; }

    /*  This is used in LaTeX as the title of the chapter containing
     *  the documentation of all groups.
     */
    virtual QCString trModuleDocumentation()
    { return "Modul-Dokumentation"; }

    /*  This is used in LaTeX as the title of the chapter containing
     *  the documentation of all classes, structs and unions.
     */
    virtual QCString trClassDocumentation()
    { 
      if (Config_getBool("OPTIMIZE_OUTPUT_FOR_C"))
        return "Datenstruktur-Dokumentation"; 
      else
        return "Klassen-Dokumentation";
    }

    /*  This is used in LaTeX as the title of the chapter containing
     *  the documentation of all files.
     */
    virtual QCString trFileDocumentation()
    { return "Datei-Dokumentation"; }

    /* This is used in LaTeX as the title of the chapter containing
     *  the documentation of all examples.
     */
    virtual QCString trExampleDocumentation()
    { return "Dokumentation der Beispiele"; }

    /*  This is used in LaTeX as the title of the chapter containing
     *  the documentation of all related pages.
     */
    virtual QCString trPageDocumentation()
    { return "Zus鋞zliche Informationen"; }

    /* This is used in LaTeX as the title of the document */
    virtual QCString trReferenceManual()
    { return "Nachschlagewerk"; }

    /*  This is used in the documentation of a file as a header before the 
     *  list of defines
     */
    virtual QCString trDefines()
    { return "Makrodefinitionen"; }

    /*  This is used in the documentation of a file as a header before the 
     *  list of function prototypes
     */
    virtual QCString trFuncProtos()
    { return "Funktionsprototypen"; }

    /*  This is used in the documentation of a file as a header before the 
     *  list of typedefs
     */
    virtual QCString trTypedefs()
    { return "Typendefinitionen"; }

    /*  This is used in the documentation of a file as a header before the 
     *  list of enumerations
     */
    virtual QCString trEnumerations()
    { return "Aufz鋒lungen"; }

    /*  This is used in the documentation of a file as a header before the 
     *  list of (global) functions
     */
    virtual QCString trFunctions()
    { return "Funktionen"; }

    /*  This is used in the documentation of a file as a header before the 
     *  list of (global) variables
     */
    virtual QCString trVariables()
    { return "Variablen"; }

    /*  This is used in the documentation of a file as a header before the 
     *  list of (global) variables
     */
    virtual QCString trEnumerationValues()
    { return "Aufz鋒lungswerte"; }

    /*  This is used in the documentation of a file before the list of
     *  documentation blocks for defines
     */
    virtual QCString trDefineDocumentation()
    { return "Makro-Dokumentation"; }

    /*  This is used in the documentation of a file/namespace before the list 
     *  of documentation blocks for function prototypes
     */
    virtual QCString trFunctionPrototypeDocumentation()
    { return "Funktionsprototypen Dokumentation"; }

    /*  This is used in the documentation of a file/namespace before the list 
     *  of documentation blocks for typedefs
     */
    virtual QCString trTypedefDocumentation()
    { return "Dokumentation der benutzerdefinerten Typen"; }

    /*  This is used in the documentation of a file/namespace before the list 
     *  of documentation blocks for enumeration types
     */
    virtual QCString trEnumerationTypeDocumentation()
    { return "Dokumentation der Aufz鋒lungstypen"; }

    /*  This is used in the documentation of a file/namespace before the list 
     *  of documentation blocks for enumeration values
     */
    virtual QCString trEnumerationValueDocumentation()
    { return "Dokumentation des Wertebereiches der Aufz鋒lungstypen"; }