How katyono4ek/fukuoka-guide works
Fukuoka, softly is a bilingual, JSON-driven static travel guide. Editors add localized sections, place entries, and photo metadata; the build loads and validates that content, renders a complete page for each locale, and copies local assets into a static site for readers. In the browser, JavaScript enhances the pages with theme, language, filtering, and navigation behavior; the content remains readable without it. A separate photo tool fetches and crops Commons images, while a local-only server previews built output. Relationships for client-side behavior and some content capabilities are based on README documentation; unsampled asset internals are not inspected.
Main entry points: content.mjs Load and validate · build.mjs Static site builder · photo.mjs Photo fetch and crop · templates.mjs HTML rendering
Components 18
Guide content
- Site configuration
content/site.json - Guide sections
content/sections - Photo metadata
content/photos.json - Photo files
content/photos
Site generation
- Load and validate
src/content.mjs - Photo formats
src/photos.mjs - HTML rendering
src/templates.mjs - Static site builder
src/build.mjs
Reader experience
- Localized static pages
src/build.mjs - Theme toggle
src/assets/theme.js - Tag filters
src/assets/app.js - Language and page navigation
src/assets/gate.js - Page styling
src/assets/styles.css - Local preview server
src/serve.mjs
Photo authoring
- Photo fetch and crop
tools/photo.mjs
Other components
- Content editor
- Guide reader
- Wikimedia Commons
Connections 24
- Content editor → Site configuration: edits settings
README.md - Content editor → Guide sections: adds entries
README.md - Content editor → Photo metadata: writes alt text
README.md - Load and validate → Site configuration: loads
src/content.mjs - Load and validate → Guide sections: loads and validates
src/content.mjs - Load and validate → Photo metadata: loads and validates
src/content.mjs - Load and validate → Photo formats: checks photo files
src/content.mjs - Static site builder → Load and validate: loads content
src/build.mjs - Static site builder → HTML rendering: renders pages
src/build.mjs - Static site builder → Localized static pages: writes output
src/build.mjs - Static site builder → Photo files: copies photos
src/build.mjs - HTML rendering → Load and validate: uses translations
src/templates.mjs - HTML rendering → Photo formats: builds photo markup
src/templates.mjs - HTML rendering → Photo metadata: renders credits and alt text
README.md - Localized static pages → Guide reader: serves guide
README.md - Guide reader → Theme toggle: toggles theme
README.md - Guide reader → Tag filters: filters tags
README.md - Guide reader → Language and page navigation: switches language
README.md - Localized static pages → Page styling: loads styling
- Local preview server → Localized static pages: serves built output
src/serve.mjs - Photo fetch and crop → Wikimedia Commons: fetches image data
tools/photo.mjs - Photo fetch and crop → Photo files: writes cropped photos
tools/photo.mjs - Photo fetch and crop → Photo metadata: updates credits
tools/photo.mjs - Photo fetch and crop → Photo formats: uses dimensions
tools/photo.mjs