MediaWikiのソースを表示

Wikipediaやこのサイトで使用されている代表的なWikiシステムであるMediaWikiについて解説する。

== 初期設定 ==

<span id="cssjs"></span>
== CSS/JS ==

[https://meta.m.wikimedia.org/wiki/Help:User_style/ja Help&#58;User style/ja &#45; Meta] とかにある通り、デフォルトではcssを直接ページ内に書いても有効にならない。<code>wgAllowUserCss</code>をtrueにして有効にするか、MediaWiki&#58;Common.cssを直接編集するとよい。管理がしやすいので当サイトでは後者の方法を採用した。

当サイトでは使っていないがJSについても同じ（<code>wgAllowUserJs</code>とMediaWiki&#58;Common.js）。

<span id="スキンに関するcss"></span>
==== スキンに関するCSS ====

当サイトではVectorテーマを使用しているので、MediaWiki&#58;Vector.cssの内容も適用される。さらにVector 2022を使っているのでMediaWiki&#58;Vector&#45;2022.cssの内容も適用される。

設定内容としては、ja.wikipedia.orgに合わせて文字サイズを0.875emから0.944emに変更している。

== シェルアクセス ==

[https://www.mediawiki.org/wiki/Manual:Maintenance_scripts/Running_the_scripts#No_shell_access Manual&#58;Maintenance scripts/Running the scripts &#45; MediaWiki]にあるように、シェルアクセスがないところで使っている場合は拡張機能でどうにかする。2つ書いてあるがMaintenanceShellのほうがいろいろと良さそう。MaintenanceShellは、有効にしたあと、Special&#58;MaintenanceShellにアクセスする。

しかし、generateSitemapとかはまともに動かなかった。まあやはりというか、普通はシェルアクセスのあるところで使ったほうがいいっぽい。

<span id="api"></span>
== API ==

nodeでやる。requestはdeprecatedになったのでaxiosを使う。

cookieを使うってことがどこにも書いてなくて難しかった。[https://stackoverflow.com/questions/49367096/how-to-login-to-mediawiki-wikipedia-api-in-node-js ここ]でようやく見つけた。

== 画像 ==

[https://www.mediawiki.org/wiki/Help:Images/ja Help&#58;画像 &#45; MediaWiki]に詳しく書いてある。

MediaWikiにアップロードするのが原則だが、[https://www.mediawiki.org/wiki/Manual:$wgAllowExternalImages $wgAllowExternalImages]という変数を設定することで外部サイトの画像を直接掲載できる。このサイトは個人サイトであり、管理しやすい（普通のアップロードだとランダムなフォルダに入れられたりするし、移行が煩雑そう）のでこちらを使っている。

==== サイズ ====

<code>style&#61;&quot;max&#45;width&#58;100%&#59; height&#58;auto&#59;&quot;</code>みたいなCSS（当サイトでは前述のCommon.cssに入れた）を使えば、外部サイトの画像でもサイズを変えられる。

<span id="500-internal-server-error"></span>
==== 500 internal server error ====

アップロードまではできたが、画像ファイルが（ftpで見てもちゃんとアップロードされているのに）500 internal server errorで見れない。

これはstarserverの性質かもしれないが、どうやらimages直下の.htaccessが悪いようで、これを消したら見れた。実際に悪さをしているのは<code>Options +FollowSymLinks</code>だったっぽい。これをコメントアウトすると見れた。

<span id="urlを短くする"></span>
== URLを短くする ==

最初の設定だとURLに<code>index.php?title&#61;</code>のような見栄えのよくない文字列が入ってしまうが、Wikipediaのように<code>example.com/wiki/タイトル</code>のような形式にできる。[https://www.mediawiki.org/wiki/Manual:Short_URL/ja Manual&#58;短縮URL &#45; MediaWiki]に案内がある。そこに書いてある通り、URLに<code>?</code>が入っているのは見栄えだけでなくSEO上もあまりよくないとのこと。

注意点として、<code>index.php?title&#61;</code>形式を短い形式に強制的にリダイレクトさせるわけではない（index.phpは単なる記事の閲覧以外にも使われるので、そのように設定するのは面倒そう）。ただ、この状態でも、記事間リンクは短いURLを使ってくれるようになる。あとはWikiSEO拡張（後述）を使うと検索エンジンにも短いURLが通知される。

このサイトはサーバーがApacheなので、[https://www.mediawiki.org/wiki/Manual:Short_URL/Apache Manual&#58;Short URL/Apache &#45; MediaWiki]の通りにする。長々と説明が書いてあるが、普通に設定するなら<strong>Simple instructions</strong>のところだけ読めばよい。URLに設定したい場所（たとえば<code>wiki</code>）が既にMediaWikiのフォルダとして使われているとうまくいかない（このサイトの場合は<code>mw</code>なので大丈夫）ので、この記事の最初の方にある通りにMediaWikiのフォルダのほうを動かす。

== テンプレート ==

MediaWikiにはテンプレートというものがあり、記事のパーツを引用して使いまわすことができる。このWikiでもWikipediaの「[https://ja.wikipedia.org/wiki/Template:%E7%8B%AC%E8%87%AA%E7%A0%94%E7%A9%B6 独自研究]」などに倣ったメッセージボックスをいくつかテンプレートとして利用している。

例えば、まず以下のような汎用の<code>Mbox</code>というテンプレートを作り（色も引数で指定できるのがポイント）、

<pre style="margin-bottom:0.2em;" class="dummy_str_visual_basic">&lt;div style=&quot;border-left: 0.4rem solid #119922&quot; &gt;&lt;div style=&quot;padding-left: 10px; padding-right: 10px;  border: 1px solid #222222; background-color:#FBFBFB; border-left: 0.4rem solid {{{1}}}&quot; &gt;{{{2}}}&lt;/div&gt;
&lt;/div&gt;</pre>
<div style='text-align: center;'>Template:Mbox</div>

これを利用して下書きのテンプレートを作っている。

<pre style="margin-bottom:0.2em;" class="dummy_str_visual_basic">{{Mbox|#000022|このセクションの内容は未完成であり、今後の加筆が予定されています。}}</pre>
<div style='text-align: center;'>Template:Stub</div>

<span id="seoogp"></span>
== SEO・OGP ==

まずは[https://www.mediawiki.org/wiki/Extension:WikiSEO/ja WikiSEO]というextensionを同じように入れる。

<span id="ogp"></span>
==== OGP ====

このサイトではとりあえず大した設定はしておらず、<code>$wgWikiSeoDefaultImage &#61; &quot;http&#58;//turgenev0.starfree.jp/mw/logo0.png&quot;&#59;</code>でロゴを設定し（相対パスでも表示はされるようだが、[https://webma.xscore.co.jp/study/ogp-seo/ SNSで重要なOGPとは？SEOとの関係性や設定方法を解説 &#45;webma&#45;]とかを見ると多分絶対パスのほうがよさそう）、各ページに<code>&#123;&#123;&#35;seo&#58;|title&#61;&#123;&#123;FULLPAGENAME&#125;&#125; &#45; Turgenev&#39;s Wiki&#125;&#125;</code>と書いただけで、あとは何もしていない。先ほどの「URLを短くする」をやっておくと、そちらのURLが正規URLとして扱われる。

表示を確かめたいときは[https://developers.facebook.com/tools/debug/?locale=ja_JP シェアデバッガー &#45; Meta for Developers]を使うとよい。

<code>&#123;&#123;&#35;seo&#58;...&#125;&#125;</code>でimageなどを一度設定してしまうと、後でimageを消してもその設定がそのまま残ってしまった（WikiSEOの<code>wfLoadExtension</code>を外すと消えるが、付けるとまた復活する）。おそらくページなどを格納しているMySQLデータベースのどこかに前回の設定が残っているのであろう。ページを削除するとリセットできるがそれ以外の治し方は不明。

==== サイトマップ ====

generateSitemap.phpを使えばよい。しかし以前使っていたスターサーバーフリーではシェルアクセスがなくて使えなかったので自前で生成できるようにした（参考&#58; [[フィルターされたNotionページによるMediaWiki|フィルターされたNotionページによるMediaWiki]]）

<span id="その他seo"></span>
==== その他SEO ====

そこまでの必要性を感じないが、気が向いたらやるかも。

{{Stub}}
[[Category:IT]]{{#seo:|title={{FULLPAGENAME}} - Turgenev's Wiki}}