Extension:StructuredDiscussions

課題かだい管理かんりシステム: #StructuredDiscussions
From mediawiki.org
This page is a translated version of the page Extension:StructuredDiscussions and the translation is 97% complete.
Languages:
MediaWiki 拡張かくちょう機能きのうマニュアル
StructuredDiscussions
リリースの状態じょうたい: 保守ほしゅされていない
実装じっそう ページの操作そうさ
説明せつめい トークページに討議とうぎと共同きょうどう作業さぎょうのシステムを導入どうにゅう
作者さくしゃ Brandon Harris, Erik Bernhardson, Matthias Mullie, Andrew Garrett, Benny Situ, Shahyar Ghobadpour, Matthew Flaschen, Roan Kattouw, Moriel Schottlender, Stephane Bisson, Kunal Mehta
最新さいしんバージョン Continuous updates
互換ごかん性せいの方針ほうしん MediaWiki とともにリリースされるスナップショット。 master には後方こうほう互換ごかん性せいがありません。
MediaWiki 1.34+
PHP 5.4+
データベースの変更へんこう はい
Composer mediawiki/flow
ライセンス GNU 一般いっぱん公衆こうしゅう利用りよう許諾きょだく書しょ 2.0 以降いこう
ダウンロード
拡張かくちょう機能きのうをダウンロード
Git [?]:
ヘルプ Help:Structured Discussions
例れい Talk:Structured Discussions
パラメーター
  • $wgFlowExternalStore
  • $wgFlowMaxMentionCount
  • $wgFlowEnableOptInBetaFeature
  • $wgFlowHelpPage
  • $wgFlowReadOnly
  • $wgFlowAbuseFilterEmergencyDisableThreshold
  • $wgFlowCoreActionWhitelist
  • $wgFlowAjaxTimeout
  • $wgFlowCluster
  • $wgFlowNotificationTruncateLength
  • $wgFlowAbuseFilterEmergencyDisableAge
  • $wgFlowParsoidTimeout
  • $wgFlowCacheTime
  • $wgFlowDefaultWikiDb
  • $wgFlowServerCompileTemplates
  • $wgFlowAbuseFilterEmergencyDisableCount
  • $wgFlowContentFormat
  • $wgFlowMaxLimit
  • $wgFlowMaxThreadingDepth
  • $wgFlowParsoidForwardCookies
  • $wgFlowCacheVersion
  • $wgFlowParsoidHTTPProxy
  • $wgFlowParsoidPrefix
  • $wgFlowDefaultLimit
  • $wgFlowAbuseFilterGroup
  • $wgFlowParsoidURL
追加ついかする権限けんげん
  • flow-hide
  • flow-lock
  • flow-delete
  • flow-suppress
  • flow-edit-post
  • flow-edit-title
  • flow-create-board
使用しようするフック
提供ていきょうするフック
四半期しはんきごとのダウンロード数すう 46 (Ranked 99th)
StructuredDiscussions 拡張かくちょう機能きのうの翻訳ほんやくにご協力きょうりょくください
問題もんだい点てん 未み解決かいけつのタスク · バグを報告ほうこく

StructuredDiscussions 拡張かくちょう機能きのうはトークページにおける討議とうぎと共同きょうどう作業さぎょうに使つかうシステムを提供ていきょうします。 このページではインストールと管理かんりの方法ほうほうを紹介しょうかいします。使つかい方かたのガイドはHelp:Structured Discussions をご参照さんしょうください。 この機能きのうをご自分じぶんで試ためすには、サンドボックスのトークページが利用りようできます。

この拡張かくちょう機能きのうは以前いぜんはFlowとして知しられており、いくつかの場所ばしょ(Git リポジトリなど)での名前なまえはまだそれを反映はんえいしています。

StructuredDiscussions 拡張かくちょう機能きのうの開発かいはつにはウィキメディア財団ざいだんのCollaborationチームが当あたりました。 バグ修正しゅうせいのため管理かんりを続つづけていますが、2017年ねん9月がつに「StructuredDiscussions」に改名かいめいされたほかは、実体じったいのある開発かいはつは2015年ねん以降いこうなされていません。 この拡張かくちょう機能きのうの開発かいはつ状じょう況きょうならびに設計せっけいの概要がいようについて詳くわしく知しるには、Structured Discussionsをご参照さんしょうください。

インストール

警告! 警告けいこく: StructuredDiscussionsはSQLiteと互換ごかん性せいがないことにご注意ちゅういください。
  • 必要ひつような依存いぞん関係かんけいのセットアップと構成こうせいがすべて完了かんりょうしていることを確認かくにんしてください。
  • あなたのウィキのrest.php を指さすように$wgVirtualRestConfig['modules']['parsoid']['url']を設定せっていしてください。
  • If you have problems in MediaWiki 1.40, you should make some changes to remove virtualrestconfig of restbase in Flow. See task T337223.
  • ダウンロードして、ファイルをextensions/フォルダー内ないのFlowという名前なまえのディレクトリ内ないに配置はいちします。
    開発かいはつ者しゃとコード寄稿きこう者しゃは、上記じょうきの代かわりに以下いかを使用しようしてGitからインストールします:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Flow
  • Gitでのインストールの場合ばあいのみ、PHPの依存いぞん関係かんけいをインストールするためComposerを実行じっこうします。 (合併症がっぺいしょうの可能かのう性せいについてはタスク T173141を参照さんしょう。)
  • 以下いかのコードを LocalSettings.php ファイルの末尾まつびに追加ついかします: 
    wfLoadExtension( 'Flow' );
  • 更新こうしんスクリプトを実行じっこうします。このスクリプトは、この拡張かくちょう機能きのうが必要ひつようとするデータベーステーブルを自動的じどうてきに作成さくせいします。
  • Yes 完了かんりょう – ウィキの「Special:Version」に移動いどうして、拡張かくちょう機能きのうが正まさしくインストールされたことを確認かくにんします。


Vagrantでのインストール:

  • Vagrant を使用しようしている場合ばあいは、vagrant roles enable flow --provisionでインストールしてください。
既知きちの問題もんだいに遭遇そうぐうした場合ばあいは、トラブルシューティング節ぶしをご参照さんしょうください。

インストール後ご

ウェブサーバーの利用りよう者しゃ権限けんげんで「update.php」を実行じっこうします (設定せっていにもよりますが例たとえば www-data)。 さもなければ、/tmp/mw-UIDGeneratorUUID-UID-xx 一時いちじファイルが残のこってしまい、MediaWiki には開ひらくことができません (タスク T55791). Flow のボードを初はじめて開ひらこうとした時とき、もし「必要ひつような権限けんげんがありません」などのエラーが表示ひょうじされた場合ばあいは、必かならずこれらのファイルを削除さくじょします。 さらに Flow の言及げんきゅう機能きのうをビジュアル編集へんしゅう機能きのうで有効ゆうこうにするため、update.phpは{{FlowMention }}を作成さくせいし (言及げんきゅうはアットマーク「@」もしくはツールバーのメニューに便利べんりな自動じどう入力にゅうりょくインターフェースを提供ていきょうして使つかえるようにします)。

注意ちゅうい点てんは、StructuredDiscussionsを有効ゆうこうもしくは無効むこうにする手順てじゅんをすべて実行じっこうすることで、これには提示ていじされたスクリプトをすべて実行じっこうすることも含ふくまれます。

依存いぞん関係かんけい

必須ひっす
  • Extension:Echo - 通知つうち用よう (例れい：投稿とうこうへの返事へんじ)
  • 対象たいしょうのキャッシュが必要ひつようです。その実行じっこうには memcach (汎用はんようの分散ぶんさん型がたメモリキャッシュシステム) の使用しようが推奨すいしょうされます。現在げんざい、Redis を使つかうと問題もんだいが発生はっせいするかもしれません。
  • Extension:ParserFunctions - 自動的じどうてきにインストールされるテンプレートに対応たいおう (例れい＝#time)
強つよく推奨すいしょう
  • Parsoidは投稿とうこうをHTML形式けいしき($wgFlowContentFormat = 'html';)として保存ほぞんし、パフォーマンスを改善かいぜん。 WMF（ウィキメディア財団ざいだん）のウィキの設定せっていがこうなっているからで、現状げんじょうではもっともテストが行いき届とどいた設定せっていです。 MediaWiki-Vagrantを使用しようしている場合ばあい、StructuredDiscussionsを有効ゆうこうにすると Parsoid が有効ゆうこうになり、形式けいしきを「html」に設定せっていします。
省略しょうりゃく可能かのう
  • Extension:BetaFeatures - 利用りよう者しゃのトークページで選択せんたく制せいのベータ機能きのうを利用りようするため。
  • Extension:CLDR - 人間にんげんにわかりやすい「3日にち前まえ」のようなタイムスタンプを使用しよう
  • Extension:VisualEditor - ビジュアル編集へんしゅう機能きのう VisualEditor への対応たいおう
    バグ? ビジュアルエディタをインストールしてある場合ばあい (例れい：OOUIを提供ていきょうするため) は、たとえ有効ゆうこうにしていなくても StructuredDiscussions が Parsoid を呼よび出だそうとする現象げんしょう
  • StructuredDiscussions はExtension:AbuseFilter 、Extension:SpamBlacklist 、Extension:ConfirmEdit と統合とうごうします。詳細しょうさいはExtension:StructuredDiscussions/Spam をご参照さんしょうください
  • StructuredDiscussionsはExtension:CheckUser をインストールした環境かんきょうで統合とうごうします。
  • Extension:Thanks - 投稿とうこうした利用りよう者しゃに「感謝かんしゃ」を送信そうしん

インストールの確認かくにん

StructuredDiscussions を有効ゆうこうにしたページのどれかを開ひらき (#Configurationを参照さんしょう)、話題わだいの追加ついかやその見出みだしの編集へんしゅうを試ためしてください。

設定せってい

LocalSettings.phpで設定せっていが必要ひつような項目こうもくを説明せつめいします。

StructuredDiscussions を有効ゆうこうもしくは無効むこうにするには

MediaWiki 1.35, 以前いぜんは、StructuredDiscussions を名前なまえ空間くうかんで有効ゆうこうまたは無効むこうにするには、まず影響えいきょうを受うける名前なまえ空間くうかんでpopulateContentModel.php を実行じっこうします (代かわりにallで実行じっこうしても可か)。 1.35 以降いこうはもう必要ひつようがなくなりました。 例れい＝NS_TALK (1) や NS_USER_TALK (3) で有効ゆうこうもしくは無効むこうにする場合ばあい、以下いかのPHP 設定せっていの状態じょうたいなら次つぎのようになります。 

mwscript populateContentModel.php --wiki=somewiki --ns=1 --table=revision
mwscript populateContentModel.php --wiki=somewiki --ns=1 --table=archive
mwscript populateContentModel.php --wiki=somewiki --ns=1 --table=page

mwscript populateContentModel.php --wiki=somewiki --ns=3 --table=revision
mwscript populateContentModel.php --wiki=somewiki --ns=3 --table=archive
mwscript populateContentModel.php --wiki=somewiki --ns=3 --table=page

mwscript が未み設定せっていの場合ばあいは、mwscript populateContentModel.phpをphp maintenance/populateContentModel.phpと入いれ替かえます。

上記じょうきの後のちに、特定とくていの名前なまえ空間くうかんで$wgNamespaceContentModels [namespace]を設定せっていします。 例れい： 

  // These lines enable StructuredDiscussions on the "Talk" and "User talk" namespaces
  // All the NS_* constants here: https://www.mediawiki.org/wiki/Manual:Namespace_constants
  
  $wgNamespaceContentModels[NS_TALK] = 'flow-board';
  $wgNamespacesWithSubpages[NS_TALK] = true;
  $wgNamespaceContentModels[NS_USER_TALK] = 'flow-board';
  $wgNamespacesWithSubpages[NS_USER_TALK] = true;

グローバルな設定せってい変更へんこうしてはダメです ($wgNamespaceContentModels =)。

単たん一いちページで有効ゆうこうにする場合ばあいは、Special:EnableStructuredDiscussionsを利用りようします。 これにはフローボード作成さくせい権限けんげん flow-create-board が必要ひつようで、どんなグループでも権限けんげんを付与ふよされます (利用りよう者しゃ権限けんげんのグループ権限けんげん変更へんこうのページ Manual:User rights#Changing group permissions をご参照さんしょうください)。 

  $wgGroupPermissions['somegroup']['flow-create-board'] = true;

ご利用りようのwikiのすべてのページで StructuredDiscussions を無効むこうにする方法ほうほうはExtension:StructuredDiscussions/Turning off all StructuredDiscussions をご参照さんしょうください。

Parsoid 設定せってい

StructuredDiscussions は Parsoid または RESTBase サービスに接続せつぞくするため、バーチャル REST サービスを使つかいます。 ご利用りようのウィキでVisualEditor 拡張かくちょう機能きのうを読よみ込こんだ場合ばあい、これの設定せっていはすでに済すんでいる可能かのう性せいがあります。 LocalSettings.phpで以下いかを探さがします。 

$wgVirtualRestConfig['modules']['parsoid'] = array(
  // URL to the Parsoid instance
  // Use port 8142 if you use the Debian package
  'url' => 'http://localhost:8000',
  // Parsoid "domain", see below (optional)
  'domain' => 'localhost',
  // Parsoid "prefix", see below (optional)
  'prefix' => 'localhost',
);

単体たんたいのParsoid は複数ふくすうのウィキを取とり扱あつかいます。 Parsoid の domain 設定せっていはお使つかいのウィキの設定せっていを Parsoid に指定していします。 既定きていでは$wgCanonicalServerが命名めいめいするホスト名めいに設定せっていされるものの、任意にんいの文字もじ列れつを選えらぶこともできます。 旧版きゅうばんの Parsoid でも固有こゆうの「接頭せっとう辞じ」を用もちいてこのサーバを特定とくていします。ここにそれをリストする必要ひつようがあるかもしれません。

Parsoid の localsettings.js で以下いかのような行くだりを使つかって、Parsoid が適合てきごうするように設定せっていしておく必要ひつようがあります： 

parsoidConfig.setMwApi({ uri: 'http://path/to/my/wiki/api.php', domain: 'localhost', prefix: 'localhost' });

ここでも Parsoid 設定せっていで「domain」（ドメイン）属性ぞくせいはオプションです。指定していしないと既定きていでuri属性ぞくせいで採用さいようするホスト名めいを採用さいようします。 「prefix」（接頭せっとう辞じ）属性ぞくせいも除去じょきょ可能かのうですが、旧版きゅうばんの Parsoid を利用りようする場合ばあいは例外れいがいです。 Parsoid の localsettings.js に記述きじゅつされた domain と prefix がご利用りようのウィキの LocalSettings.php と一致いっちすることを確認かくにんします。

詳細しょうさいはParsoid/Setup#Configuration をご参照さんしょうください。

「入いれ子この関数かんすうの最大さいだいレベル「100」に達たっしたため、中止ちゅうしします」

このエラーが表示ひょうじされた場合ばあい、おそらく /etc/php5/apache2/php.ini.[1] において xdebug.max_nesting_level = 200の設定せっていが必要ひつようです

「例外れいがいを発見はっけん：CASがXyz で実行じっこうしない」状態じょうたい

StructuredDiscussions は $cache->cas() とCACHE_ACCEL (APCBagOStuff)などのキャッシュした実行じっこうでCASを伴ともなわないものを実施じっしします。 変更へんこうし、たとえばmemcachedをインストールし$wgMainCacheType = CACHE_MEMCACHED;を設定せっていするなど、違ちがうキャッシュを使つかう必要ひつようがあるかもしれません。

権限けんげん

StructuredDiscussionsで書かき込こみの作業さぎょうをする利用りよう者しゃは、コアのedit権限けんげんが必要ひつようです。 この権限けんげんを'user'グループ (ログイン状態じょうたいで) にのみ付与ふよするウィキがたくさんあります。

StructuredDiscussions が定義ていぎする動作どうさは多おおく、たとえばedit-postやdelete-topicがあります (詳細しょうさいな一覧いちらんはFlowActions.phpをご参照さんしょうください)。 投稿とうこうが皆みなさん自身じしんのものかどうか、変更へんこうしたかどうかにより、権限けんげんが異ことなります。 一いち例れいとして、既定きていでは利用りよう者しゃは自分じぶん自身じしんの投稿とうこうの編集へんしゅうを認みとめられますが、他者たしゃの投稿とうこうを改変かいへんできるのはflow-edit-post権限けんげんを付与ふよされた'sysop'グループの利用りよう者しゃのみです。 Flow に関かんして、どのグループにどの権限けんげんを付与ふよするか、動作どうさごとに必要ひつような権限けんげんの選定せんていができます。権限けんげんの概要がいようの詳細しょうさいは Manual:利用りよう者しゃ権限けんげん をご参照さんしょうください。

既存きそんのページの移行いこう

既存きそんの単たん一いちページを移行いこうするには、Special:EnableStructuredDiscussionsを使つかいます。 すると自動的じどうてきに単たん一いちページの過去かこログ化か (それによって StructuredDiscussions を有効ゆうこうにする) 扱あつかいをします。

maintenance/convertNamespaceFromWikitext.php というスクリプトはこの名前なまえ空間くうかんの変換へんかんと有効ゆうこう化かを自動じどう化かします。詳細しょうさいはFlow/Converting talk pages参照さんしょう。 これはどちらかというと WMF固有こゆうであり、実行じっこう前まえにご利用りようのデータベースをまずバックアップし、操作そうさの仕方しかたを調しらべてください。 別べつのmaintenance/convertAllLqtPages.phpというスクリプトはLiquidThreadsページとスレッドをFlowのボードと話題わだいに変換へんかんします。注意ちゅうい事項じこうはFlow/Converting LiquidThreadsを参照さんしょう。

Flow はTopic:名前なまえ空間くうかんを追加ついかします。Extension default namespaces#flowを参照さんしょう。 これと衝突しょうとつする既存きそんのページの有無うむは、Special:PrefixIndex/Topic:で確認かくにんしてください。見みつかった場合ばあいは管理かんりスクリプトmaintenance/namespaceDupes.phpを走はしらせます。

設定せってい

Flow.php での構成こうせい設定せってい
パラメーター 既定きてい コメント
$wgFlowHelpPage //www.mediawiki.org/wiki/Special:MyLanguage/Help:Extension:Flow Flow 通知つうちシステムに関かんする詳細しょうさい情報じょうほうの URL
$wgFlowCluster false $wgFlowCluster はどの外部がいぶ DB サーバを使つかうべきか定義ていぎします。

設定せっていを false にすると、現在げんざいのデータベース (wfGetDB) を使つかってデータの読よみ出だし/書かき込こみを実行じっこうします。 外部がいぶデータベース上じょうに StructuredDiscussions データを保存ほぞんする場合ばあい、この変数へんすうの値ねを $wgExternalServers に設定せっていし、当該とうがいの外部がいぶ接続せつぞくを示しめします。

$wgFlowDefaultWikiDb false StructuredDiscussions メタデータ利用りように使つかうデータベース。ウィキデータベースを使用しようする際さいは false に設定せってい。

StructuredDiscussions データベースを利用りようするウィキの件数けんすうに上限じょうげんは設もうけず、共有きょうゆうできるものとします。 実際じっさいのデータベース名めいはメッセージ単位たんいで内部ないぶのテーブルに保存ほぞんします。メッセージを投稿とうこう後ごにデータベース名めいを変更へんこうすると、過去かこのスレッドにアクセス不能ふのうとなります。

$wgFlowExternalStore false コンテンツの保存ほぞんに使用しよう。

False に設定せっていしてコンテンツを StructuredDiscussions データベースに保存ほぞん。 あるいは ExternalStore に使用しようするクラスタ単体たんたいもしくはクラスタの一覧いちらん。 提示ていじしたクラスタ類るいは $wgExternalStores に実在じつざいする必要ひつようがあります。 HA には複数ふくすうのクラスタが必要ひつようで、メンテナンスあるいはその他たの理由りゆうにより、マスターのどれかがダウンしても挿入そうにゅうを継続けいぞくするためです。

$wgFlowExternalStore = array( 'DB://cluster24', 'DB://cluster25' );

$wgFlowContentFormat html 既定きていでは StructuredDiscussions に保存ほぞんするコンテンツは HTML 形式けいしきです。

しかしながら、これには Parsoid が既すでに導入どうにゅう済ずみで稼働かどうしていることが条件じょうけんとなり、基本きほんのエディタに渡わたすため HTML からウィキテキストに変換へんかんする必要ひつようがあるからです。 (つまりビジュアルエディタ VisualEditor を使つかう場合ばあいは Parsoid が必須ひっすであり、ビジュアルエディタをサポートするウィキでは今いますぐ、これを HTML 形式けいしきに設定せっていし直なおしてください)

$wgFlowParsoidURL が null の場合ばあい、$wgFlowContentFormat はウィキテキストに切きり替かえる必要ひつようがあります。

'wikitext' 書式しょしきでさえ、将来しょうらい的てきには非ひ推奨すいしょうになる可能かのう性せいがあります。

$wgFlowParsoidURL null
警告 警告けいこく: 廃止はいし済ずみ。$wgVirtualRestConfig['modules']['parsoid']['url'] に切きり替かえてください。

StructuredDiscussions Parsoid 構成こうせい

留意りゅうい点てんとして、この構成こうせい設定せっていはビジュアルエディタ自体じたいの Parsoid 構成こうせいとは別べつのものである点てんです。

$wgFlowParsoidPrefix null
警告 警告けいこく: 廃止はいし済ずみ。$wgVirtualRestConfig['modules']['parsoid']['prefix'] に切きり替かえてください。

Flow Parsoid 構成こうせい設定せってい

留意りゅうい点てんとして、この構成こうせい設定せっていはビジュアルエディタ自体じたいの Parsoid 構成こうせいとは別べつのものである点てんです。

$wgFlowParsoidTimeout null
警告 警告けいこく: 廃止はいし済ずみ。$wgVirtualRestConfig['modules']['parsoid']['timeout'] に切きり替かえてください。

Flow Parsoid 構成こうせい設定せってい

留意りゅうい点てんとして、この構成こうせい設定せっていはビジュアルエディタ自体じたいの Parsoid 構成こうせいとは別べつのものである点てんです。

$wgFlowParsoidForwardCookies false
警告 警告けいこく: 廃止はいし済ずみ。$wgVirtualRestConfig['modules']['parsoid']['forwardCookies'] に切きり替かえてください。

利用りよう者しゃのクッキーを転送てんそう：Parsoid に送おくるヘッダ。非公開ひこうかいウィキ (ログインして閲覧えつらん) で必要ひつよう。

当該とうがいのウィキが公開こうかいである場合ばあい (つまり $wgGroupPermissions['*']['read'] は true) には、この構成こうせい設定せっていの編集へんしゅうは無視むしされます。

この機能きのうには、ロックしないセッションの保存ほぞんが必要ひつようです。 この既定きていのセッション保存ほぞんはおそらく無効むこうであり、この機能きのうを使つかおうとした時ときに行いき詰づまりが発生はっせいします。 行いき詰づまりが発生はっせい他た場合ばあいは、$wgSessionsInObjectCache を有効ゆうこうにしてください。

警告けいこく: これを有効ゆうこうにするのは非公開ひこうかいウィキに限定げんていし、HTTP経由けいゆでCookieヘッダーをParsoidに送信そうしんする場合ばあいのセキュリティへの影響えいきょうを理解りかいしている場合ばあいのみにしてください。 セキュリティー上じょうの問題もんだいがあり、この設定せっていを有効ゆうこうにする場合ばあいは必かならず $wgVirtualRestConfig['modules']['parsoid']['forwardCookies'] をローカルのホストに指定していします。

$wgFlowDefaultLimit 10 表示ひょうじページ数すうの上限じょうげん
$wgFlowMaxLimit 100 ページングの制限せいげん
$wgFlowMaxMentionCount 100 コメント1件けんで通知つうちを送信そうしんできる利用りよう者しゃ数すうの上限じょうげん
$wgFlowMaxThreadingDepth 8 スレッドの最大さいだいの深ふかさ
$wgFlowCacheTime 60 * 60 * 24 * 3 StructuredDiscussions データを memcache にキャッシュする既定きてい時間じかん

この値ねはキャッシュのヒット・ミス率りつと対応たいおうさせて調整ちょうせいが可能かのうで、メモリの使用しよう率りつ、データベースのクエリ、反応はんのう時間じかんのバランス (トレードオフ) を実現じつげんします。 初期しょきの既定きてい値ち3日にちとは StructuredDiscussions が過去かこ３日間にちかんに呼よび出だしのあったデータモデル全ぜん件けんを memcache に保持ほじしようとすることです。

$wgFlowCacheVersion 4.9 一連いちれんのバージョンをキャッシュキーに添付てんぷします。

キャッシュのフォーマットもしくはロジックが変更へんこうされた場合ばあいは、これを不ふ採用さいようにします。 StructuredDiscussions とはウィキ間あいだデータベースであり、バージョン違ちがいの Flow コードを走はしらせるウィキ群ぐんがアクセスします。ウィキメディア財団ざいだんは時ときに応おうじてこれを wmf-config/CommonSettings.php でグローバルに上書うわがきすることがあります。

$wgFlowAbuseFilterGroup 'flow' Custom group name for AbuseFilter

Acceptable values:

  • a specific value for flow-specific filters
  • 'default' to use core filters; make sure they are compatible with both core and StructuredDiscussions (e.g. StructuredDiscussions has no 'summary' variable to test on)
  • false to not use AbuseFilter
$wgFlowAbuseFilterEmergencyDisableThreshold 0.10 AbuseFilter emergency disable values for StructuredDiscussions
$wgFlowAbuseFilterEmergencyDisableCount 50 AbuseFilter emergency disable values for StructuredDiscussions
$wgFlowAbuseFilterEmergencyDisableAge 86400 // One day. AbuseFilter emergency disable values for StructuredDiscussions
$wgFlowAjaxTimeout 30 Timeout for StructuredDiscussions's AJAX requests (only affects ones that go through flow-api.js), in seconds
$wgFlowCoreActionWhitelist array( 'info', 'protect', 'unprotect', 'unwatch', 'watch', 'history', 'wikilove', 'move', 'delete' ); Actions that must pass through to MediaWiki on StructuredDiscussions-enabled pages
$wgFlowServerCompileTemplates false When set to true StructuredDiscussions will compile templates into their intermediate forms on every run. When set to false Flow will use the versions already written to disk. Production should always have this set to false.
$wgFlowSearchServers, $wgFlowSearchConnectionAttempts, $wgFlowSearchBannedPlugins, $wgFlowSearchOptimizeIndexForExperimentalHighlighter, $wgFlowSearchMaxShardsPerNode, $wgFlowSearchRefreshInterval, $wgFlowSearchMaintenanceTimeout, $wgFlowSearchReplicas, $wgFlowSearchShardCount, $wgFlowSearchCacheWarmers, $wgFlowSearchMergeSettings, $wgFlowSearchIndexAllocation, $wgFlowSearchEnabled N/A These former settings were removed because the code was unmaintained and broken. (You can look at the previous documentation if you want.) There is currently no code for supporting search in StructuredDiscussions.

システムメッセージ

StructuredDiscussions のボードでソース編集へんしゅう オプションを使つかうと、ヘルプ文ぶんの"ウィキテキストはマークアップを使用しよう、また、いつでも結果けっかをプレビューできます。"を表示ひょうじできます。 「マークアップを使用しよう」の部分ぶぶんのリンク先さきはシステムメッセージMediaWiki:Flow-wikitext-editor-help-uses-wikitextを介かいし、MediaWiki.orgへのウィキ間あいだリンクを利用りようします。

場合ばあいによっては、このウィキ間あいだリンクはMediaWiki.orgでHelp:Formatting を指さす代かわりに、ホスト先さきのウィキで（通常つうじょうは存在そんざいしない）Help:Formattingページを指さします。

その修正しゅうせいはMediaWiki:Flow-wikitext-editor-help-uses-wikitextのウィキ間あいだリンクを外部がいぶリンクとして

[https://www.mediawiki.org/wiki/Help:Formatting uses markup].

のように書かき換かえます。

トラブルシューティング

Flow が思おもったように使つかえませんか？ 問題もんだいの原因げんいんにより、修正しゅうせい方法ほうほうが変かわります。

正まさしく設定せっていされていないparsoid/VEが機能きのうしない

Conversion from 'html' to 'wikitext' was requested, but core's Parser only supports 'wikitext' to 'html' conversion のようなメッセージが表示ひょうじされた場合ばあいは、parsoid が正まさしく設定せっていされていない可能かのう性せいがあります。 ディスカッションでビジュアルエディタを使用しようするには、この拡張かくちょう機能きのうは正まさしく設定せっていされたparsoidが必要ひつようです。

以下いかに従したがってください:

  1. parsoidが正まさしくインストールされていることを確認かくにんしてください。
  2. このバグが解決かいけつされていない場合ばあい、このパッチをStructuredDiscussionsコードベースに適用てきようしてください。

問題もんだいが解決かいけつしない場合ばあいは、この議論ぎろんが役やくに立たつかもしれません。

Custom-Namespace 宣言せんげんの順序じゅんじょが間違まちがっている

Flow 宣言せんげんはカスタムの名前なまえ空間くうかん名めいの後のちに 記述きじゅつしなければなりません。 正ただしい順序じゅんじょ： 

define("NS_PORTAL_TALK", 3005); 
$wgExtraNamespaces[NS_PORTAL_TALK] = "Portal_Talk"; 
$wgNamespaceContentModels[NS_PORTAL_TALK] = 'flow-board';
$wgNamespacesWithSubpages[NS_PORTAL_TALK] = true;

間あいだ違ちがったネイティブの定数ていすう

メインの名前なまえ空間くうかんではNS_TALKと定義ていぎされるトークページの定数ていすうは、NS_MAIN_TALKではありません。

正ただしい宣言せんげんとは： 

$wgNamespaceContentModels[NS_TALK] = 'flow-board';

登録とうろくのない拡張かくちょう機能きのうの定数ていすう

Extension:Page Forms 名前なまえ空間くうかんの定数ていすうはPF_NS_FORM_TALK になる見込みこみです。 ただしその定数ていすうは Flow 宣言せんげんでは無効むこうです -- そこで実際じっさいの数字すうじを使つかう必要ひつようがあります: 107。 するとその作用さようは次つぎのとおりです。 

$wgNamespaceContentModels[107] = 'flow-board';

筆者ひっしゃには、Flow に関かんしてPage_Formsが定数ていすうを正ただしく登録とうろくしない理由りゆう、あるいは拡張かくちょう機能きのう すべてで (定数ていすうの代かわりに) 数字すうじを使つかうべきか原因げんいんは不明ふめいです。 他たの名前なまえ空間くうかん用ようの定数ていすうの一覧いちらんをご参照さんしょうください。

古ふるい名残なごり

特定とくていの名前なまえ区間くかんのトークページすべてできちんと Flow が働はたらくようになり、その名前なまえ空間くうかんであるページ のみ例外れいがいだったとして、トークページにジャンクの名残なごりがあるのかもしれません（見みた目めには何なにもないように見みえても。） 次つぎの処理しょりをします。

  1. Flow を読よみ込こまないトークページを閲覧えつらんします。たとえば： Portal_Talk:Welcome
  2. 削除さくじょタブを使つかい、トークページを削除さくじょします。
  3. そのトークページが付ついたコンテンツのページを開ひらきます。例れい： Portal:Welcome
  4. 「Discuss」をクリックします。
  5. すると Flow が有効ゆうこうになります。

Parsoid not working in StructuredDiscussions (Flow)

To get Parsoid to work with StructuredDiscussions (Flow):

  1. In LocalSettings.php, explicitely load Parsoid like so: wfLoadExtension( 'Parsoid', "vendor/wikimedia/parsoid/extension.json" );
  2. Apply the following patch.

For more details, see Topic:X8mv19b4va26u8tz.

アーキテクチャ

Flow/Architecture を参照さんしょうしてください。

スパム

FlowFlow のスパム対策たいさく詳細しょうさいは Extension:StructuredDiscussions/Spam をご参照さんしょうください。

モデレーション

Flowにおけるモデレーションの詳細しょうさいについては、Extension:StructuredDiscussions/Moderation を参照さんしょうしてください。

エクスポートとインポート

Flow のデータをエクスポートする管理かんりスクリプトがあり、Manual:DumpBackup.phpに類似るいじします。

php extensions/Flow/maintenance/dumpBackup.php

タスク T114703 - インポートのヒントをいくつか示しめします。

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:StructuredDiscussions/ja&oldid=6388363"