zengen 0.2.3 → 0.2.5

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 (123) hide show
  1. package/.zen/meta.json +26 -12
  2. package/.zen/src/ar-SA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +36 -36
  3. package/.zen/src/ar-SA/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  4. package/.zen/src/da-DK/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +29 -29
  5. package/.zen/src/da-DK/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  6. package/.zen/src/de-DE/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +24 -24
  7. package/.zen/src/de-DE/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  8. package/.zen/src/en-US/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +27 -27
  9. package/.zen/src/en-US/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  10. package/.zen/src/es-ES/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +34 -34
  11. package/.zen/src/es-ES/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  12. package/.zen/src/es-MX/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +31 -31
  13. package/.zen/src/es-MX/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  14. package/.zen/src/fi-FI/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +30 -30
  15. package/.zen/src/fi-FI/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  16. package/.zen/src/fr-FR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +26 -26
  17. package/.zen/src/fr-FR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  18. package/.zen/src/hi-IN/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +29 -29
  19. package/.zen/src/hi-IN/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  20. package/.zen/src/id-ID/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +27 -27
  21. package/.zen/src/id-ID/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  22. package/.zen/src/it-IT/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +38 -38
  23. package/.zen/src/it-IT/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  24. package/.zen/src/ja-JP/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +27 -27
  25. package/.zen/src/ja-JP/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  26. package/.zen/src/ko-KR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +25 -25
  27. package/.zen/src/ko-KR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  28. package/.zen/src/nl-NL/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +31 -31
  29. package/.zen/src/nl-NL/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  30. package/.zen/src/no-NO/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +32 -32
  31. package/.zen/src/no-NO/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  32. package/.zen/src/pl-PL/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +27 -27
  33. package/.zen/src/pl-PL/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  34. package/.zen/src/pt-BR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +34 -34
  35. package/.zen/src/pt-BR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  36. package/.zen/src/pt-PT/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +28 -28
  37. package/.zen/src/pt-PT/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  38. package/.zen/src/ru-RU/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +37 -37
  39. package/.zen/src/ru-RU/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  40. package/.zen/src/sv-SE/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +29 -29
  41. package/.zen/src/sv-SE/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  42. package/.zen/src/th-TH/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +30 -30
  43. package/.zen/src/th-TH/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  44. package/.zen/src/tr-TR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +31 -31
  45. package/.zen/src/tr-TR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  46. package/.zen/src/uk-UA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +30 -30
  47. package/.zen/src/uk-UA/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  48. package/.zen/src/vi-VN/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +24 -24
  49. package/.zen/src/vi-VN/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
  50. package/.zen/src/zh-Hans/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +14 -11
  51. package/.zen/src/zh-Hans/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +31 -0
  52. package/.zen/src/zh-Hant/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +18 -15
  53. package/.zen/src/zh-Hant/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +31 -0
  54. package/dist/ai/extractMetadataFromMarkdown.js +3 -3
  55. package/dist/ai/extractMetadataFromMarkdown.js.map +1 -1
  56. package/dist/build/pipeline.d.ts.map +1 -1
  57. package/dist/build/pipeline.js +2 -40
  58. package/dist/build/pipeline.js.map +1 -1
  59. package/dist/process/scanSourceFiles.d.ts +5 -0
  60. package/dist/process/scanSourceFiles.d.ts.map +1 -0
  61. package/dist/process/scanSourceFiles.js +64 -0
  62. package/dist/process/scanSourceFiles.js.map +1 -0
  63. package/dist/process/template.d.ts.map +1 -1
  64. package/dist/process/template.js +26 -4
  65. package/dist/process/template.js.map +1 -1
  66. package/dist/types.d.ts +1 -0
  67. package/dist/types.d.ts.map +1 -1
  68. package/dist/utils/frontmatter.js +1 -1
  69. package/dist/utils/frontmatter.js.map +1 -1
  70. package/dist/utils/sha256.d.ts +2 -0
  71. package/dist/utils/sha256.d.ts.map +1 -0
  72. package/dist/utils/sha256.js +7 -0
  73. package/dist/utils/sha256.js.map +1 -0
  74. package/docs/tricks.md +15 -0
  75. package/package.json +1 -1
  76. package/src/ai/extractMetadataFromMarkdown.ts +3 -3
  77. package/src/build/pipeline.ts +1 -45
  78. package/src/process/scanSourceFiles.ts +65 -0
  79. package/src/process/template.ts +32 -4
  80. package/src/types.ts +1 -0
  81. package/src/utils/frontmatter.ts +1 -1
  82. package/src/utils/sha256.ts +4 -0
  83. package/.zen/src/de-DE/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
  84. package/.zen/src/de-DE/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  85. package/.zen/src/en-US/01d04f7c17b4a541ead9d759d877b30b403e15b849182a49eb1f62bd29ecd18c.md +0 -120
  86. package/.zen/src/en-US/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
  87. package/.zen/src/en-US/1b798c44a4f353e47296ca83d5905e37e6aba3e90bbd9bc3b3d34fc12059a2ca.md +0 -75
  88. package/.zen/src/en-US/1e96be58d76c60056b708eb5bd8b8b81d7b5845d9cfe0b879d85068a5f11df3a.md +0 -189
  89. package/.zen/src/en-US/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  90. package/.zen/src/en-US/5ec990146b35e00de2630559126ee07f7cdcddeb23b0e8cab3d85b4181353e26.md +0 -53
  91. package/.zen/src/en-US/6124ea88edec5bde737b26b21f71ecfeffe4e73151784856edf813ee231a4baa.md +0 -11
  92. package/.zen/src/en-US/80ae9bed74fc6348a7c1fe9f33e86b65f5d919169721f77bcf0e1bc29fbdb4f9.md +0 -61
  93. package/.zen/src/en-US/afbf4998656c97181d0edc711e388ad11e0f08f5c6f329861327202462a3a34a.md +0 -63
  94. package/.zen/src/en-US/f0c2799126931ccd113a0c45b1e623870b0d4f4f400becf6dd877da8f1011517.md +0 -40
  95. package/.zen/src/en-US/fdfca9b960d0eaa8b2b96fe988ead7481d2c0b16f66ebc94fb477139b4178cdc.md +0 -65
  96. package/.zen/src/es-ES/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
  97. package/.zen/src/es-ES/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  98. package/.zen/src/fr-FR/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
  99. package/.zen/src/fr-FR/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  100. package/.zen/src/ja-JP/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -71
  101. package/.zen/src/ja-JP/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  102. package/.zen/src/ko-KR/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  103. package/.zen/src/pt-PT/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
  104. package/.zen/src/pt-PT/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  105. package/.zen/src/ru-RU/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
  106. package/.zen/src/ru-RU/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  107. package/.zen/src/zh-Hans/01d04f7c17b4a541ead9d759d877b30b403e15b849182a49eb1f62bd29ecd18c.md +0 -120
  108. package/.zen/src/zh-Hans/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
  109. package/.zen/src/zh-Hans/084ef1f6a0167df8621c673c79211309d4af6c588e7bbe3e043f7c244edd0ac6.md +0 -80
  110. package/.zen/src/zh-Hans/1b798c44a4f353e47296ca83d5905e37e6aba3e90bbd9bc3b3d34fc12059a2ca.md +0 -77
  111. package/.zen/src/zh-Hans/1e96be58d76c60056b708eb5bd8b8b81d7b5845d9cfe0b879d85068a5f11df3a.md +0 -189
  112. package/.zen/src/zh-Hans/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
  113. package/.zen/src/zh-Hans/5ec990146b35e00de2630559126ee07f7cdcddeb23b0e8cab3d85b4181353e26.md +0 -55
  114. package/.zen/src/zh-Hans/6124ea88edec5bde737b26b21f71ecfeffe4e73151784856edf813ee231a4baa.md +0 -11
  115. package/.zen/src/zh-Hans/80ae9bed74fc6348a7c1fe9f33e86b65f5d919169721f77bcf0e1bc29fbdb4f9.md +0 -63
  116. package/.zen/src/zh-Hans/afbf4998656c97181d0edc711e388ad11e0f08f5c6f329861327202462a3a34a.md +0 -63
  117. package/.zen/src/zh-Hans/f0c2799126931ccd113a0c45b1e623870b0d4f4f400becf6dd877da8f1011517.md +0 -40
  118. package/.zen/src/zh-Hans/fdfca9b960d0eaa8b2b96fe988ead7481d2c0b16f66ebc94fb477139b4178cdc.md +0 -65
  119. package/dist/scan/files.d.ts +0 -7
  120. package/dist/scan/files.d.ts.map +0 -1
  121. package/dist/scan/files.js +0 -54
  122. package/dist/scan/files.js.map +0 -1
  123. package/src/scan/files.ts +0 -17
@@ -1,50 +1,50 @@
1
1
  ---
2
- title: ZEN - मिनिमलिस्ट मार्कडाउन + AI स्टैटिक साइट बिल्डर
3
- summary: ZEN एक AI-संयुक्त स्टैटिक साइट जनरेटर है जो स्मार्ट वर्गीकरण नेविगेशन और स्वचालित इंक्रीमेंटल अनुवाद का समर्थन करता है, जिससे उपयोगकर्ता अपनी मातृभाषा में लिखने पर ध्यान केंद्रित कर सकते हैं, और कॉन्फ़िगरेशन निर्माण प्रक्रिया को सरल बनाया जा सकता है।
4
- tags:
5
- - स्टैटिक साइट जनरेटर
6
- - मार्कडाउन
7
- - AI
8
- - बहुभाषी अनुवाद
9
- - मिनिमलिज़्म
10
- - डॉक्यूमेंटेशन टूल
11
- - Node.js
12
- inferred_lang: hi-IN
2
+ 'title': 'ZEN - एक न्यूनतावादी Markdown + AI स्टैटिक साइट बिल्डर'
3
+ 'summary': 'ZEN एक AI क्षमताओं से युक्त स्टैटिक साइट जनरेटर है जो दस्तावेज़ लेखन और साइट निर्माण प्रक्रिया को सरल बनाने के लिए डिज़ाइन किया गया है। यह उपयोगकर्ताओं को मूल भाषा में Markdown सामग्री लिखने पर ध्यान केंद्रित करने की अनुमति देता है, शीर्षक निर्माण, श्रेणी नेविगेशन और वृद्धिशील अनुवाद को स्वचालित रूप से संसाधित करता है, बहुभाषी संस्करणों का समर्थन करता है, और जटिल कॉन्फ़िगरेशन की आवश्यकता नहीं होती है। यह उपकरण Node.js और OpenAI API पर आधारित है, कमांड लाइन के माध्यम से साइटों को तेज़ी से बनाता है, और दक्षता और सादगी चाहने वाले लेखकों के लिए उपयुक्त है।'
4
+ 'tags':
5
+ - 'स्टैटिक साइट जनरेटर'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - 'न्यूनतावाद'
9
+ - 'बहुभाषी अनुवाद'
10
+ - 'Node.js'
11
+ - 'OpenAI'
12
+ 'inferred_lang': 'hi-IN'
13
13
  ---
14
14
 
15
- # ZEN - मिनिमलिस्ट मार्कडाउन + AI स्टैटिक साइट बिल्डर
15
+ # ZEN - एक न्यूनतावादी Markdown + AI स्टैटिक साइट बिल्डर
16
16
 
17
17
  [> वेबसाइट डेमो](https://zccz14.github.io/ZEN/)
18
18
 
19
- ## मूलभूत कार्यक्षमताएँ
19
+ ## मूल कार्यक्षमता
20
20
 
21
- 1. 📃 **स्टैटिक साइट जनरेशन**: मार्कडाउन युक्त किसी भी git फ़ोल्डर को एक स्टैटिक HTML साइट में बदल देता है।
22
- 2. 🧭 **स्मार्ट वर्गीकरण नेविगेशन**: AI का उपयोग करके सामग्री का विश्लेषण करता है, साइटमैप और नेविगेशन उत्पन्न करता है, स्रोत फ़ाइलों के स्थान से संवेदनशील नहीं होता।
23
- 3. 🌍 **स्वचालित इंक्रीमेंटल अनुवाद**: AI का उपयोग करके इंक्रीमेंटल अनुवाद करता है, उपयोगकर्ता को मातृभाषा में मार्कडाउन लिखने देता है, लेकिन उपयोगकर्ता बहुभाषी हो सकते हैं।
21
+ 1. 📃 **स्टैटिक साइट जनरेशन**: Markdown युक्त किसी भी git फ़ोल्डर को एक स्टैटिक HTML साइट में बदल देता है।
22
+ 2. 🧭 **स्मार्ट वर्गीकरण नेविगेशन**: AI का उपयोग करके सामग्री विश्लेषण करता है, साइटमैप और नेविगेशन उत्पन्न करता है, स्रोत फ़ाइलों के स्थान से असंवेदनशील।
23
+ 3. 🌍 **स्वचालित वृद्धिशील अनुवाद**: AI का उपयोग करके वृद्धिशील अनुवाद करता है, उपयोगकर्ताओं को मूल भाषा में Markdown लिखने देता है, लेकिन उपयोगकर्ता बहुभाषी हो सकते हैं।
24
24
 
25
- फिर से एक और मार्कडाउन स्टैटिक साइट जनरेटर क्यों बनाया? मैंने AI युग में दोबारा सोचा कि डॉक्यूमेंटेशन टूल लेखकों की बेहतर सेवा कैसे कर सकते हैं:
25
+ फिर से एक Markdown स्टैटिक साइट जनरेटर क्यों बनाया? मैंने AI युग में दस्तावेज़ उपकरण लेखकों की बेहतर सेवा कैसे कर सकते हैं, इस पर पुनर्विचार किया:
26
26
 
27
- - सामग्री पर वापसी: व्यवधान को न्यूनतम करें, लेखन पर ध्यान केंद्रित करें
27
+ - सामग्री पर वापसी: व्यवधान को न्यूनतम करें, लेखन पर ध्यान दें
28
28
 
29
- दस्तावेज़ों को उनके मूल स्वरूप में लौटाएँ, लेखन को शांति में लौटाएँ।
29
+ दस्तावेज़ों को उनके सार में वापस लाएं, लेखन को शांति में वापस लाएं।
30
30
 
31
- पहला, मैं पुस्तकालयाध्यक्ष नहीं बनना चाहता। कभी-कभी मैं कुछ सामग्री लिखना चाहता हूँ, लेकिन हो सकता है मैंने अभी तक इसका शीर्षक नहीं सोचा हो, या विशेष संगठन नहीं बनाया हो। मैं चाहता हूँ कि LLM स्वचालित रूप से मेरे लिए शीर्षक उत्पन्न करे, सारांश बनाए, वर्गीकरण करे, नेविगेशन आदि का प्रबंधन करे।
31
+ पहला, मैं पुस्तकालयाध्यक्ष नहीं बनना चाहता। कभी-कभी मैं कुछ सामग्री लिखना चाहता हूं, लेकिन हो सकता है मैंने अभी तक इसका शीर्षक नहीं सोचा हो, कोई विशेष संगठन नहीं बनाया हो। मैं चाहता हूं कि LLM स्वचालित रूप से मेरे लिए शीर्षक उत्पन्न करे, सारांश बनाए, वर्गीकरण करे, नेविगेशन आदि व्यवस्थित करे।
32
32
 
33
- दूसरा, मेरे अध्ययन कक्ष को साफ-सुथरा रखना होगा। मैं जटिल कॉन्फ़िगरेशन वाले बिल्ड टूल, पेचीदा डॉक्यूमेंट कॉन्फ़िगरेशन, या जटिल संरचना नहीं चाहता। हर बार जब मैं Docusaurus, VuePress, Astro जैसे टूल्स के कॉन्फ़िगरेशन फ़ाइलों और प्रोजेक्ट संरचना को देखता हूँ, तो मेरा सिर दर्द करने लगता है। अब, ZEN ने सभी कॉन्फ़िगरेशन को `.zen` डायरेक्टरी में छिपाने, कोने में सरका देने का विकल्प चुना है, उपयोगकर्ता को केवल लेखन सामग्री पर ध्यान केंद्रित करना है, बाकी सब ZEN को सौंप देना है। अन्य सभी डायरेक्टरी आपकी लेखन जगह हैं, आप अपनी मार्कडाउन फ़ाइलों को मनचाहे ढंग से व्यवस्थित कर सकते हैं।
33
+ दूसरा, मेरे अध्ययन कक्ष को साफ-सुथरा रखना होगा। मुझे जटिल कॉन्फ़िगरेशन वाले निर्माण उपकरण, पेचीदा दस्तावेज़ कॉन्फ़िगरेशन, जटिल संरचनाएं नहीं चाहिए। हर बार जब मैं Docusaurus, VuePress, Astro जैसे उपकरणों के कॉन्फ़िगरेशन फ़ाइलों और प्रोजेक्ट संरचनाओं को देखता हूं, तो मेरा सिर दर्द करने लगता है। अब, ZEN ने सभी कॉन्फ़िगरेशन को `.zen` डायरेक्टरी में छिपाने, कोने में सरका देने का विकल्प चुना है, उपयोगकर्ता को केवल लेखन सामग्री पर ध्यान केंद्रित करना है, बाकी सब ZEN संभाल लेगा। अन्य सभी डायरेक्टरी आपकी लेखन जगह हैं, आप अपनी Markdown फ़ाइलों को मनचाहे ढंग से व्यवस्थित कर सकते हैं।
34
34
 
35
- - मातृभाषा पर वापसी: मातृभाषा में लिखें, बहुभाषी संस्करणों का सहज निर्माण करें
35
+ - मूल भाषा पर वापसी: मूल भाषा में लिखें, बहुभाषी संस्करणों का सहज निर्माण करें
36
36
 
37
- जीवन छोटा है, मैं अनुवाद करने में आलसी हूँ। व्यक्ति अपनी मातृभाषा का उपयोग करते समय ही अपनी सोच की गहराई का पूरा उपयोग कर पाता है। लेकिन साथ ही दुनिया से जुड़े रहना भी ज़रूरी है, मैं बहुभाषी संवाद को छोड़ना नहीं चाहता। इसलिए मैं एक ऐसे टूल की कामना करता हूँ जो मुझे मातृभाषा में लिखने दे, और साथ ही मेरी सामग्री को और लोगों तक पहुँचाए। वर्तमान i18n में न केवल खुद अनुवाद करना पड़ता है, बल्कि सामग्री अपडेट भी खुद से मेंटेन करनी पड़ती है, यह बहुत परेशानी भरा है। मैंने अनुवाद के लिए LLM का उपयोग करने का विकल्प चुना है, इससे मेरा बहुत समय बचता है, और एक क्लिक में कई देशों की भाषाओं में अनुवाद किया जा सकता है।
37
+ जीवन छोटा है, मैं अनुवाद करने में आलसी हूं। व्यक्ति अपनी मूल भाषा का उपयोग करते समय ही अपनी सोच की गहराई का पूरा उपयोग कर सकता है। लेकिन साथ ही दुनिया से जुड़े रहना भी ज़रूरी है, मैं बहुभाषी संवाद को छोड़ना नहीं चाहता। इसलिए मैं एक ऐसा उपकरण चाहता हूं जो मुझे मूल भाषा में लिखने दे, साथ ही मेरी सामग्री को और लोग देख सकें। वर्तमान i18n में न केवल खुद अनुवाद करना पड़ता है, बल्कि सामग्री अपडेट भी खुद बनाए रखनी पड़ती है, यह बहुत परेशानी भरा है। मैंने अनुवाद के लिए LLM का उपयोग करने का विकल्प चुना है, जिससे मेरा बहुत समय बचता है, और कई देशों की भाषाओं का अनुवाद एक क्लिक में पूरा किया जा सकता है।
38
38
 
39
39
  ## त्वरित प्रारंभ
40
40
 
41
41
  पूर्वापेक्षाएँ:
42
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 से मार्कडाउन फ़ाइलें सूचीबद्ध करने के लिए, .gitignore नियमों द्वारा फ़िल्टर की गई फ़ाइलों को अनदेखा करने के लिए)
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
46
 
47
- सबसे पहले, एक ऐसे फ़ोल्डर में काम करें जो पहले से ही git द्वारा प्रबंधित हो:
47
+ सबसे पहले, एक ऐसे फ़ोल्डर में काम करें जो पहले से git द्वारा प्रबंधित हो:
48
48
 
49
49
  पर्यावरण चर कॉन्फ़िगर करें
50
50
 
@@ -54,10 +54,10 @@ export OPENAI_BASE_URL="https://api.openai.com/v1" # वैकल्पिक,
54
54
  export OPENAI_MODEL="gpt-3.5-turbo" # वैकल्पिक, डिफ़ॉल्ट रूप से gpt-3.5-turbo मॉडल का उपयोग करता है
55
55
  ```
56
56
 
57
- साइट बनाएँ, बहुभाषी अनुवाद का समर्थन करता है। वर्तमान डायरेक्टरी को स्रोत डायरेक्टरी के रूप में उपयोग करता है, आउटपुट `.zen/dist` डायरेक्टरी में होता है।
57
+ साइट बनाएं, बहुभाषी अनुवाद का समर्थन करता है। स्रोत डायरेक्टरी के रूप में वर्तमान डायरेक्टरी का उपयोग करें, `.zen/dist` डायरेक्टरी में आउटपुट करें।
58
58
 
59
59
  - `--lang` पैरामीटर का बार-बार उपयोग करके आवश्यक भाषा संस्करण निर्दिष्ट किए जा सकते हैं (उदाहरण: `--lang zh-Hans --lang en-US`)।
60
- - `--base-url` पैरामीटर द्वारा साइट का आधार URL उपसर्ग निर्दिष्ट किया जा सकता है (उदाहरण: GitHub Pages पर रिपॉजिटरी का नाम)।
60
+ - `--base-url` पैरामीटर का उपयोग करके साइट का आधार URL उपसर्ग निर्दिष्ट किया जा सकता है (उदाहरण: GitHub Pages पर रिपॉजिटरी नाम)।
61
61
  - स्रोत भाषा कॉन्फ़िगर करने की आवश्यकता नहीं है, ZEN स्वचालित रूप से पता लगा लेगा।
62
62
 
63
63
  ```bash
@@ -0,0 +1,30 @@
1
+ ---
2
+ 'title': 'ZEN दस्तावेज़ तिथि घोषणा उपयोग तकनीक'
3
+ 'summary': 'यह दस्तावेज़ ZEN टूल में मुख्य पाठ में सीधे तिथि घोषणा करने की उपयोग तकनीकों का परिचय देता है, पारंपरिक Markdown द्वारा YAML फ्रंटमैटर में तिथि घोषणा करने के तरीके से तुलना करते हुए, ZEN की स्वचालित पहचान और बुद्धिमान प्रसंस्करण क्षमताओं पर जोर देता है, जो उपयोगकर्ता अनुभव को बेहतर बनाता है और डायरी, ब्लॉग जैसी समयरेखा-आधारित सामग्री प्रकारों के लिए उपयुक्त है।'
4
+ 'tags':
5
+ - 'ZEN'
6
+ - 'तिथि घोषणा'
7
+ - 'Markdown'
8
+ - 'AI प्रसंस्करण'
9
+ - 'समयरेखा'
10
+ - 'उपयोगकर्ता अनुभव'
11
+ - 'दस्तावेज़ प्रबंधन'
12
+ 'inferred_date': '2026-01-08'
13
+ 'inferred_lang': 'hi-IN'
14
+ ---
15
+
16
+ # उपयोग तकनीक
17
+
18
+ ## मुख्य पाठ में तिथि घोषणा
19
+
20
+ मुख्य पाठ में "आज 2026 जनवरी 8 है" जैसी तिथि घोषणा (स्वतंत्र प्रारूप शैली) का उपयोग किया जा सकता है, ZEN इसे स्वचालित रूप से पहचानेगा और प्रसंस्कृत करेगा।
21
+
22
+ पारंपरिक Markdown दस्तावेज़ YAML फ्रंटमैटर के माध्यम से तिथि घोषणा करते हैं, जिसके लिए संबंधित फ़ील्ड याद रखने की आवश्यकता होती है, अन्यथा तिथि सही ढंग से पहचानी नहीं जा सकती।
23
+
24
+ ZEN मुख्य पाठ में सीधे तिथि घोषणा का समर्थन करता है, जिससे फ्रंटमैटर फ़ील्ड भरना भूल जाने की समस्या से बचा जा सकता है।
25
+
26
+ AI स्वचालित रूप से मुख्य पाठ से तिथि जानकारी निकालेगा और अनुमान लगाएगा, और इसे दस्तावेज़ की निर्माण तिथि के रूप में प्रसंस्कृत करेगा।
27
+
28
+ यह तरीका अधिक लचीला और बुद्धिमान है, जो उपयोगकर्ता अनुभव को बेहतर बनाता है।
29
+
30
+ साथ ही, तिथि वाले दस्तावेज़ों से समयरेखा दृश्य उत्पन्न किए जा सकते हैं, जो ब्राउज़िंग और प्रबंधन को सुविधाजनक बनाते हैं। यह विशेष रूप से डायरी, ब्लॉग जैसी समयरेखा-आधारित सामग्री प्रकारों के लिए उपयुक्त है।
@@ -1,50 +1,50 @@
1
1
  ---
2
- title: ZEN - Pembangun Situs Statis Minimalis Markdown + AI
3
- summary: ZEN adalah generator situs statis yang menggabungkan AI, mendukung navigasi klasifikasi cerdas dan terjemahan inkremental otomatis, memungkinkan pengguna fokus menulis dalam bahasa ibu mereka, serta menyederhanakan proses konfigurasi dan pembangunan.
4
- tags:
5
- - Generator Situs Statis
6
- - Markdown
7
- - AI
8
- - Terjemahan Multibahasa
9
- - Minimalisme
10
- - Alat Dokumentasi
11
- - Node.js
12
- inferred_lang: id-ID
2
+ 'title': 'ZEN - Pembangun Situs Statis Markdown + AI dengan Pendekatan Minimalis'
3
+ 'summary': 'ZEN adalah generator situs statis yang menggabungkan kemampuan AI, dirancang untuk menyederhanakan proses penulisan dokumen dan pembangunan situs. Alat ini memungkinkan pengguna fokus menulis konten Markdown dalam bahasa ibu mereka, sambil secara otomatis menangani pembuatan judul, navigasi kategorisasi, dan penerjemahan inkremental, mendukung versi multibahasa tanpa konfigurasi rumit. Dibangun dengan Node.js dan OpenAI API, ZEN membangun situs dengan cepat melalui command line, cocok untuk penulis yang mengutamakan efisiensi dan kesederhanaan.'
4
+ 'tags':
5
+ - 'Generator Situs Statis'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - 'Minimalis'
9
+ - 'Penerjemahan Multibahasa'
10
+ - 'Node.js'
11
+ - 'OpenAI'
12
+ 'inferred_lang': 'id-ID'
13
13
  ---
14
14
 
15
- # ZEN - Pembangun Situs Statis Minimalis Markdown + AI
15
+ # ZEN - Pembangun Situs Statis Markdown + AI dengan Pendekatan Minimalis
16
16
 
17
17
  [> Demo Situs Web](https://zccz14.github.io/ZEN/)
18
18
 
19
19
  ## Fitur Dasar
20
20
 
21
- 1. 📃 **Pembangunan Situs Statis**: Membangun folder git yang berisi Markdown apa pun menjadi situs HTML statis.
22
- 2. 🧭 **Navigasi Klasifikasi Cerdas**: Menggunakan AI untuk analisis konten, menghasilkan peta situs dan navigasi, lokasi file sumber tidak sensitif.
23
- 3. 🌍 **Terjemahan Inkremental Otomatis**: Menggunakan AI untuk terjemahan inkremental, memungkinkan pengguna menulis Markdown dalam bahasa ibu, tetapi pengguna dapat multibahasa.
21
+ 1. 📃 **Pembangunan Situs Statis**: Mengubah folder git berisi file Markdown apa pun menjadi situs HTML statis.
22
+ 2. 🧭 **Navigasi Kategori Cerdas**: Menganalisis konten menggunakan AI untuk 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 menghasilkan konten multibahasa.
24
24
 
25
25
  Mengapa membuat generator situs statis Markdown lagi? Saya memikirkan kembali bagaimana alat dokumentasi dapat melayani penulis dengan lebih baik di era AI:
26
26
 
27
- - Kembali ke Konten: Minimalkan gangguan, fokus pada penulisan
27
+ - **Kembali ke Konten**: Minimalkan gangguan, fokus pada menulis
28
28
 
29
- Kembalikan dokumentasi ke esensinya, kembalikan ketenangan dalam menulis.
29
+ Mengembalikan esensi dokumentasi, mengembalikan ketenangan dalam menulis.
30
30
 
31
- Pertama, saya tidak ingin menjadi pustakawan. Terkadang saya ingin menulis sesuatu, tetapi mungkin saya belum memikirkan judulnya, belum membentuk organisasi yang khusus. Saya berharap LLM akan secara otomatis membantu saya membuat judul, ringkasan, klasifikasi, navigasi, dan pekerjaan pengorganisasian lainnya.
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
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-alat seperti Docusaurus, VuePress, Astro, kepala saya pusing. Sekarang, ZEN memilih untuk menyembunyikan semua konfigurasi ke dalam direktori .zen, disapu ke sudut, pengguna hanya perlu fokus pada konten penulisan, sisanya diserahkan kepada ZEN untuk menanganinya. Direktori lainnya adalah ruang penulisan Anda, Anda dapat mengatur file Markdown Anda sesuka hati.
33
+ Kedua, ruang kerja saya harus bersih. Saya tidak ingin alat pembangun dengan konfigurasi rumit, berurusan dengan pengaturan dokumen yang kompleks, atau struktur yang berbelit. Setiap kali melihat file konfigurasi dan struktur proyek dari alat seperti Docusaurus, VuePress, atau Astro, kepala saya pusing. Sekarang, ZEN memilih untuk menyembunyikan semua konfigurasi di dalam direktori `.zen`, disingkirkan ke sudut. 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
34
 
35
- - Kembali ke Bahasa Ibu: Menulis dalam bahasa ibu, membangun versi multibahasa dengan lancar
35
+ - **Kembali ke Bahasa Ibu**: Menulis dalam bahasa ibu, membangun versi multibahasa dengan lancar
36
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 melepaskan komunikasi multibahasa. Oleh karena itu, saya berharap ada alat yang memungkinkan saya menulis dalam bahasa ibu, sekaligus memungkinkan lebih banyak orang melihat konten saya. i18n saat ini tidak hanya mengharuskan diri sendiri menerjemahkan, tetapi juga harus memelihara pembaruan konten sendiri, terlalu merepotkan. Saya memilih menggunakan LLM untuk membantu saya menerjemahkan, menghemat banyak waktu saya, dan dapat menyelesaikan terjemahan multibahasa dengan satu klik.
37
+ Hidup ini singkat, saya malas menerjemahkan. Seseorang dapat mengungkapkan kedalaman pemikirannya dengan paling baik 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
38
 
39
39
  ## Memulai Cepat
40
40
 
41
41
  Prasyarat:
42
42
 
43
- - Sudah menginstal [Node.js](https://nodejs.org/) (disarankan versi 18 ke atas, perlu perintah npx)
43
+ - Sudah menginstal [Node.js](https://nodejs.org/) (disarankan versi 18 ke atas, perlu perintah `npx`)
44
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)
45
+ - Sudah menginstal Git (untuk mendaftar file Markdown dari Git, mengabaikan file yang difilter oleh aturan `.gitignore`)
46
46
 
47
- Pertama, bekerja di dalam folder yang sudah dikelola oleh git:
47
+ Pertama, bekerja di dalam folder yang sudah dikelola oleh Git:
48
48
 
49
49
  Konfigurasi variabel lingkungan
50
50
 
@@ -54,10 +54,10 @@ export OPENAI_BASE_URL="https://api.openai.com/v1" # Opsional, default mengguna
54
54
  export OPENAI_MODEL="gpt-3.5-turbo" # Opsional, default menggunakan model gpt-3.5-turbo
55
55
  ```
56
56
 
57
- Bangun situs, mendukung terjemahan multibahasa. Gunakan direktori saat ini sebagai direktori sumber, output ke direktori `.zen/dist`.
57
+ Bangun situs, mendukung penerjemahan multibahasa. Gunakan direktori saat ini sebagai direktori sumber, hasilkan ke direktori `.zen/dist`.
58
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 prefiks URL dasar situs dengan parameter `--base-url` (misalnya nama repositori di GitHub Pages).
59
+ - Dapat menentukan versi bahasa yang ingin dibuat dengan menggunakan parameter `--lang` beberapa kali (contoh: `--lang id-ID --lang en-US`).
60
+ - Dapat menentukan prefiks URL dasar situs dengan parameter `--base-url` (contoh: nama repositori di GitHub Pages).
61
61
  - Tidak perlu mengonfigurasi bahasa sumber, ZEN akan mendeteksi secara otomatis.
62
62
 
63
63
  ```bash
@@ -0,0 +1,30 @@
1
+ ---
2
+ 'title': 'Teknik Penggunaan Deklarasi Tanggal dalam Dokumen ZEN'
3
+ 'summary': 'Dokumen ini memperkenalkan teknik penggunaan deklarasi tanggal langsung dalam konten utama pada alat ZEN, dibandingkan dengan metode deklarasi tanggal tradisional melalui YAML Frontmatter di Markdown. Teknik ini menekankan kemampuan pengenalan otomatis dan pemrosesan cerdas ZEN, meningkatkan pengalaman pengguna, serta cocok untuk tipe konten yang memerlukan garis waktu seperti buku harian dan blog.'
4
+ 'tags':
5
+ - 'ZEN'
6
+ - 'Deklarasi Tanggal'
7
+ - 'Markdown'
8
+ - 'Pemrosesan AI'
9
+ - 'Garis Waktu'
10
+ - 'Pengalaman Pengguna'
11
+ - 'Manajemen Dokumen'
12
+ 'inferred_date': '2026-01-08'
13
+ 'inferred_lang': 'id-ID'
14
+ ---
15
+
16
+ # Teknik Penggunaan
17
+
18
+ ## Mendeklarasikan Tanggal dalam Konten Utama
19
+
20
+ Dalam konten utama, Anda dapat menggunakan deklarasi tanggal seperti "Hari ini adalah 8 Januari 2026" (format dan gaya bebas), dan ZEN akan secara otomatis mengenali serta memprosesnya.
21
+
22
+ Dokumen Markdown tradisional mendeklarasikan tanggal melalui YAML Frontmatter, yang mengharuskan Anda mengingat field yang sesuai, jika tidak, tanggal tidak akan dapat dikenali dengan benar.
23
+
24
+ ZEN mendukung deklarasi tanggal langsung dalam konten utama, sehingga menghindari masalah lupa mengisi field Frontmatter.
25
+
26
+ AI akan secara otomatis mengekstrak dan menyimpulkan informasi tanggal dari konten utama, lalu memprosesnya sebagai tanggal pembuatan dokumen.
27
+
28
+ Cara ini lebih fleksibel dan cerdas, meningkatkan pengalaman pengguna.
29
+
30
+ Sebagai tambahan, dokumen yang memiliki tanggal dapat menghasilkan tampilan garis waktu, memudahkan penelusuran dan pengelolaan. Sangat cocok untuk tipe konten yang memerlukan garis waktu seperti buku harian dan blog.
@@ -1,70 +1,70 @@
1
1
  ---
2
- title: ZEN - Generatore di Siti Statici Minimalista Markdown + AI
3
- summary: ZEN è un generatore di siti statici integrato con l'IA, che supporta la navigazione intelligente per categorie e la traduzione incrementale automatica, permettendo agli utenti di concentrarsi sulla scrittura nella propria lingua madre e semplificando i processi di configurazione e build.
4
- tags:
5
- - Generatore di Siti Statici
6
- - Markdown
7
- - AI
8
- - Traduzione Multilingue
9
- - Minimalismo
10
- - Strumenti di Documentazione
11
- - Node.js
12
- inferred_lang: it-IT
2
+ 'title': 'ZEN - Generatore di siti statici minimalista Markdown + AI'
3
+ 'summary': 'ZEN è un generatore di siti statici con funzionalità AI, progettato per semplificare la scrittura di documenti e la creazione di siti. Permette agli utenti di concentrarsi sulla scrittura di contenuti Markdown nella propria lingua madre, gestendo automaticamente la generazione di titoli, la navigazione per categorie e la traduzione incrementale, supportando versioni multilingua senza configurazioni complesse. Basato su Node.js e API OpenAI, costruisce rapidamente siti tramite riga di comando, ideale per scrittori che cercano efficienza e semplicità.'
4
+ 'tags':
5
+ - 'Generatore di siti statici'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - 'Minimalismo'
9
+ - 'Traduzione multilingua'
10
+ - 'Node.js'
11
+ - 'OpenAI'
12
+ 'inferred_lang': 'zh-Hans'
13
13
  ---
14
14
 
15
- # ZEN - Generatore di Siti Statici Minimalista Markdown + AI
15
+ # ZEN - Generatore di siti statici minimalista Markdown + AI
16
16
 
17
- [> Demo del Sito Web](https://zccz14.github.io/ZEN/)
17
+ [> Demo del sito web](https://zccz14.github.io/ZEN/)
18
18
 
19
- ## Funzionalità di Base
19
+ ## Funzionalità di base
20
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, generare una mappa del sito e una navigazione, indipendentemente dalla posizione dei file sorgente.
23
- 3. 🌍 **Traduzione Incrementale Automatica**: Utilizza l'IA per la traduzione incrementale, permettendo agli utenti di scrivere in Markdown nella propria lingua madre, ma supportando comunque un pubblico multilingue.
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 incrementale automatica**: Utilizza l'AI per traduzioni incrementali, permettendo agli utenti di scrivere in Markdown nella propria lingua madre, ma supportando comunque più lingue.
24
24
 
25
- Perché creare un altro generatore di siti statici da Markdown? Ho ripensato a come gli strumenti di documentazione possano servire meglio gli scrittori nell'era dell'IA:
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'AI:
26
26
 
27
- - Ritorno al Contenuto: Minimizzare le distrazioni, concentrarsi sulla scrittura
27
+ - Ritorno ai contenuti: minimizzare le distrazioni, concentrarsi sulla scrittura
28
28
 
29
- Far tornare la documentazione alla sua essenza, far tornare la scrittura alla sua tranquillità.
29
+ Far tornare la documentazione alla sua essenza, far tornare la scrittura alla tranquillità.
30
30
 
31
- Primo, non voglio fare il bibliotecario. A volte voglio annotare qualcosa, ma potrei non aver ancora pensato a un titolo o a una struttura organizzativa precisa. Vorrei che un LLM generasse automaticamente titoli, riassunti, categorie, navigazione e altre operazioni di organizzazione.
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. Vorrei che l'LLM generasse automaticamente titoli, riassunti, categorie, navigazione e altre attività di organizzazione.
32
32
 
33
- Secondo, il mio studio deve essere ordinato. Non voglio strumenti di build con configurazioni complesse, configurazioni di documentazione intricate, 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 vostro spazio di scrittura, potete organizzare i vostri file Markdown come preferite.
33
+ In secondo luogo, il mio studio deve essere ordinato. Non voglio strumenti di costruzione con configurazioni complesse, non mi piace armeggiare con impostazioni intricate o strutture complicate. Ogni volta che vedo i file di configurazione e la struttura dei progetti di strumenti come Docusaurus, VuePress o Astro, mi viene il mal di testa. Ora, ZEN sceglie di nascondere tutte le configurazioni nella cartella `.zen`, spazzandole in un angolo, così che l'utente possa concentrarsi solo sulla scrittura dei contenuti, lasciando il resto a ZEN. Tutte le altre directory sono il vostro spazio di scrittura, potete organizzare i file Markdown come preferite.
34
34
 
35
- - Ritorno alla Lingua Madre: Scrivere nella propria lingua madre, costruire versioni multilingue senza intoppi
35
+ - Ritorno alla lingua madre: scrivere nella propria lingua, costruire senza sforzo versioni multilingua
36
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, 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. Ho scelto di usare un LLM per aiutarmi con le traduzioni, risparmiandomi molto tempo e permettendomi di completare le traduzioni in più lingue con un clic.
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 renda i miei contenuti accessibili a più persone. L'i18n attuale non solo richiede di tradurre da soli, ma anche di mantenere aggiornati i contenuti, ed è troppo complicato. Ho scelto di usare l'LLM per aiutarmi con le traduzioni, risparmiandomi molto tempo e permettendomi di completare traduzioni in più lingue con un solo clic.
38
38
 
39
- ## Guida Rapida
39
+ ## Guida rapida
40
40
 
41
41
  Prerequisiti:
42
42
 
43
- - [Node.js](https://nodejs.org/) installato (si consiglia versione 18 o superiore, deve avere il comando `npx`)
44
- - Ottenuta una [OpenAI API Key](https://platform.openai.com/account/api-keys), o una API Key compatibile con OPENAI
45
- - Git installato (per elencare i file Markdown da una repository Git, ignorando i file filtrati dalle regole `.gitignore`)
43
+ - [Node.js](https://nodejs.org/) installato (versione 18 o superiore consigliata, deve includere il comando npx)
44
+ - Chiave API [OpenAI](https://platform.openai.com/account/api-keys) ottenuta, oppure una chiave API compatibile con OPENAI
45
+ - Git installato (per elencare i file Markdown da una repository Git, ignorando i file filtrati dalle regole .gitignore)
46
46
 
47
- Innanzitutto, lavora in una cartella già gestita da git:
47
+ Innanzitutto, lavorate in una cartella già gestita da git:
48
48
 
49
- Configura le variabili d'ambiente
49
+ Configurate le variabili d'ambiente
50
50
 
51
51
  ```bash
52
- export OPENAI_API_KEY="sk-xxxxxx" # Obbligatorio: sostituisci con la tua OpenAI API Key
53
- export OPENAI_BASE_URL="https://api.openai.com/v1" # Opzionale, di default usa l'API ufficiale di OpenAI
54
- export OPENAI_MODEL="gpt-3.5-turbo" # Opzionale, di default usa il modello gpt-3.5-turbo
52
+ export OPENAI_API_KEY="sk-xxxxxx" # Obbligatorio: sostituite con la vostra 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
55
  ```
56
56
 
57
- Costruisci il sito, supportando la traduzione multilingue. Usa la directory corrente come sorgente, l'output va nella directory `.zen/dist`.
57
+ Costruite il sito, supportando la traduzione multilingua. Utilizza la directory corrente come sorgente e produce l'output nella directory `.zen/dist`.
58
58
 
59
- - Puoi specificare le versioni linguistiche da generare usando più volte il parametro `--lang` (es. `--lang it-IT --lang en-US`).
60
- - Puoi specificare il prefisso dell'URL base del sito con il parametro `--base-url` (es. il nome della repository su GitHub Pages).
59
+ - Potete specificare le versioni linguistiche da generare utilizzando più volte il parametro `--lang` (ad esempio `--lang zh-Hans --lang en-US`).
60
+ - Potete specificare il prefisso dell'URL di base del sito con il parametro `--base-url` (ad esempio il nome della repository su GitHub Pages).
61
61
  - Non è necessario configurare la lingua sorgente, ZEN la rileverà automaticamente.
62
62
 
63
63
  ```bash
64
- npx zengen@latest build --lang it-IT --lang en-US
64
+ npx zengen@latest build --lang zh-Hans --lang en-US
65
65
  ```
66
66
 
67
- **Visualizza più parametri o la guida**:
67
+ **Per vedere più parametri o la guida**:
68
68
 
69
69
  ```bash
70
70
  npx zengen@latest
@@ -0,0 +1,30 @@
1
+ ---
2
+ 'title': "Tecniche per l'utilizzo della dichiarazione della data nei documenti ZEN"
3
+ 'summary': "Questo documento introduce le tecniche per dichiarare direttamente la data nel corpo del testo utilizzando lo strumento ZEN, confrontandole con il metodo tradizionale di dichiarazione della data tramite YAML Frontmatter in Markdown. Sottolinea le funzionalità di riconoscimento automatico ed elaborazione intelligente di ZEN, che migliorano l'esperienza utente, e le applica a tipi di contenuti come diari, blog e altri che richiedono una timeline."
4
+ 'tags':
5
+ - 'ZEN'
6
+ - 'Dichiarazione della data'
7
+ - 'Markdown'
8
+ - 'Elaborazione AI'
9
+ - 'Timeline'
10
+ - 'Esperienza utente'
11
+ - 'Gestione documenti'
12
+ 'inferred_date': '2026-01-08'
13
+ 'inferred_lang': 'zh-Hans'
14
+ ---
15
+
16
+ # Tecniche di utilizzo
17
+
18
+ ## Dichiarare la data nel corpo del testo
19
+
20
+ Nel corpo del testo è possibile utilizzare dichiarazioni di data come "Oggi è l'8 gennaio 2026" (lo stile del formato è libero), e ZEN le riconoscerà e elaborerà automaticamente.
21
+
22
+ I documenti Markdown tradizionali dichiarano la data tramite YAML Frontmatter, richiedendo di ricordare i campi corrispondenti, altrimenti la data potrebbe non essere riconosciuta correttamente.
23
+
24
+ ZEN supporta la dichiarazione diretta della data nel corpo del testo, evitando il problema di dimenticare di compilare i campi del Frontmatter.
25
+
26
+ L'AI estrarrà e dedurrà automaticamente le informazioni sulla data dal corpo del testo e le elaborerà come data di creazione del documento.
27
+
28
+ Questo metodo è più flessibile e intelligente, migliorando l'esperienza utente.
29
+
30
+ Inoltre, i documenti con date possono generare una vista timeline, facilitando la navigazione e la gestione. Particolarmente adatto per tipi di contenuti come diari, blog e altri che richiedono una timeline.
@@ -1,15 +1,15 @@
1
1
  ---
2
- title: ZEN - 極簡主義 Markdown + AI 静的サイトビルダー
3
- summary: ZENAIを統合した静的サイトジェネレーターで、インテリジェントな分類ナビゲーションと自動インクリメンタル翻訳をサポートします。ユーザーは母国語での執筆に集中でき、設定とビルドプロセスが簡素化されています。
4
- tags:
5
- - 静的サイトジェネレーター
6
- - Markdown
7
- - AI
8
- - 多言語翻訳
9
- - 極簡主義
10
- - ドキュメントツール
11
- - Node.js
12
- inferred_lang: ja-JP
2
+ 'title': 'ZEN - 極簡主義 Markdown + AI 静的サイトビルダー'
3
+ 'summary': 'ZENは、AI機能を統合した静的サイトジェネレーターです。ドキュメント執筆とサイト構築のプロセスを簡素化することを目的としており、ユーザーが母国語でMarkdownコンテンツを書くことに集中できるように設計されています。タイトルの自動生成、カテゴリ別ナビゲーション、インクリメンタル翻訳を自動的に処理し、複雑な設定なしで多言語バージョンをサポートします。このツールはNode.jsとOpenAI APIを基盤としており、コマンドラインからサイトを迅速に構築でき、効率性と簡潔さを求める執筆者に適しています。'
4
+ 'tags':
5
+ - '静的サイトジェネレーター'
6
+ - 'Markdown'
7
+ - 'AI'
8
+ - '極簡主義'
9
+ - '多言語翻訳'
10
+ - 'Node.js'
11
+ - 'OpenAI'
12
+ 'inferred_lang': 'zh-Hans'
13
13
  ---
14
14
 
15
15
  # ZEN - 極簡主義 Markdown + AI 静的サイトビルダー
@@ -18,53 +18,53 @@ inferred_lang: ja-JP
18
18
 
19
19
  ## 基本機能
20
20
 
21
- 1. 📃 **静的サイト生成**: Markdownを含む任意のgitフォルダを静的HTMLサイトに構築します。
22
- 2. 🧭 **インテリジェント分類ナビゲーション**: AIによるコンテンツ分析を使用して、サイトマップとナビゲーションを生成します。ソースファイルの位置に依存しません。
23
- 3. 🌍 **自動インクリメンタル翻訳**: AIによるインクリメンタル翻訳を使用し、ユーザーは母国語でMarkdownを記述できますが、多言語のユーザーに対応可能です。
21
+ 1. 📃 **静的サイト生成**:Markdownファイルを含む任意のgitフォルダを静的HTMLサイトに構築します。
22
+ 2. 🧭 **インテリジェント分類ナビゲーション**:AIを使用してコンテンツを分析し、サイトマップとナビゲーションを生成します。ソースファイルの位置に依存しません。
23
+ 3. 🌍 **自動インクリメンタル翻訳**:AIを使用したインクリメンタル翻訳により、ユーザーは母国語でMarkdownを執筆しながら、多言語でのコンテンツ提供が可能になります。
24
24
 
25
- なぜまたMarkdown静的サイトジェネレーターを作ったのか?AI時代において、ドキュメントツールが書き手により良くどのように奉仕できるか、私は再考しました:
25
+ なぜまたMarkdown静的サイトジェネレーターを作ったのか? AI時代において、ドキュメントツールが執筆者により良くどのように奉仕できるか、私は再考しました:
26
26
 
27
- - コンテンツへの回帰: 最小限の干渉で、執筆に集中
27
+ - コンテンツへの回帰:最小限の干渉で、執筆に集中
28
28
 
29
- ドキュメントを本質に戻し、執筆を静寂に戻します。
29
+ ドキュメントをその本質に戻し、執筆を静寂に帰します。
30
30
 
31
- 第一に、私は図書館司書になりたくありません。時々何かを書き留めたいと思うことがありますが、そのタイトルをまだ決めていないかもしれませんし、特別な組織化ができていないかもしれません。LLMが自動的にタイトルを生成し、要約、分類、ナビゲーションなどの整理作業を手伝ってくれることを望みます。
31
+ 第一に、私は図書館司書になりたくありません。時々、何かを書き留めたいと思うことがありますが、そのタイトルをまだ決めていなかったり、明確な構成ができていなかったりすることがあります。LLMが自動的にタイトルを生成し、要約、分類、ナビゲーションなどの整理作業をしてくれることを望んでいます。
32
32
 
33
- 第二に、私の書斎はきれいに掃除されていなければなりません。複雑な設定のビルドツールや、複雑なドキュメント設定、複雑な構造をいじりたくありません。Docusaurus、VuePress、Astroといったツールの設定ファイルやプロジェクト構造を見るたびに、私は頭が痛くなります。現在、ZENはすべての設定を `.zen` ディレクトリに隠し、隅に掃き寄せることを選択しました。ユーザーは執筆コンテンツにのみ集中し、他のことはZENに任せます。他のディレクトリはすべてあなたの執筆スペースであり、Markdownファイルを自由に整理できます。
33
+ 第二に、私の書斎はきれいに掃除されていなければなりません。複雑な設定のビルドツールや、複雑なドキュメント設定、複雑な構造は必要ありません。Docusaurus、VuePress、Astroといったツールの設定ファイルやプロジェクト構造を見るたびに、私は頭が痛くなります。現在、ZENはすべての設定を `.zen` ディレクトリに隠し、隅に掃き出すことを選択しました。ユーザーは執筆コンテンツに集中するだけでよく、残りはZENが処理します。他のディレクトリはすべてあなたの執筆スペースであり、Markdownファイルを自由に整理できます。
34
34
 
35
- - 母国語への回帰: 母国語で執筆し、滑らかに多言語バージョンを構築
35
+ - 母国語への回帰:母国語で執筆し、滑らかに多言語バージョンを構築
36
36
 
37
- 人生は短いので、翻訳は面倒です。人は母国語を使用するとき、自身の思考の深さを最も発揮できます。しかし同時に、世界とのつながりを保つことも必要であり、多言語でのコミュニケーションを諦めたくはありません。そこで私は、母国語で執筆しながら、より多くの人々に私のコンテンツを見てもらえるツールを望みました。現在のi18nは自分で翻訳するだけでなく、コンテンツの更新も自分で管理しなければならず、非常に面倒です。私はLLMを使って翻訳を手伝ってもらうことを選択し、多くの時間を節約し、ワンクリックで多国語翻訳を完了できます。
37
+ 人生は短いので、翻訳は面倒です。人は母国語を使用するとき、自身の思考の深みを最も発揮できます。しかし同時に、世界とのつながりを保つことも必要であり、多言語でのコミュニケーションを諦めたくはありません。そこで、母国語で執筆しながら、より多くの人々に私のコンテンツを見てもらえるツールを望んでいました。現在のi18nは自分で翻訳するだけでなく、コンテンツの更新も自分で管理しなければならず、非常に面倒です。私はLLMを使って翻訳を手伝ってもらうことを選択し、多くの時間を節約し、ワンクリックで複数の言語への翻訳を完了できます。
38
38
 
39
39
  ## クイックスタート
40
40
 
41
41
  前提条件:
42
42
 
43
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ルールでフィルタリングされたファイルを無視するため)
44
+ - [OpenAI API Key](https://platform.openai.com/account/api-keys) を取得済み、または OpenAI 互換の API Key を所持
45
+ - Git がインストール済み(GitからMarkdownファイルをリストアップし、.gitignoreルールでフィルタリングされたファイルを無視するために使用)
46
46
 
47
47
  まず、既にgitで管理されているフォルダ内で作業します:
48
48
 
49
49
  環境変数を設定します
50
50
 
51
51
  ```bash
52
- export OPENAI_API_KEY="sk-xxxxxx" # 必須: ご自身のOpenAI API Keyに置き換えてください
52
+ export OPENAI_API_KEY="sk-xxxxxx" # 必須:ご自身のOpenAI API Keyに置き換えてください
53
53
  export OPENAI_BASE_URL="https://api.openai.com/v1" # オプション、デフォルトはOpenAI公式APIを使用
54
54
  export OPENAI_MODEL="gpt-3.5-turbo" # オプション、デフォルトはgpt-3.5-turboモデルを使用
55
55
  ```
56
56
 
57
57
  サイトを構築し、多言語翻訳をサポートします。現在のディレクトリをソースディレクトリとして使用し、`.zen/dist` ディレクトリに出力します。
58
58
 
59
- - `--lang` パラメータを複数回使用して、生成する言語バージョンを指定できます(例: `--lang zh-Hans --lang en-US`)。
60
- - `--base-url` パラメータでサイトのベースURLプレフィックスを指定できます(例: GitHub Pages上のリポジトリ名)。
59
+ - `--lang` パラメータを複数回使用して、生成する言語バージョンを指定できます(例:`--lang zh-Hans --lang en-US`)。
60
+ - `--base-url` パラメータで、サイトのベースURLプレフィックスを指定できます(例:GitHub Pages上のリポジトリ名)。
61
61
  - ソース言語の設定は不要です。ZENが自動的に検出します。
62
62
 
63
63
  ```bash
64
64
  npx zengen@latest build --lang zh-Hans --lang en-US
65
65
  ```
66
66
 
67
- **その他のパラメータやヘルプを表示**:
67
+ **その他のパラメータやヘルプを表示する**:
68
68
 
69
69
  ```bash
70
70
  npx zengen@latest
@@ -0,0 +1,30 @@
1
+ ---
2
+ 'title': 'ZENドキュメントにおける日付宣言の使用テクニック'
3
+ 'summary': 'このドキュメントでは、ZENツールにおいて本文中で直接日付を宣言する使用テクニックを紹介します。従来のMarkdownがYAML Frontmatterを通じて日付を宣言する方法と比較し、ZENの自動認識とインテリジェントな処理機能を強調します。これによりユーザー体験が向上し、日記、ブログなどタイムラインが必要なコンテンツタイプに適しています。'
4
+ 'tags':
5
+ - 'ZEN'
6
+ - '日付宣言'
7
+ - 'Markdown'
8
+ - 'AI処理'
9
+ - 'タイムライン'
10
+ - 'ユーザー体験'
11
+ - 'ドキュメント管理'
12
+ 'inferred_date': '2026-01-08'
13
+ 'inferred_lang': 'zh-Hans'
14
+ ---
15
+
16
+ # 使用テクニック
17
+
18
+ ## 本文中での日付宣言
19
+
20
+ 本文中では「今日は2026年1月8日です」といった日付宣言(形式は自由)を使用することができ、ZENが自動的に認識・処理します。
21
+
22
+ 従来のMarkdownドキュメントでは、YAML Frontmatterを通じて日付を宣言する必要があり、対応するフィールドを覚えておかなければ、日付が正しく認識されない可能性がありました。
23
+
24
+ ZENは本文中での直接的な日付宣言をサポートしており、Frontmatterフィールドの記入忘れという問題を回避できます。
25
+
26
+ AIが本文中の日付情報を自動的に抽出・推論し、それをドキュメントの作成日として処理します。
27
+
28
+ この方法はより柔軟でインテリジェントであり、ユーザー体験を向上させます。
29
+
30
+ 付言すると、日付を持つドキュメントは、タイムラインビューを生成することができ、閲覧や管理が容易になります。特に日記、ブログなどタイムラインが必要なコンテンツタイプに適しています。