BoKビルディング

従来の構造化データは機械処理には向いていますが、人間にとっては読みにくく、学習・理解には適しません。

逆に、人間中心のドキュメントは、AIにとっては文脈を把握しにくいことがあります。

SimpleModelingではこのギャップを埋めるBoKの設計を目指します。

以下のようなWeb標準のメタ情報を活用し、ページ単位で意味づけを明示します。

これらを丁寧に設計・設定することで、検索エンジンやAIがより高精度に文書の意味を理解できます。

リンク構造や分類体系も、知識の一部です。以下の仕組みを整備することでBoKの明瞭化を図ります。

用語は文脈に応じて意味が変わります。文脈を明示できれば、AIはより正確に用語の意味を把握できます。

SimpleModeling.orgは、こうしたオントロジー技術と生成AIを連携させる実験の場でもあります。

SmartDoxは、SimpleModeling.orgの主宰者である浅海が開発した、Markdownの軽快さにAsciidocやOrg-modeの構造表現力を融合した独自の文書記法とオープンソースの文書処理系です。

複数のSmartDoxファイルを階層的にまとめることで、1つのサイト構造(SmartDoxサイト)を形成できます。

このSmartDoxサイトを元に、以下の2種類の出力を生成できます：

SmartDoxサイトは、階層ディレクトリにSmartDox文書とメタデータのテキストファイルを配置する構成のため、Gitなどのテキストベースのバージョン管理システムで管理できます。

データベースなどの特別なミドルウェアは不要で、階層ディレクトリとメタデータからサイトの構造を自動的に読み取り、適切にデータ化されます。

用語集やキーワードに対しては、自動的にリンクが貼られ、BoKとしての可読性とAI解釈性の両立が実現されます。

Arcadiaは浅海が開発したオープンソースの静的サイトジェネレータ(SSG)です。 Bootstrap 5ベースのレスポンシブなWebページを生成します。

SimpleModeling.orgでは、ArcadiaとAntoraを以下のように使い分けています：

Asciidocは技術文書向けに広く使われているマークアップ言語で、Antoraはその文書群をナビゲーション付きサイトとして構築するためのツールです。

SmartDoxからAntora互換のAsciidocを生成することで、BoK全体をAntoraによって技術文章の公開に適したWebサイトに編成することができます。

またAntora/Asciidocは広く使われているので、AIによるWebサイトの解析にも有利に働くことが期待できます。

プロジェクト内部用BoKであれば、Arcadiaを使わずにSmartDox + Antoraのみで完結できます。

データベースを用いた動的生成型サイトは、コンテンツの構造がリクエスト時に動的に生成されるため、BoKのソースとしては構造把握が難しく、不利です。

またAngularやReactなどのJavaScriptフレームワークを用いたSPA(Single Page Application)形式のサイトもDOMがクライアント側で動的に構築されるため、検索エンジンやAIがHTML構造を直接解析するには不向きです。

特にAIがBoKを学習・解釈する際には構造が明示されたHTMLやマークアップを静的に取得できることが重要です。静的HTMLであればリンク構造や文書階層、用語の位置づけなどをAIが高精度に理解できます。

BoKビルディングにおいては、SSG(静的サイトジェネレータ)による構造化・明示的な知識の公開が、AIとの連携において極めて重要です。

SimpleModeling.orgでは、こうした要件に対応するために、ArcadiaやAntoraといった静的サイト生成技術を採用し、構造的に整理されたBoKを確実にAIに届ける仕組みを構築しています。

また、開発者にとっての可読性や使いやすさを高めるために、CSSやJavaScriptの最新技術を静的構造と共存させることで、視認性とビジュアル性を損なうことなく表現力を強化しています。

これにより、人間とAIの両方にとって扱いやすく、構造的かつ直感的に理解可能なハイブリッドなBoKサイトが実現されています。