添加文章：Hugo博客搭建和维护完全指南

content/posts/hugo-blog-guide.md

@@ -0,0 +1,278 @@
+---
+title: "搭建和维护Hugo博客完全指南"
+date: 2024-12-10
+draft: false
+tags: ["Hugo", "博客", "教程", "GitHub Pages"]
+categories: ["技术文档"]
+---
+
+# 搭建和维护Hugo博客完全指南
+
+本文将详细介绍如何使用Hugo和GitHub Pages搭建个人博客，以及如何进行日常维护和内容更新。这是一份完整的操作手册，适合收藏参考。
+
+## 一、初始环境搭建
+
+### 1.1 安装必要工具
+
+首先需要安装以下工具：
+
+```bash
+# macOS用户
+brew install hugo
+brew install git
+
+# Windows用户
+choco install hugo-extended
+# 安装Git：从 https://git-scm.com/download/win 下载安装
+```
+
+### 1.2 验证安装
+```bash
+hugo version
+git --version
+```
+
+## 二、创建Hugo站点
+
+### 2.1 基础站点创建
+```bash
+# 创建新站点
+hugo new site my-blog
+cd my-blog
+
+# 初始化Git仓库
+git init
+```
+
+### 2.2 主题安装
+```bash
+# 添加主题（以hugo-coder为例）
+git submodule add https://github.com/luizdepra/hugo-coder.git themes/hugo-coder
+
+# 修改config.toml配置主题
+echo 'theme = "hugo-coder"' >> config.toml
+```
+
+## 三、配置文件详解
+
+### 3.1 基础配置 (config.toml)
+```toml
+baseURL = 'https://你的用户名.github.io/'
+languageCode = 'zh-cn'
+title = '我的博客'
+theme = 'hugo-coder'
+
+# 其他常用配置
+[params]
+  author = "你的名字"
+  info = "个人介绍"
+  description = "个人博客"
+  keywords = "blog,developer,personal"
+
+[taxonomies]
+  category = "categories"
+  tag = "tags"
+  series = "series"
+```
+
+## 四、文章管理
+
+### 4.1 创建新文章
+```bash
+# 创建新文章
+hugo new posts/my-first-post.md
+```
+
+### 4.2 文章前置配置
+每篇文章开头都需要包含以下信息：
+```yaml
+---
+title: "文章标题"
+date: 2024-12-10
+draft: false
+tags: ["标签1", "标签2"]
+categories: ["分类"]
+---
+```
+
+### 4.3 本地预览
+```bash
+# 启动本地服务器
+hugo server -D
+
+# 访问 http://localhost:1313 查看效果
+```
+
+## 五、部署流程
+
+### 5.1 GitHub仓库设置
+1. 创建名为 `<用户名>.github.io` 的仓库
+2. 配置GitHub Pages：
+   - 进入仓库Settings > Pages
+   - 选择GitHub Actions作为部署源
+
+### 5.2 推送更新
+```bash
+# 添加更改
+git add .
+
+# 提交更改
+git commit -m "更新说明"
+
+# 推送到GitHub
+git push origin main
+```
+
+## 六、日常维护指南
+
+### 6.1 写作工作流
+1. 创建新文章：
+```bash
+hugo new posts/新文章名称.md
+```
+
+2. 编写内容：
+   - 使用Markdown编辑器（推荐VS Code）
+   - 添加图片：将图片放在 `static/images` 目录下
+   - 引用图片：`![描述](/images/图片名.jpg)`
+
+3. 发布流程：
+```bash
+# 本地预览
+hugo server -D
+
+# 确认无误后推送
+git add .
+git commit -m "添加新文章：文章标题"
+git push
+```
+
+### 6.2 常用维护命令
+```bash
+# 清理缓存
+hugo clean
+
+# 重建站点
+hugo
+
+# 更新主题
+git submodule update --remote
+```
+
+### 6.3 图片管理建议
+1. 建立规范的图片命名规则：
+   - 使用日期前缀：`2024-12-10-图片描述.jpg`
+   - 使用文章相关名称：`article-name-image1.jpg`
+
+2. 图片目录结构：
+```
+static/
+  └── images/
+      ├── posts/  # 文章配图
+      ├── avatar/ # 头像等固定资源
+      └── gallery/ # 图片集
+```
+
+## 七、进阶技巧
+
+### 7.1 自定义短代码
+在 `layouts/shortcodes` 目录下创建自定义短代码，例如创建提示框：
+```html
+<!-- layouts/shortcodes/notice.html -->
+<div class="notice {{ .Get 0 }}">
+  {{ .Inner }}
+</div>
+```
+
+使用方式：
+```markdown
+{{%/* notice info */%}}
+这是一个信息提示框
+{{%/* /notice */%}}
+```
+
+### 7.2 SEO优化
+1. 添加网站地图：
+```toml
+# config.toml
+[sitemap]
+  changefreq = "weekly"
+  priority = 0.5
+  filename = "sitemap.xml"
+```
+
+2. 添加robots.txt：
+```txt
+# static/robots.txt
+User-agent: *
+Allow: /
+Sitemap: https://你的域名/sitemap.xml
+```
+
+### 7.3 评论系统集成
+可以集成Disqus或utterances等评论系统：
+```toml
+# config.toml
+[params.utterances]
+  repo = "用户名/仓库名"
+  issueTerm = "pathname"
+  theme = "preferred-color-scheme"
+```
+
+## 八、常见问题解决
+
+### 8.1 部署失败排查
+1. 检查GitHub Actions配置
+2. 验证仓库权限设置
+3. 确认Hugo版本兼容性
+4. 查看构建日志定位错误
+
+### 8.2 内容更新不生效
+1. 确认文章front matter中draft设置
+2. 清理缓存后重新构建
+3. 检查文件名和路径是否正确
+
+### 8.3 主题更新
+```bash
+# 更新特定主题
+cd themes/hugo-coder
+git pull
+
+# 更新所有子模块
+git submodule update --remote
+```
+
+## 九、效率提升技巧
+
+### 9.1 使用VS Code扩展
+推荐安装以下扩展：
+- Markdown All in One
+- Front Matter
+- Hugo Language and Syntax Support
+
+### 9.2 创建发布脚本
+创建 `publish.sh`:
+```bash
+#!/bin/bash
+# 添加文章更改
+git add .
+
+# 提交更改
+git commit -m "发布: $1"
+
+# 推送到远程
+git push origin main
+```
+
+使用方式：
+```bash
+./publish.sh "新文章：XXX"
+```
+
+## 十、结语
+
+本指南涵盖了Hugo博客的基础搭建和日常维护的主要方面。随着使用的深入，你可以根据需要扩展和优化这些流程。记得定期备份你的内容，并保持主题和Hugo版本的更新。
+
+---
+
+**最后更新时间**: 2024-12-10

public/categories/index.html

@@ -123,6 +123,9 @@ <h1>Categories</h1>
 </header>
 
 <ul class="terms-tags">
+    <li>
+        <a href="http://localhost:1313/categories/%E6%8A%80%E6%9C%AF%E6%96%87%E6%A1%A3/">技术文档 <sup><strong><sup>1</sup></strong></sup> </a>
+    </li>
 </ul>
     </main>
 

public/categories/index.xml

@@ -6,6 +6,14 @@
     <description>Recent content in Categories on My New Hugo Site</description>
     <generator>Hugo -- 0.139.3</generator>
     <language>en-us</language>
+    <lastBuildDate>Tue, 10 Dec 2024 00:00:00 +0000</lastBuildDate>
     <atom:link href="http://localhost:1313/categories/index.xml" rel="self" type="application/rss+xml" />
+    <item>
+      <title>技术文档</title>
+      <link>http://localhost:1313/categories/%E6%8A%80%E6%9C%AF%E6%96%87%E6%A1%A3/</link>
+      <pubDate>Tue, 10 Dec 2024 00:00:00 +0000</pubDate>
+      <guid>http://localhost:1313/categories/%E6%8A%80%E6%9C%AF%E6%96%87%E6%A1%A3/</guid>
+      <description></description>
+    </item>
   </channel>
 </rss>