How to contribute/ru: Difference between revisions

From DDraceNetwork
(Translated 'How to create a video' and translated some other bits on the page)
(Updating to match new version of source page)
Line 1: Line 1:
{{LangNavBox}}
<languages/>
{{Stub/ru}}
<div lang="en" dir="ltr" class="mw-content-ltr">
We welcome you to contribute to this wiki. Feel free to edit any pages to improve this wiki. All changes made in good faith are welcome. [[wikipedia:Wikipedia:Be_bold|Be bold!]] When you are unsure about something, you can always ask in the #wiki channel on [https://ddnet.org/discord Discord] or [https://matrix.to/#/#ddnet-wiki:matrix.org Matrix]. This page should help getting started to contribute. You need to register in order to contribute.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
== What to contribute? ==
== What to contribute? ==
Мы поощряем любой вид контрибуции. Здесь показаны несколько примеров того, что вы можете сделать:
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
We encourage every kind of contribution. Here are a few examples what you could do:
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
* You can always fix problems you see, correct grammar, make sure wording is accurate, etc.
* Expand an article by covering another topic
* Create videos for articles ([[Special:MyLanguage/#how_to_create_a_video|How to create videos]])
* Write a new article. A variety of topics are yet to be covered
* Here you can find articles that need content: [[:Category:Needs Content|:Category:Needs Content]]
</div>
 
 
<div lang="en" dir="ltr" class="mw-content-ltr">
== What content is accepted? ==
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
Articles should be related to the DDNet and Teeworlds community/projects/ecosystem.
</div>


* Вы всегда можете исправлять проблемы, поправлять грамматику, make sure формулировка верна, и т.д. (See Editing Pages)
<div lang="en" dir="ltr" class="mw-content-ltr">
* Можете расширить статью, добавив в неё дополнительные разделы по теме статьи
Please do not put "Made by X" or "Wiki Article by X" when writing an article, authorship is seen by contributions that can be looked up on "View History", not at the article directly.
* Создавать видео для статей ([[#How_to_create_a_video|How to create videos]])
</div>
* Написать статью. Множество тем ещё не раскрыто
* Здесь вы найдёте статьи, которым нужно добавить контент: [[:Category:Needs Content/ru]]


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


<div lang="en" dir="ltr" class="mw-content-ltr">
== Moderation ==
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Changes made to the wiki go to a moderation queue, where moderators will check if the change you made is vandalism.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Here are our practices we follow when moderating content, which the extension itself recommends:
Here are our practices we follow when moderating content, which the extension itself recommends:
</div>


=== Рекомендации при модерации ===
 
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Recommended use / good practices for moderators ===
</div>
 
<div lang="en" dir="ltr" class="mw-content-ltr">
The following good-practices are advised:
The following good-practices are advised:
</div>


# Должны быть отклонены только вандальные правки. Not-so-good edits with good intentions (e.g. adding excessive plot details into the Wikipedia article about film) are better made Approved and then reverted as usual. This way the author is not offended and the text is saved in page history, viewable by anyone.
<div lang="en" dir="ltr" class="mw-content-ltr">
# Only vandalism should be Rejected. Not-so-good edits with good intentions (e.g. adding excessive plot details into the Wikipedia article about film) are better made Approved and then reverted as usual. This way the author is not offended and the text is saved in page history, viewable by anyone.
# Any user that is deemed legitimate (does N good edits) should be added into <code>automoderated</code> group.
# Any user that is deemed legitimate (does N good edits) should be added into <code>automoderated</code> group.
# Adding users to <code>automoderated</code> group via <code>$wgAutopromote</code> is NOT recommended, as it motivates the vandals to do many very-minor edits (e.g. adding interwiki). Better promote them to <code>automoderated</code> manually for one good edit and not promote for 30 useless-edits-made-for-count.
# Adding users to <code>automoderated</code> group via <code>$wgAutopromote</code> is NOT recommended, as it motivates the vandals to do many very-minor edits (e.g. adding interwiki). Better promote them to <code>automoderated</code> manually for one good edit and not promote for 30 useless-edits-made-for-count.
# Abstain from using blocks. Don't protect pages "just in case", except maybe for important templates.
# Abstain from using blocks. Don't protect pages "just in case", except maybe for important templates.
# Allow the full rehabilitation of users with a bad history of editing. Their useful edits to the articles should be allowed, no matter how many times they were blocked. At the same time, trolling on talk pages should be rejected, so are the purposely-low-quality edits.
# Allow the full rehabilitation of users with a bad history of editing. Their useful edits to the articles should be allowed, no matter how many times they were blocked. At the same time, trolling on talk pages should be rejected, so are the purposely-low-quality edits.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
== How to create a video ==
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Step 1: Getting a Map ===
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
==== Variant 1: Using an existing map ====
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
To use maps from videos in the wiki:
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# Right-click the video and click ‘Open Video in New Tab’. Now you can find the name of the video in the URL
# Go [https://gitlab.com/ddnet-wiki/ddnet-wiki.gitlab.io/-/tree/master/static/videosherehere here] and download the correct demo
# Open the demo in your client (you need to move the demo into your <code>data/demos</code> folder)
# While you have the demo open, go into the editor, click <code>File</code>, and select <code>Load Current Map</code>
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Now you can edit and use the map for the demo.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
==== Variant 2: Creating a new map ====
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# Create a new map in the editor
# Set the background color to <code>#5E84AE</code>
## Click on the <code>quads</code> layer
## Right-click the corners of the rectangle
## Insert the color value <code>#5E84AE</code> into the third to last field each each
# The main focus should be that it is comprehensible
# Keep the style simple and similar to the other videos
#* Use simple textures (preferably <code>grass_main</code>, combined with <code>generic_unhookable</code> and <code>font_teeworlds</code>)
#* Make it loopable, you can get creative with that :)
#* Insert a scale if suited
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
==== Step 2.1: Recording the demo ====
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# Turn demo recording on
#* I suggest <code>Settings -> General -> Automatically record demos</code>
# Load the map on a server
#* Start your own DDNet server or use the [https://trashmap.timakro.de/ Trashmap] hosting service
# Join it with your client, try the trick until you are satisfied with the result and keep loopability in mind
</div>


== Как создать видео ==
=== Шаг 1: Выбрать карту ===


==== Вариант 1: Использовать готовую карту ====
<div lang="en" dir="ltr" class="mw-content-ltr">
==== Recording Settings ====
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Set consistent skin:
</div>


Использовать карты с видео на wiki:
<div lang="en" dir="ltr" class="mw-content-ltr">
* Hammer: brownbear
* Pistol: coala
* Shotgun: cammo
* Grenade: redstripe
* Laser: bluestripe
* Hook: default
* Jump: bluekitty
</div>


# Нажмите правой кнопкой мыши на видео 'Открыть видео в новой вкладке'. Теперь найдите название видео в ссылке.
# Идите [https://gitlab.com/ddnet-wiki/ddnet-wiki.gitlab.io/-/tree/master/static/videosherehere сюда] и скачайте верное демо
# Откройте демо в клиенте (переместите демо в вашу <code>data/demos</code> папку)
# При открытом демо, откройте редактор, нажмите <code>File</code>, и выберите <code>Load Current Map</code>


Теперь мы можете редактировать и использовать карту из демо.
<div lang="en" dir="ltr" class="mw-content-ltr">
==== Step 2.2: Cutting the demo ====
</div>


==== Вариант 2: Создать новую карту ====
<div lang="en" dir="ltr" class="mw-content-ltr">
# In your client, go to <code>Demos -> auto/</code>
# Open the demo you recorded
#* Tip: Click on <code>Date</code> to sort by date
# Press <code>Escape</code> for demo functions
# Use the 2 buttons on the left of the camera icons to select a starting and end point
# Use the camera icon to save the shortened demo
</div>


# Создайте новую карту в редактотре
<div lang="en" dir="ltr" class="mw-content-ltr">
# Поменяйте цвет фона на <code>#5E84AE</code>
Tip: you can repeat these steps multiple times to be able to cut the demo more precisely
## Нажмите на слой <code>quads</code>
</div>
## Правой кнопкой нажмите на угол прямоугольника
## Вставьте цвет <code>#5E84AE</code> в каждое третье с конца поле
# Самое главное, что оно должно быть понятно
# Сохраняйте простой стиль, похожий на другие видео
#* Используйте простые текстуры (предпочтительно <code>grass_main</code>, вместе с <code>generic_unhookable</code> и<code>font_teeworlds</code>)
#* Сделайте его зацикливающимся, можете подойти к этому творчески :)
#* При необходимости добавьте масштаб


==== Шаг 2.1: Запись видео ====


# Включите запись демо
<div lang="en" dir="ltr" class="mw-content-ltr">
#* Я предлагаю <code>Settings -> General -> Automatically record demos</code>
==== Step 2.3: Converting the demo to a video ====
# Загрузите карту на сервере
</div>
#* Запустите свой сервер DDNet или используйте сервис хостинга [https://trashmap.timakro.de/ Trashmap]
# Зайдите на него со своего клиента, делайте трюк, пока не будете довольны результатом. И не забывайте про зацикливание.


==== Настройки записи ====
<div lang="en" dir="ltr" class="mw-content-ltr">
Выберите подходящий скин:
Once you have the client, converting a demo is as simple as:
</div>


* Молоток: brownbear
<div lang="en" dir="ltr" class="mw-content-ltr">
* Пистолет: coala
* Open the client (with the converting functionality)
* Дробовик: cammo
* Set zoom to 10: <code>cl_default_zoom 10</code>
* Граната: redstripe
* Go to the <code>Demos</code> tab
* Лазер: bluestripe
* Select the correct demo
* Хук: default
* Click <code>Render</code> at the bottom
* Прыжок: bluekitty
</div>


==== Шаг 2.2: Обрезка демо ====


# В вашем клиенту, откройте <code>Demos -> auto/</code>
<div lang="en" dir="ltr" class="mw-content-ltr">
# Выберите демо которое вы записали
=== Step 3: Getting the video into the wiki ===
#* Подсказка: Нажмите на <code>Date</code> для сортировки по дате
</div>
# Нажмите <code>Escape</code> для функций демо
# Используйте 2 кнопки справа от иконок камер, чтобы выбрать стартовую и конечную точку
# Используйте иконку камеры, чтобы сохранить укороченное демо


Подсказка: вы можете повторять эти шаги множество раз, чтобы точнее обрезать демо
<div lang="en" dir="ltr" class="mw-content-ltr">
Some of the following steps might be a little overwhelming. You can simply ask one of the wiki admins to do the remaining steps.
</div>


==== Шаг 2.3: Конвертирование демо в видео ====
Чтобы конвертировать демо:


* Откройте клиент (with the converting functionality)
<div lang="en" dir="ltr" class="mw-content-ltr">
* Поставьте приближение 10: <code>cl_default_zoom 10</code>
==== Step 3.1: Cropping the video ====
* Откройте панель <code>Demos</code>
</div>
* Выберите ваше демо
* Нажмите <code>Render</code> снизу


=== Шаг 3: Помещение видео на вики ===
<div lang="en" dir="ltr" class="mw-content-ltr">
Некоторые из шагов могут быть немного тяжелы. Можете просто попросить одного из админов вики доделать оставшиеся шаги.
Using your preferred video editor, crop the video, so that only the relevant cutout of the video remains. You can look at other videos from the wiki to get a feel for how much you should crop.
</div>


==== Шаг 3.1: Обрезка видео ====
Используя ваш предпочитаемый видео-редактор, обрежьте видео, так чтобы остались только главные части видео. Вы можете посмотреть на другие видео с вики, чтобы понять как вам необходимо обрезать.


==== Шаг 3.2: Загрузка видео на вики ====
<div lang="en" dir="ltr" class="mw-content-ltr">
Чтобы загрузить видео на вики, вам нужны права. Если вы считаетесь доверенным участником, вы их получите. Если вы считаете, что заслуживаете доверие, попросите администора рассмотреть получение вами разрешения на загрузку файлов.
==== Step 3.2: Uploading the video to the wiki ====
</div>


Чтобы загрузить файл, перейдите по ссылке [[Special:Upload|Upload file]] на боковой панели.
<div lang="en" dir="ltr" class="mw-content-ltr">
To upload a video to the wiki first you need permissions, if you are considered a trustworthy contributor you will get them, if you consider yourself trustworthy you can ask an administrator to consider giving you the permission to upload files.
</div>


==== Шаг 3.3: Вставка видео в статью ====
<div lang="en" dir="ltr" class="mw-content-ltr">
Чтобы вставить видео в статью, сначала вы должны определить, подходит ли оно к тексту или вставить его на стороне.
To upload a file you can go to [[Special:MyLanguage/Special:Upload|Upload file]] link on the sidebar.
</div>


Обычно, если текст включает в себя какие-то шаги или видео напрямую относится к тексту, лучше поставить его так:


<div lang="en" dir="ltr" class="mw-content-ltr">
==== Step 3.3: Inserting the video into an article ====
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
To insert a video into an article, first you have to choose whether it fits in the text or on a side.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Usually, if the text mentions some steps to take or the video is directly related to a text, it's better to put it there like this:
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
<nowiki>[[File:myvideo.mp4|gif]]</nowiki>
<nowiki>[[File:myvideo.mp4|gif]]</nowiki>
</div>


Если думаете, что лучше пусть висит на правой стороне, можете сделать так:
<div lang="en" dir="ltr" class="mw-content-ltr">
If you consider it better to be floating on the right side, you can do this
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<nowiki>[[File:myvideo.mp4|right|gif]]</nowiki>
<nowiki>[[File:myvideo.mp4|right|gif]]</nowiki>
</div>


Или с миниатюрой и подписью:
<div lang="en" dir="ltr" class="mw-content-ltr">
Or with a thumb and a label:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<nowiki>[[File:myvideo.mp4|thumb|This video shows this!|gif]]</nowiki>
<nowiki>[[File:myvideo.mp4|thumb|This video shows this!|gif]]</nowiki>
</div>


Если думаете, что видео слишком мало, можете задать размер:
<div lang="en" dir="ltr" class="mw-content-ltr">
If you think the video is too small, you can specify a size:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<nowiki>[[File:myvideo.mp4|gif|400px]]</nowiki>
<nowiki>[[File:myvideo.mp4|gif|400px]]</nowiki>
</div>


Вы можете узнать о размещении медиа подробнее здесь: https://www.mediawiki.org/wiki/Help:Images/ru
<div lang="en" dir="ltr" class="mw-content-ltr">
You can learn more in detail about media placement here: https://www.mediawiki.org/wiki/Help:Images
</div>


== Шаблоны ==
Если заметите что какие-то элементы часто повторяются, такие как блоки информации об оружии, можете автоматизировать их, создавая шаблоны, подробнее [[mediawikiwiki:Help:Templates|здесь]].


Список созданных шаблонов:
<div lang="en" dir="ltr" class="mw-content-ltr">
== Templates ==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
If you identify a common occurrence, such as weapon info boxes, you can automate it creating templates, more info [[mediawikiwiki:Help:Templates|here]].
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
List of created templates:
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
[[:Category:Templates|Category:Templates]]
[[:Category:Templates|Category:Templates]]
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
== Translation ==
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Title ===
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
To translate the title you can go to "Edit source" and add <code><nowiki>{{DISPLAYTITLE:Translated title}}</nowiki></code>  to the top of the page replacing "Translated title" with the title you want displayed.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
=== Linking ===
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
You can archive the same in the visual editor, by first linking the translated page: e.g. by typing <code>[[</code> to open the linking page. Enter <code>Jump/de</code> to link to the correct page and then modify the display text to the translated version.
</div>

Revision as of 17:19, 11 February 2023

We welcome you to contribute to this wiki. Feel free to edit any pages to improve this wiki. All changes made in good faith are welcome. Be bold! When you are unsure about something, you can always ask in the #wiki channel on Discord or Matrix. This page should help getting started to contribute. You need to register in order to contribute.


What to contribute?

We encourage every kind of contribution. Here are a few examples what you could do:

  • You can always fix problems you see, correct grammar, make sure wording is accurate, etc.
  • Expand an article by covering another topic
  • Create videos for articles (How to create videos)
  • Write a new article. A variety of topics are yet to be covered
  • Here you can find articles that need content: :Category:Needs Content


What content is accepted?

Articles should be related to the DDNet and Teeworlds community/projects/ecosystem.

Please do not put "Made by X" or "Wiki Article by X" when writing an article, authorship is seen by contributions that can be looked up on "View History", not at the article directly.


Moderation

Changes made to the wiki go to a moderation queue, where moderators will check if the change you made is vandalism.

Here are our practices we follow when moderating content, which the extension itself recommends:


Recommended use / good practices for moderators

The following good-practices are advised:

  1. Only vandalism should be Rejected. Not-so-good edits with good intentions (e.g. adding excessive plot details into the Wikipedia article about film) are better made Approved and then reverted as usual. This way the author is not offended and the text is saved in page history, viewable by anyone.
  2. Any user that is deemed legitimate (does N good edits) should be added into automoderated group.
  3. Adding users to automoderated group via $wgAutopromote is NOT recommended, as it motivates the vandals to do many very-minor edits (e.g. adding interwiki). Better promote them to automoderated manually for one good edit and not promote for 30 useless-edits-made-for-count.
  4. Abstain from using blocks. Don't protect pages "just in case", except maybe for important templates.
  5. Allow the full rehabilitation of users with a bad history of editing. Their useful edits to the articles should be allowed, no matter how many times they were blocked. At the same time, trolling on talk pages should be rejected, so are the purposely-low-quality edits.


How to create a video


Step 1: Getting a Map


Variant 1: Using an existing map

To use maps from videos in the wiki:

  1. Right-click the video and click ‘Open Video in New Tab’. Now you can find the name of the video in the URL
  2. Go here and download the correct demo
  3. Open the demo in your client (you need to move the demo into your data/demos folder)
  4. While you have the demo open, go into the editor, click File, and select Load Current Map

Now you can edit and use the map for the demo.


Variant 2: Creating a new map

  1. Create a new map in the editor
  2. Set the background color to #5E84AE
    1. Click on the quads layer
    2. Right-click the corners of the rectangle
    3. Insert the color value #5E84AE into the third to last field each each
  3. The main focus should be that it is comprehensible
  4. Keep the style simple and similar to the other videos
    • Use simple textures (preferably grass_main, combined with generic_unhookable and font_teeworlds)
    • Make it loopable, you can get creative with that :)
    • Insert a scale if suited


Step 2.1: Recording the demo

  1. Turn demo recording on
    • I suggest Settings -> General -> Automatically record demos
  2. Load the map on a server
    • Start your own DDNet server or use the Trashmap hosting service
  3. Join it with your client, try the trick until you are satisfied with the result and keep loopability in mind


Recording Settings

Set consistent skin:

  • Hammer: brownbear
  • Pistol: coala
  • Shotgun: cammo
  • Grenade: redstripe
  • Laser: bluestripe
  • Hook: default
  • Jump: bluekitty


Step 2.2: Cutting the demo

  1. In your client, go to Demos -> auto/
  2. Open the demo you recorded
    • Tip: Click on Date to sort by date
  3. Press Escape for demo functions
  4. Use the 2 buttons on the left of the camera icons to select a starting and end point
  5. Use the camera icon to save the shortened demo

Tip: you can repeat these steps multiple times to be able to cut the demo more precisely


Step 2.3: Converting the demo to a video

Once you have the client, converting a demo is as simple as:

  • Open the client (with the converting functionality)
  • Set zoom to 10: cl_default_zoom 10
  • Go to the Demos tab
  • Select the correct demo
  • Click Render at the bottom


Step 3: Getting the video into the wiki

Some of the following steps might be a little overwhelming. You can simply ask one of the wiki admins to do the remaining steps.


Step 3.1: Cropping the video

Using your preferred video editor, crop the video, so that only the relevant cutout of the video remains. You can look at other videos from the wiki to get a feel for how much you should crop.


Step 3.2: Uploading the video to the wiki

To upload a video to the wiki first you need permissions, if you are considered a trustworthy contributor you will get them, if you consider yourself trustworthy you can ask an administrator to consider giving you the permission to upload files.

To upload a file you can go to Upload file link on the sidebar.


Step 3.3: Inserting the video into an article

To insert a video into an article, first you have to choose whether it fits in the text or on a side.

Usually, if the text mentions some steps to take or the video is directly related to a text, it's better to put it there like this:

[[File:myvideo.mp4|gif]]

If you consider it better to be floating on the right side, you can do this

[[File:myvideo.mp4|right|gif]]

Or with a thumb and a label:

[[File:myvideo.mp4|thumb|This video shows this!|gif]]

If you think the video is too small, you can specify a size:

[[File:myvideo.mp4|gif|400px]]

You can learn more in detail about media placement here: https://www.mediawiki.org/wiki/Help:Images


Templates

If you identify a common occurrence, such as weapon info boxes, you can automate it creating templates, more info here.

List of created templates:


Translation


Title

To translate the title you can go to "Edit source" and add {{DISPLAYTITLE:Translated title}} to the top of the page replacing "Translated title" with the title you want displayed.


Linking

You can archive the same in the visual editor, by first linking the translated page: e.g. by typing [[ to open the linking page. Enter Jump/de to link to the correct page and then modify the display text to the translated version.