zengen 0.2.6 → 0.3.1

package/.zen/src/nl-NL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Minimalistische Markdown + AI Statische Site Generator'
+'summary': 'ZEN is een statische site generator met AI-functionaliteiten, speciaal ontworpen voor Markdown-documenten. Het stelt gebruikers in staat om een Git-map met Markdown-bestanden om te zetten in een statische HTML-site, zonder complexe configuratie; alle instellingen zijn verborgen in de .zen-map. Kernfuncties zijn onder meer intelligente categorisatie en navigatie (gebruikmakend van AI om inhoud te analyseren en een sitemap te genereren), automatische incrementele vertaling (ondersteunt meertalige versies, gebruikers kunnen in hun moedertaal schrijven, AI verzorgt de vertaling), en een schrijfervaring met minimale afleiding. De snelstartgids vereist de installatie van Node.js, het verkrijgen van een OpenAI API Key en Git, het bouwen van de site via de commandoregel, en ondersteunt het specificeren van taal en basis-URL.'
+'tags':
+  - 'Statische Site Generator'
+  - 'Markdown'
+  - 'AI'
+  - 'Meertalige Vertaling'
+  - 'Minimalisme'
+  - 'Documentatietool'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistische Markdown + AI Statische Site Generator
+
+[> Website Demo](https://zen.zccz14.com/)
+
+## Basisfunctionaliteiten
+
+1. 📃 **Statische Site Generatie**: Bouw een willekeurige Git-map met Markdown-bestanden om naar een statische HTML-site.
+2. 🧭 **Intelligente Categorisatie en Navigatie**: Gebruik AI voor inhoudsanalyse, genereer een sitemap en navigatie, ongeacht de locatie van de bronbestanden.
+3. 🌍 **Automatische Incrementele Vertaling**: Gebruik AI voor incrementele vertaling, zodat gebruikers in hun moedertaal Markdown kunnen schrijven, maar de site meertalig kan zijn.
+
+Waarom nog een Markdown statische site generator? Ik heb opnieuw nagedacht over hoe documentatietools in het AI-tijdperk schrijvers beter kunnen dienen:
+
+- Terug naar inhoud: Minimale afleiding, focus op schrijven
+
+  Laat documentatie terugkeren naar de essentie, laat schrijven terugkeren naar rust.
+
+  Ten eerste, ik wil geen bibliothecaris zijn. Soms wil ik iets opschrijven, maar ik heb misschien nog geen titel bedacht of een duidelijke structuur gevormd. Ik hoop dat LLM automatisch titels voor me genereert, samenvattingen maakt, categoriseert, navigatie regelt en ander organisatiewerk doet.
+
+  Ten tweede, mijn werkkamer moet opgeruimd zijn. Ik wil geen complexe bouwtools configureren, geen ingewikkelde documentatie-instellingen uitzoeken, en houd niet van complexe structuren. Elke keer als ik de configuratiebestanden en projectstructuren van tools zoals Docusaurus, VuePress, Astro zie, krijg ik hoofdpijn. Nu kiest ZEN ervoor om alle configuratie te verbergen in de .zen-map, weggeveegd in een hoekje. Gebruikers hoeven zich alleen te concentreren op het schrijven van inhoud, de rest laat ZEN afhandelen. Alle andere mappen zijn uw schrijfruimte, u kunt uw Markdown-bestanden vrij organiseren.
+
+- Terug naar moedertaal: Schrijf in je moedertaal, bouw soepel meertalige versies
+
+  Het leven is kort, ik heb geen zin om te vertalen. Mensen kunnen hun denkdiepte het beste benutten wanneer ze hun moedertaal gebruiken. Maar tegelijkertijd is verbinding met de wereld noodzakelijk, ik wil meertalige communicatie niet opgeven. Daarom wilde ik een tool die me in staat stelt in mijn moedertaal te schrijven, terwijl meer mensen mijn inhoud kunnen zien. De huidige i18n vereist niet alleen zelfvertaling, maar ook zelfonderhoud van inhoudsupdates, dat is te veel gedoe. Ik kies ervoor om LLM te gebruiken om voor mij te vertalen, wat me veel tijd bespaart en meertalige vertalingen met één klik mogelijk maakt.
+
+## Snelstart
+
+Vereisten:
+
+- [Node.js](https://nodejs.org/) geïnstalleerd (aanbevolen versie 18 of hoger, npx-commando vereist)
+- Een [OpenAI API Key](https://platform.openai.com/account/api-keys) verkregen, of een OPENAI-compatibele API Key
+- Git geïnstalleerd (om Markdown-bestanden uit Git op te lijsten, bestanden gefilterd door .gitignore-regels te negeren)
+
+Werk eerst in een map die al door Git wordt beheerd:
+
+Configureer omgevingsvariabelen
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Verplicht: Vervang door uw OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Optioneel, gebruikt standaard het officiële OpenAI API
+export OPENAI_MODEL="gpt-3.5-turbo"  # Optioneel, gebruikt standaard het gpt-3.5-turbo model
+```
+
+Bouw de site, ondersteunt meertalige vertaling. Gebruik de huidige map als bronmap, uitvoer naar de `.zen/dist` map.
+
+- U kunt meerdere keren de `--lang` parameter gebruiken om de gewenste taalversies op te geven (bijv. `--lang zh-Hans --lang en-US`).
+- U kunt de `--base-url` parameter gebruiken om het basis-URL-voorvoegsel van de site op te geven (bijv. de repositorynaam op GitHub Pages).
+- Bron taal hoeft niet geconfigureerd te worden, ZEN detecteert dit automatisch.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Meer parameters of hulp bekijken**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/no-NO/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Mermaid-diagramtestdokument'
+'summary': 'Dette dokumentet er en testfil for å validere Mermaid-diagramgjengivelsesfunksjonen i ZEN. Den inneholder eksempler på flere Mermaid-diagramtyper, som flytskjemaer, sekvensdiagrammer, Gantt-diagrammer, klassediagrammer, tilstandsdiagrammer og kakediagrammer, og inkluderer en testsyntaksfeil for å sjekke feilmeldinger. Dokumentet er designet for å vise at Mermaid-integrasjonen i ZEN fungerer som forventet.'
+'tags':
+  - 'Mermaid'
+  - 'diagramtesting'
+  - 'ZEN'
+  - 'flytskjema'
+  - 'sekvensdiagram'
+  - 'Gantt-diagram'
+  - 'klassediagram'
+  - 'tilstandsdiagram'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'no-NO'
+---
+
+# Mermaid-diagramtesting
+
+Dette er en testfil for å validere Mermaid-diagramgjengivelsesfunksjonen i ZEN.
+
+## Eksempel på flytskjema
+
+```mermaid
+graph TD
+    A[Start] --> B{Fortsette?}
+    B -->|Ja| C[Utfør handling]
+    B -->|Nei| D[Avslutt]
+    C --> E[Sjekk resultat]
+    E --> F{Vellykket?}
+    F -->|Ja| G[Fullført]
+    F -->|Nei| H[Prøv på nytt]
+    H --> C
+    G --> D
+```
+
+## Eksempel på sekvensdiagram
+
+```mermaid
+sequenceDiagram
+    participant Bruker
+    participant System
+    participant Database
+
+    Bruker->>System: Send forespørsel
+    System->>Database: Spør etter data
+    Database-->>System: Returner resultat
+    System-->>Bruker: Vis resultat
+```
+
+## Eksempel på Gantt-diagram
+
+```mermaid
+gantt
+    title Prosjekttidsplan
+    dateFormat  YYYY-MM-DD
+    section Design
+    Kravanalyse     :done,    des1, 2024-01-01, 7d
+    Prototypedesign :active,  des2, 2024-01-08, 5d
+    Detaljert design:         des3, after des2, 5d
+    section Utvikling
+    Frontend-utvikling :         dev1, after des3, 10d
+    Backend-utvikling  :         dev2, after des3, 15d
+    section Testing
+    Enhetstesting     :         test1, after dev1, 5d
+    Integrasjonstesting:         test2, after dev2, 5d
+```
+
+## Eksempel på klassediagram
+
+```mermaid
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +void eat()
+        +void sleep()
+    }
+    class Dog {
+        +void bark()
+    }
+    class Cat {
+        +void meow()
+    }
+
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+## Eksempel på tilstandsdiagram
+
+```mermaid
+stateDiagram-v2
+    [*] --> Inaktiv
+    Inaktiv --> Behandler : Start behandling
+    Behandler --> Vellykket : Behandling vellykket
+    Behandler --> Feil : Behandling mislyktes
+    Vellykket --> [*]
+    Feil --> [*]
+```
+
+## Eksempel på kakediagram
+
+```mermaid
+pie title Nettleserbruk
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Annet" : 1.8
+```
+
+## Testsyntaksfeil (skal vise feilmelding)
+
+```mermaid
+graph TD
+    A --> B
+    // Mangler pildedefinisjon her
+    C --> D
+```
+
+Denne testfilen inneholder flere Mermaid-diagramtyper for å validere at Mermaid-integrasjonen i ZEN fungerer som forventet.

package/.zen/src/no-NO/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Minimalistisk Markdown + AI-statisk nettstedbygger'
+'summary': 'ZEN er en statisk nettstedgenerator med AI-integrasjon som fokuserer på å forenkle dokumentasjon og byggeprosessen. Den lar brukere opprette statiske HTML-nettsteder fra git-styrte mapper ved hjelp av Markdown, uten kompleks konfigurasjon – alle innstillinger er skjult i .zen-mappen. Kjernefunksjoner inkluderer intelligent kategorinavigasjon (genererer nettstedskart via AI-analyse), automatisk inkrementell oversettelse (støtter flerspråklige versjoner, brukere kan skrive på morsmålet mens AI håndterer oversettelsen), og en minimalt forstyrrende skriveopplevelse. Verktøyet krever Node.js, OpenAI API-nøkkel og Git, bygges raskt via kommandolinje, og støtter språkparametere som zh-Hans og en-US.'
+'tags':
+  - 'Statisk nettstedgenerator'
+  - 'Markdown'
+  - 'AI'
+  - 'Flerspråklig oversettelse'
+  - 'Minimalisme'
+  - 'Dokumentasjonsverktøy'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistisk Markdown + AI-statisk nettstedbygger
+
+[> Nettsteddemo](https://zen.zccz14.com/)
+
+## Grunnleggende funksjoner
+
+1. 📃 **Statisk nettstedgenerering**: Bygg et statisk HTML-nettsted fra en hvilken som helst git-mappe som inneholder Markdown-filer.
+2. 🧭 **Intelligent kategorinavigasjon**: Bruker AI til å analysere innhold og generere nettstedskart og navigasjon, uavhengig av kildefilenes plassering.
+3. 🌍 **Automatisk inkrementell oversettelse**: Bruker AI til inkrementell oversettelse, slik at brukere kan skrive Markdown på morsmålet, mens nettstedet blir flerspråklig.
+
+Hvorfor lagde jeg enda en Markdown-statisk nettstedgenerator? Jeg har tenkt på hvordan dokumentasjonsverktøy i AI-tiden bedre kan tjene skribenter:
+
+- Tilbake til innholdet: Minimal forstyrrelse, fokus på skriving
+
+  La dokumentasjonen vende tilbake til essensen, og la skrivingen bli rolig.
+
+  For det første vil jeg ikke være bibliotekar. Noen ganger vil jeg skrive ned noe, men jeg har kanskje ikke tenkt ut en tittel ennå, eller organisert det godt. Jeg ønsker at LLM automatisk skal generere titler, lage sammendrag, kategorisere og lage navigasjon for meg.
+
+  For det andre må kontoret mitt være rent. Jeg vil ikke ha komplekse byggeverktøy med innviklede konfigurasjoner, eller krøkkete dokumentasjonsstrukturer. Hver gang jeg ser konfigurasjonsfiler og prosjektstrukturer fra Docusaurus, VuePress eller Astro, får jeg hodepine. Nå har ZEN valgt å skjule all konfigurasjon i .zen-mappen, gjemt bort i et hjørne. Brukeren trenger bare å fokusere på å skrive innhold, resten håndterer ZEN. Alle andre mapper er din skriveplass, du kan organisere Markdown-filene dine som du vil.
+
+- Tilbake til morsmålet: Skriv på morsmålet, bygg flerspråklige versjoner sømløst
+
+  Livet er for kort til at jeg gidder å oversette. Når man bruker morsmålet, kan man tenke på sitt dypeste. Men det er også nødvendig å forbli tilkoblet verden, og jeg vil ikke gi opp flerspråklig kommunikasjon. Derfor ønsker jeg et verktøy som lar meg skrive på morsmålet, samtidig som flere kan se innholdet mitt. Dagens i18n krever at man oversetter selv og vedlikeholder oppdateringer, det er for mye arbeid. Jeg velger å bruke LLM til å oversette for meg, det sparer mye tid og gjør flerspråklige oversettelser til én knappetrykking.
+
+## Kom i gang raskt
+
+Forutsetninger:
+
+- [Node.js](https://nodejs.org/) er installert (anbefalt versjon 18 eller nyere, må ha npx-kommandoen)
+- Du har en [OpenAI API-nøkkel](https://platform.openai.com/account/api-keys), eller en OPENAI-kompatibel API-nøkkel
+- Git er installert (brukes til å liste Markdown-filer fra Git, ignorerer filer filtrert av .gitignore-regler)
+
+Først, arbeid i en mappe som allerede er styrt av Git:
+
+Konfigurer miljøvariabler
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Påkrevd: erstatt med din OpenAI API-nøkkel
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valgfritt, bruker offisiell OpenAI API som standard
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valgfritt, bruker gpt-3.5-turbo-modellen som standard
+```
+
+Bygg nettstedet, støtter flerspråklig oversettelse. Bruker gjeldende mappe som kilde, output til `.zen/dist`-mappen.
+
+- Du kan spesifisere språkversjoner som skal genereres ved å bruke `--lang`-parameteren flere ganger (f.eks. `--lang zh-Hans --lang en-US`).
+- Kilde språk trenger ikke konfigureres, ZEN oppdager det automatisk.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Se flere parametere eller få hjelp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/no-NO/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Minimalistisk Markdown + AI-statisk nettstedbygger'
+'summary': 'ZEN er en statisk nettstedgenerator med AI-funksjoner, spesielt designet for Markdown-dokumenter. Den lar brukere konvertere en Git-mappe som inneholder Markdown-filer til et statisk HTML-nettsted uten kompleks konfigurasjon, med alle innstillinger skjult i .zen-katalogen. Kjernefunksjoner inkluderer intelligent kategorinavigasjon (bruker AI til å analysere innhold og generere nettstedskart), automatisk inkrementell oversettelse (støtter flerspråklige versjoner, brukere kan skrive på morsmålet, AI håndterer oversettelse), og en minimalt forstyrrende skriveopplevelse. Hurtigstartveiledningen krever installasjon av Node.js, anskaffelse av OpenAI API-nøkkel og Git, bygging av nettstedet via kommandolinjen, med støtte for spesifisering av språk og basis-URL.'
+'tags':
+  - 'Statisk nettstedgenerator'
+  - 'Markdown'
+  - 'AI'
+  - 'Flerspråklig oversettelse'
+  - 'Minimalisme'
+  - 'Dokumentverktøy'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistisk Markdown + AI-statisk nettstedbygger
+
+[> Nettsteddemo](https://zen.zccz14.com/)
+
+## Grunnleggende funksjoner
+
+1. 📃 **Statisk nettstedgenerering**: Bygg en hvilken som helst Git-mappe som inneholder Markdown til et statisk HTML-nettsted.
+2. 🧭 **Intelligent kategorinavigasjon**: Bruker AI til innholdsanalyse, genererer nettstedskart og navigasjon, uavhengig av kildefilenes plassering.
+3. 🌍 **Automatisk inkrementell oversettelse**: Bruker AI til inkrementell oversettelse, slik at brukere kan skrive Markdown på morsmålet, men nettstedet kan være flerspråklig.
+
+Hvorfor lagde jeg enda en Markdown-statisk nettstedgenerator? Jeg har tenkt på nytt over hvordan dokumentverktøy i AI-tiden bedre kan tjene skribenter:
+
+- Tilbake til innholdet: Minimal forstyrrelse, fokus på skriving
+
+  La dokumenter gå tilbake til essensen, la skrivingen gå tilbake til ro.
+
+  For det første vil jeg ikke være bibliotekar. Noen ganger vil jeg skrive ned noe, men jeg har kanskje ikke tenkt ut tittelen ennå, eller organisert det spesielt. Jeg ønsker at LLM automatisk skal hjelpe meg med å generere titler, lage sammendrag, kategorisere, navigere og andre organiseringsoppgaver.
+
+  For det andre må mitt skrivebord være rent. Jeg vil ikke ha komplekse konfigurasjonsverktøy, krangle med innviklede dokumentoppsett, eller liker komplekse strukturer. Hver gang jeg ser konfigurasjonsfiler og prosjektstrukturer fra verktøy som Docusaurus, VuePress, Astro, får jeg hodepine. Nå velger ZEN å skjule all konfigurasjon i .zen-katalogen, feie den bort i et hjørne. Brukeren trenger bare å fokusere på å skrive innhold, resten håndteres av ZEN. Alle andre kataloger er ditt skriveområde, du kan organisere Markdown-filene dine som du vil.
+
+- Tilbake til morsmålet: Skriv på morsmålet, bygg flerspråklige versjoner sømløst
+
+  Livet er kort, jeg gidder ikke oversette. Når man bruker morsmålet, kan man utnytte sin tankedybde best. Men samtidig er det nødvendig å forbli tilkoblet verden, jeg vil ikke gi slipp på flerspråklig kommunikasjon. Derfor ønsker jeg et verktøy som lar meg skrive på morsmålet, samtidig som det lar flere se innholdet mitt. Nåværende i18n krever at man oversetter selv, og i tillegg må man vedlikeholde innholdsopdateringer, det er for mye arbeid. Jeg velger å bruke LLM til å hjelpe meg med oversettelse, det sparer mye tid og kan fullføre oversettelse til flere språk med ett klikk.
+
+## Hurtigstart
+
+Forutsetninger:
+
+- [Node.js](https://nodejs.org/) er installert (anbefalt versjon 18 eller høyere, må ha npx-kommandoen)
+- [OpenAI API-nøkkel](https://platform.openai.com/account/api-keys) er anskaffet, eller en OPENAI-kompatibel API-nøkkel
+- Git er installert (brukes til å liste Markdown-filer fra Git, ignorerer filer filtrert av .gitignore-regler)
+
+Først, arbeid i en mappe som allerede er administrert av Git:
+
+Konfigurer miljøvariabler
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Påkrevd: Erstatt med din OpenAI API-nøkkel
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valgfritt, bruker offisiell OpenAI API som standard
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valgfritt, bruker gpt-3.5-turbo-modellen som standard
+```
+
+Bygg nettstedet, støtter flerspråklig oversettelse. Bruker gjeldende katalog som kildekatalog, skriver ut til `.zen/dist`-katalogen.
+
+- Du kan spesifisere språkversjoner som skal genereres ved å bruke `--lang`-parameteren flere ganger (f.eks. `--lang zh-Hans --lang en-US`).
+- Du kan spesifisere nettstedets basis-URL-prefiks med `--base-url`-parameteren (f.eks. depotnavn på GitHub Pages).
+- Kilde språk trenger ikke konfigureres, ZEN oppdager det automatisk.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Se flere parametere eller hjelp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/pl-PL/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Dokument testowy diagramów Mermaid'
+'summary': 'Ten dokument jest plikiem testowym służącym do weryfikacji funkcji renderowania diagramów Mermaid w ZEN. Zawiera przykłady różnych typów diagramów Mermaid, takich jak schematy blokowe, diagramy sekwencji, diagramy Gantta, diagramy klas, diagramy stanów i wykresy kołowe, a także test błędnej składni w celu sprawdzenia wyświetlania komunikatów o błędach. Dokument ma na celu zademonstrowanie poprawnego działania integracji Mermaid w ZEN.'
+'tags':
+  - 'Mermaid'
+  - 'Test diagramów'
+  - 'ZEN'
+  - 'Schemat blokowy'
+  - 'Diagram sekwencji'
+  - 'Diagram Gantta'
+  - 'Diagram klas'
+  - 'Diagram stanów'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'pl-PL'
+---
+
+# Test diagramów Mermaid
+
+To jest plik testowy służący do weryfikacji funkcji renderowania diagramów Mermaid w ZEN.
+
+## Przykład schematu blokowego
+
+```mermaid
+graph TD
+    A[Start] --> B{Czy kontynuować?}
+    B -->|Tak| C[Wykonaj operację]
+    B -->|Nie| D[Koniec]
+    C --> E[Sprawdź wynik]
+    E --> F{Czy sukces?}
+    F -->|Tak| G[Zakończono]
+    F -->|Nie| H[Ponów próbę]
+    H --> C
+    G --> D
+```
+
+## Przykład diagramu sekwencji
+
+```mermaid
+sequenceDiagram
+    participant Użytkownik
+    participant System
+    participant BazaDanych
+
+    Użytkownik->>System: Wyślij żądanie
+    System->>BazaDanych: Zapytaj o dane
+    BazaDanych-->>System: Zwróć wynik
+    System-->>Użytkownik: Wyświetl wynik
+```
+
+## Przykład diagramu Gantta
+
+```mermaid
+gantt
+    title Harmonogram projektu
+    dateFormat  YYYY-MM-DD
+    section Projektowanie
+    Analiza wymagań     :done,    des1, 2024-01-01, 7d
+    Projekt prototypu   :active,  des2, 2024-01-08, 5d
+    Projekt szczegółowy :         des3, after des2, 5d
+    section Rozwój
+    Rozwój frontendu    :         dev1, after des3, 10d
+    Rozwój backendu     :         dev2, after des3, 15d
+    section Testy
+    Testy jednostkowe   :         test1, after dev1, 5d
+    Testy integracyjne  :         test2, after dev2, 5d
+```
+
+## Przykład diagramu klas
+
+```mermaid
+classDiagram
+    class Zwierzę {
+        +String nazwa
+        +int wiek
+        +void jedz()
+        +void śpij()
+    }
+    class Pies {
+        +void szczekaj()
+    }
+    class Kot {
+        +void miaucz()
+    }
+
+    Zwierzę <|-- Pies
+    Zwierzę <|-- Kot
+```
+
+## Przykład diagramu stanów
+
+```mermaid
+stateDiagram-v2
+    [*] --> Bezczynny
+    Bezczynny --> Przetwarzanie : Rozpocznij przetwarzanie
+    Przetwarzanie --> Sukces : Przetwarzanie zakończone sukcesem
+    Przetwarzanie --> Błąd : Przetwarzanie zakończone niepowodzeniem
+    Sukces --> [*]
+    Błąd --> [*]
+```
+
+## Przykład wykresu kołowego
+
+```mermaid
+pie title Udział w rynku przeglądarek
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Inne" : 1.8
+```
+
+## Test błędnej składni (powinien wyświetlić komunikat o błędzie)
+
+```mermaid
+graph TD
+    A --> B
+    // Brak definicji strzałki
+    C --> D
+```
+
+Ten plik testowy zawiera różne typy diagramów Mermaid, służące do weryfikacji, czy integracja Mermaid w ZEN działa poprawnie.

package/.zen/src/pl-PL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Minimalistyczny generator statycznych stron Markdown + AI'
+'summary': 'ZEN to generator statycznych stron zintegrowany z AI, skupiający się na uproszczeniu procesu pisania dokumentów i budowania. Umożliwia użytkownikom tworzenie statycznych stron HTML w folderze zarządzanym przez git przy użyciu Markdown, bez skomplikowanej konfiguracji – wszystkie ustawienia są ukryte w katalogu .zen. Kluczowe funkcje obejmują inteligentną nawigację kategorii (generowanie mapy strony poprzez analizę treści przez AI), automatyczne tłumaczenie przyrostowe (obsługa wersji wielojęzycznych, użytkownicy mogą pisać w języku ojczystym, a AI zajmuje się tłumaczeniem) oraz doświadczenie pisania z minimalnymi zakłóceniami. Narzędzie wymaga Node.js, klucza API OpenAI i Gita, umożliwia szybkie budowanie przez wiersz poleceń i obsługuje parametry językowe, takie jak zh-Hans i en-US.'
+'tags':
+  - 'generator statycznych stron'
+  - 'Markdown'
+  - 'AI'
+  - 'tłumaczenie wielojęzyczne'
+  - 'minimalizm'
+  - 'narzędzie do dokumentacji'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistyczny generator statycznych stron Markdown + AI
+
+[> Demo strony internetowej](https://zen.zccz14.com/)
+
+## Podstawowe funkcje
+
+1.  📃 **Generowanie statycznych stron**: Przekształca dowolny folder git zawierający pliki Markdown w statyczną stronę HTML.
+2.  🧭 **Inteligentna nawigacja kategorii**: Wykorzystuje AI do analizy treści, generując mapę strony i nawigację, niezależnie od lokalizacji plików źródłowych.
+3.  🌍 **Automatyczne tłumaczenie przyrostowe**: Wykorzystuje AI do tłumaczenia przyrostowego, pozwalając użytkownikom pisać w Markdown w języku ojczystym, jednocześnie udostępniając treść w wielu językach.
+
+Po co kolejny generator statycznych stron Markdown? Ponownie przemyślałem, jak narzędzia do dokumentacji w erze AI mogą lepiej służyć autorom:
+
+- **Powrót do treści: Minimalne zakłócenia, skupienie na pisaniu**
+
+  Niech dokumenty wrócą do swojej istoty, a pisanie do spokoju.
+
+  Po pierwsze, nie chcę być bibliotekarzem. Czasami chcę coś napisać, ale może jeszcze nie wymyśliłem tytułu ani nie ukształtowałem struktury. Chcę, aby LLM automatycznie generował dla mnie tytuły, tworzył streszczenia, kategoryzował, organizował nawigację i inne zadania porządkowe.
+
+  Po drugie, moje biurko musi być czyste. Nie chcę skomplikowanych narzędzi do budowania, męczącej konfiguracji dokumentacji ani złożonych struktur. Za każdym razem, gdy widzę pliki konfiguracyjne i struktury projektów takich narzędzi jak Docusaurus, VuePress czy Astro, boli mnie głowa. Teraz ZEN ukrywa całą konfigurację w katalogu `.zen`, zamiatając ją w kąt. Użytkownik musi skupić się tylko na treści, resztą zajmie się ZEN. Wszystkie inne katalogi to Twoja przestrzeń do pisania – możesz dowolnie organizować swoje pliki Markdown.
+
+- **Powrót do języka ojczystego: Pisz w języku ojczystym, płynnie twórz wersje wielojęzyczne**
+
+  Życie jest krótkie, nie mam ochoty na tłumaczenie. Człowiek myśli najgłębiej, gdy używa języka ojczystego. Jednocześnie konieczne jest utrzymanie połączenia ze światem – nie chcę rezygnować z komunikacji wielojęzycznej. Dlatego chcę narzędzia, które pozwoli mi pisać w języku ojczystym, a jednocześnie udostępnić moje treści szerszemu gronu. Obecne rozwiązania i18n wymagają nie tylko własnego tłumaczenia, ale także samodzielnego utrzymywania aktualności treści – to zbyt uciążliwe. Wybieram wykorzystanie LLM do tłumaczenia, co oszczędza mi mnóstwo czasu i pozwala na jednym kliknięciu uzyskać tłumaczenia na wiele języków.
+
+## Szybki start
+
+Wymagania wstępne:
+
+- Zainstalowany [Node.js](https://nodejs.org/) (zalecana wersja 18 lub nowsza, wymagane polecenie `npx`)
+- Uzyskany [klucz API OpenAI](https://platform.openai.com/account/api-keys) lub kompatybilny klucz API OPENAI
+- Zainstalowany Git (do listowania plików Markdown z gita, z pominięciem plików filtrowanych przez reguły `.gitignore`)
+
+Najpierw pracuj w folderze już zarządzanym przez gita:
+
+Skonfiguruj zmienne środowiskowe
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Wymagane: zastąp swoim kluczem API OpenAI
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcjonalne, domyślnie używa oficjalnego API OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opcjonalne, domyślnie używa modelu gpt-3.5-turbo
+```
+
+Zbuduj stronę z obsługą tłumaczenia wielojęzycznego. Użyj bieżącego katalogu jako źródła, wynik zostanie zapisany w katalogu `.zen/dist`.
+
+- Możesz wielokrotnie użyć parametru `--lang`, aby określić wersje językowe do wygenerowania (np. `--lang zh-Hans --lang en-US`).
+- Nie trzeba konfigurować języka źródłowego, ZEN wykryje go automatycznie.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Zobacz więcej parametrów lub pomoc**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/pl-PL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Minimalistyczny generator statycznych stron Markdown + AI'
+'summary': 'ZEN to generator statycznych stron z funkcjami AI, zaprojektowany specjalnie dla dokumentów Markdown. Umożliwia użytkownikom przekształcenie folderu Git zawierającego pliki Markdown w statyczną stronę HTML bez skomplikowanej konfiguracji — wszystkie ustawienia są ukryte w katalogu .zen. Kluczowe funkcje obejmują inteligentną nawigację kategorii (używającą AI do analizy treści i generowania mapy strony), automatyczne tłumaczenie przyrostowe (obsługa wersji wielojęzycznych, użytkownicy mogą pisać w języku ojczystym, a AI zajmuje się tłumaczeniem) oraz doświadczenie pisania z minimalnymi zakłóceniami. Przewodnik szybkiego startu wymaga zainstalowania Node.js, uzyskania klucza API OpenAI i Gita, budowania strony za pomocą wiersza poleceń oraz obsługi określania języka i podstawowego adresu URL.'
+'tags':
+  - 'Generator statycznych stron'
+  - 'Markdown'
+  - 'AI'
+  - 'Tłumaczenie wielojęzyczne'
+  - 'Minimalizm'
+  - 'Narzędzie do dokumentacji'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistyczny generator statycznych stron Markdown + AI
+
+[> Demo strony internetowej](https://zen.zccz14.com/)
+
+## Podstawowe funkcje
+
+1.  📃 **Generowanie statycznych stron**: Przekształć dowolny folder git zawierający pliki Markdown w statyczną stronę HTML.
+2.  🧭 **Inteligentna nawigacja kategorii**: Użyj AI do analizy treści, generowania mapy strony i nawigacji, bez wrażliwości na lokalizację plików źródłowych.
+3.  🌍 **Automatyczne tłumaczenie przyrostowe**: Użyj AI do tłumaczenia przyrostowego, pozwalając użytkownikom pisać w Markdown w języku ojczystym, jednocześnie umożliwiając im tworzenie treści wielojęzycznych.
+
+Dlaczego stworzyłem kolejny generator statycznych stron dla Markdown? Ponownie przemyślałem, jak narzędzia do dokumentacji mogą lepiej służyć pisarzom w erze AI:
+
+- **Powrót do treści: Minimalizacja zakłóceń, skupienie na pisaniu**
+
+  Niech dokumenty wrócą do swojej istoty, a pisanie do spokoju.
+
+  Po pierwsze, nie chcę być bibliotekarzem. Czasami chcę coś napisać, ale może jeszcze nie wymyśliłem tytułu ani nie ukształtowałem struktury. Chcę, aby LLM automatycznie generował dla mnie tytuły, tworzył streszczenia, kategoryzował, organizował nawigację i inne prace porządkowe.
+
+  Po drugie, mój gabinet musi być posprzątany. Nie chcę skomplikowanych narzędzi do budowania, męczącej konfiguracji dokumentacji ani złożonych struktur. Za każdym razem, gdy widzę pliki konfiguracyjne i struktury projektów takich narzędzi jak Docusaurus, VuePress czy Astro, boli mnie głowa. Teraz ZEN ukrywa całą konfigurację w katalogu `.zen`, zamiatając ją w kąt. Użytkownik musi skupić się tylko na treści, resztą zajmie się ZEN. Wszystkie inne katalogi to Twoja przestrzeń do pisania — możesz dowolnie organizować swoje pliki Markdown.
+
+- **Powrót do języka ojczystego: Pisz w języku ojczystym, płynnie twórz wersje wielojęzyczne**
+
+  Życie jest krótkie, nie mam ochoty na tłumaczenie. Człowiek myśli najgłębiej, gdy używa języka ojczystego. Jednocześnie konieczne jest utrzymanie kontaktu ze światem — nie chcę rezygnować z komunikacji wielojęzykowej. Dlatego chcę narzędzia, które pozwoli mi pisać w języku ojczystym, a jednocześnie dotrzeć z treścią do większej liczby osób. Obecne rozwiązania i18n wymagają samodzielnego tłumaczenia i utrzymywania aktualności treści, co jest zbyt uciążliwe. Wybieram użycie LLM do pomocy w tłumaczeniu, oszczędzając mnóstwo czasu i umożliwiając tłumaczenie na wiele języków jednym kliknięciem.
+
+## Szybki start
+
+Wymagania wstępne:
+
+- Zainstalowany [Node.js](https://nodejs.org/) (zalecana wersja 18 lub nowsza, wymagane polecenie `npx`)
+- Uzyskany [klucz API OpenAI](https://platform.openai.com/account/api-keys) lub kompatybilny klucz API OPENAI
+- Zainstalowany Git (do listowania plików Markdown z Gita, z pominięciem plików filtrowanych przez reguły `.gitignore`)
+
+Najpierw pracuj w folderze zarządzanym przez gita:
+
+Skonfiguruj zmienne środowiskowe
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Wymagane: zastąp swoim kluczem API OpenAI
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opcjonalne, domyślnie używa oficjalnego API OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opcjonalne, domyślnie używa modelu gpt-3.5-turbo
+```
+
+Zbuduj stronę, obsługującą tłumaczenie wielojęzyczne. Użyj bieżącego katalogu jako katalogu źródłowego, wynik zostanie zapisany w katalogu `.zen/dist`.
+
+- Możesz wielokrotnie użyć parametru `--lang`, aby określić wersje językowe do wygenerowania (np. `--lang zh-Hans --lang en-US`).
+- Możesz użyć parametru `--base-url`, aby określić podstawowy prefiks URL strony (np. nazwa repozytorium na GitHub Pages).
+- Nie ma potrzeby konfigurowania języka źródłowego, ZEN wykryje go automatycznie.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Zobacz więcej parametrów lub uzyskaj pomoc**:
+
+```bash
+npx zengen@latest
+```