Siduction Forum

Siduction Forum => Siduction News => Topic started by: scholle1 on 2022/04/13, 00:50:47

Title: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/04/13, 00:50:47
Liebe Leute, hier könnt ihr helfen.
Nachdem in diesem Post https://forum.siduction.org/index.php?topic=8492.0 bereits um Mitarbeit gebeten wurde, nun etwas konkretere Vorschläge.

Hier kann jeder entsprechend seinen Fähigkeiten und Vorlieben mitarbeiten.
Es braucht das Interesse an Linux, die Zähigkeit um nicht gleich aufzugeben, sondern weiter zu probieren und zu testen.
Und es braucht so viel Zeit wie du bereit bist einzubringen. Nicht mehr und auch nicht weniger.

Raffe dich auf, spring über deinen Schatten und melde dich hier oder auf GitHub https://github.com/siduction.

ak-li alias scholle1
Title: Re: Mitarbeit: Jetzt und hier.
Post by: Mister00X on 2022/04/13, 14:00:08
Hi,

erstmal danke für konkrete Vorschläge was gemacht werden kann.

Ich kann mich definitiv an das PDF-Problem setzen, nur kann ich nichts darüber sagen, wie schnell ich da vorankomme. Ich bin momentan wegen eines Todesfalls in der Familie etwas beschäftigt und kann nicht wirklich einschätzen wann ich wie viel Zeit hab.

Ich werde heute Nachmittag/Abend mal einen Blick draufwerfen und schauen, ob es was offensichtliches ist.

Gibt es abgesehen von der Hyperlink-Geschichte in den PDFs noch irgendwas, was in Punkto LaTeX gemacht werden soll/könnte?

Mister00X
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/04/14, 01:01:18
@Mister00X
Danke für deine Unterstützung. Habe es gerade auf Git gesehen und beantwortet.

Quote
Gibt es abgesehen von der Hyperlink-Geschichte in den PDFs noch irgendwas, was in Punkto LaTeX gemacht werden soll/könnte?

Ja, Codeblöcke innerhalb von Listen stechen in den rechten Seitenrand. 
Listen haben eingerückten Text und darin enthaltene Codeblöcke sind genauso breit wie im normalen Text. 
Gut zu erkennen auf Seite 34 des deutsche PDF-Handbuches.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: edlin on 2022/04/14, 14:13:48
1. Kann es sein, dass die Verlinkung im PDF deshalb teilweise fehlerhaft ist, weil nur ein tex-Durchlauf durchgeführt wird? Sprich, beim ersten Durchlauf wird das Dokument generiert und erst in einem zweiten Durchlauf könnten die Links korrekt generiert werden. Nicht getestet, nur ein Anfangsverdacht.
2. rdiff und rsync hängen auf OLD (gut 10 Jahre nicht angefasst). Gibts da Dinge, die angefasst, ergänzt etc. werden sollten oder muss nur alles mal vom Staub befreit werden und bezüglich Aktualität gecheckt werden. Übergeordnetes Kapitel zum Backup erstellen? Andere Werkzeuge ergänzen (partclone u.ä.)?

edlin
Title: Re: Mitarbeit: Jetzt und hier.
Post by: Mister00X on 2022/04/14, 16:51:17
1. Kann es sein, dass die Verlinkung im PDF deshalb teilweise fehlerhaft ist, weil nur ein tex-Durchlauf durchgeführt wird? Sprich, beim ersten Durchlauf wird das Dokument generiert und erst in einem zweiten Durchlauf könnten die Links korrekt generiert werden. Nicht getestet, nur ein Anfangsverdacht.
Nope es war ein LaTeX Paket (titlesec) welches mit dem de-facto Standard für Links in PDFs (hyperref) inkompatibel war.

Hätte pandoc allerdings tatsächlich nur einen {pdf,lua,xe}latex-Durchlauf gemacht anstatt sowas wie latexmk zu benutzen, wäre ich in der Tat etwas enttäuscht gewesen. Hat es aber nicht, also alles gut damit  :)
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/04/14, 19:52:51
@edlin
2. rdiff und rsync hängen auf OLD (gut 10 Jahre nicht angefasst). Gibts da Dinge, die angefasst, ergänzt etc. werden sollten oder muss nur alles mal vom Staub befreit werden und bezüglich Aktualität gecheckt werden. Übergeordnetes Kapitel zum Backup erstellen? Andere Werkzeuge ergänzen (partclone u.ä.)?

Vorgehensweise
Wie es dir beliebt. Meine war bei den alten Dateien so:
- Entstauben, offensichtlich überholtes entfernen.
- Aktualisieren, in Manpages und im Netz suchen.
- Testen, Fehler finden, testen, ...
- Link prüfen (interne und externe)
Dann bist du fast bei RC1 (Siehe https://github.com/siduction/sidu-manual/wiki/DE_Status-der-Handbuchseiten#rc-definition (https://github.com/siduction/sidu-manual/wiki/DE_Status-der-Handbuchseiten#rc-definition)
Wenn du mit der Bearbeitung anfängst, trage das bitte in der gleichen Datei weiter unten ein.

Tipp:
Du hast es mit dem Layout leichter, wenn du die Hinweise im Wiki DE-Home beachtest.
https://github.com/siduction/sidu-manual/wiki/DE_Home#hinweise-f%C3%BCr-autoren (https://github.com/siduction/sidu-manual/wiki/DE_Home#hinweise-f%C3%BCr-autoren)
und bei Unklarheiten ein Issue aufmachst und um Hilfe bittest oder einfach in den fertigen, nummerierten Dateien nachschaust..

Nummerierung, übergeordnete Kapitel
IMHO gehören rdiff und rsync unterhalb 0700. Eventuell bei 0720 starten.
Bei 3 oder mehr Dateien zum Thema Datensicherung wäre ein eigenes Kapitel denkbar.
Das sollten wir gemeinsam mit einem Issue abstimmen.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: Mister00X on 2022/04/14, 20:55:43
Ja, Codeblöcke innerhalb von Listen stechen in den rechten Seitenrand. 
Listen haben eingerückten Text und darin enthaltene Codeblöcke sind genauso breit wie im normalen Text. 
Gut zu erkennen auf Seite 34 des deutsche PDF-Handbuches.

Ganz vergessen, dazu was zu sagen..... ;)
Ich kann mir das anschauen, aber dafür muss ich wirklich erstmal an den von pandoc generierten LaTeX-Code rankommen. Es gibt nämlich verschiedenste Möglichkeiten Codeblöcke in LaTeX zu machen und ich habe keine Ahnung welche pandoc nutzt. Ich werde mir die Tage mal die Dokumentation anschauen, vielleicht find ich da was dazu.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/04/14, 21:06:14
Neues Issue erstellt, da ist es besser aufgehoben.

" PDF: Code blocks within lists poke into the right page margin #44 "

https://github.com/siduction/sidu-manual/issues/44
Title: Re: Mitarbeit: Jetzt und hier.
Post by: edlin on 2022/05/07, 18:54:13
Nachdem es hier wieder ganz schnell sehr ruhig geworden ist: Ich werde mich mal rsync und rdiff und ... annehmen.
Heißt konkret, dass ich das unter Backup & Restore verorten würde, also Grundlagen zum Backup (Typen, Strategien etc.).
Und dann nicht nur mit rsync und rdiff-backup, sondern auch dd und Konsorten.
Hab schon mal lokal einen ersten Ansatz erstellt. Hab mich mit der md-Syntax noch etwas schwer, ist aber normal, wenn man von LaTeX kommt (so eine Art downgrade).

Da das dann doch etwas umfangreicher wird, bitte etwas Geduld. Zumal ich meinen Hexenschuss (ja, ich werde älter) auskurieren muss.

edlin 
 
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/05/09, 18:08:21
@edlin
Schön von dir und deinem Projekt zu hören.

Quote
Und dann nicht nur mit rsync und rdiff-backup, sondern auch dd und Konsorten.
Hab schon mal lokal einen ersten Ansatz erstellt. Hab mich mit der md-Syntax noch etwas schwer, ist aber normal, wenn man von LaTeX kommt (so eine Art downgrade).

Die md-Syntax betreffend, kann ich dir gerne helfen wenn du mit einem Entwurf so weit bist. Einfach melden.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: vinzv on 2022/05/11, 23:36:24
Kurzes Zwischen-Update:
Das Manual ist jetzt im Stand vom 01.05.22 online. D.h. es gibt jetzt sowohl eine deutsche als auch eine englische Variante.

https://manual.siduction.org

Die responsive Darstellung ist eine gesonderte Baustelle. Wer hier mit pandoc mithelfen möchte, gerne melden:
https://github.com/siduction/sidu-manual/issues/33#issuecomment-1124315528
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/13, 19:53:46
HTML Manual Testkandidat

Das deutsche siduction Handbuch mit responsiver Darstellung steht zum Testen bereit.
https://manual.siduction.org/index3_de.html (https://manual.siduction.org/index3_de.html)

Nachdem wir uns intensiv um die Verbesserung der PDF Version kümmerten, war jetzt
das Ziel die Darstellung der HTML Seiten auf Mobilgeräten zu optimieren. Die Seite ist
ausschließlich auf HTML und CSS aufgebaut und verwendet lediglich relative Größenangaben
mit Bezug zum Viewport und der vom User verwendeten Standardschriftgröße des Browsers.

Bitte postet hier eure Meinung und sachliche Kritik.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: ds15 on 2022/06/14, 11:37:25
Moin @scholle1

Die neue Version empfinde ich als deutlich angenehmer für die Augen (liegt wohl am gelblichen Hintergrund). Mir gefällt auch die Möglichkeit, den Baum auf linken Seite komplett auszublenden. Die grauen Rechtecke lenken sonst etwas beim Lesen des Textes ab.

Zum Negativen:
Wenn ich z.B. zur Seite "Quickstart" will, muss ich zweimal klicken: einmal, um das Kapitel im Baum aufzuklappen, und dann nochmal auf den Link "Quickstart". Eine Lösung wäre, dass man zum Aufklappen auf das Pluszeichen klickt oder, wenn man zum Kapitel "Quickstart" will, direkt auf "Quickstart" klickt. Falls es kein großer Aufwand ist, natürlich.

Die grauen Rechtecke im Baum finde ich nicht sehr ansprechend. Da gefällt mir das ursprüngliche Design besser, also: keine Rechtecke, gerne auch wieder mit den ursprünglichen Pfeilspitzen statt den Pluszeichen.

Ich kann leider nicht abschätzen, wie gut der Text für Menschen mit Seeschwäche lesbar ist -> eventuell das Farbschema übernehmen, auf das wir uns in der GitHub-Diskussion geeinigt haben (https://github.com/siduction/sidu-manual/issues/49).

Wenn man mit der Maus oben Links auf das siduction-Logo geht, entsteht so ein organger Balken (siehe Screenshot). Der  [ This attachment cannot be displayed inline in 'Print Page' view ]   gefällt mir nicht so gut (in der vorigen Version entstand er auch nicht).
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/14, 22:28:04
Hallo ds15

Zum Negativen:
Wenn ich z.B. zur Seite "Quickstart" will, muss ich zweimal klicken
- Die Funktion des Navi blieb unverändert (z.B. zweimal klicken) und ist den Bedürfnissen von Smarti und Tablet geschuldet.
Dort sind für die Bedienung größere Flächen notwendig. Gleichzeitig haben die Geräte im Porträtformat Auflösungen von 1080, 1440 und mehr Pixel. Mein Browserfenster auf dem 22'' Monitor hat weniger als 1440 Pixel. Somit kann man über den Viewport nicht sicher zwischen der Bedienung mit dem Finger oder Mauszeiger unterscheiden.
- Wenn der Menütext sofort den Link auslöst, ist die darunter liegende Menüebene nicht mehr erreichbar.

Quote
Eine Lösung wäre, dass man zum Aufklappen auf das Pluszeichen klickt
Ist ein guter Ansatzpunkt und macht Sinn, wenn das Plus- und Minuszeichen weit genug vom Text getrennt ist, zum Beispiel ganz rechts. Das erfordert aber auch eine breitere Navibox. Bedingung ist meines Erachtens, dass der Hamburger nicht wegscrollt damit man das Navi sofort schließen kann. Bin auf der Suche.

Quote
Farbschema
Hab ich getestet. Neu sind der cremefarbene Hintergrund und das grau. Beides ist im Hinblick auf Farbsehschwäche unbedenklich.

Quote
Wenn man mit der Maus oben Links auf das siduction-Logo geht, entsteht so ein organger Balken
Wird geändert.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: Mister00X on 2022/06/15, 20:33:14
Das erste was mir auffällt ist, dass wenn man schon auf der ersten Seite auf irgendeinen externen Link klickt, dann passiert in Firefox das
 [ This attachment cannot be displayed inline in 'Print Page' view ]  

Kann man das irgendwie so ändern, dass die links stattdessen in einem neuen Tab bzw. neuem Fenster geöffnet werden?
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/16, 11:59:31
Kann man das irgendwie so ändern

Man kann, selbstverständlich.
Code: [Select]
target="_blank" leitet die Ausgabe des Link in einen neuen Tab oder ein neues Fenster um. Erledige ich etwas später. Damit es bei mir nicht untergeht und für andere nachvollziehbar ist: Ein neus issue https://github.com/siduction/sidu-manual/issues/58 (https://github.com/siduction/sidu-manual/issues/58)
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/16, 12:53:37
Zwischenbericht
Bitte berücksichtigen, dass die unten genannten Punkten jetzt noch nicht auf der Testseite erscheinen.
Es folgt demnächst eine neue Version.

Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/18, 21:19:00
HTML Manual nächster Testkandidat
https://manual.siduction.org/index4_de.html

Das wurde gegenüber dem Vorgänger geändert:

Bitte testet die Seite auf allen möglichen Ausgabegeräten im Hoch- und Querformat.
Die Darstellung sollte sich entsprechend anpassen.
Wer nur am PC arbeitet, kann das Browserfenster einfach mal so weit zusammenschieben, bis ein Hochformat entsteht.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/19, 16:45:53
HTML Manual jetzt mit vereinfachtem Menü
https://manual.siduction.org/index5_de.html

@ds15
Habe deinem Verbesserungsvorschlag entsprechend das Menü vereinfacht.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: unklarer on 2022/06/19, 17:23:40
@scholle1, danke für deine/eure Arbeit.   :)

Ich habe das jetzt kurz auf einem Huawei-p40-light mit den Browsern FOSS und Privacy getestet.

Sowohl im Längs -, als auch im Querformat verhält es sich, wie du sagst, korrekt und passt sich an.
Prima finde ich das mit den Pluszeichen und der Auswahlfarbe Orange. Da weiß man, wo man ist. Allerdings löse ich beim "Abstreifen/Scrollen" (von oben nach untern) ein "Neu-Laden-der-Seite" aus und ich bin auf der Startseite des Manual.
Gehe ich wieder an den Punkt, ist die ursprüngliche Auswahl (+) in Orange noch vorhanden.

Es kann auch sein, dass das an den Einstellungen des Gerät liegt.   :D 
Schaun'mer mal.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: hendrikL on 2022/06/20, 07:37:44
Dieses Verhalten liegt sehr wahrscheinlich daran, dass dies ein Frame basiertes Design ist und auf js und ähnliches verzichtet wird.
Lädt man die Seiten neu, so lädt man die Index Seite neu und nicht den Frame-Inhalt.
Aus diesem Grunde springt es zurück.
Gut daran zu sehen, in dem sich die Addresse nicht verändert egal wo man sich im Manual befindet.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: unklarer on 2022/06/20, 10:26:17
@hendrikL,

danke, für diese Erklärung.   :)
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/20, 12:28:22
@unklarer

Die Seite ist auf verschachtelte Flexboxen (Nachfolger der veralteten und starren Frames) aufgebaut.
Die Inhaltsseiten werden in einem iframe dargestellt.

In welchem Bereich hast du gescrollt, Inhalt oder Navi?
Und löst sich das Neuladen am Anfang und Ende des Inhalts aus oder auch dazwischen?
Oder hast du das Navi geschlossen?
Title: Re: Mitarbeit: Jetzt und hier.
Post by: hendrikL on 2022/06/20, 14:04:31
Also hier nur im iframe, egal ob Menü geöffnet oder geschlossen, zurück zum Anfang scrollen und dann Seite neu laden, also im iFrame,
Title: Re: Mitarbeit: Jetzt und hier.
Post by: unklarer on 2022/06/20, 16:56:00
@scholle1,

genau, wie bei hendrik.  Ein Bild:

(https://i.imgur.com/El1sGcgt.png) (https://i.imgur.com/El1sGcg.png)

Zwei weitere, wobei ich das jetzt falsch gemacht habe, zuerst zeigt das Neu-Laden den Anfang des Manual ohne Menü und getroffener Vorauswahl.   ;)

(https://i.imgur.com/RT7RTTHt.png) (https://i.imgur.com/RT7RTTH.png)  (https://i.imgur.com/GyPwJent.png) (https://i.imgur.com/GyPwJen.png)
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/20, 22:29:30
@unklarer

habe mir den Browser auf mein Samsung Galaxy A10 geladen und die Seite ausprobiert.
Ständiges neu laden beim scrollen des Navi und der Inhaltsseite.

Ursache: Einstellung im Browser.

Abhilfe:
Jetzt tut er wie er soll.
 ;D 8)
Title: Re: Mitarbeit: Jetzt und hier.
Post by: unklarer on 2022/06/21, 08:09:59
@scholle1.

Klasse Ansage von dir!   ;D

Kann ich bestätigen und funktioniert jetzt.
Im anderen Browser (Privacy) mit meinen Bildern ist es ähnlich:

links oben die drei Striche--Einstellungen--Allgemein--"Herunterziehen zum Aktualisieren" abstellen.

Entschuldige bitte, dass ich dir Mehrarbeit "bereitet" habe.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/06/21, 12:12:53
@unklarer

Geht in Ordnung. Auf die Weise habe ich einen zusätzlichen Browser zum testen.

 ;)
Title: Re: Mitarbeit: Jetzt und hier.
Post by: scholle1 on 2022/07/06, 21:48:46
Habe heute das Handbuch aktualisiert und die HTML Seiten auf das neue responsive Design umgestellt, nachdem hier keine weiteren Anregungen und Verbesserungsvorschläge eintrafen.

Dank an alle, die bei dem Relaunch der HTML Seiten unterstützend und beratend dabei waren.
Title: Re: Mitarbeit: Jetzt und hier.
Post by: schtobia on 2022/08/10, 08:26:36
Thema Python, ich kann leider das Ursprungsposting nicht zitieren: Was ist denn da zu tun? https://github.com/siduction/release-orga/issues sagt leider auch nicht mehr dazu…
Title: Re: Mitarbeit: Jetzt und hier.
Post by: hendrikL on 2022/08/10, 10:36:39
Moin , towo kann bestimmt zu Python etwas sagen .
Gib mal im IRC laut!