如何使用¶

🎯 快速开始¶

浏览笔记¶

使用左侧导航栏可以按分类浏览笔记：

• 根目录 - 系统介绍和基础内容
• R语言相关 - R语言学习笔记
• 更多分类会随着内容增加自动出现

搜索功能¶

• 点击顶部的搜索框
• 输入关键词可以搜索笔记标题和内容
• 支持中文和英文搜索

📝 添加新笔记¶

第一步：创建文件¶

在相应的分类目录下创建新的 Markdown 文件：

# 在 docs/notes/ 目录下创建新文件
touch docs/notes/new-note.md

# 或在子分类下创建
touch docs/notes/r-lang/new-r-note.md

第二步：编写内容¶

使用标准的 Markdown 语法编写笔记：

# 笔记标题

## 主要内容

这里是笔记的主要内容...

### 代码示例

​```python
def hello_world():
    print("Hello, World!")
​```

!!! note "提示"
    这是一个提示框

第三步：更新导航¶

编辑 mkdocs.yml 文件中的 nav 部分，添加新页面：

nav:
  - 首页: index.md
  - 笔记分类:
    - 根目录:
      - 新笔记: notes/new-note.md

🔄 更新索引¶

使用提供的脚本自动更新索引：

python update_readme.py

./update_notes.bat

🎨 格式化技巧¶

使用提示框¶

MkDocs Material 支持多种提示框：

代码高亮¶

支持多种编程语言的语法高亮：

def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

# 生成随机数据
data <- rnorm(100, mean = 0, sd = 1)
summary(data)

标签页¶

使用标签页组织相关内容：

🚀 部署说明¶

网站使用 GitHub Actions 自动部署：

1. 推送代码到 master 分支
2. GitHub Actions 自动构建 MkDocs 网站
3. 自动部署到 GitHub Pages

📱 移动端优化¶

网站完全响应式设计：

• 手机端 - 侧边栏可折叠
• 平板端 - 适配中等屏幕
• 桌面端 - 充分利用大屏空间

🎉 更多功能¶

• 深色模式 - 点击右上角切换主题
• 目录导航 - 长文章自动生成目录
• 返回顶部 - 长页面自动显示返回按钮
• 编辑链接 - 每页都有 GitHub 编辑链接