Halo Java轻量博客主题开发准备和目录清单（Halo主题开发准备）

Halo 是一款以Java开发的轻量博客系统程序。我们有一些玩转Java的朋友可能会选择使用，对于我们大部分个人建站的朋友可能较多的还是用PHP+MYSQL的比较多。老蒋在前面也有介绍到 "几款值得安装的Halo博客主题推荐" ，如果我们有自己开发或者仿主题移植到Halo，也是可以做的，这里简单的把 Halo主题开发准备和对应目录介绍一下。

第一、搭建博客环境

我们可以在本地或者服务器端搭建Halo安装环境。具体的我们可以参考 "利用宝塔面板Docker快速安装Halo轻量博客程序"。我们也可以在本地部署。

第二、新建主题

我们这里有可以看到主题的目录。

~/halo-dev/templates/themes 

我们在该目录下创建自己的目录。

使用我们熟悉的编辑器打开你所新建的主题目录，这里推荐使用 Visual Studio Code，并安装 Freemarker 扩展。

主题目录下必须存在 theme.yaml（主题描述文件），settings.yaml（主题配置文件），如果要开源到 Github 我们建议将仓库名设置为 halo-theme-主题名，并设置仓库的 topic 为 halo 和 halo-theme，这样可以方便使用者搜索。所有模板文件的后缀为 .ftl。主题目录需要以 screenshot.png 命名的预览图片，以供后台展示。

第三、主题的目录文件

这里我们可以参考主推的官方目录，然后对应创建名称。

├── module                      // 公共模板目录
│   ├── comment.ftl             // 比如：评论模板
│   ├── layout.ftl              // 比如：布局模板
├── source                      // 静态资源目录
│   ├── css                     // 样式目录
│   ├── images                  // 图片目录
│   ├── js                      // JS 脚本目录
│   └── plugins                 // 前端库目录
├── index.ftl                   // 首页
├── post.ftl                    // 文章页
├── post_xxx.ftl                    // 自定义文章模板，如：post_diary.ftl。可在后台发布文章时选择。
├── sheet.ftl                   // 自定义页面
├── sheet_xxx.ftl               // 自定义模板，如：sheet_search.ftl、sheet_author.ftl。可在后台发布页面时选择。
├── archives.ftl                // 归档页
├── categories.ftl              // 分类目录页
├── category.ftl                // 单个分类的所属文章页
├── tags.ftl                    // 标签页面
├── tag.ftl                     // 单个标签的所属文章页
├── search.ftl                  // 搜索结果页
├── links.ftl                   // 内置页面：友情链接
├── photos.ftl                  // 内置页面：图库
├── journals.ftl                // 内置页面：日志
├── 404.ftl                     // 404 页
├── 500.ftl                     // 500 页
├── README.md                   // README，一般用于主题介绍或说明
├── screenshot.png              // 主题预览图
├── settings.yaml               // 主题选项配置文件
└── theme.yaml                  // 主题描述文件

依照此目录，我们可以对主题进行移植的时候对应文件名不能错，这是系统需要识别的。

本文出处：老蒋部落 » Halo Java轻量博客主题开发准备和目录清单（Halo主题开发准备） | 欢迎分享（ 公众号：老蒋朋友圈 ）