在使用 Docusaurus 搭建文档站点的时候,我们经常要给某个侧边栏菜单增加一些醒目的标识,比如针对新创建的文档给它一个 New
的标识,
以提醒过来看文档的用户这是一个新增加项或者新特性(阅读的时候不要遗漏)。
然而这个功能是 Docusaurus 本身没有的,但是它向我们提供了定制改造的支持。就是这个 Swizzling 特性。
在使用 Docusaurus 搭建文档站点的时候,我们经常要给某个侧边栏菜单增加一些醒目的标识,比如针对新创建的文档给它一个 New
的标识,
以提醒过来看文档的用户这是一个新增加项或者新特性(阅读的时候不要遗漏)。
然而这个功能是 Docusaurus 本身没有的,但是它向我们提供了定制改造的支持。就是这个 Swizzling 特性。
最近因为要发布一个关于统计工具的介绍页面,要用到表单的功能,Docusaurus 中样式库用的是 Infima,里面并没有涉及到表单组件的样式。
想到网站后面肯定要用到很多交互方面的样式,纯手写比较麻烦。于是干脆直接引入一款前端 UI 库,基于个人审美选择了 Material UI。
安装免费开源的基于 React 函数式组件版的 MUI Core
npm install @mui/material @emotion/react @emotion/styled
在使用 Docusaurus 过程中,我逐步摸索出一些不常用但是很实用的特性,有些是通过一些简单的配置,有的则需要增加或修改一些代码来实现。
未撰写好的博客,在打包的时候不希望显示在博客列表中,可设置该篇博客为草稿状态,默认未设置 draft
为发布状态。
---
title: 我是如何使用 Docusaurus 来搭建我的网站的
slug: how-to-use-docusaurus
authors:
- name: Timfan
title: 高级前端开发
url: https://github.com/fantingsheng
image_url: https://spacexcode.com/img/avatar.png
email: fants0230@sina.com
tags: [使用指南]
hide_table_of_contents: false
draft: true
---