示例文章标题
这是一篇示例文章,展示如何使用自定义工具生成静态页面。通过这个工具,你可以将 Markdown 文件转换为美观的电子文集网页。
功能特点
- 简单易用:只需编写 Markdown,执行脚本即可生成静态页面
- 美观大方:响应式设计,适配不同设备
- 代码高亮:支持多种编程语言的代码高亮
- 目录结构:自动生成文章列表
技术实现
核心技术
- Node.js:处理文件操作和 Markdown 解析
- marked:Markdown 解析库
- highlight.js:代码高亮
- fs-extra:增强的文件操作
构建流程
- 读取 content 目录下的 Markdown 文件
- 解析 Markdown 内容和元数据
- 生成静态 HTML 页面
- 复制样式文件到输出目录
// 示例代码
function generateStaticPages(articles, outputDir) {
// 确保输出目录存在
fs.ensureDirSync(outputDir);
// 生成首页
const indexHtml = generateIndexPage(articles);
fs.writeFileSync(path.join(outputDir, 'index.html'), indexHtml);
// 生成文章页面
articles.forEach(article => {
const articleHtml = generateArticlePage(article);
const outputPath = path.join(outputDir, article.relativePath.replace('.md', '.html'));
fs.ensureDirSync(path.dirname(outputPath));
fs.writeFileSync(outputPath, articleHtml);
});
}
如何使用
- 安装依赖:
npm install - 添加文章:在 content 目录下创建 Markdown 文件
- 构建页面:
npm run build - 预览效果:
npm run dev
提示:你可以在 Markdown 文件的顶部添加元数据,如标题、日期等。
后续扩展
- 添加搜索功能
- 支持标签和分类
- 实现深色模式
- 添加阅读进度条
- 集成评论系统
希望这个工具能帮助你轻松创建自己的电子文集!