https://github.com/lruihao/hugo-blog
Lruihao's Note
https://github.com/lruihao/hugo-blog
blog front-end hugo hugo-blog hugo-fixit hugo-site
Last synced: 6 months ago
JSON representation
Lruihao's Note
- Host: GitHub
- URL: https://github.com/lruihao/hugo-blog
- Owner: Lruihao
- License: mit
- Created: 2021-09-08T12:52:53.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-04T06:46:59.000Z (7 months ago)
- Last Synced: 2025-03-31T14:13:45.938Z (6 months ago)
- Topics: blog, front-end, hugo, hugo-blog, hugo-fixit, hugo-site
- Language: Markdown
- Homepage: https://lruihao.cn
- Size: 76.8 MB
- Stars: 75
- Watchers: 2
- Forks: 9
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 菠菜眾長
[](https://gohugo.io/)
[](https://github.com/Lruihao/hugo-blog/actions/workflows/deploy.yml)
[](https://github.com/Lruihao/hugo-blog/commits/main)
> 站名“菠菜眾長”，取“兼收並蓄，博採眾長”之意。
博客基于 [Hugo](https://github.com/gohugoio/hugo) 和 [FixIt](https://github.com/Lruihao/FixIt) 搭建，建站的初衷不是为了炫耀所知，而是记录无知。
博客内容主要以 Web 前端开发方向为主，分享一些有趣程序、技巧、开发教程、心情和学习记录等。
你可以通过我的[微信公众号](https://lruihao.cn/images/qr-wx-mp.webp "关注「菠菜眾長」公众号")、[GitHub](https://github.com/Lruihao/hugo-blog "Watch on GitHub") 或 [RSS](http://lruihao.cn/index.xml) 来订阅本博客。
## Content
- [归档](https://lruihao.cn/archives/)
- [分类](https://lruihao.cn/categories/)
- [合集](https://lruihao.cn/collections/)
- [标签](https://lruihao.cn/tags/)
## Source
博客相关源码：
- [HTML-CSS-JavaScript 相关](https://github.com/Lruihao/html-demo)
- [Vue2 相关](https://github.com/Lruihao/vue-el-demo)
- [Hugo FixIt 相关](https://github.com/hugo-fixit)
- [更多](https://github.com/Lruihao?tab=repositories)
## [Roadmap](https://github.com/users/Lruihao/projects/1)
## Project setup
本博客已部署到 [Vercel](https://blog-lruihao.vercel.app/) 和 [GitHub Pages](https://github.com/Lruihao/lruihao.github.io)，工作流如下图所示：
```bash
▸ .github/ # GitHub configuration
▸ .scripts/ # custom scripts
▸ .shell/ # shell commands for hugo project, entrance: hugo_main.sh
▸ archetypes/ # page archetypes (like scaffolds of archetypes)
▸ assets/ # css, js, third-party libraries etc.
▸ config/ # configuration files
▸ content/ # markdown files for hugo project
▸ private/ # private submodule for encrypted content
▸ data/ # blog data (allow: yaml, json, toml), e.g. friends.yml
▸ public/ # build directory
▸ static/ # static files, e.g. favicon.ico
▸ themes/ # theme submodules
```
### System requirements
- [Node.js](https://nodejs.org/): >= 18.0.0
- [Go](https://go.dev/dl/)
- [Hugo](https://gohugo.io/installation/): >= 0.134.1 (extended version)
### Clone
首先点上 Star 😜，然后下载源码：
```bash
git clone --recursive git@github.com:Lruihao/hugo-blog.git && cd hugo-blog
```
下载源码后，有两种方法可以启动这个博客。
### NPM
```bash
npm install
# build the blog
npm run build
# run a local debugging server with watch
npm run server
# run a local debugging server in production environment
npm run server:production
# update theme submodules
npm run update:theme
```
如果没有全局安装 Hugo，甚至可以通过 hugo-bin 在 Node.js 环境下使用 Hugo。
参考：[hugo-bin](https://github.com/fenneclab/hugo-bin)
```bash
npm install hugo-bin --save-dev
```
`package.json` 需配置 `extended` 版本：
```json
{
...
"hugo-bin": {
"buildTags": "extended"
}
}
```
再通过 `npx hugo` 启动。
### Hugo
```bash
# Development environment
hugo server --disableFastRender --navigateToChanged --bind 0.0.0.0
# Production environment
hugo server --disableFastRender --navigateToChanged --environment production --bind 0.0.0.0
```
此外，还可以运行 shell 脚本来选择常用的 Hugo 命令。
```bash
cd .shell && sh hugo_main.sh
```
```text
--------------Hugo Admin--------------
Please enter the serial number to work
--------------------------------------
1. post
2. server
3. server:production
4. build
5. submodule-sync
6. push
--------------------------------------
Press Ctrl+C to stop
```
## License
[](https://creativecommons.org/licenses/by-nc-sa/4.0/)
[](https://github.com/Lruihao/hugo-blog/blob/main/LICENSE)
- 此存储库中的文本、图像和视频等内容采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可
- 此存储库中的代码采用 [MIT](https://github.com/Lruihao/hugo-blog/blob/main/LICENSE) 许可
- _`content/private` 目录不在任何许可范围内_
## Sponsor
[translate.js](https://github.com/xnx3/translate) 赞助企业级翻译通道。
## Author
[Lruihao](https://github.com/Lruihao "在 GitHub 上关注我")