Руководство по наполнению вики: различия между версиями

imported>SpaceSmithers
(made less vulgar, made guide to guides more generic and on-topic, emphasized important parts, more lists, updated forum and byond account linking, moved topics around, and more.)
Нет описания правки
Строка 1: Строка 1:
== Welcome ==
== Добро пожаловать ==


We're happy you've shown interest in contributing to the wiki. We welcome all editors and assume good faith for all edits made, so there are very few [[#Protected pages|protected pages]]. Don't be afraid to jump in and start creating and modifying pages.
Мы рады, что вы проявили интерес к наполнению вики. Мы приветствуем всех редакторов и исходим из презумпции добросовестности для всех правок, поэтому у нас очень мало [[#Protected pages|защищённых страниц]].Не бойтесь действовать и начинайте создавать и изменять страницы.


=== Getting started ===
=== Начало работы ===


You will need to '''link your byond account to your forum account''' to be able to edit the wiki. Instructions can be found [https://tgstation13.org/phpBB/linkbyondaccount.php here]. In summary:  
Вам нужно будет '''привязать свой аккаунт byond к вашему аккаунту на форуме''', чтобы иметь возможность редактировать вики. Инструкции можно найти [https://tgstation13.org/phpBB/linkbyondaccount.php здесь]. Вкратце:  
# Create a Byond account (if you haven't).
# Создайте аккаунт Byond (если у вас его ещё нет).
# Create a tgstation13 forum account.
# Создайте аккаунт на форуме tgstation13.
# Link those accounts. There are multiple ways of linking accounts:
# Свяжите эти учётные записи. Существует несколько способов связать учётные записи:
##Connect to a normal /tg/ server and click the "Link Forum Account" button under the OOC tab
## Подключитесь к обычному серверу /tg/ и нажмите кнопку «Связать учётную запись форума» на вкладке OOC.
##Join a dedicated Byond server for account linking. byond://byondoauth.tgstation13.org:31337
## Присоединитесь к выделенному серверу Byond для связи учётных записей: byond://byondoauth.tgstation13.org:31337
## <span style=color:red>(Experimental/Buggy)</span> Use the link https://tgstation13.org/phpBB/linkbyondaccount.php?go=1&
## <span style=color:red>(Экспериментальный/с ошибками)</span> Используйте ссылку https://tgstation13.org/phpBB/linkbyondaccount.php?go=1&


You should now be able to see "edit" buttons on the wiki.
Теперь вы сможете увидеть кнопки «Править» на вики.


=== Important notes ===
=== Важные замечания  ===
*Please summarize your edits. You will see a textbox for a summary near the 'Save page' button when making an edit. It provides detail and clarity to a page's history and the [[Special:RecentChanges|Recent Changes log]]
* Пожалуйста, кратко описывайте свои правки. При редактировании вы увидите текстовое поле для краткого описания рядом с кнопкой «Сохранить страницу». Оно добавляет ясности и подробностей в историю страницы и [[Special:RecentChanges|журнал свежих изменений]].
*Editing any page with [[#Tabs|tabs]] may require manual flushing of the page's cache. [[#Tabs|See Tabs for more details]]<br>
* Редактирование любой страницы со [[#Tabs|вкладками]] может потребовать ручной очистки кеша страницы. [[#Tabs|Подробнее см. Вкладки]]<br>
*The wiki, for the most part, should be tailored to new players. If you are a veteran and you want to share more advanced tips and tactics, please create a clear divide between that and the other content. For example, create a new header titled "'''Advanced (subject)'''"<br>
* Вики, по большей части, должна быть ориентирована на новых игроков. Если вы ветеран и хотите поделиться более продвинутыми советами и тактиками, пожалуйста, чётко отделите их от остального контента. Например, создайте новый заголовок «'''Продвинутый (тема)'''»<br>
*The "Edit" button utilizes Mediawiki's Visual Editor, which provides a fancy interface for users who may be less proficient with [[#Wikicode|wikicode]]. The "Edit Source" button uses the old-fashioned but versatile source editor.
* Кнопка «Править» использует визуальный редактор Mediawiki, который предоставляет удобный интерфейс для пользователей, которые могут быть менее опытны в [[#Wikicode|викикоде]]. Кнопка «Править код» использует старомодный, но универсальный редактор исходного кода.


== [[Wikicode]] ==
== [[Wikicode|Викикод]] ==


Wikicode is the strange syntax used by all wikipedias, including this one. Our [[wikicode]] page provides good examples on how to insert [[Wikicode#Headers|headers]], [[Wikicode#Templates|templates]], [[Wikicode#Tables|tables]], [[Wikicode#Images|images]], and more. If we don't have what you're looking for, try the Wikipedia page [http://en.wikipedia.org/wiki/Help:Wiki_markup here]. Learning wiki markup is not mandatory, you can still help without even using it.
Викикод — это необычный синтаксис, используемый во всех вики, включая эту. Наша страница [[wikicode|викикод]] содержит хорошие примеры того, как вставлять [[Wikicode#Headers|заголовки]], [[Wikicode#Templates|шаблоны]], [[Wikicode#Tables|таблицы]], [[Wikicode#Images|Изображения]], и многое другое. Если у нас нет того, что вы ищете, попробуйте страницу Википедии [http://en.wikipedia.org/wiki/Help:Wiki_markup здесь]. Изучение разметки вики не является обязательным, вы можете помочь, даже не используя её.


== What needs doing? ==
== Что нужно сделать? ==
A to-do list for the wiki is on the /tg/ forums, and can be found [https://tgstation13.org/phpBB/viewtopic.php?f=45&t=30266 here].


=== New pages ===
Список дел для вики находится на форумах /tg/ и доступен [https://tgstation13.org/phpBB/viewtopic.php?f=45&t=30266 здесь].


New content is constantly being added to /tg/station 13 which needs tutorials and documentation. Make sure the page you want to write does not already exist before composing a new one. We welcome all contributions to the wiki and trust all edits to be made in good faith. As a recommendation, if you wish to work on a page uninterrupted and not worry about other users' edits while working, make it in your personal [[Special:MyPage/Sandbox|sandbox]] area or anywhere in your own pages. If you don't know wikicode, you can create an unformatted page and ask someone else to format it for you.
=== Новые страницы ===


=== Existing pages ===
В /tg/station 13 постоянно добавляется новый контент, для которого нужны руководства и документация. Прежде чем создавать новую страницу, убедитесь, что её ещё нет. Мы приветствуем любые материалы для вики и верим, что все правки делаются из благих побуждений. В качестве рекомендации, если вы хотите работать над страницей без перерывов и не беспокоиться о правках других пользователей во время работы, делайте это в своей личной [[Special:MyPage/Sandbox|песочнице]] или где-нибудь на своих собственных страницах. Если вы не знаете викикода, вы можете создать неформатированную страницу и попросить кого-нибудь другого отформатировать её за вас.
=== Существующие страницы ===


A list of pages that need revisions can be found [[:Category:Needs revision|here]].
Список страниц, требующих доработки, можно найти [[:Category:Needs revision|здесь]].


Updates are frequent and we need people to update the information on the wiki. To do this, simply edit the page with new information. If you don't know wikicode, you can write the new and/or updated content on the discussion page without formatting.
Обновления выходят часто, и нам нужны люди, которые будут обновлять информацию в вики. Для этого просто отредактируйте страницу, добавив новую информацию. Если вы не знаете викикода, вы можете написать новый и/или обновлённый контент на странице обсуждения без форматирования.


=== Marking for revision and deletion ===
=== Отметка для доработки и удаления ===
If a page is '''out of date''' or doesn't have a reason for existing, add one of the following tags to the top of the page:
Если страница '''устарела''' или у неё нет причин для существования, добавьте один из следующих тегов в начало страницы:


<code>
<code>
Строка 45: Строка 45:
</code>
</code>
<code>
<code>
<nowiki>{{Needs revision | reason = Out of date.}}</nowiki><br>
<nowiki>{{Needs revision | reason = Устарела.}}</nowiki><br>
</code>
</code>
or<br>
или<br>
<code>
<code>
<nowiki>{{delete}}</nowiki>
<nowiki>{{delete}}</nowiki>
</code>
</code>


=== Images ===
=== Изображения ===
====Uploading new images====
====Загрузка новых изображений====
If you have new and relevant images, then upload them and add them to the page they're intended for. It is appreciated if the pictures of items you add have a blank background and are in the .gif or .png format. The easiest way to add images of items is to download the [[Downloading the source code#Downloading|source code]], open the icons .dmi files, and export images as .gif's or .png's from there.
Если у вас есть новые и актуальные изображения, загрузите их и добавьте на страницу, для которой они предназначены. Будем благодарны, если изображения предметов, которые вы добавляете, будут иметь прозрачный фон и формат .gif или .png. Самый простой способ добавить изображения предметов — загрузить [[Downloading the source code#Downloading||исходный код]], открыть файлы значков .dmi и экспортировать изображения в формате .gif или .png оттуда.
Затем загрузите их сюда: https://tgstation13.org/wiki/Special:Upload


Then upload them here: https://tgstation13.org/wiki/Special:Upload
====Обновление существующих изображений====
Изображение может устареть после обновления исходного кода. Чтобы обновить существующее устаревшее изображение, вы можете:
* Перейти на [[Special:Upload|страницу загрузки]] и загрузить новое изображение <u>с тем же путём к файлу, что и у старого изображения</u>.
* Перейти на его страницу в вики (щёлкнув само изображение или выполнив поиск по его имени, используя префикс «Файл:» в строке поиска), щёлкнуть «Загрузить новую версию этого файла» в разделе «История файла» и выбрать новое изображение на странице загрузки.
Все устаревшие версии изображения останутся на странице истории файла для потомков.
<br>'''ВАЖНЫЕ ЗАМЕЧАНИЯ:''' Изображения можно обновлять только файлами того же формата: изображения .png нельзя обновить до .gif и наоборот. Это связано с тем, что файлы сохраняются на странице, в названии которой указан их формат. Из-за проблем с кешированием обновление существующих изображений может занять до недели.
=== Вкладки ===
На любую страницу можно добавить вкладки с помощью функции <code><nowiki><tabs></nowiki></code>. Эта функция имеет известную проблему: она отображается правильно в режиме предварительного просмотра редактирования страницы, но неправильно после применения правки. Чтобы это исправить, необходимо очистить кеш страницы. Один простой способ — добавить '''?action=purge''' в конце URL-адреса страницы. Если проблема не исчезнет, оставьте сообщение [https://tgstation13.org/phpBB/viewforum.php?f=45| на форуме].


====Updating existing images====
== Руководство по написанию и редактированию руководства ==
It is possible for an image to become depreciated following an update to the source code. To update an existing obsolete image, you can:
Всегда помните, для чего нужны эти руководства; они нужны для того, чтобы новички могли быстро просмотреть их и получить представление о том, что они только что выбрали.
*Visit the [[Special:Upload|upload page]] and upload your new image <u>with the same filepath as the old image</u>.
*Visit its page on the wiki (by either clicking the image itself or searching for its name using the "File:" prefix in the search bar), click on "upload a new version of this file" under "File history", and select your new image on the upload page.
All depreciated versions of the image will remain on the File's history page for posterity.
<br>'''IMPORTANT NOTICES:''' Images can only be updated with files of the same format: .png images cannot be updated to .gif, and vice-versa. This is because files are saved on a page that includes their format in its name. Due to caching issues, updating existing images may take up to a week to actually update.


=== Tabs ===
'''Хорошее руководство должно содержать, по порядку:'''
Any page can have tabs added to it through the <code><nowiki><tabs></nowiki></code> function. This function has the known problem of displaying correctly in a page edit preview, but incorrectly once an edit is applied. To fix this, the page's cache has to be flushed. One easy method is to add '''?action=purge''' at the end of a page's URL. If the problem persists, leave a post [https://tgstation13.org/phpBB/viewforum.php?f=45| on the forum].
* Краткое описание режима в одном-двух абзацах.
* Список из коротких, чётких и лаконичных пунктов, описывающих ключевые механики; каждый пункт должен быть не длиннее двух предложений. И помните: ключевые моменты — это то, что вам нужно знать, чтобы соответствовать минимальным ожиданиям в начале раунда. Вы должны быть в состоянии прочитать и понять его в течение 5 минут.
* Более подробный раздел, описывающий механику игры. Он включает в себя более сложную информацию, но она всё равно должна быть чёткой и лаконичной.
* Краткое изложение основных моментов; да — одно в начале и одно в конце. Повторение помогает лучше запомнить материал. Это будет, по сути, простой список, напоминающий читателю о важных деталях, а не объясняющий их.
* Дополнительная литература — здесь читатель может получить более подробную и расширенную информацию или стратегии. Если она должна быть написана на главной странице, чётко отделите её от остального контента, например, новым заголовком. В противном случае перечислите соответствующие статьи, чтобы пользователи могли погрузиться в кроличью нору!
* Гиперссылки! Не забудьте добавить ссылки на [[Game modes|режимы игры]], [[Guides#Antagonist Guides|aроли антагонистов]], [[профессии]], предметы и [[руководства]] о которых вы упомянули! Лучше делать это на этапе корректуры, чтобы не тратить время при написании самой статьи.


== Guide to Writing and Revising a Guide ==
Примером плохого руководства будет огромная стена текста, которая содержит слишком много воды и/или полна неинформативных мнений.<br>
Always keep in mind what these guides are for; they're so newbies can quickly skim across them so they can have half an idea of what they've just been selected for.
Это отпугнёт как новых, так и опытных игроков. Старайтесь не перегружать и не пугать новичков.


'''A good guide needs, by order:'''
'''Итак, помните:'''
* A brief one-two paragraph description of what the mode is.
* Факты — это хорошо, мнения — плохо.
* A bullet point list of short, clear, and concise points of key mechanics; these should be no longer than two sentences each. And remember: key points means the important stuff you need to know to meet minimum expectations at the start of the round. You should be able to read and understand it within 5 minutes.
* Излагайте факты чётко, без лишней воды.
* A more detailed section describing the game mechanics in depth. This includes more advanced information, but it should still be clear and concise.
* Основы должны быть простыми, а более сложная информация — в отдельном разделе или на отдельной странице.
* A summary of the key points; yes - one at the start and one at the end. Reiteration helps to hammer things home. This one will more or less be a simple list to remind the reader of important details, it won't explain them.
* Важная информация в первую очередь, подробности, объяснения и несущественные вещи — потом.
* Further reading - this is where the reader can get more detailed and advanced information or strategies. If it is to be written on the main page, have a clear divide between this and the rest of the content, like a new header. Otherwise, list the relevant articles for users to sink into the rabbit hole!
* Пробелы, таблицы, разделы и форматирование имеют важное значение для удобства чтения. Мы не печатное издание, место не ограничено, поэтому используйте его свободно.
* Hyperlinks! Remember to add links to [[Game modes|game modes]], [[Guides#Antagonist Guides|antagonist roles]], [[jobs]], items and [[guides]] you mention! It's better to do it during the proofreading stage as to not waste any time actually writing the article.
* Ссылки!
* Я только что использовал вышеприведённый шаблон, чтобы написать это руководство.


An example of a bad guide would be a giant wall of text that's overly fluffed up and/or full of uninformative opinions.<br>
== Шутки ==
This will scare away new and veteran players alike. Try not to overload or intimidate newbies.
Некоторые отсылки (и даже целые страницы) предназначены для развлечения. Однако новичок может не понять, что что-то является шуткой или сарказмом, даже если это очевидно для всех остальных. Это особенно важно при написании руководств. Подумайте, где уместны шутки, а где нет, и действительно ли они смешные.


'''So remember:'''
== Полезные страницы ==
* Facts good, opinions bad.
* Keep your facts clear of irrelevant fluff.
* Keep the basic guide basic, keep the advanced stuff on a separate section or page.
* Important stuff first; depth, explanation, and unimportant things later.
* White space, tables, sections, and formatting are essential for ease of reading. We're not print media, space isn't at a premium so use it freely.
* Links!
* I just used the above template to write this guide.


== Jokes ==
'''Категории:''' [[Special:Categories|Используемые]], [[Special:UnusedCategories|неиспользуемые]] и [[Special:WantedCategories|нужные]]
Some references (and even entire pages) are designed to be entertaining. However, a newbie might not realize something is a joke or sarcasm, even if it's blatantly obvious to the rest of us. This is especially important when writing guides. Think about where jokes fit and where they don't, and if they're actually funny.


== Useful pages ==
'''Шаблоны:''' [[Special:MostLinkedTemplates|Используемые]], [[Special:UnusedTemplates|неиспользуемые]] и [[Special:WantedTemplates|нужные]]


'''Categories:''' [[Special:Categories|Used]], [[Special:UnusedCategories|unused]] and [[Special:WantedCategories|wanted]]
'''Файлы:''' [[Special%3AListFiles|Все]], [[Special:UnusedFiles|неиспользуемые]] и [[Special:WantedFiles|нужные]]


'''Templates:''' [[Special:MostLinkedTemplates|Used]], [[Special:UnusedTemplates|unused]] and [[Special:WantedTemplates|wanted]]
'''Все страницы:''' [[Special:AllPages|Все существующие страницы]] и [[Special:WantedPages|Нужные страницы]]


'''Files:''' [[Special%3AListFiles|All]], [[Special:UnusedFiles|unused]] and [[Special:WantedFiles|wanted]]
==Защищённые страницы==
Очень немногие страницы защищены из-за их административной важности, деликатного содержания или чрезмерного вандализма. Редактировать эти страницы могут только администраторы. Список защищённых страниц можно найти [[Special:ProtectedPages|здесь]].


'''All pages:''' [[Special:AllPages|All existing pages]] and [[Special:WantedPages|Wanted pages]]
==Страницы обсуждения==
В вики у статей есть '''страницы обсуждения''', а у пользователей — '''страницы обсуждения участников'''. Использование этих страниц не является распространённым явлением, но они обычно используются для общения между пользователями (очевидно) и предложения правок,  [[#Protected pages|защищённых страницах]].<br>
При написании на странице обсуждения или странице обсуждения участника (например, [[Talk:Main_Page]]), нужно знать несколько вещей.


==Protected pages==
===Подпись===
Very few pages are protected for their administrative importance, sensitive content, or excessive griefing. Only administrators can edit these pages. A list of protected pages can be found [[Special:ProtectedPages|here]].
Всегда заканчивайте своё сообщение подписью, чтобы все знали, кто что написал (без необходимости проверять историю правок).<br>
 
Это нужно делать, написав <code><nowiki>~~~~</nowiki></code> после своего сообщения. Вы можете настроить свою подпись на своей странице [[Special:Preferences|настроек]].
==Talk Pages==
Within the wiki, articles have a '''discussion page''' and users have a '''talk page'''. The use of these pages is uncommon, but they are usually used for communication between users (obviously), and suggesting edits, especially on [[#Protected pages|protected pages]].<br>
When writing on a discussion or talk page (for example [[Talk:Main_Page]]), there are a few things you need to know.
 
===Signature===
Always end your message with your signature, so everyone knows who wrote what (without having to check the edit history).<br>
This should be done by writing <code><nowiki>~~~~</nowiki></code> after your message. You can customize your signature on your [[Special:Preferences|user preferences page]].


{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
|-
|-
!Code:
!Код:
||
||
<nowiki>Look. ~~~~</nowiki>
<nowiki>Смотри. ~~~~</nowiki>
|-
|-
!Result:
!Результат:
||
||
Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)
Смотри. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:35, 30 ноября 2013 (CET)
|}
|}


===Indentation===
===Отступ===
When replying to another user's message, be sure to ''indent'' your message so it is visibly a reply to the above message.<br>
При ответе на сообщение другого пользователя обязательно сделайте '''отступ''' в своём сообщении, чтобы было видно, что это ответ на предыдущее сообщение.<br>
This is done by simply adding <code><nowiki>:</nowiki></code> at the start of the line.
Это делается путём добавления <code><nowiki>:</nowiki></code> в начале строки.


{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
|-
|-
!Code:
!Код:
||
||
<nowiki>Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)</nowiki><br>
<nowiki>Смотри. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:35, 30 ноября 2013 (CET)</nowiki><br>
<nowiki>:At what? ~~~~</nowiki>
<nowiki>:На что? ~~~~</nowiki>
|-
|-
!Result:
!Результат:
||
||
Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)
Смотри. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:35, 30 ноября 2013 (CET)
:At what? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:40, 30 November 2013 (CET)
:На что? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:40, 30 ноября 2013 (CET)
|}
|}


===Headline===
===Заголовок===
If you are starting a new topic, add a headline with the name of the topic. If a talk page is used a lot, it can become confusing if the topics aren't separated with headlines. It also allows for section editing, which makes editing long talk pages a lot easier.<br>
Если вы начинаете новую тему, добавьте заголовок с названием темы. Если страница обсуждения используется часто, на ней может быть трудно ориентироваться, если темы не разделены заголовками. Это также позволяет редактировать отдельные разделы, что значительно упрощает редактирование длинных страниц обсуждения.<br>
This is one of the most basic and commonly used features on a wiki. It is used by typing <code><nowiki>==Topic==</nowiki></code> on the line above your message. Just replace "Topic" with whatever it is you're talking about.
Это одна из самых основных и часто используемых функций в вики. Она используется путём ввода <code><nowiki>==Тема==</nowiki></code> в строке над вашим сообщением. Просто замените «Тема» на то, о чём вы говорите.


{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
|-
|-
!Code:
!Код:
||
||
<nowiki>==Look at this tutorial==</nowiki><br>
<nowiki>==Посмотрите на это руководство==</nowiki><br>
<nowiki>Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)</nowiki><br>
<nowiki>Смотри. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:35, 30 ноября 2013 (CET)</nowiki><br>
<nowiki>:At what? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:40, 30 November 2013 (CET)</nowiki><br>
<nowiki>:На что? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:40, 30 ноября 2013 (CET)</nowiki><br>
<nowiki>::This tutorial I made. ~~~~</nowiki>
<nowiki>::На это руководство, которое я написал. ~~~~</nowiki>
|-
|-
!Result:
!Результат:
||
||
<font size="4">Look at this tutorial</font> <nowiki>[</nowiki><span style="color: blue">edit</span><nowiki>]</nowiki>
<font size="4">Посмотрите на это руководство</font> <nowiki>[</nowiki><span style="color: blue">править</span><nowiki>]</nowiki>
----
----
Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)
Смотри. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:35, 30 ноября 2013 (CET)
:At what? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:40, 30 November 2013 (CET)
:На что? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:40, 30 ноября 2013 (CET)
::This tutorial I made. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:45, 30 November 2013 (CET)
::На это руководство, которое я написал. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:45, 30 ноября 2013 (CET)
|}
|}
{{Contribution guides}}
{{Contribution guides}}
[[Category:Meta]]
[[Category:Meta]]

Версия от 06:34, 6 августа 2024

Добро пожаловать

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

Начало работы

Вам нужно будет привязать свой аккаунт byond к вашему аккаунту на форуме, чтобы иметь возможность редактировать вики. Инструкции можно найти здесь. Вкратце:

  1. Создайте аккаунт Byond (если у вас его ещё нет).
  2. Создайте аккаунт на форуме tgstation13.
  3. Свяжите эти учётные записи. Существует несколько способов связать учётные записи:
    1. Подключитесь к обычному серверу /tg/ и нажмите кнопку «Связать учётную запись форума» на вкладке OOC.
    2. Присоединитесь к выделенному серверу Byond для связи учётных записей: byond://byondoauth.tgstation13.org:31337
    3. (Экспериментальный/с ошибками) Используйте ссылку https://tgstation13.org/phpBB/linkbyondaccount.php?go=1&

Теперь вы сможете увидеть кнопки «Править» на вики.

Важные замечания

  • Пожалуйста, кратко описывайте свои правки. При редактировании вы увидите текстовое поле для краткого описания рядом с кнопкой «Сохранить страницу». Оно добавляет ясности и подробностей в историю страницы и журнал свежих изменений.
  • Редактирование любой страницы со вкладками может потребовать ручной очистки кеша страницы. Подробнее см. Вкладки
  • Вики, по большей части, должна быть ориентирована на новых игроков. Если вы ветеран и хотите поделиться более продвинутыми советами и тактиками, пожалуйста, чётко отделите их от остального контента. Например, создайте новый заголовок «Продвинутый (тема)»
  • Кнопка «Править» использует визуальный редактор Mediawiki, который предоставляет удобный интерфейс для пользователей, которые могут быть менее опытны в викикоде. Кнопка «Править код» использует старомодный, но универсальный редактор исходного кода.

Викикод

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

Что нужно сделать?

Список дел для вики находится на форумах /tg/ и доступен здесь.

Новые страницы

В /tg/station 13 постоянно добавляется новый контент, для которого нужны руководства и документация. Прежде чем создавать новую страницу, убедитесь, что её ещё нет. Мы приветствуем любые материалы для вики и верим, что все правки делаются из благих побуждений. В качестве рекомендации, если вы хотите работать над страницей без перерывов и не беспокоиться о правках других пользователей во время работы, делайте это в своей личной песочнице или где-нибудь на своих собственных страницах. Если вы не знаете викикода, вы можете создать неформатированную страницу и попросить кого-нибудь другого отформатировать её за вас.

Существующие страницы

Список страниц, требующих доработки, можно найти здесь.

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

Отметка для доработки и удаления

Если страница устарела или у неё нет причин для существования, добавьте один из следующих тегов в начало страницы:

{{Needs revision}}
 {{Needs revision | reason = Устарела.}}
 или
{{delete}}

Изображения

Загрузка новых изображений

Если у вас есть новые и актуальные изображения, загрузите их и добавьте на страницу, для которой они предназначены. Будем благодарны, если изображения предметов, которые вы добавляете, будут иметь прозрачный фон и формат .gif или .png. Самый простой способ добавить изображения предметов — загрузить |исходный код, открыть файлы значков .dmi и экспортировать изображения в формате .gif или .png оттуда. Затем загрузите их сюда: https://tgstation13.org/wiki/Special:Upload

Обновление существующих изображений

Изображение может устареть после обновления исходного кода. Чтобы обновить существующее устаревшее изображение, вы можете:

  • Перейти на страницу загрузки и загрузить новое изображение с тем же путём к файлу, что и у старого изображения.
  • Перейти на его страницу в вики (щёлкнув само изображение или выполнив поиск по его имени, используя префикс «Файл:» в строке поиска), щёлкнуть «Загрузить новую версию этого файла» в разделе «История файла» и выбрать новое изображение на странице загрузки.

Все устаревшие версии изображения останутся на странице истории файла для потомков.
ВАЖНЫЕ ЗАМЕЧАНИЯ: Изображения можно обновлять только файлами того же формата: изображения .png нельзя обновить до .gif и наоборот. Это связано с тем, что файлы сохраняются на странице, в названии которой указан их формат. Из-за проблем с кешированием обновление существующих изображений может занять до недели.

Вкладки

На любую страницу можно добавить вкладки с помощью функции <tabs>. Эта функция имеет известную проблему: она отображается правильно в режиме предварительного просмотра редактирования страницы, но неправильно после применения правки. Чтобы это исправить, необходимо очистить кеш страницы. Один простой способ — добавить ?action=purge в конце URL-адреса страницы. Если проблема не исчезнет, оставьте сообщение на форуме.

Руководство по написанию и редактированию руководства

Всегда помните, для чего нужны эти руководства; они нужны для того, чтобы новички могли быстро просмотреть их и получить представление о том, что они только что выбрали.

Хорошее руководство должно содержать, по порядку:

  • Краткое описание режима в одном-двух абзацах.
  • Список из коротких, чётких и лаконичных пунктов, описывающих ключевые механики; каждый пункт должен быть не длиннее двух предложений. И помните: ключевые моменты — это то, что вам нужно знать, чтобы соответствовать минимальным ожиданиям в начале раунда. Вы должны быть в состоянии прочитать и понять его в течение 5 минут.
  • Более подробный раздел, описывающий механику игры. Он включает в себя более сложную информацию, но она всё равно должна быть чёткой и лаконичной.
  • Краткое изложение основных моментов; да — одно в начале и одно в конце. Повторение помогает лучше запомнить материал. Это будет, по сути, простой список, напоминающий читателю о важных деталях, а не объясняющий их.
  • Дополнительная литература — здесь читатель может получить более подробную и расширенную информацию или стратегии. Если она должна быть написана на главной странице, чётко отделите её от остального контента, например, новым заголовком. В противном случае перечислите соответствующие статьи, чтобы пользователи могли погрузиться в кроличью нору!
  • Гиперссылки! Не забудьте добавить ссылки на режимы игры, aроли антагонистов, профессии, предметы и руководства о которых вы упомянули! Лучше делать это на этапе корректуры, чтобы не тратить время при написании самой статьи.

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

Итак, помните:

  • Факты — это хорошо, мнения — плохо.
  • Излагайте факты чётко, без лишней воды.
  • Основы должны быть простыми, а более сложная информация — в отдельном разделе или на отдельной странице.
  • Важная информация в первую очередь, подробности, объяснения и несущественные вещи — потом.
  • Пробелы, таблицы, разделы и форматирование имеют важное значение для удобства чтения. Мы не печатное издание, место не ограничено, поэтому используйте его свободно.
  • Ссылки!
  • Я только что использовал вышеприведённый шаблон, чтобы написать это руководство.

Шутки

Некоторые отсылки (и даже целые страницы) предназначены для развлечения. Однако новичок может не понять, что что-то является шуткой или сарказмом, даже если это очевидно для всех остальных. Это особенно важно при написании руководств. Подумайте, где уместны шутки, а где нет, и действительно ли они смешные.

Полезные страницы

Категории: Используемые, неиспользуемые и нужные

Шаблоны: Используемые, неиспользуемые и нужные

Файлы: Все, неиспользуемые и нужные

Все страницы: Все существующие страницы и Нужные страницы

Защищённые страницы

Очень немногие страницы защищены из-за их административной важности, деликатного содержания или чрезмерного вандализма. Редактировать эти страницы могут только администраторы. Список защищённых страниц можно найти здесь.

Страницы обсуждения

В вики у статей есть страницы обсуждения, а у пользователей — страницы обсуждения участников. Использование этих страниц не является распространённым явлением, но они обычно используются для общения между пользователями (очевидно) и предложения правок, защищённых страницах.
При написании на странице обсуждения или странице обсуждения участника (например, Talk:Main_Page), нужно знать несколько вещей.

Подпись

Всегда заканчивайте своё сообщение подписью, чтобы все знали, кто что написал (без необходимости проверять историю правок).
Это нужно делать, написав ~~~~ после своего сообщения. Вы можете настроить свою подпись на своей странице настроек.

Код:

Смотри. ~~~~

Результат:

Смотри. - Deantwo (обсуждение) 10:35, 30 ноября 2013 (CET)

Отступ

При ответе на сообщение другого пользователя обязательно сделайте отступ в своём сообщении, чтобы было видно, что это ответ на предыдущее сообщение.
Это делается путём добавления : в начале строки.

Код:

Смотри. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:35, 30 ноября 2013 (CET)
:На что? ~~~~

Результат:

Смотри. - Deantwo (обсуждение) 10:35, 30 ноября 2013 (CET)

На что? - Deantwo (обсуждение) 10:40, 30 ноября 2013 (CET)

Заголовок

Если вы начинаете новую тему, добавьте заголовок с названием темы. Если страница обсуждения используется часто, на ней может быть трудно ориентироваться, если темы не разделены заголовками. Это также позволяет редактировать отдельные разделы, что значительно упрощает редактирование длинных страниц обсуждения.
Это одна из самых основных и часто используемых функций в вики. Она используется путём ввода ==Тема== в строке над вашим сообщением. Просто замените «Тема» на то, о чём вы говорите.

Код:

==Посмотрите на это руководство==
Смотри. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:35, 30 ноября 2013 (CET)
:На что? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|обсуждение]]) 10:40, 30 ноября 2013 (CET)
::На это руководство, которое я написал. ~~~~

Результат:

Посмотрите на это руководство [править]

Смотри. - Deantwo (обсуждение) 10:35, 30 ноября 2013 (CET)

На что? - Deantwo (обсуждение) 10:40, 30 ноября 2013 (CET)
На это руководство, которое я написал. - Deantwo (обсуждение) 10:45, 30 ноября 2013 (CET)
Hosting Hosting a server • Setting up the database • Working with /tg/station as an upstream repository
Contributing Guide to contributing to the game • Setting up git • Downloading the source code • Reporting issues • Changelogs
Coding Understanding SS13 code • SS13 for experienced programmers • Code docs • Coding standards • Getting Your Pull Accepted • Binary flags‎ • Text Formatting • MySQL
Mapping Guide to mapping • Map merger • Guide to door access
Spriting Guide to spriting • Resolving icon conflicts
Wiki Guide to contributing to the wiki • Wikicode • Autowiki
Источник — https://tg.ss220.club/index.php?title=Руководство_по_наполнению_вики&oldid=74023