超简单!使用 Docusaurus 搭建个人博客(一)

本文介绍了如何使用Docusaurus快速搭建个人博客,包括Docusaurus的特性、安装运行步骤、项目结构解析以及如何配置为博客模式。通过实例展示了创建第一篇博客的过程,适合前端开发者快速入门。
摘要由CSDN通过智能技术生成

B 站视频 - 点击传送

历史迷茫

我以前总也找不到一个满意的博客系统,wordpress 这个程序又大,然后配置也不方便。占用的服务器的资源也多。我就想有没有一个又简单又快速的博客平台,后来发现了一些静态的网站生成器,像 hexo 这种,但是发现上面的主题又不好看,又懒得自己去写。后来就有一阵子我就直接把博客就发布在了其他的第三方的博客平台上。现在发现了这个 docusaurus, 它的主题跟我之前看到的一个大佬 Dan Abramov,它的 overreacted.io 博客,风格是一模一样的,因为他是 react 的作者之一,估计这个他们这个样式都是互相借鉴,它这个主题可以切换暗黑和白天模式,比较好看。安装和部署也特别简单,我的博客也是用它这个搭建的。

博客有啥用?

首先先弄清一个问题,为什么要有一个自己的博客?,博客的好处就是对于咱们程序员来说:

它可以当成是咱们的副业。如果咱们在写代码的时候遇到了问题,或者是在学习一个新的技术的时候,咱们可以把这些学到的东西都给整理成博客,然后发表出来,这样的话呢,既可以能巩固咱们的知识,检测咱们这个技术有没有学懂,然后呢还能让其他想学这些东西的人也能看见,等这些分享的人多了之后,你就会慢慢攒一些粉丝,那这样你的博客就可以成为你的一个品牌,有了这个品牌之后,你再去面试或者是干嘛的,你就可以把它拿出来,然后大家可以看到你的作品,这样的话对于你以后的职业发展还是很有发财升官都有帮助。现在你也了解这个博客的好处了吧,那咱们开始用这个 Docusaurus 搭建一个博客

Docusaurus 简介

它是一个静态网站生成器,之前我在我的前端路线图的视频里面提到过这个概念,他是用 React 写的源代码,然后编译成的是静态的 HTML css。他这个写文章支持 Markdown 语法,并且呢,它这个 marketdown 是用的 mdx 也就是支持 jsx 语法的 markdown,无缝结合 React, 里边可以引入自定义的组件,然后呢他也支持插件,还有主题,咱们也可以写自定义的组件,把它默认的主题的某一个组件给覆盖掉,特别方便。

<img alt="" src={useBaseUrl('img/2020-03-02-deploy-a-docusaurus-site/2020-03-04-22-04-02.png')} />

安装运行环境

因为他是个 node 的项目,所以得安装一下 node js 的环境,

  • 8
    点赞
  • 34
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 7
    评论
Docusaurus是一个基于React的静态网站生成器,它使用Lunr.js作为默认的搜索引擎,而Lunr.js不支持中文搜索。因此,您需要使用其他中文分词库来支持中文搜索。 其中一个流行的中文分词库是jieba。要在Docusaurus使用jieba进行中文搜索,您需要执行以下步骤: 1. 在您的Docusaurus项目中安装jieba: ``` npm install jieba ``` 2. 在您的Docusaurus配置文件中,将Lunr.js搜索引擎替换为自定义的中文搜索引擎。假设您的配置文件名为docusaurus.config.js,您可以将以下代码添加到该文件的module.exports对象中: ```js const jieba = require('jieba'); const lunr = require('lunr'); // 自定义中文分词器 const tokenizer = (text) => { const tokens = jieba.cut(text); return lunr.utils .stringify(tokens) .split(/[\s,-]+/) .map((token) => token.toLowerCase()); }; // 自定义中文搜索引擎 const myIndex = lunr(function () { this.tokenizer = tokenizer; this.ref('id'); this.field('title'); this.field('content'); }); module.exports = { // ... themeConfig: { // ... algolia: { appId: 'YOUR_APP_ID', apiKey: 'YOUR_API_KEY', indexName: 'YOUR_INDEX_NAME', // 将Lunr.js搜索引擎替换为自定义的中文搜索引擎 algoliaOptions: { searchClient: null, searchFunction: function (helper) { const results = myIndex.search(helper.state.query); helper.setState(results); }, }, }, }, }; ``` 在上面的代码中,我们首先引入jieba和lunr库。然后,我们定义了一个自定义的中文分词器tokenizer,它使用jieba库来对中文文本进行分词。接下来,我们定义了一个自定义的中文搜索引擎myIndex,它使用我们刚刚定义的tokenizer来进行分词。 最后,我们将Lunr.js搜索引擎替换为我们的自定义搜索引擎。具体来说,我们在algoliaOptions对象中设置了searchFunction属性,该属性覆盖了Lunr.js默认的搜索函数。我们的自定义搜索函数使用我们的自定义搜索引擎来进行搜索。 3. 在您的Docusaurus项目中,在需要进行搜索的页面中添加一个搜索框。您可以使用Docusaurus内置的SearchBar组件来实现这一点: ```jsx import React from 'react'; import SearchBar from '@theme/SearchBar'; function MyComponent() { return ( <div> <SearchBar /> {/* ... */} </div> ); } export default MyComponent; ``` 现在,当您在搜索框中输入中文字符时,您的Docusaurus站点将使用jieba库来进行中文搜索。请注意,jieba库可能无法处理所有中文字符,因此您可能需要使用其他中文分词库或对jieba库进行配置来处理您需要搜索的特殊字符。
评论 7
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

峰华前端工程师

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值