Project:PD ヘルプ

From mediawiki.org
This page is a translated version of the page Project:PD help and the translation is 66% 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 管理関係はマニュアルの配下に置きます。

The only small exception to this, is the 'Admin tips' boxes (described below).

Information for sysop / bureaucrat users less prominent

The Help pages would not be complete without also describing what 'sysop' users can do. However, these advanced features are not available to a majority of the target audience (most wiki users). As such, this information is to be kept slightly separate from the majority of the contents, so that normal users are not confronted with information which is not relevant to them.

Within the bulk of the Help pages, brief mentions of actions which require sysop privileges may be deemed necessary; but, detailed descriptions of sysop procedures should be tucked away on less prominently linked pages, or should be left out of the Help pages, altogether.

This section is under discussion

Editorial guidelines

  • Create links between the pages, but avoid linking to other namespaces on MediaWiki.org. Keep the links internal to the public domain help pages, or make external links (full URL) to relevant resources, e.g. on meta.wikimedia.org. This is to facilitate easier copying of the text into fresh wiki installations. Do not use interwiki links, as these may not exist in the target wiki.
  • We probably don't want to swap in the {{SITENAME}} syntax anywhere. MediaWiki is the name of the software we are describing. This is the Content Management Software (CMS), that enables the destination wiki to run, so anywhere where our text is referring to the software (everywhere throughout help), it should be left as a literal string "MediaWiki". If, for some reason, the help text is mentioning the name of the site, then this would be an appropriate exception (use {{SITENAME}}). However, we are not going to swap this in everywhere we mention the word MediaWiki.
  • Translations should be done after the English version of a page has reached a stable status. The naming convention is Pagetitle/language-code (e.g. Help:Editing/pt).
  • Unless you have the perfect solution for navigation in this manual, please refrain from creating navigation templates, and focus content creation first.
  • Do not use extensions such as Cite, since they are not installed on all MediaWiki installations.

Formatting

  • Formatting should be consistent. Use class="wikitable" for any tables you create, highlight cells or rows with {{Hl1}} etc.
  • All wiki markup and code should be put in ‎<code> or ‎<pre> tags. Help for inserting: {{subst:nw|text}}.
  • All references to menu texts and descriptions should appear in italic.

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

スクリーンショットは便利です。 PD ヘルプページ にはパブリックドメインのスクリーンショットに限定して置いてください。スクリーンショットと言ってもロゴはすべて除外し、コモンズへのアップロードに添えるライセンスのテンプレートは(GPLの場合) {{MediaWiki screenshot}} または(利用者の作成物の場合は){{CC-zero}} を選びます。

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

管理者のヒント

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

カテゴリ

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

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

関連項目

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