How yuebo119/flint works
Flint is a Hugo-compatible static-site generator. The main workflow starts with a user invoking the CLI to build a site: configuration and content are loaded, content is parsed, templates render pages, and the builder writes generated output. The repository also provides a development server, module management, deployment commands, and a Go-template theme migration toolchain. The graph follows documented or indexed relationships; some subsystems, especially migration internals and asset processing, are only partially represented because their implementation files were not supplied in the tree or excerpts.
Main entry points: SiteBuilder.cs Site build orchestrator · Program.cs Flint CLI · ServeHandler.cs Serve command · ContentParser.cs Content parser
Components 21
CLI workflows
- Flint CLI
src/Flint.Cli/Program.cs - Build command
src/Flint.Cli/Handlers/BuildHandler.cs - Deploy command
src/Flint.Cli/Handlers/DeployHandler.cs - Serve command
src/Flint.Cli/Handlers/ServeHandler.cs
Site generation
- Configuration loader
src/Flint.Core/Configuration/ConfigLoader.cs - Site build orchestrator
src/Flint.Core/Site/SiteBuilder.cs - Generated site
src/Flint.Core/Site/SiteBuilder.cs
Content and templates
- Content parser
src/Flint.Core/Content/ContentParser.cs - Front matter
src/Flint.Core/Content/FrontMatterParser.cs - Markdown renderer
src/Flint.Core/Content/MarkdownParser.cs - Shortcode processor
src/Flint.Core/Content/Shortcodes/ShortcodeProcessor.cs - Render hooks
src/Flint.Core/Content/RenderHooks.cs - Scriban renderer
src/Flint.Core/Templates/ScribanTemplateRenderer.cs
Development serving
- Development server
src/Flint.Core/Server/DevServer.cs
Themes and modules
- Module commands
src/Flint.Cli/Handlers/ModHandler.cs - Module manager
src/Flint.Core/Modules/ModuleManager.cs - Go template parser
src/Flint.ThemeMigrator/Parsing/GoTemplateParser.cs - Scriban converter
src/Flint.ThemeMigrator/Conversion/ScribanConverter.cs - Migration validation
src/Flint.ThemeMigrator/Validation/Gates.cs
Other components
- Site author
- Deployment target
Connections 23
- Site author → Flint CLI: runs commands
src/Flint.Cli/Program.cs - Flint CLI → Build command: dispatches build
src/Flint.Cli/Program.cs - Flint CLI → Serve command: dispatches serve
src/Flint.Cli/Program.cs - Flint CLI → Deploy command: dispatches deploy
src/Flint.Cli/Program.cs - Flint CLI → Module commands: dispatches modules
src/Flint.Cli/Program.cs - Build command → Configuration loader: loads settings
src/Flint.Cli/Handlers/BuildHandler.cs - Build command → Site build orchestrator: starts build
src/Flint.Cli/Handlers/BuildHandler.cs - Site build orchestrator → Configuration loader: loads configuration
src/Flint.Core/Site/SiteBuilder.cs - Site build orchestrator → Content parser: parses content
src/Flint.Core/Site/SiteBuilder.cs - Content parser → Front matter: reads metadata
src/Flint.Core/Content/ContentParser.cs - Content parser → Markdown renderer: renders Markdown
src/Flint.Core/Content/ContentParser.cs - Content parser → Shortcode processor: processes shortcodes
src/Flint.Core/Content/ContentParser.cs - Markdown renderer → Render hooks: uses render hooks
src/Flint.Core/Content/MarkdownParser.cs - Render hooks → Scriban renderer: renders hook templates
src/Flint.Core/Content/RenderHooks.cs - Site build orchestrator → Scriban renderer: renders pages
src/Flint.Core/Site/SiteBuilder.cs - Site build orchestrator → Generated site: writes site
src/Flint.Core/Site/SiteBuilder.cs - Serve command → Configuration loader: loads settings
src/Flint.Cli/Handlers/ServeHandler.cs - Serve command → Site build orchestrator: builds site
src/Flint.Cli/Handlers/ServeHandler.cs - Serve command → Development server: starts server
src/Flint.Cli/Handlers/ServeHandler.cs - Module commands → Module manager: manages modules
src/Flint.Cli/Handlers/ModHandler.cs - Go template parser → Scriban converter: converts syntax
- Scriban converter → Migration validation: validates migration
- Deploy command → Deployment target: deploys output
README.md