Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/means88/hexo-theme-type
https://github.com/means88/hexo-theme-type
Last synced: 15 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/means88/hexo-theme-type
- Owner: Means88
- License: mit
- Created: 2024-05-05T07:49:23.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-09-20T12:33:58.000Z (4 months ago)
- Last Synced: 2025-01-09T09:10:34.638Z (16 days ago)
- Language: JavaScript
- Size: 6.41 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Hexo Theme Type
一个漂亮、简洁的 HEXO 主题
[中文文档](https://tripper.press/type-readme/#💡-快速指南) [效果预览](https://tripper.press/) [实时预览](https://photup.github.io/type-live-preivew/)
- 提出 Issue 请到 [Issues · aiokr/Hexo-Theme-Type](https://github.com/aiokr/hexo-theme-type/issues)
- 了解最新进展请到 [[持续更新] Hexo-Theme-Type 最新进展 · Discussion #23 · aiokr/Hexo-Theme-Type](https://github.com/aiokr/hexo-theme-type/discussions/23)
- 参与讨论请到 [Discussions · aiokr/Hexo-Theme-Type](https://github.com/aiokr/hexo-theme-type/discussions/categories/general) 或 [QQ 频道](https://qun.qq.com/qqweb/qunpro/share?_wv=3&_wwv=128&appChannel=share&inviteCode=14OQfh&businessType=9&from=246610&biz=ka#/pc)
## 🔨 安装使用
本主题支持 npm 和 git 两种安装方式，你也可以下载 release 版本手动安装。
当前主题仍在开发中，部分功能还没有完善！
### 使用 npm 安装（推荐）
进入 Hexo 根目录，依次执行以下命令。
```bash
npm install hexo-theme-type --save
npm install
cp -v ./node_modules/hexo-theme-type/_config_template.yml ./_config.type.yml
```
随后，修改站点配置文件[^1]
```yaml
theme: type
```
### 使用 git 安装
进入 Hexo 根目录，依次执行以下命令。
```bash
git clone https://github.com/aiokr/hexo-theme-type.git themes/type --depth=1
npm install
```
随后，修改站点配置文件[^1]
```yaml
theme: type
```
## 📖 文档
本项目的文档正在逐步完善中，详情请阅读 [GitHub · Where software is built](https://github.com/aiokr/hexo-theme-type/wiki)
## 💡 快速指南
### 主题设定
[主题设定](https://tripper.press/type/theme_settings.html)
### 独立页面
本主题支持以下独立页面：
1. 文章样式：你可以创建一个外观和文章一样的独立页面。
2. 照片墙页面：一个照片墙页面。
3. 关于页面 β：一个独特的“关于我”页面，目前尚在测试阶段，随时可能发生变化。
4. 其他样式页面
#### 创建文章样式的独立页面
[效果预览](https://tripper.press/about-archieve/)
在 `source` 文件夹中添加一个文件夹，并在其中创建 'index.md' 文件，填入以下信息
```yaml
---
title: {{ 页面标题 }}
date: {{ 创建日期 }}
---
```
也可以执行以下代码：
```yaml
hexo new page '页面标题'
```
#### 创建照片墙页面
[效果预览](https://tripper.press/gallery/)
在 `source` 文件夹中添加一个文件夹，并在其中创建 `index.md` 文件，填入以下信息
```yaml
---
title: {{ 页面标题 }}
layout: gallery
---
```
并在 `source/_data` 文件夹中创建 `gallery.yml`，按以下模板填写内容：
```yaml
'{{项目标题}}':
date: {{拍摄日期：格式：YYYY-MM-DD，此项目可移除}}
cover: '{{项目封面，此项目可移除}}'
img:
- '{{图片链接1}}'
- '{{图片链接2}}'
```
#### 创建关于页面 β
[效果预览](https://tripper.press/about/)
在 `source` 文件夹中添加一个文件夹，并在其中创建 `index.md` 文件，填入以下信息
```yaml
---
title: {{ 页面标题 }}
layout: about_page
---
```
修改 `themes/hexo-themes-type/layout/about_page.ejs` 的内容
#### 创建其他样式页面
[效果预览](https://tripper.press/weatherwidget.html)
在 `source` 文件夹中添加一个文件，并在开头填入以下内容
```
---
layout: html
---
```
随后你可以在该文件夹中填入任意 HTML 代码
## 关于项目中的 Tailwind CSS
本主题部分样式采用 Tailwind CSS 构建，但您作为主题使用者，无需在 Hexo 项目中安装 Tainwind Cli，主题在上传的同时会自动生成 css 文件。
## 🗒 许可证
hexo-theme-type 还使用/依赖了这些开源项目
### HEXO 相关
**HEXO**
[hexojs/hexo: A fast, simple & powerful blog framework, powered by Node.js.](https://github.com/hexojs/hexo)
**License**: MIT
**hexo-renderer-ejs**
[hexojs/hexo-renderer-ejs: EJS renderer for Hexo](https://github.com/hexojs/hexo-renderer-ejs)
**License**: MIT
**hexo-renderer-marked**
[hexojs/hexo-renderer-marked: Markdown renderer for Hexo](https://github.com/hexojs/hexo-renderer-marked)
**License**: MIT
### 评论系统
**DisqusJS**
[SukkaW/DisqusJS: Render Disqus comments in Mainland China using Disqus API](https://github.com/SukkaW/DisqusJS)
**License**: MIT
**Valine**
[xCss/Valine: A fast, simple & powerful comment system.](https://github.com/xCss/Valine)
**License**: GPL-2.0
**Waline**
[walinejs/waline: A Simple, Safe Comment System inspired by Valine | 一款基于 Valine 衍生的简洁、安全的评论系统](https://github.com/walinejs/waline)
**License**: GPL-2.0
**Gitment**
[imsun/gitment: A comment system based on GitHub Issues.](https://github.com/imsun/gitment)
**License**: MIT
### 其他
**霞鹜文楷**
[lxgw/LxgwBright: A merged font of Ysabeau Office and LXGW WenKai.](https://github.com/lxgw/LxgwBright)
**License**: SIL Open Font License 1.1
## ✨ 其他
### 代码提交量
### Star 历史
---
[^1]: 站点配置文件即 Hexo 根目录的 `_config.yml` 文件