メインコンテンツまでスキップ

1月以降、docStaticでリリースされた機能

· 約5分
Andrew Owen
Andrew Owen
docStatic maintainer

1月、私はdocStaticの開発状況に関する技術評価を執筆しました。そこでは、docStaticの優れた点、商用CCMSに比べて不足している点、そしてロードマップ上にあった2つの具体的な課題について述べました。 それから6ヶ月が経ち、200件以上のコミットが行われた今、進捗報告を行う時期が来ました。

ロードマップの2項目が実装完了​

1月の時点では、CCMSツールが依然として優位性を保っていた2つの領域として、デプロイの容易さとダッシュボードが挙げられていました。

デプロイに関しては、npx create-docstatic@latest my-site を実行すると、テンプレートがダウンロードされ、プロジェクト名が設定され、git init が実行され、依存関係がインストールされます（ロードマップの「npm を使用してデフォルトのリポジトリを作成する」という項目）。 付属のスクリプトにより、テンプレートはメインサイトのコードと常に同期が保たれます。これはCIおよびpre-commitフックで強制されるため、生成されたスターターによくあるような、スケルトンが古くなってしまうといった事態を防ぎます。

ダッシュボードはもはや概念実証（PoC）の段階ではありません。完全なスイートには、コンテンツ概要、コンテンツの再利用、メディアの使用状況、翻訳ステータス、リンク切れが含まれます。 TinaCMSはメディア使用状況ダッシュボードを非常に高く評価し、独自のバージョンを実装しました。これによりスタイルテンプレートが提供されたため、ダッシュボードは現在、TinaCMS独自のUIと統一されています。しかし、最も重要な変更点は、アドホックなデータ読み込み呼び出し箇所を単一の共有データレイヤーに統合したことです。

まだ不足しているもの​

1月の時点で指摘された2つの制限事項は依然として残っています。

ロールベースのアクセス制御は、依然としてTinaCloudの有料機能であり、docStaticが単独で提供する機能ではありません。

移行ツール（既存のCCMSからのコンテンツインポート）はまだ存在しません。

予定外の機能​

ロードマップには含まれていなかったものの、実装された機能には以下があります：

  • Valeによる散文のリンティング（docStatic独自のスタイル設定付き）。（曖昧な表現、長横線、長すぎる文を検出します）。
  • MCPサーバー。これにより、AIアシスタントは生のMarkdownから推測するのではなく、docStaticのコンテンツやメタデータを直接照会できるようになります。
  • llms.txt：検索エンジンではなく、AIクローラー向けのマニフェスト。
  • チェックボックスが機能する、GitHubスタイルのMarkdownタスクリスト。

構造化された表​

CALSの表モデル（DocBookやDITAで使用されている）がサポートされるようになりました。セルの結合、列ごとの幅設定、きめ細かな枠線の制御が可能です。 執筆者は、CMS内でスプレッドシート風のグラフィカルエディタを使用してセルの結合や分割を行うことができ、手動で表のマークアップを編集する必要はありません。また、CMSのプレビューと公開ページの両方は、同じレンダラーによって生成されます。詳細については、CALS表のガイドをご覧ください。

翻訳​

最大の更新点は翻訳機能です。ドキュメントは、英語とフランス語に加え、ドイツ語、スペイン語、日本語でも利用可能になりました。翻訳ダッシュボードでは、XLIFFのエクスポートおよびインポートが可能です。 DeepLを活用した翻訳スクリプトが追加され、古いセグメントをエクスポートし、コードフェンスやコンポーネントのマークアップはそのままに文章部分を機械翻訳した後、再インポートを行うことで、「翻訳運用をコードとして扱う（translation-ops-as-code）」というコンセプトを実現しました。

コードの堅牢化​

コードベース全体が Biome によるリンティングの対象となり、回帰バグを防ぐためのテストスイートが追加されました。

今後の予定​

現在、4つの機能強化リクエストが未処理となっています：

  • AI チャットボット。これは概念実証（PoC）として WebLLM を使用して実装される予定です。 商用LLMサーバーに置き換えるのも比較的簡単であるはずです。
  • 管理型URLコンポーネント：通常、URLは翻訳されません。このコンポーネントにより、ローカライズされた外部リンクの管理が容易になります。
  • アナリティクス：設定UIからMatomoやGoogle Analyticsを簡単に設定できる機能。
  • フィードバックコンポーネント：分析機能をトリガーする「いいね／嫌い」コンポーネント。

現時点でdocStaticはどのようなチームに最適か？​

開発者以外のメンバーによる実際の作成・レビューが可能な、Gitネイティブのドキュメントプラットフォームを求めるエンジニア主導のチームには、依然として最適です。現在では、複数の言語で公開を行うチーム向けの堅牢な翻訳パイプラインも備えています。 ロールベースのアクセス制御やPDF機能が必要なチームにとっては、依然として不適切な選択肢です。ただし、ドキュメントの移行やベンダーによるサポートが必要な場合は、ぜひご連絡ください。