mkdocs.yml

# 项目设置
site_name: 笔记
site_url: https://yoolc.github.io/notes
repo_name: YooLc/notes
repo_url: https://github.com/YooLc/notes
edit_uri: -/tree/main/docs/
site_description: Yet another Futsū no Material for MkDocs site
site_author: YooLc
copyright: YooLc 🄯 Copyleft 2024 - 2025

nav:
  - 首页:
    - index.md
  - "🔥 博客":
    - blog/index.md
  - "📝 课程笔记":
    - 大三:
      - 计算机体系结构:
        - courses/24fall/computer-architecture/index.md
        - courses/24fall/computer-architecture/chapter-1.md
        - courses/24fall/computer-architecture/chapter-2.md
        - courses/24fall/computer-architecture/chapter-3.md
        - courses/24fall/computer-architecture/chapter-4.md
        - courses/24fall/computer-architecture/chapter-5.md
      - 汇编与接口:
        - courses/24fall/assembly-and-interface/index.md
        - courses/24fall/assembly-and-interface/chapter-1.md
        - courses/24fall/assembly-and-interface/chapter-2.md
        - courses/24fall/assembly-and-interface/chapter-3.md
        - courses/24fall/assembly-and-interface/chapter-4-6.md
        - courses/24fall/assembly-and-interface/chapter-9-11.md
        - courses/24fall/assembly-and-interface/note.md
        - courses/24fall/assembly-and-interface/final.md
      - 应用运筹学基础:
        - courses/24fall/applied-operations-research/index.md
      - 计算机网络:
        - courses/24fall/computer-network/index.md
      - 操作系统:
        - courses/24fall/operating-system/index.md
        - courses/24fall/operating-system/note.md
      - 编程语言原理:
        - courses/24fall/principles-of-programming-languages/index.md
        - courses/24fall/principles-of-programming-languages/practice.md
      - 计算理论:
        - courses/24fall/theory-of-computation/index.md
        - courses/24fall/theory-of-computation/undecidability.md
  # - "🛠️ 计算机科学":
  #   - computer-science/index.md
  - "🚀 体系结构":
    - architecture/index.md
    - "CPU 微架构梳理":
      - architecture/cpu-uarch/index.md
      - architecture/cpu-uarch/Intel/index.md
      - architecture/cpu-uarch/AMD/index.md
    - "向量化指令扩展":
      - "ARM":
        - architecture/simd/ARM/neon.md
        - architecture/simd/ARM/sve.md
      - architecture/simd/riscv.md   

theme:
  name: material
  custom_dir: overrides
  language: zh
  # logo:
  # favicon:
  icon:
    repo: fontawesome/brands/github
  # 自适应主题
  palette:
    - media: "(prefers-color-scheme: light)" 
      scheme: goblue
      toggle:
        icon: material/weather-sunny
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"  
      scheme: slate
      toggle:
        icon: material/weather-night
        name: Switch to light mode
  font:
    text: LXGW WenKai Screen
    code: JetBrains Mono
  features:
    - announce.dismiss
    # 代码块操作
    - content.code.copy
    - content.code.select
    - content.code.annotate
    # 底部导航
    - navigation.footer
    # 顶部导航
    - navigation.tabs
    # 侧边栏按 section 展开
    - navigation.indexes
    - navigation.sections
    # - navigation.expand
    # 章节首页
    - navigation.indexes
    # 锚点
    - navigation.tracking
    # 路径
    - navigation.path
    - navigation.instant.prefetch
    - navigation.instant.progress
    # 回到顶部
    - navigation.top
    - toc.follow
    # 页面编辑
    - content.action.edit
    # 搜索
    - search.suggest
    - search.highlight
    - search.share

markdown_extensions:
  # Admonition
  - admonition
  - pymdownx.details
  - pymdownx.superfences:
      # Mermaid
      custom_fences:
        - name: mermaid
          class: mermaid
          format:
            !!python/name:pymdownx.superfences.fence_code_format # Code Block

  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  # Tab Card
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  # Grid, Image
  - attr_list
  - md_in_html
  # Icon
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg # List

  - def_list
  - pymdownx.tasklist:
      custom_checkbox: true
  # TOC
  - toc:
      permalink: true
  # 中文锚点
      slugify: !!python/object/apply:pymdownx.slugs.slugify
        kwds:
          case: lower
  # MathJax
  - pymdownx.arithmatex:
      generic: true
  # Keys
  - pymdownx.keys
  # Highlight
  - pymdownx.critic
  # 时间轴、甘特图
  - neoteroi.timeline
  - neoteroi.projects

extra_javascript:
  # MathJax
  - javascripts/mathjax.js
  - https://polyfill.alicdn.com/polyfill.min.js?features=es6
  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
  # Table Sort
  # - https://unpkg.com/tablesort@5.3.0/dist/tablesort.min.js
  # - javascripts/tablesort.js

extra_css:
  - fonts/fonts.css
  - stylesheets/auto_counter.css
  - stylesheets/theme.css
  - stylesheets/mkdocs-plugins-v1.1.0.css
  - stylesheets/md-post.css
  - https://cdnjs.cloudflare.com/ajax/libs/lxgw-wenkai-screen-webfont/1.7.0/style.css

plugins:
  - git-revision-date-localized:
      type: datetime
      timezone: Asia/Shanghai
      locale: zh
      enable_creation_date: true
  - glightbox
  - drawio_file
  - tags:
      tags_file: index.md
  - search
  - rss:
      match_path: blog/posts/.* 
      date_from_meta:
        as_creation: date
      categories:
        - categories
        - tags
  - include_dir_to_nav:
      recurse: false
  - blog:
      archive_toc: true
      post_excerpt: required