简体中文 | English
这是我的的 博客 的源代码,同时也是一个强大的静态博客站点。
- 支持自定义主题开发
- 从 Notion 同步文章
- 多语言 UI/文章
- RSS 订阅
- 评论
点击页面右上角 Use this templat,创建你自己的仓库。
之后,修改配置文件。位于 ./site.config.js
- title:博客名称
- root:博客根网址
- author: 作者信息
- name:名称
- intro:介绍
如果你需要使用 Notion 写作,请在 Notion 新建一个 Intergation,获取 API Key. 同时获取你的 database_id
然后,在 Github 仓库新增两个环境变量:
NOTION_API_KEY=<YOUR_KEY>
NOTION_DATABASE_ID=<YOUR_ID>
一切准备就绪后,可以选择你喜欢的方法部署。
目前支持两种写作方式:
- 将 Markdown 文件放入
/posts/<catagories>
目录即可。目前最高支持二级目录。 - 从 Notion 单向同步文章。
如果你选择第一种方式,每篇文章至少需要以下两个 frontmatter:
- title
- date
如果选择使用 Notion 写作,请参考这个 database 的形式创建一个一样的。
此外,若要启用底部的照片墙,只需编辑/posts/gallery.json
即可,例如:
{
"zh-CN": [
{
"imageUrl": "/photography/IMG_7199.png",
"caption": "Santana 2023",
"alt": "Sunset Image",
"date": "2023-10-18"
}
],
"en-US": [
{
"imageUrl": "/photography/IMG_6922.png",
"caption": "Dawn",
"alt": "Blue Skyline",
"date": "2023-09-12"
},
{
"imageUrl": "/photography/IMG_5621.png",
"caption": "Hometown",
"alt": "The city I was born in.",
"date": "2023-01-27"
},
{
"imageUrl": "/photography/IMG_7246.png",
"caption": "Green",
"alt": "Beach Image",
"date": "2023-10-21"
}
]
}
由于 netify 的特性,请在项目设置中把部署命令修改为:
CI= yarn run build
确保服务器已安装 Node.js、 git 和 pm2。
在服务器下创建/app/ygk-blog 目录,并执行git init
初始化仓库。
mkdir -p /app/blog && cd /app/blog
git init
在 github 创建一个仓库,并在Setting
->Secrets
下添加服务器信息。
- SSH_HOST:服务器 IP
- SSH_USERNAME:服务器用户名
- SSH_PORT:SSH 端口(默认 22)
- SSH_PASSWORD:服务器用户密码
在 Github 仓库的 Deploy Keys
下添加服务器 git 公钥(生成方法)。
vim ~/.ssh/id_rsa.pub
确保 Action 已启用之后,在 github 上所有 master 分支的更新都会自动部署到服务器。大功告成!
一个自定义主题需要包含以下文件:
文件名 | 参数 | 说明 |
---|---|---|
index.tsx | 首页 | |
all.tsx | 全部文章页面 | |
detail.tsx | ||
p/[id].tsx |
开发完毕之后,可以替换 theme 中的文件来实现更换主题。
MIT