diff --git a/AGENTS.md b/AGENTS.md index c581463..2d2b6a5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -19,8 +19,8 @@ redirects.json ──────┘ (含生成的 assets/js/redirects.js 构建后还有一步:`stage_markdown_copies()` 把 `cache/` 下每个 `.md` 复制到 `site/` 同路径(如 `site/nmbot-telegram/mcp.md`),作为每页的 Markdown 版本,供 -`/llms.txt` 链接、“复制本文 Markdown”按钮、View-as-Markdown 菜单项与 AI -打开菜单。 +`/llms.txt` 链接、“复制 Markdown”按钮、View-as-Markdown 菜单项与 AI 打开 +菜单。 `generate()`(`src/nmteam_support/generator.py`)编排的完整链路: diff --git a/README.md b/README.md index e3263dc..63372f6 100644 --- a/README.md +++ b/README.md @@ -69,8 +69,8 @@ Markdown 中仍使用普通图片语法,构建工具会自动输出 WebP 每个链接指向页面的 Markdown 版本。 - 每页 Markdown 版本:`nmteam build` 时在每个页面旁生成同路径的 `.md` 文件 (如 `/nmbot-telegram/mcp.md`)。 -- 页面顶部的文章操作区:**复制本文 Markdown** 直接复制当前页面原文; - **使用[品牌图标]打开本文章** 菜单提供 GitHub 源文件、Markdown 版本, +- 页面顶部的文章操作区(首页不显示):**复制 Markdown** 直接复制当前页面 + 原文;**使用[品牌图标]打开** 菜单提供 GitHub 源文件、Markdown 版本, 以及 Perplexity、Grok、ChatGPT、Claude Web、Claude Desktop、 Claude Code、OpenAI Codex、Cursor 八种 AI 打开方式。 @@ -83,9 +83,16 @@ Markdown 中仍使用普通图片语法,构建工具会自动输出 WebP ```bash uv run nmteam generate # 仅重新生成文档结构 uv run nmteam clean # 清理 cache/、generated/ 和 site/ +uv run nmteam serve # 预览 site/(.md 以 text/plain; charset=utf-8 提供) uv run nmteam --help # 显示完整命令帮助 ``` +`nmteam serve` 默认监听 `127.0.0.1:8124`,可用 `--port` / `--bind` +调整。与裸 `python -m http.server` 不同,它把 `.md` 文件的 +`Content-Type` 显式设为 `text/plain; charset=utf-8`(Python 3.13+ 的 +`mimetypes` 会把 `.md` 判为 `text/markdown`,部分客户端会下载而非内联 +显示),保证每页 Markdown 版本在任何浏览器中都能直接阅读。 + ## 平台启动器 直接运行 `uv run nmteam` 是推荐方式。`scripts/` 也提供不包含业务逻辑的薄启动器;它们会自动定位仓库根目录并原样传递参数。 diff --git a/assets/js/ai-tools.js b/assets/js/ai-tools.js index 705edef..68b6e1a 100644 --- a/assets/js/ai-tools.js +++ b/assets/js/ai-tools.js @@ -105,7 +105,7 @@ button.querySelector(".ai-tools__copy-icon--success").hidden = !copied; button.querySelector(".ai-tools__copy-label").textContent = copied ? "已复制" - : "复制本文 Markdown"; + : "复制 Markdown"; } function wireCopy(button, md, availability) { diff --git a/assets/styles/ai-tools.css b/assets/styles/ai-tools.css index 34e7791..7d6580e 100644 --- a/assets/styles/ai-tools.css +++ b/assets/styles/ai-tools.css @@ -1,7 +1,7 @@ /* Fumadocs-style page actions menu. */ .ai-tools { position: relative; - z-index: 4; + z-index: 1; display: inline-flex; flex-wrap: wrap; align-items: center; @@ -210,9 +210,40 @@ height: 100%; } +@media (max-width: 48em) { + .md-content__inner { + display: flex; + flex-direction: column; + } + + .md-content__inner > h1 { + order: -1; + } + + .md-content__inner > .ai-tools { + order: 0; + float: none; + flex-wrap: nowrap; + width: 100%; + justify-content: flex-start; + margin: 0 0 16px; + } + + .ai-tools__copy, + .ai-tools__trigger { + flex: 0 1 auto; + background: transparent; + border-color: var(--md-default-fg-color--light); + } + + .md-content__inner > :not(h1):not(.ai-tools) { + order: 1; + } +} + @media (max-width: 44.984375em) { .ai-tools { - flex-wrap: nowrap; + flex-wrap: wrap; gap: 6px; margin-right: 4px; } diff --git a/assets/styles/base.css b/assets/styles/base.css new file mode 100644 index 0000000..33766da --- /dev/null +++ b/assets/styles/base.css @@ -0,0 +1,10 @@ +/* Global anchor-link smooth scrolling. */ +html { + scroll-behavior: smooth; +} + +@media (prefers-reduced-motion: reduce) { + html { + scroll-behavior: auto; + } +} diff --git a/docs/nmbot-telegram/index.md b/docs/nmbot-telegram/index.md index e574bff..5dee6c5 100644 --- a/docs/nmbot-telegram/index.md +++ b/docs/nmbot-telegram/index.md @@ -12,17 +12,11 @@ title: nmBot Telegram 帮助文档 欢迎查阅由 nmTeam 官方和 nmBot 社区志愿者编写的 nmBot 官方帮助文档,请从页面导航中或通过搜索框查找您需要的内容。 -
- -![开始使用 nmBot](/assets/images/nmbot/doc%20start%20telegram.png){ width="200" } - - -![开始使用 nmBot](/assets/images/nmbot/doc%20start%20panel.png){ width="200" } - - -![开始使用 nmBot](/assets/images/nmbot/doc%20start%20intro.png){ width="200" } - -
+
+ +[![开始使用 nmBot](/assets/images/nmbot/doc%20start%20telegram.png){ width="200" }](https://t.me/nmnmfunbot) [![开始使用 nmBot](/assets/images/nmbot/doc%20start%20panel.png){ width="200" }](https://nmbot.nmnm.fun) [![开始使用 nmBot](/assets/images/nmbot/doc%20start%20intro.png){ width="200" }](https://nmteam.xyz/products/overview/nmBot-Telegram) + +
## 了解 nmBot 最新动态 diff --git a/mkdocs-template.yml b/mkdocs-template.yml index 6ea2ea3..e2e45a1 100644 --- a/mkdocs-template.yml +++ b/mkdocs-template.yml @@ -34,7 +34,7 @@ theme: - navigation.sections - toc.integrate - navigation.top -extra_css: [assets/styles/docsList.css, assets/styles/plus.css, assets/styles/ai-tools.css] +extra_css: [assets/styles/base.css, assets/styles/docsList.css, assets/styles/plus.css, assets/styles/ai-tools.css] extra_javascript: [assets/js/redirects.js, assets/js/ai-tools.js] docs_dir: generated diff --git a/overrides/.icons/simple/grok.svg b/overrides/.icons/simple/grok.svg new file mode 100644 index 0000000..b90e919 --- /dev/null +++ b/overrides/.icons/simple/grok.svg @@ -0,0 +1 @@ + diff --git a/overrides/partials/actions.html b/overrides/partials/actions.html index 2a7b0f4..343ab41 100644 --- a/overrides/partials/actions.html +++ b/overrides/partials/actions.html @@ -37,7 +37,7 @@ {%- endmacro %} -{% if page %} +{% if page and page.url %} {% set source_url = "https://github.com/nm-Team/Support/blob/main/docs/" ~ page.file.src_uri %}
- 复制本文 Markdown + 复制 Markdown