egh0bww1 — include-yy’s blog

Welcome to include-yy’s blog source.

本博客使用了 Emacs 的 org-mode 导出功能，将 Org 文件导出为 HTML 文件。虽然 Github 支持 Org 文件渲染，前往网页也许能够获取更好的阅读体验。

https://egh0bww1.com — Home :: include-yy

如何构建本博客

请确保 git 已安装并可在 Emacs 内使用，然后执行以下步骤：

请使用以下命令安装 ox-w3ctr 和 yynt：

M-x package-vc-install https://github.com/include-yy/ox-w3ctr RET
M-x package-vc-install https://github.com/include-yy/yynt     RET

1. 打开 yy.el，在 buffer 中通过 C-c C-e (elisp-eval-region-or-buffer) 对整个 buffer 求值
2. 执行命令 M-x yynt-export-build 并在弹出的 minibuffer 中选择 *t* 来构建整个博客
3. （可选）执行命令 M-x yynt-publish-build 并在弹出的 minibuffer 中选择 *t* 来发布整个博客到 blog-build 目录

在执行第 2 步后可在与 org 源文件同位置看到生成的 HTML 文件，第 3 步是可选的，它会将生成的 HTML 和相关的资源复制到 blog-build 目录。

关于本博客

博客的目录结构

博客目录如下：

• assets/*/* 一些全局资源
• posts/*/* 发布的文章
• republish/*/* 一些转载的文章
• projecteuler/* 一些简单 projecteuler 题解
• index.org 博客主页 Org 源文件
• 404.org 404 页面源文件
• robots.txt Robots 文件
• tags.eld 包含所有 TAG 的数据文件
• yy.el 构建工具代码

Problems 1 to 100 provide a wealth of helpful introductory teaching material and if you are able to respect our requirements, then we give permission for those problems and their solutions to be discussed elsewhere.

https://projecteuler.net/about

博客的 posts 和 projecteuler 部分使用 CC-BY-SA 4.0。如果您有任何问题，欢迎通过 issue 与我交流。

文章的格式

一篇博客应该包含以下头信息：

• #+TITLE: name 文章的标题
• #+DATE: [YYYY-MM-DD HH:MM] 或 [YYYY-MM-DD HH:MM]--[YYYY-MM-DD HH:MM] ，表示文章的创建时间或创建时间加上完成时间
• #+FILETAGS: tags 文章的 TAG，当前只允许一个
• #+DESCRIPTION: ... 对文章内容的介绍，这部分用于生成 RSS 的 <description>

对于 republish 和 projecteuler 也是类似的头结构，不过一般我们不用手写，直接使用以下函数创建新的 post, repost 或 projecteuler ：

• yynt/yy-create-draft ，在 drafts 目录交互式创建新的 posts 草稿
• yynt/yy-create-repost ，在 republish 目录交互式创建新的 repost 项目
• yynt/yy-create-euler ，在 projecteuler 目录交互式创建新的 euler 项目

TAG 管理

所以 posts 文章的 TAG 都存储在 /tags.eld 中，格式大致如下：

("math" "c" "win32" "lisp" "gossip" "git" "emacs" "elisp" "blog" "rescript" "tr" "orgmode")

通过 yynt/yy--post-read-tags 和 yynt/yy--post-write-tags 我们可以对这个文件中的 TAGS 进行读写，不过一般不需要使用这样低层的函数，而是以下这些，它们会提供用于选择 TAG 的 minibuffer：

• yynt/yy-post-add-tags 向 TAG 文件中添加新的 TAG
• yynt/yy-post-delete-tags 从 TAG 文件中删除某 TAG
• yynt/yy-post-insert-tag 在当前位置插入某个 TAG

一些参考资料

• orgcss ，一个不错的 Org CSS 主题
• org-static-blog，一个简单的 Org 静态网页生成工具
• org-modeで文字をエスケープする方法
  • 如何在 Org 文本中使用一些符号的转义序列（对 org-entities-help 的总结）