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.
- package/.zen/meta.json +7 -8
- package/.zen/src/ar-SA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ar-SA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/da-DK/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/da-DK/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/de-DE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/de-DE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/en-US/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/en-US/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/es-ES/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/es-ES/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/es-MX/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/es-MX/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/fi-FI/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/fi-FI/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/fr-FR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/fr-FR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/hi-IN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/hi-IN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/id-ID/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/id-ID/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/it-IT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/it-IT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ja-JP/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ja-JP/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ko-KR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ko-KR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/nl-NL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/nl-NL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/no-NO/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/no-NO/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pl-PL/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pl-PL/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pt-BR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pt-BR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/pt-PT/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/pt-PT/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/ru-RU/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/ru-RU/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/sv-SE/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/sv-SE/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/th-TH/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/th-TH/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/tr-TR/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/tr-TR/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/uk-UA/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/uk-UA/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/vi-VN/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/vi-VN/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/.zen/src/zh-Hans/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +74 -0
- package/.zen/src/zh-Hans/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +75 -0
- package/.zen/src/zh-Hant/6e7ca196ba51235db30218cf9b28f92d35937b09a22411062be088a0086b29ed.md +70 -0
- package/.zen/src/zh-Hant/98a9dd72146a69d155030cb7286ea2d10e0521451de9754cbdfcde46c46f2c71.md +71 -0
- package/README.md +1 -2
- package/dist/build/pipeline.d.ts.map +1 -1
- package/dist/build/pipeline.js +0 -1
- package/dist/build/pipeline.js.map +1 -1
- package/dist/cli.js +0 -2
- package/dist/cli.js.map +1 -1
- package/dist/process/template.d.ts.map +1 -1
- package/dist/process/template.js +3 -4
- package/dist/process/template.js.map +1 -1
- package/dist/types.d.ts +0 -1
- package/dist/types.d.ts.map +1 -1
- package/package.json +2 -2
- package/src/build/pipeline.ts +0 -1
- package/src/cli.ts +0 -2
- package/src/process/template.ts +3 -9
- package/src/types.ts +0 -1
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - 미니멀리즘 Markdown + AI 정적 사이트 빌더'
|
|
3
|
+
'summary': 'ZEN은 AI를 결합한 정적 사이트 생성기로, 문서 작성과 빌드 과정을 단순화하는 데 중점을 둡니다. 사용자가 복잡한 설정 없이 git으로 관리되는 폴더에서 Markdown을 사용해 정적 HTML 사이트를 생성할 수 있으며, 모든 설정은 .zen 디렉토리 아래에 숨겨져 있습니다. 핵심 기능으로는 지능형 분류 네비게이션(AI가 내용을 분석해 사이트맵 생성), 자동 증분 번역(다국어 버전 지원, 사용자는 모국어로 작성하고 AI가 번역 처리), 그리고 최소한의 방해로 글쓰기 경험이 포함됩니다. 이 도구는 Node.js, OpenAI API 키, Git에 의존하며, 명령줄을 통해 빠르게 빌드할 수 있고 zh-Hans 및 en-US와 같은 언어 매개변수를 지정할 수 있습니다.'
|
|
4
|
+
'tags':
|
|
5
|
+
- '정적 사이트 생성기'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- '다국어 번역'
|
|
9
|
+
- '미니멀리즘'
|
|
10
|
+
- '문서 도구'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'ko-KR'
|
|
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 Key 및 Git 획득을 요구하며, 명령줄을 통해 사이트를 구축하고 언어와 기본 URL을 지정할 수 있습니다.'
|
|
4
|
+
'tags':
|
|
5
|
+
- '정적 사이트 생성기'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- '다국어 번역'
|
|
9
|
+
- '미니멀리즘'
|
|
10
|
+
- '문서 도구'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'ko-KR'
|
|
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 ko-KR --lang en-US`).
|
|
60
|
+
- `--base-url` 매개변수로 사이트의 기본 URL 접두사를 지정할 수 있습니다 (예: GitHub Pages의 저장소 이름).
|
|
61
|
+
- 소스 언어를 구성할 필요가 없으며, ZEN이 자동으로 감지합니다.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang ko-KR --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**더 많은 매개변수 또는 도움말 보기**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistische Markdown + AI Statische Site Bouwer'
|
|
3
|
+
'summary': 'ZEN is een statische site generator gecombineerd met AI, gericht op het vereenvoudigen van het documentatie schrijf- en bouwproces. Het stelt gebruikers in staat om statische HTML-sites te maken in git-beheerde mappen met behulp van Markdown, zonder complexe configuratie; alle instellingen zijn verborgen in de .zen map. Kernfuncties omvatten intelligente categorisatie en navigatie (via AI-analyse van inhoud om een sitemap te genereren), automatische incrementele vertaling (ondersteunt meertalige versies, gebruikers kunnen in hun moedertaal schrijven, AI verwerkt de vertaling), en een minimale schrijfonderbreking ervaring. De tool vereist Node.js, een OpenAI API Key en Git, bouwt snel via de command line, en ondersteunt het specificeren van taalparameters zoals zh-Hans en en-US.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Statische Site Generator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Meertalige Vertaling'
|
|
9
|
+
- 'Minimalisme'
|
|
10
|
+
- 'Documentatie Tool'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistische Markdown + AI Statische Site Bouwer
|
|
16
|
+
|
|
17
|
+
[> Website Demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Basisfunctionaliteiten
|
|
20
|
+
|
|
21
|
+
1. 📃 **Statische Site Generatie**: Bouw een willekeurige git-map met Markdown-bestanden om tot een statische HTML-site.
|
|
22
|
+
2. 🧭 **Intelligente Categorisatie en Navigatie**: Gebruik AI voor inhoudsanalyse om een sitemap en navigatie te genereren, ongeacht de locatie van de bronbestanden.
|
|
23
|
+
3. 🌍 **Automatische Incrementele Vertaling**: Gebruik AI voor incrementele vertaling, zodat gebruikers Markdown in hun moedertaal kunnen schrijven, maar de site meertalig kan zijn.
|
|
24
|
+
|
|
25
|
+
Waarom nog een Markdown statische site generator? Ik heb opnieuw nagedacht over hoe documentatietools in het AI-tijdperk schrijvers beter kunnen dienen:
|
|
26
|
+
|
|
27
|
+
- Terug naar inhoud: Minimale onderbreking, focus op schrijven
|
|
28
|
+
|
|
29
|
+
Laat documentatie terugkeren naar de essentie, laat schrijven terugkeren naar rust.
|
|
30
|
+
|
|
31
|
+
Ten eerste, ik wil geen bibliothecaris zijn. Soms wil ik iets opschrijven, maar ik heb misschien nog geen titel bedacht of een duidelijke structuur gevormd. Ik hoop dat LLM automatisch titels voor me genereert, samenvattingen maakt, categoriseert, navigatie regelt en ander organisatiewerk doet.
|
|
32
|
+
|
|
33
|
+
Ten tweede, mijn werkkamer moet opgeruimd zijn. Ik wil geen complexe bouwtools configureren, geen ingewikkelde documentatie-instellingen, geen complexe structuren. Elke keer als ik de configuratiebestanden en projectstructuren van tools zoals Docusaurus, VuePress, Astro zie, krijg ik hoofdpijn. Nu kiest ZEN ervoor om alle configuratie te verbergen in de .zen map, weggeveegd in een hoekje. Gebruikers hoeven zich alleen te concentreren op het schrijven van inhoud, de rest laat ZEN afhandelen. Alle andere mappen zijn uw schrijfruimte, u kunt uw Markdown-bestanden vrij organiseren.
|
|
34
|
+
|
|
35
|
+
- Terug naar moedertaal: Schrijf in je moedertaal, bouw soepel meertalige versies
|
|
36
|
+
|
|
37
|
+
Het leven is kort, ik heb geen zin om te vertalen. Mensen kunnen hun denkdiepte het beste benutten wanneer ze hun moedertaal gebruiken. Maar tegelijkertijd is verbinding met de wereld noodzakelijk, ik wil meertalige communicatie niet opgeven. Daarom hoop ik op een tool waarmee ik in mijn moedertaal kan schrijven, terwijl meer mensen mijn inhoud kunnen zien. De huidige i18n vereist niet alleen zelfvertaling, maar ook zelfonderhoud van inhoudsupdates, dat is te veel gedoe. Ik kies ervoor om LLM te gebruiken om me te helpen met vertalen, wat me veel tijd bespaart en meertalige vertalingen met één klik mogelijk maakt.
|
|
38
|
+
|
|
39
|
+
## Snel Starten
|
|
40
|
+
|
|
41
|
+
Vereisten:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) geïnstalleerd (versie 18 of hoger aanbevolen, npx commando nodig)
|
|
44
|
+
- Een [OpenAI API Key](https://platform.openai.com/account/api-keys) verkregen, of een OPENAI-compatibele API Key
|
|
45
|
+
- Git geïnstalleerd (om Markdown-bestanden uit Git op te lijsten, bestanden gefilterd door .gitignore regels te negeren)
|
|
46
|
+
|
|
47
|
+
Werk eerst in een map die al door Git wordt beheerd:
|
|
48
|
+
|
|
49
|
+
Configureer omgevingsvariabelen
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Verplicht: Vervang door uw OpenAI API Key
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Optioneel, gebruikt standaard de officiële OpenAI API
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Optioneel, gebruikt standaard het gpt-3.5-turbo model
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Bouw de site, ondersteunt meertalige vertaling. Gebruik de huidige map als bronmap, uitvoer naar de `.zen/dist` map.
|
|
58
|
+
|
|
59
|
+
- U kunt meerdere keren de `--lang` parameter gebruiken om de gewenste taalversies op te geven (bijv. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Bron taal hoeft niet geconfigureerd te worden, ZEN detecteert dit automatisch.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Bekijk meer parameters of help**:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx zengen@latest
|
|
70
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistische Markdown + AI Statische Site Generator'
|
|
3
|
+
'summary': 'ZEN is een statische site generator met AI-functionaliteiten, speciaal ontworpen voor Markdown-documenten. Het stelt gebruikers in staat om een Git-map met Markdown-bestanden om te zetten in een statische HTML-site, zonder complexe configuratie; alle instellingen zijn verborgen in de .zen-map. Kernfuncties zijn onder meer intelligente categorisatie en navigatie (gebruikmakend van AI om inhoud te analyseren en een sitemap te genereren), automatische incrementele vertaling (ondersteunt meertalige versies, gebruikers kunnen in hun moedertaal schrijven, AI verzorgt de vertaling), en een schrijfervaring met minimale afleiding. De snelstartgids vereist de installatie van Node.js, het verkrijgen van een OpenAI API Key en Git, het bouwen van de site via de commandoregel, en ondersteunt het specificeren van taal en basis-URL.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Statische Site Generator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Meertalige Vertaling'
|
|
9
|
+
- 'Minimalisme'
|
|
10
|
+
- 'Documentatietool'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistische Markdown + AI Statische Site Generator
|
|
16
|
+
|
|
17
|
+
[> Website Demo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Basisfunctionaliteiten
|
|
20
|
+
|
|
21
|
+
1. 📃 **Statische Site Generatie**: Bouw een willekeurige Git-map met Markdown-bestanden om naar een statische HTML-site.
|
|
22
|
+
2. 🧭 **Intelligente Categorisatie en Navigatie**: Gebruik AI voor inhoudsanalyse, genereer een sitemap en navigatie, ongeacht de locatie van de bronbestanden.
|
|
23
|
+
3. 🌍 **Automatische Incrementele Vertaling**: Gebruik AI voor incrementele vertaling, zodat gebruikers in hun moedertaal Markdown kunnen schrijven, maar de site meertalig kan zijn.
|
|
24
|
+
|
|
25
|
+
Waarom nog een Markdown statische site generator? Ik heb opnieuw nagedacht over hoe documentatietools in het AI-tijdperk schrijvers beter kunnen dienen:
|
|
26
|
+
|
|
27
|
+
- Terug naar inhoud: Minimale afleiding, focus op schrijven
|
|
28
|
+
|
|
29
|
+
Laat documentatie terugkeren naar de essentie, laat schrijven terugkeren naar rust.
|
|
30
|
+
|
|
31
|
+
Ten eerste, ik wil geen bibliothecaris zijn. Soms wil ik iets opschrijven, maar ik heb misschien nog geen titel bedacht of een duidelijke structuur gevormd. Ik hoop dat LLM automatisch titels voor me genereert, samenvattingen maakt, categoriseert, navigatie regelt en ander organisatiewerk doet.
|
|
32
|
+
|
|
33
|
+
Ten tweede, mijn werkkamer moet opgeruimd zijn. Ik wil geen complexe bouwtools configureren, geen ingewikkelde documentatie-instellingen uitzoeken, en houd niet van complexe structuren. Elke keer als ik de configuratiebestanden en projectstructuren van tools zoals Docusaurus, VuePress, Astro zie, krijg ik hoofdpijn. Nu kiest ZEN ervoor om alle configuratie te verbergen in de .zen-map, weggeveegd in een hoekje. Gebruikers hoeven zich alleen te concentreren op het schrijven van inhoud, de rest laat ZEN afhandelen. Alle andere mappen zijn uw schrijfruimte, u kunt uw Markdown-bestanden vrij organiseren.
|
|
34
|
+
|
|
35
|
+
- Terug naar moedertaal: Schrijf in je moedertaal, bouw soepel meertalige versies
|
|
36
|
+
|
|
37
|
+
Het leven is kort, ik heb geen zin om te vertalen. Mensen kunnen hun denkdiepte het beste benutten wanneer ze hun moedertaal gebruiken. Maar tegelijkertijd is verbinding met de wereld noodzakelijk, ik wil meertalige communicatie niet opgeven. Daarom wilde ik een tool die me in staat stelt in mijn moedertaal te schrijven, terwijl meer mensen mijn inhoud kunnen zien. De huidige i18n vereist niet alleen zelfvertaling, maar ook zelfonderhoud van inhoudsupdates, dat is te veel gedoe. Ik kies ervoor om LLM te gebruiken om voor mij te vertalen, wat me veel tijd bespaart en meertalige vertalingen met één klik mogelijk maakt.
|
|
38
|
+
|
|
39
|
+
## Snelstart
|
|
40
|
+
|
|
41
|
+
Vereisten:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) geïnstalleerd (aanbevolen versie 18 of hoger, npx-commando vereist)
|
|
44
|
+
- Een [OpenAI API Key](https://platform.openai.com/account/api-keys) verkregen, of een OPENAI-compatibele API Key
|
|
45
|
+
- Git geïnstalleerd (om Markdown-bestanden uit Git op te lijsten, bestanden gefilterd door .gitignore-regels te negeren)
|
|
46
|
+
|
|
47
|
+
Werk eerst in een map die al door Git wordt beheerd:
|
|
48
|
+
|
|
49
|
+
Configureer omgevingsvariabelen
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Verplicht: Vervang door uw OpenAI API Key
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Optioneel, gebruikt standaard het officiële OpenAI API
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Optioneel, gebruikt standaard het gpt-3.5-turbo model
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Bouw de site, ondersteunt meertalige vertaling. Gebruik de huidige map als bronmap, uitvoer naar de `.zen/dist` map.
|
|
58
|
+
|
|
59
|
+
- U kunt meerdere keren de `--lang` parameter gebruiken om de gewenste taalversies op te geven (bijv. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- U kunt de `--base-url` parameter gebruiken om het basis-URL-voorvoegsel van de site op te geven (bijv. de repositorynaam op GitHub Pages).
|
|
61
|
+
- Bron taal hoeft niet geconfigureerd te worden, ZEN detecteert dit automatisch.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Meer parameters of hulp bekijken**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistisk Markdown + AI-statisk nettstedbygger'
|
|
3
|
+
'summary': 'ZEN er en statisk nettstedgenerator med AI-integrasjon som fokuserer på å forenkle dokumentasjon og byggeprosessen. Den lar brukere opprette statiske HTML-nettsteder fra git-styrte mapper ved hjelp av Markdown, uten kompleks konfigurasjon – alle innstillinger er skjult i .zen-mappen. Kjernefunksjoner inkluderer intelligent kategorinavigasjon (genererer nettstedskart via AI-analyse), automatisk inkrementell oversettelse (støtter flerspråklige versjoner, brukere kan skrive på morsmålet mens AI håndterer oversettelsen), og en minimalt forstyrrende skriveopplevelse. Verktøyet krever Node.js, OpenAI API-nøkkel og Git, bygges raskt via kommandolinje, og støtter språkparametere som zh-Hans og en-US.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Statisk nettstedgenerator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Flerspråklig oversettelse'
|
|
9
|
+
- 'Minimalisme'
|
|
10
|
+
- 'Dokumentasjonsverktøy'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistisk Markdown + AI-statisk nettstedbygger
|
|
16
|
+
|
|
17
|
+
[> Nettsteddemo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Grunnleggende funksjoner
|
|
20
|
+
|
|
21
|
+
1. 📃 **Statisk nettstedgenerering**: Bygg et statisk HTML-nettsted fra en hvilken som helst git-mappe som inneholder Markdown-filer.
|
|
22
|
+
2. 🧭 **Intelligent kategorinavigasjon**: Bruker AI til å analysere innhold og generere nettstedskart og navigasjon, uavhengig av kildefilenes plassering.
|
|
23
|
+
3. 🌍 **Automatisk inkrementell oversettelse**: Bruker AI til inkrementell oversettelse, slik at brukere kan skrive Markdown på morsmålet, mens nettstedet blir flerspråklig.
|
|
24
|
+
|
|
25
|
+
Hvorfor lagde jeg enda en Markdown-statisk nettstedgenerator? Jeg har tenkt på hvordan dokumentasjonsverktøy i AI-tiden bedre kan tjene skribenter:
|
|
26
|
+
|
|
27
|
+
- Tilbake til innholdet: Minimal forstyrrelse, fokus på skriving
|
|
28
|
+
|
|
29
|
+
La dokumentasjonen vende tilbake til essensen, og la skrivingen bli rolig.
|
|
30
|
+
|
|
31
|
+
For det første vil jeg ikke være bibliotekar. Noen ganger vil jeg skrive ned noe, men jeg har kanskje ikke tenkt ut en tittel ennå, eller organisert det godt. Jeg ønsker at LLM automatisk skal generere titler, lage sammendrag, kategorisere og lage navigasjon for meg.
|
|
32
|
+
|
|
33
|
+
For det andre må kontoret mitt være rent. Jeg vil ikke ha komplekse byggeverktøy med innviklede konfigurasjoner, eller krøkkete dokumentasjonsstrukturer. Hver gang jeg ser konfigurasjonsfiler og prosjektstrukturer fra Docusaurus, VuePress eller Astro, får jeg hodepine. Nå har ZEN valgt å skjule all konfigurasjon i .zen-mappen, gjemt bort i et hjørne. Brukeren trenger bare å fokusere på å skrive innhold, resten håndterer ZEN. Alle andre mapper er din skriveplass, du kan organisere Markdown-filene dine som du vil.
|
|
34
|
+
|
|
35
|
+
- Tilbake til morsmålet: Skriv på morsmålet, bygg flerspråklige versjoner sømløst
|
|
36
|
+
|
|
37
|
+
Livet er for kort til at jeg gidder å oversette. Når man bruker morsmålet, kan man tenke på sitt dypeste. Men det er også nødvendig å forbli tilkoblet verden, og jeg vil ikke gi opp flerspråklig kommunikasjon. Derfor ønsker jeg et verktøy som lar meg skrive på morsmålet, samtidig som flere kan se innholdet mitt. Dagens i18n krever at man oversetter selv og vedlikeholder oppdateringer, det er for mye arbeid. Jeg velger å bruke LLM til å oversette for meg, det sparer mye tid og gjør flerspråklige oversettelser til én knappetrykking.
|
|
38
|
+
|
|
39
|
+
## Kom i gang raskt
|
|
40
|
+
|
|
41
|
+
Forutsetninger:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) er installert (anbefalt versjon 18 eller nyere, må ha npx-kommandoen)
|
|
44
|
+
- Du har en [OpenAI API-nøkkel](https://platform.openai.com/account/api-keys), eller en OPENAI-kompatibel API-nøkkel
|
|
45
|
+
- Git er installert (brukes til å liste Markdown-filer fra Git, ignorerer filer filtrert av .gitignore-regler)
|
|
46
|
+
|
|
47
|
+
Først, arbeid i en mappe som allerede er styrt av Git:
|
|
48
|
+
|
|
49
|
+
Konfigurer miljøvariabler
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Påkrevd: erstatt med din OpenAI API-nøkkel
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Valgfritt, bruker offisiell OpenAI API som standard
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Valgfritt, bruker gpt-3.5-turbo-modellen som standard
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Bygg nettstedet, støtter flerspråklig oversettelse. Bruker gjeldende mappe som kilde, output til `.zen/dist`-mappen.
|
|
58
|
+
|
|
59
|
+
- Du kan spesifisere språkversjoner som skal genereres ved å bruke `--lang`-parameteren flere ganger (f.eks. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Kilde språk trenger ikke konfigureres, ZEN oppdager det automatisk.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Se flere parametere eller få hjelp**:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx zengen@latest
|
|
70
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistisk Markdown + AI-statisk nettstedbygger'
|
|
3
|
+
'summary': 'ZEN er en statisk nettstedgenerator med AI-funksjoner, spesielt designet for Markdown-dokumenter. Den lar brukere konvertere en Git-mappe som inneholder Markdown-filer til et statisk HTML-nettsted uten kompleks konfigurasjon, med alle innstillinger skjult i .zen-katalogen. Kjernefunksjoner inkluderer intelligent kategorinavigasjon (bruker AI til å analysere innhold og generere nettstedskart), automatisk inkrementell oversettelse (støtter flerspråklige versjoner, brukere kan skrive på morsmålet, AI håndterer oversettelse), og en minimalt forstyrrende skriveopplevelse. Hurtigstartveiledningen krever installasjon av Node.js, anskaffelse av OpenAI API-nøkkel og Git, bygging av nettstedet via kommandolinjen, med støtte for spesifisering av språk og basis-URL.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Statisk nettstedgenerator'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Flerspråklig oversettelse'
|
|
9
|
+
- 'Minimalisme'
|
|
10
|
+
- 'Dokumentverktøy'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistisk Markdown + AI-statisk nettstedbygger
|
|
16
|
+
|
|
17
|
+
[> Nettsteddemo](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Grunnleggende funksjoner
|
|
20
|
+
|
|
21
|
+
1. 📃 **Statisk nettstedgenerering**: Bygg en hvilken som helst Git-mappe som inneholder Markdown til et statisk HTML-nettsted.
|
|
22
|
+
2. 🧭 **Intelligent kategorinavigasjon**: Bruker AI til innholdsanalyse, genererer nettstedskart og navigasjon, uavhengig av kildefilenes plassering.
|
|
23
|
+
3. 🌍 **Automatisk inkrementell oversettelse**: Bruker AI til inkrementell oversettelse, slik at brukere kan skrive Markdown på morsmålet, men nettstedet kan være flerspråklig.
|
|
24
|
+
|
|
25
|
+
Hvorfor lagde jeg enda en Markdown-statisk nettstedgenerator? Jeg har tenkt på nytt over hvordan dokumentverktøy i AI-tiden bedre kan tjene skribenter:
|
|
26
|
+
|
|
27
|
+
- Tilbake til innholdet: Minimal forstyrrelse, fokus på skriving
|
|
28
|
+
|
|
29
|
+
La dokumenter gå tilbake til essensen, la skrivingen gå tilbake til ro.
|
|
30
|
+
|
|
31
|
+
For det første vil jeg ikke være bibliotekar. Noen ganger vil jeg skrive ned noe, men jeg har kanskje ikke tenkt ut tittelen ennå, eller organisert det spesielt. Jeg ønsker at LLM automatisk skal hjelpe meg med å generere titler, lage sammendrag, kategorisere, navigere og andre organiseringsoppgaver.
|
|
32
|
+
|
|
33
|
+
For det andre må mitt skrivebord være rent. Jeg vil ikke ha komplekse konfigurasjonsverktøy, krangle med innviklede dokumentoppsett, eller liker komplekse strukturer. Hver gang jeg ser konfigurasjonsfiler og prosjektstrukturer fra verktøy som Docusaurus, VuePress, Astro, får jeg hodepine. Nå velger ZEN å skjule all konfigurasjon i .zen-katalogen, feie den bort i et hjørne. Brukeren trenger bare å fokusere på å skrive innhold, resten håndteres av ZEN. Alle andre kataloger er ditt skriveområde, du kan organisere Markdown-filene dine som du vil.
|
|
34
|
+
|
|
35
|
+
- Tilbake til morsmålet: Skriv på morsmålet, bygg flerspråklige versjoner sømløst
|
|
36
|
+
|
|
37
|
+
Livet er kort, jeg gidder ikke oversette. Når man bruker morsmålet, kan man utnytte sin tankedybde best. Men samtidig er det nødvendig å forbli tilkoblet verden, jeg vil ikke gi slipp på flerspråklig kommunikasjon. Derfor ønsker jeg et verktøy som lar meg skrive på morsmålet, samtidig som det lar flere se innholdet mitt. Nåværende i18n krever at man oversetter selv, og i tillegg må man vedlikeholde innholdsopdateringer, det er for mye arbeid. Jeg velger å bruke LLM til å hjelpe meg med oversettelse, det sparer mye tid og kan fullføre oversettelse til flere språk med ett klikk.
|
|
38
|
+
|
|
39
|
+
## Hurtigstart
|
|
40
|
+
|
|
41
|
+
Forutsetninger:
|
|
42
|
+
|
|
43
|
+
- [Node.js](https://nodejs.org/) er installert (anbefalt versjon 18 eller høyere, må ha npx-kommandoen)
|
|
44
|
+
- [OpenAI API-nøkkel](https://platform.openai.com/account/api-keys) er anskaffet, eller en OPENAI-kompatibel API-nøkkel
|
|
45
|
+
- Git er installert (brukes til å liste Markdown-filer fra Git, ignorerer filer filtrert av .gitignore-regler)
|
|
46
|
+
|
|
47
|
+
Først, arbeid i en mappe som allerede er administrert av Git:
|
|
48
|
+
|
|
49
|
+
Konfigurer miljøvariabler
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Påkrevd: Erstatt med din OpenAI API-nøkkel
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Valgfritt, bruker offisiell OpenAI API som standard
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Valgfritt, bruker gpt-3.5-turbo-modellen som standard
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Bygg nettstedet, støtter flerspråklig oversettelse. Bruker gjeldende katalog som kildekatalog, skriver ut til `.zen/dist`-katalogen.
|
|
58
|
+
|
|
59
|
+
- Du kan spesifisere språkversjoner som skal genereres ved å bruke `--lang`-parameteren flere ganger (f.eks. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Du kan spesifisere nettstedets basis-URL-prefiks med `--base-url`-parameteren (f.eks. depotnavn på GitHub Pages).
|
|
61
|
+
- Kilde språk trenger ikke konfigureres, ZEN oppdager det automatisk.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Se flere parametere eller hjelp**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistyczny generator statycznych stron Markdown + AI'
|
|
3
|
+
'summary': 'ZEN to generator statycznych stron zintegrowany z AI, skupiający się na uproszczeniu procesu pisania dokumentów i budowania. Umożliwia użytkownikom tworzenie statycznych stron HTML w folderze zarządzanym przez git przy użyciu Markdown, bez skomplikowanej konfiguracji – wszystkie ustawienia są ukryte w katalogu .zen. Kluczowe funkcje obejmują inteligentną nawigację kategorii (generowanie mapy strony poprzez analizę treści przez AI), automatyczne tłumaczenie przyrostowe (obsługa wersji wielojęzycznych, użytkownicy mogą pisać w języku ojczystym, a AI zajmuje się tłumaczeniem) oraz doświadczenie pisania z minimalnymi zakłóceniami. Narzędzie wymaga Node.js, klucza API OpenAI i Gita, umożliwia szybkie budowanie przez wiersz poleceń i obsługuje parametry językowe, takie jak zh-Hans i en-US.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'generator statycznych stron'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'tłumaczenie wielojęzyczne'
|
|
9
|
+
- 'minimalizm'
|
|
10
|
+
- 'narzędzie do dokumentacji'
|
|
11
|
+
- 'ZEN'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistyczny generator statycznych stron Markdown + AI
|
|
16
|
+
|
|
17
|
+
[> Demo strony internetowej](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Podstawowe funkcje
|
|
20
|
+
|
|
21
|
+
1. 📃 **Generowanie statycznych stron**: Przekształca dowolny folder git zawierający pliki Markdown w statyczną stronę HTML.
|
|
22
|
+
2. 🧭 **Inteligentna nawigacja kategorii**: Wykorzystuje AI do analizy treści, generując mapę strony i nawigację, niezależnie od lokalizacji plików źródłowych.
|
|
23
|
+
3. 🌍 **Automatyczne tłumaczenie przyrostowe**: Wykorzystuje AI do tłumaczenia przyrostowego, pozwalając użytkownikom pisać w Markdown w języku ojczystym, jednocześnie udostępniając treść w wielu językach.
|
|
24
|
+
|
|
25
|
+
Po co kolejny generator statycznych stron Markdown? Ponownie przemyślałem, jak narzędzia do dokumentacji w erze AI mogą lepiej służyć autorom:
|
|
26
|
+
|
|
27
|
+
- **Powrót do treści: Minimalne zakłócenia, skupienie na pisaniu**
|
|
28
|
+
|
|
29
|
+
Niech dokumenty wrócą do swojej istoty, a pisanie do spokoju.
|
|
30
|
+
|
|
31
|
+
Po pierwsze, nie chcę być bibliotekarzem. Czasami chcę coś napisać, ale może jeszcze nie wymyśliłem tytułu ani nie ukształtowałem struktury. Chcę, aby LLM automatycznie generował dla mnie tytuły, tworzył streszczenia, kategoryzował, organizował nawigację i inne zadania porządkowe.
|
|
32
|
+
|
|
33
|
+
Po drugie, moje biurko musi być czyste. Nie chcę skomplikowanych narzędzi do budowania, męczącej konfiguracji dokumentacji ani złożonych struktur. Za każdym razem, gdy widzę pliki konfiguracyjne i struktury projektów takich narzędzi jak Docusaurus, VuePress czy Astro, boli mnie głowa. Teraz ZEN ukrywa całą konfigurację w katalogu `.zen`, zamiatając ją w kąt. Użytkownik musi skupić się tylko na treści, resztą zajmie się ZEN. Wszystkie inne katalogi to Twoja przestrzeń do pisania – możesz dowolnie organizować swoje pliki Markdown.
|
|
34
|
+
|
|
35
|
+
- **Powrót do języka ojczystego: Pisz w języku ojczystym, płynnie twórz wersje wielojęzyczne**
|
|
36
|
+
|
|
37
|
+
Życie jest krótkie, nie mam ochoty na tłumaczenie. Człowiek myśli najgłębiej, gdy używa języka ojczystego. Jednocześnie konieczne jest utrzymanie połączenia ze światem – nie chcę rezygnować z komunikacji wielojęzycznej. Dlatego chcę narzędzia, które pozwoli mi pisać w języku ojczystym, a jednocześnie udostępnić moje treści szerszemu gronu. Obecne rozwiązania i18n wymagają nie tylko własnego tłumaczenia, ale także samodzielnego utrzymywania aktualności treści – to zbyt uciążliwe. Wybieram wykorzystanie LLM do tłumaczenia, co oszczędza mi mnóstwo czasu i pozwala na jednym kliknięciu uzyskać tłumaczenia na wiele języków.
|
|
38
|
+
|
|
39
|
+
## Szybki start
|
|
40
|
+
|
|
41
|
+
Wymagania wstępne:
|
|
42
|
+
|
|
43
|
+
- Zainstalowany [Node.js](https://nodejs.org/) (zalecana wersja 18 lub nowsza, wymagane polecenie `npx`)
|
|
44
|
+
- Uzyskany [klucz API OpenAI](https://platform.openai.com/account/api-keys) lub kompatybilny klucz API OPENAI
|
|
45
|
+
- Zainstalowany Git (do listowania plików Markdown z gita, z pominięciem plików filtrowanych przez reguły `.gitignore`)
|
|
46
|
+
|
|
47
|
+
Najpierw pracuj w folderze już zarządzanym przez gita:
|
|
48
|
+
|
|
49
|
+
Skonfiguruj zmienne środowiskowe
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Wymagane: zastąp swoim kluczem API OpenAI
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Opcjonalne, domyślnie używa oficjalnego API OpenAI
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Opcjonalne, domyślnie używa modelu gpt-3.5-turbo
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Zbuduj stronę z obsługą tłumaczenia wielojęzycznego. Użyj bieżącego katalogu jako źródła, wynik zostanie zapisany w katalogu `.zen/dist`.
|
|
58
|
+
|
|
59
|
+
- Możesz wielokrotnie użyć parametru `--lang`, aby określić wersje językowe do wygenerowania (np. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Nie trzeba konfigurować języka źródłowego, ZEN wykryje go automatycznie.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Zobacz więcej parametrów lub pomoc**:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
npx zengen@latest
|
|
70
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
'title': 'ZEN - Minimalistyczny generator statycznych stron Markdown + AI'
|
|
3
|
+
'summary': 'ZEN to generator statycznych stron z funkcjami AI, zaprojektowany specjalnie dla dokumentów Markdown. Umożliwia użytkownikom przekształcenie folderu Git zawierającego pliki Markdown w statyczną stronę HTML bez skomplikowanej konfiguracji — wszystkie ustawienia są ukryte w katalogu .zen. Kluczowe funkcje obejmują inteligentną nawigację kategorii (używającą AI do analizy treści i generowania mapy strony), automatyczne tłumaczenie przyrostowe (obsługa wersji wielojęzycznych, użytkownicy mogą pisać w języku ojczystym, a AI zajmuje się tłumaczeniem) oraz doświadczenie pisania z minimalnymi zakłóceniami. Przewodnik szybkiego startu wymaga zainstalowania Node.js, uzyskania klucza API OpenAI i Gita, budowania strony za pomocą wiersza poleceń oraz obsługi określania języka i podstawowego adresu URL.'
|
|
4
|
+
'tags':
|
|
5
|
+
- 'Generator statycznych stron'
|
|
6
|
+
- 'Markdown'
|
|
7
|
+
- 'AI'
|
|
8
|
+
- 'Tłumaczenie wielojęzyczne'
|
|
9
|
+
- 'Minimalizm'
|
|
10
|
+
- 'Narzędzie do dokumentacji'
|
|
11
|
+
- 'Git'
|
|
12
|
+
'inferred_lang': 'zh-Hans'
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# ZEN - Minimalistyczny generator statycznych stron Markdown + AI
|
|
16
|
+
|
|
17
|
+
[> Demo strony internetowej](https://zen.zccz14.com/)
|
|
18
|
+
|
|
19
|
+
## Podstawowe funkcje
|
|
20
|
+
|
|
21
|
+
1. 📃 **Generowanie statycznych stron**: Przekształć dowolny folder git zawierający pliki Markdown w statyczną stronę HTML.
|
|
22
|
+
2. 🧭 **Inteligentna nawigacja kategorii**: Użyj AI do analizy treści, generowania mapy strony i nawigacji, bez wrażliwości na lokalizację plików źródłowych.
|
|
23
|
+
3. 🌍 **Automatyczne tłumaczenie przyrostowe**: Użyj AI do tłumaczenia przyrostowego, pozwalając użytkownikom pisać w Markdown w języku ojczystym, jednocześnie umożliwiając im tworzenie treści wielojęzycznych.
|
|
24
|
+
|
|
25
|
+
Dlaczego stworzyłem kolejny generator statycznych stron dla Markdown? Ponownie przemyślałem, jak narzędzia do dokumentacji mogą lepiej służyć pisarzom w erze AI:
|
|
26
|
+
|
|
27
|
+
- **Powrót do treści: Minimalizacja zakłóceń, skupienie na pisaniu**
|
|
28
|
+
|
|
29
|
+
Niech dokumenty wrócą do swojej istoty, a pisanie do spokoju.
|
|
30
|
+
|
|
31
|
+
Po pierwsze, nie chcę być bibliotekarzem. Czasami chcę coś napisać, ale może jeszcze nie wymyśliłem tytułu ani nie ukształtowałem struktury. Chcę, aby LLM automatycznie generował dla mnie tytuły, tworzył streszczenia, kategoryzował, organizował nawigację i inne prace porządkowe.
|
|
32
|
+
|
|
33
|
+
Po drugie, mój gabinet musi być posprzątany. Nie chcę skomplikowanych narzędzi do budowania, męczącej konfiguracji dokumentacji ani złożonych struktur. Za każdym razem, gdy widzę pliki konfiguracyjne i struktury projektów takich narzędzi jak Docusaurus, VuePress czy Astro, boli mnie głowa. Teraz ZEN ukrywa całą konfigurację w katalogu `.zen`, zamiatając ją w kąt. Użytkownik musi skupić się tylko na treści, resztą zajmie się ZEN. Wszystkie inne katalogi to Twoja przestrzeń do pisania — możesz dowolnie organizować swoje pliki Markdown.
|
|
34
|
+
|
|
35
|
+
- **Powrót do języka ojczystego: Pisz w języku ojczystym, płynnie twórz wersje wielojęzyczne**
|
|
36
|
+
|
|
37
|
+
Życie jest krótkie, nie mam ochoty na tłumaczenie. Człowiek myśli najgłębiej, gdy używa języka ojczystego. Jednocześnie konieczne jest utrzymanie kontaktu ze światem — nie chcę rezygnować z komunikacji wielojęzykowej. Dlatego chcę narzędzia, które pozwoli mi pisać w języku ojczystym, a jednocześnie dotrzeć z treścią do większej liczby osób. Obecne rozwiązania i18n wymagają samodzielnego tłumaczenia i utrzymywania aktualności treści, co jest zbyt uciążliwe. Wybieram użycie LLM do pomocy w tłumaczeniu, oszczędzając mnóstwo czasu i umożliwiając tłumaczenie na wiele języków jednym kliknięciem.
|
|
38
|
+
|
|
39
|
+
## Szybki start
|
|
40
|
+
|
|
41
|
+
Wymagania wstępne:
|
|
42
|
+
|
|
43
|
+
- Zainstalowany [Node.js](https://nodejs.org/) (zalecana wersja 18 lub nowsza, wymagane polecenie `npx`)
|
|
44
|
+
- Uzyskany [klucz API OpenAI](https://platform.openai.com/account/api-keys) lub kompatybilny klucz API OPENAI
|
|
45
|
+
- Zainstalowany Git (do listowania plików Markdown z Gita, z pominięciem plików filtrowanych przez reguły `.gitignore`)
|
|
46
|
+
|
|
47
|
+
Najpierw pracuj w folderze zarządzanym przez gita:
|
|
48
|
+
|
|
49
|
+
Skonfiguruj zmienne środowiskowe
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
export OPENAI_API_KEY="sk-xxxxxx" # Wymagane: zastąp swoim kluczem API OpenAI
|
|
53
|
+
export OPENAI_BASE_URL="https://api.openai.com/v1" # Opcjonalne, domyślnie używa oficjalnego API OpenAI
|
|
54
|
+
export OPENAI_MODEL="gpt-3.5-turbo" # Opcjonalne, domyślnie używa modelu gpt-3.5-turbo
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Zbuduj stronę, obsługującą tłumaczenie wielojęzyczne. Użyj bieżącego katalogu jako katalogu źródłowego, wynik zostanie zapisany w katalogu `.zen/dist`.
|
|
58
|
+
|
|
59
|
+
- Możesz wielokrotnie użyć parametru `--lang`, aby określić wersje językowe do wygenerowania (np. `--lang zh-Hans --lang en-US`).
|
|
60
|
+
- Możesz użyć parametru `--base-url`, aby określić podstawowy prefiks URL strony (np. nazwa repozytorium na GitHub Pages).
|
|
61
|
+
- Nie ma potrzeby konfigurowania języka źródłowego, ZEN wykryje go automatycznie.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx zengen@latest build --lang zh-Hans --lang en-US
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
**Zobacz więcej parametrów lub uzyskaj pomoc**:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
npx zengen@latest
|
|
71
|
+
```
|