Siduction Forum
Siduction Forum => Siduction News => Topic started 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.
- Offene Themen im Handbuch
- Alle Dateien ohne Ziffern am Anfang des Dateinamens überarbeiten.
https://github.com/siduction/sidu-manual/wiki/DE_Status-der-Handbuchseiten Layout des PDF: Wer sich mit LaTex auskennt
Die Fehlerbeschreibung hier: https://github.com/siduction/sidu-manual/issues/40
Das PDF Handbuch hier https://manual.siduction.org/manual.pdf und auf GitHub. Erledigt. Dank an Mister00X.- Übersetzung in zusätzliche Sprachen
- Artwork, da sind wir nicht wirklich gut aufgestellt.
- Background, Icon usw
Bitte hier melden um genaueres zu erfahren.
- Testen und Bewerten der Isos
- Bitte hier melden um genaueres zu erfahren.
- Die Python Skripte überarbeiten
- Dafür sind gute Kenntnisse in Python notwendig.
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
-
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
-
@Mister00X
Danke für deine Unterstützung. Habe es gerade auf Git gesehen und beantwortet.
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.
-
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
-
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 :)
-
@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.
-
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.
-
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
-
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
-
@edlin
Schön von dir und deinem Projekt zu hören.
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.
-
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
-
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.
-
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).
-
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.
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.
Farbschema
Hab ich getestet. Neu sind der cremefarbene Hintergrund und das grau. Beides ist im Hinblick auf Farbsehschwäche unbedenklich.
Wenn man mit der Maus oben Links auf das siduction-Logo geht, entsteht so ein organger Balken
Wird geändert.
-
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?
-
Kann man das irgendwie so ändern
Man kann, selbstverständlich. 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)
-
Zwischenbericht
Bitte berücksichtigen, dass die unten genannten Punkten jetzt noch nicht auf der Testseite erscheinen.
Es folgt demnächst eine neue Version.
- Erledigt:
Hamburger auf der Seite fixieren. - Nahe dran:
Ein Klick für Seiten mit Untermenü.
Link und Untermenü (+ und -) so weit trennen, dass die Bedienung mit dem Finger problemlos möglich ist. - @ds15:
Die grauen Rechtecke lenken sonst etwas beim Lesen des Textes ab.
Deine Anregung hat mich während der Testerei überzeugt, dass bei geschlossenem Menü einzig der Hamburger und ein Impressumlink neben dem Inhalt der Handbuchseite auf der Anzeige verbleiben sollten. Der Header scrollt auch mit weg. Er benötigt auf einem kleinen Display einfach zu viel Platz. Gleichzeitig lenkt auch er vom Inhalt ab.
--- Danke für die Anregung. --- - Fehler bei externen Link:
@Mister00X
Wird auf jeden Fall geändert. Muss das Script für die HTML Seiten anpassen. - Farben:
Bisher erhalten die Link im Menü beim überfahren mit der Maus oder berühren mit dem Finger (:hover) einen orangen Rahmen. Das führt leider bei Zeilenumbrüchen zu unschönen Verschiebungen und seitlich offenen Rahmen. In der nächsten Testversion entfällt der Rahmen und bei :hover färbt sich der Link grün. Angepasst an unsere Farbauswahl für Menschen mit Farbsehschwäche.
-
HTML Manual nächster Testkandidat
https://manual.siduction.org/index4_de.html
Das wurde gegenüber dem Vorgänger geändert:
- Layout etwas geändert.
Der Header scrollt nicht mehr weg. (Leider auch auf dem Smartphone.)
Footer mit Pflichtinhalt eingefügt.
Hamburger fixiert. - Im Menü das "+" und "-" Zeichen vom Text getrennt. Aufklappen des Untermenü auf das Pluszeichen verschoben.
Es dient der Vorbereitung für das geänderte Menü mit weniger Klick oder Tipp. - Die Farbe der grauen Flächen an die Hintergrundfarbe angepasst.
- Darstellung der internen Link wie auf den Inhaltsseiten. (Ohne Rahmen und weiterhin orange.)
- Den orangen Balken, der beim überfahren unter dem siduction Logo entstand, entfernt.
- Fehlermeldung des Browsers bei externen Link:
Die Skripte zur Erstellung der HTML Seiten wurden entsprechend geändert und die neuen Seiten auf den Server gladen.
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.
-
HTML Manual jetzt mit vereinfachtem Menü
https://manual.siduction.org/index5_de.html
@ds15
Habe deinem Verbesserungsvorschlag entsprechend das Menü vereinfacht.
-
@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.
-
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.
-
@hendrikL,
danke, für diese Erklärung. :)
-
@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?
-
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,
-
@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)
-
@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:
- Browser starten.
- Rechts unten auf die drei Punkte tippen.
- Im Popup noch einmal rechts unten auf die drei Punkte tippen.
- Auf "Einstellungen" gehen.
- Auf "Verhalten/Oberfläche" gehen.
- Den Punkt "Nach unten ziehen, um neu zu laden" deaktivieren.
- Browser neu starten.
Jetzt tut er wie er soll.
;D 8)
-
@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.
-
@unklarer
Geht in Ordnung. Auf die Weise habe ich einen zusätzlichen Browser zum testen.
;)
-
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.
-
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…
-
Moin , towo kann bestimmt zu Python etwas sagen .
Gib mal im IRC laut!