Formatierung Titelgrösse der FreeGEOS Techdocs auf github.io

bolle732 · April 1, 2025 at 5:58 PM

Hallo zusammen

Wenn ich die FreeGEOS Technical Documentation auf github.io durchgehe, sind die Titel der 3. Ebene (H4 Tag?) kleiner als der Text und auch kleiner als die 4. Ebene (H5 Tag?):

#FreeGEOS technical documentation

#FreeGEOS source codes. The offical home of the PC/GEOS operating system technology. For personal computing fans. For all developers and assembly lovers. For…

bluewaysw.github.io

Das macht das Lesen etwas schwierig. Liegt das an meinem Browser oder ist da ein CSS im Hintergrund mit einem fehlerhaften Eintrag?

Achim · April 1, 2025 at 7:25 PM

Ist bei mir genauso; Firefox 136.0.4 in Linux Mint 20.3

Rainer · April 1, 2025 at 8:05 PM

Hm. Ich finde die Stelle nicht. Bei mir geht nix bis 16 ...

Rainer

Mütze · April 1, 2025 at 8:51 PM

Rainer : Concepts

bolle732 : Sieht hier unter Safari genauso aus. Das Problem ist mir an anderer Stelle auch schon mal aufgefallen.

Der Fehler könnte auftreten, wenn z.B. per CSS ne andere Standardschriftgröße festgelegt wird, die im Browser voreingestellten Schriftgrößen für Überschriften aber nicht ebenfalls angepasst werden.

bolle732 · April 2, 2025 at 12:10 PM

Eventuell habe ich das Problem gefunden. In der CSS-Datei

https://bluewaysw.github.io/pcgeos/assets/css/just-the-docs-default.css

ist folgender Abschnitt für H4-Tags definiert:

h4,
.text-delta {
font-size: 0.6875rem !important;
font-weight: 400;
text-transform: uppercase;
letter-spacing: 0.1em;
}

Der Wert für "font-size" sollte wohl 0.875 sein. Scheint als ob sich da die "6" noch reingeschlichen hat... Zumindest sieht es anhand der vor- und nachgehenden Definitionen so aus...

Ist diese Techdoc im FreeGEOS Repository und wird sie von da aus auch aktualisiert?

mgroeber · April 2, 2025 at 6:50 PM

Ich schaue mal, ob man das just-the-docs-Thema aktualisieren kann (im Gemfile und dann das zugehörigen Lockfile unter Techdocs mit Ruby neu generieren).

bolle732 · April 2, 2025 at 7:01 PM

Wunderbar, habe im letzten Jahr vorallem die Doku der Routinen gebraucht, wo das Lesen beim Durchsuchen etwas schwierig war:

mgroeber · April 3, 2025 at 9:47 PM

Ich habe jetzt erst mal ein Issue bei just-the-docs geschrieben, da der Fehler wohl auch in der aktuellen 0.10 noch drin ist: https://github.com/just-the-docs/just-the-docs/issues/1634 - mal sehen, was die schreiben, oder ob da vielleicht sogar eine Idee dahinter steckt (h4 wird in Großbuchstaben umgewandelt, daher könnte jemand eine etwas kleine Schrift durchaus für typographisch sinnvoll gehalten haben...). Ich find's aber auch zu klein.

bolle732 · April 3, 2025 at 10:24 PM

Alles klar und besten Dank, dass Du Dich darum kümmerst