zengen 0.2.6 → 0.3.1

package/.zen/src/ru-RU/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - минималистичный Markdown + AI генератор статических сайтов'
+'summary': 'ZEN — это генератор статических сайтов с интеграцией AI, ориентированный на упрощение написания документации и процесса сборки. Он позволяет пользователям создавать статические HTML-сайты в папках под управлением git с использованием Markdown, без сложных конфигураций — все настройки скрыты в каталоге .zen. Ключевые функции включают интеллектуальную навигацию по категориям (генерация карты сайта через анализ контента с помощью AI), автоматический инкрементный перевод (поддержка многоязычных версий, пользователи могут писать на родном языке, а AI обрабатывает перевод) и минималистичный опыт написания. Инструмент зависит от Node.js, ключа OpenAI API и Git, быстро собирается через командную строку и поддерживает указание языковых параметров, таких как zh-Hans и en-US.'
+'tags':
+  - 'генератор статических сайтов'
+  - 'Markdown'
+  - 'AI'
+  - 'многоязычный перевод'
+  - 'минимализм'
+  - 'инструмент для документации'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - минималистичный Markdown + AI генератор статических сайтов
+
+[> Демо сайта](https://zen.zccz14.com/)
+
+## Основные функции
+
+1. 📃 **Генерация статических сайтов**: Преобразует любую папку с Markdown-файлами под управлением git в статический HTML-сайт.
+2. 🧭 **Интеллектуальная навигация по категориям**: Использует AI для анализа контента, генерации карты сайта и навигации, независимо от расположения исходных файлов.
+3. 🌍 **Автоматический инкрементный перевод**: Использует AI для инкрементного перевода, позволяя пользователям писать Markdown на родном языке, но при этом поддерживать многоязычность.
+
+Зачем ещё один генератор статических сайтов на Markdown? Я переосмыслил, как инструменты для документации могут лучше служить авторам в эпоху AI:
+
+- Возвращение к содержанию: Минимизация отвлечений, фокус на написании
+
+  Вернуть документации её суть, а написанию — спокойствие.
+
+  Во-первых, я не хочу быть библиотекарем. Иногда я хочу записать что-то, но ещё не придумал заголовок или не организовал это должным образом. Я хочу, чтобы LLM автоматически генерировала заголовки, делала выжимки, классифицировала и организовывала навигацию.
+
+  Во-вторых, мой рабочий кабинет должен быть чистым. Мне не нужны сложные инструменты сборки с запутанными конфигурациями, сложные структуры документов. Каждый раз, когда я вижу конфигурационные файлы и структуры проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN прячет все настройки в каталог .zen, сметая их в угол, чтобы пользователь мог сосредоточиться на содержании, а всё остальное ZEN берёт на себя. Все остальные каталоги — ваше пространство для письма, вы можете свободно организовывать свои Markdown-файлы.
+
+- Возвращение к родному языку: Пишите на родном языке, плавно создавайте многоязычные версии
+
+  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, когда использует родной язык. Но при этом оставаться на связи с миром необходимо, и я не хочу отказываться от многоязычного общения. Поэтому мне нужен инструмент, который позволит мне писать на родном языке, но при этом сделать мой контент доступным для большего числа людей. Текущие решения i18n требуют самостоятельного перевода и поддержки обновлений контента, что слишком хлопотно. Я выбираю использование LLM для перевода, что экономит много времени и позволяет одним кликом выполнить перевод на множество языков.
+
+## Быстрый старт
+
+Предварительные требования:
+
+- Установлен [Node.js](https://nodejs.org/) (рекомендуется версия 18 и выше, должна быть доступна команда npx)
+- Получен [OpenAI API Key](https://platform.openai.com/account/api-keys) или совместимый с OPENAI ключ API
+- Установлен Git (для получения списка Markdown-файлов из Git, игнорируются файлы, отфильтрованные по правилам .gitignore)
+
+Сначала работайте в папке, которая уже находится под управлением Git:
+
+Настройте переменные окружения
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Обязательно: замените на ваш OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Опционально, по умолчанию используется официальный API OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Опционально, по умолчанию используется модель gpt-3.5-turbo
+```
+
+Соберите сайт с поддержкой многоязычного перевода. Использует текущий каталог как исходный, вывод в каталог `.zen/dist`.
+
+- Можно несколько раз использовать параметр `--lang` для указания нужных языковых версий (например, `--lang zh-Hans --lang en-US`).
+- Исходный язык указывать не нужно, ZEN определит его автоматически.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Просмотреть больше параметров или справку**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/ru-RU/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - минималистичный Markdown + AI генератор статических сайтов'
+'summary': 'ZEN — это генератор статических сайтов с функциями искусственного интеллекта, разработанный специально для документов Markdown. Он позволяет пользователям преобразовывать Git-папки с файлами Markdown в статические HTML-сайты без сложных настроек — все конфигурации скрыты в каталоге .zen. Ключевые функции включают интеллектуальную навигацию по категориям (с использованием AI для анализа содержимого и создания карты сайта), автоматический инкрементный перевод (поддержка многоязычных версий, позволяющая пользователям писать на родном языке, а AI обрабатывает перевод) и минималистичный опыт написания. Руководство по быстрому старту требует установки Node.js, получения OpenAI API Key и Git, сборки сайта через командную строку с поддержкой указания языка и базового URL.'
+'tags':
+  - 'генератор статических сайтов'
+  - 'Markdown'
+  - 'AI'
+  - 'многоязычный перевод'
+  - 'минимализм'
+  - 'инструмент для документов'
+  - 'Git'
+'inferred_lang': 'ru-RU'
+---
+
+# ZEN - минималистичный Markdown + AI генератор статических сайтов
+
+[> Демо сайта](https://zen.zccz14.com/)
+
+## Основные функции
+
+1. 📃 **Генерация статических сайтов**: Преобразуйте любую Git-папку с Markdown-файлами в статический HTML-сайт.
+2. 🧭 **Интеллектуальная навигация по категориям**: Используйте AI для анализа содержимого, создания карты сайта и навигации, независимо от расположения исходных файлов.
+3. 🌍 **Автоматический инкрементный перевод**: Используйте AI для инкрементного перевода, позволяя пользователям писать Markdown на родном языке, но при этом поддерживая многоязычность.
+
+Зачем ещё один генератор статических сайтов для Markdown? Я переосмыслил, как инструменты для документов могут лучше служить авторам в эпоху AI:
+
+- Возвращение к содержанию: Минимизация отвлечений, фокус на написании
+
+  Вернуть документам их суть, а написанию — спокойствие.
+
+  Во-первых, я не хочу быть библиотекарем. Иногда я хочу записать что-то, но ещё не придумал заголовок или не организовал это должным образом. Я хочу, чтобы LLM автоматически генерировала заголовки, делала аннотации, классифицировала и организовывала навигацию.
+
+  Во-вторых, мой рабочий кабинет должен быть чистым. Мне не нужны сложные инструменты сборки с запутанными конфигурациями, сложные структуры документов. Каждый раз, когда я вижу конфигурационные файлы и структуры проектов таких инструментов, как Docusaurus, VuePress, Astro, у меня начинает болеть голова. Теперь ZEN скрывает все настройки в каталоге .zen, убирая их с глаз долой. Пользователю нужно только сосредоточиться на написании контента, а всё остальное ZEN берёт на себя. Все остальные каталоги — это ваше пространство для письма, вы можете свободно организовывать свои Markdown-файлы.
+
+- Возвращение к родному языку: Пишите на родном языке, плавно создавайте многоязычные версии
+
+  Жизнь коротка, мне лень переводить. Человек наиболее полно раскрывает глубину своего мышления, когда использует родной язык. Но при этом необходимо оставаться на связи с миром, и я не хочу отказываться от многоязычного общения. Поэтому мне нужен инструмент, который позволит мне писать на родном языке, но при этом сделать мой контент доступным для большего числа людей. Текущие решения i18n требуют самостоятельного перевода и поддержки обновлений контента, что слишком хлопотно. Я выбрал использование LLM для перевода, что экономит много времени и позволяет выполнить перевод на несколько языков одним нажатием.
+
+## Быстрый старт
+
+Предварительные требования:
+
+- Установлен [Node.js](https://nodejs.org/) (рекомендуется версия 18 и выше, должна быть доступна команда npx)
+- Получен [OpenAI API Key](https://platform.openai.com/account/api-keys) или совместимый с OPENAI API Key
+- Установлен Git (для получения списка Markdown-файлов из Git, игнорируя файлы, отфильтрованные по правилам .gitignore)
+
+Сначала работайте в папке, которая уже управляется Git:
+
+Настройте переменные окружения
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Обязательно: замените на ваш OpenAI API Key
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Опционально, по умолчанию используется официальный API OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Опционально, по умолчанию используется модель gpt-3.5-turbo
+```
+
+Соберите сайт с поддержкой многоязычного перевода. Используйте текущий каталог как исходный, вывод будет в каталог `.zen/dist`.
+
+- Можно указать нужные языковые версии, несколько раз используя параметр `--lang` (например, `--lang ru-RU --lang en-US`).
+- Можно указать базовый префикс URL сайта с помощью параметра `--base-url` (например, имя репозитория на GitHub Pages).
+- Исходный язык указывать не нужно, ZEN определит его автоматически.
+
+```bash
+npx zengen@latest build --lang ru-RU --lang en-US
+```
+
+**Посмотреть больше параметров или справку**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/sv-SE/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Mermaid-diagramtestdokument'
+'summary': 'Detta dokument är en testfil för att verifiera Mermaid-diagramrendering i ZEN. Den innehåller exempel på flera Mermaid-diagramtyper, såsom flödesschema, sekvensdiagram, Gantt-schema, klassdiagram, tillståndsdiagram och cirkeldiagram, samt ett test med felaktig syntax för att kontrollera felmeddelandevisning. Dokumentet syftar till att demonstrera Mermaid-integrationens korrekta funktion i ZEN.'
+'tags':
+  - 'Mermaid'
+  - 'Diagramtest'
+  - 'ZEN'
+  - 'Flödesschema'
+  - 'Sekvensdiagram'
+  - 'Gantt-schema'
+  - 'Klassdiagram'
+  - 'Tillståndsdiagram'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'sv-SE'
+---
+
+# Mermaid-diagramtest
+
+Detta är en testfil för att verifiera Mermaid-diagramrendering i ZEN.
+
+## Exempel på flödesschema
+
+```mermaid
+graph TD
+    A[Start] --> B{Fortsätt?}
+    B -->|Ja| C[Utför åtgärd]
+    B -->|Nej| D[Avsluta]
+    C --> E[Kontrollera resultat]
+    E --> F{Lyckades?}
+    F -->|Ja| G[Klart]
+    F -->|Nej| H[Försök igen]
+    H --> C
+    G --> D
+```
+
+## Exempel på sekvensdiagram
+
+```mermaid
+sequenceDiagram
+    participant Användare
+    participant System
+    participant Databas
+
+    Användare->>System: Skicka förfrågan
+    System->>Databas: Sök data
+    Databas-->>System: Returnera resultat
+    System-->>Användare: Visa resultat
+```
+
+## Exempel på Gantt-schema
+
+```mermaid
+gantt
+    title Projektplan
+    dateFormat  YYYY-MM-DD
+    section Design
+    Kravanalys     :done,    des1, 2024-01-01, 7d
+    Prototypdesign :active,  des2, 2024-01-08, 5d
+    Detaljdesign   :         des3, after des2, 5d
+    section Utveckling
+    Frontendutveckling :         dev1, after des3, 10d
+    Backendutveckling  :         dev2, after des3, 15d
+    section Test
+    Enhetstest     :         test1, after dev1, 5d
+    Integrationstest :         test2, after dev2, 5d
+```
+
+## Exempel på klassdiagram
+
+```mermaid
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +void eat()
+        +void sleep()
+    }
+    class Dog {
+        +void bark()
+    }
+    class Cat {
+        +void meow()
+    }
+
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+## Exempel på tillståndsdiagram
+
+```mermaid
+stateDiagram-v2
+    [*] --> Viloläge
+    Viloläge --> Bearbetning : Starta bearbetning
+    Bearbetning --> Framgång : Bearbetning lyckades
+    Bearbetning --> Fel : Bearbetning misslyckades
+    Framgång --> [*]
+    Fel --> [*]
+```
+
+## Exempel på cirkeldiagram
+
+```mermaid
+pie title Webbläsaranvändning
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Övriga" : 1.8
+```
+
+## Test av felaktig syntax (borde visa felmeddelande)
+
+```mermaid
+graph TD
+    A --> B
+    // Här saknas pildefinition
+    C --> D
+```
+
+Denna testfil innehåller flera Mermaid-diagramtyper för att verifiera att ZEN:s Mermaid-integration fungerar korrekt.

package/.zen/src/sv-SE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Minimalistisk Markdown + AI Static Site Builder'
+'summary': 'ZEN är en AI-integrerad statisk webbplatsgenerator som fokuserar på att förenkla dokumentationsskrivande och byggprocessen. Den låter användare skapa statiska HTML-webbplatser från git-hanterade mappar med Markdown, utan komplex konfiguration – alla inställningar är dolda i .zen-katalogen. Kärnfunktioner inkluderar intelligent kategorinavigering (genererar webbplatskarta via AI-innehållsanalys), automatisk inkrementell översättning (stödjer flerspråkiga versioner, användare kan skriva på modersmålet medan AI hanterar översättningar) och en skrivupplevelse med minimal störning. Verktyget kräver Node.js, OpenAI API-nyckel och Git, byggs snabbt via kommandoraden och stöder språkparametrar som zh-Hans och en-US.'
+'tags':
+  - 'Statisk webbplatsgenerator'
+  - 'Markdown'
+  - 'AI'
+  - 'Flerspråkig översättning'
+  - 'Minimalism'
+  - 'Dokumentationsverktyg'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistisk Markdown + AI Static Site Builder
+
+[> Webbplatsdemo](https://zen.zccz14.com/)
+
+## Grundläggande funktioner
+
+1. 📃 **Statisk webbplatsgenerering**: Bygg en statisk HTML-webbplats från valfri git-hanterad mapp som innehåller Markdown.
+2. 🧭 **Intelligent kategorinavigering**: Använder AI för innehållsanalys, genererar webbplatskarta och navigation – känslighet för källfilens placering elimineras.
+3. 🌍 **Automatisk inkrementell översättning**: Använder AI för inkrementell översättning, låter användare skriva Markdown på modersmålet samtidigt som webbplatsen blir flerspråkig.
+
+Varför ännu en Markdown-statisk-webbplatsgenerator? Jag har tänkt på hur dokumentationsverktyg i AI-eran bättre kan tjäna författare:
+
+- Återgå till innehållet: Minimal störning, fokus på skrivande
+
+  Låt dokumentationen återgå till sin essens, låt skrivandet återvända till lugn och ro.
+
+  För det första vill jag inte vara bibliotekarie. Ibland vill jag skriva ner något, men jag kanske inte har bestämt mig för en titel eller format ännu. Jag vill att LLM automatiskt genererar titlar, sammanfattningar, kategoriseringar, navigering och annan organisering.
+
+  För det andra måste mitt skrivbord hållas rent. Jag vill inte ha komplexa byggverktyg, krångla med komplicerade dokumentationskonfigurationer eller invecklade strukturer. Varje gång jag ser konfigurationsfiler och projektstrukturer för verktyg som Docusaurus, VuePress eller Astro får jag huvudvärk. Nu har ZEN valt att gömma all konfiguration i .zen-katalogen – sopa undan den i ett hörn. Användaren behöver bara fokusera på innehållet, resten hanterar ZEN. Alla andra kataloger är ditt skrivutrymme, du kan organisera dina Markdown-filer hur du vill.
+
+- Återgå till modersmålet: Skriv på modersmålet, bygg smidiga flerspråkiga versioner
+
+  Livet är för kort för att översätta. När man använder sitt modersmål kan man uttrycka sina tankar på djupast sätt. Men att hålla kontakten med världen är också nödvändigt – jag vill inte avstå från flerspråkig kommunikation. Därför vill jag ha ett verktyg som låter mig skriva på modersmålet samtidigt som fler kan se mitt innehåll. Nuvarande i18n-lösningar kräver inte bara egenöversättning utan även egen underhåll av innehållsuppdateringar – för besvärligt. Jag väljer att använda LLM för översättningar, sparar massor av tid och kan skapa flerspråkiga versioner med ett knapptryck.
+
+## Snabbstart
+
+Förutsättningar:
+
+- [Node.js](https://nodejs.org/) installerad (rekommenderas version 18 eller senare, npx-kommando krävs)
+- [OpenAI API-nyckel](https://platform.openai.com/account/api-keys) erhållen, eller OpenAI-kompatibel API-nyckel
+- Git installerad (används för att lista Markdown-filer från Git, ignorerar filer filtrerade av .gitignore-regler)
+
+Först, arbeta i en mapp som redan hanteras av git:
+
+Konfigurera miljövariabler
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatoriskt: Ersätt med din OpenAI API-nyckel
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valfritt, använder OpenAIs officiella API som standard
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valfritt, använder gpt-3.5-turbo-modellen som standard
+```
+
+Bygg webbplatsen, stöder flerspråkig översättning. Använder aktuell katalog som källkatalog, skriver ut till `.zen/dist`-katalogen.
+
+- Du kan ange språkversioner som ska genereras genom att använda `--lang`-parametern flera gånger (t.ex. `--lang zh-Hans --lang en-US`).
+- Ingen källspråkskonfiguration behövs, ZEN upptäcker automatiskt.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Visa fler parametrar eller hjälp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/sv-SE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Minimalistisk Markdown + AI-statisk webbplatsbyggare'
+'summary': 'ZEN är en statisk webbplatsbyggare med AI-funktioner, speciellt utformad för Markdown-dokument. Den låter användare omvandla en Git-mapp med Markdown-filer till en statisk HTML-webbplats utan krånglig konfiguration – alla inställningar är dolda i .zen-katalogen. Kärnfunktioner inkluderar intelligent kategorinavigering (använder AI för att analysera innehåll och generera en webbplatskarta), automatisk inkrementell översättning (stödjer flerspråkiga versioner, användare kan skriva på sitt modersmål medan AI hanterar översättningen) och en skrivupplevelse med minimal störning. Snabbstartsguiden kräver installation av Node.js, hämtning av en OpenAI API-nyckel och Git, byggande av webbplatsen via kommandoraden, med stöd för att specificera språk och bas-URL.'
+'tags':
+  - 'Statisk webbplatsbyggare'
+  - 'Markdown'
+  - 'AI'
+  - 'Flerspråkig översättning'
+  - 'Minimalism'
+  - 'Dokumentationsverktyg'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Minimalistisk Markdown + AI-statisk webbplatsbyggare
+
+[> Webbplatsdemo](https://zen.zccz14.com/)
+
+## Grundläggande funktioner
+
+1. 📃 **Statisk webbplatsbyggnad**: Bygg en statisk HTML-webbplats från valfri git-mapp som innehåller Markdown.
+2. 🧭 **Intelligent kategorinavigering**: Använder AI för innehållsanalys, genererar webbplatskarta och navigering, känslighet för källfilernas placering är låg.
+3. 🌍 **Automatisk inkrementell översättning**: Använder AI för inkrementell översättning, låter användare skriva Markdown på sitt modersmål, men webbplatsen kan vara flerspråkig.
+
+Varför ännu en Markdown-statisk webbplatsbyggare? Jag har tänkt om hur dokumentationsverktyg i AI-eran bättre kan tjäna författare:
+
+- Återgå till innehållet: Minimera störningar, fokusera på skrivandet
+
+  Låt dokumentationen återgå till sin kärna, låt skrivandet återvända till lugn och ro.
+
+  För det första vill jag inte vara bibliotekarie. Ibland vill jag skriva ner något, men jag kanske inte har bestämt mig för en titel ännu eller format en tydlig struktur. Jag vill att LLM automatiskt ska generera titlar, göra sammanfattningar, kategorisera, skapa navigering och andra organisatoriska uppgifter.
+
+  För det andra måste mitt skrivbord hållas rent. Jag vill inte ha krångliga byggverktyg, krångla med komplex dokumentationskonfiguration eller gilla invecklade strukturer. Varje gång jag ser konfigurationsfiler och projektstrukturer för verktyg som Docusaurus, VuePress eller Astro får jag huvudvärk. Nu väljer ZEN att gömma all konfiguration i .zen-katalogen, sopa undan den i ett hörn, så att användaren bara kan fokusera på att skriva innehåll – resten hanterar ZEN. Alla andra kataloger är ditt skrivutrymme, du kan organisera dina Markdown-filer hur du vill.
+
+- Återgå till modersmålet: Skriv på ditt modersmål, bygg smidigt flerspråkiga versioner
+
+  Livet är kort, jag har inte tid att översätta. När man använder sitt modersmål kan man uttrycka sina tankar på djupast sätt. Men att hålla kontakten med världen är också nödvändigt, jag vill inte avstå från flerspråkig kommunikation. Därför vill jag ha ett verktyg som låter mig skriva på mitt modersmål, samtidigt som det gör mitt innehåll tillgängligt för fler. Nuvarande i18n kräver inte bara att man översätter själv, utan också att man underhåller innehållsuppdateringar – för besvärligt. Jag väljer att använda LLM för att hjälpa mig med översättningar, vilket sparar mycket tid och gör det möjligt att slutföra flerspråkiga översättningar med ett knapptryck.
+
+## Snabbstart
+
+Förutsättningar:
+
+- [Node.js](https://nodejs.org/) installerad (rekommenderad version 18 eller senare, npx-kommandot måste finnas)
+- [OpenAI API-nyckel](https://platform.openai.com/account/api-keys) hämtad, eller en OPENAI-kompatibel API-nyckel
+- Git installerat (används för att lista Markdown-filer från Git, ignorerar filer som filtreras bort av .gitignore-regler)
+
+Först, arbeta i en mapp som redan hanteras av git:
+
+Konfigurera miljövariabler
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obligatoriskt: Ersätt med din OpenAI API-nyckel
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Valfritt, använder OpenAIs officiella API som standard
+export OPENAI_MODEL="gpt-3.5-turbo"  # Valfritt, använder gpt-3.5-turbo-modellen som standard
+```
+
+Bygg webbplatsen, stödjer flerspråkig översättning. Använd aktuell katalog som källkatalog, skicka utdata till `.zen/dist`-katalogen.
+
+- Du kan ange språkversioner som behöver genereras genom att använda `--lang`-parametern flera gånger (t.ex. `--lang zh-Hans --lang en-US`).
+- Du kan ange webbplatsens bas-URL-prefix med `--base-url`-parametern (t.ex. ett reponamn på GitHub Pages).
+- Ingen konfiguration av källspråk behövs, ZEN upptäcker det automatiskt.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Visa fler parametrar eller hjälp**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/th-TH/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'เอกสารทดสอบไดอะแกรม Mermaid'
+'summary': 'เอกสารนี้เป็นไฟล์ทดสอบสำหรับตรวจสอบความสามารถในการแสดงผลไดอะแกรม Mermaid ใน ZEN ประกอบด้วยตัวอย่างไดอะแกรม Mermaid หลายประเภท เช่น โฟลว์ชาร์ต ไดอะแกรมลำดับ แกนต์ชาร์ต ไดอะแกรมคลาส ไดอะแกรมสถานะ และแผนภูมิวงกลม พร้อมทั้งรวมการทดสอบไวยากรณ์ผิดพลาดเพื่อตรวจสอบการแสดงข้อความผิดพลาด เอกสารนี้มีวัตถุประสงค์เพื่อแสดงสถานะการทำงานปกติของการผสานรวม Mermaid ใน ZEN'
+'tags':
+  - 'Mermaid'
+  - 'การทดสอบไดอะแกรม'
+  - 'ZEN'
+  - 'โฟลว์ชาร์ต'
+  - 'ไดอะแกรมลำดับ'
+  - 'แกนต์ชาร์ต'
+  - 'ไดอะแกรมคลาส'
+  - 'ไดอะแกรมสถานะ'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'th-TH'
+---
+
+# การทดสอบไดอะแกรม Mermaid
+
+นี่คือไฟล์ทดสอบสำหรับตรวจสอบความสามารถในการแสดงผลไดอะแกรม Mermaid ใน ZEN
+
+## ตัวอย่างโฟลว์ชาร์ต
+
+```mermaid
+graph TD
+    A[เริ่มต้น] --> B{ดำเนินการต่อ?}
+    B -->|ใช่| C[ดำเนินการ]
+    B -->|ไม่| D[สิ้นสุด]
+    C --> E[ตรวจสอบผลลัพธ์]
+    E --> F{สำเร็จหรือไม่?}
+    F -->|ใช่| G[เสร็จสิ้น]
+    F -->|ไม่| H[ลองใหม่]
+    H --> C
+    G --> D
+```
+
+## ตัวอย่างไดอะแกรมลำดับ
+
+```mermaid
+sequenceDiagram
+    participant ผู้ใช้
+    participant ระบบ
+    participant ฐานข้อมูล
+
+    ผู้ใช้->>ระบบ: ส่งคำขอ
+    ระบบ->>ฐานข้อมูล: ค้นหาข้อมูล
+    ฐานข้อมูล-->>ระบบ: ส่งกลับผลลัพธ์
+    ระบบ-->>ผู้ใช้: แสดงผลลัพธ์
+```
+
+## ตัวอย่างแกนต์ชาร์ต
+
+```mermaid
+gantt
+    title ตารางเวลาโครงการ
+    dateFormat  YYYY-MM-DD
+    section การออกแบบ
+    วิเคราะห์ความต้องการ     :done,    des1, 2024-01-01, 7d
+    ออกแบบต้นแบบ     :active,  des2, 2024-01-08, 5d
+    ออกแบบรายละเอียด     :         des3, after des2, 5d
+    section การพัฒนา
+    พัฒนาด้านหน้าบ้าน     :         dev1, after des3, 10d
+    พัฒนาด้านหลังบ้าน     :         dev2, after des3, 15d
+    section การทดสอบ
+    ทดสอบหน่วย     :         test1, after dev1, 5d
+    ทดสอบบูรณาการ     :         test2, after dev2, 5d
+```
+
+## ตัวอย่างไดอะแกรมคลาส
+
+```mermaid
+classDiagram
+    class สัตว์ {
+        +String ชื่อ
+        +int อายุ
+        +void กิน()
+        +void นอน()
+    }
+    class สุนัข {
+        +void เห่า()
+    }
+    class แมว {
+        +void ร้อง()
+    }
+
+    สัตว์ <|-- สุนัข
+    สัตว์ <|-- แมว
+```
+
+## ตัวอย่างไดอะแกรมสถานะ
+
+```mermaid
+stateDiagram-v2
+    [*] --> รออยู่
+    รออยู่ --> กำลังประมวลผล : เริ่มประมวลผล
+    กำลังประมวลผล --> สำเร็จ : ประมวลผลสำเร็จ
+    กำลังประมวลผล --> ผิดพลาด : ประมวลผลล้มเหลว
+    สำเร็จ --> [*]
+    ผิดพลาด --> [*]
+```
+
+## ตัวอย่างแผนภูมิวงกลม
+
+```mermaid
+pie title อัตราการใช้เบราว์เซอร์
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "อื่นๆ" : 1.8
+```
+
+## การทดสอบไวยากรณ์ผิดพลาด (ควรแสดงข้อความผิดพลาด)
+
+```mermaid
+graph TD
+    A --> B
+    // ขาดการกำหนดลูกศรที่นี่
+    C --> D
+```
+
+ไฟล์ทดสอบนี้ประกอบด้วยไดอะแกรม Mermaid หลายประเภท เพื่อตรวจสอบว่าการผสานรวม Mermaid ใน ZEN ทำงานได้ปกติ

package/.zen/src/th-TH/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - เครื่องมือสร้างเว็บไซต์แบบสแตติกด้วย Markdown + AI แนวมินิมัลลิสต์'
+'summary': 'ZEN เป็นเครื่องมือสร้างเว็บไซต์แบบสแตติกที่ผสาน AI โดยมุ่งเน้นการลดความซับซ้อนของกระบวนการเขียนและสร้างเอกสาร ผู้ใช้สามารถสร้างเว็บไซต์ HTML แบบสแตติกจากโฟลเดอร์ที่จัดการด้วย git โดยใช้ Markdown ได้โดยไม่ต้องตั้งค่าซับซ้อน การตั้งค่าทั้งหมดถูกซ่อนไว้ในไดเรกทอรี .zen ฟีเจอร์หลักประกอบด้วยการนำทางอัจฉริยะแบบจัดหมวดหมู่ (สร้างแผนที่เว็บไซต์ผ่านการวิเคราะห์เนื้อหาด้วย AI) การแปลแบบเพิ่มอัตโนมัติ (รองรับหลายภาษา ผู้ใช้สามารถเขียนด้วยภาษาหลักได้ โดย AI จะจัดการการแปล) และประสบการณ์การเขียนที่รบกวนผู้ใช้น้อยที่สุด เครื่องมือนี้ต้องใช้ Node.js, คีย์ OpenAI API และ Git สามารถสร้างผ่าน command line ได้อย่างรวดเร็ว และรองรับพารามิเตอร์ภาษาที่ระบุ เช่น zh-Hans และ en-US'
+'tags':
+  - 'เครื่องมือสร้างเว็บไซต์แบบสแตติก'
+  - 'Markdown'
+  - 'AI'
+  - 'การแปลหลายภาษา'
+  - 'มินิมัลลิสต์'
+  - 'เครื่องมือเอกสาร'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - เครื่องมือสร้างเว็บไซต์แบบสแตติกด้วย Markdown + AI แนวมินิมัลลิสต์
+
+[> ตัวอย่างเว็บไซต์](https://zen.zccz14.com/)
+
+## ฟังก์ชันพื้นฐาน
+
+1.  📃 **การสร้างเว็บไซต์แบบสแตติก**: แปลงโฟลเดอร์ใดๆ ที่มีไฟล์ Markdown และถูกจัดการด้วย git ให้เป็นเว็บไซต์ HTML แบบสแตติก
+2.  🧭 **การนำทางอัจฉริยะแบบจัดหมวดหมู่**: ใช้ AI ในการวิเคราะห์เนื้อหาเพื่อสร้างแผนที่เว็บไซต์และการนำทาง โดยไม่ขึ้นกับตำแหน่งของไฟล์ต้นฉบับ
+3.  🌍 **การแปลแบบเพิ่มอัตโนมัติ**: ใช้ AI ในการแปลแบบเพิ่มส่วน ทำให้ผู้ใช้สามารถเขียน Markdown ด้วยภาษาหลักได้ แต่ผู้ใช้สามารถเข้าถึงเนื้อหาได้หลายภาษา
+
+ทำไมต้องสร้างเครื่องมือสร้างเว็บไซต์แบบสแตติกจาก Markdown ขึ้นมาอีก? ผมได้ทบทวนใหม่ว่าในยุคของ AI เครื่องมือเอกสารสามารถบริการผู้เขียนได้ดีขึ้นอย่างไร:
+
+- กลับสู่เนื้อหา: รบกวนน้อยที่สุด มุ่งเน้นที่การเขียน
+
+  นำเอกสารกลับสู่แก่นแท้ นำความสงบกลับสู่การเขียน
+
+  ประการแรก ผมไม่อยากเป็นบรรณารักษ์ บางครั้งผมอยากเขียนบางสิ่งลงไป แต่ผมอาจยังไม่ได้คิดชื่อเรื่องให้ดี หรือยังไม่ได้จัดระเบียบเป็นพิเศษ ผมหวังว่า LLM จะช่วยสร้างชื่อเรื่อง สรุปเนื้อหา จัดหมวดหมู่ และจัดการนำทางให้โดยอัตโนมัติ
+
+  ประการที่สอง ห้องทำงานของผมต้องสะอาดเรียบร้อย ผมไม่ต้องการเครื่องมือสร้างที่ต้องตั้งค่าซับซ้อน ไม่อยากยุ่งกับการตั้งค่าเอกสารที่ซับซ้อน และไม่ชอบโครงสร้างที่วุ่นวาย ทุกครั้งที่เห็นไฟล์การตั้งค่าและโครงสร้างโปรเจกต์ของเครื่องมืออย่าง Docusaurus, VuePress, Astro ผมก็ปวดหัว ตอนนี้ ZEN เลือกที่จะซ่อนการตั้งค่าทั้งหมดไว้ในไดเรกทอรี .zen กวาดเก็บเข้าหมู่มุม ผู้ใช้เพียงแค่ต้องมุ่งเน้นที่การเขียนเนื้อหา ส่วนที่เหลือให้ ZEN จัดการ ไดเรกทอรีอื่นๆ ทั้งหมดคือพื้นที่เขียนของคุณ คุณสามารถจัดระเบียบไฟล์ Markdown ของคุณได้ตามต้องการ
+
+- กลับสู่ภาษาหลัก: เขียนด้วยภาษาหลัก สร้างเวอร์ชันหลายภาษาได้อย่างลื่นไหล
+
+  ชีวิตสั้นนัก ผมขี้เกียจแปล เวลาที่คนเราใช้ภาษาหลัก นั่นคือเวลาที่สามารถดึงเอาความลึกของความคิดออกมาได้มากที่สุด แต่ในขณะเดียวกัน การเชื่อมต่อกับโลกก็เป็นสิ่งจำเป็น ผมไม่อยากเสียโอกาสในการสื่อสารหลายภาษา ดังนั้นผมจึงหวังว่าจะมีเครื่องมือที่ให้ผมเขียนด้วยภาษาหลักได้ และในขณะเดียวกันก็ทำให้คนอื่นๆ ได้เห็นเนื้อหาของผมมากขึ้น i18n ในปัจจุบันนอกจากต้องแปลเองแล้ว ยังต้องดูแลการอัปเดตเนื้อหาด้วยตัวเองอีก ซึ่งยุ่งยากเกินไป ผมเลือกใช้ LLM ช่วยแปล ประหยัดเวลาไปได้มาก และสามารถแปลเป็นหลายภาษาได้ด้วยคลิกเดียว
+
+## เริ่มต้นอย่างรวดเร็ว
+
+ข้อกำหนดเบื้องต้น:
+
+- ติดตั้ง [Node.js](https://nodejs.org/) แล้ว (แนะนำเวอร์ชัน 18 ขึ้นไป ต้องมีคำสั่ง npx)
+- ได้รับ [OpenAI API Key](https://platform.openai.com/account/api-keys) แล้ว หรือคีย์ API ที่เข้ากันได้กับ OPENAI
+- ติดตั้ง Git แล้ว (ใช้สำหรับแสดงรายการไฟล์ Markdown จาก Git และไม่รวมไฟล์ที่ถูกกรองโดยกฎ .gitignore)
+
+ขั้นแรก ให้ทำงานในโฟลเดอร์ที่ถูกจัดการด้วย git อยู่แล้ว:
+
+ตั้งค่าตัวแปรสภาพแวดล้อม
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # จำเป็น: โปรดแทนที่ด้วย OpenAI API Key ของคุณ
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # ไม่บังคับ ค่าเริ่มต้นใช้ API ทางการของ OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # ไม่บังคับ ค่าเริ่มต้นใช้โมเดล gpt-3.5-turbo
+```
+
+สร้างเว็บไซต์ รองรับการแปลหลายภาษา ใช้ไดเรกทอรีปัจจุบันเป็นไดเรกทอรีต้นทาง และส่งออกไปยังไดเรกทอรี `.zen/dist`
+
+- สามารถระบุเวอร์ชันภาษาที่ต้องการสร้างได้โดยใช้พารามิเตอร์ `--lang` หลายครั้ง (เช่น `--lang zh-Hans --lang en-US`)
+- ไม่จำเป็นต้องตั้งค่าภาษาต้นทาง ZEN จะตรวจจับโดยอัตโนมัติ
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**ดูพารามิเตอร์เพิ่มเติมหรือความช่วยเหลือ**:
+
+```bash
+npx zengen@latest
+```