AC - Implementační báze - Nápověda EN
January 2, 2024 · View on GitHub
Tento repozitář slouží k evidenci nápovědy D365 Business Central.
Struktura repozitáře
Markdown soubory
Markdown soubory naleznete v kořenovém adresáři a poté v každé složce vybraného balíčku:
- IB-dynamics365smb-docs.cs-cz/business-central/
Příklad: Markdown soubory pro Productivity Pack
IB-dynamics365smb-docs.cs-cz/business-central/ProductivityPack/
HTML soubory
Html soubory jsou uložené ve složce d365businesscentral v kořenovém adresáři. Následně má pak každý balíček svoji složku, obdobně jako markdown soubory
Příklad: HTML soubory pro Productivity Pack
IB-dynamics365smb-docs.cs-cz/business-central/d365businesscentral/ProductivityPack/
Obsah nápovědy
Pro psaní nápovědy k addonům dodržujte náležitosti:
-
Název souboru nápovědy se bude skládat z:
nazevsouboru.md- (
helpdesk.md)
-
Pro každý addon vzniknou dva soubory, jeden pro popis a použití, druhý pro nastavení.
- Například:
helpdesk.mdahelpdesk-setup.md
- Například:
-
Struktura souborů nápovědy je:
- Nadpis, krátký popis a kroky jak danou činnosti udělat.
- viz. vzorová nápověda Helpdesku
-
Vlastnosti a tagy
Každý dokumentu musí obsahovat hlavičku v následujícím tvaru:
--- title: Czech Local Functionality - Advance payments and invoices | Microsoft Docs description: This section describes local functionality - Advance payments and invoices author: kunes ms.service: dynamics365-business-central ms.topic: article ms.devlang: na ms.tgt_pltfrm: na ms.workload: na ms.search.keywords: Czech, Advance payment, Advance invoices, Payables, Finance, CZ, Cash ms.date: 15/05/2019 ms.author: v-pejano --- -
Každý dokument musí nakonci obsahovat tabulku "Viz také"
Pod každým souborem nápovědy bude odkaz na nadřazený balík a také odkaz na nastavení daného addonu nebo v opačném případě na obecný popis s návodem k použití.
Příklad konce souboru HelpDesk (použití):
## Viz také
[HelpDeks - Nastavení](business-central/IB/helpdesk-setup.md)
[AC Productivity pack](business-central/IB/productivity-pack.md)
- Pro základní editaci je zde šablona.
Pojmenovávání souborů
Pravidla
- Nenechávat mezery mezi slovy v názvu souboru, používejte pomlčky.
- Používejte pouze malá písmena.
- Limit je maximálně 80 symbolů.
- Všechny soubory musí být ve formátu markdown (.md).
Nahrávání souboru
Při každém nahrávání, editaci nebo mazání souborů je nutné podepsat každý commit svým jménem a popsat o jako událost se jedná. To je důležité zejména v případech, kdy používáte sdílené účty ke GitHubu a ne přímo své na jméno, kdy se Vaše jméno zaznamená automaticky při commitu.
Commit Changes
Martin Kuneš - Náhrání nových úprava stávajících souborů
Přidány nové soubory nápovědy a aktualizace dle legislativy.
Struktura souborů repoziáře
Ujistěte se, že se nacházíte ve správné větvi.
- Soubory ukládejte do master Branche
Soubory standardní nápovědy nahrávejte do:
- business-central/...
- business-central/get-started.md
Soubory pro addony nahrávejte do:
- business-central/nazev-slozky-baliku/
- business-central/IB/pp-productivity-pack.md
Základní syntaxe
Obecný text
Text není třeba formátovat. Pro tučné písmo slouží dvě hvězdičky, pro kurzívu jedna. Mezi odstavci a nadpisy musí být volný řádek. Pro text na další řádek, je za větou třeba napsat dvě mezery (V případě enteru, text nezačíná na novém řádku).
*Kurzíva*
**Tučný text**
***Tučně a kurzíva***
# Téma
## Nadpis 1
Vzorový text, vzorový text, vzorový text, vzorový text, vzorový text, vzorový text, vzorový text.
Nadpisy
Pro nadpisy slouží symbol dvojítého křížku. Dle počtu křížků se rozlišuji úrovně nadpisů.
# Hlavní nadpis
## Název kapitoly
### Název podkapitoly
Odrážky a seznamy
Odrážky pomocí pomlčky
- odrážka 1
- odrážka 2
Číslovaný seznam
Stačí psát pouze číslo a tečku.
1. Položka
2. Položka
Odkaz na jiný soubor
V hranatých závorkách je text, který se zobrazí a v závorce název souboru. (V tomto případě je soubor finance ve stejné složce.)
[Finance](finance.md)
Názvy produktů a aplikací
Aby byly názvy produktů a aplikací jednotné, je potřeba používat malé zástupné soubory, ve kterých je uveden název. Zástupné soubory jsou ve složce ve složce "INCLUDES". V případě změny názvu, se pouze jednou přepíše v zástupném souboru a tím bude automaticky aktuální ve všech dalších souborech kde je použit.
Např. pro Business Central se vloží [!INCLUDE[d365fin](../../includes/d365fin_md.md)]```