fixit-theme/hugo-stellar

hugo-theme

Hugo Stellar

Hexo theme stellar 的 Hugo 移植版本。

注意！此移植版本尚未完善，仅供 debug！

Demo

模板网站：https://hugo-template.github.io/Stellar-Hugo-Template/

Yharim Area：https://yharim.com/

DeCheng Note：https://note.dc6.fun/

Preview

Usage

方案 1：GitHub Actions + Pages 建站

Hugo Stellar 一键模板

十分甚至九分感谢由用户 cyolc932 提供的大力支持。

方案 2：本地建站

请使用 hugo extended v0.109.0 或更新版本。

本地建站 sh 脚本：

hugo new site mysite
cd mysite
git init
git submodule add https://github.com/Yharimium/hugo-stellar themes/stellar
cp -R themes/stellar/exampleSite/* .
rm config.toml

预览网站：

hugo server

注：请务必保证您的站点配置文件（如 config.yaml）中包含有下列配置：

markup:
  _merge: deep

否则将导致代码块渲染异常。

Content Management

content 目录结构：支持 posts（博客）和 docs（文档）两种模式。

content/
├── posts/
│   ├── test.md         <- example.com/posts/test.html
│   └── folder/
│       ├── index.md    <- example.com/posts/index.html
│       └── test.md     <- example.com/posts/folder/test.html
└── docs/
    └── test.md         <- example.com/docs/test.html

Experimental Features

扩展语法支持

注：此功能可能存在 bug，请谨慎使用。

支持在正文中使用 mkdocs 和 hexo stellar 语法，例如：

!!! note
    `markdown` text

{% poetry 独不见 author:唐·沈佺期 footer:诗词节选 %}
卢家少妇郁金堂，海燕双栖玳瑁梁。
**九月寒砧催木叶，十年征戍忆辽阳。**
白狼河北音书断，丹凤城南秋夜长。
谁为含愁独不见，更教明月照流黄？
{% endpoetry %}

详见 扩展语法支持