Skip to content

README.es.md

Latest commit

 

History

History
95 lines (75 loc) · 3.1 KB

README.es.md

File metadata and controls

95 lines (75 loc) · 3.1 KB
Raw

docker-gitbook-builder

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

Imagen Docker para crear libros electrónicos GitBook, con Honkit (fork comunitario), fuentes CJK y soporte PlantUML.

Docker Image

Inicio rápido

docker pull bloodstar/gitbook-builder

# iniciar
docker run --rm -v "$PWD:/gitbook" -p 4000:4000 bloodstar/gitbook-builder gitbook init
# previsualizar
docker run --rm -v "$PWD:/gitbook" -p 4000:4000 bloodstar/gitbook-builder gitbook serve
# construir
docker run --rm -v "$PWD:/gitbook" -p 4000:4000 bloodstar/gitbook-builder gitbook build

Añade alias a .bashrc o .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'

Funciones

Función Descripción
GitBook CLI Versión clásica, parcheada para Node.js 20
Honkit Fork comunitario, compatible con book.json
PlantUML Diagramas con OpenJDK 17 + Graphviz
PDF/EPUB Conversión con Calibre
Fuentes CJK Noto Sans CJK para chino, japonés, coreano
Multi-arquitectura linux/amd64, linux/arm/v7, linux/arm64

Uso

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

# Honkit (recomendado)
honkit serve
honkit build
honkit pdf .
honkit epub .

Docker Hub

  • Imagen: bloodstar/gitbook-builder
  • Etiquetas: latest, gitbook-<version>, honkit-<major>, honkit-<major>.<minor>, honkit-<full>
  • Ver etiquetas

Variables de entorno

Variable Defecto Descripción
NPM_CONFIG_REGISTRY (oficial npm) Espejo npm. Usuarios chinos: https://registry.npmmirror.com 
docker run --rm -v "$PWD":/gitbook \
  -e NPM_CONFIG_REGISTRY=https://registry.npmmirror.com \
  bloodstar/gitbook-builder honkit install

Documentos

Documento Contenido
docs/GUIDE.md Uso detallado y plugins
docs/ARCHITECTURE.md Arquitectura y componentes
docs/TESTING.md Pruebas y verificación
docs/CHANGELOG.md Historial de versiones