Skip to content

Commit dd8b26b

Browse files
committed
AI-skill extended
1 parent 7fb3da1 commit dd8b26b

1 file changed

Lines changed: 13 additions & 2 deletions

File tree

‎_doc/AI-SKILLS.md‎

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,12 @@ und nicht betroffen.
8484
- Bei `:term:` und `:ref:` mit deutschem Anzeigetext immer das Ziel
8585
angeben: `:term:`Sequenz <sequence>``. Der Bezeichner in spitzen
8686
Klammern bleibt zwingend englisch
87+
- Ein `!` am Anfang des Rolleninhalts schaltet den Querverweis ab, der
88+
Text wird nur angezeigt: `:term:`!sequence``, `:class:`!dict``. Der
89+
Inhalt bleibt trotzdem unverändert englisch, auch wenn er wie
90+
Fließtext aussieht und kein Ziel existiert, auf das Rücksicht zu
91+
nehmen wäre. `check_roles.py` vergleicht den Rolleninhalt und meldet
92+
jede Übersetzung als Inkonsistenz
8793
- `:dfn:` ist kein Querverweis — der Text wird übersetzt, ein Ziel ist
8894
weder nötig noch erlaubt
8995
- Keine zusätzliche Backtick- oder Stern-Klammer um eine Rolle:
@@ -99,8 +105,13 @@ und nicht betroffen.
99105
``Literale`` aus dem Original bleiben erhalten und werden nicht durch
100106
deutsche Anführungszeichen ersetzt
101107
- Codeblöcke bleiben buchstabengetreu, übersetzt werden höchstens die
102-
Kommentarzeilen. Nie übersetzt werden Schlüsselwörter,
103-
Interpreter-Ausgaben und String-Literale, auf die sich eine Ausgabe bezieht
108+
Kommentarzeilen — also Zeilen, die mit `#` beginnen. Nie übersetzt
109+
werden Schlüsselwörter, Interpreter-Ausgaben und String-Literale, auf
110+
die sich eine Ausgabe bezieht
111+
- Docstrings (`"""..."""`) und Zeichenketten in `print(...)` sind Code,
112+
keine Kommentare, und bleiben deshalb englisch. Sie sehen wie
113+
Fließtext aus, gehören aber zum lauffähigen Beispiel;
114+
`check_markup.py` meldet jede Änderung daran als Fehlerart `code`
104115
- Platzhalter wie `%s`, `{0}` oder `<TRANSLATION_REPO_>` bleiben unverändert
105116
- `#, fuzzy` nach dem Übersetzen entfernen
106117

0 commit comments

Comments
 (0)