DecimalWiki:Памятка для авторов: различия между версиями

Материал из Decimal Wiki
Перейти к навигации Перейти к поиску
Нет описания правки
Нет описания правки
 
(не показано 16 промежуточных версий этого же участника)
Строка 1: Строка 1:
Это развивающееся руководство о том, как внести свой вклад в [[Decimal Wiki]] и над чем работать.
{{Справка}}
{{TOC right}}
 
'''Это развивающееся руководство о том, как внести свой вклад в [[Decimal Wiki]] и над чем работать.'''


Целью Decimal Wiki является создание и поддержка аккуратного, обновляемого, завершённого и лёгкого в использовании справочника для всех, кто интересуется блокчейном Decimal и сферой криптоэкономики в целом. Присоединяйтесь к нашему проекту! Чтобы создавать и редактировать статьи, вам необходимо [[Служебная:Создать учётную запись|зарегистрироваться]].
Целью Decimal Wiki является создание и поддержка аккуратного, обновляемого, завершённого и лёгкого в использовании справочника для всех, кто интересуется блокчейном Decimal и сферой криптоэкономики в целом. Присоединяйтесь к нашему проекту! Чтобы создавать и редактировать статьи, вам необходимо [[Служебная:Создать учётную запись|зарегистрироваться]].
== Быстрые советы ==
* [[#Тон|Тон статьи]] должен быть информативным и полу-профессиональным. Используйте третье лицо (напр., «криптоинвесторы», «участники рынка») в вводной части статьи. Вы можете использовать второе лицо в последующих параграфах и предложениях, но старайтесь не писать от первого лица.
* [[#Длина статьи|Длина страницы или раздела]] должна быть настолько велика, насколько требуется, но не больше; статья должна быть информативной и сжатой.
* Используйте [[#Форматирование|форматирование текста]] (напр., '''жирное начертание''', ''курсив'') умеренно. Старайтесь не использовать <font color="red">цветной текст</font>, <s>зачеркивание</s>, <u>подчеркивание</u>.
* Соблюдайте [[#Правописание|правописание]] русского языка. Пишите полными предложениями, за исключением таблиц.
* Добавляйте в текст соответствующие внутренние и внешние [[#Ссылки|ссылки]].
* Добавьте [[#Изображения|изображения]], если они будут полезны в контексте статьи; перед добавлением попробуйте поискать нужное вам изображение на странице [[Служебная:Список_файлов]], а также в различных категориях изображений, чтобы избежать дубликатов. При [[#Заменить или удалить?|обновлении существующего изображения]] загружайте новую версию того же самого файла, вместо загрузки нового изображения.
* Добавляйте [[#Категории|категории]] в статьи, если очевидная/полезная категория отсутствует. Проверьте страницу [[Служебная:Категории|категорий]], чтобы узнать, какую категорию можно добавить на страницу, и воздержитесь от создания категорий, которые не используются.
* После внесения изменений, укажите в специальном поле снизу, что вы изменили. Это поможет остальным редакторам проверить вашу работу
* [[#Переименование страниц|Переименование страниц]] допустимо только в случае крайней необходимости. Если вы считаете, что это необходимо, оставьте соответствующий запрос к администраторам на странице обсуждения статьи.
* Если вы считаете, что страница должна быть удалена, оставьте соответствующий запрос к администраторам на странице обсуждения статьи или поставьте на странице шаблон <code><nowiki>{{delete|Причина удаления}}</nowiki></code>; укажите причину удаления.


== С чего начать ==
== С чего начать ==
Вы можете начать вносить свой вклад Decimal Wiki, создав [[Служебная:Создать учётную запись|учетную запись пользователя]]. Обязательно входите в неё каждый раз, когда редактируете, чтобы вы могли получить оценку за свои правки и чтобы мы могли признать ваш вклад.
Вы можете начать вносить свой вклад Decimal Wiki, создав [[Служебная:Создать учётную запись|учетную запись пользователя]]. Обязательно входите в неё каждый раз, когда редактируете, чтобы вы могли получить оценку за свои правки и чтобы мы могли признать ваш вклад.
{{!!!}}'''Незарегистрированные пользователи не могут создавать и править статьи в Decimal Wiki.'''


После регистрации не стесняйтесь заполнить страницу своего профиля некоторой информацией о себе. Давайте познакомимся с вами!
После регистрации не стесняйтесь заполнить страницу своего профиля некоторой информацией о себе. Давайте познакомимся с вами!
Если вам нужна помощь в редактировании, прочтите [[DecimalWiki:Правила оформления страниц|это пособие]].


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


Decimal Wiki — не просто справочник по блокчейну Decimal. Мы рассчитываем создать полноценную вики-энциклопедию, посвящённую сфере [[Криптовалюта|криптовалют]], [[блокчейн]]ов и [[Web3]], что предполагает создание обширного корпуса статей. Разобраться, какие темы затрагиваются в нашей вики, вам поможет [[Служебная:Требуемые страницы|список требуемых статей]].
Decimal Wiki — не просто справочник по блокчейну Decimal. Мы рассчитываем создать полноценную вики-энциклопедию, посвящённую сфере [[Криптовалюта|криптовалют]], [[блокчейн]]ов и [[Web3]], что предполагает создание обширного корпуса статей. Разобраться, какие темы затрагиваются в нашей вики, вам поможет [[Служебная:Требуемые страницы|список требуемых статей]].


Если у вас нет практического опыта создания или редактирования вики, вы можете начать с помощи в улучшении существующих страниц. Обратите внимание на [[:Категория:Незавершённые статьи|список незаконченных статей]]. Исправление опечаток и грамматических ошибок (даже пропущенных точек) имеет значение. Рассмотрите возможность внесения незначительных правок как способ научиться ориентироваться на сайте и пользоваться редактором, прежде чем начать вносить крупные дополнения в страницы или создавать полноценные статьи.
{{совет|Если у вас нет практического опыта создания или редактирования вики, вы можете начать с помощи в улучшении существующих страниц. Обратите внимание на [[:Категория:Незавершённые статьи|список незаконченных статей]]. Исправление опечаток и грамматических ошибок (даже пропущенных точек) имеет значение. Рассмотрите возможность внесения незначительных правок как способ научиться ориентироваться на сайте и пользоваться редактором, прежде чем начать вносить крупные дополнения в страницы или создавать полноценные статьи.}}


Прежде чем вносить серьезные изменения, воспользуйтесь страницей обсуждения статьи, чтобы обсудить содержание, разрешить любые конфликты и обсудить что-либо конкретное по данной статье. Уважение — это ключ к успеху. Не забывайте подписывать правки на страницах обсуждения.
Прежде чем вносить серьезные изменения, воспользуйтесь страницей обсуждения статьи, чтобы обсудить содержание, разрешить любые конфликты и обсудить что-либо конкретное по данной статье. Уважение — это ключ к успеху. Не забывайте подписывать правки на страницах обсуждения.
Одним из хороших источников редактирования идей является список страниц с [[:Категория:SuggestedChanges|предлагаемыми изменениями]].


Просмотр и (при необходимости) редактирование или удаление спекулятивного контента помогает сохранить точность вики.
Просмотр и (при необходимости) редактирование или удаление спекулятивного контента помогает сохранить точность вики.


=== Подписка на правки ===
== Как создать статью ==
Если вы хотите следить за изменениями в этой вики-странице или следить за новыми пользователями и правками, используйте [[Special:RecentChanges|страницу свежих правок]].
{{заготовка раздела}}
 
Если вы хотите следить за изменениями в этой вики или следить за новыми пользователями и редакторами, используйте «[[Служебная:RecentChanges|последние изменения]]».


== Как здесь редактировать ==
{{!!!}}В настоящее время визуальный редактор в нашей вики проходит стадию отладки, поэтому правка текстов возможна только в редакторе кода. Если вам нужна помощь в работе с вики-разметкой, прочтите [[DecimalWiki:Правила оформления страниц|это пособие]].
* Нажмите ссылку «Править» в верхней части страницы. Откроется страница редактирования с текстом статьи и особыми символами — «вики-разметкой».
* Внесите желаемые изменения в исходный текст.
* Кратко опишите смысл своей правки в строке «Описание изменений».
* Для проверки правильного отображения страницы нажмите кнопку «Предварительный просмотр».
* Если со страницей всё в порядке, опубликуйте свою новую версию нажатием кнопки «Записать страницу».


== Быстрые советы по редактированию ==
* [[#Тон|Тон статьи]] должен быть информативным и полу-профессиональным. Используйте третье лицо (напр., «криптоинвесторы», «участники рынка») в вводной части статьи. Допустимо использовать второе лицо в последующих параграфах и предложениях (особенно когда создаёте страницу инструкции), но старайтесь не писать от первого лица, если только вы не пишете о собственной компании.
* [[#Длина статьи|Длина страницы или раздела]] может быть настолько велика, насколько требуется, но не больше; статья должна быть информативной и сжатой.
* Используйте [[#Форматирование|форматирование текста]] (напр., '''жирное начертание''', ''курсив'') умеренно. Старайтесь не использовать <font color="red">цветной текст</font>, <s>зачеркивание</s>, <u>подчеркивание</u>.
* Соблюдайте [[#Правописание|правописание]] русского языка. Пишите полными предложениями, за исключением таблиц.
* Добавляйте в текст соответствующие внутренние и внешние [[#Ссылки|ссылки]].
* Добавьте [[#Изображения|изображения]], если они будут полезны в контексте статьи; перед добавлением попробуйте поискать нужное вам изображение на странице [[Служебная:Список_файлов]], а также в различных категориях изображений, чтобы избежать дубликатов. При [[#Заменить или удалить?|обновлении существующего изображения]] загружайте новую версию того же самого файла, вместо загрузки нового изображения.
* Добавляйте [[#Категории|категории]] в статьи, если очевидная/полезная категория отсутствует. Проверьте страницу [[Служебная:Категории|категорий]], чтобы узнать, какую категорию можно добавить на страницу, и воздержитесь от создания категорий, которые не используются.
* После внесения изменений, укажите в специальном поле снизу, что вы изменили. Это поможет остальным редакторам проверить вашу работу
* [[#Переименование страниц|Переименование страниц]] допустимо только в случае крайней необходимости. Если вы считаете, что это необходимо, оставьте соответствующий запрос к администраторам на странице обсуждения статьи.
* Если вы считаете, что страница должна быть удалена, оставьте соответствующий запрос к администраторам на странице обсуждения статьи или поставьте на странице шаблон <code><nowiki>{{удалить|Причина удаления}}</nowiki></code>; укажите причину удаления.
* Если вы хотите следить за изменениями в этой вики-странице или следить за новыми пользователями и правками, используйте [[Служебная:Свежие правки|страницу свежих правок]].


=== Советы новичкам вики ===
== Стиль статей ==
* Using the source editor (rather than the visual or classic editor) is recommended, as it is more powerful, allows for more precise editing, and enables you to view helpful comments that may have been left by other editors. You can make it your default editor via the «Preferred editor» dropdown in the [[Special:Preferences#mw-prefsection-editing|editing tab]] of your Wikia preferences. If the source editor is not your default editor, you can still access it by clicking the dropdown arrow on a page’s «Edit» button.
 
* [http://badges.wikia.com/wiki/Badge Badges] help determine [[Guidance for Scribes#Contributor Tier Process|contributor tiers]] for scribes. One way of earning badges is by editing the wiki for a certain amount of consecutive days. The following are tips related to maintaining your editing streaks:
 
* When you first create a wiki account, set your timezone immediately in your [[Special:Preferences|Preferences]]. Changing the timezone can reset your editing streak.
 
* Wiki editing streaks are counted as edits per UTC day. To ensure you keep your streak, set a Daily to edit the wiki after [http://time.unitarium.com/utc/0%7CUTC midnight].
 
 
 
 
== Стиль ==


=== Тон ===
=== Тон ===
Тон статьи должен быть информативным и полупрофессиональным. Basically, this means opening all articles with clear-cut and concise definitions of the topic in question, followed by a well-organized and thorough rundown of the topic in detail. Stick with the third person only in the openings, using words like «player» and «user» rather than «you.» Once you get into the meat of an article, it should be fine to use the second person, as most articles will have instructions for users of the site to follow. Never use the first person under any circumstances. Writing in all caps is considered yelling, and as such it is an improper tone for this Wiki.
Тон изложения должен быть энциклопедическим, информативным и полупрофессиональным. Старайтесь писать так, чтобы текст был понятен для максимально широкого круга читателей. Статьи желательно начинать с четких и кратких определений рассматриваемого предмета, за которыми следует хорошо организованное и тщательное изложение темы. Понятие, которому посвящена статья, лучше всего помещать в начале статьи и выделять '''жирным шрифтом''', а затем через тире давать краткое определение.
 
 


=== Длина статьи ===
=== Длина статьи ===
The article should be straight to the point and only as long as needed (especially for broader topics). However, do not go on a tangent and add fluff. Shorter articles are generally more accessible and usable than really long ones. Referencing '''related''' pages, however, is recommended and helpful for users in general. Always write the best that you can on all of your contributions.
Статья должна быть написана по существу и настолько велика, насколько это необходимо (особенно для более-менее широких тем). Старайтесь осветить все существенные аспекты, посвящая им отдельные разделы, но каждый аспект раскрывать по возможности лаконично. Не забывайте ставить вики-ссылки на «связанные» страницы в самом тексте или с помощью раздела «См. также».


== Форматирование ==
{{основная статья|DecimalWiki:Правила оформления страниц}}
[[Файл:Panel001 2023-10-04 07-40-35.png|500px|thumb|right|Рис. 1: панель редактирования (общий вид)]]
[[Файл:Panel002 2023-10-04 07-40-35.png|500px|thumb|right|Рис. 2: кнопки вики-разметки]]
[[Файл:Panel003 2023-10-04 07-40-35.png|500px|thumb|right|Рис. 3: справка по оформлению текста]]
Над окном редактирования вы видите панель инструментов (рис. 1). Нажав на ссылку «Дополнительно», вы увидите дополнительные кнопки для быстрой вставки вики-разметки: заголовков, списков, иллюстраций, таблиц и т. п. (рис. 2). По ссылке «Справка» вам откроется поле с краткими пояснениями по оформлению вики-текста (рис. 3). Не стесняйтесь пользоваться этими инструментами, чтобы придать вашему тексту красивый и завершённый вид.


 
=== Викификация ===
== Форматирование ==
На панели редактирования вы можете видеть кнопку викификатора: [[Файл:Викификатор 2023-10-04 08-53-11.png|24px]]. Рекомендуем обязательно пользоваться ею по завершении редактирования статьи. Викификатор автоматически приводит в порядок типографику текста: убирает лишние пробелы и отступы, проставляет русские кавычки «ёлочки» и делает много других полезных вещей.


=== Текст ===
=== Текст ===
Строка 81: Строка 70:


=== Отступы ===
=== Отступы ===
Поля и отступы — это названия пространства вокруг элемента, будь то текст, изображение, таблица и т. д. Как редактору вики, вам обычно не нужно беспокоиться об этом. Когда вы углубитесь в это, это можно будет сделать с помощью CSS и атрибута style. Подробнее об использовании вы можете прочитать здесь: [http://www.w3schools.com/css/css_margin.asp margins] и [http://www.w3schools.com/css/css_padding.asp padding].
Поля и отступы — это названия пространства вокруг элемента, будь то текст, изображение, таблица и т. д. На вики-странице не нужно специально ставить абзацные отступы. Другие элементы оформления абзацев можно делать с помощью CSS и атрибута style. Подробнее об использовании отступов вы можете прочитать здесь: [http://www.w3schools.com/css/css_margin.asp margins] и [http://www.w3schools.com/css/css_padding.asp padding].


=== Правописание ===
=== Правописание ===
'''В этой вики мы следуем стандартным правилам грамматики русского языка.'''
'''В этой вики мы следуем стандартным правилам грамматики русского языка.'''


Это включает в себя (но не ограничивается ими) интервалы и знаки препинания. Используйте один пробел между предложениями. За сокращениями должны следовать точки (например, <nowiki>напр.</nowiki> и <nowiki>т.е.</nowiki>). Если вы видите неправильную грамматику на вики-странице, не стесняйтесь исправить её! Кроме того, обязательно перепроверьте (а может быть, даже трижды перепроверьте) свои правки, чтобы убедиться, что на странице нет никаких грамматических ошибок.
Это включает в себя (но не ограничивается ими) интервалы и знаки препинания. Используйте один пробел между предложениями. За сокращениями должны следовать точки (например, ''<nowiki>напр.</nowiki>'' и ''<nowiki>т.е.</nowiki>''). Если вы видите грамматические ошибки на вики-странице, не стесняйтесь исправить их! Кроме того, обязательно перепроверьте (а может быть, даже трижды перепроверьте) свои собственные правки, чтобы убедиться, что на странице нет никаких ошибок.


=== Заглавные (прописные) буквы ===
=== Заглавные (прописные) буквы ===
Написание с прописной буквы отдельного слова неформально называется ''капитализация'' (англ. capitalization).
Обычно рекомендуется писать с прописной буквы только первое слово названия, а также [https://ru.wikipedia.org/wiki/Имя_собственное имена собственные] (Москва, Decimal), входящие в название. '''Это не строгое правило.''' Нередки случаи, когда из маркетинговых (или иных) соображений название продукта целиком пишется прописными — очень часто это касается названий монет в нашем блокчейне.
 
Обычно рекомендуется писать с прописной буквы только первое слово названия, а также [https://ru.wikipedia.org/wiki/%D0%98%D0%BC%D1%8F_%D1%81%D0%BE%D0%B1%D1%81%D1%82%D0%B2%D0%B5%D0%BD%D0%BD%D0%BE%D0%B5 имена собственные] (Москва, Decimal), входящие в название. '''Это не строгое правило.''' Нередки случая, когда из маркетинговых (или иных) соображений название продукта целиком пишется прописными — очень часто это касается названий монет в нашем блокчейне.


В большинстве других случаев написание названий компаний, криптовалют и других вещей соответствует общепринятым нормам русского языка.
В большинстве других случаев написание названий компаний, криптовалют и других вещей соответствует общепринятым нормам русского языка.
Таблицы ниже дают несколько примеров этих инструкций.
{| class="standard" border="0" cellpadding="1" cellspacing="1" style="width: 500px; height: 500px;"
|-
! scope="col" |Capitalized
! scope="col" |Example
|-
|События
|Summer Splash
|-
|Аббревиатуры
|XP, HP, MP, GP
|-
|Задачи
|Задачи, Ежедневные дела, Привычки, Награды
|-
|Атрибуты персонажа
|Сила, Интеллект, Телосложение, Восприятие
|-
|Названия классов
|Лекарь, Разбойник, Воин, Маг
|-
|Инвентарь
|Chain Mail, Orb of Rebirth
|-
|Имена боссов (но имя также должно соответствовать свитку квеста)
|The Dread Drag’on of Dilatory, The SnackLess Monster
|-
|Названия предысторий
|Fairy Ring
|-
|Названия яиц, питомцев, скакунов
|Яйцо волка, Пустынная лиса
|-
|Другие слова, которые имеют уникальное значение в Habitica
|the Tavern, Perfect Day, Grey Daily, Cron
|}


Заглавные буквы в заголовках и подзаголовках соответствуют русским, а не английским правилам: '''Пример подзаголовка статьи в Decimal Wiki''', а не '''Пример Подзаголовка Статьи в Decimal Wiki'''.
Заглавные буквы в заголовках и подзаголовках соответствуют русским, а не английским правилам: '''Пример подзаголовка статьи в Decimal Wiki''', а не '''Пример Подзаголовка Статьи в Decimal Wiki'''.
Строка 138: Строка 87:


=== Ссылки ===
=== Ссылки ===
Relevant internal links to articles help readers browse the wiki and help avoid [[Special:DeadendPages|dead-end pages]]. External links to [[GitHub]] issues and [[Feature Tracker|Trello]] cards can provide useful behind the scenes or historical information. Do not link to wiki pages that do not currently exist as the Habitica Wiki avoids using broken links.
Релевантные внутренние ссылки на статьи помогают читателям просматривать вики-страницы и избегать [[Служебная:Тупиковые страницы|тупиковых страниц]]. Не ссылайтесь на вики-страницы, которые в настоящее время не существуют, если не хотите, чтобы на странице не было «красных» ссылок.


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


Вы можете добавить внутренние вики-ссылки на другие статьи Decimal Wiki. Для этого используйте двойные квадратные скобки вокруг заголовка страницы, на которую вы хотите сделать ссылку. Например, <code><nowiki>[[Блокчейн]]</nowiki></code> выглядит как [[Блокчейн]]. Вы также можете использовать вертикальную полосу (|) для настройки заголовка ссылки — скажем, если не совпадает падеж. Например, при вводе <code><nowiki>[[Блокчейн|блокчейну]]</nowiki></code> получится [[блокчейн]]у.


When creating links on a page, make sure that you link to the current page for the topic in question, and that the target link in the source code (or edit link box) is appropriately capitalized.
Вы можете добавлять внешние ссылки, заключив URL-адрес в одиночные квадратные скобки. Например, <code><nowiki>[http://www.tablesgenerator.com/mediawiki_tables TablesGenerator.com]</nowiki></code> становится [http://www.tablesgenerator.com/mediawiki_tables TablesGenerator.com]. Обратите внимание, что для отделения URL-адреса от необязательного текста используется пробел, а не прямой слэш (|), как в вики-ссылке.
 
 
 
You can add internal links by putting double square brackets around text designating the title of the page you want to link to. For example, <code><nowiki>[[Gold Points]]</nowiki></code> becomes [[Gold Points]]. You can also use a vertical bar (|) to customize the link title. For example, typing <code><nowiki>[[Gold Points|gold]]</nowiki></code> will produce [[Gold Points|gold]]. You can add external links by placing the URL within single square brackets. For example, <code><nowiki>[http://www.tablesgenerator.com/mediawiki_tables TablesGenerator.com]</nowiki></code> becomes [http://www.tablesgenerator.com/mediawiki_tables TablesGenerator.com]. Note the use of a space (not a bar |) to separate the URL from the optional link text.
 
 
 
Because the wiki is a work in progress, pages are occasionally consolidated, removed, or renamed. For example, the [[Gold Points]] page has previously been named [[Gold Points (GP)]] and [[Gold Coins]]. To prevent issues when other sites have linked to the pages on the wiki that no longer exist, the admins leave redirect links to deleted pages. This means that when new internal links are created, the auto-fill suggestion box includes these old link names. When wiki users click these old links, they are redirected to the new page. The new page alerts the user to the old link redirect with a message below the page title, «Redirected from [old page name]», as can be seen using the links in the above example. Link targets that are not capitalized in the source code also give this message. This issue does not affect functionality of the wiki, but using the correct link and preventing these messages improves the wiki’s sense of professionalism.
 
 
 
==== Множественное число и добавление суффиксов ссылкам ====
Plural versions of links can be formed by appending an 's' after the closing brackets. For example, <code><nowiki>[[Rogue]]s</nowiki></code> displays as [[Rogue]]s. This has several benefits over the alternative (<code><nowiki>[[Rogue|Rogues]]</nowiki></code>): it is easier to type, clearer to read in the source code, and less likely to result in typos. This also works when adding a suffix (e.g., ‑ing, ‑ed, or ‑est) to a link. However, it is not necessary to make an edit solely to change link code from, say, <code><nowiki>[[Rogue|Rogues]]</nowiki></code> to <code><nowiki>[[Rogue]]s</nowiki></code>.
 
 
 
==== Межъязыковые ссылки ====
Interlanguage links connect different language versions of the same page. For more information about interlanguage links, see [http://community.wikia.com/wiki/Help:Interlanguage_links Help:Interlanguage links].
 
 
 
When copying pages in order to create new ones of the same type, e.g., using an existing Quest page as a template for a new Quest page, be sure not to copy/import the interlanguage links. Having an incorrect link to a translated page can be confusing for wiki users, especially if the page they originally wanted to read does not exist or is not fully translated at that point.
 
 
 
==== Информативный текст ссылки ====
The text for links should be informative. Avoid generic link text such as «link» or «page»; instead, use text that provides more information about the page being linked to. For example, «created a [[Adapting Habitica for ADHD|page]] outlining how to adapt Habitica to ADHD» is uninformative, whereas «created a page outlining how to [[Adapting Habitica for ADHD|adapt Habitica to ADHD]]» demonstrates good practice.
 
 
 
This is for the benefit of partially sighted and blind people using [https://en.wikipedia.org/wiki/Screen_reader screen readers]. Screen readers allow users to navigate from link to link while having the text for each link read aloud, so it is beneficial for link text to be informative about the subject matter of the link. This allows users to more easily determine when they want to follow the link or to direct the screen reader to read the surrounding text.
 
 
 
=== Названия статей ===
При создании новой страницы не используйте круглые скобки () в заголовке. Вики-страницы со скобками в названии будут давать сбои из-за конфликта с форматированием в Таверне.
 


Поскольку наша вики постоянно улучшается и развивается, страницы могут объединяться, удаляться или переименовываться. Например, страница [[Монета]] ранее называлась [[Криптомонета]]. Чтобы предотвратить возникновение «красных» ссылок на страницы, которые больше не существуют, администраторы оставляют перенаправляющие ссылки на удаленные или переименованные статьи. Это означает, что при создании новых внутренних ссылок в поле для предложений автозаполнения будут указаны эти старые названия ссылок. Когда пользователи вики переходят по старым ссылкам, они перенаправляются на новую страницу. Новая страница предупреждает пользователя о перенаправлении по старой ссылке сообщением под заголовком страницы «Перенаправлено с [старое название страницы]».


=== Заголовки разделов ===
=== Заголовки разделов ===
Liberal use of headers breaks up articles, enables easier reading, and allows the automatic generation of tables of contents. However, too many subheadings makes the text harder to read, especially if related content is being broken up unnecessarily. To keep text easy to follow, try to strike a balance in the number of headings used.
Широкое использование подзаголовков (h2, h3, h4 и т. д.) разбивает статью на части, что облегчает чтение и позволяет автоматически генерировать оглавления. Однако слишком большое количество подзаголовков затрудняет чтение текста, особенно если связанный контент разбивается без необходимости. Чтобы текст было легко читать, старайтесь соблюдать баланс в количестве используемых заголовков.
 
 
 
Headers and subheadings should not be changed unnecessarily. They can be linked to from other pages and from locations outside the wiki (e.g., Habitica itself, GitHub, and blog posts) so any change to a heading will make these links nonfunctional. If it is essential to change a header, correct all links leading there from elsewhere in the Habitica wiki. Also, search likely locations in the Habitica website (habitica.com) for links to the heading. If you find any, create a new issue in GitHub to ask that the link be changed.
 
 
 
Headers and subheadings are capitalized according to the rules described in [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style/Capital_letters#Composition_titles Composition titles] (a form of title case). However, if you see an existing header that does not have correct capitalization, please do '''not''' change it unless you are certain that there are no links to it.
 
 
 
=== Инфобоксы ===
{{infobox item
 
| title        = Snowball
 
| image        = Inventory special snowball.png
 
| imagewidth    = 51 [default: 210 pixels]
 
| imagecaption  = Throw a snowball at a party member.
 
| buy          = 1 [[Файл:Gem.svg|link=Самоцветы]]
 
| sell          = -
 
}}
 
Individual item pages should have an infobox with an image, the tooltip description, and buy/sell prices — instead of listing this info in paragraph form. Example code for the template is as follows.
 
{{clr}}
 
 
 
<pre>
 
  {{infobox item
 
  | title        = Snowball
 
  | image        = Inventory special snowball.png
 
  | imagewidth    = 51 [default: 210 pixels]
 
  | imagecaption  = Throw a snowball at a party member.
 
  | buy          = 1 [[Файл:Gem.svg|link=Самоцветы]]
 
  | sell          = -
 
  }}
 
</pre>
 
 
 
=== Содержание (TOC) ===
The table of contents (TOC) will automatically generate after the fourth main sub-heading. The TOC can be forced to appear with less than four sub-headings by including the following code in the source view of the editor at the start of the wiki document: <nowiki>__TOC__</nowiki> To shift the TOC to the right of the page, enter the following code into the source view of the editor at the top of the wiki document:
 
<pre>
 
{| align="right"
 
| __TOC__
 
|}
 
</pre>
 
 
 
=== Математические выражения и формулы ===
The Habitica wiki supports mathematical markup using a variant of LaTeX. This is well documented in the [[community:Help:Math|Wikia Community Documentation]], with further details about specific markup elements available in the [https://en.wikipedia.org/wiki/Help:Displaying_a_formula Wikipedia help pages].
 
 
 
By default, the mathematical markup should render as black text with a transparent background, e.g.:
 
 
 
<code><nowiki><math>{y = x^2 + 7x - 2}</math></nowiki></code> produces <math alt="correct maths sample">{y = x^2 + 7x - 2}</math>
 


Заголовки и подзаголовки не следует изменять без необходимости. На них могут быть ссылаться другие страницы и сайты за пределами нашей вики (например, GitHub и записи в блогах), поэтому любое изменение заголовка сделает эти ссылки нефункциональными. Если необходимо изменить заголовок, исправьте все ссылки, ведущие на него из других разделов Decimal Wiki.


Note that currently you can only enter mathematical markup in the source editor.
Заголовки и подзаголовки пишутся с заглавной буквы в соответствии с правилами русской грамматики, описанными в [[w:Википедия:Именование статей|справочной статье Википедии]]. Однако, если вы видите существующий заголовок с неправильной заглавной буквой, пожалуйста, не меняйте его, если только вы не уверены, что на него не ссылаются другие статьи.
 
 
 
=== Эмодзи ===
[[Emoji]] are rarely used in the wiki — usually only when quoting text from Habitica that contains them. If copying and pasting the emoji doesn’t work, another way to include an emoji in a wiki page is to write its HTML entity in the source editor. For example, for &#x1f418;, you would write <code><nowiki>&#x26;#128024;</nowiki></code> (its HTML entity with decimal number) or <code><nowiki>&#x26;#x1f418;</nowiki></code> (its HTML entity with hexadecimal number) — it doesn’t matter which one.
 
 
 
You can find an emoji’s HTML entity on the internet. One good place to look it up is [http://www.fileformat.info/info/emoji/index.htm FileFormat.Info]. Either find the emoji in their [http://www.fileformat.info/info/emoji/list.htm list of emoji], then click on the corresponding Unicode link on the right side, or enter the emoji’s name (in this example, «elephant») in the search field.
 
 
 
There are emoji which don’t have a corresponding Unicode character and for which this method doesn’t work — but in most cases, it does.
 
 
 
Another good source to look up different versions of emoji and copy them directly is [http://emojipedia.org/ Emojipedia].
 
 
 
== Как избежать спойлеров ==
When looking for new information to add to the main namespace, stick to features that are already implemented, visible, and accessible to all players on Habitica. Information about planned or upcoming features available on [[GitHub]] and the various [[Feature Tracker|Trello]] boards may contain spoilers that the [[staff]] wish to keep as surprises for players. This is particularly important for [[Community#World Events|world events]], particularly those with multiple event-based reveals like the battles with [[World Bosses|world bosses]]. It is, of course, okay to discuss quest lines in designated areas like the [[The Keep:The Camp|Camp]].
 
 
 
For spoilers of already implemented content, such as resolution text for [[boss]] or collection [[quests]], you can use the templates for spoilers: [[Шаблон:Spoiler start]] and [[Шаблон:Spoiler end]]. The spoiler warning template, [[Шаблон:Spoiler]], should be used on pages such as the [[The Keep:The Camp|Camp]], where most or all content are spoilers.
 


=== Оглавление (TOC) ===
Плашка с оглавлением страницы (Table of Content, TOC) генерируется автоматически после появления в статье четвертого подзаголовка типа h2. Можно заставить оглавление отображаться менее чем с четырьмя подзаголовками, включив в исходное представление редактора в начале вики-документа следующую переменную: <code><nowiki>__TOC__</nowiki></code>. Чтобы расположить оглавление с правого края страницы, введите в верхней части вики-документа шаблон <code><nowiki>{{TOC right}}</nowiki></code>.


== Изображения ==
== Изображения ==
Images should be added if they are useful in the context of the article, for example, if they help make a concept more clear, with the exception of the [[Whats New]] pages which should match the [[Characters in Habitica#Bailey the Town Crier|Bailey]] announcements in [https://habitica.com/static/old-news old news].
Изображения следует добавлять, если они полезны в контексте статьи — например, помогают сделать концепцию более понятной.
 
 
 
Before uploading a new image, search for it in [[Special:Images]] and in the various Images categories. The image you want might already be uploaded and if so, you should not upload a duplicate (see [[Guidance for Scribes#Replacing v. Deleting|Replacing v. Deleting]] below for more information). If it has not already been uploaded, you can find most of the original Habitica images used on the website (including items, food, pets, and mounts) in GitHub under the [https://github.com/HabitRPG/habitrpg/tree/develop/website/assets/sprites/spritesmith website/assets/sprites/spritesmith] and [https://github.com/HabitRPG/habitrpg/tree/develop/website/assets/sprites/spritesmith_large website/assets/sprites/spritesmith_large] directories in the «habitrpg» repository.


Последовательность действий описана на странице [[Special:Upload|Загрузить файл]]. Названия загружаемых файлов чувствительны к регистру. При загрузке нового изображения под тем же названием старое изображение сохраняется в истории правок, так же, как текст статей. Если вы считаете нужным удалить старую версию изображения или изображение полностью, а также переименовать загруженный файл, обратитесь к администраторам.


Загрузка файлов отражается в [[Служебная:Log/upload|журнале загрузки файлов]]. Просмотреть ранее загруженные файлы можно в [[Служебная:Imagelist|списке]] или [[Special:NewFiles|галерее]] загруженных изображений.


=== Типы файлов ===
=== Типы файлов ===
Изображения должны быть загружены в формате PNG с максимально доступным разрешением. В особых случаях допускаются различные форматы изображений (например, если необходим анимированный GIF).
Изображения желательно загружать в формате PNG с максимально доступным разрешением. В особых случаях допускаются различные форматы изображений (например, если необходим анимированный GIF).
 
 
 
Images should have transparent backgrounds unless the background is essential to understanding the information that the image is trying to present.
 
 
 
=== Названия файлов ===
Standard images from Habitica, such as images of equipment and pets, as well as quest-related images, should use the file names that are used in Habitica itself; this is of especial importance for equipment and quest scrolls. For example, the Winter 2015 Healer armor has the file name [[:Файл:Broad armor special winter2015Healer.png|broad_armor_special_winter2015Healer.png]]. File names can be found in GitHub under [https://github.com/HabitRPG/habitrpg/tree/develop/website/assets/sprites/spritesmith website/assets/sprites/spritesmith/]. Don’t use file names beginning with «shop_…» even if the shop version of the image is uploaded; instead, use the file name for the normal version of the image (e.g., use weapon_healer_1.png rather than shop_weapon_healer_1.png).
 
 
 
Other images such as example avatars or task should be uploaded named with generic but descriptive titles. The name should accurately reflect the content of the image, distinguishing it from other images, without describing elements of the image that may be changed as Habitica evolves.
 
 
 
[[Файл:Avatar Buff.png|thumb|116x116px|Avatar_Buff.png]] Try to avoid using words in the name that would be inaccurate should the image need to be updated in the future to represent changes to Habitica. For example, the image on the right was uploaded to show what the [[buff]] icon looks like on an avatar. It was correctly named '''Avatar_Buff.png'''.
 
 
 
Avoid including any words in the image’s name that are likely to become irrelevant when the image changes:
 
* Dates (e.g., Avatar_Buff_August_2014.png)
 
* Version numbers (e.g., Avatar_Buff_version_1.png) or words indicating a new version (e.g., Avatar_Buff_updated.png or Avatar_Buff_modified.png)
 
* Avatar names (e.g., Deborah_Buff.png)
 
* Elements in the image that might change when the site is updated, such as colors or shapes (e.g., Buff_White_Arrow.png)
 
An exception can be made if it is absolutely necessary and not likely to change (e.g., July_2014_Mystery_Item.png).
 
[[Файл:Boss.png|альт=|мини|У этого изображения есть описывающая подпись.]]
 
 
 
=== Подписи ===
Используйте подпись, чтобы объяснить, что изображено на картинке, а также для уточнения, почему именно она была добавлена на эту страницу
 
{{Clr}}
 
 
 
==== Ширина подписей ====
[[Файл:Inventory special snowball.png|thumb|Throw a snowball at a party member.]]
 
When paired with smaller images, some captions may wrap undesirably as seen to the right. {{clr}}
 
You can use the {{t|infobox item}} template as follows to render the image without undesired wrapping:
 
 
 
{{infobox item
 
| title        =
 
| image        = Inventory special snowball.png
 
| imagecaption  = Throw a snowball at a party member.
 
}}
 
<pre>
 
{{infobox item
 
| title        =
 
| image        = Inventory special snowball.png
 
| imagecaption  = Throw a snowball at a party member.
 
}}
 
</pre>
 
 
 
 
 
=== Заменить или удалить? ===
[[Файл:Replace Image.png|thumb|220x220px]]
 
Outdated images should be replaced rather than deleted if at all possible. Go to the image’s page, then select the drop-down menu on the edit button next to the title. You will see the following options: ''History'' and ''Replace''. Click on replace, then use the form displayed to upload the updated image. You can write a brief description of what has changed in the image, or why a new version is needed.
 
[[Файл:Image File History.png|left|thumb|190x190px|Image history (click for larger image).]]
 
Once the form is submitted, the old version of the image will be replaced by the new one, but the old version will still be available in the file’s history tab.
 
 
 
''Note:'' There is an ongoing issue with the Wikia caching so that for a little while after a replacement image is uploaded, the old image still shows. Wikia seems to occasionally have very aggressive caching that can hold on to the old version of an image for hours. It should rectify itself within a day, but if it doesn’t, the issue can be reported to wiki staff and they’ll manually clear out their cache. See also the Wikia Community Central’s [http://community.wikia.com/wiki/Help:Purge Help:Purge] page.
 
 
 
Using this method to replace an old image has a lot of advantages over uploading a completely new image. It means that you can see all versions of an image in one place, and it’s very easy to revert to an old version if needed. It means that all links on the wiki and elsewhere will keep on working. It reduces clutter in the wiki’s «Photo» section because there’s only one entry for each image.
 
 
 
Most importantly, it makes it impossible for anyone to accidentally use an old version of an image. Someone who’s editing a page and needs to choose an image will find it hard to pick the right one, and if more than one similar image is used across the site, then all of them have to be updated when Habitica changes. But if new versions of images are uploaded to «replace» old images rather than uploaded as new images, this issue disappears.
 
 
 
Check out this [[Thread:2900|thread]] for more explanation of why it’s generally better to replace rather than delete.
 


Другие разрешённые типы файлов: jpg, jpeg, doc, xls, mpp, pdf, ppt, tiff, bmp, docx, xlsx, mp4, flac, mkv, mov, mp3, oga, ogg, ogv, wav, webm.


=== Авторское право ===
=== Авторское право ===
[[Файл:CC box.png|thumb|400px|If you’ve uploaded an image from Habitica, make sure the image page’s 'About' tab shows this license.]]
При написании статей или загрузке изображений соблюдайте авторское право.
 
All images on the wiki must have accurate copyright (license) information in their descriptions. Images from Habitica (artwork, screenshots, etc) are licensed under the [http://creativecommons.org/licenses/by-nc-sa/3.0/ CC-by-NC-SA 3.0] license. If your image is not from Habitica, please make sure you are allowed to use it (i.e., using it on the Habitica wiki does not break any copyright licenses).
 
 
 
You can add license information when you upload the image to the wiki (that’s easiest and is strongly recommended) or you can edit the image after you’ve uploaded it.
 
 
 
To add a license when you are uploading an image, when you get to the «Upload Photo» screen:
 
# click on the «More options» link that you’ll see near the bottom right
 
# find the «Licensing» drop-down list
 
# select the appropriate option; for images from Habitica (artwork, screenshots, etc), use «This is licensed under under the Creative Commons Attribution-NonCommercial-Share-Alike license.»
 
 
 
To add a license to an existing image:
 
# click on the image to open it in a pop-up screen
 
# click on the «more info» button at the top right of that screen to go to the image’s own wiki page
 
# click on the «edit» button (note: the source editor is recommended; if it is not your default editor, click the dropdown arrow on the «edit» button to access it)
 
# in the text area that you will then see, copy and paste this text: <nowiki>== Licensing ==</nowiki>
 
# on a new line under that text, paste in the correct code for the appropriate license:
 
#* for images from Habitica (artwork, screenshots, etc), all you need to paste in is «<nowiki>{{CC-BY-NC-SA}}</nowiki>» (without the quote marks)
 
#* for images from other sources, find the appropriate license code at Wikia’s [http://community.wikia.com/wiki/Help:Image_copyright_tags Help:Image copyright tags] page
 
# in the «Edit summary» box to the left of the edit page, paste in this text or similar: «adding copyright information»
 
# click the «Publish» button.
 
 
 
{{clr}}
 
 
 
=== Добавление пробелов и предотвращение неуклюжего перекрытия ===
If the image is creating issues with the layout, you can add the following code to create a clear space to fix it.
 
<pre>
 
{{clr}}
 
</pre>
 
 
 
=== Промо-арт вики ===
[[Файл:Raking Leaves by leephon.png|thumb|An example of wiki promotional art.|ссылка=Special:FilePath/Raking_Leaves_by_leephon.png]]
 
Some pages have decorative promotional art, depicting Habiticans engaging in activities relevant to the material on the page. These images can add flavor and help break up large areas of text. If you find a page that could benefit from this type of art and have an idea for it, submit your idea to the appropriate card on the [https://trello.com/c/WTAgvsCK/23-wiki-promotional-art-i-e-clip-art Pixel Art Trello]. Once your idea is approved, it will be added to a list of scenes needed. [[Guidance for Artisans|Artisans]] will then be able to claim and create the scene.
 
 
 
As wiki promotional art is decorative, it does not require captions.
 
{{clr}}
 
 


== Видео ==
== Видео ==
Videos from Youtube and Vimeo can be included, but should only be used if they improve the article significantly.
В статью можно вставлять ролики с YouTube в виде окошка с потоковым видео. Это реализовано с помощью шаблонов {{Tl|youtube}} и {{Tl|yt}}. Инструкции по их использованию вы можете прочитать в документации на страницах этих шаблонов.
 
 
 
== Категории ==
Categories can be added to articles to group them according to a certain topic. However, having too many categories, especially when they contain very few pages, have vague topics, or are similar to other categories, can add unnecessary clutter to the wiki and make it more difficult for users to find the most helpful categories. Please refrain from adding categories that are not already in use without first discussing your idea with other experienced Scribes, such as in the [https://habitica.com/groups/guild/9a163b28-ebcf-4e52-87de-5c040ed0f8f8 Wizard of the Wiki] guild.
 
 
 
Category pages (for example, [[:Категория:Contributing]]) can optionally contain one to two sentences to explain what the category is for. This is not necessary when the intention is obvious. Category pages should never contain more content than that because their primary purpose is to be a list of related articles. Check the page for a category before adding articles to the category, since it may contain guidance about what pages should or should not be added.
 
 
 
Most categories are reserved for certain types of pages--in particular, the categories listed in the [[Category Index]] should only be used for main wiki pages, unless noted otherwise (e.g. [[:Категория:Guilds]] and [[:Категория:Parties]] are for pages in the Armory). To avoid clutter, please don’t add these categories to other types of pages (templates, blog posts, files, etc.).


== Категоризация статей ==
В статьях полезно прописывать [[Служебная:Категории|категории]], чтобы группировать их по определенной теме и облегчать навигацию по сайту. Однако избегайте слишком большого количества категорий, особенно когда они содержат очень мало страниц, имеют расплывчатые темы или похожи на другие категории — это может внести неразбериху и затруднить пользователям поиск наиболее полезных категорий. Пожалуйста, воздержитесь от добавления категорий, которые еще не используются, без предварительного обсуждения вашей идеи с другими опытными редакторами — например, на странице обсуждения статьи.


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


== Описание изменений ==
== Описание изменений ==
When making edits, write a short summary of the changes that have been made in the 'Edit Summary' box before publishing. Depending on the edit, a few words may suffice, but major edits may need longer summaries or the inclusion of rationales. Providing these summaries allows other scribes to quickly get a sense of what has changed. It is also extremely helpful when filling out contributor tier applications, as these summaries are shown as part of the edit histories on user profiles in the 'Contributions' tab. In addition, it makes finding specific changes in a series of edits much easier.
Перед публикацией напишите краткое описание своих правок в поле «Описание изменений». Обычно достаточно нескольких слов, но для крупных правок может потребоваться более подробное резюме или обоснование. Такое пояснение позволяет другим участникам быстро получить представление о том, что изменилось в статье. Это также может быть полезно при подаче заявки на повышение уровня участника, поскольку ваши резюме отображаются как часть истории правок в профиле пользователя на вкладке «Вклад участника». Кроме того, это значительно упрощает поиск конкретных изменений в истории правок.
 
 
 
If you have trouble remembering to fill out the edit summary, you can (if you have an account) set your user preferences to remind you if you forget to leave one. In the [[Special:Preferences#mw-prefsection-editing|«Editing» section of your preferences]], check the box reading «Prompt me if I leave a blank edit summary» (the third checkbox under «Editing experience») and save the change. This will remind you to fill in your edit summary if you leave it blank on any page (except your own user page) on any Wikia wiki. If your edit summary is blank and you click «Publish» you will be given a reminder reading «Reminder: You have not provided an edit summary. If you click Publish again, your edit will be published without one». You then have the option to type an edit summary as recommended or just save your edit without one.
 
 


== Переименование страниц ==
== Переименование страниц ==
On rare occasions, pages may need to be renamed. When pages are renamed, Wikia will automatically create a redirect page that will take old links to the new site. However, links on the wiki will not be updated automatically. The wiki will still function, but users will be alerted to the fact that the link is old with a message below the page title, «Redirected from [old page name]». To eliminate this message and maintain the sense of professionalism that the wiki strives for, you can use the special page [[Special:WhatLinksHere|WhatLinksHere]] to find those out of date links that renaming has created, and fix them. Simply type the old page title into the appropriate box, and they will be displayed.
В редких случаях страницу может потребоваться переименовать. Когда страница переименовывается, вики-движок автоматически создает на старой странице перенаправление («редирект»), которое будет содержать ссылку на новое название. Если вы хотите избежать этого, на странице переименования уберите галочку в строке «Оставить перенаправление».
 


При необходимости вы можете подать запрос администрации, чтобы страница с перенаправлением была удалена.


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


<pre><nowiki>{{удалить|Причина удаления}}</nowiki></pre>


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


<pre><nowiki>{{delete|Reason for deletion}}</nowiki></pre>
== Создание черновика пользователя ==
[[Файл:Черновик 2023-10-04 09-12-36.png|300px|thumb|right|Рис. 4: ссылка для быстрого создания черновика.]]
Черновик — это страница, которую можно использовать для упражнений в редактировании, изучения форматирования и написания драфта статьи без обязательной публикации на главной странице. Это может быть очень полезно для начинающего пользователя.


Keep in mind that at this time, redirect pages are a permanent fixture for the wiki. The wiki is here to provide information to the users in a way that’s convenient for them to use. Broken external links, whether from an outside site, the Habitica forums, or a page that a user bookmarked, make it less convenient for the readers to use the wiki. Therefore, redirect pages are kept in place so that these links will not give a «404 Page Not Found» error. This ensures that wiki users have a better experience when trying to locate information, and increases the wiki’s efficiency in providing consistent, up-to-date information. Remember, our goal is to create and maintain an accurate, up-to-date and easy-to-use guide for players of Habitica, so if there is a redirect page that you firmly feel needs to be deleted, at the top of the page add the deletion code with the reason that the page should be deleted. From there, the wiki admins will discuss the reason and make a decision, and the page will either be deleted, or the deletion code can be removed.
Проще всего создать свой черновик, нажав на соответствующую ссылку на главной странице (рис. 4). Страница черновика создаётся в вашем личном пользовательском пространстве, ссылка выглядит так: <code><nowiki>[[Участник:Имя_участника/Черновик]]</nowiki></code>.


Кроме того, вы можете создать черновик под любым другим названием (например, «Песочница»), совершив последовательность действий:


1. '''Перейдите на свою страницу пользователя.''' Вы можете сделать это, нажав на значок вашего пользователя в правом верхнем углу любой вики-страницы. Возможно, вам придется щелкнуть дважды, если при первом щелчке откроется меню.


== Создание песочницы пользователя ==
2. '''Добавьте <code>/Песочница</code> в конце URL в адресной строке браузера.''' Для этого нажмите на поле URL в вашем браузере, отмените выделение текста и введите «/Песочница» в самом конце. Нажмите Enter.
Песочница-это страница, которую можно использовать для практики редактирования, изучения форматирования и составления черновиков без обязательной публикации на главной странице. Если вы из тех, кто учится на практике, наличие песочницы, где вы можете опробовать код, форматирование и дизайн, может быть очень полезным. Ниже приведены шаги по созданию вашей песочницы.


3. Поскольку вы еще не создали страницу, вам будет предложено сделать это прямо сейчас. Нажмите на ссылку «'''создать страницу с таким названием'''».


4. '''В открывшемся окне редактирования вставьте следующий код:'''


1. '''Go to your user page. '''You can do this by clicking on your user icon at the top right of any wiki page. You may have to click twice if the first click opens up the menu.
<pre><nowiki>{{Черновик}}
<!--ПРАВЬТЕ НИЖЕ ЭТОЙ ЛИНИИ--></nowiki></pre>


5. '''Под этим вставленным текстом вы можете начать практиковаться в редактировании.''' Одна из идей для начала — добавить оглавление и ссылки на полезные шаблоны и ссылки, которые вам часто приходится просматривать.


6. Всякий раз, когда вы закончите редактирование в редакторе кода, нажмите «Внесённые изменения» под окном редактирования. Также вы можете посмотреть, как изменится страница, нажав на кнопку «Предварительный просмотр».


2. '''Add ''/Sandbox'' to the end of your URL.''' Click on the URL box in your browser, deselect the text, and type in ''/Sandbox'' at the very end of. Go to this page.
7. '''Нажмите «Записать изменения».'''


{{совет|Чтобы легко найти свой черновик, добавьте ссылку на него на странице своего профиля. Для этого вставьте следующий код в окне редактирования вашей страницы пользователя, заменив «Имя_участника» на ваше собственное имя пользователя:
<code><nowiki>[[Участник:Имя_участника/Название_страницы|Мой черновик]]</nowiki></code>}}


8. '''Ура!''' Вы создали собственную страницу-песочницу! Экспериментируйте с ней, как вам будет угодно, изучайте вики-разметку и повышайте свой скилл редактирования вики!


3. Since you have not yet created your sandbox, you will have the option to do so here. Right next to the page title, '''click the ''Create'' button'''.
{{совет|В черновике вы можете написать предварительный текст статьи. После одобрения опытного редактора, статья будет переименована и перемещена в основное пространство имён.}}
 
 
 
4. If it opens up in the visual editor, select the option to '''open the source editor'''. You can find this option by clicking on the drop-down menu next to the Cancel and Publish buttons, and selecting Source Editor.
 


=== Обновление страниц ===
Иногда страницы могут вести себя странно, как будто сделанные вами изменения не внесены. Если это происходит, попробуйте добавить <code>?action=purge</code> в конец URL-адреса и перейти по этому адресу. Это приведёт к перезагрузке страницы и устранению многих проблем.


5. '''Paste the following code into the text box:'''
{{rules}}


<nowiki>{{Sandbox}}


                                      <!--EDIT BELOW THIS LINE--></nowiki>
6. '''Below this pasted text, you can begin to practice editing.''' One idea to begin with is to add a table of contents and links to useful templates and code that you often need to look up.
7. Whenever you are finished editing in the source editor, '''click ''Apply Changes''''' on the bottom right of the frame.
8. '''Click on ''Publish'' to save your page.'''
9. '''To find your Sandbox easily, add a link to it on your profile page.''' You can do so by pasting the following code into the source editor of your user page (found by clicking on your user icon, selecting Edit Profile under the Profile tab, and selecting the Source Editor option), replacing «Username» with your own username:
<nowiki>[[User:Username/Sandbox|My Sandbox]]</nowiki>
10. '''Voila!''' You now have a Sandbox of your own! Experiment with it as you please!
== Другие советы по аккаунту вики ==
[[Файл:Wiki Toolbar customize default.jpg|thumb|529x529px|Wiki Toolbar]]
=== Панель инструментов ===
[[Файл:Wiki Toolbar customize dialog.jpg|thumb|171x171px|Customization Dialog]]
Если у вас есть учетная запись вики, вы можете использовать панель инструментов, расположенную в нижней части экрана, для использования ярлыков и других инструментов для выполнения различных функций. Вы можете найти более подробную информацию на панели инструментов [http://habitica.wikia.com/wiki/Help:Toolbar здесь].
Список доступных инструментов панели инструментов см. на этой [http://habitica.wikia.com/wiki/Help:Toolbar/List_of_available_tools странице].
[[Файл:DisablingAdsWikiaAccount.png|thumb|263x263px|Disabling Ads on the Wiki|left]]
{{clr}}
=== Отключение рекламы ===
Если у вас есть учетная запись Wiki и вы хотите отключить рекламу, вы можете перейти на страницу настроек, прокрутить вниз до объявлений и выбрать «Не показывать все объявления», а затем сохранить свои настройки.
=== Обновление страниц ===
Иногда страницы могут вести себя странно, как будто не показываются изменения. Если это происходит, попробуйте добавить <code>?action=purge</code> в конец URL-адреса и перейти по этому адресу. Это приведёт к перезагрузке страницы и устранению многих проблем.
-->
[[Категория:DecimalWiki:Справка]]
[[Категория:DecimalWiki:Справка]]

Текущая версия от 16:22, 27 марта 2024


Это развивающееся руководство о том, как внести свой вклад в Decimal Wiki и над чем работать.

Целью Decimal Wiki является создание и поддержка аккуратного, обновляемого, завершённого и лёгкого в использовании справочника для всех, кто интересуется блокчейном Decimal и сферой криптоэкономики в целом. Присоединяйтесь к нашему проекту! Чтобы создавать и редактировать статьи, вам необходимо зарегистрироваться.

С чего начать

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

Обратите внимание! Незарегистрированные пользователи не могут создавать и править статьи в Decimal Wiki.

После регистрации не стесняйтесь заполнить страницу своего профиля некоторой информацией о себе. Давайте познакомимся с вами!

О чём писать

Наполнение вики — это не только создание абсолютно новых страниц, но и улучшение качества существующих.

Decimal Wiki — не просто справочник по блокчейну Decimal. Мы рассчитываем создать полноценную вики-энциклопедию, посвящённую сфере криптовалют, блокчейнов и Web3, что предполагает создание обширного корпуса статей. Разобраться, какие темы затрагиваются в нашей вики, вам поможет список требуемых статей.

Совет: Если у вас нет практического опыта создания или редактирования вики, вы можете начать с помощи в улучшении существующих страниц. Обратите внимание на список незаконченных статей. Исправление опечаток и грамматических ошибок (даже пропущенных точек) имеет значение. Рассмотрите возможность внесения незначительных правок как способ научиться ориентироваться на сайте и пользоваться редактором, прежде чем начать вносить крупные дополнения в страницы или создавать полноценные статьи.

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

Просмотр и (при необходимости) редактирование или удаление спекулятивного контента помогает сохранить точность вики.

Как создать статью

Как здесь редактировать

Обратите внимание! В настоящее время визуальный редактор в нашей вики проходит стадию отладки, поэтому правка текстов возможна только в редакторе кода. Если вам нужна помощь в работе с вики-разметкой, прочтите это пособие.

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

Быстрые советы по редактированию

  • Тон статьи должен быть информативным и полу-профессиональным. Используйте третье лицо (напр., «криптоинвесторы», «участники рынка») в вводной части статьи. Допустимо использовать второе лицо в последующих параграфах и предложениях (особенно когда создаёте страницу инструкции), но старайтесь не писать от первого лица, если только вы не пишете о собственной компании.
  • Длина страницы или раздела может быть настолько велика, насколько требуется, но не больше; статья должна быть информативной и сжатой.
  • Используйте форматирование текста (напр., жирное начертание, курсив) умеренно. Старайтесь не использовать цветной текст, зачеркивание, подчеркивание.
  • Соблюдайте правописание русского языка. Пишите полными предложениями, за исключением таблиц.
  • Добавляйте в текст соответствующие внутренние и внешние ссылки.
  • Добавьте изображения, если они будут полезны в контексте статьи; перед добавлением попробуйте поискать нужное вам изображение на странице Служебная:Список_файлов, а также в различных категориях изображений, чтобы избежать дубликатов. При обновлении существующего изображения загружайте новую версию того же самого файла, вместо загрузки нового изображения.
  • Добавляйте категории в статьи, если очевидная/полезная категория отсутствует. Проверьте страницу категорий, чтобы узнать, какую категорию можно добавить на страницу, и воздержитесь от создания категорий, которые не используются.
  • После внесения изменений, укажите в специальном поле снизу, что вы изменили. Это поможет остальным редакторам проверить вашу работу
  • Переименование страниц допустимо только в случае крайней необходимости. Если вы считаете, что это необходимо, оставьте соответствующий запрос к администраторам на странице обсуждения статьи.
  • Если вы считаете, что страница должна быть удалена, оставьте соответствующий запрос к администраторам на странице обсуждения статьи или поставьте на странице шаблон {{удалить|Причина удаления}}; укажите причину удаления.
  • Если вы хотите следить за изменениями в этой вики-странице или следить за новыми пользователями и правками, используйте страницу свежих правок.

Стиль статей

Тон

Тон изложения должен быть энциклопедическим, информативным и полупрофессиональным. Старайтесь писать так, чтобы текст был понятен для максимально широкого круга читателей. Статьи желательно начинать с четких и кратких определений рассматриваемого предмета, за которыми следует хорошо организованное и тщательное изложение темы. Понятие, которому посвящена статья, лучше всего помещать в начале статьи и выделять жирным шрифтом, а затем через тире давать краткое определение.

Длина статьи

Статья должна быть написана по существу и настолько велика, насколько это необходимо (особенно для более-менее широких тем). Старайтесь осветить все существенные аспекты, посвящая им отдельные разделы, но каждый аспект раскрывать по возможности лаконично. Не забывайте ставить вики-ссылки на «связанные» страницы в самом тексте или с помощью раздела «См. также».

Форматирование

Основная статья: DecimalWiki:Правила оформления страниц

Рис. 1: панель редактирования (общий вид)
Рис. 2: кнопки вики-разметки
Рис. 3: справка по оформлению текста

Над окном редактирования вы видите панель инструментов (рис. 1). Нажав на ссылку «Дополнительно», вы увидите дополнительные кнопки для быстрой вставки вики-разметки: заголовков, списков, иллюстраций, таблиц и т. п. (рис. 2). По ссылке «Справка» вам откроется поле с краткими пояснениями по оформлению вики-текста (рис. 3). Не стесняйтесь пользоваться этими инструментами, чтобы придать вашему тексту красивый и завершённый вид.

Викификация

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

Текст

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

Отступы

Поля и отступы — это названия пространства вокруг элемента, будь то текст, изображение, таблица и т. д. На вики-странице не нужно специально ставить абзацные отступы. Другие элементы оформления абзацев можно делать с помощью CSS и атрибута style. Подробнее об использовании отступов вы можете прочитать здесь: margins и padding.

Правописание

В этой вики мы следуем стандартным правилам грамматики русского языка.

Это включает в себя (но не ограничивается ими) интервалы и знаки препинания. Используйте один пробел между предложениями. За сокращениями должны следовать точки (например, напр. и т.е.). Если вы видите грамматические ошибки на вики-странице, не стесняйтесь исправить их! Кроме того, обязательно перепроверьте (а может быть, даже трижды перепроверьте) свои собственные правки, чтобы убедиться, что на странице нет никаких ошибок.

Заглавные (прописные) буквы

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

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

Заглавные буквы в заголовках и подзаголовках соответствуют русским, а не английским правилам: Пример подзаголовка статьи в Decimal Wiki, а не Пример Подзаголовка Статьи в Decimal Wiki.

В самом тексте, а также в обсуждении статей избегайте использовать CAPS LOCK. Запись КРУПНЫМИ буквами воспринимается как крик и считается неприличным тоном в интернет-среде.

Ссылки

Релевантные внутренние ссылки на статьи помогают читателям просматривать вики-страницы и избегать тупиковых страниц. Не ссылайтесь на вики-страницы, которые в настоящее время не существуют, если не хотите, чтобы на странице не было «красных» ссылок.

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

Вы можете добавить внутренние вики-ссылки на другие статьи Decimal Wiki. Для этого используйте двойные квадратные скобки вокруг заголовка страницы, на которую вы хотите сделать ссылку. Например, [[Блокчейн]] выглядит как Блокчейн. Вы также можете использовать вертикальную полосу (|) для настройки заголовка ссылки — скажем, если не совпадает падеж. Например, при вводе [[Блокчейн|блокчейну]] получится блокчейну.

Вы можете добавлять внешние ссылки, заключив URL-адрес в одиночные квадратные скобки. Например, [http://www.tablesgenerator.com/mediawiki_tables TablesGenerator.com] становится TablesGenerator.com. Обратите внимание, что для отделения URL-адреса от необязательного текста используется пробел, а не прямой слэш (|), как в вики-ссылке.

Поскольку наша вики постоянно улучшается и развивается, страницы могут объединяться, удаляться или переименовываться. Например, страница Монета ранее называлась Криптомонета. Чтобы предотвратить возникновение «красных» ссылок на страницы, которые больше не существуют, администраторы оставляют перенаправляющие ссылки на удаленные или переименованные статьи. Это означает, что при создании новых внутренних ссылок в поле для предложений автозаполнения будут указаны эти старые названия ссылок. Когда пользователи вики переходят по старым ссылкам, они перенаправляются на новую страницу. Новая страница предупреждает пользователя о перенаправлении по старой ссылке сообщением под заголовком страницы «Перенаправлено с [старое название страницы]».

Заголовки разделов

Широкое использование подзаголовков (h2, h3, h4 и т. д.) разбивает статью на части, что облегчает чтение и позволяет автоматически генерировать оглавления. Однако слишком большое количество подзаголовков затрудняет чтение текста, особенно если связанный контент разбивается без необходимости. Чтобы текст было легко читать, старайтесь соблюдать баланс в количестве используемых заголовков.

Заголовки и подзаголовки не следует изменять без необходимости. На них могут быть ссылаться другие страницы и сайты за пределами нашей вики (например, GitHub и записи в блогах), поэтому любое изменение заголовка сделает эти ссылки нефункциональными. Если необходимо изменить заголовок, исправьте все ссылки, ведущие на него из других разделов Decimal Wiki.

Заголовки и подзаголовки пишутся с заглавной буквы в соответствии с правилами русской грамматики, описанными в справочной статье Википедии. Однако, если вы видите существующий заголовок с неправильной заглавной буквой, пожалуйста, не меняйте его, если только вы не уверены, что на него не ссылаются другие статьи.

Оглавление (TOC)

Плашка с оглавлением страницы (Table of Content, TOC) генерируется автоматически после появления в статье четвертого подзаголовка типа h2. Можно заставить оглавление отображаться менее чем с четырьмя подзаголовками, включив в исходное представление редактора в начале вики-документа следующую переменную: __TOC__. Чтобы расположить оглавление с правого края страницы, введите в верхней части вики-документа шаблон {{TOC right}}.

Изображения

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

Последовательность действий описана на странице Загрузить файл. Названия загружаемых файлов чувствительны к регистру. При загрузке нового изображения под тем же названием старое изображение сохраняется в истории правок, так же, как текст статей. Если вы считаете нужным удалить старую версию изображения или изображение полностью, а также переименовать загруженный файл, обратитесь к администраторам.

Загрузка файлов отражается в журнале загрузки файлов. Просмотреть ранее загруженные файлы можно в списке или галерее загруженных изображений.

Типы файлов

Изображения желательно загружать в формате PNG с максимально доступным разрешением. В особых случаях допускаются различные форматы изображений (например, если необходим анимированный GIF).

Другие разрешённые типы файлов: jpg, jpeg, doc, xls, mpp, pdf, ppt, tiff, bmp, docx, xlsx, mp4, flac, mkv, mov, mp3, oga, ogg, ogv, wav, webm.

Авторское право

При написании статей или загрузке изображений соблюдайте авторское право.

Видео

В статью можно вставлять ролики с YouTube в виде окошка с потоковым видео. Это реализовано с помощью шаблонов {{youtube}} и {{yt}}. Инструкции по их использованию вы можете прочитать в документации на страницах этих шаблонов.

Категоризация статей

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

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

Описание изменений

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

Переименование страниц

В редких случаях страницу может потребоваться переименовать. Когда страница переименовывается, вики-движок автоматически создает на старой странице перенаправление («редирект»), которое будет содержать ссылку на новое название. Если вы хотите избежать этого, на странице переименования уберите галочку в строке «Оставить перенаправление».

При необходимости вы можете подать запрос администрации, чтобы страница с перенаправлением была удалена.

Удаление

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

{{удалить|Причина удаления}}

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

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

Рис. 4: ссылка для быстрого создания черновика.

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

Проще всего создать свой черновик, нажав на соответствующую ссылку на главной странице (рис. 4). Страница черновика создаётся в вашем личном пользовательском пространстве, ссылка выглядит так: [[Участник:Имя_участника/Черновик]].

Кроме того, вы можете создать черновик под любым другим названием (например, «Песочница»), совершив последовательность действий:

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

2. Добавьте /Песочница в конце URL в адресной строке браузера. Для этого нажмите на поле URL в вашем браузере, отмените выделение текста и введите «/Песочница» в самом конце. Нажмите Enter.

3. Поскольку вы еще не создали страницу, вам будет предложено сделать это прямо сейчас. Нажмите на ссылку «создать страницу с таким названием».

4. В открывшемся окне редактирования вставьте следующий код:

{{Черновик}}
<!--ПРАВЬТЕ НИЖЕ ЭТОЙ ЛИНИИ-->

5. Под этим вставленным текстом вы можете начать практиковаться в редактировании. Одна из идей для начала — добавить оглавление и ссылки на полезные шаблоны и ссылки, которые вам часто приходится просматривать.

6. Всякий раз, когда вы закончите редактирование в редакторе кода, нажмите «Внесённые изменения» под окном редактирования. Также вы можете посмотреть, как изменится страница, нажав на кнопку «Предварительный просмотр».

7. Нажмите «Записать изменения».

Совет: Чтобы легко найти свой черновик, добавьте ссылку на него на странице своего профиля. Для этого вставьте следующий код в окне редактирования вашей страницы пользователя, заменив «Имя_участника» на ваше собственное имя пользователя: [[Участник:Имя_участника/Название_страницы|Мой черновик]]

8. Ура! Вы создали собственную страницу-песочницу! Экспериментируйте с ней, как вам будет угодно, изучайте вики-разметку и повышайте свой скилл редактирования вики!

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

Обновление страниц

Иногда страницы могут вести себя странно, как будто сделанные вами изменения не внесены. Если это происходит, попробуйте добавить ?action=purge в конец URL-адреса и перейти по этому адресу. Это приведёт к перезагрузке страницы и устранению многих проблем.

   Эта страница относится к своду правил и документов Decimal Wiki.
   Править её могут только администраторы проекта.