CZ : Browse help unpublished locally, fulltextIndex creation explained in basic steps

Author: VitSimon

cs/fulltextIndex.md

@@ -6,3 +6,26 @@
 - Pokud soubor **existuje, je zapnuto** vytvoření fulltext indexu při vydávání nápovědy. Dalšího zásahu ze strany autora zde není potřeba.
 - Soubor ponechte prázdný
 - Pro vypnutí vytvoření fulltext indexu stačí soubor z jazykové verze smazat.
+
+## Obecný popis logiky
+
+Logika procesu přípravy fulltext indexu se nachází v repozitáři [fulltextSearchDBBuilder][FTSIndexing] (jedná se o bash skript)
+
+Pro každý jazyk samostatně proběhnou tyto kroky:
+
+1. do indexace se vyberou soubory: \*.md;\*.htm;\*.html
+2. vše se převede na UTF-8 kódovou stránku
+3. Chybějící soubory v [seznamu souborů][Dfiles.lst] jsou vloženy na konec seznamu bez záložního nadpisu
+4. Všechna písmena textu se převedou na malá
+5. Odebere se diakritika a speciální znaky (about:blank -> aboutblank)
+6. Slova s délkou menší než 3 písmena jsou vynechána ze zpracování
+7. Spočítá se počet výskytů unikátních slov v jednotlivých dokumentech
+8. Dokumenty se seřadí od největšího k nejmenšímu počtu výskytu v seznamech pro jednotlivá slova
+9. Sestaví se dva nové soubory:
+    - fts-keywords.lst (slova)
+    - fts-keywords-files.lst (propojené soubory)  
+  Soubory jsou strukturou stejné se seznamem [klíčových slov][Dkeywords.lst]
+
+[FTSIndexing]: https://github.com/HelpViewer/fulltextSearchDBBuilder "Sestavení fulltext indexu"
+[Dkeywords.lst]: mdata/keywords.lst.md "keywords.lst"
+[Dfiles.lst]: mdata/files.lst.md "files.lst"

cs/general.md

@@ -2,4 +2,12 @@
 
 V organizaci **[HelpVewer][HV]** naleznete repozitáře začínající na **help\***. Kromě **helpTemplate** a **HelpViewer** jsou všechny ukázkami souborů nápovědy. Můžete si vzít kterýkoli z nich jako příklad, stáhnout si z kteréhokoli **Release** jeho přílohy **Help-*.zip**. Archivy jsou nezaheslované, jejich obsah je přístupný k procházení.
 
+Během přípravy Vaší nápovědy ji můžete offline procházet i přesto, že nebyla ještě vydána a ověřit si tak výsledky. Provedete to následujícím způsobem - spustíte **HelpViewer** v prohlížeči s procházením místního souboru a předáte mu relativní cestu ke své vznikající nápovědě:
+```
+file://.../HelpViewer/?d=../VaseNapoveda/__/
+```
+
+- Pokud by cesta nefungovala, lomítka **/** v d nahraďte za **%2F**
+- Fulltextový bude po dobu těchto testů nefunkční (je sestaven automaticky až při vydávání)
+
 [HV]: https://github.com/orgs/HelpViewer/repositories "Repozitáře"