====== Konverze menu XML souborů a překlad do cizího jazyka ======

**menu** XML soubory obsahují texty, které se zobrazují uživateli v hlavní nabídce OR-SYSTEM Open a menu další funkce.\\
Aby je bylo možné zobrazovat v cizí řeči, je nutné vlastní texty nahradit odkazy na properties soubory, které obsahují jazykové mutace textů.\\
Pro tuto úpravu XML souborů slouží tento program.
Program lze spustit pouze na vývojové verzi a navíc jen pokud je spuštěn z vývojového prostředí NetBeans.
Jeho cílem je umožit překlad menu do cizího jazyka.\\
Proto je potřeba vlastní text extrahovat do properties souborů a do do xml souboru uvést odkaz na tento text.\\
Properties soubory je pak možné automatizovaně přeložit s využitím DeepL.   

Příklad původního tvaru menu výroba:
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<group>
  <ref name="lva" id="orfertc.lv.a">
    <text>Základní data a číselníky</text>
    <hint>Základní data a číselníky</hint>
  </ref>
  <ref name="lvb" id="orfertc.lv.b">
    <text>Plánování výroby</text>
    <hint>Plánování výroby</hint>
  </ref>  
  <ref name="lvc" id="orfertc.lv.c">
    <text>Řízení zakázky</text>
    <hint>Řízení zakázky</hint>
  </ref>
</code>
Nový tvar:
<code xml>
<?xml version="1.0" encoding="UTF-8"?><group>
  <ref id="orfertc.lv.a" name="lva">
    <text>$R{zakladniDataACiselniky}</text>
    <hint>$R{zakladniDataACiselniky}</hint>
  </ref>
  <ref id="orfertc.lv.b" name="lvb">
    <text>$R{planovaniVyroby}</text>
    <hint>$R{planovaniVyroby}</hint>
  </ref>  
  <ref id="orfertc.lv.c" name="lvc">
    <text>$R{rizeniZakazky}</text>
    <hint>$R{rizeniZakazky}</hint>
  </ref>
</code>

Vzniklý properties soubor:

<code java>
menu.zakladniDataACiselniky=Základní data a číselníky
menu.planovaniVyroby=Plánování výroby
menu.rizeniZakazky=Řízení zakázky
</code>


Properties soubory se generují do projektu api. cz/orcz/text/predpona_projektu_menu_text.properties\\
např.\\
lv-api/src/main/java/cz/orcz/texty/lv_menu_text.properties\\
ors-api/src/main/java/cz/ortex/texty/ors_menu_text.properties\\


====== 1. Konverze vybraných záznamů ======
Po spuštění programu jsou načteny všechny xml soubory dostupné v aktuálním adresáři projektů.\\
Pokud je tedy spušten OR-SYSTEM Open z adresáře c:\JavaProjects, kde se nachází adresáře\\
ors-api\\
ors-gui\\
ors-impl\\
lc-api\\
lc-gui\\
lc-impl\\
lv-api\\
lv-gui\\
lv-impl\\
Tak se načtou menu xml soubory z adresářů *-gui.\\
Zobrazí se v browsu. Např. takto:

Je přitom vidět, které XML soubory jsou již zkonvertované a které ne.
Následně je možné záznamy vyfiltrovat a hromadně či individuálně zatrhnout.
Vybrané záznamy se pak pomocí funkce **Konverze vybraných záznamů** zkonvertuje do properties souborů.



\\
====== 2. Přeložit vybrané properties soubory ======

Následně je možné vygenerované properties soubory přeložit do cizího jazyka pomocí DeepL.


\\
====== 3. Editace properties souboru v NetBeans ======