Docusaurus Sidebar のカウント機能の高度な実装：再帰的集計と安定した slug

/**
 * 指定ディレクトリ以下の全ての Markdown (.md) ファイルを再帰的にカウントする。
 * 隠しファイル（先頭が '.'）や '_category_.json' は無視する。
 *
 * @param {string} dirPath - 対象ディレクトリの絶対パス。
 * @returns {number} 見つかった Markdown ファイルの合計数。
 */
function countMarkdownFiles(dirPath) {
  let count = 0;

  // 現在のディレクトリ内の全項目（ファイルとサブディレクトリ）を取得
  for (const name of fs.readdirSync(dirPath)) {
    // 隠しファイルと _category_.json 設定ファイルを除外
    if (name.startsWith(".") || name === "_category_.json") continue;

    const fullPath = path.join(dirPath, name); // フルパスを取得
    const stat = fs.statSync(fullPath); // ファイルまたはディレクトリの状態を取得

    if (stat.isDirectory()) {
      // ディレクトリなら再帰的に中の Markdown 数をカウント
      count += countMarkdownFiles(fullPath);
    } else if (stat.isFile() && name.endsWith(".md")) {
      // Markdown ファイルならカウントを増やす
      count += 1;
    }
  }

  return count;
}

/**
 * 相対 POSIX パスを URL 安全な slug に変換する。
 * スラッシュを正規化し、encodeURIComponent を適用してクロスプラットフォームで一貫した slug を保証。
 *
 * @param {string} relPath - 'classic-cnns/vgg' のような相対パス。
 * @returns {string} 'classic-cnns/vgg' のようにエンコードされた URL slug。
 */
function toSlug(relPath) {
  return relPath
    .replace(/\\/g, "/") // Windows のバックスラッシュを POSIX スタイルのスラッシュに置換
    .split("/") // 各ディレクトリ階層に分割
    .map(encodeURIComponent) // 各セグメントを URL エンコード
    .join("/"); // スラッシュで再結合し、安定した slug を作成
}

const defaultSlug = `/category/${toSlug(relativeDirPath)}`;

const link = {
  type: "generated-index",
  slug: metadata.link?.slug || defaultSlug, // カスタム slug があれば優先、なければフォールバック
  title: metadata.link?.title || baseLabel,
  ...metadata.link, // description などその他のフィールドを保持
};

/**
 * サブディレクトリを並び替える：
 * - `_category_.json` を含むフォルダを先頭に
 * - その他はアルファベット順
 *
 * @param {string} dir - 親ディレクトリの絶対パス
 * @returns {string[]} 並び替えられたサブディレクトリ名の配列
 */
function getSortedSubDirs(dir) {
  return fs
    .readdirSync(dir)
    .filter((name) => {
      const fullPath = path.join(dir, name);
      return !name.startsWith(".") && fs.statSync(fullPath).isDirectory();
    })
    .sort((a, b) => {
      const aHasCategory = fs.existsSync(path.join(dir, a, "_category_.json"));
      const bHasCategory = fs.existsSync(path.join(dir, b, "_category_.json"));

      // _category_.json があるフォルダを先に
      if (aHasCategory && !bHasCategory) return -1;
      if (bHasCategory && !aHasCategory) return 1;

      // それ以外はアルファベット順
      return a.localeCompare(b);
    });
}