ONEPAGE

概述

一个简单的静态站点生成器，将 md 文章转换为 html。

• 读取 markdown 文件
• 通过 pulldown cmark 将 md 解析为 html
• 使用 tera 模板 渲染
• 由 picocss 和 highlightjs 样式化

在线演示

我的博客

用法

从仓库

• 克隆此仓库，然后
• cargo run -- build 来构建页面
• cargo run -- serve 来构建页面，并在本地主机上创建服务器

从 cargo

• cargo安装 onepage
• onepage init [dir] : 从 GitHub 下载模板文件
• onepage serve
• onepage build
• onepage new {filename}: 创建新文章

结构

• /pages: markdown 源文件
  • index.md => 首页
  • /posts/*.md => 文章页
  • /image markdown 文件中使用的图片
• /dist: 生成的站点
• /static: 静态资源
  • /assets: img/css/font
  • /favicon favicon 文件
• /templates: html 模板
• /src: rust 源代码

新建文章

• 在 /pages/posts/ 中创建一个 .md 文件
• 您可以复制示例 md 文件
• 目前，文章页 必须 包含一个 frontmatter 头部，包括 title(必需),date(必需),tags(可选)
• 或者您可以使用 onepage new {filename} 命令来创建新的帖子。

---
title: hello world
date: 2020-03-15 10:54:39
---

---
title: hello world
date: 2020-03-15 10:54:39
tags:
  - awesome-tag
  - more-awesome-tag
---

待办事项

• 自定义站点配置文件（可能不需要）
• 生成新页面
• 实时刷新
• 将站点初始化到新路径
• CSS样式
• 添加命令行
• 提供/dist服务
• 监视/pages并重建

参考

• 构建自己的静态站点生成器
• 用100行Rust代码构建静态站点生成器
• mdblog