Skip to content
/ API Public template

Use Markdown image syntax in README and make coverpage content the VitePress homepage#4

Open
Copilot wants to merge 5 commits intomasterfrom
copilot/update-to-vitepress
Open

Use Markdown image syntax in README and make coverpage content the VitePress homepage#4
Copilot wants to merge 5 commits intomasterfrom
copilot/update-to-vitepress

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 29, 2026

  • 先执行当前文档构建,确认基线通过
  • 定位并确认 Docsify 入口与静态资源引用
  • 最小范围删除 Docsify 环境相关文件与配置
  • 运行文档构建验证改动不破坏 VitePress
  • 复查变更范围并提交

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 29, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
api-tmwy Error Error Mar 29, 2026 2:57am

@insoxin insoxin marked this pull request as ready for review March 29, 2026 02:54
Copilot AI review requested due to automatic review settings March 29, 2026 02:54
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 07b6126489

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

description: '姬长信API 一个基于多种编程语言并运行在Docker上开源免费不限制提供生活常用、出行服务、开发工具、金融服务、通讯服务和公益大数据的平台。',
ignoreDeadLinks: true,
markdown: {
html: false
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Re-enable HTML rendering for markdown content

Setting markdown.html to false escapes raw HTML in every Markdown page, but this docs set already depends on inline HTML for user-visible content (for example, pages like 壁纸模块.md include <img ...> blocks outside code fences). With this option disabled, those sections render as literal tags instead of images/embeds, which is a broad functional regression in the migrated VitePress site.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR migrates the documentation presentation toward VitePress by introducing a VitePress homepage (index.md) based on the existing Docsify coverpage content and standardizing README images to Markdown syntax, along with adding a Node/VitePress build pipeline for GitHub Pages.

Changes:

  • Add VitePress tooling/config (package.json, lockfile, .vitepress/config.ts) and update GitHub Pages workflow to build/deploy .vitepress/dist.
  • Add root index.md populated with _coverpage.md content so / renders that content in VitePress.
  • Replace HTML <img> tags in README.md with Markdown image syntax and add .gitignore entries for Node/VitePress artifacts.

Reviewed changes

Copilot reviewed 5 out of 7 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
package.json Introduces VitePress scripts/dependency for local dev/build and CI.
package-lock.json Locks VitePress (and transitive) dependencies for reproducible CI builds.
index.md New VitePress homepage content mirroring existing coverpage text.
README.md Normalizes traffic-card images to Markdown image syntax.
.vitepress/config.ts Adds VitePress site config, navigation/sidebar, and head scripts.
.gitignore Ignores node_modules, logs, and VitePress build output.
.github/workflows/pages.yml Switches Pages deployment to a Node-based VitePress build + deploy flow.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

export default defineConfig({
lang: 'zh-CN',
title: '姬长信API For Docker官方文档',
description: '姬长信API 一个基于多种编程语言并运行在Docker上开源免费不限制提供生活常用、出行服务、开发工具、金融服务、通讯服务和公益大数据的平台。',
Copy link

Copilot AI Mar 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The VitePress config doesn’t set base. When deploying to GitHub Pages for a project repo (e.g. /API/), VitePress will otherwise generate asset links rooted at /, which typically breaks CSS/JS on the published site. Consider setting base appropriately (or deriving it from an env var in CI) to match the Pages URL.

Suggested change
description: '姬长信API 一个基于多种编程语言并运行在Docker上开源免费不限制提供生活常用、出行服务、开发工具、金融服务、通讯服务和公益大数据的平台。',
description: '姬长信API 一个基于多种编程语言并运行在Docker上开源免费不限制提供生活常用、出行服务、开发工具、金融服务、通讯服务和公益大数据的平台。',
base:
process.env.DOCS_BASE ||
(process.env.GITHUB_REPOSITORY
? '/' + process.env.GITHUB_REPOSITORY.split('/')[1] + '/'
: '/'),

Copilot uses AI. Check for mistakes.
Comment on lines +1 to +2
# 姬长信 API For Docker <small>始于 2017</small>

Copy link

Copilot AI Mar 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This heading uses an inline HTML <small> tag. With the current VitePress config (markdown.html: false), it will be escaped and shown as text; even with HTML enabled it can affect the generated heading id/anchor. Consider rewriting this as pure Markdown (e.g., move “始于 2017” to a separate line) to avoid rendering/anchor issues.

Suggested change
# 姬长信 API For Docker <small>始于 2017</small>
# 姬长信 API For Docker
_始于 2017_

Copilot uses AI. Check for mistakes.
* 条款:姬长信 API 拥有所有运行权,在某些特定情况下有权禁止你的网站调用。
* 禁止用于违法、商业用途,不接受定制功能性捐助!
[GitHub](https://github.com/insoxin/API/)
[开始](#姬长信api-for-docker)
Copy link

Copilot AI Mar 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[开始](#姬长信api-for-docker) is very likely to be a broken in-page anchor in VitePress because heading ids are slugified (typically inserting hyphens and including additional heading text). Consider linking to a real route (e.g. the first doc page like /公益中国) or updating the hash to match the actual generated heading id.

Suggested change
[开始](#姬长信api-for-docker)
[开始](#姬长信-api-for-docker-始于-2017)

Copilot uses AI. Check for mistakes.
},
"keywords": [],
"author": "",
"license": "ISC",
Copy link

Copilot AI Mar 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

license is set to ISC, but the repository LICENSE file is GNU AGPLv3. This package metadata should match the repo’s actual license (e.g. AGPL-3.0-or-later) to avoid publishing incorrect licensing information.

Suggested change
"license": "ISC",
"license": "AGPL-3.0-or-later",

Copilot uses AI. Check for mistakes.
description: '姬长信API 一个基于多种编程语言并运行在Docker上开源免费不限制提供生活常用、出行服务、开发工具、金融服务、通讯服务和公益大数据的平台。',
ignoreDeadLinks: true,
markdown: {
html: false
Copy link

Copilot AI Mar 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

markdown.html is set to false, but many existing Markdown pages in this repo include raw HTML (e.g., <img ...>). With HTML disabled, those tags will render as literal text and break the docs layout across multiple pages. Either remove this override / set markdown.html: true, or migrate all existing pages away from raw HTML before disabling it.

Suggested change
html: false
html: true

Copilot uses AI. Check for mistakes.
Agent-Logs-Url: https://github.com/insoxin/API/sessions/02f46b2e-7093-484b-b7b4-9ac478f72a9f

Co-authored-by: insoxin <19371836+insoxin@users.noreply.github.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages bot commented Mar 29, 2026

Deploying api with  Cloudflare Pages  Cloudflare Pages

Latest commit: 0e08605
Status:⚡️  Build in progress...

View logs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants