Jump to content

拡張機能:WikiLambda

From mediawiki.org
This page is a translated version of the page Extension:WikiLambda and the translation is 97% complete.
MediaWiki 拡張機能マニュアル
WikiLambda
リリースの状態: 実験的
実装 パーサー関数 , ContentHandler
説明 ウィキメディアのウィキ・プロジェクト群に ウィキ文のパーサ関数を提供し、中央のウィキ・プロジェクトで記述し管理下にあり評価された関数の評価を呼び出します。
作者 Wikimedia Foundation
互換性の方針 スナップショットが MediaWiki とともにリリースされます。 master には後方互換性がありません。
データベースの変更 はい
仮想ドメイン
  • virtual-awstorage
  • virtual-wikifunctions-usage
  • $wgWikiLambdaClientDefaultShowChanges
  • $wgWikiLambdaEnableAbstractClientModeIntegration
  • $wgWikiLambdaClientRepoSiteId
  • $wgWikiLambdaAbstractWikiIconUrl
  • $wgWikiLambdaEnableAbstractMode
  • $wgWikiLambdaEnableClientMode
  • $wgWikiLambdaAbstractWikiArticleStoreLangs
  • $wgWikiLambdaEnableSearchIndexFields
  • $wgWikiLambdaSearchIndexLanguages
  • $wgWikiLambdaClientTargetAPI
  • $wgWikiLambdaEnableRepoMode
  • $wgWikiLambdaClientWikis
  • $wgWikiLambdaAbstractWikiArticleStoreTopics
  • $wgWikiLambdaObjectCacheBroadcast
  • $wgWikiLambdaEnableAbstractClientMode
  • $wgWikiLambdaClientModeOffline
  • $wgWikiLambdaAbstractNamespaces
  • $wgWikiLambdaOrchestratorLocation
  • $wgWikiLambdaPersistBackendCache
  • $wgWikiLambdaClientCallThresholds
  • $wgWikiLambdaObjectCaches
ライセンス MIT ライセンス
ダウンロード
translatewiki.net で翻訳を利用できる場合は、WikiLambda 拡張機能の翻訳にご協力ください
問題点 未解決のタスク · バグを報告

ウィキラムダ WikiLambda 拡張機能は、利用者が記述し管理し評価する関数をウィキごとにホストできるようにして、wikifunctions.org の強化を図ります。 抽象ウィキペディア Abstract Wikipedia の実現に向けた作業の一環として、「ウィキ関数」Wikifunctions という一連のソフトウェアのコアとなります。 当該のシステムは現在、開発を実行中であり、フロントエンドは Vue.js で記述し、インタフェースのライブラリには新しい Codex を採用。 ウィキラムダ経由のウィキ関数は、ウィキ・プロジェクト群にウィキ文形式のパーサ関数を提供し、ローカルのウィキにおいてウィキ関数の評価をもたらします。

はじめに

ウィキ関数の予想挙動と現状で作業中のトップレベルの構造モデル

ウィキ関数 Wikifunctions はメディアウィキにインストール可能であり、保存するのは関数コンテンツのみで、出力は保存しません。このコンテンツにはウィキ・コミュニティの通常の管理コンテンツ(井戸端、議論の場、方針ページなど)に加えて、利用可能な各関数(「Functions」)をプログラム式に記述した形、これらの関数を実際にユーザが記述したコードの実装(「Implementations」)、これら関数のテスト・スイート(「Testers」)ならびにこれら関数をめぐる人間向け解説文書をそろえています。

関数呼び出し(function calls)のリクエストはウェブ申請の形で直接、あるいはまた MediaWiki 経由(パーサ関数 {{#function:…}} の利用)により受け付けます。 関数オーケストレータ orchestrator はリクエストの具体的な内容を判断し、出力値の提供が最近かどうかキャッシュをチェックして確認して、それを返すか、もしくは評価をトリガーします。 その過程では関連コンテンツをすべてクラスタから取得し、それはウィキ関数から公開済みの関数コンテンツ(またはその時点でまだ編集中で未公開の関数コンテンツを「プレビュー」したもの)、またはウィキデータおよびウィキメディア・コモンズに既存であり関数が動作できる構造化コンテンツです。 すると実行する全コードを揃えたバンドルならびに、その実行の源となる入力は適切な関数実行過程 function executor に渡され、それにより安全な入力実行を試みて出力(または失敗エラー)を返します。 そうするとオーケストレータ orchestrator は 成功した結果をキャッシュに書き込み、消費者に送信します。

ウィキラムダ WikiLambda 拡張機能の担当範囲は Wikifunctions ウィキ上のコンテンツ管理(例:ウィキベース・リポジトリ拡張機能 Wikibase Repository)、編集インターフェースを提供し、ユーザによる特定の操作を制限もしくは警告すること、加えて読み取りおよびテスト実行インターフェースを提供しつつ、ウィキメディアの全ウィキ・プロジェクトから上がるコンテンツ・リクエストを統合することです(例:ウィキベース・クライアント拡張機能 Wikibase Client)。 ユーザ記述のコードは本番環境の文脈で実行されることはなく、 したがって機密性の高いコンテンツにアクセスできないため、使い捨ての孤立したインスタンスでのみ実行されます。

始めてみよう

インストール

  • ダウンロードして、ファイルをextensions/フォルダー内のWikiLambdaという名前のディレクトリ内に配置します。
    開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:
    cd extensions/
    git clone --recurse-submodules https://gerrit.wikimedia.org/r/mediawiki/extensions/WikiLambda
    
  • Gitでのインストールの場合のみ、PHPの依存関係をインストールするためComposerを実行します。 (合併症の可能性についてはT173141を参照。)
  • 以下のコードを LocalSettings.php ファイルの末尾に追加します:
    wfLoadExtension( 'WikiLambda' );
    
  • 更新スクリプトを実行します。このスクリプトは、この拡張機能が必要とするデータベーステーブルを自動的に作成します。
  • Yes 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

バックエンドサービスのインストール

希望に応じ、バックエンド・サービスをインストールしてウィキラムダ・ソフトウェア WikiLambda を使用するなら、ご自身で手順を実行し、設定しなければなりません。指示は変更されるという前提で、リポジトリ限定で提供します。

局所的テスト

(TODO)

コードのスチュワード権限

関連項目

下位ページ