feat(RevisionBlock): replace dir="v" to vertical attribute (#2)

Author: std-microblock

.github/workflows/migrate.yml

@@ -0,0 +1,49 @@
+name: Migrate cppreference pages
+
+on:
+  issues:
+    types:
+      - opened
+      - labeled
+  workflow_dispatch:
+    inputs:
+      issue_number:
+        description: "Specific issue number to process (optional)"
+        required: false
+        type: string
+
+jobs:
+  migrate:
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name == 'workflow_dispatch' ||
+      (github.event_name == 'issues' &&
+        (github.event.action == 'opened' || github.event.action == 'labeled') &&
+        contains(github.event.issue.labels.*.name, 'migrate-cppref-page'))
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run migration bot
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
+        run: npm run migrate

migrate/PROMPT.md

@@ -0,0 +1,18 @@
+You are a professional C++ documentation writer. You are now migrating cppreference.com documentation from HTML format to MDX format. During this process, you must adhere to the following rules:
+1. Only migrate the format, ensuring that the text of the migrated result is **exactly the same** as the original. Of course, you don't need to process text that was originally invisible.
+2. When using the pre-provided component library, import and only import the component you used. Do not try to write your own component. Do not try to write your own component. Do not try to write your own component. DO NOT USE NORMAL HTML ELEMENTS. Replace them with our MDX component.
+3. For links, take the URL part, remove `/w/` and the latter part `.html`, and then wrap it with `DocLink`. For example:
+If the current path is: `/w/cpp/language/basics.html`
+Link: `<a href="declarations.html" title="cpp/language/declarations">declarations</a>`
+You should, based on the current link, change it to: `<DocLink src="/cpp/language/declarations">declarations</DocLink>`
+4. Currently available components:
+```mdx
+{{LLM_DOCS}}
+```
+
+## Note: The above content is all part of the component library examples. Do not confuse it with the actual content that needs to be migrated.
+
+The original content will be provided in the following format:
+// URL: Original page link
+Original page content
+Please proceed with the migration.

migrate/migrate-bot.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+
+import { Octokit } from "@octokit/rest";
+import { JSDOM } from "jsdom";
+import fs, { readFile } from "fs/promises";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
+const OPENROUTER_API_KEY = process.env.OPENROUTER_API_KEY;
+const REPO_OWNER = process.env.GITHUB_REPOSITORY_OWNER || "owner";
+const REPO_NAME = process.env.GITHUB_REPOSITORY?.split("/")[1] || "cppdoc";
+const LABEL = "migrate-cppref-page";
+
+if (!GITHUB_TOKEN) {
+  console.error("Missing GITHUB_TOKEN");
+  process.exit(1);
+}
+if (!OPENROUTER_API_KEY) {
+  console.error("Missing OPENROUTER_API_KEY");
+  process.exit(1);
+}
+
+const octokit = new Octokit({ auth: GITHUB_TOKEN });
+
+function extractLink(title) {
+  const urlRegex = /https?:\/\/en\.cppreference\.com\/w\/[^\s]+/g;
+  const match = title.match(urlRegex);
+  return match ? match[0] : null;
+}
+
+function hasPRReference(title) {
+  return /\[#\d+\]/.test(title);
+}
+
+async function fetchPageContent(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch ${url}: ${response.status}`);
+  }
+  const html = await response.text();
+  const dom = new JSDOM(html);
+  const contentElement = dom.window.document.querySelector("#mw-content-text");
+  const headingElement = dom.window.document.querySelector("#firstHeading");
+  if (!contentElement) {
+    throw new Error("Could not find #mw-content-text");
+  }
+  return {
+    html: contentElement.innerHTML,
+    title: headingElement?.textContent?.trim() || "",
+    url,
+  };
+}
+
+async function convertToMDX(html, title, url) {
+  const prompt = await readFile(__dirname + "/PROMPT.md", "utf8").replace(
+    "{{LLM_DOCS}}",
+    await readFile(
+      __dirname +
+        "/../src/content/docs/development/guide/component-docs-for-llm.mdx",
+      "utf8",
+    ),
+  );
+
+  const response = await fetch(
+    "https://openrouter.ai/api/v1/chat/completions",
+    {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${OPENROUTER_API_KEY}`,
+        "Content-Type": "application/json",
+        "HTTP-Referer": "https://github.com/cppdoc/cppdoc",
+        "X-Title": "CppDoc Migration Bot",
+      },
+      body: JSON.stringify({
+        model: "deepseek/deepseek-v3.2",
+        messages: [
+          { role: "system", content: prompt },
+          {
+            role: "user",
+            content: `
+// Convert the following HTML content from cppreference.com into MDX format suitable for CppDoc.
+// Title: ${title}
+// URL: ${url}
+// HTML Content:
+${html}
+`,
+          },
+        ],
+      }),
+    },
+  );
+
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`OpenRouter API error: ${error}`);
+  }
+
+  const data = await response.json();
+  return data.choices[0].message.content.trim();
+}
+
+function getLocalPath(url) {
+  // https://en.cppreference.com/w/cpp/comments.html -> src/content/docs/cpp/comments.mdx
+  const match = url.match(/https?:\/\/en\.cppreference\.com\/w\/(.+)\.html$/);
+  if (!match) {
+    throw new Error(`无法从URL解析路径: ${url}`);
+  }
+  const relative = match[1]; // "cpp/comments"
+  return path.join(
+    __dirname,
+    "..",
+    "src",
+    "content",
+    "docs",
+    `${relative}.mdx`,
+  );
+}
+
+async function writeMDXFile(filePath, content, title) {
+  const dir = path.dirname(filePath);
+  await fs.mkdir(dir, { recursive: true });
+  const frontmatter = `---
+title: ${title}
+description: Auto‑generated from cppreference
+---\n\n`;
+  await fs.writeFile(filePath, frontmatter + content, "utf8");
+  console.log(`写入 ${filePath}`);
+}
+
+async function createPullRequest(issue, filePath, url) {
+  const branchName = `migrate/${issue.number}-${Date.now().toString(36)}`;
+  const commitMessage = `Migrate ${url}`;
+  const prTitle = `[#${issue.number}] Migrate ${url}`;
+  const prBody = `自动迁移自 ${url}\n\nclose #${issue.number}`;
+
+  const { execSync } = await import("child_process");
+  try {
+    execSync(`git config user.name "github-actions[bot]"`);
+    execSync(
+      `git config user.email "github-actions[bot]@users.noreply.github.com"`,
+    );
+    execSync(`git checkout -b ${branchName}`);
+    execSync(`git add "${filePath}"`);
+    execSync(`git commit -m "${commitMessage}"`);
+    execSync(`git push origin ${branchName}`);
+  } catch (error) {
+    console.error("Git操作失败:", error.message);
+    throw error;
+  }
+
+  const { data: pr } = await octokit.pulls.create({
+    owner: REPO_OWNER,
+    repo: REPO_NAME,
+    title: prTitle,
+    body: prBody,
+    head: branchName,
+    base: "main",
+  });
+
+  console.log(`创建PR #${pr.number}`);
+  return pr.number;
+}
+
+async function updateIssue(issue, prNumber, error = null) {
+  const newTitle = `[#${prNumber}] ${issue.title.replace(/\[#\d+\]\s*/, "")}`;
+  await octokit.issues.update({
+    owner: REPO_OWNER,
+    repo: REPO_NAME,
+    issue_number: issue.number,
+    title: newTitle,
+  });
+
+  if (error) {
+    await octokit.issues.createComment({
+      owner: REPO_OWNER,
+      repo: REPO_NAME,
+      issue_number: issue.number,
+      body: `迁移失败: ${error.message}\n\n已关闭issue。`,
+    });
+    await octokit.issues.update({
+      owner: REPO_OWNER,
+      repo: REPO_NAME,
+      issue_number: issue.number,
+      state: "closed",
+    });
+  } else {
+    await octokit.issues.createComment({
+      owner: REPO_OWNER,
+      repo: REPO_NAME,
+      issue_number: issue.number,
+      body: `迁移完成！已创建PR [#${prNumber}].`,
+    });
+  }
+}
+
+async function main() {
+  console.log("获取带有标签", LABEL, "的issue...");
+  const { data: issues } = await octokit.issues.listForRepo({
+    owner: REPO_OWNER,
+    repo: REPO_NAME,
+    labels: LABEL,
+    state: "open",
+    per_page: 50,
+  });
+
+  console.log(`找到 ${issues.length} 个issue`);
+
+  for (const issue of issues) {
+    console.log(`处理issue #${issue.number}: ${issue.title}`);
+    try {
+      if (hasPRReference(issue.title)) {
+        continue;
+      }
+
+      const url = extractLink(issue.title);
+      if (!url) {
+        throw new Error("标题中未找到有效的cppreference链接");
+      }
+
+      // 获取页面内容
+      console.log(`  获取 ${url}`);
+      const { html, title } = await fetchPageContent(url);
+
+      // 转换为MDX
+      console.log(`  转换HTML为MDX...`);
+      const mdx = await convertToMDX(html, title, url);
+
+      // 写入文件
+      const filePath = getLocalPath(url);
+      console.log(`  写入 ${filePath}`);
+      await writeMDXFile(filePath, mdx, title);
+
+      // 创建PR
+      console.log(`  创建PR...`);
+      const prNumber = await createPullRequest(issue, filePath, url);
+
+      // 更新issue
+      console.log(`  更新issue...`);
+      await updateIssue(issue, prNumber);
+
+      console.log(`  issue #${issue.number} 完成`);
+    } catch (error) {
+      console.error(`  issue #${issue.number} 出错:`, error);
+      await updateIssue(issue, null, error);
+    }
+  }
+
+  console.log("全部完成");
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});