Help:RU/Editing Guidelines: Difference between revisions
(Blanked the page) |
|||
Line 1: | Line 1: | ||
{{RU/Important Note|Эта вики, более старой версии ({{CURRENTVERSION}}), функциональные возможности описанные в справочных страницах [https://www.mediawiki.org Mediawiki], могут быть не работоспособны.}} | |||
Прежде чем вы посодействуете Multi Theft Auto Wiki, вы должны изучить/понять основы [http://www.mediawiki.org/wiki/Help:Contents/ru MediaWiki]. Эта статья, является руководством, как правильно редактировать MTA Wiki. | |||
== Редактирование страниц == | |||
<div style="font-size: 85%;">'' Главная справочная страница MediaWiki: [http://www.mediawiki.org/wiki/Help:Editing_pages/ru Редактирование страниц]''</div> | |||
{{RU/Note|Не дублируйте содержимое если вы хотите его использовать на нескольких страницах, используйте [[#Шаблоны|шаблоны]], что-бы содержимое можно было изменять одновременно на всех страницах.}} | |||
=== Малые изменения === | |||
Сделайте пометку "малые изменения", если изменения между отредактированной и предыдущей версией, лишь поверхностные: вроде исправления ошибок, форматирования и изменений вида, перестроения текста без его модификации, и т.п. Малое изменение является версией, которой верит редактор без её просмотра, и она не становится предметом обсуждения. Опция "малые изменения", это первое что становится доступно зарегистрированным пользователям. | |||
=== Редактирование страниц функций/событий === | |||
[[File:Layout function page.png|thumb|Формат страницы функции]] | |||
Специфическая информация для редактирования MTA вики. | |||
===== Оглавление страниц Функций/событий ===== | |||
Страницы функций и событий, имеют легко идентифицируемый и последовательный формат. Прежде чем добавлять страницы функций и/или событий, убедитесь что они есть в ядре MTA или хотя-бы есть ли такая страница на английском(посмотрите кто её добавил, во вкладке история). | |||
====== Формат страницы функции ====== | |||
* Не показывать содержание: <nowiki>__NOTOC__</nowiki> | |||
* Для указания функции клиента и/или сервера: | |||
** Функция сервера: <nowiki>{{RU/Server function}}</nowiki> | |||
** Функция клиента: <nowiki>{{RU/Client function}}</nowiki> | |||
** Функция клиента и сервера: <nowiki>{{RU/Server client function}}</nowiki> | |||
* Объясните функцию | |||
* Синтаксис: для выделения кода используйте <nowiki><syntaxhighlight lang="lua"></syntaxhighlight></nowiki> | |||
** Обязательные параметры | |||
** Необязательные параметры (не всегда нужно) | |||
* Возвращает | |||
* Примеры | |||
* Смотрите также: добавьте шаблон чтобы сгруппировать это содержимое. | |||
====== Формат страницы события ====== | |||
* Не показывать содержание: <nowiki>__NOTOC__</nowiki> | |||
* Для указания события клиента или сервера: | |||
** Событие сервера: <nowiki>{{RU/Server event}}</nowiki> | |||
** Событие клиента: <nowiki>{{RU/Client event}}</nowiki> | |||
* Параметры | |||
* Источник: источник события. | |||
* Пример | |||
* Смотрите также | |||
События могут быть серверными или клиентскими, но не одновременно. | |||
===== Советы ===== | |||
* При создании новой страницы для функции или события, вам нужно редактировать шаблон для 'смотрите также' тоже. Если вы не будете добавлять функцию/событие к групповому шаблону, эта страница - окажется сиротой. | |||
* Когда вы не хотите добавлять пример, добавьте вначале страницы: <nowiki>{{RU/Needs Example}}</nowiki>. | |||
* Если вы добавили пример на страницу, уберите ссылку на шаблон, <nowiki>{{RU/Needs Example}}</nowiki>. | |||
== Примеры скриптов == | |||
{{RU/Note| При написании примера скрипта, обязательно проверяйте и тестируйте ваш пример на работоспособность, если он не будет работать вы отнимите время всех.}} | |||
* Предпочтительно использовать четыре пробела, вместо табуляции. | |||
* Используйте подсветку кода, предусмотренную на этой вики. (<nowiki><syntaxhighlight lang="lua">(Вводите код сюда)</syntaxhighlight></nowiki>) | |||
* Если событие или функция, является одновременно серверной и клиентской, используйте шаблон для выделения: | |||
** Примеров на серверной стороне: <nowiki><section name="Пример 1" </nowiki>'''class="server"'''<nowiki> show="true"></section></nowiki> | |||
** Примеров на клиентской стороне: <nowiki><section name="Пример 2" </nowiki>'''class="client"'''<nowiki> show="false"></section></nowiki> | |||
Когда событие/функция, только серверная или клиентская, вы не должны использовать шаблон для выделения. | |||
Если есть уже достаточно примеров скриптов, уберите <nowiki>{{RU/Needs Example}}</nowiki> или <nowiki>[[Category:Needs Example]]</nowiki>. | |||
== Шаблоны == | |||
<div style="font-size: 85%;">''Главная справочная страница MediaWiki: [http://www.mediawiki.org/wiki/Help:Templates/ru Шаблоны]''</div> | |||
Шаблоны это последовательные наборы визуальных стилей и они могут быть использованы в статьях, что-бы получить внимание читателя или выделить страницу, например как устаревшую. Некоторые шаблоны также требуют аргументы, более подробно о том как использовать специфические MTA вики-шаблоны, смотрите [[RU/Help:MTA_Wiki_Specific_Templates|здесь]]. | |||
{{RU/Tip|Если вы хотите убрать оглавление страницы, используйте <nowiki>__NOTOC__</nowiki> перед другими шаблонами и/или [http://www.mediawiki.org/wiki/Help:Magic_words/ru волшебные словами], т.е. лучше если это будет первым словом на странице.}} | |||
Использование шаблонов рекомендуется, если используемое содержимое, повторяется на множестве страниц. Это сохраняет ваше время, на изменении одного и того же содержимого, и позволяет менять его одновременно на всех страницах. | |||
* [[RU/Help:MTA_Wiki_Specific_Templates|Как использовать специфические MTA вики-шаблоны]] | |||
== Защищенные страницы == | |||
Защищенные страницы не могут быть изменены обычными пользователями, если вам необходимо изменить такую страницу, обратитесь к тому есть права для их редактирования.<ref>http://www.mediawiki.org/wiki/Help:Protected_pages/ru</ref> | |||
== Страницы-сироты == | |||
Страница считается сиротой, когда никакая другая страница не ссылается на неё. Это значит, что эту страницу, возможно найти только с помощью поиска. | |||
* [[Special:LonelyPages|Страницы сироты]] | |||
* [[Добавление страниц в категории и шаблоны]] | |||
== Иконки == | |||
Если вы используете иконки, рекомендуется использовать главные иконки, это улучшает согласованность вики. | |||
* [[RU/MTA Wiki:Tango Icon List |Список "Taнго"-иконок]] | |||
== Полезные ссылки == | |||
* [http://ru.wikipedia.org/wiki/%D0%92%D0%B8%D0%BA%D0%B8%D0%BF%D0%B5%D0%B4%D0%B8%D1%8F:%D0%A8%D0%BF%D0%B0%D1%80%D0%B3%D0%B0%D0%BB%D0%BA%D0%B0 Шпаргалка википедии] - Краткий обзор главных тегов и функций редактирования. | |||
* [http://www.mediawiki.org/wiki/Help:Contents/ru Справка MediaWiki] - Главная справка для ПО MediaWiki. | |||
* [http://meta.wikimedia.org/wiki/Help:Wikitext Mediawiki примеры] | |||
== Ссылки == | |||
<references></references> | |||
[[Category:MTA Wiki:Editing]] | |||
[[en:Help:Editing_Guidelines]] |
Latest revision as of 03:05, 1 April 2016
Важное примечание: Эта вики, более старой версии (1.39.3), функциональные возможности описанные в справочных страницах Mediawiki, могут быть не работоспособны. |
Прежде чем вы посодействуете Multi Theft Auto Wiki, вы должны изучить/понять основы MediaWiki. Эта статья, является руководством, как правильно редактировать MTA Wiki.
Редактирование страниц
Примечание: Не дублируйте содержимое если вы хотите его использовать на нескольких страницах, используйте шаблоны, что-бы содержимое можно было изменять одновременно на всех страницах. |
Малые изменения
Сделайте пометку "малые изменения", если изменения между отредактированной и предыдущей версией, лишь поверхностные: вроде исправления ошибок, форматирования и изменений вида, перестроения текста без его модификации, и т.п. Малое изменение является версией, которой верит редактор без её просмотра, и она не становится предметом обсуждения. Опция "малые изменения", это первое что становится доступно зарегистрированным пользователям.
Редактирование страниц функций/событий
Специфическая информация для редактирования MTA вики.
Оглавление страниц Функций/событий
Страницы функций и событий, имеют легко идентифицируемый и последовательный формат. Прежде чем добавлять страницы функций и/или событий, убедитесь что они есть в ядре MTA или хотя-бы есть ли такая страница на английском(посмотрите кто её добавил, во вкладке история).
Формат страницы функции
- Не показывать содержание: __NOTOC__
- Для указания функции клиента и/или сервера:
- Функция сервера: {{RU/Server function}}
- Функция клиента: {{RU/Client function}}
- Функция клиента и сервера: {{RU/Server client function}}
- Объясните функцию
- Синтаксис: для выделения кода используйте <syntaxhighlight lang="lua"></syntaxhighlight>
- Обязательные параметры
- Необязательные параметры (не всегда нужно)
- Возвращает
- Примеры
- Смотрите также: добавьте шаблон чтобы сгруппировать это содержимое.
Формат страницы события
- Не показывать содержание: __NOTOC__
- Для указания события клиента или сервера:
- Событие сервера: {{RU/Server event}}
- Событие клиента: {{RU/Client event}}
- Параметры
- Источник: источник события.
- Пример
- Смотрите также
События могут быть серверными или клиентскими, но не одновременно.
Советы
- При создании новой страницы для функции или события, вам нужно редактировать шаблон для 'смотрите также' тоже. Если вы не будете добавлять функцию/событие к групповому шаблону, эта страница - окажется сиротой.
- Когда вы не хотите добавлять пример, добавьте вначале страницы: {{RU/Needs Example}}.
- Если вы добавили пример на страницу, уберите ссылку на шаблон, {{RU/Needs Example}}.
Примеры скриптов
Примечание: При написании примера скрипта, обязательно проверяйте и тестируйте ваш пример на работоспособность, если он не будет работать вы отнимите время всех. |
- Предпочтительно использовать четыре пробела, вместо табуляции.
- Используйте подсветку кода, предусмотренную на этой вики. (<syntaxhighlight lang="lua">(Вводите код сюда)</syntaxhighlight>)
- Если событие или функция, является одновременно серверной и клиентской, используйте шаблон для выделения:
- Примеров на серверной стороне: <section name="Пример 1" class="server" show="true"></section>
- Примеров на клиентской стороне: <section name="Пример 2" class="client" show="false"></section>
Когда событие/функция, только серверная или клиентская, вы не должны использовать шаблон для выделения.
Если есть уже достаточно примеров скриптов, уберите {{RU/Needs Example}} или [[Category:Needs Example]].
Шаблоны
Шаблоны это последовательные наборы визуальных стилей и они могут быть использованы в статьях, что-бы получить внимание читателя или выделить страницу, например как устаревшую. Некоторые шаблоны также требуют аргументы, более подробно о том как использовать специфические MTA вики-шаблоны, смотрите здесь.
Подсказка: Если вы хотите убрать оглавление страницы, используйте __NOTOC__ перед другими шаблонами и/или волшебные словами, т.е. лучше если это будет первым словом на странице. |
Использование шаблонов рекомендуется, если используемое содержимое, повторяется на множестве страниц. Это сохраняет ваше время, на изменении одного и того же содержимого, и позволяет менять его одновременно на всех страницах.
Защищенные страницы
Защищенные страницы не могут быть изменены обычными пользователями, если вам необходимо изменить такую страницу, обратитесь к тому есть права для их редактирования.[1]
Страницы-сироты
Страница считается сиротой, когда никакая другая страница не ссылается на неё. Это значит, что эту страницу, возможно найти только с помощью поиска.
Иконки
Если вы используете иконки, рекомендуется использовать главные иконки, это улучшает согласованность вики.
Полезные ссылки
- Шпаргалка википедии - Краткий обзор главных тегов и функций редактирования.
- Справка MediaWiki - Главная справка для ПО MediaWiki.
- Mediawiki примеры