mkdocs.yml

site_name: AstraEditor Document
site_url: https://docs.astras.top
repo_url: https://github.com/AstraEditor/scratch-gui
repo_name: AstraEditor/scratch-gui
edit_uri: edit/main/src/

site_description: AstraEditor Document

nav:
  - 主页: index.md
  - 基础: 
    - website/index.md
    - 不再加载私有作品: website/unshared-projects.md
    - 云变量: website/cloud-variables.md
    - 高级设置: 
      - website/settings/index.md
      - 自定义帧率: website/settings/custom-fps.md
      - 动画插帧: website/settings/interpolation.md
      - 高清画笔: website/settings/high-quality-pen.md
      - 移除舞台边缘: website/settings/remove-fencing.md
      - 移除其他限制: website/settings/remove-misc-limits.md
      - 无限克隆: website/settings/infinite-clones.md
      - 循环计时器: website/settings/warp-timer.md
      - 自定义舞台大小: website/settings/custom-stage-size.md
      - 禁用编译器: website/settings/disable-compiler.md
    - 新编译器: website/new-compiler.md
    - 嵌入作品: website/embedding.md
    - 为啥TW内核这么快?: website/how-it-works.md
    - 怎么下载编译后的JS代码?: website/javascript.md
    - 自定义返回值: website/return.md
    - CORS问题: website/cors.md
    - TW块: website/turbowarp-blocks.md
    - 为TW提供翻译: website/translate.md
    - URL参数: website/url-parameters.md
    - Scratch账户&该编辑器: website/scratch-accounts.md
    - 赞助: website/donate.md
  - 特色:
    - features/index.md
    - README: features/readme.md
  - 打包:
    - packager/index.md
    - 嵌入: packager/embedding.md
    - 商业使用: packager/commercial-use.md
    - 动态舞台尺寸: packager/dynamic-stage-resize.md
    - 特殊的云变量: packager/special-cloud-behaviors.md
    - 离线打包器: packager/offline.md
  - 插件:
    - addons/index.md
    - TurboWarp插件:
      - addons/turbowarp/index.md
      - 猫积木: addons/turbowarp/cat-blocks.md
  - 开发:
    - development/index.md
    - 基础扩展教程:
      - 介绍: development/extensions/index.md
      - 你好，世界!: development/extensions/hello-world.md
      - 处理输入: development/extensions/inputs.md
      - 异步函数: development/extensions/async.md
      - 沙盒: development/extensions/sandbox.md
      - 非沙盒扩展: development/extensions/unsandboxed.md
      - 开发服务器: development/extensions/better-development-server.md
      - 各种API: development/extensions/assorted-apis.md
      - 事件&头代码: development/extensions/hats.md
      - 保持兼容: development/extensions/compatibility.md
      - 分享你的扩展: development/extensions/share.md
      - 结尾: development/extensions/wrapping-up.md
    - Mod 介绍: development/getting-started.md
    - 全局变量: development/globals.md
    - Scratch X & TurboWarp: development/scratchx.md
  - 编辑器:
    - editor/index.md
  - 博客:
    - blog/index.md
    - blog/tags.md

theme: 
  name: material
  custom_dir: overrides
  language: zh
  logo: assets/favicon.ico
  favicon: assets/favicon.ico

  icon:
    previous: fontawesome/solid/angle-left
    next: fontawesome/solid/angle-right
    repo: fontawesome/brands/github
    annotation: material/help-circle
    admonition:
      note: fontawesome/solid/note-sticky
      abstract: fontawesome/solid/book
      info: fontawesome/solid/circle-info
      tip: fontawesome/solid/bullhorn
      success: fontawesome/solid/check
      question: fontawesome/solid/circle-question
      warning: fontawesome/solid/triangle-exclamation
      failure: fontawesome/solid/bomb
      danger: fontawesome/solid/skull
      bug: fontawesome/solid/robot
      example: fontawesome/solid/flask
      quote: fontawesome/solid/quote-left

  features:
    - navigation.instant
    - navigation.instant.prefetch
    - navigation.instant.progress
    - navigation.instant.preview
    - navigation.tracking
    - navigation.tabs
    - navigation.path
    - navigation.prune 
    - navigation.indexes
    - toc.follow
    - navigation.top
    - search.suggest
    - search.highlight
    - search.share
    - navigation.footer
    - content.code.copy
    - content.code.select
    - content.footnote.tooltips
    - content.tooltips
    - announce.dismiss
    - content.tabs.link
    - content.code.annotate 
    - content.action.edit
    - content.action.view

  palette:
    # Palette toggle for light mode
    - scheme: default
      toggle:
        icon: material/brightness-7 
        name: 切换为夜间模式
        primary: custom

    # Palette toggle for dark mode
    - scheme: slate
      toggle:
        icon: material/brightness-4
        name: 切换为日间模式
        primary: custom

plugins:
  - search
  - blog:
      archive_date_format: MMMM yyyy
      archive_url_date_format: MMMM/dd/yyyy
      authors_profiles: true
  - tags:
      tags_file: blog/tags.md
  - privacy
  - git-authors

extra_css:
  - style/style.css

extra_javascript:
  - https://unpkg.com/tablesort@5.3.0/dist/tablesort.min.js

copyright: >
  Copyright &copy; 2025 - present, Astras Team all right reserved.<br>
  <a href="#__consent">修改cookie设置</a>

extra:
  homepage: https://editor.astras.top
  generator: false
  social:
    - icon: fontawesome/brands/github 
      link: https://github.com/AstraEditor
      name: AstraEditor Organization
    - icon: fontawesome/brands/bilibili
      link: https://space.bilibili.com/3691007061264515
      name: AstrasOfficial's Bilibili
    - icon: fontawesome/solid/paper-plane
      link: mailto:2381068747@qq.com
      name: Astras Team's Email
  consent:
    title: Cookies隐私政策
    description: >- 
      我们使用Cookies(是饼干哦！)来识别您的重复访问和偏好，以及测量我们的文档是否有效以及用户是否找到他们正在搜索的内容。通过您的同意，您正在帮助我们改进我们的文档。
    actions:
      - accept
      - manage
      - reject
  alternate:
  - name: 简体中文
    link: /
    lang: zh
  - name: English
    link: /en/ 
    lang: en

markdown_extensions:
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.superfences
  - footnotes
  - abbr
  - attr_list
  - md_in_html
  - pymdownx.blocks.caption
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - md_in_html
  - admonition
  - pymdownx.details
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true