多言語サイトを作る — locale で言語別に取得

import { cms } from '../../lib/cms';
import { renderProseMirror } from '@sharedan/cms-sdk';

// 投稿一覧・個別（本文も指定言語で返る）
const { items } = await cms.posts.list('news', { locale: 'en', perPage: 20 });
const post = await cms.posts.get('news', slug, { locale: 'en' });
const html = post.body ? renderProseMirror(post.body) : '';

// FAQ・カテゴリ・固定コンテンツ・フォーム定義・メンテナンス状態も同じ要領
const faqs = await cms.faqs.list({ locale: 'ko' });
const cats = await cms.posts.categories('news', { locale: 'ko' }); // slug は言語共通
const company = await cms.contents.get('company-message', { locale: 'zh-Hant' });
const form = await cms.forms.get('contact', { locale: 'vi' });
const maint = await cms.maintenance.get({ locale: 'en' });

const { items } = await cms.posts.list('news', { locale: 'en' });

for (const p of items) {
  if (p.translation_available === false) {
    // 英語版がまだ無い投稿。原文（日本語）が入っている。
    // 「翻訳準備中」の注記を添えて原文を見せる、などの出し分けに使える。
  }
}
// locale を指定しない（＝原文取得）と translation_available は付かない（undefined）。

// src/lib/locales.ts — ビルド時に「生成してよい言語」を見極める
import { ShareDanCmsApiError } from '@sharedan/cms-sdk';
import { cms } from './cms';

// 出したい候補（APIに渡す locale コード）。原文 ja はルートで別途生成するので含めない。
const CANDIDATES = ['en', 'zh-Hant'];

// 多言語が有効で、かつ運営管理画面で設定済みの言語だけを残す。
export async function resolveExtraLocales() {
  const enabled = [];
  for (const locale of CANDIDATES) {
    try {
      const { items } = await cms.posts.list('news', { perPage: 1, locale });
      // 多言語が有効な公開APIは locale 指定時のレスポンスに translation_available を必ず含める。
      // 付いていなければ（未有効化・旧API）その言語はスキップする。
      if (items[0] && 'translation_available' in items[0]) enabled.push(locale);
    } catch (e) {
      // 無効／未対応の言語は 400（E001008）。その言語は生成しない。
      if (e instanceof ShareDanCmsApiError && e.isBadRequest) continue;
      throw e; // それ以外の実エラーはビルドを止める（壊れたサイトを配信しない）
    }
  }
  return enabled; // 例: ['en', 'zh-Hant']（原文 ja は常にルートで生成）
}

---
// src/pages/[locale]/posts/news/[slug].astro（原文以外の言語ページ）
import { cms } from '../../../../lib/cms';
import { renderProseMirror } from '@sharedan/cms-sdk';
import { resolveExtraLocales } from '../../../../lib/locales';

export async function getStaticPaths() {
  const locales = await resolveExtraLocales();   // ['en', 'zh-Hant'] など（原文 ja は含まない）
  const paths = [];
  for (const locale of locales) {
    const { items } = await cms.posts.list('news', { perPage: 100, locale });
    for (const p of items) {
      paths.push({ params: { locale, slug: p.slug }, props: { locale } });
    }
  }
  return paths;
}

const { locale } = Astro.props;
const post = await cms.posts.get('news', Astro.params.slug, { locale });
const untranslated = post.translation_available === false;
const html = post.body ? renderProseMirror(post.body) : '';
---
<article>
  <h1>{post.title}</h1>
  {untranslated && <p class="untranslated">この記事はまだ翻訳されていません。原文を表示しています。</p>}
  <div set:html={html} />
</article>

// 原文 ja はルート（/…）、他言語は /{locale}/… に置く。
// 同じ記事の各言語版へのリンクを組み立てる。
const localeLink = (code, slug) =>
  code === 'ja' ? '/posts/news/' + slug : '/' + code + '/posts/news/' + slug;

const langs = [
  { code: 'ja', label: '日本語' },
  { code: 'en', label: 'EN' },
  { code: 'zh-Hant', label: '繁中' },
];