VNDev Wiki:Getting Started: Difference between revisions
Trying to make an accessible starting point |
Ok! I think that's done for now, unless I/we realize something should be tweaked or tidied. |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
== What can/should I edit? == | |||
The VNDev Wiki is currently getting its feet on the ground! That means there are many unwritten articles, and many articles that need some serious expansion. Our [[VNDev_Wiki:Article Wishlist|Article Wishlist]] is a great place to start! You can also visit the [[:Category:Article_maintenance|Article Maintenance category]] to find articles that have been flagged as needing some help. | |||
[[ | |||
[[ | Before you edit, make sure you're familiar with the [[VNDev_Wiki:Manual of Style|Manual of Style]]. Users who fail to follow the [[VNDev_Wiki:Contribution Policy|Contribution Policy]] may have their accounts removed. | ||
== Basics for Programmers == | |||
[[mw: | The VNDev Wiki runs off of [[mw:MediaWiki|MediaWiki]], which in turn uses a combination of Markdown, HTML, and CSS as its basis. All default MediaWiki formatting techniques apply. However, please be aware that many implementations of MediaWiki utilize [[mw:Manual:Extensions|extensions]]. While wiki admins will consider adding extensions, we want to keep them to a minimum to ensure compatibility, ease of use, etc. Feel free to stop by the #vndev-wiki channel in the [https://discord.gg/devtalk DevTalk Discord] to discuss your ideas and use cases. | ||
[[ | == Articles vs Guides == | ||
There are two main types of pages on the wiki: Articles and Guides. Articles are encyclopedic in nature, while Guides are formatted like tutorials and explicitly teach the reader how to do something specific. See the [[VNDev_Wiki:Manual_of_Style#Articles vs Guides|Manual of Style]] for more. | |||
== Editing Basics == | |||
To edit a page, log in, then click "Edit" in the top right. You can then enter text normally, with no special formatting required. | |||
=== Headers === | |||
Headers are set up with equals signs on either side. The more equals signs, the smaller the header. | |||
<pre style="background:#f2f2f2; width:fit-content"><nowiki>== This is a top level header == | |||
=== One level smaller === | |||
==== Even smaller ==== | |||
===== And so on =====</nowiki></pre> | |||
=== Links === | |||
{{main|mw:Help:Links}} | |||
To link to another page on the Wiki, put the name of the page in square brackets: | |||
<pre style="background:#f2f2f2; width:fit-content"><nowiki>[[Editing]]</nowiki></pre> | |||
[[ | You can also choose the display text for the link. For example, if you want to have the words "beep boop" that link to the Programming page, you can do: | ||
<pre style="background:#f2f2f2; width:fit-content"><nowiki>[[Programming | beep boop]]</nowiki></pre> | |||
For links external to the Wiki (such as Wikipedia, Itch, VNDB, etc.), use a single set of brackets, and no vertical line divider. | |||
<pre style="background:#f2f2f2; width:fit-content"><nowiki>[https://google.com Visit Google]</nowiki></pre> | |||
=== Formatting === | |||
{{main|mw:Help:Formatting}} | |||
====Italics==== | |||
''Put two apostrophes on each side.'' | |||
<pre style="background:#f2f2f2; width:fit-content"><nowiki>'' Put two apostrophes on each side. ''</nowiki></pre> | |||
====Bold==== | |||
'''Put three apostrophes on each side.''' | |||
<pre style="background:#f2f2f2; width:fit-content"><nowiki>''' Put three apostrophes on each side. '''</nowiki></pre> | |||
====Lists==== | |||
{{main|mw:Help:Lists}} | |||
*For a bulleted list, place an asterisk at the start of each new bullet. | |||
</ | **More asterisks give deeper levels. | ||
<pre style="background:#f2f2f2; width:fit-content"><nowiki>* Top level | |||
** This is a sub-bullet | |||
** This is a sub-bullet | |||
*** Another level deep | |||
* Another top level</nowiki></pre> | |||
== Resources == | <ol style="margin-left: 1.5em"><li>Numbered lists are mostly the same as above.</li> | ||
<li>#Use # instead of *.</li></ol> | |||
<pre style="background:#f2f2f2; width:fit-content"><nowiki># Top level | |||
## This is a sub-bullet | |||
## This is a sub-bullet | |||
### Another level deep | |||
# Another top level</nowiki></pre> | |||
===Helpful links=== | |||
[[mw:Cheatsheet|{{clickable button|Cheatsheet|color=blue|width=200px}}]] [[mw:Help:Formatting|{{clickable button|More formatting tips|color=blue|width=200px}}]] <br /><br /> | |||
[[mw:Help:Tables|{{clickable button|Tables|width=200px}}]] [[mw:Help:Managing files|{{clickable button|Uploading Files|width=200px}}]] [[mw:Help:Images|{{clickable button|Images|width=200px}}]] [[mw:Help:Templates|{{clickable button|Templates|width=200px}}]] | |||
== Editing Resources == | |||
=== Article Management === | === Article Management === | ||
* [[mw:Help:Moving a page|Moving a page]] | * [[mw:Help:Moving a page|Moving a page]] | ||
Latest revision as of 17:35, 25 November 2024
What can/should I edit?
The VNDev Wiki is currently getting its feet on the ground! That means there are many unwritten articles, and many articles that need some serious expansion. Our Article Wishlist is a great place to start! You can also visit the Article Maintenance category to find articles that have been flagged as needing some help.
Before you edit, make sure you're familiar with the Manual of Style. Users who fail to follow the Contribution Policy may have their accounts removed.
Basics for Programmers
The VNDev Wiki runs off of MediaWiki, which in turn uses a combination of Markdown, HTML, and CSS as its basis. All default MediaWiki formatting techniques apply. However, please be aware that many implementations of MediaWiki utilize extensions. While wiki admins will consider adding extensions, we want to keep them to a minimum to ensure compatibility, ease of use, etc. Feel free to stop by the #vndev-wiki channel in the DevTalk Discord to discuss your ideas and use cases.
Articles vs Guides
There are two main types of pages on the wiki: Articles and Guides. Articles are encyclopedic in nature, while Guides are formatted like tutorials and explicitly teach the reader how to do something specific. See the Manual of Style for more.
Editing Basics
To edit a page, log in, then click "Edit" in the top right. You can then enter text normally, with no special formatting required.
Headers
Headers are set up with equals signs on either side. The more equals signs, the smaller the header.
== This is a top level header == === One level smaller === ==== Even smaller ==== ===== And so on =====
Links
- Main article: mw:Help:Links
To link to another page on the Wiki, put the name of the page in square brackets:
[[Editing]]
You can also choose the display text for the link. For example, if you want to have the words "beep boop" that link to the Programming page, you can do:
[[Programming | beep boop]]
For links external to the Wiki (such as Wikipedia, Itch, VNDB, etc.), use a single set of brackets, and no vertical line divider.
[https://google.com Visit Google]
Formatting
- Main article: mw:Help:Formatting
Italics
Put two apostrophes on each side.
'' Put two apostrophes on each side. ''
Bold
Put three apostrophes on each side.
''' Put three apostrophes on each side. '''
Lists
- Main article: mw:Help:Lists
- For a bulleted list, place an asterisk at the start of each new bullet.
- More asterisks give deeper levels.
* Top level ** This is a sub-bullet ** This is a sub-bullet *** Another level deep * Another top level
- Numbered lists are mostly the same as above.
- #Use # instead of *.
# Top level ## This is a sub-bullet ## This is a sub-bullet ### Another level deep # Another top level
