Eastwind Blogger

一个使用全缓存实现的相当简单却高效的静态博客服务器程序。

配置和部署

示例配置

yaml public: home_post: welcome site: hostname: "127.0.0.1:5000" enable_https: false site_name: 那阵东风 site_email: zhongdongy@dongs.xyz site_slogan: '由 Eastwind Blogger 驱动' gravatar_proxy: https://127.0.0.1/gavatar/ baidu_site_verification: "" # 百度站长平台的 HTML 标签验证码方法 beian: enabled: true icp_id: 粤ICP备XXX号-1 beian_id: 粤公安网备XXX号

撰写文章

您可以使用 Markdown 和 LaTeX（使用 MathJax 进行渲染）撰写博文。为了提供标签分类等丰富的博文索引服务，您还可以在每篇博文的报头增加一段元数据：

```yaml

title: 沁园春·雪 author: 毛泽东 authoravatar: https://xxxxx/ authoremail: "mzd@example.com" description: "" keywords: - 诗词 createdat: "1936-02-01" updatedat: "1936-02-01" tags: - 毛泽东诗词 permanentlink: rendererparams: - enable-toc - content-serif - content-justify

redirect: "/post/abc/"

```

这段元数据遵循 YAML 语法，其中： - title 对应了文章的标题 - author 指博文的作者 - author_avatar（可选）是用户头像的 URL - author_email（可选）指博文作者的邮箱，用于获取 GRAVATAR 图像 - description（可选）简单的博文描述信息 - keywords（可选）博文的关键字 - created_at（可选）指博文创作的时间，如“YYYY-mm-dd” - updated_at（可选）指博文修改的时间，如“YYYY-mm-dd” - tags （可选）指博文的标签，您可以为同一篇博文提供任意数量的标签 - permanent_link（可选）是您手动指定的固定访问链接，没有指定则不会生成 - renderer_params（可选）是渲染博文时的指令参数，您可以使用： - enable-toc：显示文章索引目录 TOC - content-serif：使用衬线字体 (Noto Serif SC) 渲染博文内容 - content-justify：让文字两端对齐 - filter-grayscale：整个页面都将被渲染为黑白灰阶模式 - redirect （可选）可以给出一个地址（需要包含起始的/），页面加载后会自动重定向到给定页面

注意：

为了丰富读者的阅读体验，您可以使用 Markdown 扩展语法中的脚注来实现。

开发

如果您在中国大陆扩展开发，建议您打包时使用 Cargo 的镜像以加速访问：

bash docker build -t test:latest --build-arg enable_cargo_mirror=1 --progress=plain .

如果修改了 Sass 样式表，可以通过此命令重新生成 CSS 样式表:

bash sass --watch --update --source-map static/css:static/css sass --no-source-map static/css:static/css