Skip to main content

Docusaurus Guide – Formatting

Zásady formátovania (nadpisy, obrázky, code blocks).

  • Jeden # nadpis na stránku (= nadpis stránky), sekcie ##, podsekcie ###.

  • Obrázky: ![popis](/assets/.../nazov.svg) – SVG majú svetlé pozadie, aby boli čitateľné aj v tmavom režime.

  • Tabuľky pre všetko, čo má stĺpce (kusovník, testy, piny) – ľahšie sa udržiavajú než odrážky.

  • Kód: ```cpp pre firmvér, ```bash pre príkazy, ``` pre G-kód / obsah karty.

  • MDX pasce: v texte nepoužívať { } ani znak menší-než pred písmenom (napr. „pod 3,3 V“ namiesto „<3,3 V“) – rozbije to build.

  • Fyzikálne jednotky s medzerou: 3,7 V, 8 Ω, 20 mA; desatinná čiarka v slovenskom texte.

  • Fotky z procesu ako 2-stĺpcová tabuľka s placeholdrami, ktoré nahradím .jpg súbormi rovnakého mena.

  • PNG zo Fritzingu (schémy, breadboard, PCB) idú do assets/knifes/lelek/ s názvom vN_schematic.png, vN_breadboard.png, pcb_vN.png; v texte vždy s popisom verzie.

  • Ceny vždy s menou, DPH, dátumom čítania a poznámkou o poštovnom.