知识库

网站内容更新流程

一、更新网站的基本原理

这个网站不是在服务器上直接编辑页面，而是在本地电脑维护源码。

流程是：

  1. 在本地写 Markdown 文章。
  2. 用 Hexo 把 Markdown 生成静态网页。
  3. 把生成后的 public 目录上传到云服务器的 /var/www/html。
  4. 用 GitHub 备份源码，防止换电脑或误删后丢失。

可以理解为：

Markdown 源文件 -> Hexo 生成 HTML -> Nginx 对外访问

二、新增一篇文章

进入项目目录：

1
cd C:\Users\Lenovo\Documents\搭建个人网站

在 source/_posts 目录中新建一个 .md 文件，例如：

1
source/_posts/python-file-notes.md

文章开头写固定信息：

1
2
3
4
5
6
7
8
9
10
11
12
---
title: Python 文件处理笔记
date: 2026-06-27 10:30:00
categories:
  - 知识库
tags:
  - Python
  - 文件处理
excerpt: 记录 Python 读取、写入、遍历文件的常用方法。
---

正文从这里开始写。

三、本地预览

写完后先构建：

1
2
npm.cmd run clean
npm.cmd run build

如果要本地预览：

1
npm.cmd run server

然后打开：

1
http://localhost:4000/

四、发布到服务器

构建完成后，把 public 目录上传到服务器的 /var/www/html。

如果用当前项目里的自动流程，可以让 Codex 执行发布。

如果手动操作，核心思路是：

1
2
npm.cmd run clean
npm.cmd run build

然后用 scp 上传 public 里的文件，再在服务器上复制到：

1
/var/www/html

服务器上的 Nginx 会把 /var/www/html/index.html 当作网站首页。

五、备份到 GitHub

每次改完源码后，建议提交到 GitHub：

1
2
3
4
git status
git add .
git commit -m "Update knowledge base content"
git push

以后换电脑时，只要重新从 GitHub 克隆源码，再安装依赖，就可以继续维护。

六、哪些文件最常改

位置 用途
source/_posts 写文章
source/knowledge/index.md 修改知识库首页大纲
source/nav/index.md 修改导航页
source/images 存放图片
_config.yml 网站基础配置
themes/landscape-custom/_config.yml 菜单、主题配置

七、更新 Wiki 大纲

如果新增文章后，希望它出现在左侧“知识大纲”里，需要修改：

1
themes/landscape-custom/layout/_partial/wiki-tree.ejs

如果希望它出现在知识库首页的大纲里，需要修改：

1
source/knowledge/index.md

简单原则：文章负责内容，大纲负责入口。