From Fedora Project Wiki

Revision as of 19:20, 23 April 2010 by Kruvalig (talk | contribs) (Перевод начат)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This page is a draft only
It is still under construction and content may change. Do not rely on the information on this page.
Shortcut:
NAMING
This is a page that describes policies of the Fedora Project.
For policy pages, accuracy and clarity are important. You are encouraged to edit the wiki to improve it. If you have any substantive changes to make to this page, use the talk page to discuss the changes with other page maintainers. Do this before making the changes.

Пишете страницы wiki? Хотите узнать как называть их в MediaWiki? Данная страница расскажет вам о наших пожеланиях структурирования wiki, при создании новых страниц и перемещении старого содержимого.

Согласованность это хорошо, это внушает доверие читателю. Эти правила и правила Help:Editing разработаны для использования возможностей MediaWiki и соответствуют нуждам проекта Fedora, чтобы сделать проще жизнь участников и читателей.

Названия страниц

Используйте их для названия новых страниц в области. Также используйте их для планирования того куда переместить новые страницы вышедшие из старой wiki.

Основные правила при присваивании имен

Правила для станиц и разделов.

  • Не группируйте страницы с помощью подкаталогов, например Topic/FAQ
    • Исключения: Подпроекты с существующими именами ProjectName/ могут продолжать использовать одноуровневый способ размещения. Все странице одного уровня должны подчиняться следующим правилам
  • Используйте родной язык в названиях (но не при группировке страниц)
  • Используйте заглавные буквы только для первого слова в заголовке : "Подобным образом"
    • Исключения: Имя подпроекта, верное произношение, формализация заголовка/раздела, полнотекстовая документация предназначенная для преобразования в XHTML/XML
    • Пример: [[Присоединиться к проекту НазваниеПроекта]]; [[Установка USB носителя]]; [[ЧаВо по SELinux]]; [[Standing in the middle of the field#With my eyes wide open]].

Страницы предназначенные для конечных пользователей

Это страницы предназначенные для пользователей любого уровня, начинающих или высоко квалифицированных. Но это старницы не относящиеся к какому либо подпроекту или специальной группеSIG.

  • Давайте имена в основном пространстве имен; не используйте иерархию каталогов:
    • неправильно : [[FedoraLiveCD/ЧавоUSB]]
    • правильно : [[Как запустить образ Fedora с USB]]
  • Comprehensive guides (sets of pages linked together as a guide):
    • [[Guide Name - Chapter Name]]
      • Add each guide to a specific [[Category:Guide Name]]
    • For specific versions use [[F10 Guide Name - Chapter Name]]
      • Add these version specific guides to a version specific category [[Category:F10 Guide Name]], then add just that one category as a sub-category of [[Category:Guide Name]]

Project and SIG focused pages for contributors

These are pages focused on contributors who are working in one or more areas of Fedora. Some content may be end-user focused but belong within the project/SIG for reference.

The content here may be divided by one nesting level. Any further nesting needs to be squashed to the one sub-level with a natural language title. The best solution is to entirely rename without nesting, putting all pages in an appropriate Category:Foo Project category.

  • If pages are in a single nested level:
    • no : SIGs/ISV/Join
    • yes : ISV_SIG/Join
    • best : How_to_join_the_ISV_SIG
  • Content within the single nesting must be in a flat namespace with spaces
    • no : EPEL/PackageMaintainer/GenericJobDescription
    • yes : EPEL/FAQ
    • yes : EPEL/Package_Maintainer_Generic_Job_Description
    • best : Frequently_asked_questions_about_EPEL; Generic_job_description_for_package_maintainers

Namespaces

A MediaWiki namespace is a special word followed by a colon, that puts the content in a different naming area in the wiki.

Automatically searchable namespaces

  • Main:
  • FedoraProject: (default project)
  • Help:
  • Category:

User: namespace

The User: namespace is somewhere you can put drafts and other personal material that you do not want searched and indexed by engines like Google. For instance, the user jpublic can build any wiki materials as desired under User:Jpublic, using subpages. If you need to know what pages you've built under your personal User: namespace, use the Special:Prefixindex page.

Archive: namespace

Move old content to this namespace. This gets it out of the regular search index but keeps it available for future needs.

If you are archiving old content while renaming a set of pages, do not give the page a new, natural language name in the Archive: namespace. It should remain under its old name in the new namespace, to make it easier to find in historical contexts. For example, FooProject/Some/OldStuff moves to Archive:FooProject/Some/OldStuff.

Put pages in an archive category
Put archived pages an appropriate category, such as Category:Docs Project archives.

Meeting: namespace

Use this namespace for naturally named pages related to project and SIG meetings. For example, Meeting:Docs IRC log 20080806.

Put pages in a meeting category
Put the meeting in an appropriate category, such as Category:Docs Project meeting logs.

Categories

  • Use as many categories as needed that make sense:
  • The category pages are the aggregation pages. Point to them prominently as the way to find all of something on a topic/within a category.
  • New category names should follow the same natural language rules as individual pages but are usually plural:
    • Docs project meeting logs
    • Ambassadors in North America
    • 2009 events
    • Google Summer of Code activities