Übersetzung des Benutzerhandbuchs?

Lieber Joachim,
ich erkenne die Problematik. Es ist eine Mammutaufgabe, die Dinge zu richten, die über lange Zeit nicht angegangen worden sind. Jeder, der sich mit der Drupalwelt auseinandersetzt und sich die Aufgabe vor Augen führt, fühlt sich davon erdrückt.
Ich bin erst sehr kurze Zeit dabei und sehe, lieber Joachim, welches riesige Engagement Du an den Tag legst um Mitstreiter zu finden, die Dich dabei unterstützen, Drupal begreifbarer zu machen. Dafür zolle ich Dir meinen Respekt!
Ich bin mir sicher, dass Du absolut in der Lage bist, zur Erfüllung der Aufgaben sinnvolle und konkrete Vorgaben ins Netz zu stellen. Deshalb erlaube ich mir, das Wort „Salamitaktik“ in die Runde zu werfen. Alle diejenigen, die sich hier im Forum zu Wort gemeldet haben, wären ganz sicher auch bereit, einen konkreten, für sie überschaubaren und machbaren Beitrag zur Lösung der Aufgabe beizutragen. Und das nicht nur deshalb, weil jeder mehr oder weniger direkt davon partizipiert!
Als Anfang könntest Du an prominenter Stelle auf Drupalcenter eine Prioritätenliste ins Netz stellen, aus der ersichtlich ist, welche Teilaufgaben zuerst erledigt werden sollten. Danach könntest Du diese Teilaufgaben weiter in Aufgabengebiete aufteilen, für deren Bearbeitung ein normal begabter Drupalaner max. 16 Stunden benötigen wird, also maximal ein Wochenende.
In diese Liste, kann sich jeder eintragen, der eine der Teilaufgaben übernehmen will, mit der Angabe eines voraussichtlichen bzw. fixen Fertigstellungstermins. Als Drupalexperte kannst Du den Fortschritt optimal steuern. Nichts spricht dagegen, dass sich bei zwingenden Abhängigkeiten, Bearbeiter selbständig untereinander absprechen.
Diese Vorgehensweise würde lange Reisen, Gesprächszeit und Kosten sparen und auch denjenigen engagierten Drupalanern die Möglichkeit zur Unterstützung bieten, die nur hier und da mal ein paar Stunden von ihrer eigentlichen Arbeitszeit abzwacken können.

Wenn`s klappt, schmeiße ich `ne Gartenparty!

Ottmar

Da ich eher in englischen Foren unterwegs bin, wusste ich nicht mal, dass es ein Drupal Meetup in Stuttgart gibt, sonst hätte ich auch mal vorbeigeschaut. Vielleicht hätte man das über Facebook-Events verbreiten sollen, so machen das die meisten Gruppen aller Art, die sich regelmäßig treffen.

Von der Idee einer Übersetzung des Drupal-Handbuches halte ich überhaupt nichts. Die Energie sollte lieber in die Verbesserung der derzeitigen Doku investiert werden, denn da bestehen noch viele Lücken. Englisch sollte man in der heutigen Zeit auch als Nicht-Entwickler beherrschen.

Jonny ich denke da gehen die Meinungen wirklich auseinander.

Ich kann sehr gut Englisch, aber ich schaue beispielsweise James Bond viel lieber auf deutsch, weil ich mich dann zurücklehnen und entspannen kann. Ein Benutzerhandbuch, das anhand eines einfachen Demo-Projektes vielen Neulingen den Einstieg erleichtert nicht zu Übersetzen, weil man davon ausgeht, dass jeder vom Fleck weg genügend Englischkenntnisse haben sollte, der sich für Drupal interessiert, schädigt letzten Endes schlicht Drupal's Marktanteil in Deutschland.

Das Hollywood-Filme trotz des guten Englischunterrichts an vielen Schulen, dennoch übersetzt werden, hat sicher seine Berechtigung. Hier ist es schlicht genauso.

Ich schaue Filme auch immer lieber auf Deutsch, aber ich würde jetzt passive Unterhaltung nicht mit der aktiven Erstellung einer Webseite vergleichen. Wenn ich irgendwie feststecke, dann habe ich den Ehrgeiz dieses Problem auch zu lösen und gebe doch nicht auf, weil ich englische Texte lesen muss. Eine Übersetzung kann auch nie 100% aktuell sein, sonst wird immer irgendwie hinterherhinken und allein schon deshalb würde ich mich immer für die englische Version entscheiden. Ich glaube auch nicht, dass Anfänger so ein Handbuch durchlesen würden, sondern man diese eher durch Youtube-Tutorials erreichen kann und da wäre mehr deutscher Content sicher wünschenswert.

Lieber Joachim,
hast Du schon einen Plan, wie die Übersetzung des Benutzerhandbuchs am besten durchgeführt werden kann? Kann es funktionieren, dass Du das Handbuch in eine Tabelle kopierst, die pro Zeile 24 Zeilen des Handbuchs beinhaltet? Wenn wir pro Zeile des Handbuchs im Durchschnitt 2,5 Minuten Übersetzungszeit für einen Drupalaner voraussetzen, der im Umgang mit der englischen Sprache durchschnittlich sicher ist, würde die Übersetzung einer Zeile der Tabelle ca. 1 Stunde dauern. Die Tabelle müsste dann 4 Spalten haben: 1. Spalte = Originaltext, 2. Spalte = Anmeldespalte (Hier trägt sich derjenige ein, der die Übersetzung der Spalte übernimmt, 3. Spalte Voraussichtliche Fertigstellung, 4. Spalte = Übersetzter Text.
Leider habe ich noch nicht gelernt, wie eine solche Tabelle mit Drupal am effizientesten aufgebaut wird, sonst würde ich die Tabelle selbst programmieren. Und Du weißt ganz sicher, an welcher Stelle auf Drupalcenter.de die Tabelle am besten platziert wird, damit möglichst viele die Tabelle sehen. Vielleicht ist Johny ja so nett und übersetzt auch 2 oder 3 Zeilen der Tabelle. Wenn wir es ganz korrekt machen wollen, solltest Du noch einen "Checker" bestimmen, der die englische Sprache nahezu perfekt beherrscht. Er sollte für ein einheitliches "Wording" sorgen, damit gleiche Elemente/Vorgänge immer die gleiche Bezeichnung bekommen.
Es wäre schön, wenn wir einen Anfang machen würden. Als "absolut Beginner" wäre es mir eine große Hilfe.
Ottmar
PS: Wenn Du mir den Programmiertext für die Tabelle senden würdest, wäre ich Dir sehr dankbar!

Hallo,
Joachim war so nett, die Diskussion zur Akzeptanz von Drupal 8 anzukurbeln. Als Neueinsteiger bei Drupal 8, ohne jegliche Vorkenntnisse in der Programmierung oder mit D6 oder D7, erlaube ich mir meine Sicht zu diesem Thema darzustellen, nachdem ich die Diskussion von Anfang 2018 nachvollzogen habe. Ich hoffe darauf, dass mein Beitrag Assoziationen hervorruft, die zu einem fundierten Weg zur Beseitigung der Unsicherheit bei der Wahrnehmung von Drupal 8 führt. Ich hoffe deshalb darauf, weil ich trotz meiner geringen Kenntnisse über D8, mich bereits von dem Konzept Drupal gefangen fühle.

Mögliche Lösungen zu den jeweiligen Diskussionspunkten sind in der vorgenannten Diskussion benannt worden. Es geht mir in diesem Beitrag deshalb darum, diese zusammenzufassen um sie ins Gedächtnis zurückzurufen, als Anreiz dafür, dass sie zuende gedacht und im optimalen Fall, schließlich umgesetzt werden. Entsprechend der Diskussion habe ich folgende Aufteilung vorgenommen:
A: Zielsetzung des Initialteams Drupal, USA
B: Technische Möglichkeiten
C: Lehrmittelgestaltung

A: Die Diskussion verdeutlicht Unsicherheit in der Zielsetzung von D8.
1. Ist es das Ziel, Drupal 8 zu einem „Framework“ (CMF) zu machen, das in der letzten Konsequenz ausschließlich von großen Spezialistenteams beherrscht werden kann, oder
2. Soll Drupal für jedermann attraktiv sein?
Meinung war: 1 funktioniert nicht ohne 2 und 2 funktioniert nicht ohne 1!
• Drupalanwender unterliegen den gleichen ökonomischen Zwängen, wie jeder andere Marktteilnehmer. Ist das einzige Ziel, ein hochqualifiziertes Framework zu entwickeln, entsteht eine zu hohe Eintrittsschwelle für Neueinsteiger. Der Aufwand für die Erstellung einer Drupalseite wird konsequenter Weise allein durch die Personalkosten erheblich, sodass die Frage nach alternativen Möglichkeiten schnell gestellt wird. Drupal verwirkt seinen konzeptionellen Vorteil, weil notwendige Manpower am Markt nicht oder nur sehr teuer eingekauft werden kann.
• Eine Weiterentwicklung mit dem Schwerpunkt „niedrige Eintrittsschwelle für Neueinsteiger“, führt zu einer qualitativen Abflachung. Drupals konzeptioneller Ansatz würde auch auf diesem Weg nicht genutzt werden.
• Es steht die Aufgabe an, die Eintrittsschwelle für Neueinsteiger gering zu halten und einen gleitenden Übergang zu einem jeweils höheren Levels mit wachsendem Wissen, zu begleiten.

Lösungsansätze:

B: Die Integration von Git, Drush und Composer und die damit verbundene Verwendung von Kommandozeilen wird im Diskussionsschwerpunkt zögernd bewertet. Der Diskussionsansatz Linux/Windows wird nicht zu Ende diskutiert.
• Drush und/oder Composer machen das komplexe System Drupal handhabbarer.
• Die hier zu lösende Aufgabe ist eine einfache, schnelle und funktionierende Bereitstellung dieser Komponenten für Neueinsteiger.
• Den Umgang mit Composer lernt ein Neueinsteiger vorbehaltlos, wenn dieser Ansatz von Anfang an propagiert wird.
• Sich nicht gegen die Kommandozeile zu wehren, scheint mir als Totallaien einfacher zu sein, als das Rad neu zu erfinden, um sie nicht zu nutzen.

Eine Volksweisheit: Wenn Du einen Feind nicht besiegen kannst, mach ihn Dir zum Freund!
• Was spricht dagegen, mit Microsoft eine Zusammenarbeit mit der Zielsetzung einer optimalen Integration von Drush und/oder Composer für Drupal anzuregen? Bitnami könnte dabei möglicherweise Hilfestellung geben. Es gibt abermillionen Windowsnutzer, die sicher nicht Linux aufsetzen wollen um Drupal mal auszuprobieren. Und Windows erlangt Vorteile, die uns als Drupalaner objektiv betrachtet, nicht stören müssen.
• Ein weiterer Ansatz ist die Optimierung des Aufsetzens eines Linuxservers auf einem Windowsgerät, so, das dies einfach wie der Bitnami-Download erfolgt. (Erforderlicher Arbeitsspeicher, Prozessorausstattung, etc. nicht berücksichtigt)
• Es gibt Laptops, die gleichzeitig ein Linux- als auch ein Windows-Betriebssystem installiert haben. Möglicherweise können Hersteller gefunden werden, die Drupal mit allen empfohlen Komponenten von Hause aus installieren und Drupal als Verkaufsargument bzw. Alleinstellungsmerkmal nutzen.
• Auf dem eigenen Rechner entwickeln und dann auf einen Liveserver hochladen. Diese Vorgehensweise sollte Standard für kleine und mittlere Seiten sein können.

C: Ein Neueinsteiger sucht beim ersten Kontakt mit Drupal nach einem „Steigbügel“. Der muss sofort zu finden und zu verstehen sein. Menschen setzen ihre Sinne beim Lernen mit unterschiedlicher Intensität ein.
• Dem Handbuch, an repräsentativer Stelle platziert, sollte eine Grafik und ein entsprechender Text vorangestellt werden, sodass Neueinsteiger einen schnellen und leicht verständlichen Überblick über die grundsätzlichen Zusammenhänge des Drupalkonzepts sofort finden.
• Das Benutzerhandbuch sollte zu jedem in prosa beschriebenen Vorgang ein Ablaufdiagramm liefern.
• Der Text des Benutzerhandbuchs und das entsprechende Diagramm können die Grundlage für ein jeweils maximal 3-minütiges, bei komplexen Themen maximal 7-minütiges Video liefern. Das Video sollte vom Benutzerhandbuch aus direkt aktivierbar sein und die Erstellung muss standardisiert sein.
• Die Übersetzung des Benutzerhandbuchs in die jeweilige Landessprache ist ein „Muss“!
• Auf der Grundlage eines so neu strukturierten Benutzerhandbuchs mit den entsprechenden Features kann ein „Interaktives Drupal-TV“ aufgebaut werden.

• Ein weiterer Ansatz ist, statt eines Benutzerhandbuchs in der jetzigen Form, eine interaktive Plattform zu schaffen, mit einer Struktur wie sie von www.w3schools.com verwendet wird.

Der Möglichkeiten gibt es genug – greifen wir zu!

Ottmar

Lieber Joachim,

vielen Dank für das tolle Gespräch, dass wir heute Vormittag geführt haben. Gehen wir die Sache also mal in aller Ruhe und Gemütlichkeit an. Als Anhang sende ich Dir eine Ablaufgliederung, die wiedergeben soll, wie ich mir die weitere Umsetzung des Projekts vorstelle. Klar, der Entwurf wird einige Fragen und Fehler beinhalten. Es freut mich daher, wenn Du die Zeit findest, einen Blick darauf zu werfen und den Text entsprechend zu verändern. Ansonsten, kein Thema, Anruf genügd!

Gliederung des Arbeitsablaufs für die Übersetzung des Drupal -Benutzerhandbuchs (DBHB)
in die deutsche Sprache und deren Nutzung für Weiterentwicklungen

Mit der Übersetzung des DBHB in die deutsche Sprache ist die Absicht verbunden, deutschsprachigen Neueinsteigern die Nutzung von Drupal zu erleichtern. Der Installation einer optimalen Entwicklungsumgebung für die Nutzung von Drupal soll zudem mehr Raum gegeben werden, als in der englischen Originalfassung. Drush und Composer sollen als Hauptbearbeitungs-Tools von Beginn an als wesentliche Bedienungsinstrumente lanciert werden, da sie die Bedienung und Überschaubarkeit von Drupal wesentlich erleichtern. Durch die Erweiterung des DBHB um Ablaufdiagramme, die die Bedienung von Drupal grafisch abbilden, soll eine einheitliche Grundlage für deutschsprachige Anleitungsvideos geschaffen werden und ein Rahmen für ein interaktives Drupal-TV.

Der Übersetzungsvorgang

1. Programmierung einer Übersetzungstabelle mit 4 Spalten:
1. Spalte
Eintragung des Originaltexts. Es soll eine durchschnittliche Zeilenmenge von 24 Zeilen des DBHB - Originaltexts eingetragen werden. Bei einer Übersetzungsdauer von 2,5 Minuten pro Zeile, soll die Übersetzung eines Textpakets, also einer Tabellenzeile, ca. 60 Minuten in Anspruch nehmen.
2. Spalte
In diese Spalte kann sich jeder eintragen, der die Übersetzung der entsprechenden Zeile übernehmen will. Es wäre schön, wenn die Eintragung mit dem Benutzerkonto verlinkt werden könnte.
3. Spalte
Eintragung, bis zu welchem Datum die Übersetzung fertig ist.
4. Spalte
Eintragung des übersetzten Textes

Es ist zu prüfen, inwieweit es sinnvoll sein kann, in die Tabelle Verlinkungen zu Übersetzungstools zu integrieren. So könnte sich beispielsweise die Tabelle, bei Aktivierung einer Verlinkung, nach links oder rechts verschieben und der Link auf der jeweils anderen Seite geöffnet werden. Möglicherweise wäre dies eine Erleichterung für die Übersetzungsarbeit.

2. Aufteilung und Eintragung des DBHB Originaltexts
1. Concept - Beschreibungen
Die Struktur des Originaltext bleibt in der Endfassung erhalten.
2. Ausführungsbeschreibungen
Die Übersetzung erfolgt wie oben, jedoch soll berücksichtigt werden, dass später ein Diagramm oben, unten oder seitlich, je nach technischem Optimum, nach der vollständigen Übersetzung, eingefügt wird.
3. Eintragung der Textstücke in Spalte 1 der Tabelle, wobei zuerst die Konzeptbeschreibungen und danach die Ausführungsbeschreibungen eingetragen werden.

3. Nach der Erledigung der Aufgaben 1 bis 2
1. Ansprache des Organisationsteams, unser Projekt an prominenter Stelle zu lancieren.
2. Ggf. ist zu klären, ob für die Durchführung der Übersetzungsarbeit eine eigene Website notwendig ist. Wie bei jedem Projekt hängt der Erfolg unseres Projekts von der überzeugenden Darstellung ab.

4. Entwurf eines erklärenden Einleitungstexts. Der Text soll auf die Notwendigkeit und den Nutzen für jeden hinweisen, der Drupal nutzt oder nutzen will. Der Wortlaut des Texts ist mit davon abhängig, an welcher Stelle der Text und die Tabelle eingestellt wird

5. Reaktivierung vorhandener Kontakte mit dem Hinweis auf das Projekt mit der Bitte um Unterstützung bei der Übersetzung.

6. Auswahl eines „Checkers“, der den Übersetzungstext in eine einheitliche sprachliche Fassung bringt. Der Checker bekommt die "Übersetzungshoheit". Damit soll verhindert werden, dass die Übersetzungsarbeit durch Diskussionen über mögliche Übersetzungsalternativen, verlängert wird. Der Checker sollte einen eigenen "Thread" bekommen, auf dem Übersetzungsalternativen eingereicht und diskutiert werden können. Es obliegt dem Checker zu entscheiden, welche Alternativen er wann übernimmt.

7. Parallel zur Übersetzungsarbeit soll ein adäquater Text für die Erklärung der Installation einer optimalen Entwicklungsumgebung für die Nutzung von Drupal in deutscher Sprache formuliert werden. Der Text kann später in die englische Sprache übersetzt werden. Bei der Planung einer optimalen Entwicklungsumgebung, sollte berücksichtigt werden, dass die meisten Neueinsteiger mit Windows arbeiten. Nur wenige werden gleich zu Beginn dazu bereit sein, ohne Drupal überhaupt zu kennen, auf eine Linux-Variante umzusteigen. Es sollten daher zwei Beschreibungen für den Aufbau einer optimalen Entwicklungsumgebung erstellt werden.

1. Auf Grundlage von Windows. Composer und Drush werden entsprechend der System- bzw. Umgebungsvariablen integriert.
2. Beschreibung für die Integration einer optimalen Entwicklungsumgebung zum späteren Umstieg von Windows auf Linux, bzw. für eine direkte Integration auf Linux.

8. Nach erfolgreicher Übersetzungsarbeit soll die technische Implementation als deutschsprachiges DBHB erfolgen. Hier ist wahrscheinlich wieder die Unterstützung des Drupal - Organisationsteams gefragt.

Vorausschau

Schaffung der Grundlagen für die Erstellung von Ablaufdiagrammen. Ansprache von Systemanalytikern und Designern

Integration der Ablaufdiagramme in das vorhandene DBHB. Möglicherweise mit integrierter Verlinkung zu den entsprechenden Erklärvideos

Erstellen von beschreibenden Videos in deutscher Sprache auf der Grundlage des DBHB – Texts und Diagrammen

Entwicklung eines „interaktiven Drupal-TV“ auf Grundlage des DBHB und den dazu entwickelten Diagrammen und Videos

Hab's gelesen. Drubalhandbuch schreibt man übrigens mit P Also als Franke verstehe ich auch DBHB aber auch nur, weil's bei uns ja kein haddes b gibt.

Nur um es Mal erwähnt zu haben. Dieses Handbuch ist Bestandteil der lückenhaften Dokumentation, von der du sprichst.

Also ich hab' mir jetzt nach 2 Jahren das Benutzerhandbuch auf Drupal.org mal wieder angesehen. Und ich habe in der Tat festgestellt, dass weder eine Tabelle noch eine Webseite Sinn machen, um dieses Projekt zu stemmen. Zur Verdeutlichung möchte ich euch mal folgenden Screenshot zeigen:

Wer hier mit übersetzen möchte, muss:

1. in der Lage sein eine Git-Repository zu klonen
2. Verschiedene Tools, wie Atom und darin einige Addons unter Windows/Linux installieren können.
3. Bereit sein, sich mit ASCII-Doc auseinander zu setzen

Das Außeinandernehmen der einzelnen Texte ist alleine schon aus technischen Gründen eine wirklich blöde Idee.
In den einzelnen Dateien stecken so viele Metadaten, Formatierungsanweisungen und andere Hinweise, dass die Übersetzung durch das Aufbereiten in einer Tabelle unnötig in die Länge gezogen würde.

Ascii-Doc ist nicht schwer. und das Clonen einer Git-Repo auch nicht. Wenn genügend Interesse besteht, können wir gerne eine Arbeitsanleitung erschaffen, die es jedem ermöglicht an der Übersetzung des Drupal.org Benutzerhandbuchs mitzuwirken.

Was das Projekt das letzte mal zum Scheitern brachte, sind vor allem die technischen Anforderungen und, dass keiner weiß, wie einfach das eigentlich ist.

- Im ersten Schritt sollten wir schlicht diie Konzepte im Habdbuch übersetzen
- Im zweiten Schritt den Rest
- Ist das geschafft, müssen wir den Wortlaut der einzelnen Dokumente mit der deutschen Übersetzung der Benutzeroberfläche
in Drupal abgleichen

Anschließend muss das Projekt nachgebaut und die entsprechenden Screenshots erzeugt werden

In der Zwischenzeit können wir alle Beten, dass Jennifer nicht einfällt, das Handbuch zu aktualisieren oder auf Drupal 9 vorzubereiten.

Das Ganze am besten mit 2 - 4 willigen technisch verständigen Menschen.

Ich mutmaße mal, dass man auf diese Weise das aktuelle Handbuch auf Drupal.org in 2 - 3 Monten fertig bekommt. Wenn das vorher jemand außeinander nimmt, nur um es grundsätzlich willigen Übersetzern möglichst angenehm zu machen und wir es hinterher stück für Stück wieder zusammenfielßeln und alle Formatierungen überprüfen müssen, damit das Buch auf Drupal.org auch wieder so zusammengebaut wird, wie es im Orginal der Fall ist und die entsprechenden Prozessoren daraus jeweils ein PDF, epub, und mobi erzeugen sollen, können, dann sind wir auf Grund der Metadaten und der Formatierungen locker 2 -3 Jahre beschäftigt. Da können wir auch gleich auf Drupal 9 warten :-)

Sorry Ottmar, ich finde die Idee ja gut, aber der Aufwand ist mir für läppische 326 Seiten Handbuch einfach zu groß, da nehme ich die Vorbereitungszeit lieber, um das Buch Seite für Seite zu übersetzen und bin am Ende wesentlich schneller fertig.

Lieber Joachim,

Das mit dem hadden b lernt ihr Franken noch. Jedenfalls drücke ich ganz fest die Daumen!

Allerdings ist "DBHB" die Abkürzung für "Drupal-Benutzer-Hand-Buch".

Aber die Abkürzung wird uns nicht aufhalten!

Bis hoffentlich bald,
Ottmar

Lieber Joachim,
ich befasse mich am Wochenende mit Deiner Idee. Beim ersten Lesen Deiner Beschreibung zur Vorgehensweise für die Übersetzung des DBHB, kann ich nicht ganz folgen. Das liegt daran, dass ich eher schlichten Verstandes bin und daher immer versuche, die einfachste Lösung zu finden. Leider bin ich nicht fit genug im Umgang mit den technischen Zusammenhängen, die das DBHB betreffen. Bisher bin ich davon ausgegangen, dass einen Neueinsteiger zu Beginn eher nicht 300+ Seiten interessieren, sondern zunächst nur das wirklich gute DBHB, wie es zurzeit unter Drupal 8 Benutzerhandbuch in englischer Sprache veröffentlicht ist. Alles Weitere, so war meine Überlegung, sollte als weiterführender Stoff für die Heranführung der Neueinsteiger an ein jeweils höheres Verständnislevel angehangen werden und dies unter Beachtung der Integration von Diagrammen, Videos und das interaktive Drupal-TV. Ein Auseinanderreißen des Textes sehe ich unter diesem Kontext und den technischen Zusammenhängen, wie ich sie aus Deinen Darstellungen verstanden habe, nicht, da der übersetzte Test von einem technischen Bearbeiter, nach meinem Verständnis, "lediglich" in den Editortext kopiert werden muss. Aber wie schon geschrieben, ich befasse mich am Wochenende nochmal intensiver mit Deiner Idee und hoffe, dadurch ein höheres Level an Verständnis zu erreichen.
Wichtig ist, dass wir schnellstens mit der Übersetzungsarbeit anfangen. Darauf kommt´s schließlich an.
Ich bin gespannt, wie es weiter geht!
Ottmar

Also.

Ja es geht um das Benutzerhandbuch auf drupal.org. Dass hat halt über 200 Seiten, aber nur cica 103 Seiten Text und Metadaten.

guide

Damit das Benutzerhandbuch in wirklich jeder Sprache gleich aussieht, hat das Documentation-Team ein hochgradig strukturiertes Dokument erstellt.

Das fertige Produkt besteht aktuell aus 237 Seiten, die sehr viele Hinweise, Links und Verweise auf Seiten innerhalb der Benutzeroberfläche von Drupal 8.und auf die jeweiligen Originalautoren des Handbuhcs enthalten..

Ich habe bis circa 3 Uhr heute morgen am Benutzerhandbuch in seiner letzten Version gearbeitet.

Viele Textmuster lassen sich wirklich gut ersetzen.

Die kleinen Textteile auf den Seiten, die das eigentliche Benutzerhandbuch darstellen, sind auf 103 Txt-Dateien verteilt.

Ich denke bei einer Stunde pro Seite, was wirklich gut kalkuliert.ist, sind 2 - 3 Wochen durchaus eine angemessene Zeit, die jemand benötigt, der ASCII Doc auskennt. 103 Dateien á 2 Stunden macht insgesamt 206 Stunden, also 8,6 Tage

Auf eine extra Website kopieren und Menschen, die eventuell mit übersetzen wollen, das ganze angenehmen zu präsentieren, damit sie die einzelnen Teile des Handbuchs wegsnacken können, dauert einfach viel länger.

Hier ein Beispiel:

Im Originaltext des Buches steht z.b.

Das meiste dieser Inhalte taucht in fast gleicher Form in jedem der Quelldokumente wieder auf.

Das bedeutet, dass man Überschriften, Tabellenspaltenbezeichnungen und auch Namensnennungen mit jeweils 1 Eingabe in die Suchen und ersetzen Funktion eines guten Texteditors im gesamten Dokumente setzen kann.

Dann kommen so kleine Texte wie im Abschnitt Arbeitsschritte (Steps) hinzu. Darin enthalten sind _Verweise_ auf Schaltflächen in der UI von Drupal.

Das dürfte die größte Arbeit sein. Bezeichnungen von Schaltflächen, Blöcken und Regionen in Drupal mit der deutschen Übersetzung abzugleichen.

Im obigen Beispiel z. B. Ist die benannte Schaltfläche - None - folgendermaßen übersetzt

https://localize.drupal.org/translate/languages/de/translate?sid=2760

Damals, beim ersten Versuch den User guide zu übersetzen haben wir schnell festgestellt, dass es nicht einfach wird. Vor allem, solange das Drupal Kernsystem nicht vollständig übersetzt ist. Das haben wir mittlerweile geschafft.

Wenn ich es jetzt noch schaffe den User guide soweit vorzubereiten, dass jemand eine Datei wie oben mit einem entsprechend vorbereiteten Texteditor öffnen und die reinen Textstellen übersetzen kann, dann haben wir es fast.

Durch die Vorschau, die du oben Rechts im Editor siehst, ist jedem eine optische Kontrolle der Änderung möglich.

Es sollte also wirklich jeder, der möchte das Benutzerhandbuch auf Drupal.org übersetzen können.

Trotzdem sollte man den Userguide nicht unnötig zerreißen, sondern stattdessen die 103 Txt-Dateien aufteilen und genau wie oben gezeigt übersetzen. Dann sieht die Übersetzerin, der Übersetzer nämlich recht schnell, wenn er z. B. die oben im Quelltext befindliche Tabelle ruiniert.

Vielleicht bin ich Sonntag schon nicht mehr bei den Blöcken, sondern bei der Installation. So viel Text ist jetzt wirklich nicht im Buch.

Am Ende des Ganzen müssen wir dann noch Screenshots machen und Balu und Jennifer Bescheid geben, dass die Übersetzung fertig ist und dann kann das Dokument neu gerädert und damit auch auf Deutsch zur Verfügung gestellt werden.

Die von dir vorgeschlagen Änderungen sind auf diesem Wege übrigens nicht ganz so einfach möglich. Wenn die Grundversion des Guides übersetzt ist, kann man eine erweiterte Version zusammenbauen, die außerhalb von Drupal.org gehostet wird.

Ich glaube aber nicht, dass sich Diagramm-Grafik, wie sie dir vorschwebt direkt im Original-Projekt in 115 Sprachen übersetzen lässt.

Man darf auch nicht vergessen, das es sich bei der Übersetzung des Benutzerhandbuchs um einen Modellversuch handelt, von dem abhängen wird, ob und wie die gesamte Dokumentation auf Drupal.org zukünftig Übersetzt werden wird. Darum sollten wir versuchen uns an das zu Halten, was von dort vorgegeben wird, um diesen Prozess voranzutreiben.

Ich habe jetzt 15 von 103 Dateien frisch übersetzt., ohne auf bereits vorhandene Dateien au früheren Versionen zurückzugreifen.

Das sind rund 14,6 % in nicht mal 24 Stunden.

Nach dieser Rechnung dauert das Übersetzen des Handbuchs also knapp 8 Tage.

Danach müssten wir dann korrigieren und dann Bilder machen und so.

Geschätzte Gesamtbearbeitungszeit. 3 Wochen.

Jemand der mehr Zeit als ich hat, weil er mit Drupal sein Geld verdient, und der für das Projekt 2 -3 Mitarbeiter abstellt, ist das Ganze sogar in noch kürzerer Zeit zu schaffen,

Die Rohentwürfe der Übersetzung für folgende Dateien sind bereits fertig:

1. attributions.txt
2. block-conzept.txt
3. block-create.custom.txt
4. block-place.txt
5. block-regions.txt
6. config-basict.xt
7. config-install.txt
8. config-overview.txt
9. config-theme.txt
10. config-uninstalll.txt
11. config-users.txt
12. guide-docinfo.xml
13. understanding-gdpl.txt
14. understanding-project.txt
15. understanding-themes.txt

Diese könnte die Community bereits jetzt korrigieren :D Das ist auch bitter nötig, da die Übersetzung einzelner Konzepte zugegebener maßen bisweilen etwas hölzern klingt:

Hier das Beispiel der understanding-project.txt

Liber Ottmar, liebe Community, ihr seht also.

Wenn sich für dieses Thema jemand erwärmen würde, außer Ottmar und mir, oder bereits erwärmt hätte, könnte der User-Guide auf Drupal.org Neueinsteigern längst zur Verfügung stehen.

Bevor mir hier noch einer meckert, wie schlecht die Welt doch ist und das Drupal 8 gemein sei und er jetzt lieber zu Wordpress, Backdrop oder Joomla geht, um seine Kunden zu bedienen, soll er lieber mal mithelfen, solche Dokumentationen ins Deutsche zu übertragen, um die Abwanderung aus der Community mittels einfach verständlichen Tutorials und Dokumentationen zu Drupal 8 aufzuhalten und Neueinsteiger zu motivieren den Weg zu Drupal 8 zu finden.

Vielleicht versteht der ein oder andere das neue Drupal 8 mittels solcher Arbeiten am Ende sogar ein Stückchen besser als bisher.

Zu eurer aller Verteidigung, nur für den Fall, dass sich jetzt jemand wiedererkennt und persönlich angegriffen fühlt, muss ich aber eines sagen.

Als dann klar wurde, dass keine Übersetzungssoftware der Welt AsciiDoc Code richtig auslesen und aus Dokumenten abstrahieren kann, war die Euphorie ganz schnell wieder vorbei. Das will ja eh keiner machen, hieß es da.

Mal ehrlich hätten wir uns damals schon mit zwei drei Leuten hingesetzt und trotz ASCII-Doc Kodierung und aller neuen Technik zum Trotz das ganze einfach Satz für Satz und Datei für Datei abgetippt, hätten wir schon längst eine Übersetzung des Handbuchs auf Drupal.org ins Deutsche fertiggestellt.

Ihr seht also, auch wenn meine Kommentare und Beiträge im Forum bisweilen etwas bissig formuliert sind.

Auch ich und alle, die Drupal regelmäßig mit frischen Übersetzungen versorgen sind offensichtlich ab und an ein wenig faul und verstecken uns lieber hinter der Suche nach der perfekten Lösung, statt einfach zu machen.

Kommt alle ein bisschen mehr ins Tun und ein bisschen mehr weg von MiMiMi, dann klappt's auch mit Drupal 8 und 9 noch. Trotz Composer, Kommandozeile und AsciiDoc. Gerade Hobyisten, die sich ja hier im Forum gerne mal negativ darüber äußern, dass das neue Drupal nur noch was für Agenturen, Medienhäuser und große Firmen sei, können gerade in Punkto Dokumentation und Marketing jede Menge tun.

Ich kann's euch doch auch nur vormachen :-D

Wer mag, kann sich beispielsweise auch folgender Initiative anschließen https://www.drupal.org/community/promotedrupal

Nur für den Fall, dass ihr Englisch langweilig findet und lieber mit Photoshop und Adobe InDesign tolle Marketing-Materialien für eure potenziellen Kunden anfertigen wollt. Jetzt wäre der richtige Zeitpunkt.

Ottmar, wie weit bist du denn mit deinen Forschungen bezüglich dieser komplizierten Technik namens Ascii-Doc bis jetzt gekommen? Ich hoffe, es hilft dir, dass ich meine Ausführungen minimal ausgebaut habe

Lieber Joachim,

nochmals spreche ich meinen Respekt aus, für die enorme Leistung, die Du in Bezug auf das o.g. Thema leistest! Schon aus diesem Grund werde ich gerne bei der Übersetzung helfen. Leider hat sich für heute kurzfristig Besuch bei mir angesagt, sodass mein Plan, heute volle Kanne mitzumachen, nicht funktioniert. Aber, wie sieht´s bei Dir morgen aus? Ich freue mich, wenn wir uns morgen kontaktieren können und Du mir am Telefon oder per Computer zeigst, wie ich sofort, ohne große technische Voreinstellungen, einsteigen kann. Ich versuche, in der nächsten Woche soviel wie möglich an anderen Verpflichtungen abzusagen, damit wir, hoffnungsfroh wie ich bin, das Wichtigste vielleicht bis Ende der kommenden Woche geschafft haben. Was hältst Du denn von der Idee, dass ich mich hauptsächlich auf die Übersetzung des Textes konzentriere und Du das "Feintuning" und die technische Umsetzung übernimmst? Hat sich noch jemand anderes für eine Mitarbeit zur Verfügung gestellt? Ich meine auf einem anderen Thread, den ich leider nicht mehr finde, einige Meldungen von Drupalanern gesehen zu haben. Falls ich mich getäuscht habe - wie können wir das Thema "Übersetzung" in unserer Community bekannter machen um mehr Unterstützung zu bekommen? Insbesondere im Hinblick auf die Erweiterungen, die wir geplant haben. Wie auch immer - ab morgen bin ich bereit loszulegen. Ich freue mich, wenn Du mir mitteilst, wann wir uns koordinieren können.

Ruh Dich jetzt aus, lieber Joachim, nächste Woche werde ich Dir schwer auf die Nerven gehen! - Aber immer im Sinne eines super Ergebnises!

Ottmar

Na dann. Bevor du mir aber Löcher in den Bauch fragst, lies bitte erst mal diese Anleitung

Lieber Joachim,
ich bin Deiner Anleitung gefolgt. Das Programm ist entsprechend auf meinem Computer installiert, allerdings kann ich es nicht wieder öffnen, nachdem ich es wie beschrieben geschlossen habe. Es liegt in . . . (siehe Anhang). Ich habe leider zu viel zutun, um mich damit zu beschäftigen, wie das Programm wieder geöffnet wird.
Ottmar

Lieber Ottmar, verwende doch bitte einfach die Verknüpfung in deinem Startmenü dazu.

Das habe ich selbstverständlich schon versucht. Ergebnis .... siehe Anhang
Ottmar

Das bedeutet Grundsätzlich, dass deine Windows-Version vom angesprochenen Bug betroffenen ist.

Grundsätzlich kann man in diesem Fall nur folgendes tun.

Den Prozess des Atom Editor beenden. Wenn zu technisch, Rechner aus und wieder an.

Das Verzeichnis .Atom im Verzeichnis deines Benutzerprofile löschen

Die Installation des AsciDoc-Moduls wiederholen und hoffen, dass die Adonn-Kacheln nach Abschluss der Meldung alle grün werden.

Ich habe hier auch nur öffentliches WLAN mit entsprechend niedriger Down/Upload-Rate. Im Ergebnis passiert genau das gleiche. Dateien werden nicht vollständig heruntergeladen und entpackt und fertig ist der Salat.

Einfach bei Gelegenheit den oben genannten Ordner wie beschrieben löschen und noch Mal machen.

Diesmal aber ohne den Editor während der Installation der Add-ons zu schließen und mit etwas beten. Dann wird's gehen

Lieber Jocahim,
es tut mir wirklich leid, aber ich habe heute fast den ganzen Tag damit verbracht, Atom ordnungsgemäß zu installieren. Es ist mir auch gelungen, die Datei herunterzuladen und einmal mit Atom zu öffnen. Allerdings fehlt mir jetzt jeder Hinweis wie ich die heruntergeladene Datei bearbeiten soll, ohne etwas zu zerstören. Auch funktioniert die Vorschau nicht, bzw. sie läßt sich zumindest nicht von mir nicht öffnen.

Ich hätte Dir wirklich gern bei der Übersetzung des Benutzerhandbuchs gehölfen, aber ich ärgere mich, wenn ich meine Zeit für die Lösung von für mich nicht überschaubaren technischen Probleme einsetzen soll, statt einfach nur zu übersetzen. Bitte fasse das nicht als Vorwurf an Dich auf! Offensichtlich liegt das Problem bei mir und meinem Computer.

Bis bald,
Ottmar

Oh weh. Ich kann gerne versuchen meinen Teamviewer abzuschneiden und das Problem zu lösen.

Lieber Joachim,
Nachdem ich meinen Computer neu gestartet habe, funktionieren jetzt einige Dinge bei Atom, die vorher nicht geklappt haben. Testhalber habe ich anschließend etwas in dem bereits übersetzten Text berichtigt. Auch das hat funktioniert - hoffe ich jedenfalls - und ich hoffe, dass es entsprechend gespeichert ist. Dabei ist mir jedoch aufgefallen, dass es eigentlich irgendwo eine Anleitung zur Übersetzung geben müsste. Zum Beispiel: Website ist ein englisches Wort, dass eigentlich mit Webseite übersetzt werden sollte. Oder gibt es die Anleitung Website beizubehalten, weil es als eingedeutschtes Wort behandelt werden soll?. Oder: Innerhalb eines normalen Textes soll der Doppelpunkt verwendet werden, aber in einer Überschrift (Zum Beispiel: Ziel:) nicht?. Ähnliche Fragen tauchen auf, wenn es um kursive, farbige Schrift oder auch die Schriftgröße geht. Nach meinem Dafürhalten sollte es einen "Checker" oder auch "Maintainer" geben, der ausschließlich auf die Formalien achtet. Andere können sich so ausschließlich um das Vokabular und die Grammatik kümmern. Wie also, ist es organisiert?
Ottmar

Die gibt es auch Ottmar. Sie bezieht sich allerdings auf die Übersetzung der Benutzeroberfläche von Drupal ins deutsche. Auf diese Benutzeroberfläche bezieht sich am Ende das Handbuch. Fachbegriffe findest du im Glossar.

Übersetze einfach Mal eine Datei.

Die sehe ich mir dann sehr gerne an.

Abgleichen muss das dann sowieso ein Übersetzer, der den Überblick hat, sonst musst du das hier vorher auch noch inhalieren.

localize.drupal.de

Das Glossar findest du auch über diesen Direktlink:

https://docs.google.com/spreadsheets/d/1JGZWWUQGBsXg30aax-0-yQM_KW8vZs9n...

Organisiert ist das ganze wie folgt.

Farben und Design kommen komplett über CSS aus den USA. Das Handbuch sieht hinterher genauso aus, wie es das aktuell auf Drupal.org tut.

In Überschriften sind alleine schon aus Gründen der Grammatik ganz selten Doppelpunkte. Hier fällt mir keine Stelle ein, an der das der Fall wäre.

Wichtig ist nur, dass du die Verweise auf Teile der Ui vorerst Englisch lässt, damit wir diese nachher mit der Benutzeroberfläche abgleichen können. So ist der Text später stimmig zu den Screenshots.

Natürlich hast du noch weitere Fragen. Diese kann man am Besten beantworten, wenn du eine Datei übersetzt. Dann kann man an Hand dieser Übersetzung Feedback geben.

Ich hoffe die Installation der ASCII Doc Vorschau hat inzwischen geklappt.

Ansonsten kann ich immer noch versuchen, von hier aus Teamviewer anzuwerfen.

Lieber Joachim,

mein Optimismus im Hinblick auf die Nutzung von Atom ist leider verflogen. Ich musste feststellen, dass Atom sicher ein super gutes Tool ist, allerdings muss ich mich damit länger befassen, um es einigermaßen sicher zu beherrschen. Zum Beispiel habe ich soeben festgestellt, dass Atom auf meinem Rechner immer noch nicht richtig installiert ist. Ich müßte also nochmal bei Null anfangen. Wenn ich so weitermachen würde, bräuchte ich die von mir freigeschaufelte Woche nur für die Einstellung der richtigen Umgebung. Dafür, lieber Joachim, ist mir meine Zeit zu schade, da ich Atom wahrscheinlich, außer für diese Projekt, nicht mehr nutzen muss. Tut mir leid, Joachim; aber so ist das mit mir als Neueinsteiger. Vielleicht sollte irgendjemand von Drupal die Anleitungen nochmal überarbeiten und zumindest die Schritte beschreiben, die man benötigt um die Arbeitsumgebung richtig einzustellen.
Wenn es gelungen ist, eine stimmige Installationsanweisung und eine ausreichende Beschreibung für die Bearbeitung des Projekts zu erstellen, bin ich selbstverständlich wieder am Start.
Bis dahin,

Ottmar

Ok Wir machen im April eine Schritt für Schritt Anleitung in Bild und Ton.

Lieber Joachim,
ich bin heute vom Land nach Berlin in die Stadt gefahren. Da es mir keine Ruhe gelassen hat, dass ich gestern eine einfache Installation nicht hinbekommen habe, habe ich den Versuch hier, in Berlin, nochmal wiederholt - und siehe da, diesmal hat alles perfekt funktioniert. Ohne eine Entschuldigung für mich finden zu wollen, vermute ich einfach mal, dass ich die Downloadschwierigkeiten aufgrund von immer wieder auf dem Land auftauchenden Netzschwankungen bekommen habe, die diesmal witterungsbedingt stärker als gewöhnlich waren.
Wenn nicht wieder eine unvorhergesehene Schwierigkeit auftaucht, werde ich also morgen endlich mit Übersetzungen anfangen.
Muss ich noch irgendwas beachten, wenn ich einen englischen Text übersetzt und gegen den deutschen Text im Editor ausgetauscht habe? (Irgendeine Speicherung?)
Also, Joachim, hoffentlich pack ich´s jetzt!
Ottmar

Schwierige generelle Frage. Du solltest beim Übersetzen in jedem Fall die AsciDoc-Vorschau benutzen, damit du z.B. Tabellen nicht aus Versehen Kaputtschiest. Am besten machst du wirklich erst Mal 1 Datei und guckst dir an, wie die Vorschau sich Ändert, wenn du nebendran tippst.

Lieber Joachim,
ich habe heute Nachmittag ein paar Dateien übersetzt. Da es diesmal ein klein wenig mehr Arbeit war, bitte ich Dich, einmal nachzusehen, ob der Text ordentlich rüberkommt. Die Nacharbeit/Feintuning des Textes habe ich noch nicht vorgenommen. Ich bin bis "extend-maintenance.txt" gekommen. Antworte bitte direkt wenn Du dies liest, da ich Atom auflasse bis Du mir die Information gibst, wie ich die Datei speichern soll (Datei>speichern als //oder einfach nur Datei >beenden). Ich hoffe auf kurzfristige Antwort!
Ottmar

Gelesen und angerufen.

Lieber Joachim,

heute bin ich bis zur Datei "install prepare.txt" gekommen und mache morgen mit der Datei "install requirements.text" weiter.

Die Übersetzung ist eine reine Fleißarbeit. Deshalb wundere ich mich sehr darüber, dass von all den Drupalnutzern, die auf dieser Seite schreiben, niemand bereit ist, für diese Aufgabe einmalig ein bisschen Zeit zu opfern. Nach Deinen Informationen, liegt die Übersetzungsarbeit bereits seit 2 Jahren unberührt in der Schublade. Wenn jeder, der auf dieser Seite Hilfe inanspruch nimmt, einmalig 2 bis 3 Stunden Übersetzungsarbeit leistet, ist der Fisch doch ruckzuck gefangen!
Abgesehen davon halte ich unsere Inaktivität für eine Respektlosigkeit gegenüber denjenigen, die eine wahnsinnige Arbeitsleistung dieser Community zur Verfügung gestellt haben. Wir sind nicht mal in der Lage, innerhalb von 2 Jahren eine simple Übersetzung dieser Arbeit hinzubekommen. Ist das denn wirklich wahr?

Joachim, kennst Du nicht den einen oder anderen engagierten Drupalaner, der mir entgegenarbeiten kann?

Ich hoffe, auf gute Nachrichten!

Ottmar
PS: Kannst Du unser langes Geplänkel am Anfang unseres Thread löschen, sodass jeder, der auf den Thread trifft, gleich weiß was der aktuelle Stand ist und sich einen Ruck gibt, mitzuhelfen?

Äm nein. Aber wenn du hier kurz sagst, ab welchem Beitrag es deiner Meinung nach Sinn macht, sind BV oder wla bestimmt so nett und verschieben den Issue noch mal.

Was du versuchen kannst, wenn du hier niemand findest, ist einen Issue auf localize.drupal.org zu öffnen. Vielleicht mag dort jemand helfen.

Falls du Hilfe dabei brauchst. Hier gucken.

https://vimeo.com/266179656

Und ansonsten gerne mich fragen.

Lieber Joachim,

bin leicht partygeschädigt. Mach jetzt Feierabend und morgen bei "language-cont-config.txt" weiter.

Ottmar

Ja klar, gerne! Ab wo soll ich es "abschneiden"?

Lieber Björn,
entschuldige bitte die späte Rückmeldung. Ich habe wegen der Beantwortung Deines Hilfsangebots etwas falsch verstanden.
Aber ich habe auch eine gute Nachricht: Der Text für das Benutzerhandbuch ist jetzt übersetzt. Joachim ist so lieb und überrbeitet die Datei nochmal inhaltlich und setzt die deutschen Konfigurationselemente ein. Wenn das auch erledigt ist, könnte meiner Meinung nach das Handbuch in deutscher Sprache an entsprechender Stelle verlinkt werden. Ob der Thread jetzt noch veröffentlicht werden muss, weiß ich nicht, da ich mich mit den internen Gepflogenheiten von Drupal nicht auskenne. Vielleicht macht Joachim einen neuen Thread wegen der Idee zu Diagrammen und Videos auf. Sicher wird er sich bald mit Dir in Verbindung setzen.
Lieber Björn, ich danke Dir für Deine Unterstützung!
Ottmar

Ich mache selbstverständlich gerne auch einfach ein neues Thema auf.

Wenn ich könnte, würde ich das Teil hier als gelöst markieren.

Ottmar, du bist jedenfalls der Wahnsinn. 104 Seiten Benutzerhandbuch übersetzen in knapp 2 Wochen. Das hat nicht mal das Team der deutschen Übersetzer auf localize.drupal.org in den vergangenen 2 Jahren geschafft und dass, obwohl dort über 600 aktive Benutzer Interesse daran bekunden Drupal ins Deutsche zu übertragen.

Sobald ich eine Zusammenfassung der berühmten Fragen
Wer?
Was?
Warum? und
Wiso?

gefunden habe, mach ich ein neues Thema auf und verlinke es in diesem Kommentar.

Vielleicht können wir so doch noch den ein oder anderen bewegen, sich hier zu beteiligen.

Lieber Jochaim,
vielen Dank für Dein tolles Kompliment!
Es war so: Ich war jung und brauchte den Spaß!
- Und deshalb würde ich es wieder machen!
Bis dahin,
Ottmar