Contributing: Difference between revisions
Created page with "Category:Guides" |
Created the getting involved/contributing page. |
||
| Line 1: | Line 1: | ||
[[Category:Guides]] | [[Category:Guides]] | ||
The '''DayZUnderground Wiki''' documents notable characters, groups, locations, and events from the server's history. Its articles are created and maintained by community contributors. Prior editing experience or extensive knowledge of MediaWiki is not required. | |||
This page provides a practical introduction to creating and editing DUG Wiki articles. Standards for article structure and tone are covered within the [[Contribution Guidelines]]. | |||
== Video guide == | |||
A video version of this guide is also available for contributors who prefer a visual demonstration. It covers wiki navigation, basic MediaWiki formatting, image uploads, page creation, categories, and the preview process. | |||
[https://youtu.be/IGwoJ64nGEE DUG Wiki Quickstart Guide] | |||
== Ways to contribute == | |||
Contributors may assist by: | |||
* Creating pages for notable characters, groups, factions, locations, or events. | |||
* Expanding incomplete articles with relevant history and context. | |||
* Correcting inaccurate information, spelling, grammar, formatting, or broken links. | |||
* Providing relevant images and identifying the people, places, or events shown. | |||
* Organizing notes, stories, and timelines into usable drafts. | |||
== Preparing an article == | |||
When writing about another person's character or group, consult the people involved when possible. They may be able to provide timelines, screenshots, written accounts, or corrections. Compare the available information before drafting, particularly when participants disagree about an event. If an event involves multiple groups or characters, contact each involved party. | |||
For longer articles, drafting in a shared document may simplify collaboration. Article templates are included in the Contribution Guidelines, while additional resources and a MediaWiki formatting cheat sheet are available through the DUG Wiki Discord. | |||
== Creating and editing pages == | |||
To edit an existing article, select '''Edit source'''. This opens the page's source text and MediaWiki markup. | |||
To create an article, search for the intended title and confirm that the subject does not already have a page under another name. If the title does not exist, the wiki will provide an option to create it. Selecting a link also opens the creation form for the linked page if no page already exists. Confirm the title's spelling and capitalization before proceeding. | |||
== Basic MediaWiki formatting == | |||
Most DUG Wiki articles use a limited set of MediaWiki formatting tools. | |||
=== Section headings === | |||
Equal signs create headings. Additional equal signs create lower heading levels. | |||
<pre> | |||
== Major section == | |||
=== Subsection === | |||
==== Smaller subsection ==== | |||
</pre> | |||
Use a consistent hierarchy. Most articles require major sections and no more than one or two levels of subsections. Within the table of contents, major headings will be listed as whole numbers, whereas subheadings follow decimals (For example, 7. Notable Relationships, 7.1 CharacterName, 7.2 CharacterName2). | |||
=== Bold and italic text === | |||
Straight apostrophes are used to stylize text. Three on each side create bold text, while two on each side create italicized text. | |||
<pre> | |||
'''Bold text''' | |||
''Italic text'' | |||
</pre> | |||
Curved or “smart” apostrophes copied from some word processors or keyboards may not function as markup and should be replaced with straight apostrophes. Feel free to copy and paste apostrophes from other pages within the wiki for easy access. | |||
=== Hyperlinks === | |||
Double square brackets create links to other pages within the DUG Wiki. | |||
<pre> | |||
[[Page name]] | |||
[[Page name|text shown to the reader]] | |||
</pre> | |||
Use hyperlinks to connect related characters, groups, locations, and events. A link is allowed to be created before its destination page exists, as this creates a natural branching point for more pages for editors to start working on. | |||
=== Paragraphs and lists === | |||
Leave a completely blank line between paragraphs. A single line break within Mediawiki markdown may not create a visible paragraph break on the published page. | |||
An asterisk creates a bulleted list, while a hashtag sign creates a numbered list. | |||
<pre> | |||
* First bullet | |||
* Second bullet | |||
# First step | |||
# Second step | |||
</pre> | |||
== Uploading and displaying images == | |||
Images are uploaded separately from articles. Select '''Upload file''' underneath the Tools header from the wiki sidebar (located on the left of any page) and choose the image to upload. | |||
=== File names === | |||
Image names should begin with the article title and end with a sequential number, regardless of file type or extension. For a page titled “John DUG,” the files would be named: | |||
<pre> | |||
JohnDUG1.webp | |||
JohnDUG2.png | |||
JohnDUG3.jpeg | |||
</pre> | |||
The extension must match the uploaded file type, such as <code>.png</code>, <code>.jpg</code>, or <code>.webp</code>. Image markup should reproduce the uploaded file name, extension, and capitalization exactly. Though this is not required, a brief upload summary identifying the image and its relevance to the article is useful for other editors within the team. | |||
=== Image markup === | |||
Images are displayed with a file block: | |||
<pre> | |||
[[File:JohnDUG1.webp|300px|thumb|right|Image of John DUG.]] | |||
</pre> | |||
The file name identifies the upload, <code>300px</code> sets its displayed width, <code>thumb</code> applies the standard thumbnail frame, and <code>right</code> determines its position. The final field is the caption. Images may also be positioned with <code>left</code> or <code>center</code>. | |||
Image size and placement should be adjusted with the '''Show preview''' option, located underneath the MediaWiki markdown box when creating pages. Captions should identify the image's relevant people, location, or event. | |||
== Categories == | |||
Every article should be assigned to the category matching its subject. Categories allow pages to appear in the wiki's navigation lists, rather than requiring a manual search. | |||
<pre> | |||
[[Category:Notable Characters]] | |||
</pre> | |||
Follow the spelling and capitalization used by existing category pages. The editor-based process is explained under [[Contribution Guidelines#Categorising New Pages|Categorising New Pages]] in the Contribution Guidelines. | |||
== Previewing and publishing == | |||
Use the '''Show preview''' option before saving any changes to a page. Confirm that: | |||
* Headings follow the intended hierarchy. | |||
* Paragraphs and lists display correctly. | |||
* Images load and include appropriate captions. | |||
* Any formatting features and infoboxes display correctly. | |||
* The article uses the correct category. | |||
Review names, chronology, file names, and factual claims before publication. On subsequent edits, it is advised to provide an edit summary that briefly identifies the work completed, such as “Created initial character page,” “Added history and images,” or “Corrected links and formatting.” Questions about article organization or MediaWiki markup may be directed to contributors in the DUG Wiki Discord. | |||
Latest revision as of 03:44, 23 August 2026
The DayZUnderground Wiki documents notable characters, groups, locations, and events from the server's history. Its articles are created and maintained by community contributors. Prior editing experience or extensive knowledge of MediaWiki is not required.
This page provides a practical introduction to creating and editing DUG Wiki articles. Standards for article structure and tone are covered within the Contribution Guidelines.
Video guide
A video version of this guide is also available for contributors who prefer a visual demonstration. It covers wiki navigation, basic MediaWiki formatting, image uploads, page creation, categories, and the preview process.
Ways to contribute
Contributors may assist by:
- Creating pages for notable characters, groups, factions, locations, or events.
- Expanding incomplete articles with relevant history and context.
- Correcting inaccurate information, spelling, grammar, formatting, or broken links.
- Providing relevant images and identifying the people, places, or events shown.
- Organizing notes, stories, and timelines into usable drafts.
Preparing an article
When writing about another person's character or group, consult the people involved when possible. They may be able to provide timelines, screenshots, written accounts, or corrections. Compare the available information before drafting, particularly when participants disagree about an event. If an event involves multiple groups or characters, contact each involved party.
For longer articles, drafting in a shared document may simplify collaboration. Article templates are included in the Contribution Guidelines, while additional resources and a MediaWiki formatting cheat sheet are available through the DUG Wiki Discord.
Creating and editing pages
To edit an existing article, select Edit source. This opens the page's source text and MediaWiki markup.
To create an article, search for the intended title and confirm that the subject does not already have a page under another name. If the title does not exist, the wiki will provide an option to create it. Selecting a link also opens the creation form for the linked page if no page already exists. Confirm the title's spelling and capitalization before proceeding.
Basic MediaWiki formatting
Most DUG Wiki articles use a limited set of MediaWiki formatting tools.
Section headings
Equal signs create headings. Additional equal signs create lower heading levels.
== Major section == === Subsection === ==== Smaller subsection ====
Use a consistent hierarchy. Most articles require major sections and no more than one or two levels of subsections. Within the table of contents, major headings will be listed as whole numbers, whereas subheadings follow decimals (For example, 7. Notable Relationships, 7.1 CharacterName, 7.2 CharacterName2).
Bold and italic text
Straight apostrophes are used to stylize text. Three on each side create bold text, while two on each side create italicized text.
'''Bold text''' ''Italic text''
Curved or “smart” apostrophes copied from some word processors or keyboards may not function as markup and should be replaced with straight apostrophes. Feel free to copy and paste apostrophes from other pages within the wiki for easy access.
Hyperlinks
Double square brackets create links to other pages within the DUG Wiki.
[[Page name]] [[Page name|text shown to the reader]]
Use hyperlinks to connect related characters, groups, locations, and events. A link is allowed to be created before its destination page exists, as this creates a natural branching point for more pages for editors to start working on.
Paragraphs and lists
Leave a completely blank line between paragraphs. A single line break within Mediawiki markdown may not create a visible paragraph break on the published page.
An asterisk creates a bulleted list, while a hashtag sign creates a numbered list.
* First bullet * Second bullet # First step # Second step
Uploading and displaying images
Images are uploaded separately from articles. Select Upload file underneath the Tools header from the wiki sidebar (located on the left of any page) and choose the image to upload.
File names
Image names should begin with the article title and end with a sequential number, regardless of file type or extension. For a page titled “John DUG,” the files would be named:
JohnDUG1.webp JohnDUG2.png JohnDUG3.jpeg
The extension must match the uploaded file type, such as .png, .jpg, or .webp. Image markup should reproduce the uploaded file name, extension, and capitalization exactly. Though this is not required, a brief upload summary identifying the image and its relevance to the article is useful for other editors within the team.
Image markup
Images are displayed with a file block:
[[File:JohnDUG1.webp|300px|thumb|right|Image of John DUG.]]
The file name identifies the upload, 300px sets its displayed width, thumb applies the standard thumbnail frame, and right determines its position. The final field is the caption. Images may also be positioned with left or center.
Image size and placement should be adjusted with the Show preview option, located underneath the MediaWiki markdown box when creating pages. Captions should identify the image's relevant people, location, or event.
Categories
Every article should be assigned to the category matching its subject. Categories allow pages to appear in the wiki's navigation lists, rather than requiring a manual search.
[[Category:Notable Characters]]
Follow the spelling and capitalization used by existing category pages. The editor-based process is explained under Categorising New Pages in the Contribution Guidelines.
Previewing and publishing
Use the Show preview option before saving any changes to a page. Confirm that:
- Headings follow the intended hierarchy.
- Paragraphs and lists display correctly.
- Images load and include appropriate captions.
- Any formatting features and infoboxes display correctly.
- The article uses the correct category.
Review names, chronology, file names, and factual claims before publication. On subsequent edits, it is advised to provide an edit summary that briefly identifies the work completed, such as “Created initial character page,” “Added history and images,” or “Corrected links and formatting.” Questions about article organization or MediaWiki markup may be directed to contributors in the DUG Wiki Discord.