Nějakou dobu nebyl překlad dokumentace napojen na hlavní úložiště, ale bylo možné jej otevřít a podívat se po stažení archivu zip celé dokumentace ze stránky:
https://github.com/qelectrotech/qelectrotech-doc
Viz rozbalovací nabídka pod "zeleným tlačítkem" Code -> Download ZIP
Nyní lze dokumentaci v češtině prohlížet v prohlížeči i bez stahování,
viz oznámení ve fóru (Dokumentace): přidání překladu dokumentace do češtiny a
tento odkaz:
https://download.tuxfamily.org/qet/manual_0.7/build_cs/index.html#
Přes stránky
QElectroTechu se dostaneme na "manuál", ale kde je tam případně nějaký přepínač/rozbalovací nabídka jazyků, nebo (pro)zatím není, není vidět?
https://download.tuxfamily.org/qet/manual_0.7/build/index.html#
Pokud tedy nadále nebudete používat odkaz na internetovou stránku se soubory ke stažení uvedený výše, potom po stažení a rozbalení (obsahu archivu na disk) vás bude zajímat složka build_cs.
V ní poklepete na (otevřete) soubor index.html. Protože při prvním otevření (asociace souboru v systému nainstalovaném na daném zařízení) ve starším
Internet Exploreru zobrazení obsahu nevypadalo normálně, použijte
například Firefox.
V překladu byly určité mouchy, zvláště odkazy se chovaly a chovají "podivně" (ne vždy totiž vedou tam, kam mají, jak by se očekávalo, nebo mělo smysl). Vedle toho se tam občas vyskytl i nějaký překlep, který ovlivnil výsledný dojem, a také formátování textu, např. špatný apostrof nebo často chybějící mezera (zcela neprovedené odkazy z důvodu chybějící mezery a tím špatného
výkladu takového "spojeného řetězce" byly při prvním zkouknutí výsledku kapitola sama o sobě), a pak z toho zřetelně vidět řetězec, který měl po kompilaci fungovat jako odkaz, ale odkaz nebyl z uvedeného důvodu vytvořen.
Bylo tak třeba zjistit, proč jsme se ne zřídka setkali s tím, že byla např. předložka a slovo zobrazeno bez mezery. Nedělo se to ale jen s předložkami, jakoby to mohlo být něco tímto dané, ale i tak, že viditelně stála dvě slova vedle sebe. Ty mezery vůbec podezřele chyběly nějak moc často. Na to bylo potřeba se při zkoumání zaměřit, a tak se rychle přišlo na to, že mezery ve zdrojových souborech na koncích řádků opravdu nebyly tam, kde být dle očekávání měly (v editoru jsou jinak typicky vloženy, ale zde se využilo i jiného nástroje a po vložení, aniž by si toho kdo hned všiml, jednoduše zmizely-se nezkopírovaly/nevložily.
Jenže ani po první opravě všechny takové řetězce nebyly překladačem vyloženy a nefungovaly jako odkazy. Ostatně očividně v některých místech je přeodkazováno. Když to přeženu, k čemu je mít čtyřikrát v jedné větě odkaz na stránku "projekt", a třikrát odkaz nefunguje jako odkaz. Řekněme, že z ostatních "taky odkazů" jednoduše smažeme část řetězce, která z nich má udělat odkaz. Co na to překladač, nezblázní se z toho? :-) Uvidíme. Při druhé opravě se vychytají ty zbývající (aspoň dva tam určitě budou) nepracující odkazy-neodkazy.
Problém také je, že se odkazy chovají tak, jakoby při určování jejich cíle překladač vycházel z angličtiny, lépe řečeno z pořadí odkazů v anglické větě. Když odkazy vyzkoušíme, vypadají někdy jakoby byly prohozeny - odkaz, který má v názvu list vede na projekt, a odkaz s projektem v názvu vede na list. No není to rozkošné? Klepnete na odkaz a jste zvědaví, kam vás to dovede. To už radši v hlavě myšlenkovou mapu obsahu, kdy už víte, kde co je. Rada: čtěte příručku často a pozorně, a půjde to. Řešení: poklepejte na všechny odkazy ve větě, kde je jich víc, a v nových kartách se třeba otevřeu všechny, které máte dle záměru tvůrce vidět.
Do jisté míry se dá zařídit, aby i v češtině skladba věty vypadala jako česká/moravská, a dodrželo se anglické pořadí odkazů, pokud budeme brát za fakt, že to hraje roli. Stačí se nad slovy zamyslet a zpřeházet je tak, aby nevypadaly, že takto byste je nikdy dobrovolně podle anglické věty na první pokus nesestavili. Překvapením ale jsou potom věty byť s několika málo odkazy, kde je jednoznačně dodrženo "anglické" pořadí, ale výsledek tomu stejně neodpovídá.
Ještě jednou k tomu, jak postupovat, když se budete chtít na dokumentaci podívat, kdyby bylo výše uvedené moc stručné. Z uvedených stránek se stáhne soubor (archiv) s příponou zip. Ten obsahuje více
složek, a protože nás zbytek nezajímá (zdrojáky s anglickou verzí/zdrojáky
k české verzi), tak pokud obsah archivu nechceme na disk rozbalit celý, aby se tam nezabíralo místo tím, co se nepoužívá, už při otevření staženého archivu v software, který je
pro to v operačním systému určen, třeba hned jednoduše zkopírujeme jen tu složku build_cs
(Ctrl+C při jejím označení) a tu vložíme přes správce souborů (Ctrl+V) na zvolené místo na disku, např.
do složky Dokumenty. (co se týče toho, co popisuji: jde u rozbalení na námi určené místo vlastně o to, jak se ten který
operační systém k těm archivům chová, a nechci tu přibližovat všechny obměny postupu; kupříkladu v OS Windows se vám
obsah archivu otevře ve správci souborů - Průzkumník se mu stále ještě
říká?, a tak popisuji to, co byste mohli hned dělat jako kopírování
složky a její vložení někam do jiné složky).
Pak stačí dvakrát poklepat na soubor index.html (ve
struktuře adresáře build_cs na nejvyšší úrovni), a prohlížeč, který je
přiřazen v systému na otvírání souborů s touto příponou (případně si
přes pravé tlačítko myši můžete hned určit, ve kterém prohlížeči se mají takové
soubory otevírat trvale), stránku načte.
Dokumentace
a obrázky jsou již dělány zároveň s aktualizací samotného
překladu, takže v nejnovějších vývojářských verzích, co je systém
automaticky noc co noc chrlí (noční verze), rozhraní programu po spuštění v posledních měsících
vypadá už takto.
Ještě jedna poznámka k tomu, co snad (ale spíš to byla specifická situace - snad otevření ještě na disk včetně ostatních neuloženého souboru přímo v okně programu pro archivaci?) můžete při svém snažení o zprovoznění dokumentace také pozorovat. 1) Uživateli, který, jak sdělil, poklepal na soubor index.html, se stránka s obsahem zobrazila, a to bylo asi tak vše. Při klepnutí na konkrétní položku, libovolnou, mu vyskočila hláška... něco jako, že stránku nelze najít, a navazující otázka: zkusit znovu? A tak pořád dokola. Takže, co udělal, aby mu to jelo: 2) zkopíroval si jen build_cs, otevřel index.html, a jak napsal, světe div se jede to. Ale podle všeho rozbalení celého archivu není nic proti ničemu, takže těžko říct, v čem mohl být problém. - Ale, jak již podotknuto, jde zřejmě o to, abyste poctivě :-) obsah archivu rozbalili na disk.
Dne 29. prosince 2020 jsem se podíval a viděl, že 27. prosince byly (skoro všude - a při procházení dokumentace se na nějaké ty "drobnosti" sem tam přijde) opravené soubory v
dokumentaci aktualizovány. Stáhl jsem ZIP archiv, rozbalil a vypadá to
(i podle toho, že jsou v češtině i ty předtím výjimečně nepřeložené
kapitolky, jako je spuštění v OS Windows, které jsem v rámci oprav a úprav, po prvním zkompilování celé dokumentace, což bylo před více jak měsícem?, dopřeložil), že problém s mezerami a
některými nefunkčními odkazy je tím vyřešen - ale jen do té míry, o které se hovoří v průběžně aktualizovaných odstavcích výše (viz položená a namátkově zkoušená otázka, jestli
vždy odkaz vede tam, kam má, a také, jestli se s tím dá něco jednoduše dělat (když odkaz vede mimo jiné i na nefunkční stránku - nebo to byl problém, dejme tomu s připojením? - ne nebyl a není): jednoduše, spíš ne, a pro přesné určení by správce dokumentace měl pořádně nastudovat dokumentaci k použitému systému, a poskytnou přehledný návod, jak odkazy zacílit, když by bylo potřeba, přesně, napsat, co je potřeba udělat, a ne jinak, ať je to pracné, jak chce).
Jestli ale ty drobné potíže s odkazy pramení z anglického textu (anglické dokumentace), tak s tím nic nenaděláme. Prostě, chcete-li, poklepejte na všechny odkazy, které v daném odstavci najdete (protože zkouším některé takto označené v anglickém textu odstranit - zbavit toho, co je označuje jako text, který se má zobrazit jako odkazy), a uvidíte. Je pak jedno, jestli se po klepnutí na např. Prvek zobrazí kapitola List, hlavně, že se, doufejme, něco zobrazí, když to zrovna potřebujete tímto způsobem vyhmátnout.
Po první prosincové (2020) předvánoční fázi oprav přišla druhá lednová fáze (2021), kdy byla na začátku poslední dekády dokumentace znovu projita a aktualizována. Do úložiště byly tyto změny nahrány někdy na přelomu 11. až 12. února. Nyní tedy zbývají aspoň dva nedořešené odkazy (čili ty, které jako odkazy nyní vůbec nefungují; viz líčení problému s odkazy výše). K tomu se časem doplní nyní chybějící obrázky rozhraní apod.
