Docusaurus2搭建博客及入门使用

开始上手

官方文档

hexo 博客转换为 Docusaurus2 博客

hexo 博客可以轻松的转换为 Docusaurus2 博客

将文件从hexo 的source\_posts 移动到 Docusaurus2的 blog 下

可能会有一些报错， 再根据报错进行对应修复即可

设置摘要示例

docusaurus.config.js

  blog: {
        // ...
          truncateMarker: /<!--\s*(more)\s*-->/,
        }
      

国际化 i18n

官方文档

tip: Github Pages 不能部署国际化 我改用 vercel 进行部署 ，使用 vercel 部署见文档

搜索

搜索

官方建议使用docsearch的申请界面 进行申请 预计两个星期左右给回复邮件 我等了3星期也没有回复 哎
决定自己配置搜索 官方文档

• 首先需要创建一个 algolia 账号
• 根据 官方文档 使用 docker 爬取自己站点的索引
• 配置 docusaurus.config.js

tip: 建议使用 github 的 codespaces 省得自己配环境
注意事项

• API_KEY设置为您的 API 密钥。确保使用具有索引写入权限的 API 密钥。它需要添加修改和删除权（我使用的是管理员密钥）
• 爬虫配置文件 config.json 需要使用docusaurus-v2 的模板 我使用官方的默认配置建立不了索引
• algolia 有 1000 条索引限制需要注意
• docusaurus.config.js algolia 配置 indexName 需要跟爬虫配置文件 config.json 中 index_name 一致

搜索引擎优化 (SEO)

SEO

editUrl 编辑此页

{
  editUrl: "https://github.com/bitbw/new-blog/tree/preview"
}

https://github.com/用户名称/仓库名称/tree/分支"

案例展示

Docusaurus 案例展示
我的博客