zengen 0.2.6 → 0.3.1

package/.zen/src/id-ID/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Dokumen Pengujian Diagram Mermaid'
+'summary': 'Dokumen ini adalah file pengujian untuk memverifikasi fungsi render diagram Mermaid di ZEN. Dokumen ini berisi contoh berbagai jenis diagram Mermaid seperti diagram alir, diagram urutan, diagram Gantt, diagram kelas, diagram keadaan, dan diagram pai, serta mencakup pengujian sintaksis yang salah untuk memeriksa tampilan pesan kesalahan. Dokumen ini bertujuan untuk menunjukkan status kerja normal integrasi Mermaid di ZEN.'
+'tags':
+  - 'Mermaid'
+  - 'Pengujian Diagram'
+  - 'ZEN'
+  - 'Diagram Alir'
+  - 'Diagram Urutan'
+  - 'Diagram Gantt'
+  - 'Diagram Kelas'
+  - 'Diagram Keadaan'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'id-ID'
+---
+
+# Pengujian Diagram Mermaid
+
+Ini adalah file pengujian untuk memverifikasi fungsi render diagram Mermaid di ZEN.
+
+## Contoh Diagram Alir
+
+```mermaid
+graph TD
+    A[Mulai] --> B{Apakah melanjutkan?}
+    B -->|Ya| C[Eksekusi Tindakan]
+    B -->|Tidak| D[Selesai]
+    C --> E[Periksa Hasil]
+    E --> F{Apakah berhasil?}
+    F -->|Ya| G[Selesai]
+    F -->|Tidak| H[Ulangi]
+    H --> C
+    G --> D
+```
+
+## Contoh Diagram Urutan
+
+```mermaid
+sequenceDiagram
+    participant Pengguna
+    participant Sistem
+    participant BasisData
+
+    Pengguna->>Sistem: Kirim Permintaan
+    Sistem->>BasisData: Kueri Data
+    BasisData-->>Sistem: Kembalikan Hasil
+    Sistem-->>Pengguna: Tampilkan Hasil
+```
+
+## Contoh Diagram Gantt
+
+```mermaid
+gantt
+    title Jadwal Proyek
+    dateFormat  YYYY-MM-DD
+    section Desain
+    Analisis Kebutuhan     :done,    des1, 2024-01-01, 7d
+    Desain Prototipe      :active,  des2, 2024-01-08, 5d
+    Desain Detail         :         des3, after des2, 5d
+    section Pengembangan
+    Pengembangan Frontend :         dev1, after des3, 10d
+    Pengembangan Backend  :         dev2, after des3, 15d
+    section Pengujian
+    Pengujian Unit        :         test1, after dev1, 5d
+    Pengujian Integrasi   :         test2, after dev2, 5d
+```
+
+## Contoh Diagram Kelas
+
+```mermaid
+classDiagram
+    class Animal {
+        +String name
+        +int age
+        +void eat()
+        +void sleep()
+    }
+    class Dog {
+        +void bark()
+    }
+    class Cat {
+        +void meow()
+    }
+
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+## Contoh Diagram Keadaan
+
+```mermaid
+stateDiagram-v2
+    [*] --> Idle
+    Idle --> Processing : Mulai Pemrosesan
+    Processing --> Success : Pemrosesan Berhasil
+    Processing --> Error : Pemrosesan Gagal
+    Success --> [*]
+    Error --> [*]
+```
+
+## Contoh Diagram Pai
+
+```mermaid
+pie title Penggunaan Browser
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Lainnya" : 1.8
+```
+
+## Pengujian Sintaksis Salah (Seharusnya Menampilkan Pesan Kesalahan)
+
+```mermaid
+graph TD
+    A --> B
+    // Di sini kurang definisi panah
+    C --> D
+```
+
+File pengujian ini berisi berbagai jenis diagram Mermaid untuk memverifikasi apakah integrasi Mermaid di ZEN berfungsi normal.

package/.zen/src/id-ID/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Pembangun Situs Statis Markdown + AI dengan Pendekatan Minimalis'
+'summary': 'ZEN adalah generator situs statis yang mengintegrasikan AI, berfokus pada penyederhanaan proses penulisan dan pembangunan dokumentasi. Alat ini memungkinkan pengguna membuat situs HTML statis dari folder yang dikelola git menggunakan Markdown, tanpa konfigurasi rumit—semua pengaturan tersembunyi di direktori .zen. Fitur inti meliputi navigasi kategorisasi cerdas (membangun peta situs melalui analisis konten AI), penerjemahan inkremental otomatis (mendukung versi multibahasa, pengguna dapat menulis dalam bahasa ibu, AI menangani terjemahan), serta pengalaman menulis yang minimalis dan tidak mengganggu. Alat ini bergantung pada Node.js, OpenAI API Key, dan Git, dibangun melalui command line dengan cepat, serta mendukung parameter bahasa seperti zh-Hans dan en-US.'
+'tags':
+  - 'Generator Situs Statis'
+  - 'Markdown'
+  - 'AI'
+  - 'Penerjemahan Multibahasa'
+  - 'Minimalisme'
+  - 'Alat Dokumentasi'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Pembangun Situs Statis Markdown + AI dengan Pendekatan Minimalis
+
+[> Demo Situs Web](https://zen.zccz14.com/)
+
+## Fitur Dasar
+
+1. 📃 **Pembangunan Situs Statis**: Mengubah folder git berisi Markdown apa pun menjadi situs HTML statis.
+2. 🧭 **Navigasi Kategorisasi Cerdas**: Menggunakan AI untuk menganalisis konten, menghasilkan peta situs dan navigasi, tanpa bergantung pada lokasi file sumber.
+3. 🌍 **Penerjemahan Inkremental Otomatis**: Menggunakan AI untuk penerjemahan inkremental, memungkinkan pengguna menulis Markdown dalam bahasa ibu, namun hasilnya dapat dinikmati dalam berbagai bahasa.
+
+Mengapa membuat generator situs statis Markdown lagi? Saya memikirkan kembali bagaimana alat dokumentasi dapat lebih melayani penulis di era AI:
+
+- **Kembali ke Konten**: Minimalkan gangguan, fokus pada penulisan
+
+  Mengembalikan dokumentasi ke esensinya, mengembalikan ketenangan dalam menulis.
+
+  Pertama, saya tidak ingin menjadi pustakawan. Terkadang saya ingin menulis sesuatu, tetapi mungkin belum memikirkan judulnya atau belum memiliki struktur yang jelas. Saya berharap LLM dapat secara otomatis membantu saya membuat judul, ringkasan, klasifikasi, navigasi, dan pekerjaan pengorganisasian lainnya.
+
+  Kedua, ruang kerja saya harus bersih dan rapi. Saya tidak ingin alat pembangun dengan konfigurasi rumit, mengutak-atik pengaturan dokumentasi yang kompleks, atau struktur yang berbelit. Setiap kali melihat file konfigurasi dan struktur proyek dari alat seperti Docusaurus, VuePress, atau Astro, kepala saya langsung pusing. Sekarang, ZEN memilih untuk menyembunyikan semua konfigurasi di direktori `.zen`, disingkirkan ke sudut, sehingga pengguna hanya perlu fokus pada konten penulisan, sisanya diserahkan kepada ZEN. Semua direktori lainnya adalah ruang menulis Anda, Anda dapat mengatur file Markdown sesuka hati.
+
+- **Kembali ke Bahasa Ibu**: Menulis dalam bahasa ibu, membangun versi multibahasa dengan lancar
+
+  Hidup ini singkat, saya malas menerjemahkan. Seseorang baru dapat mengeluarkan kedalaman pemikirannya sepenuhnya saat menggunakan bahasa ibu. Namun, tetap terhubung dengan dunia juga penting, saya tidak ingin melewatkan komunikasi multibahasa. Oleh karena itu, saya menginginkan alat yang memungkinkan saya menulis dalam bahasa ibu, sekaligus membuat konten saya dapat diakses oleh lebih banyak orang. Saat ini, i18n tidak hanya mengharuskan penerjemahan manual, tetapi juga pemeliharaan pembaruan konten, terlalu merepotkan. Saya memilih menggunakan LLM untuk membantu menerjemahkan, menghemat banyak waktu, dan dapat menyelesaikan penerjemahan multibahasa dengan satu klik.
+
+## Memulai Cepat
+
+Prasyarat:
+
+- [Node.js](https://nodejs.org/) sudah terinstal (disarankan versi 18 ke atas, perlu perintah `npx`)
+- Sudah mendapatkan [OpenAI API Key](https://platform.openai.com/account/api-keys), atau API Key yang kompatibel dengan OPENAI
+- Git sudah terinstal (untuk mendaftar file Markdown dari Git, mengabaikan file yang difilter oleh aturan `.gitignore`)
+
+Pertama, bekerja di folder yang sudah dikelola oleh git:
+
+Konfigurasi variabel lingkungan
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Wajib: ganti dengan OpenAI API Key Anda
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opsional, default menggunakan API resmi OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opsional, default menggunakan model gpt-3.5-turbo
+```
+
+Bangun situs, mendukung penerjemahan multibahasa. Gunakan direktori saat ini sebagai direktori sumber, hasilkan ke direktori `.zen/dist`.
+
+- Dapat menentukan versi bahasa yang ingin dibuat dengan menggunakan parameter `--lang` beberapa kali (misalnya `--lang zh-Hans --lang en-US`).
+- Tidak perlu mengonfigurasi bahasa sumber, ZEN akan mendeteksi secara otomatis.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Lihat parameter lebih lanjut atau bantuan**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/id-ID/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Pembangun Situs Statis Markdown + AI Minimalis'
+'summary': 'ZEN adalah generator situs statis yang menggabungkan kemampuan AI, dirancang khusus untuk dokumen Markdown. Alat ini memungkinkan pengguna mengubah folder Git berisi file Markdown menjadi situs HTML statis tanpa konfigurasi rumit, semua pengaturan tersembunyi di direktori .zen. Fitur inti meliputi navigasi kategorisasi cerdas (menggunakan AI untuk menganalisis konten dan menghasilkan peta situs), penerjemahan inkremental otomatis (mendukung versi multibahasa, pengguna dapat menulis dalam bahasa ibu, AI menangani terjemahan), serta pengalaman menulis dengan gangguan minimal. Panduan memulai cepat memerlukan instalasi Node.js, mendapatkan OpenAI API Key dan Git, membangun situs melalui baris perintah, dengan dukungan penentuan bahasa dan URL dasar.'
+'tags':
+  - 'Generator Situs Statis'
+  - 'Markdown'
+  - 'AI'
+  - 'Penerjemahan Multibahasa'
+  - 'Minimalisme'
+  - 'Alat Dokumentasi'
+  - 'Git'
+'inferred_lang': 'id-ID'
+---
+
+# ZEN - Pembangun Situs Statis Markdown + AI Minimalis
+
+[> Demo Situs Web](https://zen.zccz14.com/)
+
+## Fungsi Dasar
+
+1. 📃 **Pembuatan Situs Statis**: Mengubah folder git berisi Markdown apa pun menjadi situs HTML statis.
+2. 🧭 **Navigasi Kategorisasi Cerdas**: Menggunakan AI untuk menganalisis konten, menghasilkan peta situs dan navigasi, tidak sensitif terhadap lokasi file sumber.
+3. 🌍 **Penerjemahan Inkremental Otomatis**: Menggunakan AI untuk penerjemahan inkremental, memungkinkan pengguna menulis Markdown dalam bahasa ibu, namun pengguna dapat bersifat multibahasa.
+
+Mengapa membuat generator situs statis Markdown lagi? Saya memikirkan kembali bagaimana alat dokumentasi dapat melayani penulis dengan lebih baik di era AI:
+
+- Kembali ke Konten: Minimalkan gangguan, fokus pada menulis
+
+  Mengembalikan esensi dokumentasi, mengembalikan ketenangan dalam menulis.
+
+  Pertama, saya tidak ingin menjadi pustakawan. Terkadang saya ingin menulis sesuatu, tetapi mungkin belum memikirkan judulnya, belum terbentuk organisasi khusus. Saya berharap LLM akan secara otomatis membantu saya membuat judul, ringkasan, klasifikasi, navigasi, dan pekerjaan pengaturan lainnya.
+
+  Kedua, ruang kerja saya harus bersih. Saya tidak ingin alat pembangun dengan konfigurasi rumit, berurusan dengan konfigurasi dokumen yang kompleks, tidak menyukai struktur yang rumit. Setiap kali saya melihat file konfigurasi dan struktur proyek dari alat seperti Docusaurus, VuePress, Astro, kepala saya pusing. Sekarang, ZEN memilih untuk menyembunyikan semua konfigurasi di direktori .zen, disingkirkan ke sudut, pengguna hanya perlu fokus pada konten penulisan, sisanya diserahkan kepada ZEN untuk menanganinya. Direktori lainnya adalah ruang menulis Anda, Anda dapat mengatur file Markdown Anda sesuka hati.
+
+- Kembali ke Bahasa Ibu: Menulis dalam bahasa ibu, membangun versi multibahasa dengan lancar
+
+  Hidup ini singkat, saya malas menerjemahkan. Saat menggunakan bahasa ibu, seseorang dapat mengungkapkan kedalaman pemikirannya dengan paling baik. Tetapi tetap terhubung dengan dunia juga diperlukan, saya tidak ingin melewatkan komunikasi multibahasa. Oleh karena itu, saya menginginkan alat yang memungkinkan saya menulis dalam bahasa ibu, sekaligus membuat lebih banyak orang melihat konten saya. i18n saat ini tidak hanya mengharuskan menerjemahkan sendiri, tetapi juga memelihara pembaruan konten sendiri, terlalu merepotkan. Saya memilih menggunakan LLM untuk membantu menerjemahkan, menghemat banyak waktu saya, dan dapat menyelesaikan terjemahan multibahasa dengan satu klik.
+
+## Memulai Cepat
+
+Prasyarat:
+
+- Sudah menginstal [Node.js](https://nodejs.org/) (disarankan versi 18 ke atas, perlu perintah npx)
+- Sudah mendapatkan [OpenAI API Key](https://platform.openai.com/account/api-keys), atau API Key yang kompatibel dengan OPENAI
+- Sudah menginstal Git (untuk mendaftar file Markdown dari Git, mengabaikan file yang difilter oleh aturan .gitignore)
+
+Pertama, bekerja di folder yang sudah dikelola oleh git:
+
+Konfigurasi variabel lingkungan
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Wajib: Ganti dengan OpenAI API Key Anda
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opsional, default menggunakan API resmi OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opsional, default menggunakan model gpt-3.5-turbo
+```
+
+Bangun situs, mendukung terjemahan multibahasa. Gunakan direktori saat ini sebagai direktori sumber, keluaran ke direktori `.zen/dist`.
+
+- Dapat menentukan versi bahasa yang perlu dibuat dengan menggunakan parameter `--lang` beberapa kali (misalnya `--lang id-ID --lang en-US`).
+- Dapat menentukan awalan URL dasar situs dengan parameter `--base-url` (misalnya nama repositori di GitHub Pages).
+- Tidak perlu mengonfigurasi bahasa sumber, ZEN akan mendeteksi secara otomatis.
+
+```bash
+npx zengen@latest build --lang id-ID --lang en-US
+```
+
+**Lihat lebih banyak parameter atau bantuan**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/it-IT/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Documento di Test per Diagrammi Mermaid'
+'summary': "Questo documento è un file di test per verificare la funzionalità di rendering dei diagrammi Mermaid in ZEN. Contiene esempi di vari tipi di diagrammi Mermaid, come diagrammi di flusso, diagrammi di sequenza, diagrammi di Gantt, diagrammi delle classi, diagrammi di stato e diagrammi a torta, e include un test di sintassi errata per verificare la visualizzazione dei messaggi di errore. Il documento mira a dimostrare il corretto funzionamento dell'integrazione di Mermaid in ZEN."
+'tags':
+  - 'Mermaid'
+  - 'Test diagrammi'
+  - 'ZEN'
+  - 'Diagramma di flusso'
+  - 'Diagramma di sequenza'
+  - 'Diagramma di Gantt'
+  - 'Diagramma delle classi'
+  - 'Diagramma di stato'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'it-IT'
+---
+
+# Test Diagrammi Mermaid
+
+Questo è un file di test per verificare la funzionalità di rendering dei diagrammi Mermaid in ZEN.
+
+## Esempio di Diagramma di Flusso
+
+```mermaid
+graph TD
+    A[Inizio] --> B{Continuare?}
+    B -->|Sì| C[Esegui operazione]
+    B -->|No| D[Fine]
+    C --> E[Controlla risultato]
+    E --> F{Successo?}
+    F -->|Sì| G[Completato]
+    F -->|No| H[Riprova]
+    H --> C
+    G --> D
+```
+
+## Esempio di Diagramma di Sequenza
+
+```mermaid
+sequenceDiagram
+    participant Utente
+    participant Sistema
+    participant Database
+
+    Utente->>Sistema: Invia richiesta
+    Sistema->>Database: Interroga dati
+    Database-->>Sistema: Restituisci risultati
+    Sistema-->>Utente: Mostra risultati
+```
+
+## Esempio di Diagramma di Gantt
+
+```mermaid
+gantt
+    title Cronologia Progetto
+    dateFormat  YYYY-MM-DD
+    section Progettazione
+    Analisi requisiti     :done,    des1, 2024-01-01, 7d
+    Progettazione prototipo :active,  des2, 2024-01-08, 5d
+    Progettazione dettagliata :         des3, after des2, 5d
+    section Sviluppo
+    Sviluppo frontend     :         dev1, after des3, 10d
+    Sviluppo backend     :         dev2, after des3, 15d
+    section Test
+    Test unitari     :         test1, after dev1, 5d
+    Test integrazione     :         test2, after dev2, 5d
+```
+
+## Esempio di Diagramma delle Classi
+
+```mermaid
+classDiagram
+    class Animale {
+        +String nome
+        +int età
+        +void mangia()
+        +void dormi()
+    }
+    class Cane {
+        +void abbaia()
+    }
+    class Gatto {
+        +void miagola()
+    }
+
+    Animale <|-- Cane
+    Animale <|-- Gatto
+```
+
+## Esempio di Diagramma di Stato
+
+```mermaid
+stateDiagram-v2
+    [*] --> Inattivo
+    Inattivo --> Elaborazione : Avvia elaborazione
+    Elaborazione --> Successo : Elaborazione riuscita
+    Elaborazione --> Errore : Elaborazione fallita
+    Successo --> [*]
+    Errore --> [*]
+```
+
+## Esempio di Diagramma a Torta
+
+```mermaid
+pie title Utilizzo Browser
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "Altri" : 1.8
+```
+
+## Test Sintassi Errata (dovrebbe mostrare un messaggio di errore)
+
+```mermaid
+graph TD
+    A --> B
+    // Qui manca la definizione della freccia
+    C --> D
+```
+
+Questo file di test include vari tipi di diagrammi Mermaid per verificare che l'integrazione di Mermaid in ZEN funzioni correttamente.

package/.zen/src/it-IT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md

@@ -0,0 +1,70 @@
+---
+'title': 'ZEN - Generatore di siti statici minimalista Markdown + AI'
+'summary': "ZEN è un generatore di siti statici integrato con l'IA, focalizzato sulla semplificazione della scrittura e del processo di costruzione della documentazione. Permette agli utenti di creare siti HTML statici utilizzando Markdown in cartelle gestite da git, senza configurazioni complesse, con tutte le impostazioni nascoste nella directory .zen. Le funzionalità principali includono navigazione intelligente per categorie (generazione di mappe del sito tramite analisi AI dei contenuti), traduzione incrementale automatica (supporto per versioni multilingua, consentendo agli utenti di scrivere nella loro lingua madre mentre l'IA gestisce le traduzioni) e un'esperienza di scrittura con distrazioni minime. Lo strumento dipende da Node.js, una chiave API OpenAI e Git, si costruisce rapidamente tramite riga di comando e supporta parametri di lingua specifici come zh-Hans e en-US."
+'tags':
+  - 'Generatore di siti statici'
+  - 'Markdown'
+  - 'AI'
+  - 'Traduzione multilingua'
+  - 'Minimalismo'
+  - 'Strumento di documentazione'
+  - 'ZEN'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Generatore di siti statici minimalista Markdown + AI
+
+[> Demo del sito web](https://zen.zccz14.com/)
+
+## Funzionalità di base
+
+1. 📃 **Generazione di siti statici**: Trasforma qualsiasi cartella git contenente file Markdown in un sito HTML statico.
+2. 🧭 **Navigazione intelligente per categorie**: Utilizza l'IA per analizzare i contenuti, generando mappe del sito e navigazione, indipendentemente dalla posizione dei file sorgente.
+3. 🌍 **Traduzione incrementale automatica**: Utilizza l'IA per traduzioni incrementali, permettendo agli utenti di scrivere in Markdown nella loro lingua madre, ma supportando contenuti multilingua.
+
+Perché creare un altro generatore di siti statici Markdown? Ho ripensato a come gli strumenti di documentazione possano servire meglio gli scrittori nell'era dell'IA:
+
+- Ritorno ai contenuti: minimizzare le distrazioni, concentrarsi sulla scrittura
+
+  Far tornare la documentazione alla sua essenza, restituire tranquillità alla scrittura.
+
+  In primo luogo, non voglio fare il bibliotecario. A volte voglio annotare dei contenuti, ma potrei non aver ancora pensato a un titolo o a un'organizzazione specifica. Spero che gli LLM mi aiutino automaticamente a generare titoli, fare riassunti, classificare, navigare e organizzare.
+
+  In secondo luogo, il mio studio deve essere ordinato. Non voglio strumenti di costruzione con configurazioni complesse, non voglio configurazioni di documentazione intricate, non mi piacciono le strutture complicate. Ogni volta che vedo i file di configurazione e le strutture di progetto di strumenti come Docusaurus, VuePress, Astro, mi viene il mal di testa. Ora, ZEN sceglie di nascondere tutte le configurazioni nella directory .zen, spazzandole in un angolo, permettendo agli utenti di concentrarsi solo sulla scrittura dei contenuti, mentre tutto il resto è gestito da ZEN. Tutte le altre directory sono il vostro spazio di scrittura, potete organizzare i vostri file Markdown come preferite.
+
+- Ritorno alla lingua madre: scrivere nella propria lingua, costruire versioni multilingua in modo fluido
+
+  La vita è breve, non ho voglia di tradurre. Quando si usa la propria lingua madre, si esprime al meglio la profondità del proprio pensiero. Ma allo stesso tempo, è necessario rimanere connessi con il mondo, e non voglio rinunciare alla comunicazione multilingue. Quindi desidero uno strumento che mi permetta di scrivere nella mia lingua madre, ma che allo stesso tempo permetta a più persone di vedere i miei contenuti. L'i18n attuale richiede non solo di tradurre da soli, ma anche di mantenere aggiornati i contenuti, è troppo complicato. Ho scelto di usare gli LLM per aiutarmi con le traduzioni, risparmiandomi molto tempo e permettendomi di completare le traduzioni in più lingue con un clic.
+
+## Guida rapida
+
+Prerequisiti:
+
+- [Node.js](https://nodejs.org/) installato (si consiglia versione 18 o superiore, deve includere il comando npx)
+- Ottenuta una [chiave API OpenAI](https://platform.openai.com/account/api-keys), o una chiave API compatibile con OpenAI
+- Git installato (utilizzato per elencare i file Markdown da Git, ignorando i file filtrati dalle regole .gitignore)
+
+Innanzitutto, lavorare in una cartella già gestita da git:
+
+Configurare le variabili d'ambiente
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obbligatorio: sostituire con la propria chiave API OpenAI
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opzionale, per impostazione predefinita utilizza l'API ufficiale di OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opzionale, per impostazione predefinita utilizza il modello gpt-3.5-turbo
+```
+
+Costruire il sito, con supporto per traduzioni multilingua. Utilizza la directory corrente come sorgente e produce l'output nella directory `.zen/dist`.
+
+- È possibile specificare le versioni linguistiche da generare utilizzando più volte il parametro `--lang` (ad esempio `--lang zh-Hans --lang en-US`).
+- Non è necessario configurare la lingua sorgente, ZEN la rileverà automaticamente.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Visualizzare più parametri o la guida**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/it-IT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md

@@ -0,0 +1,71 @@
+---
+'title': 'ZEN - Generatore di siti statici minimalista Markdown + AI'
+'summary': "ZEN è un generatore di siti statici con funzionalità AI, progettato specificamente per documenti Markdown. Permette agli utenti di convertire una cartella Git contenente file Markdown in un sito HTML statico, senza configurazioni complesse: tutte le impostazioni sono nascoste nella directory .zen. Le funzionalità principali includono navigazione intelligente per categorie (utilizza l'AI per analizzare i contenuti e generare una mappa del sito), traduzione automatica incrementale (supporta versioni multilingua, consentendo agli utenti di scrivere nella loro lingua madre mentre l'AI gestisce le traduzioni) e un'esperienza di scrittura con distrazioni minime. La guida rapida richiede l'installazione di Node.js, l'ottenimento di una chiave API OpenAI e Git, la costruzione del sito tramite riga di comando, con supporto per la specifica della lingua e dell'URL di base."
+'tags':
+  - 'Generatore di siti statici'
+  - 'Markdown'
+  - 'AI'
+  - 'Traduzione multilingua'
+  - 'Minimalismo'
+  - 'Strumento per documentazione'
+  - 'Git'
+'inferred_lang': 'zh-Hans'
+---
+
+# ZEN - Generatore di siti statici minimalista Markdown + AI
+
+[> Demo del Sito Web](https://zen.zccz14.com/)
+
+## Funzionalità di Base
+
+1. 📃 **Generazione di siti statici**: Trasforma qualsiasi cartella Git contenente file Markdown in un sito HTML statico.
+2. 🧭 **Navigazione intelligente per categorie**: Utilizza l'AI per analizzare i contenuti, generando una mappa del sito e una navigazione, indipendentemente dalla posizione dei file sorgente.
+3. 🌍 **Traduzione automatica incrementale**: Utilizza l'AI per traduzioni incrementali, permettendo agli utenti di scrivere in Markdown nella loro lingua madre, ma rendendo i contenuti disponibili in più lingue.
+
+Perché creare un altro generatore di siti statici per Markdown? Ho ripensato a come gli strumenti di documentazione possano servire meglio gli scrittori nell'era dell'AI:
+
+- Ritorno ai contenuti: distrazioni minime, concentrazione sulla scrittura
+
+  Far tornare la documentazione alla sua essenza, restituire tranquillità alla scrittura.
+
+  In primo luogo, non voglio fare il bibliotecario. A volte voglio annotare dei contenuti, ma potrei non aver ancora pensato a un titolo o non averli organizzati in modo particolare. Desidero che un LLM generi automaticamente titoli, riassunti, categorie, navigazione e altre attività di organizzazione.
+
+  In secondo luogo, il mio studio deve essere ordinato. Non voglio strumenti di costruzione con configurazioni complesse, non voglio armeggiare con impostazioni di documentazione intricate, non mi piacciono le strutture complicate. Ogni volta che vedo i file di configurazione e le strutture di progetto di strumenti come Docusaurus, VuePress, Astro, mi viene il mal di testa. Ora, ZEN sceglie di nascondere tutte le configurazioni nella directory .zen, spazzandole in un angolo. L'utente deve solo concentrarsi sulla scrittura dei contenuti, il resto lo gestisce ZEN. Tutte le altre directory sono il tuo spazio di scrittura, puoi organizzare i tuoi file Markdown come preferisci.
+
+- Ritorno alla lingua madre: scrivere nella propria lingua, costruire senza intoppi versioni multilingua
+
+  La vita è breve, non ho voglia di tradurre. Quando si usa la propria lingua madre, si esprime al meglio la profondità del proprio pensiero. Ma allo stesso tempo, è necessario rimanere connessi con il mondo, e non voglio rinunciare alla comunicazione multilingue. Quindi desidero uno strumento che mi permetta di scrivere nella mia lingua madre, ma che permetta anche a più persone di vedere i miei contenuti. L'i18n attuale richiede non solo di tradurre da soli, ma anche di mantenere aggiornati i contenuti, è troppo complicato. Scelgo di usare un LLM per aiutarmi con le traduzioni, risparmiandomi molto tempo e permettendomi di completare le traduzioni in più lingue con un clic.
+
+## Guida Rapida
+
+Prerequisiti:
+
+- [Node.js](https://nodejs.org/) installato (si consiglia versione 18 o superiore, deve includere il comando npx)
+- Chiave API [OpenAI](https://platform.openai.com/account/api-keys) ottenuta, o una chiave API compatibile con OpenAI
+- Git installato (utilizzato per elencare i file Markdown da Git, ignorando i file filtrati dalle regole .gitignore)
+
+Innanzitutto, lavora in una cartella già gestita da Git:
+
+Configura le variabili d'ambiente
+
+```bash
+export OPENAI_API_KEY="sk-xxxxxx"  # Obbligatorio: sostituisci con la tua chiave API OpenAI
+export OPENAI_BASE_URL="https://api.openai.com/v1"  # Opzionale, per impostazione predefinita utilizza l'API ufficiale di OpenAI
+export OPENAI_MODEL="gpt-3.5-turbo"  # Opzionale, per impostazione predefinita utilizza il modello gpt-3.5-turbo
+```
+
+Costruisci il sito, con supporto per traduzioni multilingua. Utilizza la directory corrente come sorgente e scrive l'output nella directory `.zen/dist`.
+
+- È possibile specificare le versioni linguistiche da generare utilizzando più volte il parametro `--lang` (ad esempio `--lang zh-Hans --lang en-US`).
+- È possibile specificare il prefisso dell'URL di base del sito utilizzando il parametro `--base-url` (ad esempio il nome del repository su GitHub Pages).
+- Non è necessario configurare la lingua sorgente, ZEN la rileverà automaticamente.
+
+```bash
+npx zengen@latest build --lang zh-Hans --lang en-US
+```
+
+**Visualizza più parametri o la guida**:
+
+```bash
+npx zengen@latest
+```

package/.zen/src/ja-JP/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md

@@ -0,0 +1,121 @@
+---
+'title': 'Mermaid 図表テストドキュメント'
+'summary': 'このドキュメントは、ZENにおけるMermaid図表レンダリング機能を検証するためのテストファイルです。フローチャート、シーケンス図、ガントチャート、クラス図、状態図、円グラフなど、様々なMermaid図表タイプのサンプルを含み、エラーメッセージ表示を確認するための誤った構文テストも含まれています。このドキュメントは、ZENにおけるMermaid統合の正常な動作状態を示すことを目的としています。'
+'tags':
+  - 'Mermaid'
+  - '図表テスト'
+  - 'ZEN'
+  - 'フローチャート'
+  - 'シーケンス図'
+  - 'ガントチャート'
+  - 'クラス図'
+  - '状態図'
+'inferred_date': '2024-01-01'
+'inferred_lang': 'ja-JP'
+---
+
+# Mermaid 図表テスト
+
+これは、ZENにおけるMermaid図表レンダリング機能を検証するためのテストファイルです。
+
+## フローチャート例
+
+```mermaid
+graph TD
+    A[開始] --> B{続行しますか？}
+    B -->|はい| C[操作を実行]
+    B -->|いいえ| D[終了]
+    C --> E[結果を確認]
+    E --> F{成功しましたか？}
+    F -->|はい| G[完了]
+    F -->|いいえ| H[再試行]
+    H --> C
+    G --> D
+```
+
+## シーケンス図例
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant System
+    participant Database
+
+    User->>System: リクエストを送信
+    System->>Database: データを照会
+    Database-->>System: 結果を返却
+    System-->>User: 結果を表示
+```
+
+## ガントチャート例
+
+```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 Animal {
+        +String name
+        +int age
+        +void eat()
+        +void sleep()
+    }
+    class Dog {
+        +void bark()
+    }
+    class Cat {
+        +void meow()
+    }
+
+    Animal <|-- Dog
+    Animal <|-- Cat
+```
+
+## 状態図例
+
+```mermaid
+stateDiagram-v2
+    [*] --> Idle
+    Idle --> Processing : 処理を開始
+    Processing --> Success : 処理成功
+    Processing --> Error : 処理失敗
+    Success --> [*]
+    Error --> [*]
+```
+
+## 円グラフ例
+
+```mermaid
+pie title ブラウザ使用率
+    "Chrome" : 65.2
+    "Firefox" : 15.3
+    "Safari" : 12.5
+    "Edge" : 5.2
+    "その他" : 1.8
+```
+
+## 誤った構文テスト（エラーメッセージが表示されるはず）
+
+```mermaid
+graph TD
+    A --> B
+    // ここに矢印の定義が不足しています
+    C --> D
+```
+
+このテストファイルは、ZENのMermaid統合が正常に動作することを検証するために、様々なMermaid図表タイプを含んでいます。