EN,CZ : admonitions mentioned, linked to branding, branding contains details about admonitions styling, categorization

Author: VitSimon

cs/admonitions.md

@@ -0,0 +1,43 @@
+# 📢 Vyznačené informační bloky (admonitions)
+
+Implementace vyznačených informačních bloků vychází ze stylu admonitions běžně používaného v dokumentaci (např. GitHub Docs) a je navržena tak, aby byla s tímto stylem kompatibilní. Tuto součást aplikace může administrátor při instalaci odebrat - v takovém případě bude syntaxe stále platná, ale bloky se zobrazí jen jako běžný, zleva odsazený odstavec (blockquote).
+
+- Notace psaní je **> [!TYP]Text informace.**
+- Definovány jsou typy: NOTE, TIP, IMPORTANT, WARNING, CAUTION. Jakýkoli jiný typ se označí pouze stříbrnou čarou
+- Odkazy uvnitř textu informace musí být uvedeny včetně cílové cesty uvnitř tohoto bloku (odkaz do zápatí stránky není dovolen - viz ukázka níže)
+
+```markdown
+> [!NOTE]**Poznámka**
+Popis na dalším řádku.  
+Popis na třetím řádku.
+
+> [!TIP]Tip pro čtenáře
+> [!IMPORTANT]Tento bod je významný.
+Důležité upozornění pro bloky ```<script>``` si můžete přečíst na stránce s [ukázkou](innerJS.md "Ukázka") 
+
+> [!WARNING]Pozor: žlutý vykřičník!
+
+> [!CAUTION]Pozor: červený vykřičník!
+
+> [!MYTEST]Blok neznámého typu
+```
+
+Ukázka:
+
+> [!NOTE]**Poznámka**
+Popis na dalším řádku.  
+Popis na třetím řádku.
+
+> [!TIP]Tip pro čtenáře
+> [!IMPORTANT]Tento bod je významný.
+Důležité upozornění pro bloky ```<script>``` si můžete přečíst na stránce s [ukázkou](innerJS.md "Ukázka") 
+
+> [!WARNING]Pozor: žlutý vykřičník!
+
+> [!CAUTION]Pozor: červený vykřičník!
+
+> [!MYTEST]Blok neznámého typu
+
+Kapitola 🏷️ [Vizuální identita][Branding] popisuje možnosti úpravy vzhledu těchto bloků, včetně definice vlastního typu bloku.
+
+[Branding]: branding.md#h-3-8 "🏷️ Vizuální identita"

cs/branding.md

@@ -151,6 +151,29 @@ ARIAHEADER|contentinfo
 
 Tímto způsobem se aktivuje nová instance pluginu **puiHeader** s názvem **Down**. Současně je nutné založit konfigurační soubor přesně s uvedeným názvem, aby se konfigurace automaticky načetla. Výsledkem bude nový panel umístěný pod panelem obsahu kapitoly, který bude zobrazovat text z klíče **TEXT**. Tento text bude uživateli vždy zobrazen na obrazovce a bude například součástí výstupu pro tisk. Klíč **ARIAHEADER** určuje roli přístupnosti obsahu.
 
+###  Vlastní typ admonition bloku
+
+V rámci řešení vyznačení bloků je dovoleno si dodefinovat vlastní typ podle instrukcí v kapitole 🛠️ [Vlastní UI prohlížeče][customUI] a dále tímto způsobem v **custom.css** v nápovědě:
+
+```css
+:root {
+  --c-border-note-mytest:rgb(207, 207, 34);
+}
+.note-mytest {
+  border-color: var(--c-border-note-mytest);
+}
+
+.note-mytest p::before {
+  content: "MT ";
+}
+```
+
+s použitím jaké je obvyklé u ostatních typů:
+
+```markdown
+> [!MYTEST]Blok neznámého typu
+```
+
 [TocIcon]: tocIcon.md "Ikony stromu témat"
 [customUI]: customUI.md "Vlastní UI prohlížeče"
 [DGuide]: ?d=hlp-dguide/Help-__.zip "Dokumentace pro vývojáře"

cs/files.lst

@@ -33,3 +33,4 @@ https://discord.gg/J2SjcmqHSZ|Uživatelská skupina
 sectionList.md|Seznam částí
 print.md|Tisk
 export.md|Export
+admonitions.md|Vyznačené informační bloky

cs/keywords-files.lst

@@ -1,18 +1,18 @@
 0;1;3;25;26;34
 1;2;34
 2;6;13;22;25
-3;6;7;11;10;21;26
+3;6;7;11;10;21;26;35
 3
-4;25
+4;25;35
 4;2;3;24;26;28
-5;10;11;12
+5;10;11;12;35
 5
 6
 7;34
 5
-8;16
+8;16;35
 9;34
-10;11
+10;11;35
 11;21
 10
 12;17;18;19;20
@@ -29,3 +29,4 @@
 27;28;29;30
 26
 34
+35

cs/keywords.lst

@@ -29,3 +29,4 @@ HelpViewer
 Odkaz
 Identita;Branding;Vizuál
 Export
+Admonition;upozornění;Blok;infoblok;vyznačení

cs/tree.lst

@@ -15,6 +15,7 @@ Nová kapitola|Nová kapitola||newTopic.md
  🔗 Odkazy|Odkazy v textech||links.md
  🖼️ Obrázky|Obrázky v textech||images.md
  🧾 Kódový výpis|Kódový výpis v textech||code.md
+ 📢 Informační bloky|Vyznačené informační bloky||admonitions.md
  📊 Diagram|Diagram||diagram.md
  🧩 JavaScript|Vložený JavaScript blok||innerJS.md
  🖨️ Tisk|Tisk||print.md

en/admonitions.md

@@ -0,0 +1,43 @@
+# 📢 Highlighted information blocks (admonitions)
+
+The implementation of marked information blocks is based on the admonitions style commonly used in documentation (e.g., GitHub Docs) and is designed to be compatible with this style. This part of the application can be removed by the administrator during installation - in this case, the syntax will still be valid, but the blocks will only be displayed as a normal, left-aligned paragraph (blockquote).
+
+- The notation is **> [!TYPE]Information text.**
+- The following types are defined: NOTE, TIP, IMPORTANT, WARNING, CAUTION. Any other type is marked only with a silver line
+- Links within the text of the information must be included with the target path within this block (links to the footer of the page are not allowed - see example below)
+
+```markdown
+> [!NOTE]**Note**
+Description on the next line.  
+Description on the third line.
+
+> [!TIP]Tip for readers
+> [!IMPORTANT]This point is important.
+Important notice for ```<script>``` blocks can be found on the [example](innerJS.md "Example") page. 
+
+> [!WARNING]Warning: yellow exclamation mark!
+
+> [!CAUTION]Warning: red exclamation mark!
+
+> [!MYTEST]Block of unknown type
+```
+
+Example:
+
+> [!NOTE]**Note**
+Description on the next line.  
+Description on the third line.
+
+> [!TIP]Tip for readers
+> [!IMPORTANT]This point is important.
+Important note for ```<script>``` blocks can be found on the [example](innerJS.md "Example") page. 
+
+> [!WARNING]Warning: yellow exclamation mark!
+
+> [!CAUTION]Warning: red exclamation mark!
+
+> [!MYTEST]Block of unknown type
+
+Chapter 🏷️ [Branding][Branding] describes the options for customizing the appearance of these blocks, including defining your own block type.
+
+[Branding]: branding.md#h-3-8 "🏷️ Branding"

en/branding.md

@@ -151,6 +151,29 @@ ARIAHEADER|contentinfo
 
 This activates a new instance of the **puiHeader** plugin named **Down**. At the same time, it is necessary to create a configuration file with the exact name specified so that the configuration is loaded automatically. The result will be a new panel located below the chapter content panel, which will display the text from the **TEXT** key. This text will always be displayed to the user on the screen and will be included in the print output, for example. The **ARIAHEADER** key specifies the accessibility role of the content.
 
+###  Custom admonition block type
+
+As part of the information blocks (admonition) solution, you can define your own type according to the instructions in the chapter 🛠️ [Viewer Custom UI][customUI] and also in this way in **custom.css** in the help:
+
+```css
+:root {
+  --c-border-note-mytest:rgb(207, 207, 34);
+}
+.note-mytest {
+  border-color: var(--c-border-note-mytest);
+}
+
+.note-mytest p::before {
+  content: "MT ";
+}
+```
+
+using the same method as for other types:
+
+```markdown
+> [!MYTEST]Block of unknown type
+```
+
 [TocIcon]: tocIcon.md "TOC icons"
 [customUI]: customUI.md "Viewer Custom UI"
 [DGuide]: ?d=hlp-dguide/Help-__.zip "Documentation for developers"

en/files.lst

@@ -33,3 +33,4 @@ https://discord.gg/J2SjcmqHSZ|User group
 sectionList.md|Sections list
 print.md|Print
 export.md|Export
+admonitions.md|Admonitions

en/keywords-files.lst

@@ -1,18 +1,18 @@
 0;1;3;25;26;34
 1;2;34
 2;6;13;22;25
-3;6;7;11;10;21;26
+3;6;7;11;10;21;26;35
 3
-4;25
+4;25;35
 4;2;3;24;26;28
-5;10;11;12
+5;10;11;12;35
 5
 6
 7;34
 5
-8;16
+8;16;35
 9;34
-10;11
+10;11;35
 11;21
 10
 12;17;18;19;20
@@ -29,3 +29,4 @@
 27;28;29;30
 26
 34
+35