Skip to main content

关于这个站的过程

· 2 min read

按以下页面提示安装运行: 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

test