Difference between revisions of "Help:Get Started"
From Roll20 Wiki
Andreas J. (Talk | contribs) m (→Upload Image) |
Andreas J. (Talk | contribs) m (→Create New Page) |
||
| (5 intermediate revisions by one user not shown) | |||
| Line 5: | Line 5: | ||
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 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 MediaWiki, so some newer features used on other wikis aren't available. | + | 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 | * [[wikipedia:Help:Cheatsheet|Wikitext Cheatsheet]] - short guide to main features | ||
| − | + | <noinclude>__TOC__</noinclude> | |
| − | '''Wiki Purpose & Suggestions on what to add''' | + | <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: | Some ideas on what is a good fit for the Roll20 Community Wiki: | ||
| Line 15: | Line 15: | ||
# '''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. | # '''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. | # '''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 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:// | + | # '''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. | # '''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. | # '''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=== | ===Create New Page=== | ||
| − | {{notebox|Please add the {{tlx|revdate}}-template to the start of newly created pages. ''It will show when page was last edited.''}} | + | {{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: | To create a new page, you can either: | ||
| Line 48: | Line 47: | ||
Few thing to consider: | Few thing to consider: | ||
| − | # '''Add images if possible.''' By default, 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. | + | # '''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. | # 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 pages where it's relevant. If there are no links or mentions of a new page, it's less likely to be found. | + | # 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 | + | # '''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. | + | # 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. | # 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=== | ===Upload Image=== | ||
| − | '''By default, users can't upload images to the wiki.''' If 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. | + | '''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 /> | <br /> | ||
| Line 68: | Line 67: | ||
# Don't use the wiki for saving info on your specific campaigns. | # 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 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''' | + | # '''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> | <noinclude> | ||
[[Category:Wiki Editing]] | [[Category:Wiki Editing]] | ||
</noinclude> | </noinclude> | ||
Latest revision as of 04:30, 10 August 2023
 |
Page Updated: 2023-08-10 |
Main Page: Help:Contents
Roll20 Community Wiki
The Roll20 Wiki is written using the Wikitext markup language, the same one used on Wikipedia and Fandom Wikis, but you can also use HTML & CSS.
The Roll20 Wiki runs on a somewhat older version of MediaWiki, so some newer features used on other wikis aren't available here.
- Wikitext Cheatsheet - short guide to main features
Contents |
Wiki Purpose & Suggestions on what to add
Some ideas on what is a good fit for the Roll20 Community Wiki:
- Content that the entire community will find useful. Guides, 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 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 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. 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 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.
[edit] Create New Page
 | Please add the {{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 https://wiki.roll20.net/Creating_Random_New_Page 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 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.
[edit] 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(
https://wiki.roll20.net/5E) 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(
https://wiki.roll20.net/Complete%20Guide%20to%20Macros%20%26%20Rolls) 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
[edit] Redirect
About: 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 #REDIRECT [[name of the page it should link to]], then save it. Now the new page redirect to the page you wanted.
Example:
A wiki page with only#REDIRECT [[Help:Contents]] would redirect to this page you're reading.
[edit] 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 Contact Roll20, 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 to hide a larger chunk by default. In some cases, 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.
[edit] Upload Image
By default, users can't upload images to the wiki. If cant access the Upload file-page(found in the sidebar) and you want to be able to upload images, either message Andreas J., or Contact Roll20 and ask for them to upgraded you Roll20 account's wiki permissions so you can upload images.
When your wiki account have been promoted to Contributor, see the Images-section for how to use and upload images & gifs on the Community Wiki.
| 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. |
[edit] 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 Suggestions Forum(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 Forums(Forum) 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.
