Halo主题蝴蝶：安装与配置指南

1. 项目目录结构及介绍

Halo博客主题——Butterfly 是基于Halo CMS的一个精美主题，其设计灵感源自Hexo社区的同名主题。以下是该主题的基本目录结构及其简介：

halo-theme-butterfly/
│
├───templates              # 主题模板文件夹，包括FreeMarker(.ftl)模板用于渲染网页。
│   ├── layouts            # 页面布局模板。
│   └── snippets           # 模板片段，如头部、底部等可复用部分。
│
├───assets                 # 主题资源文件夹，存放CSS、JS和其他静态资源。
│   ├── css                # 主题样式表文件。
│   ├── img                # 图像资源。
│   └── js                 # JavaScript脚本。
│
├───config.yml             # 主题配置文件，定义主题行为和外观。
│
├───README.md               # 项目说明文件。
└───...

• templates: 包含网站的布局和显示模板，FreeMarker语法让定制更加灵活。
• assets: 存放所有前端资源，包括主题的样式和脚本，用户可以根据需求添加或修改这些文件。
• config.yml: 关键配置文件，用户可以在这里调整主题设置，以匹配个人偏好或站点需求。

2. 项目的启动文件介绍

在Halo框架中，启动过程主要由Halo CMS自身管理，并非直接通过主题的特定文件启动。然而，对于开发和测试主题功能，你需要：

• Halo后台管理界面: 进入Halo管理控制台，上传并激活halo-theme-butterfly作为当前使用的主题。
• theme.yml 或 config.yml: 虽然这不是一个启动文件，但在激活主题后，对这个配置文件的任何更改都可能需要重启Halo服务来应用更改，尤其是在进行主题配置调整时。

3. 项目的配置文件介绍

config.yml

这是Butterfly主题的核心配置文件，它允许用户自定义多种功能和视觉效果。文件结构通常包含但不限于以下几个关键部分：

• metadata_name: 必须设置的主题元数据名称，确保与Halo用户配置中的用户名一致，以便正确应用主题。
• ** Reward**: 打赏配置，包括二维码图片路径和提示文本。
• Font Settings: 字体定制选项，允许用户指定主题所使用的字体。
• Background Image: 自定义背景图像的设置。
• Sidebar: 侧边栏的配置，是否启用以及其内容。
• Social Accounts: 社交媒体链接配置，提升交互性。
• Syntax Highlighting: 代码高亮的相关配置，包括行号、复制按钮等。
• Theme Mode: 支持深色和浅色模式切换的配置。
• Other Features: 如SEO优化、统计代码集成等高级功能配置。

使用示例：

# 示例配置片段
metadata_name: "你的用户名"
reward:
    enable: true
    title: "支持我"
    qr_code_path: "/path/to/your/qrcode.jpg"

font_settings:
    font_family: "Arial, sans-serif"

sidebar:
    enable: true
    items:
        - type: "recent_posts"
          title: "最近的文章"

请注意，实际配置项更详细，用户应根据项目最新的config.yml文件注释进行具体配置。务必参考仓库内的最新文档或配置示例进行详细设置。