Skip to main content

第一篇博客

· 4 min read
业余开发者

这是我的第一篇博客,记录一下我的学习和生活。

本网站基于Docusaurus构建,使用了Markdown语法。

Docusaurus 是一款基于 React 的静态网站生成工具,专注于快速构建文档、博客等内容驱动型网站。以下是其核心使用方法和实践要点:


一、快速入门

  1. 安装与初始化
    使用 Node.js 的 npx 命令创建项目:

    npx create-docusaurus@latest my-website classic

    该命令会生成经典模板项目,支持文档、博客和自定义页面。

  2. 启动开发服务器

    cd my-website
    npm start

    访问 http://localhost:3000 即可预览本地站点,支持实时热更新。

  3. 目录结构
    项目主要目录包括:

    • docs/:存放文档(Markdown/MDX 文件)
    • blog/:存放博客文章
    • src/:自定义 React 组件和页面
    • static/:静态资源(如图片、CSS)

二、核心功能

  1. 文档与博客管理
    • 文档编写:在 docs/ 下创建 .md.mdx 文件,通过 sidebar_position 控制侧边栏排序。
    • 博客发布:在 blog/ 下按日期命名文件(如 2025-03-30-intro.md),支持标签、作者和摘要截断(通过 `