OBS! WIP EXPERIMENTAL osv etc.
Detta repo innehåller dokumentationen för Libris olika API:er.
Dokumentationen ligger under docs/ och är i Markdown-format.
För att generera dokumentationssajten används Material for MkDocs, ett slags framework ovanpå MkDocs.
Se:
- https://squidfunk.github.io/mkdocs-material/setup/ för övergripande inställningar
- https://squidfunk.github.io/mkdocs-material/reference/ för saker som kan användas i dokumenten
MkDocs static i18n plugin används för att göra det möjligt att ha sidor på olika språk. Just nu är svenska (sv) och engelska (en) aktiverade. Svenska är default.
När du skapar en ny sida, skriv den på svenska först. Lägg den på lämpligt ställe under docs/ och döp filen till <nånting>.sv.md. Om du gör en översättning ska den heta <nånting>.en.md.
Alla sidor under docs/ kompileras automatiskt till HTML, men endast de som är explicit listade i mkdocs.yml hamnar i navigationsmenyn.
Se till att ha https://github.com/astral-sh/uv installerat.
# Skapa en venv och aktivera
uv run mkdocs build # output hamnar i site/
# Kör inbyggd server, sajten laddas om automatiskt vid ändringar
uv run mkdocs serve