Hexo 黑曜石（Obsidian）主题配置与使用指南

Hexo 黑曜石（Obsidian）主题配置与使用指南

hexo-theme-obsidian🎨 A dark Hexo theme, it's responsive, simple but elegant.项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-obsidian

本文将介绍如何安装和配置Hexo的Obsidian主题，以及该项目的目录结构和关键文件。

1. 项目目录结构及介绍

当你克隆hexo-theme-obsidian仓库后，你会得到以下基本目录结构：

.
├── CHANGELOG.md       // 更新日志
├── CHANGELOG_CN.md     // 中文更新日志
├── LICENSE             // 许可证文件
├── README.md           // 英文README
├── README_CN.md        // 中文README
├── _config_template_cn.yml  // 中文配置模板
├── _config_template_en.yml  // 英文配置模板
├── _config.yml         // 示例配置文件
├── package-lock.json   // npm锁定版本文件
├── package.json        // npm依赖包文件
└── source              // 主题源码
   ├── assets            // 资产文件
   ├── css               // CSS样式
   └── ...                // 其他资源

• source: 包含主题的所有源代码，包括HTML，CSS，JavaScript和其他资源。
• _config*.yml: 配置模板文件，用于帮助创建和理解_config.yml。
• _config.yml: 示例配置文件，用于指导用户如何修改默认设置。

2. 项目启动文件介绍

在Hexo环境中，启动文件通常是位于项目根目录下的hexo-server命令。然而，对于主题本身，启动文件并不在主题目录内，而是由主 Hexo 项目中的node_modules/.bin/hexo server命令触发。这个命令启动Hexo服务并应用所选主题（在这种情况下是Obsidian）。

要启动Hexo服务器，确保你在主Hexo项目目录内，并执行以下命令：

$ npm run dev

或者，如果你使用全局安装的Hexo CLI:

$ hexo server

这将构建你的站点并以开发模式运行，可以在浏览器中查看结果。

3. 项目的配置文件介绍

配置文件 _config.yml 是Hexo的核心，用于自定义站点行为和主题选项。以下是一些重要的配置项，对于Obsidian主题尤其重要：

# 主题配置
theme: obsidian

# 是否开启响应式设计
responsive: true

# 是否启用暗模式
darkmode: false

# 站点其他相关配置
...

要启用Obsidian主题，你需要在你的主Hexo项目_config.yml文件中设置theme字段为obsidian。然后可以按需调整响应式、暗模式以及其他相关设置。参考主题的README文件或提供的示例配置文件获取更多信息。

以上就是关于Hexo的Obsidian主题的基本安装和配置说明。根据你的个人需求，你可能还需要进一步探索和定制你的博客。祝你使用愉快！

hexo-theme-obsidian🎨 A dark Hexo theme, it's responsive, simple but elegant.项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-obsidian