主要观点:将README.org
导出为 HTML 的 Elisp 代码放在 Makefile 中可简化打包流程,无需额外的.el
文件供 lint 工具和编译器抱怨,该想法归功于 Jonas Bernoulli。
关键信息:
- 在项目根目录添加名为
Makefile
的文件,如hyperdrive.el Makefile
,其中定义了相关环境变量和导出 HTML 的命令。 README.html: README.org
表示依赖关系,通过$(BATCH)
命令进行转换。- 在
.builds/
子目录添加readme.yml
文件,如hyperdrive.el.builds/readme.yml
,指定构建脚本所需的信息,包括镜像、安装包、源和任务等,其中任务为在hyperdrive.el
目录中执行make README.html
和hut git update --readme README.html
。
重要细节: EMACS
为 Emacs 路径,EMACSQ
为不带 GUI 的 Emacs 路径,BATCH
定义了一系列 Emacs 命令参数用于处理README.org
并导出为 HTML。- 构建脚本可安装
hut
和emacs
,克隆仓库,导出README.html
并设置自定义 README。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。