How ximpley/muchtrans works
Main System Components
a) Static Site Generator Component
• Input Processing: Show how articles in markdown format (*.md and *.ko.md) are processed
• Template Engine: Illustrate how templates (from /templates directory) are used
• Build System: Show the build process (build.py) that generates the static site
b) Development Server Component
• Dev.py server component that serves the site locally
c) Deployment Component
• Netlify integration for automated builds and hosting
Data Flow and Structure
• Content Flow: From source markdown files to generated HTML
• Build Process Flow: From build.py to _build directory
• Deployment Flow: From repository to Netlify
Specific Elements
• Blue rectangles: Source content (articles directory)
• Green rectangles: Templates (templates directory)
• Orange rectangles: Build system components
• Purple rectangles: Output (_build directory)
• Gray rectangles: External services (Netlify)
[Source Layer]
**Articles (*.md, *.ko.md) → Templates**
[Processing Layer]
Build System (build.py) → Development Server (dev.py)
[Output Layer]
Static Site (_build directory)
[Deployment Layer]
Netlify Hosting
Important Details to Highlight
• Bilingual Content Management: Show how original and translated content (*.md and *.ko.md) are paired
• Template Processing: Illustrate how templates (base.html, article.html, etc.) are applied
• Static Asset Management: Show how CSS and images are processed
• Feed Generation: Include the feed.xml generation process