tumblebone / dufteranatomie

Wir übersetzen das Anki-Deck "Dope Ranatomy" ins Deutsche. / We're translating the Anki-Deck "Dope Ranatomy" into German.

• Projekt DufteRanatomie
• Guidelines
  • Allgemeine Informationen
  • Schema der Übersetzung
• Cheatsheet
• Bearbeiten einer Karte
  • Editor
    • HTML-Quelltext aus Anki-Desktop
    • HTML-Quelltext aus Anki-iOS
  • Tags
• Einreichen der Änderung

Table of contents generated with markdown-toc

Projekt DufteRanatomie

Ziel des Projekts ist eine Übersetzung des Anatomie-Decks DopeRanatomy und des Histologie-Decks Navicularis ins Deutsche.

Um das ganze für die Organisatoren möglichst reibungslos zu gestalten, wird der Inhalt über diese Github-Repository verwaltet. Das erlaubt es allen, die zum Projekt beitragen wollen:

• Parallel zu arbeiten
• Sich gegenseitig über die Schulter zu schauen
• Änderungen des Decks zu dokumentieren und zwischenzuspeichern, falls man auf eine ältere Version downgraden möchte
• Jeder Zeit den aktuellen Stand des Decks zu überprüfen
• Regelmäßig (und hoffentlich bald auf Knopfdruck) Decks zu releasen

Guidelines

Allgemeine Informationen

Updates zum Deck umfassen zur Zeit:

• Übersetzung
• Rechtschreib-/Grammatikfehler
• Inhaltliche Fehler und Ergänzungen
• Wortwahl (bei Unklarheiten)
• Hinzufügen neuer, einheitlicher Tags (die meisten deutschsprachigen Tags fehlen, der Rest ist ein ziemliches Durcheinander)

Einschränkungen:

• Der Inhalt des Originals soll keinesfalls verloren gehen!
• Das hinzufügen neuer Karten ist zur Zeit nicht vorgesehen.
• Wenn du deinen Karten Medien (Bilder, Audio, etc.) hinzufügst, solltest du diese den Projektleitern zukommen lassen. Andernfalls sind diese in zukünftigen Deck-Releases nicht enthalten.
• Was Verwaltung von Medien angeht, werden wir uns nochmal was eleganteres überlegen.

Schema der Übersetzung

• Die erste Zeile enthält den Alltagsnamen (bspw. "Untere Hohlvene") und die gängige Abkürzung in Klammern (bspw. IVC) gefolgt von einem Strichpunkt ";".
• Die zweite Zeile enthält den abgekürzten Fachbegriff nach Terminologia Anatomica (bspw. "V. cava inferior").
• Wenn es keinen Alltagsnamen gibt, oder dieser mit dem Fachbegriff übereinstimmt, nur den Fachbegriff in einer Zeile.
• Sollte es mehrere wichtige Alltagsnamen oder Abkürzungen geben, dann kannst du diese durch einen unterstrichenen Querstrich (HTML lautet "<u> / </u>") getrennt in der selben Zeile angeben.
• Gib bei deiner Übersetzung als Quellenangabe am besten Amboss, ansonsten entweder Wiktionary, Wikipedia oder Terminologia-Anatomica an.
• Quellenangaben aus Büchern sollten leicht nachvollziehbar sein. Prometheus -> Prometheus (X. Auflage, Seite YZ)

Before:

  1a: 'Inferior vena cava'

After:

  1a: 'Untere Hohlvene (IVC);<br>V. cava inferior'

..hierbei ist <br> ein HTML-Tag für einen Zeilenumbruch. Dieser ist notwendig, um den Inhalt der Karte richtig darzustellen.

Klassen (Nervus, Nodus, Arteria, etc.) sollten bitte nach diesem Schema abgekürzt werden.

Begriff	Abkürzung (sg.)	Abkürzung (pl.)
Arteria	A.	Aa.
Ligamentum	Lig.	Ligg.
Nervus	N.	Nn.
Nodus	Nd.	Ndd.
...	...	...

Cheatsheet

1. Click auf den Errata-Button
2. Bearbeite die Karte im Editor
3. New Branch -> "Propose Changes"
4. Formular ausfüllen -> "Create Pull Request"

Bearbeiten einer Karte

• Alle Karten des Dufte-Ranatomie-Decks, die am oberen rechten Bildrand einen "Errata"-Button haben, sind Teil dieses Projekts.
• Ein Click auf diesen Button führt dich, wenn du in Github eingeloggt bist, zu einem Editor. Das ganze sollte Plattformunabhängig und Unabhängig von deiner Anki-Version funktionieren.
• Wenn du bei Click auf den Errata-Button einen 404-Fehler bekommst, bearbeitest du höchstwahrscheinlich eine selbst gemachte, neue Karte, die nicht Teil des Decks ist.
• Du kannst auch manuell nach einer Karte suchen, indem du im Suchfenster die Note ID der Karte einfügst. Der Inhalt jeder Karte ist in einer .yaml-Textdatei gespeichert, die nach der Note ID benannt ist. Diese findest du über den Button "Note ID" in der Kopfzeile

Editor

Im Editor siehst du Inhalte der Felder im Format:

  Feldname1: 'Inhalt des <b>ersten Flelds</b> mit HTML-Tags'
  Feldname2: 'Inhalt des zweiten Felds'

... wobei die Elemente in eckigen Klammern Textformattinerung im HTML-Format darstellen. (In diesem Fall, fett = fett).

Damit Formattierung (fett, kursiv, Zeilenumbrüche, etc.) nicht verloren gehen, musst du den Text als HTML aus dem Anki-Editor kopieren und in die Gänsefüßchen des betreffenden Feldes eintragen:

  Feldname1: 'Inhalt des <b>ersten Felds</b> mit HTML-Tags'
  Feldname2: 'Inhalt des zweiten Felds'

Aufgrund der aktuell horrenden Implementierung unseres Programms darf der Text allerdings keine Gänsefüßchen enthalten. Weder einfach noch doppelt.

HTML-Quelltext aus Anki-Desktop

Hierfür musst du den Anki-Editor (Taste E beim reviewen) öffnen und auf den Sandwichbutton clicken:

Wähle hier den Reiter "Edit HTML" und kopiere den Inhalt des sich öffnenden Fensters:

HTML-Quelltext aus Anki-iOS

Hier geht das etwas einfacher. Du kannst im Editor durch Click auf den "</>"-Button zwischen HTML und Normalansicht wechseln.

Tags

Bei Tags brauchst du dir keine Gedanken um Formattierung machen. Diese enthalten kein HTML-Gedöns. Jede Zeile entspricht einem Tag:

  - 'Parent::Child::Leberkas'

Um neue Tags hinzuzufügen, könnt ihr einfach neue Zeilen nach bestehendem Schema hinzufügen.

Einreichen der Änderung

Wenn du zum Ende der Seite scrollst, kannst du die Änderung einreichen. Im unteren Beispiel habe ich einen neuen Tag hinzugefügt. Wähle die Option "New Branch" und clicke anschließend auf "Propose Changes". Du kannst die übrigen Felder gerne ignorieren.

Im nächsten Bildschirm ist ein Formular, in dem du deinen Vorschlag kategorisieren, Quellen hinzufügen oder eine kurze Erklärung einfügen kannst.

Wenn du das einreichst, sieht das ganze für uns so aus:

Über den Reiter "Pull Requests kannst du jeder Zeit den Stand aller Submissions einsehen.