我的电子文集

"示例文章"

示例文章标题

这是一篇示例文章,展示如何使用自定义工具生成静态页面。通过这个工具,你可以将 Markdown 文件转换为美观的电子文集网页。

功能特点

  • 简单易用:只需编写 Markdown,执行脚本即可生成静态页面
  • 美观大方:响应式设计,适配不同设备
  • 代码高亮:支持多种编程语言的代码高亮
  • 目录结构:自动生成文章列表

技术实现

核心技术

  • Node.js:处理文件操作和 Markdown 解析
  • marked:Markdown 解析库
  • highlight.js:代码高亮
  • fs-extra:增强的文件操作

构建流程

  1. 读取 content 目录下的 Markdown 文件
  2. 解析 Markdown 内容和元数据
  3. 生成静态 HTML 页面
  4. 复制样式文件到输出目录
// 示例代码
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);
  });
}

如何使用

  1. 安装依赖npm install
  2. 添加文章:在 content 目录下创建 Markdown 文件
  3. 构建页面npm run build
  4. 预览效果npm run dev

示例图片

提示:你可以在 Markdown 文件的顶部添加元数据,如标题、日期等。

后续扩展

  • 添加搜索功能
  • 支持标签和分类
  • 实现深色模式
  • 添加阅读进度条
  • 集成评论系统

希望这个工具能帮助你轻松创建自己的电子文集!