How to contribute: Difference between revisions

"Update links from ddnet.tw to ddnet.org"
Rafaelff (talk | contribs)
Linking: Archive -> Achieve, and explain what is 'de' in 'Jump/de'
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{LangNavBox}}
<languages/>
<translate>
<!--T:1-->
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.
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.


== What to contribute? ==
== What to contribute? == <!--T:2-->
 
<!--T:3-->
We encourage every kind of contribution. Here are a few examples what you could do:
We encourage every kind of contribution. Here are a few examples what you could do:


<!--T:4-->
* You can always fix problems you see, correct grammar, make sure wording is accurate, etc.
* You can always fix problems you see, correct grammar, make sure wording is accurate, etc.
* Expand an article by covering another topic
* Expand an article by covering another topic
* Create videos for articles ([[#How_to_create_a_video|How to create videos]])
* Create videos for articles ([[Special:MyLanguage/How to contribute#how_to_create_a_video|How to create videos]])
* Write a new article. A variety of topics are yet to be covered
* Write a new article. A variety of topics are yet to be covered
* Here you can find articles that need content: [[:Category:Needs Content]]
* Here you can find articles that need content: [[:Category:Needs Content|:Category:Needs Content]]
 
== What content is accepted? == <!--T:5-->


== What content is accepted? ==
<!--T:6-->
Articles should be related to the DDNet and Teeworlds community/projects/ecosystem.
Articles should be related to the DDNet and Teeworlds community/projects/ecosystem.


<!--T:7-->
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.
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 ==
== Moderation == <!--T:8-->
 
<!--T:9-->
Changes made to the wiki go to a moderation queue, where moderators will check if the change you made is vandalism.
Changes made to the wiki go to a moderation queue, where moderators will check if the change you made is vandalism.


<!--T:10-->
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:


=== Recommended use / good practices when moderating ===
=== Recommended use / good practices for moderators === <!--T:11-->
 
<!--T:12-->
The following good-practices are advised:
The following good-practices are advised:


<!--T:13-->
# 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.
# 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.
Line 30: Line 44:
# 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.


== How to create a video ==
== How to create a video == <!--T:14-->
=== Step 1: Getting a Map ===


==== Variant 1: Using an existing map ====
=== Step 1: Getting a Map === <!--T:15-->
 
==== Variant 1: Using an existing map ==== <!--T:16-->
 
<!--T:17-->
To use maps from videos in the wiki:
To use maps from videos in the wiki:


<!--T:18-->
# Right-click the video and click ‘Open Video in New Tab’. Now you can find the name of the video in the URL
# 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
# Go [https://gitlab.com/ddnet-wiki/ddnet-wiki.gitlab.io/-/tree/master/static/videos 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)
# 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>
# While you have the demo open, go into the editor, click <code>File</code>, and select <code>Load Current Map</code>


<!--T:19-->
Now you can edit and use the map for the demo.
Now you can edit and use the map for the demo.


==== Variant 2: Creating a new map ====
==== Variant 2: Creating a new map ==== <!--T:20-->


<!--T:21-->
# Create a new map in the editor
# Create a new map in the editor
# Set the background color to <code>#5E84AE</code>
# Set the background color to <code>#5E84AE</code>
Line 56: Line 76:
#* Insert a scale if suited
#* Insert a scale if suited


==== Step 2.1: Recording the demo ====
==== Step 2.1: Recording the demo ==== <!--T:22-->


<!--T:23-->
# Turn demo recording on
# Turn demo recording on
#* I suggest <code>Settings -> General -> Automatically record demos</code>
#* I suggest <code>Settings -> General -> Automatically record demos</code>
Line 64: Line 85:
# Join it with your client, try the trick until you are satisfied with the result and keep loopability in mind
# Join it with your client, try the trick until you are satisfied with the result and keep loopability in mind


==== Recording Settings ====
==== Recording Settings ==== <!--T:24-->
 
<!--T:25-->
Set consistent skin:
Set consistent skin:


<!--T:26-->
* Hammer: brownbear
* Hammer: brownbear
* Pistol: coala
* Pistol: coala
Line 75: Line 99:
* Jump: bluekitty
* Jump: bluekitty


==== Step 2.2: Cutting the demo ====
==== Step 2.2: Cutting the demo ==== <!--T:27-->


<!--T:28-->
# In your client, go to <code>Demos -> auto/</code>
# In your client, go to <code>Demos -> auto/</code>
# Open the demo you recorded
# Open the demo you recorded
Line 84: Line 109:
# Use the camera icon to save the shortened demo
# Use the camera icon to save the shortened demo


<!--T:29-->
Tip: you can repeat these steps multiple times to be able to cut the demo more precisely
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 ====
==== Step 2.3: Converting the demo to a video ==== <!--T:30-->
 
<!--T:31-->
Once you have the client, converting a demo is as simple as:
Once you have the client, converting a demo is as simple as:


<!--T:32-->
* Open the client (with the converting functionality)
* Open the client (with the converting functionality)
* Set zoom to 10: <code>cl_default_zoom 10</code>
* Set zoom to 10: <code>cl_default_zoom 10</code>
Line 95: Line 124:
* Click <code>Render</code> at the bottom
* Click <code>Render</code> at the bottom


=== Step 3: Getting the video into the wiki ===
=== Step 3: Getting the video into the wiki === <!--T:33-->
 
<!--T:34-->
Some of the following steps might be a little overwhelming. You can simply ask one of the wiki admins to do the remaining steps.
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 ====
==== Step 3.1: Cropping the video ==== <!--T:35-->
 
<!--T:36-->
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.
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 ====
==== Step 3.2: Uploading the video to the wiki ==== <!--T:37-->
 
<!--T:38-->
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 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.


<!--T:39-->
To upload a file you can go to [[Special:Upload|Upload file]] link on the sidebar.
To upload a file you can go to [[Special:Upload|Upload file]] link on the sidebar.


==== Step 3.3: Inserting the video into an article ====
==== Step 3.3: Inserting the video into an article ==== <!--T:40-->
 
<!--T:41-->
To insert a video into an article, first you have to choose whether it fits in the text or on a side.
To insert a video into an article, first you have to choose whether it fits in the text or on a side.


<!--T:42-->
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:
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:


<!--T:43-->
<nowiki>[[File:myvideo.mp4|gif]]</nowiki>
<nowiki>[[File:myvideo.mp4|gif]]</nowiki>


<!--T:44-->
If you consider it better to be floating on the right side, you can do this
If you consider it better to be floating on the right side, you can do this


<!--T:45-->
<nowiki>[[File:myvideo.mp4|right|gif]]</nowiki>
<nowiki>[[File:myvideo.mp4|right|gif]]</nowiki>


<!--T:46-->
Or with a thumb and a label:
Or with a thumb and a label:


<!--T:47-->
<nowiki>[[File:myvideo.mp4|thumb|This video shows this!|gif]]</nowiki>
<nowiki>[[File:myvideo.mp4|thumb|This video shows this!|gif]]</nowiki>


<!--T:48-->
If you think the video is too small, you can specify a size:
If you think the video is too small, you can specify a size:


<!--T:49-->
<nowiki>[[File:myvideo.mp4|gif|400px]]</nowiki>
<nowiki>[[File:myvideo.mp4|gif|400px]]</nowiki>


<!--T:50-->
You can learn more in detail about media placement here: https://www.mediawiki.org/wiki/Help:Images
You can learn more in detail about media placement here: https://www.mediawiki.org/wiki/Help:Images


== Templates ==
== Templates == <!--T:51-->
 
<!--T:52-->
If you identify a common occurrence, such as weapon info boxes, you can automate it creating templates, more info [[mediawikiwiki:Help:Templates|here]].
If you identify a common occurrence, such as weapon info boxes, you can automate it creating templates, more info [[mediawikiwiki:Help:Templates|here]].


<!--T:53-->
List of created templates:
List of created templates:


<!--T:54-->
[[:Category:Templates|Category:Templates]]
[[:Category:Templates|Category:Templates]]


== Translation ==
== Translation == <!--T:55-->
To translate a page, the page needs a <nowiki>{{LangNavBox}}</nowiki> at the top of the page. Then you can click on the link language you want to create. You translate the page by having two browser windows open comparing them side by side or any other method you can think of.
 
=== Title === <!--T:56-->


=== Title ===
<!--T:57-->
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.
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.


=== Linking ===
=== Linking === <!--T:58-->
When the page you link to exists in your page, you should reference it like this: <nowiki>[[English title/language-code|Translated title]]</nowiki>. For example: <nowiki>[[Jump/de|Sprung]]</nowiki> as a link to the jump article in German, with the translated string "Sprung" visible to the user. This allows the LangNavBox to always show all links to translated pages.


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.
<!--T:59-->
You can achieve the same in the visual editor, by first linking the translated page: e.g. by typing <code><nowiki>[[</nowiki></code> to open the linking page. Enter <code>Jump/de</code> (replacing <code>de</code> with the target language code) to link to the correct page and then modify the display text to the translated version.
</translate>