Java Static Blog Converter

基于Java 8构建的强大而轻量级的静态网站生成器，专为从Markdown文件创建美观的博客和文档网站而设计。

🚀 项目概述

Java Static Blog Converter 是一个完全用Java编写的静态网站生成器，它可以将Markdown文件转换为美观的静态HTML网站。项目采用模块化设计，提供了完整的博客网站生成解决方案。

GitHub: https://github.com/geyuxu/java-static-blog-covert

🛠 技术栈

• Java 8: 核心开发语言
• FlexMark: Markdown解析和处理
• Jackson: YAML frontmatter解析
• JUnit & AssertJ: 单元测试
• Maven: 依赖管理和构建工具

✨ 核心功能特性

🎯 主要特性

• 快速轻量: 基于Java 8，性能优异
• 完整Markdown支持: 支持表格、代码块等扩展语法
• 灵活模板系统: 可自定义的HTML模板
• YAML Frontmatter: 支持页面元数据
• 自动资源处理: 自动处理CSS、JS、图片等静态资源
• 零配置: 开箱即用，无需复杂配置
• 响应式设计: 生成的网站支持移动端

📁 核心组件

src/main/java/
├── BlogConverter.java          # CLI入口点
├── StaticSiteGenerator.java    # 核心生成逻辑
├── MarkdownConverter.java      # Markdown处理
├── FrontmatterParser.java      # YAML元数据解析
├── TemplateEngine.java         # 模板引擎
└── AssetProcessor.java         # 静态资源处理

🏃‍♂️ 快速开始

环境要求

• Java 8+
• Maven 3.6+

安装使用

# 克隆项目
git clone https://github.com/geyuxu/java-static-blog-covert.git
cd java-static-blog-covert

# 编译项目
mvn clean compile

# 运行生成器
java -cp target/classes BlogConverter

基本用法

1. 将Markdown文件放在 content/ 目录下
2. 运行生成器
3. 生成的静态网站将在 output/ 目录中

📚 项目特色

模块化架构

项目采用清晰的模块化设计，每个组件都有明确的职责：

• 解析模块: 处理Markdown和YAML
• 模板模块: 管理HTML模板渲染
• 资源模块: 处理静态资源文件
• 生成模块: 协调整个生成流程

企业级代码质量

• 完整的单元测试覆盖
• 使用AssertJ进行流畅的断言
• 遵循Java最佳实践
• 清晰的代码结构和文档

🎨 应用场景

• 个人博客: 快速搭建技术博客
• 文档网站: 项目文档和API文档
• 企业官网: 静态企业展示网站
• 知识库: 团队知识管理系统

🔧 技术亮点

1. 纯Java实现: 无需额外运行时环境
2. 高度可扩展: 模块化设计便于功能扩展
3. 性能优异: 基于Java NIO的高效文件处理
4. 跨平台: 支持Windows、macOS、Linux

📈 项目价值

这个项目展示了如何用Java构建一个完整的静态网站生成器，涵盖了：

• 文件系统操作和模板处理
• Markdown解析和HTML生成
• 企业级Java应用架构设计
• 完整的测试驱动开发实践

通过这个项目，我深入理解了静态网站生成的核心原理，并在Java生态中实现了一个高质量的解决方案。