Roll20 Wiki

<noinclude>{{revdate}}
{{main|Help:Contents}}

=Roll20 Community Wiki=</noinclude>
The Roll20 Wiki is written using the [[wikipedia:Help:Wikitext|Wikitext]] markup language, the same one used on Wikipedia and [[wikipedia:Fandom_(website)|Fandom Wikis]], but you can also use [[HTML]] & CSS.

The Roll20 Wiki runs on a somewhat older version of [https://www.mediawiki.org/wiki/MediaWiki MediaWiki], so some newer features used on other wikis aren't available here. 

* [[wikipedia:Help:Cheatsheet|Wikitext Cheatsheet]] - short guide to main features
<noinclude>__TOC__</noinclude>
<noinclude>===</noinclude><includeonly>'''</includeonly>Wiki Purpose & Suggestions on what to add<includeonly>'''</includeonly><noinclude>===</noinclude>

Some ideas on what is a good fit for the Roll20 Community Wiki:

# '''Content that the entire community will find useful.''' [[:Category:Guides|Guides]], [[:Category:Tips|Tips]] & tricks for variety of Roll20-related features, suggestions on how to implement certain elements in a game, pages with resources and links to relevant forum posts, pages on other sites, or video tutorials.
# '''Guides & tips on playing [[:Category:Games|specific games/rule systems]] on Roll20.''' Pages like [[Star Wars D6]], [[World of Darkness]] & [[Pathfinder]] contains various tips on how to play the games, and can serve as a hub for related pages. 
# '''Info & tips on how to use a [[:Category:Character Sheet Documentation|specific character sheet]].''' Roll20 have hundreds of community-contributed sheets & a handful of official sheets, of which only few have any extra info on how to use them, and all works slightly differently. [https://help.roll20.net/hc/en-us/categories/360003712814-Roll20-Character-Sheets All Official Character Sheets don't have documentation pages on the Help Center], and even when they do, the page might lack some info, so creating/updating the [[:Category:Official_Sheet|Community Wiki's version of the page]] could be a good idea. Sometimes even creating a short wiki page addressing a common issue with a sheet will make it easier for other to figure it out.
# '''If the Official [[Help Center]] is lacking Documentation for some feature, is confusing or too short, have errors, it can be a good idea to update the Community Wiki's page for the same topic.''' If a page for it doesn't exist, one can be created, and featuring the clarification to the feature, along with a link to the Help Center article. You could also copy the full article to the wiki, and then expand/edit it to your liking.
# '''Linking great forum posts on pages related to a topic/feature.''' If good advice on a topic exist on a number of forum threads, it can be enough to just create a new wiki page for the topic and give a list of links to the threads, instead of writing a full-blown article on it. Having a wiki page for a topic makes the info more accessible/findable, even if it just links to a couple of forum posts. [[Invisible Tokens]] started that way.

===Create New Page===
{{notebox|Please add the {{tlx|revdate}}-template to the start of newly created pages. ''It will automatically show when page was last edited in the top-right corner.''}}

To create a new page, you can either:
1. go directly to the url for the page you want to create, and you'll be shown a "this page doesn't exist" message. In the the top menu there is a "create" option, which you select. (e.g. go to <code><nowiki>https://wiki.roll20.net/Creating_Random_New_Page</nowiki></code> and you can create it.
2. use the '''Search''' option and search for the exact name of the page you want to create, and press {{button|Enter}}. It now show you a search result of the term, and says '''Create the page "name-of-your-search" on this wiki!''' with a red link if there is no existing page with that name, which will lead you to create that page, as it doesn't exist yet.

Check [[:Category:Page Templates]] for some examples so you don't have to start from scratch when making a new page.

====Name====
Try give pages a descriptive,, so the page is more likely to be found on a wiki search. Afterwards, you can create redirects to the page 

* Example: [[5E]](<code><nowiki>https://wiki.roll20.net/5E</nowiki></code>) is the page displaying info related to D&D 5E, the most popular game on the platform, so makes sense to have a short and simple url.
* Example 2: [[Complete Guide to Macros & Rolls]](<code><nowiki>https://wiki.roll20.net/Complete%20Guide%20to%20Macros%20%26%20Rolls</nowiki></code>) Is a accurate and descriptive title for a guide. The page have a couple redirects, like [[Macro Guide]], which make finding it easier even with alternative spellings, without confusing it with the [[Macros]] or [[How to Roll Dice]]-pages

====Redirect====
About: [https://en.wikipedia.org/wiki/Wikipedia:Redirect redirect] pages

Example: [[5ESheet]] redirects to [[D&D 5E by Roll20]], [[Link Token]] redirects to [[Linking Tokens to Journals]]

Create the new page, and add <code><nowiki>#REDIRECT [[name of the page it should link to]]</nowiki></code>, then save it. Now the new page redirect to the page you wanted.

{{ex}}
A wiki page with only<code><nowiki>#REDIRECT [[Help:Contents]]</nowiki></code> would redirect to this page you're reading.

===Updating/Expanding the Wiki===
Few thing to consider:

# '''Add images/gifs if possible.''' By default, wiki users don't have image upload access, but you can {{bug}}, say you want to be mentioning your user ID, and why you want image upload access. More details: [[Help:Contents#Upload_Image]]
# If you are aware of an undocumented feature/quirk of Roll20, it's smart to mention it on the relevant page.
# After creating a new page, it's a good idea to add links to it on existing wiki pages where it's relevant. If there are no links or mentions of a new page, it's less likely to be found.
# '''Link to external resources.''' If there exists a great forum post, blog, or other site with relevant info, it's best to provide link to the original source, if you copy the content to the wiki.
# If a page starts to become very large, it might be a smart to split self-contained sections into their own pages. Then link to the new page on the original section & reduce the text to a summary of what the new page contains. Alternatively, you could use a [[#Collapsible Section|Collapsible Section]] to hide a larger chunk by default. In some cases, [[Help:Contents#Transclusion|transclusion]] could be a good idea
# The '''[[:Category:Roll20]]'''-category is mean for core Roll20 aspects or features, and new pages should likely be categorized by some of it's sub-categories. [[:Category:Guides]], [[:Category:Games]] and [[:Category:Tips]] categories are great categories for most new pages. See  [[Help:Contents#Categories]] for more info on existing categories.

===Upload Image===
'''By default, users can't upload images to the wiki.''' If cant access the [[Special:Upload|Upload file]]-page(found in the sidebar) and you want to be able to upload images, either message {{user profile|1223200|Andreas J.}}, or {{bug}} and ask for them to upgraded you Roll20 account's wiki permissions so you can upload images. 
<br />

When your wiki account have been promoted to [[Roll20:Contributors|Contributor]], see the '''[[#Images|Images]]'''-section for how to use and upload images & gifs on the Community Wiki.


{{notebox| '''Possible Bug:''' It seems '''trying to upload an updated version on a image doesn't work''', so one needs to upload the image with a new name, and delete the old image if it i serves no purpose. Please only delete images you uploaded yourself. }}

===Please don't===

# Don't use the wiki for saving info on your specific campaigns.
# Don't use the wiki pages to lobby for changes to Roll20(doesn't have much reach anyway). Instead post to the Official {{forum|category/385189 Suggestions Forum}} or vote/comment on existing suggestions. Wiki Talk pages are intended for discussion wiki changes.
# '''Don't use the wiki to ask questions about how Roll20 works'''. The {{forum| Forums}} are the right place for that. Basically nobody notices random new wiki pages, nor if there are any talk pages, so it's pointless anyway.

<noinclude>
[[Category:Wiki Editing]]
</noinclude>