Skip to main content

Docusaurus2搭建博客及入门使用

· 2 min read
Bowen Zhang
Bowen Zhang
本文作者

开始上手​

官方文档

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星期也没有回复 哎 决定自己配置搜索 官方文档

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 案例展示 我的博客