Skip to content

README.ar.md

Latest commit

 

History

History
95 lines (75 loc) · 3.34 KB

README.ar.md

File metadata and controls

95 lines (75 loc) · 3.34 KB

docker-gitbook-builder

🇨🇳 中文 · 🇬🇧 English · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇪🇸 Español · 🇮🇳 हिन्दी · 🇸🇦 العربية
🇵🇹 Português · 🇧🇩 বাংলা · 🇷🇺 Русский · 🇫🇷 Français · 🇩🇪 Deutsch

صورة Docker لبناء كتب GitBook الإلكترونية، مع Honkit (نسخة المجتمع)، وخطوط CJK، ودعم PlantUML.

Docker Image

بدء سريع

docker pull bloodstar/gitbook-builder

# تهيئة
docker run --rm -v "$PWD:/gitbook" -p 4000:4000 bloodstar/gitbook-builder gitbook init
# معاينة
docker run --rm -v "$PWD:/gitbook" -p 4000:4000 bloodstar/gitbook-builder gitbook serve
# بناء
docker run --rm -v "$PWD:/gitbook" -p 4000:4000 bloodstar/gitbook-builder gitbook build

أضف اختصارات إلى .bashrc أو .zshrc:

alias gitbook='docker run --rm -v "$PWD":/gitbook -p 4000:4000 bloodstar/gitbook-builder gitbook'
alias honkit='docker run --rm -v "$PWD":/gitbook -p 4000:4000 bloodstar/gitbook-builder honkit'

الميزات

الميزة الوصف
GitBook CLI الإصدار الكلاسيكي، محدث لـ Node.js 20
Honkit نسخة المجتمع، متوافقة مع book.json
PlantUML رسومات بيانية بـ OpenJDK 17 + Graphviz
PDF/EPUB تحويل الكتب بـ Calibre
خطوط CJK Noto Sans CJK مدمجة
متعدد المعماريات linux/amd64, linux/arm/v7, linux/arm64

الاستخدام

# GitBook
gitbook serve    # http://localhost:4000
gitbook build
gitbook pdf .
gitbook epub .

# Honkit (موصى به)
honkit serve
honkit build
honkit pdf .
honkit epub .

Docker Hub

  • الصورة: bloodstar/gitbook-builder
  • الوسوم: latest, gitbook-<version>, honkit-<major>, honkit-<major>.<minor>, honkit-<full>
  • عرض الوسوم

متغيرات البيئة

المتغير الافتراضي الوصف
NPM_CONFIG_REGISTRY (npm الرسمي) مرآة npm. للمستخدمين الصينيين: https://registry.npmmirror.com 
docker run --rm -v "$PWD":/gitbook \
  -e NPM_CONFIG_REGISTRY=https://registry.npmmirror.com \
  bloodstar/gitbook-builder honkit install

المستندات

المستند المحتوى
docs/GUIDE.md الاستخدام التفصيلي والإضافات
docs/ARCHITECTURE.md المعمارية والمكونات
docs/TESTING.md الاختبار والتحقق
docs/CHANGELOG.md سجل الإصدارات