Jump to content

Project:PD ヘルプ

From mediawiki.org
This page is a translated version of the page Project:PD help and the translation is 100% complete.
Project:PD help は、MediaWiki 利用者、つまり MediaWiki を利用した Web サイトへの訪問者向けの簡潔な利用者ヘルプ ページの集合体を作成するプロジェクトです。

このプロジェクトは、ヘルプ名前空間のすべてのコンテンツを網羅しています。 このプロジェクトのメインのエントリ ポイントは Help:コンテンツ です。

このヘルプの説明文書は、マニュアル (GFDL または CC BY-SA ライセンスの MediaWiki 管理者マニュアル) とは別のものです。 貢献者の皆さん、違いについて明確に理解してください。 PD ヘルプ ページには、MediaWiki ソフトウェアのインストール、構成、保守の方法に関するサーバー管理者向けの情報は含まれていません。 私たちが達成しようとしていることの詳細な説明については、以下の「目標」節を参照してください。

  コンテンツをメタ・ウィキのヘルプ ページからここにコピー & ペーストしないでください

それらは GFDL または CC BY-SA ライセンスの下で書かれており、パブリック ドメインではありません

目標

目標はページの集合体を提供し、新しく導入されたウィキに転写したり、MediaWiki の配布物に含めたりできるようにすることです。 これは、基礎的な利用者情報と、その他のメタ情報を適度に簡潔な形で含んでいます。 基本的な概念は、リファレンスではなく、圧縮された利用者ガイド」を作成することです。利用者が何を求めているかに焦点を当て、他の機能の説明はしないようにすべきです。

ライセンス

PD ヘルプへの貢献 (編集) は、CC0 waiver を介してパブリック・ドメインとして公開されます。 これは、利用者が自分のウィキのインストレーションに簡単にテキストをコピーできるようにするために必要です。 以下の内容をご理解の上、投稿をお願いします:

  • PD ヘルプ名前空間に置くページはすべて、ライセンス状態を示す一文 {{PD Help Page}} を含む必要があります。
  • 他のあらゆる場所からコンテンツをこれらのページに転写することは許されません。唯一の例外は次の場合のみです。
  1. 転写したコンテンツは利用者ご本人(たとえば著者作者)の作成物、もしくは 原著作者から許諾を文書で受ける必要があります。
  2. すでにパブリックドメイン にあるものはここに転写できます。ただし、ネット空間に公開されたものの大部分はこの範囲に該当しません
  • ここに貢献する情報に関与した権利はすべて放棄するものとします。このWebサイトでは引き続き、皆さん貢献した文書を一覧でき属性も表示されますが、他の誰でも貢献者の名称を示さないまま文書を転写したり、必要に応じて文書を改変したりすることを認められています。

対象の閲覧者層:通常の利用者

ヘルプページは全般として、ウィキの特定のウェブサイトを開く通常のサイト訪問者を対象に想定しています。

サーバ管理者ではない人向け

ここで MediaWiki 解説文書を全文、複写するつもりはありません。 サーバ管理者向けの情報、インストールの詳細な説明や設定、あるいは MediaWiki 管理関係はマニュアルの配下に置きます。

ここではごく限定的な例外として、「管理者用ヒント」(Admin tips)の箱組み類があります(詳細はこのページの後半)。

システム管理者 / ビューロクラット権限の利用者向けの付加情報

ヘルプページ類 は、「システム管理者」(sysop)の権限範囲を解説しないと完璧とは言えません。 しかしながら、これら高度な機能は、そのターゲットとなる観衆の大多数(ウィキ利用者ほぼ全員)は利用できないものです。 それゆえに、この情報は大部分のコンテンツから少し離して保管し、一般利用者が自分に無関係の情報にぶつからないようにしてあります。

大量にある ヘルプページ類 には、シスオペ権限(Sysop)が必須の操作を簡単に述べるべきだと見なされる場合があります。それでもシスオペ手順の詳細な説明は一切、ヘルプページから除外する必要があり、リンク先が少なめのページに折り込むことは許容範囲です。

この部分はまだ 協議中です

編集のガイドライン

  • ページ間を結ぶリンクを作る時は、名前空間 MediaWiki.org のページへのリンクはしないでください。リンク元はあくまでもパブリックドメイン指定のヘルプページに限定するか、たとえば meta.wikimedia.org など適切な情報源と外部リンク形式(URL の生リンク)で結びます。この回避策は、新規開設のウィキに文字列を簡便に転写できるようにするためです。ウィキ間リンクは使わず、持ち込み先のウィキに(訳注:仕組みそのものが)ない可能性にご配慮願います。
  • おそらく、{{SITENAME}}の構文はどこであれ、入れ替えは賢明ではないはずです。MediaWikiこそ、私たちがここで説明しているソフトウェアの名前だからです。これについては「コンテンツ管理ソフトウェア」(CMS=Content Management Software)の範疇であり、宛先ウィキの実行を可能にしようとして文字列から(ヘルプ全体のどこかの)場所を参照するとソフトウェア名が示される際には、文字通りの文字列「MediaWiki」として残しておく必要があります。ヘルプの文中に何らかの理由でサイト名が記載済みの場合は、例外とした適切です({{SITENAME}}を使用)。それはそれとして、MediaWikiという言葉に言及する場所すべてでこれに入れ替えるつもりなどありません
  • 翻訳はあくまでも、英語版原文がある程度、安定するのを待ってから取り掛かります。ページ名の命名規則は Pagetitle/language-codeを採用(例=Help:Editing/pt)。
  • コンテンツ作成を第一優先として、このマニュアルの完璧な 歩き方の解決策を知らない限り、ナビゲーション用テンプレートの作成はしないこと。
  • Citeなど拡張機能は、MediaWikiのインストール先で採用していない場合に配慮し、使いません。

書式設定

  • 書式設定は一貫させます。表を作るなら必ずclass="wikitable" を採用、セルもしくは列を強調したいなら {{Hl1}} を使うなどです。
  • ウィキマークアップやコート類はすべて、 ‎<code> または ‎<pre> タグで挟みます。挿入方法 のヘルプ:{{subst:nw|text}}
  • メニューの文字列ならびに説明を参照させる場合は 斜体(イタリック体)にします。

スクリーンショットの画像

スクリーンショットは便利です。 PD ヘルプ ページに含めるスクリーンショットは、パブリック ドメインに限定する必要はありません (ただし、商標登録されたロゴは含めてはいけません)。 画面キャプチャ(スクショ)を必ずウィキメディア・コモンズにアップロード、ライセンスは {{MediaWiki screenshot}} テンプレートを付与すること。

画像の移転には解説文書を添付する、もしくは インスタントコモンズ 経由でコモンズにあるファイルを閲覧できます。

管理者のヒント

サーバ管理者の権限で実施するヘルプ の設定がある場合は、「管理者のヒント」を記入して{{Admin tip }}を添えます。

カテゴリ

「Help:」名前空間にあるページはすべて、定義上はこのパブリックドメインのヘルプ解説文書プロジェクトの配下にありり、したがって分類はカテゴリ:ヘルプ にする必要があります。 MediaWiki 拡張機能に対応するヘルプページ は、下位分類カテゴリ:拡張機能ヘルプ に入れてください。

「Help:」名前空間、つまりパブリックドメインである当ヘルプ解説文書プロジェクトに含まれるページは、以前、カテゴリはCategory:PD helpでした。 簡略さを保ち、カテゴリは単に カテゴリ:ヘルプ になり全てのページを更新しました。

関連項目

  • Project:言語の方針  – ヘルプページ英語版以外で取り組みたいと思った皆さん。
  • Project:PD help/export  – 便利なヘルプ名前空間として提示されたダンプ作りの方法を協議。この段階ではまだ話し合いのみで実際の機能化はその後。