zengen 0.3.0 → 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.
Files changed (69) hide show
  1. package/.zen/meta.json +7 -8
  2. package/.zen/src/ar-SA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  3. package/.zen/src/ar-SA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  4. package/.zen/src/da-DK/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  5. package/.zen/src/da-DK/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  6. package/.zen/src/de-DE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  7. package/.zen/src/de-DE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  8. package/.zen/src/en-US/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  9. package/.zen/src/en-US/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  10. package/.zen/src/es-ES/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  11. package/.zen/src/es-ES/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  12. package/.zen/src/es-MX/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  13. package/.zen/src/es-MX/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  14. package/.zen/src/fi-FI/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  15. package/.zen/src/fi-FI/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  16. package/.zen/src/fr-FR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  17. package/.zen/src/fr-FR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  18. package/.zen/src/hi-IN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  19. package/.zen/src/hi-IN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  20. package/.zen/src/id-ID/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  21. package/.zen/src/id-ID/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  22. package/.zen/src/it-IT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  23. package/.zen/src/it-IT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  24. package/.zen/src/ja-JP/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  25. package/.zen/src/ja-JP/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  26. package/.zen/src/ko-KR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  27. package/.zen/src/ko-KR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  28. package/.zen/src/nl-NL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  29. package/.zen/src/nl-NL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  30. package/.zen/src/no-NO/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  31. package/.zen/src/no-NO/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  32. package/.zen/src/pl-PL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  33. package/.zen/src/pl-PL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  34. package/.zen/src/pt-BR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  35. package/.zen/src/pt-BR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  36. package/.zen/src/pt-PT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  37. package/.zen/src/pt-PT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  38. package/.zen/src/ru-RU/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  39. package/.zen/src/ru-RU/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  40. package/.zen/src/sv-SE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  41. package/.zen/src/sv-SE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  42. package/.zen/src/th-TH/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  43. package/.zen/src/th-TH/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  44. package/.zen/src/tr-TR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  45. package/.zen/src/tr-TR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  46. package/.zen/src/uk-UA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  47. package/.zen/src/uk-UA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  48. package/.zen/src/vi-VN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  49. package/.zen/src/vi-VN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  50. package/.zen/src/zh-Hans/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +74 -0
  51. package/.zen/src/zh-Hans/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +75 -0
  52. package/.zen/src/zh-Hant/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
  53. package/.zen/src/zh-Hant/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
  54. package/README.md +1 -2
  55. package/dist/build/pipeline.d.ts.map +1 -1
  56. package/dist/build/pipeline.js +0 -1
  57. package/dist/build/pipeline.js.map +1 -1
  58. package/dist/cli.js +0 -2
  59. package/dist/cli.js.map +1 -1
  60. package/dist/process/template.d.ts.map +1 -1
  61. package/dist/process/template.js +3 -4
  62. package/dist/process/template.js.map +1 -1
  63. package/dist/types.d.ts +0 -1
  64. package/dist/types.d.ts.map +1 -1
  65. package/package.json +2 -2
  66. package/src/build/pipeline.ts +0 -1
  67. package/src/cli.ts +0 -2
  68. package/src/process/template.ts +3 -9
  69. package/src/types.ts +0 -1
@@ -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
+ ```
@@ -0,0 +1,70 @@
1
+ ---
2
+ 'title': 'ZEN - Pembangun Situs Statis Markdown + AI dengan Pendekatan Minimalis'
3
+ '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.'
4
+ 'tags':
5
+ - 'Generator Situs Statis'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - 'Penerjemahan Multibahasa'
9
+ - 'Minimalisme'
10
+ - 'Alat Dokumentasi'
11
+ - 'ZEN'
12
+ 'inferred_lang': 'zh-Hans'
13
+ ---
14
+
15
+ # ZEN - Pembangun Situs Statis Markdown + AI dengan Pendekatan Minimalis
16
+
17
+ [> Demo Situs Web](https://zen.zccz14.com/)
18
+
19
+ ## Fitur Dasar
20
+
21
+ 1. 📃 **Pembangunan Situs Statis**: Mengubah folder git berisi Markdown apa pun menjadi situs HTML statis.
22
+ 2. 🧭 **Navigasi Kategorisasi Cerdas**: Menggunakan AI untuk menganalisis konten, menghasilkan peta situs dan navigasi, tanpa bergantung pada lokasi file sumber.
23
+ 3. 🌍 **Penerjemahan Inkremental Otomatis**: Menggunakan AI untuk penerjemahan inkremental, memungkinkan pengguna menulis Markdown dalam bahasa ibu, namun hasilnya dapat dinikmati dalam berbagai bahasa.
24
+
25
+ Mengapa membuat generator situs statis Markdown lagi? Saya memikirkan kembali bagaimana alat dokumentasi dapat lebih melayani penulis di era AI:
26
+
27
+ - **Kembali ke Konten**: Minimalkan gangguan, fokus pada penulisan
28
+
29
+ Mengembalikan dokumentasi ke esensinya, mengembalikan ketenangan dalam menulis.
30
+
31
+ 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.
32
+
33
+ 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.
34
+
35
+ - **Kembali ke Bahasa Ibu**: Menulis dalam bahasa ibu, membangun versi multibahasa dengan lancar
36
+
37
+ 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.
38
+
39
+ ## Memulai Cepat
40
+
41
+ Prasyarat:
42
+
43
+ - [Node.js](https://nodejs.org/) sudah terinstal (disarankan versi 18 ke atas, perlu perintah `npx`)
44
+ - Sudah mendapatkan [OpenAI API Key](https://platform.openai.com/account/api-keys), atau API Key yang kompatibel dengan OPENAI
45
+ - Git sudah terinstal (untuk mendaftar file Markdown dari Git, mengabaikan file yang difilter oleh aturan `.gitignore`)
46
+
47
+ Pertama, bekerja di folder yang sudah dikelola oleh git:
48
+
49
+ Konfigurasi variabel lingkungan
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # Wajib: ganti dengan OpenAI API Key Anda
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # Opsional, default menggunakan API resmi OpenAI
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # Opsional, default menggunakan model gpt-3.5-turbo
55
+ ```
56
+
57
+ Bangun situs, mendukung penerjemahan multibahasa. Gunakan direktori saat ini sebagai direktori sumber, hasilkan ke direktori `.zen/dist`.
58
+
59
+ - Dapat menentukan versi bahasa yang ingin dibuat dengan menggunakan parameter `--lang` beberapa kali (misalnya `--lang zh-Hans --lang en-US`).
60
+ - Tidak perlu mengonfigurasi bahasa sumber, ZEN akan mendeteksi secara otomatis.
61
+
62
+ ```bash
63
+ npx zengen@latest build --lang zh-Hans --lang en-US
64
+ ```
65
+
66
+ **Lihat parameter lebih lanjut atau bantuan**:
67
+
68
+ ```bash
69
+ npx zengen@latest
70
+ ```
@@ -0,0 +1,71 @@
1
+ ---
2
+ 'title': 'ZEN - Pembangun Situs Statis Markdown + AI Minimalis'
3
+ '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.'
4
+ 'tags':
5
+ - 'Generator Situs Statis'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - 'Penerjemahan Multibahasa'
9
+ - 'Minimalisme'
10
+ - 'Alat Dokumentasi'
11
+ - 'Git'
12
+ 'inferred_lang': 'id-ID'
13
+ ---
14
+
15
+ # ZEN - Pembangun Situs Statis Markdown + AI Minimalis
16
+
17
+ [> Demo Situs Web](https://zen.zccz14.com/)
18
+
19
+ ## Fungsi Dasar
20
+
21
+ 1. 📃 **Pembuatan Situs Statis**: Mengubah folder git berisi Markdown apa pun menjadi situs HTML statis.
22
+ 2. 🧭 **Navigasi Kategorisasi Cerdas**: Menggunakan AI untuk menganalisis konten, menghasilkan peta situs dan navigasi, tidak sensitif terhadap lokasi file sumber.
23
+ 3. 🌍 **Penerjemahan Inkremental Otomatis**: Menggunakan AI untuk penerjemahan inkremental, memungkinkan pengguna menulis Markdown dalam bahasa ibu, namun pengguna dapat bersifat multibahasa.
24
+
25
+ Mengapa membuat generator situs statis Markdown lagi? Saya memikirkan kembali bagaimana alat dokumentasi dapat melayani penulis dengan lebih baik di era AI:
26
+
27
+ - Kembali ke Konten: Minimalkan gangguan, fokus pada menulis
28
+
29
+ Mengembalikan esensi dokumentasi, mengembalikan ketenangan dalam menulis.
30
+
31
+ 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.
32
+
33
+ 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.
34
+
35
+ - Kembali ke Bahasa Ibu: Menulis dalam bahasa ibu, membangun versi multibahasa dengan lancar
36
+
37
+ 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.
38
+
39
+ ## Memulai Cepat
40
+
41
+ Prasyarat:
42
+
43
+ - Sudah menginstal [Node.js](https://nodejs.org/) (disarankan versi 18 ke atas, perlu perintah npx)
44
+ - Sudah mendapatkan [OpenAI API Key](https://platform.openai.com/account/api-keys), atau API Key yang kompatibel dengan OPENAI
45
+ - Sudah menginstal Git (untuk mendaftar file Markdown dari Git, mengabaikan file yang difilter oleh aturan .gitignore)
46
+
47
+ Pertama, bekerja di folder yang sudah dikelola oleh git:
48
+
49
+ Konfigurasi variabel lingkungan
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # Wajib: Ganti dengan OpenAI API Key Anda
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # Opsional, default menggunakan API resmi OpenAI
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # Opsional, default menggunakan model gpt-3.5-turbo
55
+ ```
56
+
57
+ Bangun situs, mendukung terjemahan multibahasa. Gunakan direktori saat ini sebagai direktori sumber, keluaran ke direktori `.zen/dist`.
58
+
59
+ - Dapat menentukan versi bahasa yang perlu dibuat dengan menggunakan parameter `--lang` beberapa kali (misalnya `--lang id-ID --lang en-US`).
60
+ - Dapat menentukan awalan URL dasar situs dengan parameter `--base-url` (misalnya nama repositori di GitHub Pages).
61
+ - Tidak perlu mengonfigurasi bahasa sumber, ZEN akan mendeteksi secara otomatis.
62
+
63
+ ```bash
64
+ npx zengen@latest build --lang id-ID --lang en-US
65
+ ```
66
+
67
+ **Lihat lebih banyak parameter atau bantuan**:
68
+
69
+ ```bash
70
+ npx zengen@latest
71
+ ```
@@ -0,0 +1,70 @@
1
+ ---
2
+ 'title': 'ZEN - Generatore di siti statici minimalista Markdown + AI'
3
+ '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."
4
+ 'tags':
5
+ - 'Generatore di siti statici'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - 'Traduzione multilingua'
9
+ - 'Minimalismo'
10
+ - 'Strumento di documentazione'
11
+ - 'ZEN'
12
+ 'inferred_lang': 'zh-Hans'
13
+ ---
14
+
15
+ # ZEN - Generatore di siti statici minimalista Markdown + AI
16
+
17
+ [> Demo del sito web](https://zen.zccz14.com/)
18
+
19
+ ## Funzionalità di base
20
+
21
+ 1. 📃 **Generazione di siti statici**: Trasforma qualsiasi cartella git contenente file Markdown in un sito HTML statico.
22
+ 2. 🧭 **Navigazione intelligente per categorie**: Utilizza l'IA per analizzare i contenuti, generando mappe del sito e navigazione, indipendentemente dalla posizione dei file sorgente.
23
+ 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.
24
+
25
+ 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:
26
+
27
+ - Ritorno ai contenuti: minimizzare le distrazioni, concentrarsi sulla scrittura
28
+
29
+ Far tornare la documentazione alla sua essenza, restituire tranquillità alla scrittura.
30
+
31
+ 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.
32
+
33
+ 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.
34
+
35
+ - Ritorno alla lingua madre: scrivere nella propria lingua, costruire versioni multilingua in modo fluido
36
+
37
+ 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.
38
+
39
+ ## Guida rapida
40
+
41
+ Prerequisiti:
42
+
43
+ - [Node.js](https://nodejs.org/) installato (si consiglia versione 18 o superiore, deve includere il comando npx)
44
+ - Ottenuta una [chiave API OpenAI](https://platform.openai.com/account/api-keys), o una chiave API compatibile con OpenAI
45
+ - Git installato (utilizzato per elencare i file Markdown da Git, ignorando i file filtrati dalle regole .gitignore)
46
+
47
+ Innanzitutto, lavorare in una cartella già gestita da git:
48
+
49
+ Configurare le variabili d'ambiente
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # Obbligatorio: sostituire con la propria chiave API OpenAI
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # Opzionale, per impostazione predefinita utilizza l'API ufficiale di OpenAI
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # Opzionale, per impostazione predefinita utilizza il modello gpt-3.5-turbo
55
+ ```
56
+
57
+ Costruire il sito, con supporto per traduzioni multilingua. Utilizza la directory corrente come sorgente e produce l'output nella directory `.zen/dist`.
58
+
59
+ - È possibile specificare le versioni linguistiche da generare utilizzando più volte il parametro `--lang` (ad esempio `--lang zh-Hans --lang en-US`).
60
+ - Non è necessario configurare la lingua sorgente, ZEN la rileverà automaticamente.
61
+
62
+ ```bash
63
+ npx zengen@latest build --lang zh-Hans --lang en-US
64
+ ```
65
+
66
+ **Visualizzare più parametri o la guida**:
67
+
68
+ ```bash
69
+ npx zengen@latest
70
+ ```
@@ -0,0 +1,71 @@
1
+ ---
2
+ 'title': 'ZEN - Generatore di siti statici minimalista Markdown + AI'
3
+ '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."
4
+ 'tags':
5
+ - 'Generatore di siti statici'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - 'Traduzione multilingua'
9
+ - 'Minimalismo'
10
+ - 'Strumento per documentazione'
11
+ - 'Git'
12
+ 'inferred_lang': 'zh-Hans'
13
+ ---
14
+
15
+ # ZEN - Generatore di siti statici minimalista Markdown + AI
16
+
17
+ [> Demo del Sito Web](https://zen.zccz14.com/)
18
+
19
+ ## Funzionalità di Base
20
+
21
+ 1. 📃 **Generazione di siti statici**: Trasforma qualsiasi cartella Git contenente file Markdown in un sito HTML statico.
22
+ 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.
23
+ 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.
24
+
25
+ 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:
26
+
27
+ - Ritorno ai contenuti: distrazioni minime, concentrazione sulla scrittura
28
+
29
+ Far tornare la documentazione alla sua essenza, restituire tranquillità alla scrittura.
30
+
31
+ 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.
32
+
33
+ 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.
34
+
35
+ - Ritorno alla lingua madre: scrivere nella propria lingua, costruire senza intoppi versioni multilingua
36
+
37
+ 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.
38
+
39
+ ## Guida Rapida
40
+
41
+ Prerequisiti:
42
+
43
+ - [Node.js](https://nodejs.org/) installato (si consiglia versione 18 o superiore, deve includere il comando npx)
44
+ - Chiave API [OpenAI](https://platform.openai.com/account/api-keys) ottenuta, o una chiave API compatibile con OpenAI
45
+ - Git installato (utilizzato per elencare i file Markdown da Git, ignorando i file filtrati dalle regole .gitignore)
46
+
47
+ Innanzitutto, lavora in una cartella già gestita da Git:
48
+
49
+ Configura le variabili d'ambiente
50
+
51
+ ```bash
52
+ export OPENAI_API_KEY="sk-xxxxxx" # Obbligatorio: sostituisci con la tua chiave API OpenAI
53
+ export OPENAI_BASE_URL="https://api.openai.com/v1" # Opzionale, per impostazione predefinita utilizza l'API ufficiale di OpenAI
54
+ export OPENAI_MODEL="gpt-3.5-turbo" # Opzionale, per impostazione predefinita utilizza il modello gpt-3.5-turbo
55
+ ```
56
+
57
+ Costruisci il sito, con supporto per traduzioni multilingua. Utilizza la directory corrente come sorgente e scrive l'output nella directory `.zen/dist`.
58
+
59
+ - È possibile specificare le versioni linguistiche da generare utilizzando più volte il parametro `--lang` (ad esempio `--lang zh-Hans --lang en-US`).
60
+ - È possibile specificare il prefisso dell'URL di base del sito utilizzando il parametro `--base-url` (ad esempio il nome del repository su GitHub Pages).
61
+ - Non è necessario configurare la lingua sorgente, ZEN la rileverà automaticamente.
62
+
63
+ ```bash
64
+ npx zengen@latest build --lang zh-Hans --lang en-US
65
+ ```
66
+
67
+ **Visualizza più parametri o la guida**:
68
+
69
+ ```bash
70
+ npx zengen@latest
71
+ ```
@@ -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': 'zh-Hans'
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文書専用に設計されています。Gitで管理されたMarkdownファイルを含むフォルダを、複雑な設定なしに静的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': 'zh-Hans'
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
+ - `--base-url` パラメータで、サイトのベース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
+ ```