Помощь с Wiki: различия между версиями

мНет описания правки
м Nemesis переименовал страницу Helping Out в Помощь с Wiki
 
(не показана 1 промежуточная версия 1 участника)
Строка 2: Строка 2:




=Before you begin=
=Перед началом=
* The [[Special:SpecialPages]] page is the #1 weapon against unorganized or lacking wiki pages. It can be reached from the [http://i.imgur.com/pTsPYpc.png main menu cogwheel].
* Страница [[Special:SpecialPages]] — главный инструмент в борьбе с неорганизованными или неполными вики-страницами. Её можно открыть через [http://i.imgur.com/pTsPYpc.png значок шестерёнки в главном меню].
* The [[Special:Version]] special page has useful information on what extensions are installed for more advanced knowledge on wiki syntax and functionality.
* Страница [[Special:Version]] содержит информацию об установленных расширениях, полезную для более глубокого понимания вики-синтаксиса и функционала.
* If you're not sure how to use wiki syntax, check out the official [https://www.mediawiki.org/wiki/Help:Formatting Mediawiki Formatting] page.
* Если вы не уверены, как пользоваться вики-разметкой, загляните на официальную страницу [https://www.mediawiki.org/wiki/Help:Formatting MediaWiki Formatting].
* Check out your [[Special:Preferences | "Editing" user preferences]] and make sure you have the enhanced editing toolbar enabled, among other optional tweaks.
* Проверьте свои [[Special:Preferences | настройки редактирования]] и убедитесь, что у вас включена расширенная панель инструментов и другие нужные опции.


=Стандарты редактирования=
Редакционные стандарты крайне важны, ведь вики — это главный способ обучения игроков. Она должна быть читабельной и понятной для всех: будь то описание механики, профессии или касты.


=Editing Standard=
==Философия редактирования==
The editing standard of the wiki is extremely important, as the wiki is what governs how players learn the game. So it has to be legible and coherent for what it is you are trying to display/explain, whether its a mechanic or a job/caste.
При создании новой страницы или редактировании существующей основная философия такова: как можно больше визуальных материалов для читателя — изображений и gif-анимаций, демонстрирующих, как работает та или иная механика или выглядит предмет. Длинные текстовые блоки — это именно то, чего следует избегать. Единственное исключение — страницы с лором.


==Editing Philosophy==
Одна из важнейших задач при написании или редактировании статьи — упростить информацию настолько, чтобы она была понятна каждому игроку. Неважно, является ли он носителем английского языка или изучает его как второй — простота изложения делает вашу правку хорошей, ведь чем проще подача, тем больше людей её поймут.
When it comes to creating a new page or editing a pre-existing page the current design philosophy on the wiki is to provide a lot of visual feedback to the reader i.e. Images and gifs displaying what X mechanic or item does and what it looks like. This is because lots and lots of text is what the reader does NOT want to have to go through in order to find out how to do X. The only exception to that rule is pages regarding lore.


Хороший пример — преподавание. Если учитель объясняет тему запутанно и занудно, ученики, скорее всего, не поймут материал, могут заскучать или потерять нить. Но если объяснение будет коротким и чётким — понять его будет намного проще. Вики-редактор — это невидимый преподаватель для сотен игроков, поэтому ваша подача должна быть логичной и доступной.


One of the most important goals to consider when writing or editing a wiki page is that you want the information that you are providing to be in it's most simplest form so that it is easy to understand for any and all players. Whether it is for someone who is a native english speaker or someone who is an ESL, the simplicity of the explanation is what make your edit good because it means that more people can understand it.
'''Вопросы, которые стоит задать себе при редактировании или создании страницы:'''
* Я не написал(а) слишком много?
* Можно ли сократить текст?
* Можно ли упростить формулировки?
* Можно ли добавить наглядные материалы к описанию?
* Поймёт ли это новый игрок без контекста?


''Если вы не уверены в своей правке — отправьте её в предпросмотр в канал #wiki-work на Discord. Там участники и мейнтейнер вики дадут обратную связь.''


An example of this is via teaching, if your teacher explains a topic in a convoluted and long winded manner then the likelihood of the class fully understanding said topic is very low as some students may get bored or find it hard to follow. If they explain it in a short and concise manner, then it is a lot simpler to understand. The example of teaching is because as a wiki editor you're the unseen teacher of the hundreds who play this game, so your explanations etc need to make sense and be easy to follow.
И наконец, перед сохранением страницы обязательно напишите краткое описание изменений. Это помогает структурировать изменения и показывает другим редакторам, когда и что было добавлено. Вот пример описания для этого раздела:
 
 
'''Questions to think about when editing a page or creating a new one:'''
 
* Have I written too much?
* Could I condense this down?
* Could I simplify my writing?
* Could I provide visual aid to what I'm explaining?
* Would a new player be able to understand this without any prior context knowledge?
 
''If you are ever in doubt about your edit just post a preview of your edit in  #wiki-work on discord for wiki contributors and the wiki maintainer to look at and provide feedback.''
 
 
Lastly, after finishing an edit, write a brief summary of what the edit is before you save page as it helps organise your edit amongst all the others so other editors can see when a certain section or topic was added to a page. Here's the summary for this section being added to give you an example of what this should look like:


[[File:Page_summary.png|link=]]
[[File:Page_summary.png|link=]]


=Mediawiki Code=
This section is to cover the basics of mediawiki code  so that new and returning wiki contributors can refresh themselves with the basic and adanced code.




=Код MediaWiki=
Этот раздел охватывает основы кода MediaWiki, чтобы новые и вернувшиеся участники могли освежить знания базового и продвинутого форматирования.


<tabs>
<tabs>
<tab name="Basic Formatting Code">
<tab name="Базовое форматирование">


{| style="border: 2px solid black; class="mw-collapsible"
{| class="wikitable"
! style="background-color:#31532f; width:150px;"|'''Action to be performed:'''
! style="background-color:#31532f; width:150px;"|'''Действие'''
! style="background-color:#31532f;"|<center>'''The Code:'''</center>
! style="background-color:#31532f;"|'''Код'''
! style="background-color:#31532f;"|<center>'''The Output:'''</center>
! style="background-color:#31532f;"|'''Результат'''
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Removes the table of contents
| Отключение оглавления
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki>__NOTOC__</nowiki></center>
| <nowiki>__NOTOC__</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Removes the table of contents.
| Убирает автоматическое оглавление со страницы (код не отображается при просмотре).
 
The code will not appear on the page when viewed.</center>
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Applying Bolding to text
| Жирный текст
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki>'''Bold'''</nowiki></center>
| <nowiki>'''Жирный'''</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> '''Bold'''</center>
| '''Жирный'''
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Applying Italics to text
| Курсив
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki>''Italics''</nowiki></center>
| <nowiki>''Курсив''</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center>''Italics''</center>
| ''Курсив''
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Applying underlines to text
| Подчёркнутый текст
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki><U>Underline Text.</U></nowiki>
| <nowiki><u>Подчёркнутый</u></nowiki>
 
<small>''HTML используется, так как в MediaWiki нет встроенного подчёркивания.''</small>
 
| <u>Подчёркнутый</u>
<small>''This is HTML code as mediawiki does not have a native underline command.''</small></center>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><U>Underline Text.</U></center>
 
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Applying strikethroughs to text
| Зачёркнутый текст
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki><S>Strikethrough Text.</S></nowiki>
| <nowiki><s>Зачёркнутый</s></nowiki>
 
<small>''HTML используется, так как в MediaWiki нет встроенного зачёркивания.''</small>
 
| <s>Зачёркнутый</s>
<small>''This is HTML code as mediawiki does not have a native strikethrough command.''</small></center>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><S>Strikethrough Text.</S></center>
 
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Making formatting Centered
| Центрирование текста
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki><center>Centered Text.</center></nowiki>
| <nowiki><center>По центру</center></nowiki>
 
<small>''HTML используется, так как нет встроенной функции центрирования.''</small>
 
| <center>По центру</center>
<small>''This is HTML code as mediawiki does not have a native center command.''</small></center>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center>Centered Text.</center>
 
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Dividing line
| Разделительная линия
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> This is a
| <nowiki>----</nowiki>
<nowiki>----</nowiki>
| ----
 
Dividing Line
</center>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center>This is a
----
Dividing Line</center>
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Page headers
| Заголовки
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |
| <nowiki>= Заголовок 1 =</nowiki>
 
<nowiki>== Заголовок 2 ==</nowiki>
<nowiki>= Page Header One=</nowiki>
<nowiki>=== Заголовок 3 ===</nowiki>
* <small>''This is the same header level as the page title at the top, so normally you won't use this and instead will use header two.''</small>
<nowiki>==== Заголовок 4 ====</nowiki>
 
<nowiki>===== Заголовок 5 =====</nowiki>
 
<nowiki>====== Заголовок 6 ======</nowiki>
<nowiki>== Page Header Two==</nowiki>
<small>Можно также вставлять изображения в заголовки:</small> 
 
<nowiki>======[[Файл:Vendor Utilities.png]] Пример [[Файл:Vendor Utilities.png]]======</nowiki>
<nowiki>=== Page Header Three ===</nowiki>
| См. изображение ниже:
 
[[Файл:Wiki_Page_Headers.png|link=]]
<nowiki>==== Page Header Four ====</nowiki>
 
<nowiki>===== Page Header Five =====</nowiki>
 
<nowiki>====== Page Header Six ======</nowiki>
 
 
A way that we like to use headers is to place images{Files) in them to help them stand out visually for the reader.
 
 
<small><nowiki>======[[File:Vendor Utilities.png]] Marine Vendor [[File:Vendor Utilities.png]] ======</nowiki></small>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | To avoid messing up the table of contents for this page the below image will detail what this would look like.
[[File:Wiki_Page_Headers.png|link=]]
 
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Bullet Points
| Маркированный список
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | This is a
| <nowiki>* Пункт списка</nowiki>
<nowiki>* Bullet Point</nowiki>
| * Пункт списка
 
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | This is a
* Bullet Point
 
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Numbered List
| Нумерованный список
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | This is a
| <nowiki># Первый</nowiki>
<nowiki>
<nowiki># Второй</nowiki>
# Numbered List 1</nowiki>
<nowiki># Третий</nowiki>
 
| # Первый 
<nowiki># Numbered List 2</nowiki>
# Второй 
 
# Третий
<nowiki># Numbered List 3</nowiki>
 
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | This is a
# Numbered List 1
# Numbered List 2
# Numbered List 3
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Linking outside the wiki
| Внешняя ссылка
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki>[https://cm-ss13.com/forums/ Linking outside the wiki]</nowiki></center>
| <nowiki>[https://cm-ss13.com/forums/ Ссылка]</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center>[https://cm-ss13.com/forums/ Linking outside the wiki]</center>
| [https://cm-ss13.com/forums/ Ссылка]
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Linking within the wiki
| Внутренняя ссылка
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki>[[Marine_Equipment | Linking within the wiki]]</nowiki>
| <nowiki>[[Название_страницы|Текст ссылки]]</nowiki>
 
| [[Marine_Equipment|Текст ссылки]]
 
<nowiki>[[Pagename (as it appears in the address bar)| Desired Words]]</nowiki></center>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center>[[Marine_Equipment | Linking within the wiki]]</center>
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Displaying Images
| Отображение изображений
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |
| <nowiki>[[Файл:Vendor Utilities.png]]</nowiki>
 
<nowiki>[[Файл:Vendor Utilities.png|32px]]</nowiki>
 
<nowiki>[[Файл:Vendor Utilities.png|128px]]</nowiki>
<center><nowiki>[[File:Vendor Utilities.png]]</nowiki>
<small>Размер изображения можно менять, указав нужную ширину в пикселях.</small>
 
 
<nowiki>[[File:Vendor Utilities.png|32px]]</nowiki>
 
 
<nowiki>[[File:Vendor Utilities.png|128px]]</nowiki>
 
 
<small>''You can alter the display size of a file by changing the pixels as shown above.''</small>
</center>
 
----
----
*Most files are uploaded to be 64x64px, so please keep to this.
* Обычно используется размер 64x64px
*Remember if the image you desire is not on the wiki, please upload it [[Special:Upload | HERE.]]
* Если нужного файла нет — [[Special:Upload|загрузите его здесь]]
*Please be certain beforehand that it is not on the wiki first. If you're unsure ask in #wiki-work on discord.</center>
* Убедитесь, что файл действительно отсутствует. Если не уверены — спросите в Discord, канал <code>#wiki-work</code>.
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center>
| [[Файл:Vendor Utilities.png|link=]]
[[File:Vendor Utilities.png|link=]]
[[Файл:Vendor Utilities.png|32px|link=]]
[[File:Vendor Utilities.png|32px|link=]]
[[Файл:Vendor Utilities.png|128px|link=]]
[[File:Vendor Utilities.png|128px|link=]]
 
</center>
|}
|}
</tab>
</tab>


<tab name="Продвинутый код">


 
{| class="wikitable"
<tab name="Advanced Formatting Code">
! style="background-color:#31532f; width:150px;"|'''Действие'''
 
! style="background-color:#31532f;"|'''Код'''
{| style="border: 2px solid black; class="mw-collapsible"
! style="background-color:#31532f;"|'''Результат'''
! style="background-color:#31532f; width:150px;"|'''Action to be performed:'''
! style="background-color:#31532f;"|<center>'''The Code:'''</center>
! style="background-color:#31532f;"|<center>'''The Output:'''</center>
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Text for just the editors
| Комментарий только для редакторов
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki>
| <nowiki><!-- Этот текст виден только при редактировании --></nowiki>
<!-- The Gaps are here for readability when editing --></nowiki></center> <small>This of course will not show up in the Output section as you will only see it if you open a page to edit.</small>
<small>Не отображается при просмотре страницы.</small>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <!-- The Gaps are here for readability when editing --></center>
| <!-- Этот текст виден только при редактировании -->
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | No wiki code
| Отключение вики-разметки
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki><nowiki>'''Bold'''</nowiki></nowiki></center> <small>This stops wikicode from functioning, highly useful when filling out a usage section on a template.</small>
| <nowiki><nowiki>'''Жирный'''</nowiki></nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki>'''Bold'''</nowiki></center>
<small>Полезно для шаблонов, где нужен "пример кода".</small>
| <nowiki>'''Жирный'''</nowiki>
|}
|}
</tab>
</tab>


<tab name="Table Formatting Code">
<tab name="Форматирование таблиц">


{| style="border: 2px solid black; class="mw-collapsible"
{| class="wikitable"
! style="background-color:#31532f; width:150px;"|'''Action to be performed:'''
! style="background-color:#31532f; width:150px;"|'''Действие'''
! style="background-color:#31532f;"|<center>'''The Code:'''</center>
! style="background-color:#31532f;"|'''Код'''
! style="background-color:#31532f;"|<center>'''The Output:'''</center>
! style="background-color:#31532f;"|'''Результат'''
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Fill in
| Простая таблица
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki>Fill in</nowiki></center>
| <nowiki>{| class="wikitable"</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Fill in</center>
<nowiki>! Заголовок 1 !! Заголовок 2</nowiki>
|-
<nowiki>|-</nowiki>
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Fill in
<nowiki>| Ячейка 1 || Ячейка 2</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki>Fill in</nowiki></center>
<nowiki>|}</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Fill in</center>
| {| class="wikitable" 
! Заголовок 1 !! Заголовок 2 
|-
| Ячейка 1 || Ячейка 2 
|}
|}
|}
</tab>
</tab>


<tab name="Advanced Table Formatting">
<tab name="Продвинутое форматирование таблиц">


{| style="border: 2px solid black; class="mw-collapsible"
{| class="wikitable"
! style="background-color:#31532f; width:150px;"|'''Action to be performed:'''
! style="background-color:#31532f; width:150px;"|'''Действие'''
! style="background-color:#31532f;"|<center>'''The Code:'''</center>
! style="background-color:#31532f;"|'''Код'''
! style="background-color:#31532f;"|<center>'''The Output:'''</center>
! style="background-color:#31532f;"|'''Результат'''
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Fill in
| Объединение ячеек по горизонтали
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> <nowiki>Fill in</nowiki></center>
| <nowiki>| colspan="2" | Объединённая ячейка</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Fill in</center>
| <table class="wikitable">
<tr><td colspan="2">Объединённая ячейка</td></tr>
</table>
|-
|-
|style="width:125px; border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | Fill in
| Объединение ячеек по вертикали
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" | <center><nowiki>Fill in</nowiki></center>
| <nowiki>| rowspan="2" | Вертикально</nowiki>
|style="border: 2px solid black; border-bottom: 2px solid black; padding: 5px;" |<center> Fill in</center>
| <table class="wikitable">
<tr><td rowspan="2">Вертикально</td><td>Рядом</td></tr>
<tr><td>Рядом 2</td></tr>
</table>
|}
|}
</tab>
</tabs>


</tab>


</tabs>
=Вклад/Дополнение=
 
* Разместите <nowiki>{{outdated}}</nowiki> в начале статьи, чтобы отобразить баннер о том, что страница устарела и нуждается в обновлении. [[:Category:Outdated|Список всех устаревших страниц здесь]] — вы можете помочь с их актуализацией.
* [[Special:ShortPages|Короткие страницы]] могут нуждаться в дополнительной информации.
* [[Special:WantedFiles|Запрашиваемые файлы]] — это изображения, которые упоминаются, но ещё не загружены. В 90% случаев вы можете сообщить об этом [https://cm-ss13.com/wiki/User:Sargeantmuffinman Sargeantmuffinman], [https://cm-ss13.com/memberlist.php?mode=viewprofile&u=239 TopHatPenguin] или Harryob — они смогут загрузить оригинальный файл из игровых ресурсов. 
<small>⚠️ Объединённые иконки (например, персонаж в броне с оружием) не подходят — нужны отдельные спрайты.</small>
* [[Special:WantedPages|Запрашиваемые страницы]] — это страницы, ссылки на которые уже существуют, но сами статьи пока не созданы. Если чувствуете, что можете — смело беритесь за написание!
* Если вы [[Special:Upload|загружаете файл]], обязательно проверьте, нет ли его уже в [[Special:ListFiles|списке загруженных файлов]]. 
'''ВНИМАНИЕ:''' если файл уже существует, **загружайте новую версию поверх старой** — [http://i.imgur.com/2Zj2ckj.png не создавайте дубликаты с другим именем].
* Таблицы имеют свой удобный синтаксис и легко редактируются вручную. Подробнее читайте в официальной справке MediaWiki: [https://www.mediawiki.org/wiki/Help:Tables#Wiki_table_markup_summary Help:Tables]. 
Также есть внешние генераторы, например: [http://www.tablesgenerator.com/mediawiki_tables Mediawiki Tables Generator].
* [https://www.mediawiki.org/wiki/Help:Templates Шаблоны] — мощный инструмент, позволяющий избежать дублирования кода и упростить оформление страниц. 
[http://cm-ss13.com/wiki/Special:AllPages?from=&to=&namespace=10 Ознакомьтесь с нашими шаблонами]. 
Пример: добавьте <nowiki>{{tocright}}</nowiki>, чтобы переместить оглавление вправо.
* Расширенные шаблоны могут использовать [https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions ParserFunctions] — условия, вычисления, обработка строк и т.д. 
Это позволяет, например, отображать "Изображение не найдено", если файл отсутствует.
* Также полезны [https://www.mediawiki.org/wiki/Help:Magic_words Магические слова] — особенно в шаблонах или особых случаях (например, скрытие оглавления).
* Остальные справочные страницы MediaWiki доступны здесь: [https://www.mediawiki.org/wiki/Category:Help Категория справки].


=Contributing=
=Очистка=
* Place <nowiki>{{outdated}}</nowiki> at the top of a wiki page to display a banner showing that the page is outdated and needs help. [[:Category:Outdated|View all outdated pages here]] - you're welcome to help update them.
* [[Special:ShortPages]] might be looking for more data.
* [[Special:WantedFiles]] are all linked images that don't have a file attached to them. In 90% of cases, you can let [https://cm-ss13.com/wiki/User:Sargeantmuffinman Sargeantmuffinman], [https://cm-ss13.com/memberlist.php?mode=viewprofile&u=239 TopHatPenguin] or Harryob know about these and they can upload the correct icon directly from source files. (Combined icons won't work for this, such as a human wearing armor, clothing, and holding weapons.)
* [[Special:WantedPages]] are links to pages that don't exist yet, but someone feels it's needed.
* If you [[Special:Upload | upload a file]], make sure it doesn't already exist by checking [[Special:ListFiles]]. '''It is crucial that existing files are replaced by [http://i.imgur.com/2Zj2ckj.png uploading a new version] - DO NOT upload another version of the file with a different name!'''
* Tables have their own markup that is clean and easy to edit. Visit the official Mediawiki [https://www.mediawiki.org/wiki/Help:Tables#Wiki_table_markup_summary Help:Tables] page for more info. There are also a few 3rd-party tools to assist with formatting, such as the [http://www.tablesgenerator.com/mediawiki_tables Mediawiki Tables Generator].
* [https://www.mediawiki.org/wiki/Help:Templates Templates] are extremely powerful wiki additions that help eliminate redundancy in markup and provide a clean, easy-to-edit layout for future contributors. [http://cm-ss13.com/wiki/Special:AllPages?from=&to=&namespace=10 Check out the templates we're using]. For example, you can add <nowiki>{{tocright}}</nowiki> to any page to have the Table of Contents move to the right side of the page. Advanced templates can include [https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions ParserFunctions] (using #if, #ifexp, #switch, etc) for calculation and string handling (e.g. item infoboxes that show a default "Image not found" image if one doesn't exist), leading to some very clean and professional-looking documentation.
* Some other features include [https://www.mediawiki.org/wiki/Help:Magic_words Magic Words], which can be useful in templates or in special cases, such as hiding the Table of Contents (TOC).
* [https://www.mediawiki.org/wiki/Category:Help All other Mediawiki-specific Help pages are here] if you'd like to learn more.


=Cleaning=
* [[Special:LonelyPages|Одинокие страницы]] — список статей, на которые никто не ссылается. Возможно, их нужно переработать или удалить. 
* [[Special:LonelyPages]] has a list of pages that ''might'' need to be deleted or worked on (anything deleted can be restored).
<small>⚠️ Удалённые страницы всегда можно восстановить.</small>
* [[Special:UnusedFiles]] might also need to be deleted (anything deleted can be restored).
* [[Special:UnusedFiles|Неиспользуемые файлы]] тоже можно удалить, если они не нужны.
** Note: normal users are unable to delete pages, but [http://cm-ss13.com/wiki/index.php?title=Special:ListUsers&group=Trusted Trusted users] can.
** Примечание: обычные участники не могут удалять страницы, но это могут сделать [http://cm-ss13.com/wiki/index.php?title=Special:ListUsers&group=Trusted доверенные пользователи].

Текущая версия от 15:29, 25 мая 2025


Перед началом

  • Страница Special:SpecialPages — главный инструмент в борьбе с неорганизованными или неполными вики-страницами. Её можно открыть через значок шестерёнки в главном меню.
  • Страница Special:Version содержит информацию об установленных расширениях, полезную для более глубокого понимания вики-синтаксиса и функционала.
  • Если вы не уверены, как пользоваться вики-разметкой, загляните на официальную страницу MediaWiki Formatting.
  • Проверьте свои настройки редактирования и убедитесь, что у вас включена расширенная панель инструментов и другие нужные опции.

Стандарты редактирования

Редакционные стандарты крайне важны, ведь вики — это главный способ обучения игроков. Она должна быть читабельной и понятной для всех: будь то описание механики, профессии или касты.

Философия редактирования

При создании новой страницы или редактировании существующей основная философия такова: как можно больше визуальных материалов для читателя — изображений и gif-анимаций, демонстрирующих, как работает та или иная механика или выглядит предмет. Длинные текстовые блоки — это именно то, чего следует избегать. Единственное исключение — страницы с лором.

Одна из важнейших задач при написании или редактировании статьи — упростить информацию настолько, чтобы она была понятна каждому игроку. Неважно, является ли он носителем английского языка или изучает его как второй — простота изложения делает вашу правку хорошей, ведь чем проще подача, тем больше людей её поймут.

Хороший пример — преподавание. Если учитель объясняет тему запутанно и занудно, ученики, скорее всего, не поймут материал, могут заскучать или потерять нить. Но если объяснение будет коротким и чётким — понять его будет намного проще. Вики-редактор — это невидимый преподаватель для сотен игроков, поэтому ваша подача должна быть логичной и доступной.

Вопросы, которые стоит задать себе при редактировании или создании страницы:

  • Я не написал(а) слишком много?
  • Можно ли сократить текст?
  • Можно ли упростить формулировки?
  • Можно ли добавить наглядные материалы к описанию?
  • Поймёт ли это новый игрок без контекста?

Если вы не уверены в своей правке — отправьте её в предпросмотр в канал #wiki-work на Discord. Там участники и мейнтейнер вики дадут обратную связь.

И наконец, перед сохранением страницы обязательно напишите краткое описание изменений. Это помогает структурировать изменения и показывает другим редакторам, когда и что было добавлено. Вот пример описания для этого раздела:


Код MediaWiki

Этот раздел охватывает основы кода MediaWiki, чтобы новые и вернувшиеся участники могли освежить знания базового и продвинутого форматирования.

Действие Код Результат
Отключение оглавления __NOTOC__ Убирает автоматическое оглавление со страницы (код не отображается при просмотре).
Жирный текст '''Жирный''' Жирный
Курсив ''Курсив'' Курсив
Подчёркнутый текст <u>Подчёркнутый</u>

HTML используется, так как в MediaWiki нет встроенного подчёркивания.

Подчёркнутый
Зачёркнутый текст <s>Зачёркнутый</s>

HTML используется, так как в MediaWiki нет встроенного зачёркивания.

Зачёркнутый
Центрирование текста <center>По центру</center>

HTML используется, так как нет встроенной функции центрирования.

По центру
Разделительная линия ---- ----
Заголовки = Заголовок 1 =

== Заголовок 2 == === Заголовок 3 === ==== Заголовок 4 ==== ===== Заголовок 5 ===== ====== Заголовок 6 ====== Можно также вставлять изображения в заголовки: ======[[Файл:Vendor Utilities.png]] Пример [[Файл:Vendor Utilities.png]]======

См. изображение ниже:

Маркированный список * Пункт списка * Пункт списка
Нумерованный список # Первый

# Второй # Третий

# Первый
  1. Второй
  2. Третий
Внешняя ссылка [https://cm-ss13.com/forums/ Ссылка] Ссылка
Внутренняя ссылка [[Название_страницы|Текст ссылки]] Текст ссылки
Отображение изображений [[Файл:Vendor Utilities.png]]

[[Файл:Vendor Utilities.png|32px]] [[Файл:Vendor Utilities.png|128px]] Размер изображения можно менять, указав нужную ширину в пикселях.


  • Обычно используется размер 64x64px
  • Если нужного файла нет — загрузите его здесь
  • Убедитесь, что файл действительно отсутствует. Если не уверены — спросите в Discord, канал #wiki-work.

Действие Код Результат
Комментарий только для редакторов <!-- Этот текст виден только при редактировании -->

Не отображается при просмотре страницы.

Отключение вики-разметки <nowiki>'''Жирный'''</nowiki>

Полезно для шаблонов, где нужен "пример кода".

'''Жирный'''
Действие Код Результат
Простая таблица {| class="wikitable"

! Заголовок 1 !! Заголовок 2 |- | Ячейка 1 || Ячейка 2 |}

class="wikitable" Заголовок 1 Заголовок 2
Ячейка 1 Ячейка 2

|}

Действие Код Результат
Объединение ячеек по горизонтали | colspan="2" | Объединённая ячейка
Объединённая ячейка
Объединение ячеек по вертикали | rowspan="2" | Вертикально
ВертикальноРядом
Рядом 2


Вклад/Дополнение

  • Разместите {{outdated}} в начале статьи, чтобы отобразить баннер о том, что страница устарела и нуждается в обновлении. Список всех устаревших страниц здесь — вы можете помочь с их актуализацией.
  • Короткие страницы могут нуждаться в дополнительной информации.
  • Запрашиваемые файлы — это изображения, которые упоминаются, но ещё не загружены. В 90% случаев вы можете сообщить об этом Sargeantmuffinman, TopHatPenguin или Harryob — они смогут загрузить оригинальный файл из игровых ресурсов.

⚠️ Объединённые иконки (например, персонаж в броне с оружием) не подходят — нужны отдельные спрайты.

ВНИМАНИЕ: если файл уже существует, **загружайте новую версию поверх старой** — не создавайте дубликаты с другим именем.

  • Таблицы имеют свой удобный синтаксис и легко редактируются вручную. Подробнее читайте в официальной справке MediaWiki: Help:Tables.

Также есть внешние генераторы, например: Mediawiki Tables Generator.

  • Шаблоны — мощный инструмент, позволяющий избежать дублирования кода и упростить оформление страниц.

Ознакомьтесь с нашими шаблонами. Пример: добавьте {{tocright}}, чтобы переместить оглавление вправо.

  • Расширенные шаблоны могут использовать ParserFunctions — условия, вычисления, обработка строк и т.д.

Это позволяет, например, отображать "Изображение не найдено", если файл отсутствует.

  • Также полезны Магические слова — особенно в шаблонах или особых случаях (например, скрытие оглавления).
  • Остальные справочные страницы MediaWiki доступны здесь: Категория справки.

Очистка

  • Одинокие страницы — список статей, на которые никто не ссылается. Возможно, их нужно переработать или удалить.

⚠️ Удалённые страницы всегда можно восстановить.