welldo / nblog

支持多语言和评论的静态Markdown博客系统，仿知乎设计，响应式，基于next.js。

Rene.wang

简体中文 | 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>

一切准备就绪后，可以选择你喜欢的方法部署。

✍ 写作

目前支持两种写作方式：

1. 将 Markdown 文件放入/posts/<catagories>目录即可。目前最高支持二级目录。
2. 从 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"
		}
	]
}

部署到 Vercel

部署到 Netify

由于 netify 的特性，请在项目设置中把部署命令修改为：

CI= yarn run build

部署到自己的服务器

0.服务器配置

确保服务器已安装 Node.js、 git 和 pm2。

在服务器下创建/app/ygk-blog 目录，并执行git init初始化仓库。

mkdir -p /app/blog && cd /app/blog
git init

1.Github 仓库配置

在 github 创建一个仓库，并在Setting->Secrets下添加服务器信息。

• SSH_HOST：服务器 IP
• SSH_USERNAME：服务器用户名
• SSH_PORT：SSH 端口（默认 22）
• SSH_PASSWORD：服务器用户密码

在 Github 仓库的 Deploy Keys 下添加服务器 git 公钥（生成方法）。

vim ~/.ssh/id_rsa.pub

2.推送代码

确保 Action 已启用之后，在 github 上所有 master 分支的更新都会自动部署到服务器。大功告成！

配置 Notion

自定义主题

一个自定义主题需要包含以下文件：

文件名	参数	说明
index.tsx		首页
all.tsx		全部文章页面
detail.tsx
p/[id].tsx

开发完毕之后，可以替换 theme 中的文件来实现更换主题。

License

MIT