オープンソース
Show HN: Kiso、オープンナレッジフォーマット向けオープンソースパブリッシングエンジン
Show HN: Kiso, an open-source publishing engine for Open Knowledge Format (oak-invest.github.io)
要約
Kisoは、オープンナレッジフォーマット(OKF)バンドルを人間とAIエージェント向けの静的ウェブサイトに変換するパブリッシングエンジンです。OKFを信頼できる情報源とし、Markdownで知識を編集・管理し、明示的なメタデータとエージェントフレンドリーなHTMLを生成します。GitHub Actionsで自動ビルド・公開も可能です。
全文翻訳
Open Knowledge Formatのパブリッシングエンジン。
Kisoは、Open Knowledge Format(OKF)バンドルを、人間とAIエージェントのための静的ウェブサイトに変換するパブリッシングエンジンです。
例を見る
CLIをダウンロード
第一原則
OKFは信頼できる情報源です。構造化されたMarkdownの知識は、Gitでの編集、レビュー、差分比較、バージョン管理が容易です。
明示的なメタデータ
ページは、一貫して検証、リンク、レンダリングされるのに十分なコンテキストを保持します。
エージェントフレンドリー
生成されたHTMLは、元のMarkdownファイルへの明確なリンクを保持します。
コマンド
buildがすること
buildコマンドは、OKFバンドルから静的ウェブサイトを生成します。これには、元のMarkdownファイル、生成されたHTMLページ、llms.txt、およびsitemap.xmlが含まれます。
source
examples/kb-google-exampleのような任意のOKFバンドルディレクトリ
destination
publicまたは任意の静的ディレクトリ
GitHub Action
Github CIでの使用
KisoをGitHub Actionで使用して、OKFバンドルをGitHub Pagesまたは他の静的ホスティングサービスに自動的にビルドして公開できます。
- name: Build with Kiso
uses: oak-invest/kiso/applications/kiso-cli-action@v0.1.2
with:
command: build
source: examples/kb-google-example
destination: website/examples/kb-google-example-latest
01 閲覧
読者は、ナビゲーションと読みやすいページを備えた構造化された静的ウェブサイトを利用できます。
02 検査
各ページは、レビューと再利用のためにMarkdownソースにリンクバックできます。
03 公開
結果は、ローカルまたはHTTP経由でホストできるプレーンな静的出力です。
Google AnalyticsのサンプルナレッジベースでKisoを試してみてください。この例は、OKFバンドルが人間とAIエージェントにとってナビゲート可能なサイトになる方法を示しています。例を見る