按以下页面提示安装运行: https://developers.cloudflare.com/pages/framework-guides/deploy-a-docusaurus-site/
安装
先在 github 上新建一个库
使用
npm create cloudflare@latest my-docusaurus-app -- --framework=docusaurus
安装过程中,需要先在游览器中登录 cloudflar,命令运行过程中,会要求验证。
连接 github
git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main
运行和部署
安装完成后,命令行会提示。主要也就是两个命令。
- Run the development server
npm run pages:dev - Deploy your application
npm run pages:deploy
好象并不需要先自己手动处理 github 的事情,第 2 个命令就直接完成了部署。
使用
默认是开了 docs 和 blog 的,基本开箱用。
需要注意的是:
- docs 目录是支持多层目 录的,而 blog 不支持。
- 和 mkdocs 不同,使用软链接到 docs 目录,可以生成侧栏和目录,但是显示文章会出错。所以只能先同步 md 文件夹,然后才能正常进行。
- 一些 md 文档可能会出错,不明原因。
简明流程
- 安装 docusaurus 到目录:docu-cfpages
- 使用 obsidian 编写 md 文档。文档保存在 obsidian 的 docs 文件夹中。
- 使用 rsync 同步到
docu-cfpages目录中:rsync ~/foam/docs/ ~/docu-cfpages/docs/ -r - 同步完之后,也许应该 push 一下:
git push -u origin main - 在本机查看是否有问题,进入目录:
npm run pages:dev - 发布到网络:
npm run pages:deploy - ridemyway.top