文章+1 图标完善

This commit is contained in:
Sin Lee 2025-12-21 17:47:49 +08:00
parent f1403e3e3c
commit 3a0bfea8e3
4 changed files with 166 additions and 0 deletions

120
README.md Normal file
View File

@ -0,0 +1,120 @@
# 🚀 我的 Hugo 博客操作手册
这份文档是为了防止我忘记 Hugo 指令而准备的“防呆”指南。
---
## 1. 常用开发指令 (本地电脑)
在进行任何操作前,请先进入博客的根目录(即本文件所在的文件夹)。
### 🛠️ 启动本地预览(最常用)
```bash
hugo server -D
```
* **作用**:在本地运行一个实时预览服务器。
* **参数 `-D`**:表示显示标记为 `draft: true`(草稿)的文章。
* **查看地址**:在浏览器输入 `http://localhost:1313/`
* **注意**:这个命令是动态的,你修改并保存 Markdown 文件后,浏览器会自动刷新。
### 📝 新建一篇文章
```bash
hugo new posts/我的第一篇博客.md
```
* **作用**:在 `content/posts/` 目录下创建一个新的 Markdown 文件,并带上基础的模板(元数据)。
* **建议**:文件名尽量不要有空格,可以使用中划线,如 `my-first-post.md`
### 🏗️ 生成静态 HTML 文件
```bash
hugo
```
* **作用**:将你的所有 Markdown 源码正式编译成 HTML/CSS/JS。
* **产出**:所有的静态文件都会生成在根目录下的 `public/` 文件夹中。
* **场景**:当你准备把网站更新到服务器上时,才运行这个命令。
---
## 2. 关于“写文章”的说明
### 💡 我可以直接把写好的 .md 挪进来吗?
**可以!** 你不需要非得用 `hugo new` 指令。你可以直接把写好的 Markdown 文件直接拖进 `content/posts/` 目录下。
**但是(非常重要):**
Hugo 识别文章是靠 Markdown 文件头部的 **Front Matter**(元数据)。如果你直接挪文件,请务必在文章最顶部加上这段代码(以 YAML 格式为例):
```yaml
---
title: "文章标题"
date: 2023-10-27T10:00:00+08:00
draft: false
tags: ["标签1", "标签2"]
categories: ["分类"]
---
```
* **draft: true**:如果是 true生成网站时这篇文章会被忽略除非你带了 `-D` 参数)。
* **date**Hugo 默认按照这个时间排序,如果时间是未来的时间,文章也不会显示。
---
## 3. 本地 vs 生产环境 (Linux 服务器)
你在本地电脑和在 Linux 服务器上的操作可能略有不同,取决于你的部署方式。
### 场景 A在本地生成上传 `public` 文件夹
这是最简单的方式。
1. 本地运行 `hugo`
2. 使用 FTP/SCP/Rsync 将本地生成的 `public/` 文件夹里的所有内容发到 Linux 服务器的 Web 目录(如 `/var/www/html`)。
3. **优势**:服务器不需要安装 Hugo。
### 场景 B在服务器上通过源码生成
如果你在服务器上也安装了 Hugo并且通过 Git 同步代码:
1. 在服务器执行 `git pull` 同步源码。
2. 在服务器执行 `hugo`(不需要带 server
3. 确保你的 Nginx/Apache 指向的是服务器上的 `public` 目录。
### ⚠️ 区别提醒
* **Hugo 版本**:确保本地和服务器的 Hugo 版本尽量一致,尤其是 Extended 版本(如果你使用了高级的 CSS 样式)。
* **BaseURL**:在根目录的 `hugo.toml` (或 `config.toml`) 中,`baseURL` 必须写成你真实的域名(如 `https://www.example.com/`),否则服务器上的图片或样式可能加载不出来。
---
## 4. 常见问题排查 (新人必看)
* **Q: 为什么我新建的文章在浏览器里看不见?**
* 检查文章头部的 `draft` 是不是 `true`
* 检查文章头部的 `date` 是不是未来的时间。
* 如果你没运行 `hugo server -D`,请加上 `-D` 试试。
* **Q: 修改了主题配置,但是没生效?**
* 有时候是浏览器缓存。试试在浏览器按下 `Ctrl + F5` 强制刷新。
* 如果是 Hugo 缓存,可以尝试删除 `resources/` 文件夹后重新运行。
* **Q: 怎么更换主题?**
* 主题放在 `themes/` 文件夹。
* 在 `hugo.toml` 中修改 `theme = "你的主题文件夹名称"`
---
## 5. 目录结构速查
* `content/`:存放你的 Markdown 文章源码。
* `static/`存放图片、PDF、图标等原始资源生成后会直接复制到根目录。
* `themes/`:存放下载的主题。
* `public/`:生成的成品网站(不要手动改这里面的代码)。
* `hugo.toml` / `config.toml`:整个网站的“大脑”,改名字、改域名都在这里。
---
### ✍️ 每日更新流水账:
1. `cd` 进入目录
2. `hugo new posts/xxx.md` 或 直接拖入 md 文件
3. `hugo server -D` 预览效果
4. 满意后,运行 `hugo` 编译
5. 将 `public/` 部署到服务器
---
### 补充建议:
如果你以后还是觉得记命令麻烦,可以在你的项目根目录下新建一个叫 `deploy.sh` 的脚本文件,内容如下:

View File

@ -0,0 +1,44 @@
+++
date = '2025-12-21T17:02:45+08:00'
draft = false
title = 'linux添加frps为系统启动'
+++
## 增加一个服务(frps), 使用systemctl控制
cat > /etc/systemd/system/frps.service <<EOF
[Unit]
Description=Frp Server Service
After=network.target
[Service]
Type=simple
ExecStart=/root/frp_0.63.0_linux_amd64/frps -c /root/frp_0.63.0_linux_amd64/frps.toml
Restart=on-failure
[Install]
WantedBy=multi-user.target
EOF
systemctl enable frps
systemctl start frps

View File

@ -18,6 +18,8 @@ theme = 'PaperMod'
[params.homeInfoParams] [params.homeInfoParams]
Title = "欢迎来到我的博客" Title = "欢迎来到我的博客"
Content = "分享 杂七杂八~" Content = "分享 杂七杂八~"
[params.assets]
favicon = "/favicon.ico"
# 菜单配置 # 菜单配置
[[menu.main]] [[menu.main]]

BIN
static/favicon.ico Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB