Trauriger Zustand des deutsches Installations-Handbuchs

mike155

Das deutsche Installations-Handbuch

https://wiki.gentoo.org/wiki/Handbook:AMD64/Full/Installation/de

ist in einem traurigen Zustand. Alles, was rot unterlegt ist, muss überarbeitet werden. Und das ist eine ganze Menge!

Ich erkläre mich bereit, einen Teil davon zu überarbeiten - und habe mich heute als Translator angemeldet. Ich würde es toll finden, wenn noch ein paar mehr Leute mitmachen! Wenn jeder ein paar Abschnitte (neu) übersetzt, sollten wir das recht schnell hinbekommen!

Wer hat Lust und macht mit?

ManfredB · Veteran Joined: 27 Dec 2007 Posts: 1609

Kleiner Hinweis:

In der Basis-Installation (chroot-Umgebung) kommt ein Programm vor,
das syklogd heißt. Da fehlt eine kleine Ergänzung:

mkdir /var/log/news

Wird das nicht gemacht, kommt beim Boot-Vorgang immer die Meldung, daß dieses Verzeichnis fehlt
und sysklogd deshalbt nichts speichern kann.

Wie gesagt, nur ein winziger Hinweis.

Gruß
Manfred

LuxJux · Posted: Thu Oct 31, 2019 7:40 pm Post subject:

Abhängig vom Installationsmedium, benötigen Sie zum Download eines Stage Tar-Archivs nur einen Web-Browser

( Edit: Diese Zeile sollte einfach gelöscht werden. Danke. )

Welche LIVE chrootet sollte egal sein (AMD64)

Die LIVE sollte jedoch gentoo-sysrescue-calculate kompatibel sein.

SABAYON ist nicht zu empfehlen, da systemd und rc und überhaupt alles nur EierPfannenKuchen zusammenquervermischt ist

mike155 · Posted: Thu Oct 31, 2019 10:47 pm Post subject:

@manfredB und @LuxJux,

Danke für Eure Hinweise! Ich werde versuchen, das zu berücksichtigen. Das ist aber nicht ganz einfach, weil ich übersetze - und nicht inhaltlich arbeite. Änderungen müssen in der englischen Version eingepflegt werden - und das liegt nicht in meinem derzeitigen Fokus.

mike155 · Posted: Thu Oct 31, 2019 10:48 pm Post subject:

Es ist offensichtlich, dass das deutschsprachige Handbuch seit einiger Zeit nicht mehr gepflegt wurde. Es ist also viel zu tun. Viel mehr, als ich leisten kann.

Ich habe daher beschlossen:

Ich werde mich nur um die deutsche Übersetzung des AMD64 Handbuchs kümmern. Ich möchte, dass das richtig gut wird! Um die Übersetzung der Handbücher der anderen Architekturen werde ich mich nicht kümmern. Glücklicherweise werden diese Handbücher durch Arbeiten am AMD64 Handbuch auch besser, weil das Wiki mit einem gettext-ähnlichen System arbeitet. Nichtsdestotrotz müsste jemand die Übersetzung der Architektur-spezifischen Teile dieser Handbücher überarbeiten.
Innerhalb der deutschen Übersetzung des AMD64 Handbuchs werde ich mich nur um den ersten Teil ("Gentoo installieren") kümmern - für die anderen 3 Teile ("Arbeiten mit Gentoo", "Arbeiten mit Portage" und "Gentoo Netzwerk-Konfiguration") liegen nur wenige Übersetzungen vor und es wäre sehr viel Arbeit, das alles nach Deutsch zu übersetzen.

Ich finde es auch nicht schlimm, wenn die anderen 3 Teile auf Englisch bleiben und wir die deutsche Übersetzung aufgeben. Eine rein englische Version ist jedenfalls besser, als Seiten, bei denen sich englischer und deutscher Text abwechseln und bei denen größere Teile mit rosa-roter Farbe unterlegt sind.
In der deutschen Übersetzung des AMD64 Handbuchs kümmere ich mich zuerst um Namen, Titel, Verlinkungen und die Darstellung der Seiten. Hier stimmt einiges nicht.

Generell habe ich den Eindruck, dass wir Teile der deutschen Übersetzung aufgeben sollten. Es gibt nichts Schlimmeres als Seiten, die mal übersetzt wurden und deren Pflege dann aufgegeben wurde. Sie rotten vor sich hin, die Informationen sind veraltet und man kann nur hoffen, dass das keiner liest und sein System danach konfiguriert...

ManfredB · Veteran Joined: 27 Dec 2007 Posts: 1609

Hallo mike155,

dafür kann ich nur ganz herzlichen Dank sagen, denn dieses deutsche AMD64-Handbuch nutze ich seit vielen Jahren.

Inzwischen weiß ich viele der dort beschriebenen Schritte schon zu einem großen Teil auswendig.

Dennoch bleibt es - wenn ich in der chroot-Umgebung arbeite immer als Begleiter bei mir.

Klar: es gibt den einen oder anderen Punkt, der aktualisiert werden könnte/müßte.

ZB: eselect profile list ist noch nicht auf 17.1 umgestellt, obwohl das schon seit Wochen Standard ist.

Und /var/log/news - das habe ich immer im Boot-Vorgang gesehen, daß ksyslogd dieses Verzeichnis nicht findet.

Ich werde noch einmal genauer ins Handbuch schauen und mir eventuell noch auffallende Probleme melden,
wenn das recht ist.

Jedenfalls unterstützte ich das Vorhaben der Überarbeitung sehr gerne, auch wenn ich - was die Übersetzung aus dem Englischen angeht, ich nicht mehr so gut darin bin.

Liebe Grüße
Manfred

P.S. Noch etwas fällt mir gerade ein:
Mir wird, wenn ich auf Konsolen-Basis arbeite, immer wieder einmal der Hinweis gegeben,
daß /dev/xconsole nicht vorhanden ist. Und das sowohl auf meinem Notebook als auch auf meinem PC.

LuxJux · Posted: Fri Nov 01, 2019 9:25 pm Post subject:

Nachdem nun wieder Boden unter den Füßen ist
---------------------

LuxJux · Posted: Sat Nov 02, 2019 12:32 am Post subject:

Update:

Nein, das geht nicht. Ohne chroot geht gar nix

mike155 · Posted: Sat Nov 02, 2019 6:08 am Post subject:

So, die Navigation und die ersten Kapitel sind überarbeitet:

Einen merkwürdigen Effekt habe ich allerdings beobachtet. Je nachdem wie ich die Seiten aufrufe, sind die Änderungen nach einigen Sekunden sichtbar - oder auch nicht. Bei der Auslieferung der Seiten sind Caches involviert. Also, es kann durchaus ein paar Stunden dauern, bis Änderungen sichtbar werden...

PS: wenn weitere Kapitel fertig werden, werde ich sie zu der Liste in diesem Post hinzufügen.

ManfredB · Veteran Joined: 27 Dec 2007 Posts: 1609

stage3 entpacken:

genau da steht nur .bz2 und nicht xz.

Gruß
Manfred

mike155 · Posted: Sat Nov 02, 2019 5:47 pm Post subject:

LuxJux · Posted: Mon Nov 04, 2019 12:26 am Post subject:

Download the stage3 from "wget --patse-url" , knrks
_________________
After emerge always reboot

ManfredB · Veteran Joined: 27 Dec 2007 Posts: 1609

Einen Fehler habe ich in einem anderen Thread bereits beschrieben.

Thema: grub

Im AMD64-Handbuch (deutsch) steht nach der Installation von grub:2
emerge --ask --verbose sys-boot/grub:2

grub2-mkconfig -o /boot/grub/grub.cfg FEHLER

Es muss heisse:
grub-mkconfig -o /boot/grub/grub.cfg

Gruß
Manfred

mike155 · Posted: Wed Nov 06, 2019 6:11 pm Post subject:

LuxJux · Posted: Wed Nov 06, 2019 8:57 pm Post subject:

firefly · Watchman Joined: 31 Oct 2002 Posts: 5192

mike155 · Posted: Thu Nov 07, 2019 5:07 pm Post subject:

mike155 · Posted: Thu Nov 07, 2019 9:03 pm Post subject:

Die Übersetzung der ersten Seiten des Handbuchs lief eigentlich ganz gut.

Ein paar kleinere Fehler im englischen Original habe ich gefunden. Ich habe die Probleme dann auf den Diskussionssseiten des Wikis berichtet - und in der Übersetzung versucht, den Fehler zu verbessern. Gelegentlich habe ich auch Boxen mit Anmerkungen zum Text hinzugefügt - wenn ich den Eindruck hatte, dass etwas fehlt.

Das Kapitel "Konfiguration des Systems" ist allerdings anstrengend und das Übersetzen dauert sehr lange! Im englischen Original ist einiges veraltet oder sogar falsch. Bei den Abschnitten über "Filesystem/Partition labels and UUIDs" bin ich am Verzweifeln. Das ist missverständlich. Ich glaube nicht, dass ein Anwender mit dieser Anleitung in der Lage ist, Filesystem/Partition Labels und UUIDs in seiner fstab zu verwenden. Am liebsten würde ich die deutsche Übersetzung weglassen und gleich auf die Arch Linux Seite verlinken - die ist deutlich besser! :-(

ManfredB · Veteran Joined: 27 Dec 2007 Posts: 1609

Ich kann nur noch einmal ein großes Lob und herzlichen Dank aussprechen für diese wirklich umfangreiche und anstrengende Arbeit an dem AMD64-Handbuch.

Nur nebenbei:
Ich habe mich bei einer Neuinstallation von gentoo mit ACCEPT_KEYWORDS="~amd64" anders orientiert:
Das systemd-WIKI beginnt bei der Installation mit Kernel / genkernel und grub:2.

So habe ich es heute auch im Test begonnen und muss sagen, daß das gut funktioniert.
Denn bei der normalen Installation nach AMD64-Handbuch kommt der Kernel erst nach dem
Basis-Update an die Reihe.
Bei diesem Update ist mir immer wieder aufgefallen, daß bei dem einen oder anderen Programm
ein fehlender Kernel gemeldet wurde - ohne Unterbrechung des Installations-Vorgangs (klar),
aber auf meinem eigenen eingeschlagenen Weg kommt eine solche Meldung nicht mehr.

Insofern ist dieser Weg nach meinem Eindruck gar nicht so abwegig.

Aber ich weiß natürlich, daß das englische Handbuch die Regeln vorschreibt bzw. die Ausgangsbasis
für das deutsche Handbuch ist.

In einem deutschen Forum darf so eine Alternative sicher dennoch einmal beschrieben werden,
wenn auch vielleicht nicht gerade hier, wo es im wesentlichen um Übersetzung geht.

Gruß
Manfred

mike155 · Posted: Sat Nov 09, 2019 4:16 pm Post subject:

Hallo Manfred,

danke für den Hinweis und die vorgeschlagene Alternative! ich schaue mir das an - aber zuerst übersetze ich noch die beiden fehlenden Kapitel. :-)

Mit ist allerdings auch aufgefallen, dass das Handbuch bzgl. Systemd nicht optimal (auf gut Deutsch: grottenschlecht) ist. Das Handbuch behandelt nur OpenRC und verweist den Leser dann an einer Stelle auf die Systemd Seite: "wenn Sie Systemd verwenden wollen, machen Sie dort weiter". Das ist zu wenig! Ich glaube sofort, dass das zu Irritation führt, weil auch bei einer Systemd-Installation noch Teile des alten Handbuchs ausgeführt werden müssen.

Ich werde versuchen, an der entsprechenden Stelle eine Info-Box hinzuzufügen mit Tipps zum weiteren Vorgehen. Ich würde Dich bitten, Dir das dann anzuschauen und zu überprüfen, ob es stimmt und wie man es weiter verbessern kann. Wenn Du gerade eine Systemd Installation durchführst, kannst das wahrscheinlich besser beurteilen als ich, denn meine letzte Installation nach Handbuch liegt... 15 Jahre zurück.

Mike

ManfredB · Veteran Joined: 27 Dec 2007 Posts: 1609

Aber gerne schaue ich mir das an.

Übrigens: die systemd-Installation war bei mir schon:
ich bin aber nur nach dem systemd-Handbuch vorgegangen, das - wie beschrieben - mit kernel-Installation beginnt.

Würde ich erst alles vorher aus AMD durchführen, käme es zu Konflikten wegen openrc und systemd.

So habe ich wenigstens nach vielen Versuchen endlich wieder ein funktionierendes systemd-gentoo.

Gruß
Manfred

Nachtrag:
Meine Installations-Alternative ist erfolgreich zu Ende gebracht.
Ich habe bei meiner unstable-Installation immer wieder festgestellt:
sys-devel/gcc-8.3.0-r1 ist mit stage3 geliefert.
Beim Basis-Update in der chroot-Umgebung kommt gcc-9.2.0-r2 als Update.
Dabei wird immer wieder das Update unterbrochen, weil es Programme gibt,
die auf rebuild warten - allerdings noch mit gcc-8.3.0-r1

Ich gehe dann immer so vor:
gcc-config -l
zeigt mir beide Versionen an
gcc-config -f 2
env-update && source /etc/profile
emerge --unmerge "=sys-devel/gcc-8.3.0-r1"

Danach ist der Wunsch nach rebuild weg.

Genau dieser Vorgang hat mich heute dazu gebracht:
Nach eselect profile list
eselect profile set 23 (plasma-desktop) - bei mir.
Bevor ich nun das Update durchlaufen lasse,
installiere ich zuerst
emerge --ask sys-devel/gcc
9.2.0-r2 wird installiert.
Danch kernel, genkernel, genkernel --menuconfig all, grub:2, grub-mkconfig -o /boot/grub/grub.cfg
Den Eintrag aus grub.cfg übernehme ich in meinen ArchLinux-Bootloader (grub.cfg)

Nun folgt das Update und danach gehe ich weiter vor nach AMD-Handbuch mit den Schritten,
die nach diesem Basis-Update beschrieben sind.

Dieses Verfahren ging heute ohne irgendein Problem vonstatten.
Diesen Weg kann ich für die unstable-Installation (ACCEPT_KEYWORDS="~amd64" nur empfehlen.

Ich erspare mir damit einige Unterbrechungen und bin froh, diesen Weg eingeschlagen zu haben.

Gruß
Manfred

mike155 · Posted: Sun Nov 10, 2019 4:12 am Post subject:

Die ersten Kapitel des Handbuchs waren relativ einfach. Hier ist das englische Original in einem hervorragenden Zustand. Die deutsche Übersetzung war zwar teilweise unvollständig, aber fast immer gut. Dadurch habe ich ca. einen Tag pro Kapitel gebraucht. Weiter hinten im Handbuch sind sowohl das englische Original, als auch die deutsche Übersetzung schlechter, so dass ich länger brauche. Für das Kapitel "Konfiguration des Bootloaders" werde ich morgen den dritten Tag investieren. Das liegt zum Teil aber auch daran, dass ich bisher einen großen Bogen um UEFI gemacht habe und nicht wirklich verstehe, was ich da übersetze.

Dafür wird man dann aber auch belohnt mit Sätzen wie:

ManfredB · Veteran Joined: 27 Dec 2007 Posts: 1609

Ich habe heute morgen einmal das AMD64-Handbuch in aller Ruhe durchgelesen.

Sehr gut gemacht, mike155 !!! Hohe Anerkennung !!!

Allerdings etwas, was du nicht zu verantworten hast:

Die Anleitung für Nutzung der mini-install-iso.

Frage: wer nutzt heute dafür überhaupt noch eine CD?
Zwar haben viele neue Computer noch CD-Laufwerke,
aber lohnt sich das wirklich, für so eine mini-iso eine CD zu brennen?

Ich nutze schon seit Jahren nur noch USB-Sticks, denn die mini-iso darauf
zu kopieren, ist der einfachste und schnellste Weg meiner Ansicht nach.

Die Nutzung des Handbuchs während der Installation.
Ich habe 3 Wege für mich, wie ich das Handbuch nutzen kann:
1. Wenn ich von einer bestehenden Gentoo-Installation aus eine neue ausführen will,
nutze ich firefox als Hintergrund von 2 konsolen, eine für die Ausführung, die andere, um den Verlauf mit top
zu verfolgen oder mit mc die eine oder andere Einstellung vorzunehmen.
2. Wenn ich per USB-Stick herangehe, habe ich mein Smartphone mit Chrome, auf dem das Handbuch wunderbar nebenher zu lesen geht.
3. Auch eine ausgedruckte Version des Handbuches habe ich, doch die nutze ich nur noch in Ausnahme-Fällen,
eher seltener.

Gruß
Manfred

mike155 · Posted: Mon Nov 11, 2019 4:13 pm Post subject:

mike155 · Posted: Mon Nov 11, 2019 4:44 pm Post subject: