zengen 0.2.4 → 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.
- package/.zen/meta.json +27 -18
- package/.zen/src/ar-SA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +36 -36
- package/.zen/src/ar-SA/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/da-DK/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +29 -29
- package/.zen/src/da-DK/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/de-DE/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +24 -24
- package/.zen/src/de-DE/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/en-US/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +27 -27
- package/.zen/src/en-US/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/es-ES/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +34 -34
- package/.zen/src/es-ES/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/es-MX/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +31 -31
- package/.zen/src/es-MX/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/fi-FI/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +30 -30
- package/.zen/src/fi-FI/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/fr-FR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +26 -26
- package/.zen/src/fr-FR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/hi-IN/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +29 -29
- package/.zen/src/hi-IN/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/id-ID/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +27 -27
- package/.zen/src/id-ID/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/it-IT/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +38 -38
- package/.zen/src/it-IT/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/ja-JP/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +27 -27
- package/.zen/src/ja-JP/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/ko-KR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +25 -25
- package/.zen/src/ko-KR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/nl-NL/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +31 -31
- package/.zen/src/nl-NL/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/no-NO/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +32 -32
- package/.zen/src/no-NO/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/pl-PL/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +27 -27
- package/.zen/src/pl-PL/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/pt-BR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +34 -34
- package/.zen/src/pt-BR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/pt-PT/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +28 -28
- package/.zen/src/pt-PT/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/ru-RU/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +37 -37
- package/.zen/src/ru-RU/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/sv-SE/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +29 -29
- package/.zen/src/sv-SE/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/th-TH/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +30 -30
- package/.zen/src/th-TH/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/tr-TR/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +31 -31
- package/.zen/src/tr-TR/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/uk-UA/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +30 -30
- package/.zen/src/uk-UA/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/vi-VN/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +24 -24
- package/.zen/src/vi-VN/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +30 -0
- package/.zen/src/zh-Hans/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +14 -11
- package/.zen/src/zh-Hans/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +31 -0
- package/.zen/src/zh-Hant/74541be9d53c64107a548e09847244d52bff803960942cd2bfbd2a8600afb805.md +18 -15
- package/.zen/src/zh-Hant/9d0485c244a80b14dcc92ef91cf5ff82220ed774ebb5e09549929ac75200c7bc.md +31 -0
- package/dist/ai/extractMetadataFromMarkdown.js +3 -3
- package/dist/ai/extractMetadataFromMarkdown.js.map +1 -1
- package/dist/process/template.d.ts.map +1 -1
- package/dist/process/template.js +8 -5
- package/dist/process/template.js.map +1 -1
- package/dist/utils/frontmatter.js +1 -1
- package/dist/utils/frontmatter.js.map +1 -1
- package/docs/tricks.md +15 -0
- package/package.json +1 -1
- package/src/ai/extractMetadataFromMarkdown.ts +3 -3
- package/src/process/template.ts +10 -9
- package/src/utils/frontmatter.ts +1 -1
- package/.zen/src/de-DE/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
- package/.zen/src/de-DE/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/en-US/01d04f7c17b4a541ead9d759d877b30b403e15b849182a49eb1f62bd29ecd18c.md +0 -120
- package/.zen/src/en-US/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
- package/.zen/src/en-US/1b798c44a4f353e47296ca83d5905e37e6aba3e90bbd9bc3b3d34fc12059a2ca.md +0 -75
- package/.zen/src/en-US/1e96be58d76c60056b708eb5bd8b8b81d7b5845d9cfe0b879d85068a5f11df3a.md +0 -189
- package/.zen/src/en-US/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/en-US/5ec990146b35e00de2630559126ee07f7cdcddeb23b0e8cab3d85b4181353e26.md +0 -53
- package/.zen/src/en-US/6124ea88edec5bde737b26b21f71ecfeffe4e73151784856edf813ee231a4baa.md +0 -11
- package/.zen/src/en-US/80ae9bed74fc6348a7c1fe9f33e86b65f5d919169721f77bcf0e1bc29fbdb4f9.md +0 -61
- package/.zen/src/en-US/afbf4998656c97181d0edc711e388ad11e0f08f5c6f329861327202462a3a34a.md +0 -63
- package/.zen/src/en-US/f0c2799126931ccd113a0c45b1e623870b0d4f4f400becf6dd877da8f1011517.md +0 -40
- package/.zen/src/en-US/fdfca9b960d0eaa8b2b96fe988ead7481d2c0b16f66ebc94fb477139b4178cdc.md +0 -65
- package/.zen/src/es-ES/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
- package/.zen/src/es-ES/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/fr-FR/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
- package/.zen/src/fr-FR/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/ja-JP/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -71
- package/.zen/src/ja-JP/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/ko-KR/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/pt-PT/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
- package/.zen/src/pt-PT/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/ru-RU/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
- package/.zen/src/ru-RU/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/zh-Hans/01d04f7c17b4a541ead9d759d877b30b403e15b849182a49eb1f62bd29ecd18c.md +0 -120
- package/.zen/src/zh-Hans/04319611d7cde718d0e82da8e034e04b15fb3bb37c3784d8f7313577c5178b06.md +0 -73
- package/.zen/src/zh-Hans/084ef1f6a0167df8621c673c79211309d4af6c588e7bbe3e043f7c244edd0ac6.md +0 -80
- package/.zen/src/zh-Hans/1b798c44a4f353e47296ca83d5905e37e6aba3e90bbd9bc3b3d34fc12059a2ca.md +0 -77
- package/.zen/src/zh-Hans/1e96be58d76c60056b708eb5bd8b8b81d7b5845d9cfe0b879d85068a5f11df3a.md +0 -189
- package/.zen/src/zh-Hans/48eb2ad3e174cd06ed16c959fa58e0381dbc4a4147fa3456b21eea2b3d67c329.md +0 -81
- package/.zen/src/zh-Hans/5ec990146b35e00de2630559126ee07f7cdcddeb23b0e8cab3d85b4181353e26.md +0 -55
- package/.zen/src/zh-Hans/6124ea88edec5bde737b26b21f71ecfeffe4e73151784856edf813ee231a4baa.md +0 -11
- package/.zen/src/zh-Hans/80ae9bed74fc6348a7c1fe9f33e86b65f5d919169721f77bcf0e1bc29fbdb4f9.md +0 -63
- package/.zen/src/zh-Hans/afbf4998656c97181d0edc711e388ad11e0f08f5c6f329861327202462a3a34a.md +0 -63
- package/.zen/src/zh-Hans/f0c2799126931ccd113a0c45b1e623870b0d4f4f400becf6dd877da8f1011517.md +0 -40
- package/.zen/src/zh-Hans/fdfca9b960d0eaa8b2b96fe988ead7481d2c0b16f66ebc94fb477139b4178cdc.md +0 -65
|
@@ -1,50 +1,50 @@
|
|
|
1
1
|
---
|
|
2
|
-
title: ZEN -
|
|
3
|
-
summary: ZEN एक AI
|
|
4
|
-
tags:
|
|
5
|
-
- स्टैटिक साइट जनरेटर
|
|
6
|
-
-
|
|
7
|
-
- AI
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
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 -
|
|
15
|
+
# ZEN - एक न्यूनतावादी Markdown + AI स्टैटिक साइट बिल्डर
|
|
16
16
|
|
|
17
17
|
[> वेबसाइट डेमो](https://zccz14.github.io/ZEN/)
|
|
18
18
|
|
|
19
|
-
##
|
|
19
|
+
## मूल कार्यक्षमता
|
|
20
20
|
|
|
21
|
-
1.
|
|
22
|
-
2.
|
|
23
|
-
3.
|
|
21
|
+
1. 📃 **स्टैटिक साइट जनरेशन**: Markdown युक्त किसी भी git फ़ोल्डर को एक स्टैटिक HTML साइट में बदल देता है।
|
|
22
|
+
2. 🧭 **स्मार्ट वर्गीकरण नेविगेशन**: AI का उपयोग करके सामग्री विश्लेषण करता है, साइटमैप और नेविगेशन उत्पन्न करता है, स्रोत फ़ाइलों के स्थान से असंवेदनशील।
|
|
23
|
+
3. 🌍 **स्वचालित वृद्धिशील अनुवाद**: AI का उपयोग करके वृद्धिशील अनुवाद करता है, उपयोगकर्ताओं को मूल भाषा में Markdown लिखने देता है, लेकिन उपयोगकर्ता बहुभाषी हो सकते हैं।
|
|
24
24
|
|
|
25
|
-
फिर से एक
|
|
25
|
+
फिर से एक Markdown स्टैटिक साइट जनरेटर क्यों बनाया? मैंने AI युग में दस्तावेज़ उपकरण लेखकों की बेहतर सेवा कैसे कर सकते हैं, इस पर पुनर्विचार किया:
|
|
26
26
|
|
|
27
|
-
- सामग्री पर वापसी: व्यवधान को न्यूनतम करें, लेखन पर ध्यान
|
|
27
|
+
- सामग्री पर वापसी: व्यवधान को न्यूनतम करें, लेखन पर ध्यान दें
|
|
28
28
|
|
|
29
|
-
दस्तावेज़ों को उनके
|
|
29
|
+
दस्तावेज़ों को उनके सार में वापस लाएं, लेखन को शांति में वापस लाएं।
|
|
30
30
|
|
|
31
|
-
पहला, मैं पुस्तकालयाध्यक्ष नहीं बनना चाहता। कभी-कभी मैं कुछ सामग्री लिखना चाहता
|
|
31
|
+
पहला, मैं पुस्तकालयाध्यक्ष नहीं बनना चाहता। कभी-कभी मैं कुछ सामग्री लिखना चाहता हूं, लेकिन हो सकता है मैंने अभी तक इसका शीर्षक नहीं सोचा हो, कोई विशेष संगठन नहीं बनाया हो। मैं चाहता हूं कि LLM स्वचालित रूप से मेरे लिए शीर्षक उत्पन्न करे, सारांश बनाए, वर्गीकरण करे, नेविगेशन आदि व्यवस्थित करे।
|
|
32
32
|
|
|
33
|
-
दूसरा, मेरे अध्ययन कक्ष को साफ-सुथरा रखना होगा।
|
|
33
|
+
दूसरा, मेरे अध्ययन कक्ष को साफ-सुथरा रखना होगा। मुझे जटिल कॉन्फ़िगरेशन वाले निर्माण उपकरण, पेचीदा दस्तावेज़ कॉन्फ़िगरेशन, जटिल संरचनाएं नहीं चाहिए। हर बार जब मैं Docusaurus, VuePress, Astro जैसे उपकरणों के कॉन्फ़िगरेशन फ़ाइलों और प्रोजेक्ट संरचनाओं को देखता हूं, तो मेरा सिर दर्द करने लगता है। अब, ZEN ने सभी कॉन्फ़िगरेशन को `.zen` डायरेक्टरी में छिपाने, कोने में सरका देने का विकल्प चुना है, उपयोगकर्ता को केवल लेखन सामग्री पर ध्यान केंद्रित करना है, बाकी सब ZEN संभाल लेगा। अन्य सभी डायरेक्टरी आपकी लेखन जगह हैं, आप अपनी Markdown फ़ाइलों को मनचाहे ढंग से व्यवस्थित कर सकते हैं।
|
|
34
34
|
|
|
35
|
-
-
|
|
35
|
+
- मूल भाषा पर वापसी: मूल भाषा में लिखें, बहुभाषी संस्करणों का सहज निर्माण करें
|
|
36
36
|
|
|
37
|
-
जीवन छोटा है, मैं अनुवाद करने में आलसी
|
|
37
|
+
जीवन छोटा है, मैं अनुवाद करने में आलसी हूं। व्यक्ति अपनी मूल भाषा का उपयोग करते समय ही अपनी सोच की गहराई का पूरा उपयोग कर सकता है। लेकिन साथ ही दुनिया से जुड़े रहना भी ज़रूरी है, मैं बहुभाषी संवाद को छोड़ना नहीं चाहता। इसलिए मैं एक ऐसा उपकरण चाहता हूं जो मुझे मूल भाषा में लिखने दे, साथ ही मेरी सामग्री को और लोग देख सकें। वर्तमान i18n में न केवल खुद अनुवाद करना पड़ता है, बल्कि सामग्री अपडेट भी खुद बनाए रखनी पड़ती है, यह बहुत परेशानी भरा है। मैंने अनुवाद के लिए LLM का उपयोग करने का विकल्प चुना है, जिससे मेरा बहुत समय बचता है, और कई देशों की भाषाओं का अनुवाद एक क्लिक में पूरा किया जा सकता है।
|
|
38
38
|
|
|
39
39
|
## त्वरित प्रारंभ
|
|
40
40
|
|
|
41
41
|
पूर्वापेक्षाएँ:
|
|
42
42
|
|
|
43
|
-
- [Node.js](https://nodejs.org/) इंस्टॉल
|
|
44
|
-
- [OpenAI API Key](https://platform.openai.com/account/api-keys) प्राप्त
|
|
45
|
-
- Git इंस्टॉल
|
|
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
|
-
सबसे पहले, एक ऐसे फ़ोल्डर में काम करें जो पहले से
|
|
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
|
-
साइट
|
|
57
|
+
साइट बनाएं, बहुभाषी अनुवाद का समर्थन करता है। स्रोत डायरेक्टरी के रूप में वर्तमान डायरेक्टरी का उपयोग करें, `.zen/dist` डायरेक्टरी में आउटपुट करें।
|
|
58
58
|
|
|
59
59
|
- `--lang` पैरामीटर का बार-बार उपयोग करके आवश्यक भाषा संस्करण निर्दिष्ट किए जा सकते हैं (उदाहरण: `--lang zh-Hans --lang en-US`)।
|
|
60
|
-
- `--base-url` पैरामीटर
|
|
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
|
|
3
|
-
summary: ZEN adalah generator situs statis yang menggabungkan AI,
|
|
4
|
-
tags:
|
|
5
|
-
- Generator Situs Statis
|
|
6
|
-
- Markdown
|
|
7
|
-
- AI
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
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
|
|
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.
|
|
22
|
-
2.
|
|
23
|
-
3.
|
|
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
|
|
27
|
+
- **Kembali ke Konten**: Minimalkan gangguan, fokus pada menulis
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
Mengembalikan esensi dokumentasi, mengembalikan ketenangan dalam menulis.
|
|
30
30
|
|
|
31
|
-
Pertama, saya tidak ingin menjadi pustakawan. Terkadang saya ingin menulis sesuatu, tetapi mungkin
|
|
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
|
|
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
|
|
35
|
+
- **Kembali ke Bahasa Ibu**: Menulis dalam bahasa ibu, membangun versi multibahasa dengan lancar
|
|
36
36
|
|
|
37
|
-
Hidup ini singkat, saya malas menerjemahkan.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
60
|
-
- Dapat menentukan prefiks URL dasar situs dengan parameter `--base-url` (
|
|
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
|
|
3
|
-
summary: ZEN è un generatore di siti statici
|
|
4
|
-
tags:
|
|
5
|
-
- Generatore di
|
|
6
|
-
- Markdown
|
|
7
|
-
- AI
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
inferred_lang:
|
|
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
|
|
15
|
+
# ZEN - Generatore di siti statici minimalista Markdown + AI
|
|
16
16
|
|
|
17
|
-
[> Demo del
|
|
17
|
+
[> Demo del sito web](https://zccz14.github.io/ZEN/)
|
|
18
18
|
|
|
19
|
-
## Funzionalità di
|
|
19
|
+
## Funzionalità di base
|
|
20
20
|
|
|
21
|
-
1.
|
|
22
|
-
2.
|
|
23
|
-
3.
|
|
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
|
|
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
|
|
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
|
|
29
|
+
Far tornare la documentazione alla sua essenza, far tornare la scrittura alla tranquillità.
|
|
30
30
|
|
|
31
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
39
|
+
## Guida rapida
|
|
40
40
|
|
|
41
41
|
Prerequisiti:
|
|
42
42
|
|
|
43
|
-
- [Node.js](https://nodejs.org/) installato (
|
|
44
|
-
-
|
|
45
|
-
- Git installato (per elencare i file Markdown da una repository Git, ignorando i file filtrati dalle regole
|
|
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,
|
|
47
|
+
Innanzitutto, lavorate in una cartella già gestita da git:
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
Configurate le variabili d'ambiente
|
|
50
50
|
|
|
51
51
|
```bash
|
|
52
|
-
export OPENAI_API_KEY="sk-xxxxxx" # Obbligatorio:
|
|
53
|
-
export OPENAI_BASE_URL="https://api.openai.com/v1" # Opzionale,
|
|
54
|
-
export OPENAI_MODEL="gpt-3.5-turbo" # Opzionale,
|
|
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
|
-
|
|
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
|
-
-
|
|
60
|
-
-
|
|
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
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
65
|
```
|
|
66
66
|
|
|
67
|
-
**
|
|
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: ZEN
|
|
4
|
-
tags:
|
|
5
|
-
- 静的サイトジェネレーター
|
|
6
|
-
- Markdown
|
|
7
|
-
- AI
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
inferred_lang:
|
|
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.
|
|
22
|
-
2.
|
|
23
|
-
3.
|
|
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
|
-
|
|
31
|
+
第一に、私は図書館司書になりたくありません。時々、何かを書き留めたいと思うことがありますが、そのタイトルをまだ決めていなかったり、明確な構成ができていなかったりすることがあります。LLMが自動的にタイトルを生成し、要約、分類、ナビゲーションなどの整理作業をしてくれることを望んでいます。
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
第二に、私の書斎はきれいに掃除されていなければなりません。複雑な設定のビルドツールや、複雑なドキュメント設定、複雑な構造は必要ありません。Docusaurus、VuePress、Astroといったツールの設定ファイルやプロジェクト構造を見るたびに、私は頭が痛くなります。現在、ZENはすべての設定を `.zen` ディレクトリに隠し、隅に掃き出すことを選択しました。ユーザーは執筆コンテンツに集中するだけでよく、残りはZENが処理します。他のディレクトリはすべてあなたの執筆スペースであり、Markdownファイルを自由に整理できます。
|
|
34
34
|
|
|
35
|
-
-
|
|
35
|
+
- 母国語への回帰:母国語で執筆し、滑らかに多言語バージョンを構築
|
|
36
36
|
|
|
37
|
-
|
|
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) を取得済み、または
|
|
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" #
|
|
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`
|
|
60
|
-
- `--base-url`
|
|
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
|
+
付言すると、日付を持つドキュメントは、タイムラインビューを生成することができ、閲覧や管理が容易になります。特に日記、ブログなどタイムラインが必要なコンテンツタイプに適しています。
|