Project:Manual/ja

マニュアルの「ロゴ」
マニュアルの「ロゴ」

このページは MediaWiki マニュアルの議論と調整のためのものです。

マニュアルは Manual: 名前空間 (入り口は Manual:コンテンツ ) にあり、GNU フリー文書利用許諾契約書の下でリリースされています。 マニュアル本文は、別の互換性のないライセンス (詳細は Project:著作権 を参照) の下でリリースされるため、Help: 名前空間にある PD ヘルプ ページから 完全に分離 しておく必要があることにご注意ください。

Category:Manual/ja#%20

Content

For general information about what should go in which namespace, see Project:名前空間.

  • What content should be in the Manual: namespace?
    • Information on setting up a new wiki
    • Information on moving/upgrading/exporting/importing
    • Information about hooks/API/Database layout etc.
  • What should not be in the Manual: namespace?
    • Basic help on using and editing. This belongs in the Help: namespace
    • Extensions and tools, that are not part of the default MediaWiki distribution. (Extension: namespace)

構造

Skins

Skin documentation describes how developers and admins can use and create skins.

Documentation for individual skins is stored outside the Manual: namespace in the Skin: namespace.

Extensions

Extension documentation describes how developers and admins can use and create extensions.

Documentation for individual extensions is stored outside the Manual: namespace in the Extension: namespace.

Extension development

There is a set of pages that provides information for developers about how to create and modify extensions. Some of these pages are specific to extensions, like the extension.json schema, while others also include information that is relevant to MediaWiki core developers, like the hooks documentation.

The landing page for extension development is Manual:拡張機能の開発. All pages related to extension development should include the navigation template Template:Extension development at the end of the page, with the exception of individual hook and configuration variable pages.

Extension points

In the docs, strategies for extending MediaWiki core in extensions, skins, and user scripts/gadgets are referred to as extension points. Documentation about how to use extension points should be stored on a dedicated page in the Manual: namespace, such as Manual:フック. To help developers discover these extension points, the extension points available to extensions, skins, and user scripts are linked from their respective development landing pages.

Extension points used by extensions should be listed on:

Extension points used by skins should be listed on:

Extension points used by user scripts/gadgets should be listed on:

Discussion

Some discussion has been held regarding the layout of the Manual: namespace, but no formal decision has been made. The main debate is whether Manual pages should be organized in a flat hierarchy, with all pages at the root level, or with subtopics as subpages of the main topics. Here is where prior discussion has taken place:

Editorial guidelines

整形

to be discussed

色

to be discussed

スクリーンショット

  • Screenshots should be cut to show only the relevant part of the site (no browser surroundings).

Tables

to be discussed

Naming scheme non-English pages

Some general discussions about internationalisation are at Project:言語の方針.

Category:Manual/ja