Kapitel Computeraufnahme: Tutorial für git :)

Hallo,

problem: die Computeraufnahme kommt häufiger vor:
http://docs.linuxmuster.net/de/latest/howtos/windows10clients/registration.html
http://docs.linuxmuster.net/de/latest/howtos/linuxclients/registration.html

ich würde vorschlagen, sie vor “Linux Clients” als eigenes Kapitel aufzunehmen:
http://docs.linuxmuster.net/de/v7/getting-started/linuxclients/registration.html

Die Standardvorgehensweise sollte über die neue Schulkonsole sein.
@Maurice + @Kai haben gemeint, das Design für die LINBO-Konfiguration in der WebUI würde sich nicht mehr (stark) zwischen jetzt 6.2 und 7.0 ändern, so dass dieses Kapitel schon schreibbar wäre.

Möchtest du, @alois, das übernehmen?
du müsstest also die WebUI in einer 6.2 installieren und dann den Teil mal (mit wenigen Screenshots) neu zu schreiben.

Wenn du es mit GIT+Sphinx/rST machst, erstelle einen Pull-Request bezüglich https://github.com/linuxmuster-docs/main/tree/v7, ansonsten schicke mir das ODT und ich versuche das einzubauen und wir werden sehen, wieviel Overhead das für mich ist.

VG, Tobias

p.s. lass uns Fragen, die du hast, einfach hier diskutieren.

Hallo Tobias,

okay, machen wir.

Ich habe kürzlich versucht die Webui in 6.2 zu installieren. Es ist mir
nicht gelungen. Ich versuchs noch einmal und melde mich.

Gruß

Alois

1 „Gefällt mir“

Hallo Tobias,

die Webui ist installiert. Ich werde versuchen die Rechneraufnahme mit der
neuen Webui zu dokumentieren.

Gruß

Alois

1 „Gefällt mir“

Hi @alois,

in diesem Thread ist deine Frage besser aufgehoben:

ich finde das jetzt etwas umständlich, weil ich nicht weiß in welchem Zustand dein ubuntu 16.04 ist.

Abergut:
http://docs.linuxmuster.net/de/latest/appendix/contribute/docs/new.html#manuelle-installation-ubuntu
hier steht ja, was installiert werden muss, und welche ersten Schritte du gehen musst.
Wenn das soweit bis inklusive
http://docs.linuxmuster.net/de/latest/appendix/contribute/docs/new.html#linuxmuster-dokumentation-forken
funktioniert, müsste auf deiner konsole so was auch so aussehen:

linuxadmin@lmn-docs:~/my-docs$ git branch -l
* master
linuxadmin@lmn-docs:~/my-docs$ git branch -l -a
* master
  remotes/origin/HEAD -> origin/master
  remotes/origin/basiskurs
  remotes/origin/master
  remotes/origin/v7

mehr folgt.

Hallo Tobias,

genau so sah das jetzt bei mir aus.

Gruß

Alois

Jetzt, wie du den Zweig v7 dir holst:

  • erstellen von branch v7 (einmalig):
linuxadmin@lmn-docs:~/my-docs$ git branch v7
  • in den branch v7 wechseln (das kann man immer machen)
linuxadmin@lmn-docs:~/my-docs$ git checkout v7
Zu Branch 'v7' gewechselt
  • dem git sagen, von welchem branch bei github.com er die Daten nach “v7” holen soll:
linuxadmin@lmn-docs:~/my-docs$ git branch --set-upstream-to origin/v7 v7
Branch v7 konfiguriert zum Folgen von Remote-Branch v7 von origin.
  • zuletzt anschauen, wie die zweige lokal und remote jetzt aussehen
linuxadmin@lmn-docs:~/my-docs$ git branch -l -v -a
  master                   f15b786 Merge pull request #142 from lmn-docs-bot/master
* v7                       f15b786 [20 voraus, 35 hinterher] Merge pull request #142 from lmn-docs-bot/master
  remotes/origin/HEAD      -> origin/master
  remotes/origin/basiskurs f9b3c97  test change for git
  remotes/origin/master    f15b786 Merge pull request #142 from lmn-docs-bot/master
  remotes/origin/v7        ec8d4af Merge pull request #133 from jollyzsher/v7

Weil mein branch v7 jetzt einiges abweicht von dem wie linuxmuster-docs/main.git und dessen branch v7 aussieht, befolge ich die anweisungen in der Doku:
http://docs.linuxmuster.net/de/latest/appendix/contribute/docs/new.html#den-eigenen-fork-aktualisieren

das geht bei mir aber schief, weil es wirklich um einiges abweicht, sollte bei dir nicht schief gehen, wenn du soeben erst das git clone gemacht hast…

vG, Tobias

Hallo Tobias,

sah alles genau so aus, wie oben beschrieben.

Gruß

Alois

Hallo Alois,

gut,dann kannst du die v7-Doku bauen:

make html
xdg-open build/html/index.html

Das sollte die v7-Doku im Browser anzeigen.
VG, Tobias

Dann läge die Aufgabe darin, die source/index.rst zu editieren und das Kapitel eigenständig zu machen:

.. toctree::
  :maxdepth: 2
  :caption: Erste Schritte

  getting-started/prerequisites/index
  getting-started/install-on-xen/index
  getting-started/registration/index
  getting-started/linuxclients/index
  getting-started/add-user-accounts/index

und ein Verzeichnis registration zu erstellen und die datei registration.rst nach index.rst zu verschieben, per git geht das so:

linuxadmin@lmn-docs:~/my-docs$ git mv source/getting-started/linuxclients/registration.rst source/getting-started/registration/index.rst

Jetzt musst du noch den Verweis auf die registration.rst in der anderen linuxclients/index.rst rausnehmen, weil sonst das make html fehlschlägt…

Nach einem jetzigen make html sieht das bei mir so aus:

VG, Tobias
Hei: Discourse ist geil, ich habe das Bild direkt aus der Zwischenablage gepasted, wow!

Hallo @alois,

Tutorial zu git die zweite:
Bevor du weitermachst, könntest du den jetzigen Schritt commiten und pushen und einen Pull-request erstellen, wie es hier steht:
http://docs.linuxmuster.net/de/latest/appendix/contribute/docs/new.html#dokumentation-andern-oder-neu-erstellen

Ich mach das mal, um nachzuvollziehen ob das klappt:

  • Status anzeigen:
linuxadmin@lmn-docs:~/my-docs$ git status
Auf Branch v7
Ihr Branch ist auf dem selben Stand wie 'origin/v7'.

zum Commit vorgemerkte Änderungen:
  (benutzen Sie "git reset HEAD <Datei>..." zum Entfernen aus der Staging-Area)

	umbenannt:      source/getting-started/linuxclients/registration.rst -> source/getting-started/registration/index.rst

Änderungen, die nicht zum Commit vorgemerkt sind:
  (benutzen Sie "git add <Datei>...", um die Änderungen zum Commit vorzumerken)
  (benutzen Sie "git checkout -- <Datei>...", um die Änderungen im Arbeitsverzeichnis zu verwerfen)

	geändert:       source/getting-started/linuxclients/index.rst
	geändert:       source/index.rst
  • neue/geänderte Dateien aufnehmen mit “add” und wieder status anzeigen:
linuxadmin@lmn-docs:~/my-docs$ git add source/
linuxadmin@lmn-docs:~/my-docs$ git status
Auf Branch v7
Ihr Branch ist auf dem selben Stand wie 'origin/v7'.

zum Commit vorgemerkte Änderungen:
  (benutzen Sie "git reset HEAD <Datei>..." zum Entfernen aus der Staging-Area)

	geändert:       source/getting-started/linuxclients/index.rst
	umbenannt:      source/getting-started/linuxclients/registration.rst -> source/getting-started/registration/index.rst
	geändert:       source/index.rst
  • Ich habe dir ein Ticket erstellt: https://github.com/linuxmuster-docs/main/issues/145 somit kannst du bei einem commit darauf verweisen. Die vielen Hinweise sollte man sich zu Herzen nehmen und git config --global user.name "Tobias KÜchel" usw. ausführen.
linuxadmin@lmn-docs:~/my-docs$ git commit -a -m"try to fix: https://github.com/linuxmuster-docs/main/issues/145 moving the chapter outside"
[v7 c59274f] try to fix: https://github.com/linuxmuster-docs/main/issues/145 moving the chapter outside
 Committer: Linux Admin <linuxadmin@lmn-docs.lan>
Ihr Name und E-Mail Adresse wurden automatisch auf Basis
Ihres Benutzer- und Rechnernamens konfiguriert. Bitte prüfen Sie, dass
diese zutreffend sind. Sie können diese Meldung unterdrücken, indem Sie
diese explizit setzen:

    git config --global user.name "Ihr Name"
    git config --global user.email ihre@emailadresse.de

Nachdem Sie das getan haben, können Sie Ihre Identität für diesen Commit ändern:

    git commit --amend --reset-author

 3 files changed, 1 insertion(+), 1 deletion(-)
 rename source/getting-started/{linuxclients/registration.rst => registration/index.rst} (100%)
  • DerSTatus ist jetzt:
linuxadmin@lmn-docs:~/my-docs$ git status
Auf Branch v7
Ihr Branch ist vor 'origin/v7' um 1 Commit.
  (benutzen Sie "git push", um lokale Commits zu publizieren)

nichts zu committen, Arbeitsverzeichnis unverändert
  • Jetzt kannst du das mal in dein eigenes Repo bei github pushen:
linuxadmin@lmn-docs:~/my-docs$ git push
Username for 'https://github.com': lmn-docs-bot
Password for 'https://lmn-docs-bot@github.com': 
Zähle Objekte: 8, Fertig.
Komprimiere Objekte: 100% (7/7), Fertig.
Schreibe Objekte: 100% (8/8), 739 bytes | 369.00 KiB/s, Fertig.
Total 8 (delta 6), reused 0 (delta 0)
remote: Resolving deltas: 100% (6/6), completed with 6 local objects.
To https://github.com/lmn-docs-bot/main.git
   ec8d4af..c59274f  v7 -> v7
  • bei github.com nachschauen, wnn du Branch “v7” auswählst, siehst du jetzt, dass der Zweig 1 commit vor linuxmuter-docs:v7 ist. Gut so.
  • Auf “New pull request”, dann auf “Create pull request”,dann wechselt die Seite automatisch zum Repository von linuxmuster-docs:v7 und zeigt an, ob der Request gemerged werden kann und die checks laufen noch durch:

Das Gute daran ist: andere können denPull-request “reviewen”, d.h. auch anschauen und rückmeldung geben, ob das so ok ist.

Außerdem kanns du jetzt mit dem Arbeiten weitermachen: editieren, commit, push. Jedesmal wenn du ein push absetzt werden alle commits darin an den Pull-request dran gehängt.
Du solltst also am besten nur commits zu einem thema (hier: computeraufnahme) machen, nicht noch gleichzeitig Rechtschreibfehler anderswo editieren…

Hoffe, das half, mei post ist inzwishen so lang, dass discourse nicht mehr alle meine tatatur-befehle annimmt…

VG; Tobias

Hi @alois,

hier das vorläufige Zwischenergebnis:

  • deine Anleitung habe ich bezüglich des Zweigs “v7” erstellt, commited und in meinem Konto gepushed
  • die Änderungen bezüglich Zweig “v7” habe ich dann einen Pull-Request erstellt: https://github.com/linuxmuster-docs/main/pull/147
  • In diesem Zustand werden checks gemacht, ob die Dokumentation richtig kompiliert etc. falls nicht, dann muss man noch verbessern und wieder pushen.
  • In diesem Zustand kann man auch noch “review” machen, d.h. über den Code schauen und z.B. bemängeln, wenn einem etwas nicht passt. Dann muss man nochmal ran, bevor der PRequest angenommen (merge) wird.
  • Ich nehme den Pull-Request jetzt mal an, damit wir das Ergebnis anschauen können.

Ergebnis: http://docs.linuxmuster.net/de/v7/

ÄVG, Tobias