Hilfskripte zum Extrakt aus dem Produktprogramm erstellt. Kernkonzepte in README.md und doc
This commit is contained in:
@@ -12,8 +12,17 @@ Das Zielsystem besteht aus zwei Repos:
|
||||
- **projekt-kunde-xyz** (pro Anlage): `anlage.json` (ERP-Export), projektspezifische Bilder, Overrides, `conf.py`, `build.py`. Bindet das Base-Repo per Symlink/Mount ein.
|
||||
|
||||
### Technologie-Stack
|
||||
| Komponente | Technologie |
|
||||
|------------------|--------------------------------------------------|
|
||||
| Build-System | Sphinx (Python) |
|
||||
| Textformat | reStructuredText (rST) |
|
||||
| Templating | Jinja2 (Rahmenkapitel, Titelseite) |
|
||||
| PDF-Erzeugung | LaTeX (pdflatex/lualatex) |
|
||||
| Versionierung | Git (Gitea auf Hetzner) |
|
||||
| Konfiguration | JSON (ERP-Export) + YAML (Modul-Metadaten) |
|
||||
| CI/Automatisierung | Gitea Actions oder n8n |
|
||||
| Bildkonvertierung | ezdxf → SVG, Pillow (Optimierung) |
|
||||
|
||||
Sphinx + reStructuredText + Jinja2-Templating → LaTeX → PDF. Konfiguration via JSON (ERP-Export) + YAML (Modul-Metadaten). Bildkonvertierung: ezdxf → SVG, Pillow.
|
||||
|
||||
### Build-Pipeline (zu implementieren)
|
||||
|
||||
@@ -23,6 +32,7 @@ anlage.json → build.py → Versionscheck → Abhängigkeiten auflösen (meta.y
|
||||
→ pdflatex → PDF pro Sprache
|
||||
```
|
||||
|
||||
|
||||
## Projektstruktur
|
||||
|
||||
```text
|
||||
@@ -64,6 +74,34 @@ docu_build/
|
||||
└── results/ # Build-Ausgaben (nicht im Git)
|
||||
```
|
||||
|
||||
Ein Kundenprojekt enthält nur noch die Verweise auf die verbauten Teile, overrides und additionals, also das Überschreiben von vorhandenen Texten oder Ergänzungen
|
||||
|
||||
```
|
||||
projekt-kunde-xyz-2026/
|
||||
├── conf.py # Importiert conf_base.py vom Base-Repo
|
||||
├── anlage.json # ERP-Export: Maschinenauswahl + Metadaten
|
||||
├── build.py # Hauptbuild-Skript
|
||||
├── Makefile
|
||||
├── README.md
|
||||
├── images/ # Projektspezifische Bilder
|
||||
│ ├── aufstellplan_halle3.pdf
|
||||
│ ├── foto_abnahme_01.jpg
|
||||
│ └── kundenlogo.pdf
|
||||
├── overrides/ # Projektspezifische Überschreibungen
|
||||
│ ├── modules/
|
||||
│ │ └── weiche_typ_a/
|
||||
│ │ └── beschreibung.de.rst # Überschreibt Basis wenn vorhanden
|
||||
│ └── chapters/
|
||||
│ └── 01_einleitung/
|
||||
│ └── template.de.rst # Kundenspezifische Einleitung
|
||||
├── additional/ # Kapitel die NUR dieses Projekt hat
|
||||
│ ├── sonderausfuehrung_xyz.de.rst
|
||||
│ └── sonderausfuehrung_xyz.en.rst
|
||||
└── transport-docs-base/ ──────────── # Symlink/Mount zum Base-Repo (Share)
|
||||
```
|
||||
|
||||
Details zur Konfiguration und Aufbau einer Doku siehe `doc/Kernkonzepte.md`.
|
||||
|
||||
### Kapitelstruktur
|
||||
|
||||
| Kapitel | Inhalt |
|
||||
|
||||
Reference in New Issue
Block a user