跳到主要内容

Welcome

· 阅读需 4 分钟
brightzoe

About​

你好，这里是我的 blog，或者可以说是我的 wiki 文档。

本博客使用 docusaurus 搭建，想要进一步了解请参阅官方文档 Docusaurus docs

前期使用docsify 作为文档网站，2021.09 迁移至docusaurus。 Docsify docs

欢迎来到这里，如果对你有些帮助，我会很开心。有任何想说的或建议都欢迎留言。

信息

本 blog 中技术相关的文档，有参考来自网络的很多内容，包括来自 StackOverFlow, 掘金，思否，微信公众号，知乎等等。我在撰写文章，参考一些优秀内容时会记得添加到 References 注明出处, 若有疏漏，或者不小心侵权了，请放心联系我，尊重所有人的版权。

Site Content​

截至目前，本 blog 的技术相关文档还是以笔记为主，记录本人在技术学习过程中对参考资料的整理，以及练习某些技术的总结。

以后在整理文档时，会在相关内容处直接放上参考，来源链接，并同时把链接放到最后‘Reference’处，方便使用。

近期阅读参考‘掘金’比较多。 2021-10

How to use docusaurus​

以下为个人使用 docusaurus 的 doc 参考，更多请直接参考官方文档。

Docusaurus blogging features​

Docusaurus blogging features are powered by the blog plugin.

Simply add Markdown files (or folders) to the blog directory.

Regular blog authors can be added to authors.yml.

The blog post date can be extracted from filenames, such as:

  • 2019-05-30-welcome.md
  • 2019-05-30-welcome/index.md

A blog post folder can be convenient to co-locate blog post images:

Docusaurus Plushie

The blog supports tags as well!

Use a <!--truncate--> comment to limit blog post size in the list view.

备注

Some content with markdown syntax.

信息

Some content with markdown syntax.

警告

Some content with markdown syntax.

危险

Some content with markdown syntax.

Blog posts support Docusaurus Markdown features, such as MDX.

提示

Use the power of React to create interactive blog posts.

Using Interactive code editor​

实时编辑器
function Clock(props) {
  const [date, setDate] = useState(new Date());
  useEffect(() => {
    var timerID = setInterval(() => tick(), 1000);

    return function cleanup() {
      clearInterval(timerID);
    };
  });

  function tick() {
    setDate(new Date());
  }

  return (
    <div>
      <h2>It is {date.toLocaleTimeString()}.</h2>
    </div>
  );
}
结果
Loading...

Using sandpack​

ChangeLog​

  1. 2021.10 添加@codesandbox/sand-pack，直接在 md 文档里放可以运行预览的代码,自定义文件内容不是詪好用，待研究。

  2. 2022.01 添加lxgw-wenkai-screen字体。字体文件较大，使用 github chawyehsu/lxgw-wenkai-webfont: webfont package for the LXGW WenKai typeface 的 node 包，优化加载。

  3. 2022.06 添加 disqus 评论插件。在 blog 部分默认开启，doc 部分关闭，可以通过disqus: true来开启某篇文档的评论。

  4. 2023.05 添加 ts 支持，由 yarn 切换至 pnpm。

    依赖升级至 react18, 遇到 react 版本不兼容的问题，添加了.npmrc文件解决。 Migrate to React 18 · Issue #7264 · facebook/docusaurus

  5. 2024.01 添加 tailwindcss 支持。Using TailwindCSS v3 in Docusaurus in 5 steps

Reference​