Skip to main content

Docusaurus Guide – Intro

Krátky prehľad, ako píšem dokumentáciu projektu LELEK v Docusauruse.

  • Zdroj pravdy: content/docs/sk/sthdf/ST-016-OndrejSpanik/ – Markdown súbory s frontmatterom.

  • Obrázky: content/docs/assets/sthdf/ST-016-OndrejSpanik/img/ (SVG schémy) a photos/ (fotky z výroby). Makefile ich pri builde kopíruje do static/assets/, v texte sa odkazujú ako /assets/sthdf/ST-016-OndrejSpanik/img/nazov.svg.

  • Build lokálne: make build (sync obsahu + docusaurus build), make dev pre živý náhľad.

  • Nasadenie: push do main → Vercel spustí make build (viď vercel.json).

  • Navigácia: sidebar je autogenerovaný z priečinkov; label = title vo frontmatteri – nemením ho, aby navigácia ostala stabilná.

  • KNIFE blog: content/docs/sk/knifes/index.md; obrázky dosiek v content/docs/assets/knifes/lelek/ (make SY02-sync-assets ich skopíruje do static/assets/), v texte /assets/knifes/lelek/v7_schematic.png.