博客搭建

2025-03-16 729 words 2 minutes

Contents

前言

第一次搭建博客，仍有诸多不完善的地方

快速开始

创建一篇新文章

        
cd /d/hugo/KieranKaiyanLiang # 进入Hugo项目的根目录
hugo new posts/xxx.md # 在content/posts下新建md文档

此时会在KieranKaiyanLiang/content/posts下创建xxx.md文档

当编辑完文字后，运行脚本auto_deploy.sh一键部署

        
        
        
    
#!/bin/bash

# 进入 Hugo 项目目录（注意 WSL 的路径格式）
cd /d/hugo/KieranKaiyanLiang || { echo "无法进入项目目录"; exit 1; }

# 生成静态文件
hugo || { echo "Hugo 生成失败"; exit 1; }

# 进入 public 目录
cd public || { echo "无法进入 public 目录"; exit 1; }

# Git 操作
git add . || exit 1

# 提交并推送（强制覆盖）
git commit -m "Auto-update: $(date +'%Y-%m-%d %H:%M')"
git push --force || exit 1

echo "部署成功！"
#否则终端会自动关闭看不清运行结果
read -p "按回车关闭终端"  

新建文章

hugo new posts/xxx.md命令能够根据archetypes/default.md中的配置初始化md文档

主要就是初始化文章的Front Matter

        
        
        
    
+++
date = '2025-03-16T21:33:37+08:00'
draft = false
title = '博客搭建'
categories = ['博客相关文章']
+++

Front Matter还可以设置下列选项：

字段	作用	示例
`title`	文章标题	`{{ replace .File.ContentBaseName "-" " " \| title }}`
`date`	发布时间	`date: {{ .Date }}`
`draft`	是否草稿	`draft: true`
`slug`	URL 别名	`slug: my-first-post`
`url`	页面完整 URL	`url: /posts/my-first-post/`
`description`	摘要	`description: "文章摘要"`
`categories`	分类	`categories: ["Tech", "Hugo"]`
`tags`	标签	`tags: ["hugo", "markdown"]`
`author`	作者	`author: "Kieran"`
`featured_image`	封面图	`featured_image: "/images/post-cover.jpg"`
`layout`	使用模板	`layout: post`
`publishDate`	实际发布时间	`publishDate: 2025-10-18`

但其实直接在content/posts下手动创建md文档也可以

本地预览

如果想在本地预览修改后的博客

        
cd /d/hugo/KieranKaiyanLiang
hugo server -D # 启动本地服务器

-D表示会编译包括draft在内的所有文档

此时会显示监听的端口号（如http://localhost:1313/）

在浏览器中访问http://localhost:1313/ 即可