zengen 0.2.6 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.zen/meta.json +24 -7
- package/.zen/src/ar-SA/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/ar-SA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ar-SA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/da-DK/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/da-DK/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/da-DK/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/de-DE/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/de-DE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/de-DE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/en-US/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/en-US/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/en-US/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/es-ES/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/es-ES/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/es-ES/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/es-MX/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/es-MX/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/es-MX/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/fi-FI/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/fi-FI/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/fi-FI/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/fr-FR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/fr-FR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/fr-FR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/hi-IN/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/hi-IN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/hi-IN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/id-ID/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/id-ID/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/id-ID/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/it-IT/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/it-IT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/it-IT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ja-JP/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/ja-JP/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ja-JP/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ko-KR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/ko-KR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ko-KR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/nl-NL/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/nl-NL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/nl-NL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/no-NO/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/no-NO/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/no-NO/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pl-PL/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/pl-PL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pl-PL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pt-BR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/pt-BR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pt-BR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pt-PT/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/pt-PT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pt-PT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ru-RU/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/ru-RU/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ru-RU/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/sv-SE/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/sv-SE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/sv-SE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/th-TH/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/th-TH/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/th-TH/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/tr-TR/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/tr-TR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/tr-TR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/uk-UA/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/uk-UA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/uk-UA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/vi-VN/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +121 -0
- package/.zen/src/vi-VN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/vi-VN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/zh-Hans/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +123 -0
- package/.zen/src/zh-Hans/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +74 -0
- package/.zen/src/zh-Hans/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +75 -0
- package/.zen/src/zh-Hant/50bf41ac6fd8ec8cd6481fd1114aaf00abed0461fc8e8c81cc0373d38ffa835c.md +123 -0
- package/.zen/src/zh-Hant/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/zh-Hant/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/README.md +1 -2
- package/assets/templates/default/layout.html +82 -0
- package/dist/build/pipeline.d.ts.map +1 -1
- package/dist/build/pipeline.js +0 -1
- package/dist/build/pipeline.js.map +1 -1
- package/dist/cli.js +0 -2
- package/dist/cli.js.map +1 -1
- package/dist/process/template.d.ts.map +1 -1
- package/dist/process/template.js +3 -4
- package/dist/process/template.js.map +1 -1
- package/dist/types.d.ts +0 -1
- package/dist/types.d.ts.map +1 -1
- package/dist/utils/convertMarkdownToHtml.d.ts.map +1 -1
- package/dist/utils/convertMarkdownToHtml.js +75 -22
- package/dist/utils/convertMarkdownToHtml.js.map +1 -1
- package/docs/test-mermaid.md +105 -0
- package/package.json +2 -2
- package/src/build/pipeline.ts +0 -1
- package/src/cli.ts +0 -2
- package/src/process/template.ts +3 -9
- package/src/types.ts +0 -1
- package/src/utils/convertMarkdownToHtml.ts +80 -21
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistinen Markdown + AI -staattisen sivuston rakentaja'
|
|
3
|
+
'summary': 'ZEN on staattinen sivustogeneraattori, joka yhdistää tekoälyominaisuuksia ja on suunniteltu Markdown-dokumenteille. Sen avulla käyttäjät voivat muuntaa Git-kansion, joka sisältää Markdown-tiedostoja, staattiseksi HTML-sivustoksi ilman monimutkaisia määrityksiä. Kaikki asetukset piilotetaan .zen-hakemistoon. Keskeisiin ominaisuuksiin kuuluvat älykäs luokittelu ja navigointi (käyttäen tekoälyä sisällön analysointiin ja sivustokartan luomiseen), automaattinen inkrementaalinen käännös (tukee monikielisiä versioita, jolloin käyttäjät voivat kirjoittaa äidinkielellään ja tekoäly käsittelee käännökset) sekä häiriöttömän kirjoittamisen kokemus. Pika-aloitusoppaassa vaaditaan Node.js:n asennus, OpenAI API -avaimen ja Gitin hankinta, sivuston rakentaminen komentorivin kautta sekä kielen ja perus-URL:n määrittäminen.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'staattinen sivustogeneraattori'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'tekoäly'
|
|
8
|
+
- 'monikielinen käännös'
|
|
9
|
+
- 'minimalismi'
|
|
10
|
+
- 'dokumentointityökalu'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistinen Markdown + AI -staattisen sivuston rakentaja
|
|
16
|
+
|
|
17
|
+
[> Sivuston demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Perusominaisuudet
|
|
20
|
+
|
|
21
|
+
1. 📃 **Staattisen sivuston generointi**: Muunna mikä tahansa Git-kansio, joka sisältää Markdown-tiedostoja, staattiseksi HTML-sivustoksi.
|
|
22
|
+
2. 🧭 **Älykäs luokittelu ja navigointi**: Käytä tekoälyä sisällön analysointiin, luo sivustokartta ja navigointi. Lähdetiedostojen sijainti ei ole merkityksellinen.
|
|
23
|
+
3. 🌍 **Automaattinen inkrementaalinen käännös**: Käytä tekoälyä inkrementaaliseen käännökseen, jotta käyttäjät voivat kirjoittaa Markdownia äidinkielellään, mutta sivusto voi olla monikielinen.
|
|
24
|
+
|
|
25
|
+
Miksi olen luonut taas uuden Markdown-staattisen sivustogeneraattorin? Olen uudelleen miettinyt, kuinka dokumentointityökalut voisivat palvella kirjoittajia paremmin tekoälyn aikakaudella:
|
|
26
|
+
|
|
27
|
+
- Palaa sisältöön: Minimoi häiriöt, keskitty kirjoittamiseen
|
|
28
|
+
|
|
29
|
+
Palauta dokumentointi olemukseensa, tuo kirjoittamiseen rauha.
|
|
30
|
+
|
|
31
|
+
Ensinnäkin, en halua olla kirjastonhoitaja. Haluan joskus kirjoittaa sisältöä, mutta en ehkä ole vielä päättänyt sen otsikosta tai muodostanut selkeää järjestelyä. Toivon, että LLM auttaisi automaattisesti luomaan otsikoita, tekemään yhteenvetoja, luokittelemaan ja navigoimaan.
|
|
32
|
+
|
|
33
|
+
Toiseksi, kirjastoni on puhdistettava. En halua monimutkaisia määritystyökaluja, sotkea monimutkaisia dokumentointimäärityksiä tai monimutkaisia rakenteita. Joka kerta, kun näen Docusaurus-, VuePress- tai Astro-työkalujen määritystiedostot ja projektirakenteet, särkee pääni. Nyt ZEN piilottaa kaikki määritykset .zen-hakemistoon, työnnä ne nurkkaan. Käyttäjän tarvitsee keskittyä vain sisällön kirjoittamiseen, loput hoitaa ZEN. Kaikki muut hakemistot ovat kirjoitustilaa, voit järjestellä Markdown-tiedostojasi vapaasti.
|
|
34
|
+
|
|
35
|
+
- Palaa äidinkieleen: Kirjoita äidinkielellä, luo monikieliset versiot sujuvasti
|
|
36
|
+
|
|
37
|
+
Elämä on lyhyt, en jaksa kääntää. Ihmiset pystyvät parhaiten hyödyntämään ajattelunsa syvyyttä äidinkielellään. Mutta yhteydenpito maailmaan on myös välttämätöntä, en halua luopua monikielisestä vuorovaikutuksesta. Siksi toivon työkalua, jonka avulla voin kirjoittaa äidinkielelläni ja samalla näyttää sisältöni useammille ihmisille. Nykyinen i18n vaatii oman käännöksen ja sisällön päivitysten ylläpidon, se on liian vaivalloista. Käytän LLM:ää auttamaan käännöksissä, se säästää paljon aikaa ja monikieliset käännökset voidaan tehdä yhdellä napsautuksella.
|
|
38
|
+
|
|
39
|
+
## Pika-aloitus
|
|
40
|
+
|
|
41
|
+
Edellytykset:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) asennettuna (suositellaan versiota 18 tai uudempaa, tarvitaan npx-komento)
|
|
44
|
+
- [OpenAI API -avain](https://platform.openai.com/account/api-keys) hankittu, tai OPENAI-yhteensopiva API-avain
|
|
45
|
+
- Git asennettuna (käytetään Markdown-tiedostojen listaukseen Gitistä, .gitignore-sääntöjen mukaisesti suodatetut tiedostot ohitetaan)
|
|
46
|
+
|
|
47
|
+
Ensiksi, työskentele kansiossa, joka on jo Git-hallinnassa:
|
|
48
|
+
|
|
49
|
+
Määritä ympäristömuuttujat
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Pakollinen: korvaa omalla OpenAI API -avaimellasi
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Valinnainen, oletuksena käytetään OpenAI:n virallista API:a
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Valinnainen, oletuksena käytetään gpt-3.5-turbo -mallia
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Rakenna sivusto, tuki monikielisiä käännöksiä. Käytä nykyistä hakemistoa lähdehakemistona, tuloste .zen/dist-hakemistoon.
|
|
58
|
+
|
|
59
|
+
- Voit määrittää tarvittavat kieliversiot käyttämällä `--lang`-parametria useita kertoja (esim. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Voit määrittää sivuston perus-URL-etuliitteen `--base-url`-parametrilla (esim. GitHub Pages -varaston nimi).
|
|
61
|
+
- Lähdekielen määritystä ei tarvita, ZEN tunnistaa sen automaattisesti.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Näe lisää parametreja tai ohjeita**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'Document de test des diagrammes Mermaid'
|
|
3
|
+
'summary': "Ce document est un fichier de test destiné à vérifier la fonctionnalité de rendu des diagrammes Mermaid dans ZEN. Il contient des exemples de plusieurs types de diagrammes Mermaid, tels que des organigrammes, des diagrammes de séquence, des diagrammes de Gantt, des diagrammes de classes, des diagrammes d'état et des diagrammes circulaires, et inclut un test de syntaxe erronée pour vérifier l'affichage des messages d'erreur. Le document vise à démontrer le fonctionnement correct de l'intégration de Mermaid dans ZEN."
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Mermaid'
|
|
6
|
+
- 'Test de diagrammes'
|
|
7
|
+
- 'ZEN'
|
|
8
|
+
- 'Organigramme'
|
|
9
|
+
- 'Diagramme de séquence'
|
|
10
|
+
- 'Diagramme de Gantt'
|
|
11
|
+
- 'Diagramme de classes'
|
|
12
|
+
- "Diagramme d'état"
|
|
13
|
+
'inferred_date': '2024-01-01'
|
|
14
|
+
'inferred_lang': 'fr-FR'
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# Test des diagrammes Mermaid
|
|
18
|
+
|
|
19
|
+
Ceci est un fichier de test destiné à vérifier la fonctionnalité de rendu des diagrammes Mermaid dans ZEN.
|
|
20
|
+
|
|
21
|
+
## Exemple d'organigramme
|
|
22
|
+
|
|
23
|
+
```mermaid
|
|
24
|
+
graph TD
|
|
25
|
+
A[Commencement] --> B{Continuer ?}
|
|
26
|
+
B -->|Oui| C[Exécuter l'opération]
|
|
27
|
+
B -->|Non| D[Fin]
|
|
28
|
+
C --> E[Vérifier le résultat]
|
|
29
|
+
E --> F{Succès ?}
|
|
30
|
+
F -->|Oui| G[Terminé]
|
|
31
|
+
F -->|Non| H[Réessayer]
|
|
32
|
+
H --> C
|
|
33
|
+
G --> D
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Exemple de diagramme de séquence
|
|
37
|
+
|
|
38
|
+
```mermaid
|
|
39
|
+
sequenceDiagram
|
|
40
|
+
participant Utilisateur
|
|
41
|
+
participant Système
|
|
42
|
+
participant Base_de_données
|
|
43
|
+
|
|
44
|
+
Utilisateur->>Système: Soumettre une requête
|
|
45
|
+
Système->>Base_de_données: Interroger les données
|
|
46
|
+
Base_de_données-->>Système: Retourner le résultat
|
|
47
|
+
Système-->>Utilisateur: Afficher le résultat
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## Exemple de diagramme de Gantt
|
|
51
|
+
|
|
52
|
+
```mermaid
|
|
53
|
+
gantt
|
|
54
|
+
title Calendrier du projet
|
|
55
|
+
dateFormat YYYY-MM-DD
|
|
56
|
+
section Conception
|
|
57
|
+
Analyse des besoins :done, des1, 2024-01-01, 7d
|
|
58
|
+
Conception du prototype :active, des2, 2024-01-08, 5d
|
|
59
|
+
Conception détaillée : des3, after des2, 5d
|
|
60
|
+
section Développement
|
|
61
|
+
Développement front-end : dev1, after des3, 10d
|
|
62
|
+
Développement back-end : dev2, after des3, 15d
|
|
63
|
+
section Tests
|
|
64
|
+
Tests unitaires : test1, after dev1, 5d
|
|
65
|
+
Tests d'intégration : test2, after dev2, 5d
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Exemple de diagramme de classes
|
|
69
|
+
|
|
70
|
+
```mermaid
|
|
71
|
+
classDiagram
|
|
72
|
+
class Animal {
|
|
73
|
+
+String nom
|
|
74
|
+
+int âge
|
|
75
|
+
+void manger()
|
|
76
|
+
+void dormir()
|
|
77
|
+
}
|
|
78
|
+
class Chien {
|
|
79
|
+
+void aboyer()
|
|
80
|
+
}
|
|
81
|
+
class Chat {
|
|
82
|
+
+void miauler()
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
Animal <|-- Chien
|
|
86
|
+
Animal <|-- Chat
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Exemple de diagramme d'état
|
|
90
|
+
|
|
91
|
+
```mermaid
|
|
92
|
+
stateDiagram-v2
|
|
93
|
+
[*] --> Inactif
|
|
94
|
+
Inactif --> Traitement_en_cours : Démarrer le traitement
|
|
95
|
+
Traitement_en_cours --> Succès : Traitement réussi
|
|
96
|
+
Traitement_en_cours --> Erreur : Échec du traitement
|
|
97
|
+
Succès --> [*]
|
|
98
|
+
Erreur --> [*]
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## Exemple de diagramme circulaire
|
|
102
|
+
|
|
103
|
+
```mermaid
|
|
104
|
+
pie title Taux d'utilisation des navigateurs
|
|
105
|
+
"Chrome" : 65.2
|
|
106
|
+
"Firefox" : 15.3
|
|
107
|
+
"Safari" : 12.5
|
|
108
|
+
"Edge" : 5.2
|
|
109
|
+
"Autres" : 1.8
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
## Test de syntaxe erronée (devrait afficher un message d'erreur)
|
|
113
|
+
|
|
114
|
+
```mermaid
|
|
115
|
+
graph TD
|
|
116
|
+
A --> B
|
|
117
|
+
// Définition de flèche manquante ici
|
|
118
|
+
C --> D
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
Ce fichier de test contient plusieurs types de diagrammes Mermaid pour vérifier que l'intégration de Mermaid dans ZEN fonctionne correctement.
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Générateur de site statique minimaliste Markdown + IA'
|
|
3
|
+
'summary': "ZEN est un générateur de site statique intégrant l'IA, axé sur la simplification de l'écriture et de la construction de documentation. Il permet aux utilisateurs de créer des sites HTML statiques à partir de dossiers gérés par git en utilisant Markdown, sans configuration complexe, tous les paramètres étant cachés dans le répertoire .zen. Les fonctionnalités principales incluent une navigation par catégories intelligente (génération de sitemap via l'analyse du contenu par IA), une traduction incrémentielle automatique (prise en charge des versions multilingues, l'utilisateur peut écrire dans sa langue maternelle, l'IA gère la traduction), et une expérience d'écriture avec un minimum de perturbations. L'outil dépend de Node.js, d'une clé API OpenAI et de Git, se construit rapidement via la ligne de commande, et prend en charge des paramètres de langue comme zh-Hans et en-US."
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Générateur de site statique'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'IA'
|
|
8
|
+
- 'Traduction multilingue'
|
|
9
|
+
- 'Minimalisme'
|
|
10
|
+
- 'Outil de documentation'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Générateur de site statique minimaliste Markdown + IA
|
|
16
|
+
|
|
17
|
+
[> Démo du site web](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Fonctionnalités de base
|
|
20
|
+
|
|
21
|
+
1. 📃 **Génération de site statique** : Transforme n'importe quel dossier git contenant des fichiers Markdown en un site HTML statique.
|
|
22
|
+
2. 🧭 **Navigation par catégories intelligente** : Utilise l'IA pour analyser le contenu, générer un sitemap et une navigation, indépendamment de l'emplacement des fichiers sources.
|
|
23
|
+
3. 🌍 **Traduction incrémentielle automatique** : Utilise l'IA pour une traduction incrémentielle, permettant aux utilisateurs d'écrire en Markdown dans leur langue maternelle, tout en offrant un contenu multilingue.
|
|
24
|
+
|
|
25
|
+
Pourquoi créer un autre générateur de site statique Markdown ? J'ai repensé comment les outils de documentation pourraient mieux servir les rédacteurs à l'ère de l'IA :
|
|
26
|
+
|
|
27
|
+
- Retour au contenu : Perturbations minimales, concentration sur l'écriture
|
|
28
|
+
|
|
29
|
+
Ramener la documentation à son essence, ramener la sérénité à l'écriture.
|
|
30
|
+
|
|
31
|
+
Premièrement, je ne veux pas être un bibliothécaire. Parfois, je veux écrire du contenu, mais je n'ai peut-être pas encore trouvé de titre, ni organisé mes idées. J'aimerais que les LLM génèrent automatiquement des titres, des résumés, des catégories, une navigation, et d'autres tâches d'organisation.
|
|
32
|
+
|
|
33
|
+
Deuxièmement, mon espace de travail doit être propre. Je ne veux pas d'outils de construction complexes à configurer, ni de structures de documentation compliquées. Chaque fois que je vois les fichiers de configuration et les structures de projet de Docusaurus, VuePress, Astro, j'ai mal à la tête. Maintenant, ZEN choisit de cacher toute la configuration dans le répertoire .zen, de la reléguer dans un coin, pour que l'utilisateur se concentre uniquement sur l'écriture du contenu, et laisse ZEN gérer le reste. Tous les autres répertoires sont votre espace d'écriture, vous pouvez organiser vos fichiers Markdown comme bon vous semble.
|
|
34
|
+
|
|
35
|
+
- Retour à la langue maternelle : Écrire dans sa langue maternelle, construire des versions multilingues en toute fluidité
|
|
36
|
+
|
|
37
|
+
La vie est trop courte, je n'ai pas envie de traduire. C'est dans sa langue maternelle qu'une personne peut exprimer la profondeur de sa pensée. Mais en même temps, rester connecté au monde est nécessaire, je ne veux pas renoncer à la communication multilingue. J'espérais donc un outil qui me permette d'écrire dans ma langue maternelle, tout en permettant à plus de gens de voir mon contenu. Actuellement, l'i18n nécessite non seulement de traduire soi-même, mais aussi de maintenir les mises à jour du contenu, c'est trop fastidieux. J'ai choisi d'utiliser les LLM pour m'aider à traduire, ce qui me fait gagner beaucoup de temps et permet de réaliser des traductions multilingues en un clic.
|
|
38
|
+
|
|
39
|
+
## Démarrage rapide
|
|
40
|
+
|
|
41
|
+
Prérequis :
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) installé (version 18 ou supérieure recommandée, nécessite la commande npx)
|
|
44
|
+
- Clé [API OpenAI](https://platform.openai.com/account/api-keys) obtenue, ou clé API compatible avec OPENAI
|
|
45
|
+
- Git installé (pour lister les fichiers Markdown depuis Git, en ignorant les fichiers filtrés par les règles .gitignore)
|
|
46
|
+
|
|
47
|
+
Tout d'abord, travaillez dans un dossier déjà géré par git :
|
|
48
|
+
|
|
49
|
+
Configurer les variables d'environnement
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Obligatoire : remplacez par votre clé API OpenAI
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Optionnel, utilise par défaut l'API officielle d'OpenAI
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Optionnel, utilise par défaut le modèle gpt-3.5-turbo
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Construire le site, avec prise en charge de la traduction multilingue. Utilise le répertoire courant comme source, sortie dans le répertoire `.zen/dist`.
|
|
58
|
+
|
|
59
|
+
- Vous pouvez spécifier les versions linguistiques à générer en utilisant plusieurs fois le paramètre `--lang` (par exemple `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Aucune configuration de langue source n'est nécessaire, ZEN la détecte automatiquement.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Voir plus de paramètres ou obtenir de l'aide** :
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx zengen@latest
|
|
70
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Générateur de site statique minimaliste Markdown + IA'
|
|
3
|
+
'summary': "ZEN est un générateur de site statique intégrant des fonctionnalités IA, conçu spécifiquement pour les documents Markdown. Il permet aux utilisateurs de transformer un dossier Git contenant des fichiers Markdown en un site HTML statique, sans configuration complexe, tous les paramètres étant cachés dans le répertoire .zen. Les fonctionnalités principales incluent une navigation par catégories intelligente (utilisant l'IA pour analyser le contenu et générer un plan du site), une traduction incrémentielle automatique (prise en charge des versions multilingues, permettant aux utilisateurs d'écrire dans leur langue maternelle tandis que l'IA gère la traduction), et une expérience d'écriture avec un minimum de perturbations. Le guide de démarrage rapide nécessite l'installation de Node.js, l'obtention d'une clé API OpenAI et de Git, la construction du site via la ligne de commande, avec prise en charge de la spécification de la langue et de l'URL de base."
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Générateur de site statique'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'IA'
|
|
8
|
+
- 'Traduction multilingue'
|
|
9
|
+
- 'Minimalisme'
|
|
10
|
+
- 'Outil de documentation'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Générateur de site statique minimaliste Markdown + IA
|
|
16
|
+
|
|
17
|
+
[> Démo du site web](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Fonctionnalités de base
|
|
20
|
+
|
|
21
|
+
1. 📃 **Génération de site statique** : Transforme n'importe quel dossier git contenant des fichiers Markdown en un site HTML statique.
|
|
22
|
+
2. 🧭 **Navigation par catégories intelligente** : Utilise l'IA pour analyser le contenu, générer un plan du site et une navigation, indépendamment de l'emplacement des fichiers sources.
|
|
23
|
+
3. 🌍 **Traduction incrémentielle automatique** : Utilise l'IA pour une traduction incrémentielle, permettant aux utilisateurs d'écrire en Markdown dans leur langue maternelle, tout en offrant un contenu multilingue.
|
|
24
|
+
|
|
25
|
+
Pourquoi créer un autre générateur de site statique Markdown ? J'ai repensé la manière dont les outils de documentation pourraient mieux servir les rédacteurs à l'ère de l'IA :
|
|
26
|
+
|
|
27
|
+
- Retour au contenu : Perturbations minimales, concentration sur l'écriture
|
|
28
|
+
|
|
29
|
+
Ramener la documentation à son essence, ramener la sérénité à l'écriture.
|
|
30
|
+
|
|
31
|
+
Premièrement, je ne veux pas être un bibliothécaire. Parfois, je veux écrire du contenu, mais je n'ai peut-être pas encore trouvé son titre, ni établi une organisation particulière. J'aimerais que les LLM génèrent automatiquement les titres, fassent des résumés, des catégorisations, de la navigation et d'autres travaux d'organisation.
|
|
32
|
+
|
|
33
|
+
Deuxièmement, mon espace de travail doit être rangé. Je ne veux pas d'outils de construction complexes à configurer, ni de configurations de documentation compliquées, ni de structures complexes. Chaque fois que je vois les fichiers de configuration et les structures de projet d'outils comme Docusaurus, VuePress, Astro, j'ai mal à la tête. Maintenant, ZEN choisit de cacher toute la configuration dans le répertoire `.zen`, de la reléguer dans un coin, afin que l'utilisateur puisse se concentrer uniquement sur l'écriture du contenu, et laisser ZEN gérer le reste. Tous les autres répertoires sont votre espace d'écriture, vous pouvez organiser vos fichiers Markdown comme bon vous semble.
|
|
34
|
+
|
|
35
|
+
- Retour à la langue maternelle : Écrire dans sa langue maternelle, construire des versions multilingues de manière fluide
|
|
36
|
+
|
|
37
|
+
La vie est courte, je n'ai pas envie de traduire. C'est dans sa langue maternelle qu'une personne peut exploiter au mieux la profondeur de sa réflexion. Mais en même temps, il est nécessaire de rester connecté au monde, et je ne veux pas renoncer à la communication multilingue. J'espère donc avoir un outil qui me permette d'écrire dans ma langue maternelle, tout en permettant à plus de gens de voir mon contenu. Actuellement, l'i18n nécessite non seulement de traduire soi-même, mais aussi de maintenir les mises à jour du contenu, c'est trop fastidieux. J'ai choisi d'utiliser les LLM pour m'aider à traduire, ce qui me fait gagner beaucoup de temps et permet de réaliser des traductions multilingues en un clic.
|
|
38
|
+
|
|
39
|
+
## Démarrage rapide
|
|
40
|
+
|
|
41
|
+
Prérequis :
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) installé (version 18 ou supérieure recommandée, nécessite la commande `npx`)
|
|
44
|
+
- Clé API [OpenAI](https://platform.openai.com/account/api-keys) obtenue, ou une clé API compatible avec OpenAI
|
|
45
|
+
- Git installé (utilisé pour lister les fichiers Markdown depuis Git, en ignorant les fichiers filtrés par les règles `.gitignore`)
|
|
46
|
+
|
|
47
|
+
Tout d'abord, travaillez dans un dossier déjà géré par git :
|
|
48
|
+
|
|
49
|
+
Configurer les variables d'environnement
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Obligatoire : remplacez par votre clé API OpenAI
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Optionnel, utilise par défaut l'API officielle d'OpenAI
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Optionnel, utilise par défaut le modèle gpt-3.5-turbo
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Construire le site, avec prise en charge de la traduction multilingue. Utilise le répertoire courant comme répertoire source, et sort les fichiers dans le répertoire `.zen/dist`.
|
|
58
|
+
|
|
59
|
+
- Vous pouvez spécifier les versions linguistiques à générer en utilisant plusieurs fois le paramètre `--lang` (par exemple `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Vous pouvez spécifier le préfixe de l'URL de base du site avec le paramètre `--base-url` (par exemple, le nom du dépôt sur GitHub Pages).
|
|
61
|
+
- Aucune configuration de la langue source n'est nécessaire, ZEN la détecte automatiquement.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Voir plus de paramètres ou obtenir de l'aide** :
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'Mermaid चार्ट परीक्षण दस्तावेज़'
|
|
3
|
+
'summary': 'यह दस्तावेज़ ZEN में Mermaid चार्ट रेंडरिंग कार्यक्षमता को सत्यापित करने के लिए एक परीक्षण फ़ाइल है। इसमें विभिन्न प्रकार के Mermaid चार्ट के उदाहरण शामिल हैं, जैसे फ़्लोचार्ट, सीक्वेंस डायग्राम, गैंट चार्ट, क्लास डायग्राम, स्टेट डायग्राम और पाई चार्ट, और इसमें त्रुटि संदेश प्रदर्शन की जाँच के लिए एक गलत सिंटैक्स परीक्षण भी शामिल है। यह दस्तावेज़ ZEN में Mermaid एकीकरण के सही कार्य को प्रदर्शित करने के लिए है।'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Mermaid'
|
|
6
|
+
- 'चार्ट परीक्षण'
|
|
7
|
+
- 'ZEN'
|
|
8
|
+
- 'फ़्लोचार्ट'
|
|
9
|
+
- 'सीक्वेंस डायग्राम'
|
|
10
|
+
- 'गैंट चार्ट'
|
|
11
|
+
- 'क्लास डायग्राम'
|
|
12
|
+
- 'स्टेट डायग्राम'
|
|
13
|
+
'inferred_date': '2024-01-01'
|
|
14
|
+
'inferred_lang': 'hi-IN'
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# Mermaid चार्ट परीक्षण
|
|
18
|
+
|
|
19
|
+
यह ZEN में Mermaid चार्ट रेंडरिंग कार्यक्षमता को सत्यापित करने के लिए एक परीक्षण फ़ाइल है।
|
|
20
|
+
|
|
21
|
+
## फ़्लोचार्ट उदाहरण
|
|
22
|
+
|
|
23
|
+
```mermaid
|
|
24
|
+
graph TD
|
|
25
|
+
A[शुरू] --> B{क्या जारी रखें?}
|
|
26
|
+
B -->|हाँ| C[क्रिया निष्पादित करें]
|
|
27
|
+
B -->|नहीं| D[समाप्त]
|
|
28
|
+
C --> E[परिणाम जाँचें]
|
|
29
|
+
E --> F{क्या सफल?}
|
|
30
|
+
F -->|हाँ| G[पूर्ण]
|
|
31
|
+
F -->|नहीं| H[पुनः प्रयास करें]
|
|
32
|
+
H --> C
|
|
33
|
+
G --> D
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## सीक्वेंस डायग्राम उदाहरण
|
|
37
|
+
|
|
38
|
+
```mermaid
|
|
39
|
+
sequenceDiagram
|
|
40
|
+
participant उपयोगकर्ता
|
|
41
|
+
participant सिस्टम
|
|
42
|
+
participant डेटाबेस
|
|
43
|
+
|
|
44
|
+
उपयोगकर्ता->>सिस्टम: अनुरोध सबमिट करें
|
|
45
|
+
सिस्टम->>डेटाबेस: डेटा क्वेरी करें
|
|
46
|
+
डेटाबेस-->>सिस्टम: परिणाम लौटाएँ
|
|
47
|
+
सिस्टम-->>उपयोगकर्ता: परिणाम दिखाएँ
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## गैंट चार्ट उदाहरण
|
|
51
|
+
|
|
52
|
+
```mermaid
|
|
53
|
+
gantt
|
|
54
|
+
title परियोजना समयसारणी
|
|
55
|
+
dateFormat YYYY-MM-DD
|
|
56
|
+
section डिज़ाइन
|
|
57
|
+
आवश्यकता विश्लेषण :done, des1, 2024-01-01, 7d
|
|
58
|
+
प्रोटोटाइप डिज़ाइन :active, des2, 2024-01-08, 5d
|
|
59
|
+
विस्तृत डिज़ाइन : des3, after des2, 5d
|
|
60
|
+
section विकास
|
|
61
|
+
फ्रंटएंड विकास : dev1, after des3, 10d
|
|
62
|
+
बैकएंड विकास : dev2, after des3, 15d
|
|
63
|
+
section परीक्षण
|
|
64
|
+
यूनिट परीक्षण : test1, after dev1, 5d
|
|
65
|
+
एकीकरण परीक्षण : test2, after dev2, 5d
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## क्लास डायग्राम उदाहरण
|
|
69
|
+
|
|
70
|
+
```mermaid
|
|
71
|
+
classDiagram
|
|
72
|
+
class Animal {
|
|
73
|
+
+String name
|
|
74
|
+
+int age
|
|
75
|
+
+void eat()
|
|
76
|
+
+void sleep()
|
|
77
|
+
}
|
|
78
|
+
class Dog {
|
|
79
|
+
+void bark()
|
|
80
|
+
}
|
|
81
|
+
class Cat {
|
|
82
|
+
+void meow()
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
Animal <|-- Dog
|
|
86
|
+
Animal <|-- Cat
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## स्टेट डायग्राम उदाहरण
|
|
90
|
+
|
|
91
|
+
```mermaid
|
|
92
|
+
stateDiagram-v2
|
|
93
|
+
[*] --> निष्क्रिय
|
|
94
|
+
निष्क्रिय --> प्रसंस्करण : प्रसंस्करण शुरू करें
|
|
95
|
+
प्रसंस्करण --> सफलता : प्रसंस्करण सफल
|
|
96
|
+
प्रसंस्करण --> त्रुटि : प्रसंस्करण विफल
|
|
97
|
+
सफलता --> [*]
|
|
98
|
+
त्रुटि --> [*]
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## पाई चार्ट उदाहरण
|
|
102
|
+
|
|
103
|
+
```mermaid
|
|
104
|
+
pie title ब्राउज़र उपयोग दर
|
|
105
|
+
"Chrome" : 65.2
|
|
106
|
+
"Firefox" : 15.3
|
|
107
|
+
"Safari" : 12.5
|
|
108
|
+
"Edge" : 5.2
|
|
109
|
+
"अन्य" : 1.8
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
## गलत सिंटैक्स परीक्षण (त्रुटि संदेश दिखना चाहिए)
|
|
113
|
+
|
|
114
|
+
```mermaid
|
|
115
|
+
graph TD
|
|
116
|
+
A --> B
|
|
117
|
+
// यहाँ तीर परिभाषा गायब है
|
|
118
|
+
C --> D
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
इस परीक्षण फ़ाइल में विभिन्न प्रकार के Mermaid चार्ट शामिल हैं, जो ZEN में Mermaid एकीकरण के सही कार्य को सत्यापित करने के लिए हैं।
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - मिनिमलिस्ट Markdown + AI स्टैटिक साइट बिल्डर'
|
|
3
|
+
'summary': 'ZEN एक AI-संयुक्त स्टैटिक साइट जनरेटर है जो डॉक्यूमेंटेशन लेखन और निर्माण प्रक्रिया को सरल बनाने पर केंद्रित है। यह उपयोगकर्ताओं को git-प्रबंधित फ़ोल्डर में Markdown का उपयोग करके स्टैटिक HTML साइट बनाने की अनुमति देता है, बिना जटिल कॉन्फ़िगरेशन के, सभी सेटिंग्स .zen डायरेक्टरी में छिपी हुई हैं। मुख्य विशेषताओं में स्मार्ट वर्गीकरण नेविगेशन (AI द्वारा सामग्री विश्लेषण के माध्यम से साइटमैप जनरेशन), स्वचालित इंक्रीमेंटल अनुवाद (बहुभाषी संस्करणों का समर्थन, उपयोगकर्ता मातृभाषा में लिख सकते हैं, AI अनुवाद संभालता है), और न्यूनतम व्यवधान वाला लेखन अनुभभव शामिल है। टूल Node.js, OpenAI API Key और Git पर निर्भर करता है, कमांड लाइन के माध्यम से तेजी से निर्माण करता है, और zh-Hans और en-US जैसे भाषा पैरामीटर निर्दिष्ट करने का समर्थन करता है।'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'स्टैटिक साइट जनरेटर'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'बहुभाषी अनुवाद'
|
|
9
|
+
- 'मिनिमलिज़्म'
|
|
10
|
+
- 'डॉक्यूमेंटेशन टूल'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'hi-IN'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - मिनिमलिस्ट Markdown + AI स्टैटिक साइट बिल्डर
|
|
16
|
+
|
|
17
|
+
[> वेबसाइट डेमो](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## मूल कार्यक्षमता
|
|
20
|
+
|
|
21
|
+
1. 📃 **स्टैटिक साइट जनरेशन**: Markdown युक्त किसी भी git फ़ोल्डर को एक स्टैटिक HTML साइट में बदल देता है।
|
|
22
|
+
2. 🧭 **स्मार्ट वर्गीकरण नेविगेशन**: AI का उपयोग करके सामग्री विश्लेषण, साइटमैप और नेविगेशन जनरेट करता है, स्रोत फ़ाइलों का स्थान महत्वपूर्ण नहीं है।
|
|
23
|
+
3. 🌍 **स्वचालित इंक्रीमेंटल अनुवाद**: AI का उपयोग करके इंक्रीमेंटल अनुवाद, उपयोगकर्ताओं को मातृभाषा में Markdown लिखने देता है, लेकिन उपयोगकर्ता बहुभाषी हो सकते हैं।
|
|
24
|
+
|
|
25
|
+
एक और Markdown स्टैटिक साइट जनरेटर क्यों बनाया? मैंने AI युग में पुनर्विचार किया कि डॉक्यूमेंटेशन टूल लेखकों की बेहतर सेवा कैसे कर सकते हैं:
|
|
26
|
+
|
|
27
|
+
- **सामग्री पर वापसी: न्यूनतम व्यवधान, लेखन पर ध्यान केंद्रित**
|
|
28
|
+
|
|
29
|
+
डॉक्यूमेंटेशन को उसके मूल सार में वापस लाएं, लेखन को शांति में वापस लाएं।
|
|
30
|
+
|
|
31
|
+
पहला, मैं लाइब्रेरियन नहीं बनना चाहता। कभी-कभी मैं कुछ सामग्री लिखना चाहता हूं, लेकिन हो सकता है मैंने अभी तक इसका शीर्षक नहीं सोचा हो, या विशेष संगठन नहीं बनाया हो। मैं चाहता हूं कि LLM स्वचालित रूप से मेरे लिए शीर्षक जनरेट करे, सारांश बनाए, वर्गीकरण करे, नेविगेशन आदि का प्रबंधन करे।
|
|
32
|
+
|
|
33
|
+
दूसरा, मेरे अध्ययन कक्ष को साफ-सुथरा रहना चाहिए। मुझे जटिल कॉन्फ़िगरेशन वाले बिल्ड टूल, पेचीदा डॉक्यूमेंट कॉन्फ़िगरेशन, या जटिल संरचनाएं नहीं चाहिए। हर बार जब मैं Docusaurus, VuePress, Astro जैसे टूल्स के कॉन्फ़िगरेशन फ़ाइलों और प्रोजेक्ट संरचनाओं को देखता हूं, तो मेरा सिर दर्द करने लगता है। अब, ZEN ने सभी कॉन्फ़िगरेशन को `.zen` डायरेक्टरी में छिपाकर, कोने में सरका देने का विकल्प चुना है। उपयोगकर्ता को केवल लेखन सामग्री पर ध्यान केंद्रित करने की आवश्यकता है, बाकी सब ZEN संभाल लेगा। अन्य सभी डायरेक्टरी आपका लेखन स्थान हैं, आप अपनी Markdown फ़ाइलों को मनचाहे ढंग से व्यवस्थित कर सकते हैं।
|
|
34
|
+
|
|
35
|
+
- **मातृभाषा पर वापसी: मातृभाषा में लिखें, बहुभाषी संस्करणों का सहज निर्माण**
|
|
36
|
+
|
|
37
|
+
जीवन छोटा है, मैं अनुवाद करने में आलसी हूं। व्यक्ति अपनी मातृभाषा का उपयोग करते समय ही अपनी सोच की गहराई को पूरी तरह से व्यक्त कर सकता है। लेकिन साथ ही दुनिया से जुड़े रहना भी आवश्यक है, मैं बहुभाषी संचार को छोड़ना नहीं चाहता। इसलिए मैं एक ऐसे टूल की कामना करता हूं जो मुझे मातृभाषा में लिखने दे, साथ ही मेरी सामग्री को और अधिक लोगों तक पहुंचाए। वर्तमान i18n के लिए न केवल स्वयं अनुवाद करना पड़ता है, बल्कि सामग्री अपडेट भी स्वयं बनाए रखना पड़ता है, यह बहुत परेशानी भरा है। मैंने अनुवाद के लिए LLM का उपयोग करने का विकल्प चुना है, जिससे मेरा बहुत समय बचता है, और एक क्लिक में कई देशों की भाषाओं में अनुवाद पूरा किया जा सकता है।
|
|
38
|
+
|
|
39
|
+
## त्वरित प्रारंभ
|
|
40
|
+
|
|
41
|
+
पूर्वापेक्षाएँ:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) इंस्टॉल हो (अनुशंसित संस्करण 18 या उच्चतर, npx कमांड आवश्यक)
|
|
44
|
+
- [OpenAI API Key](https://platform.openai.com/account/api-keys) प्राप्त हो, या OPENAI-संगत API Key
|
|
45
|
+
- Git इंस्टॉल हो (Git से Markdown फ़ाइलों की सूची बनाने के लिए, .gitignore नियमों द्वारा फ़िल्टर की गई फ़ाइलों को अनदेखा करने के लिए)
|
|
46
|
+
|
|
47
|
+
सबसे पहले, एक ऐसे फ़ोल्डर में कार्य करें जो पहले से ही git द्वारा प्रबंधित हो:
|
|
48
|
+
|
|
49
|
+
पर्यावरण चर कॉन्फ़िगर करें
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # आवश्यक: कृपया अपने OpenAI API Key से बदलें
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # वैकल्पिक, डिफ़ॉल्ट रूप से OpenAI आधिकारिक API का उपयोग करता है
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # वैकल्पिक, डिफ़ॉल्ट रूप से gpt-3.5-turbo मॉडल का उपयोग करता है
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
साइट बनाएं, बहुभाषी अनुवाद का समर्थन करता है। वर्तमान डायरेक्टरी को स्रोत डायरेक्टरी के रूप में उपयोग करता है, आउटपुट `.zen/dist` डायरेक्टरी में जाता है।
|
|
58
|
+
|
|
59
|
+
- `--lang` पैरामीटर का बार-बार उपयोग करके आवश्यक भाषा संस्करण निर्दिष्ट किए जा सकते हैं (उदाहरण: `--lang zh-Hans --lang en-US`)।
|
|
60
|
+
- स्रोत भाषा कॉन्फ़िगर करने की आवश्यकता नहीं है, ZEN स्वचालित रूप से पता लगा लेगा।
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**अधिक पैरामीटर या सहायता देखें**:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx zengen@latest
|
|
70
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - मिनिमलिस्ट Markdown + AI स्टैटिक साइट बिल्डर'
|
|
3
|
+
'summary': 'ZEN एक AI क्षमताओं से युक्त स्टैटिक साइट जनरेटर है, जो विशेष रूप से Markdown दस्तावेज़ों के लिए डिज़ाइन किया गया है। यह उपयोगकर्ताओं को Markdown फ़ाइलों वाले Git फ़ोल्डर को स्टैटिक HTML साइट में बदलने की अनुमति देता है, बिना किसी जटिल कॉन्फ़िगरेशन के, सभी सेटिंग्स .zen डायरेक्टरी में छिपी होती हैं। मुख्य विशेषताओं में स्मार्ट वर्गीकरण नेविगेशन (साइटमैप बनाने के लिए AI द्वारा सामग्री का विश्लेषण), स्वचालित इंक्रीमेंटल अनुवाद (बहुभाषी संस्करणों का समर्थन, उपयोगकर्ता मूल भाषा में लिख सकते हैं, AI अनुवाद संभालता है), और न्यूनतम व्यवधान वाला लेखन अनुभभव शामिल है। त्वरित प्रारंभ गाइड के लिए Node.js स्थापित करना, OpenAI API कुंजी और Git प्राप्त करना आवश्यक है, कमांड लाइन के माध्यम से साइट बनाना, भाषा और आधार URL निर्दिष्ट करने का समर्थन करता है।'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'स्टैटिक साइट जनरेटर'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'बहुभाषी अनुवाद'
|
|
9
|
+
- 'मिनिमलिज़्म'
|
|
10
|
+
- 'दस्तावेज़ उपकरण'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'hi-IN'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - मिनिमलिस्ट Markdown + AI स्टैटिक साइट बिल्डर
|
|
16
|
+
|
|
17
|
+
[> वेबसाइट डेमो](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## मूल कार्यक्षमता
|
|
20
|
+
|
|
21
|
+
1. 📃 **स्टैटिक साइट जनरेशन**: Markdown युक्त किसी भी git फ़ोल्डर को एक स्टैटिक HTML साइट में बदलें।
|
|
22
|
+
2. 🧭 **स्मार्ट वर्गीकरण नेविगेशन**: सामग्री विश्लेषण के लिए AI का उपयोग करके साइटमैप और नेविगेशन उत्पन्न करें, स्रोत फ़ाइलों के स्थान संवेदनशील नहीं हैं।
|
|
23
|
+
3. 🌍 **स्वचालित इंक्रीमेंटल अनुवाद**: इंक्रीमेंटल अनुवाद के लिए AI का उपयोग करें, उपयोगकर्ताओं को मूल भाषा में Markdown लिखने दें, लेकिन उपयोगकर्ता बहुभाषी हो सकते हैं।
|
|
24
|
+
|
|
25
|
+
फिर से एक Markdown स्टैटिक साइट जनरेटर क्यों बनाया? मैंने AI युग में दस्तावेज़ उपकरण लेखकों की बेहतर सेवा कैसे कर सकते हैं, इस पर पुनर्विचार किया:
|
|
26
|
+
|
|
27
|
+
- सामग्री पर वापसी: न्यूनतम व्यवधान, लेखन पर ध्यान केंद्रित करें
|
|
28
|
+
|
|
29
|
+
दस्तावेज़ों को उनके सार में वापस लाएं, लेखन को शांति में वापस लाएं।
|
|
30
|
+
|
|
31
|
+
पहला, मैं पुस्तकालयाध्यक्ष नहीं बनना चाहता। कभी-कभी मैं कुछ सामग्री लिखना चाहता हूं, लेकिन हो सकता है मैंने अभी तक इसका शीर्षक नहीं सोचा हो, विशेष संगठन नहीं बनाया हो। मुझे उम्मीद है कि LLM स्वचालित रूप से मेरे लिए शीर्षक उत्पन्न करेगा, सारांश बनाएगा, वर्गीकरण करेगा, नेविगेशन आदि व्यवस्थित करेगा।
|
|
32
|
+
|
|
33
|
+
दूसरा, मेरे अध्ययन कक्ष को साफ-सुथरा रखना होगा। मुझे जटिल कॉन्फ़िगरेशन वाले निर्माण उपकरण, पेचीदा दस्तावेज़ कॉन्फ़िगरेशन से छेड़छाड़, जटिल संरचना पसंद नहीं है। हर बार जब मैं Docusaurus, VuePress, Astro जैसे उपकरणों की कॉन्फ़िगरेशन फ़ाइलें और प्रोजेक्ट संरचना देखता हूं, तो मेरा सिर दर्द करने लगता है। अब, ZEN ने सभी कॉन्फ़िगरेशन को .zen डायरेक्टरी में छिपाने का विकल्प चुना है, कोने में सरका दिया है, उपयोगकर्ता को केवल लेखन सामग्री पर ध्यान केंद्रित करने की आवश्यकता है, बाकी सब ZEN संभाल लेगा। अन्य सभी निर्देशिकाएं आपका लेखन स्थान हैं, आप अपनी Markdown फ़ाइलों को मनमाने ढंग से व्यवस्थित कर सकते हैं।
|
|
34
|
+
|
|
35
|
+
- मूल भाषा पर वापसी: मूल भाषा में लिखें, बहुभाषी संस्करणों का सहज निर्माण करें
|
|
36
|
+
|
|
37
|
+
जीवन छोटा है, मैं अनुवाद करने में आलसी हूं। व्यक्ति अपनी मूल भाषा का उपयोग करते समय ही अपनी सोच की गहराई को पूरी तरह से व्यक्त कर सकता है। लेकिन साथ ही दुनिया से जुड़े रहना भी ज़रूरी है, मैं बहुभाषी संचार छोड़ना नहीं चाहता। इसलिए मुझे एक ऐसे उपकरण की उम्मीद है जो मुझे मूल भाषा में लिखने दे, और साथ ही मेरी सामग्री को और लोगों तक पहुंचाए। वर्तमान i18n के लिए न केवल स्वयं अनुवाद करना पड़ता है, बल्कि सामग्री अद्यतन भी स्वयं बनाए रखना पड़ता है, यह बहुत परेशानी भरा है। मैंने अनुवाद करने के लिए LLM का उपयोग करने का विकल्प चुना है, इससे मेरा बहुत समय बचता है, और कई देशों की भाषाओं का अनुवाद एक क्लिक में पूरा किया जा सकता है।
|
|
38
|
+
|
|
39
|
+
## त्वरित प्रारंभ
|
|
40
|
+
|
|
41
|
+
पूर्वापेक्षाएँ:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) स्थापित है (संस्करण 18 या उससे अधिक की सिफारिश की जाती है, npx कमांड की आवश्यकता है)
|
|
44
|
+
- [OpenAI API Key](https://platform.openai.com/account/api-keys) प्राप्त कर लिया गया है, या OPENAI-संगत API Key
|
|
45
|
+
- Git स्थापित है (Git से Markdown फ़ाइलों की सूची बनाने के लिए, .gitignore नियमों द्वारा फ़िल्टर की गई फ़ाइलों को अनदेखा करने के लिए)
|
|
46
|
+
|
|
47
|
+
सबसे पहले, एक ऐसे फ़ोल्डर में काम करें जो पहले से ही git द्वारा प्रबंधित है:
|
|
48
|
+
|
|
49
|
+
पर्यावरण चर कॉन्फ़िगर करें
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # आवश्यक: कृपया अपनी OpenAI API Key से बदलें
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # वैकल्पिक, डिफ़ॉल्ट रूप से OpenAI आधिकारिक API का उपयोग करता है
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # वैकल्पिक, डिफ़ॉल्ट रूप से gpt-3.5-turbo मॉडल का उपयोग करता है
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
साइट बनाएं, बहुभाषी अनुवाद का समर्थन करता है। स्रोत निर्देशिका के रूप में वर्तमान निर्देशिका का उपयोग करें, आउटपुट `.zen/dist` निर्देशिका में करें।
|
|
58
|
+
|
|
59
|
+
- `--lang` पैरामीटर का बार-बार उपयोग करके आवश्यक भाषा संस्करण निर्दिष्ट किए जा सकते हैं (उदाहरण के लिए `--lang zh-Hans --lang en-US`)।
|
|
60
|
+
- साइट के आधार URL उपसर्ग को निर्दिष्ट करने के लिए `--base-url` पैरामीटर का उपयोग किया जा सकता है (उदाहरण के लिए GitHub Pages पर रिपॉजिटरी नाम)।
|
|
61
|
+
- स्रोत भाषा कॉन्फ़िगर करने की आवश्यकता नहीं है, ZEN स्वचालित रूप से पता लगा लेगा।
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**अधिक पैरामीटर या सहायता देखें**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|