Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Difference between revisions of "Help:Contents"

From Roll20 Wiki

Jump to: navigation, search
m (Categories: mentioned few more common categories, and linked to each)
m (Roll20 UI Icons)
(6 intermediate revisions by one user not shown)
Line 1: Line 1:
 
The Roll20 Wiki is intended to serve as a community resource for help and documentation as well as tips and tricks for best using Roll20 with your tabletop games. We welcome community contributions and would love for you to help us create the best resource we can for your fellow Roll20 users!
 
The Roll20 Wiki is intended to serve as a community resource for help and documentation as well as tips and tricks for best using Roll20 with your tabletop games. We welcome community contributions and would love for you to help us create the best resource we can for your fellow Roll20 users!
 +
 +
Check '''[[:Category:Stubs]]''' and '''[[:Category:NeedsUpdates]]''' for existing pages that need help
  
 
That said, there are a few things we actively discourage at this time:
 
That said, there are a few things we actively discourage at this time:
Line 5: Line 7:
 
* The wiki is for content that the entire community will find useful. Please don't use it to post information relevant to a specific game/Campaign that you are running.
 
* The wiki is for content that the entire community will find useful. Please don't use it to post information relevant to a specific game/Campaign that you are running.
 
* The pages in the '''Docs''' Category are only to contain factual information on official Roll20 functionality. These pages are created and maintained only by the Roll20 Staff. Feel free to create additional pages outside that category for workarounds and other non-official tips.
 
* The pages in the '''Docs''' Category are only to contain factual information on official Roll20 functionality. These pages are created and maintained only by the Roll20 Staff. Feel free to create additional pages outside that category for workarounds and other non-official tips.
* Please do not use wiki pages to lobby for changes to Roll20 features. That's what the Suggestions forum is for. Talk pages should only be used to discuss changes that need to be made to the wiki page itself or to clarify existing functionality.
+
* Please do not use wiki pages to lobby for changes to Roll20 features. Instead use the [https://app.roll20.net/forum/category/385189 Suggestions forum]. Talk pages should only be used to discuss changes that need to be made to the wiki page itself or to clarify existing functionality.
 +
* '''Don't use the wiki to ask questions''', the [https://app.roll20.net/forum/ Forums] are better used for this.
  
  
Line 12: Line 15:
 
If you're new to the MediaWiki software that we're utilizing (the same used to power Wikipedia), you can view a lot of helpful information on it [https://meta.wikimedia.org/wiki/Help:Contents here].
 
If you're new to the MediaWiki software that we're utilizing (the same used to power Wikipedia), you can view a lot of helpful information on it [https://meta.wikimedia.org/wiki/Help:Contents here].
  
===Categories===
+
==Page formatting ==
There are a series of wiki categories to keep pages organized. The larges ones are:
+
The exists a few tips and tricks how to make pages look better and more readable, here are few main pointers.
* '''[[Category:Games|Games]]''': For thorough run-through of how to play a particular tRPG system in Roll20
+
* '''[[Category:Guides|Guides]]''': Many pages under the Games category fall in here too; anything extensively explained should use this category
+
* '''[[Category:Tips|Tips]]''': For smaller pages that cover a portion of the Roll20 platform (I.e. tips and tricks)
+
* '''Marketplace''': This Category are for creators regarding their content placed on the Roll20 Marketplace<br />
+
* '''[[Category:Character Sheet Documentation|Character Sheet Documentation]]''' For guides dedicated to specific character sheets
+
* '''[[Category:Macros|Macros]]''' For pages largely dedicated to Roll20 macros
+
  
To add a category to a page, simply add this line of text at the very bottom:
+
===Headings===
<pre>[[Category:Category Name]]</pre>
+
Use headings to structure a page if it contains multiple sections. If a page have enough sections, it will automatically generate a Table of Content. [[Style_Guide_Update|Heading Showcase]]  
If the page falls under multiple categories, add another category tag underneath first and so forth (don't combine them in one tag).<br />
+
  
 
===Uploading Images===
 
===Uploading Images===
If you are a new user adding content to the wiki, the option to upload images is disabled by default. If you need to include screenshots or diagrams, contact a Roll20 Developer to enable upload privileges.<br />
+
If you are a new user adding content to the wiki, the option to upload images is disabled by default. If you need to include screenshots or diagrams, contact a Roll20 Developer to enable upload privileges.
 +
<br />
 +
 
 
===Message Boxes===
 
===Message Boxes===
 
<br />
 
<br />
Line 45: Line 43:
 
* <span style="font-family:Pictos Custom;">u</span> <code><nowiki><span style="font-family:Pictos Custom;">u</span></nowiki></code> Jukebox tab
 
* <span style="font-family:Pictos Custom;">u</span> <code><nowiki><span style="font-family:Pictos Custom;">u</span></nowiki></code> Jukebox tab
 
* <span style="font-family:Pictos;">l</span> <code><nowiki><span style="font-family:Pictos;">l</span></nowiki></code> Collection tab
 
* <span style="font-family:Pictos;">l</span> <code><nowiki><span style="font-family:Pictos;">l</span></nowiki></code> Collection tab
* <span style="font-family:Pictos;">y</span> <code><nowiki><span style="font-family:Pictos;">y</span></nowiki></code> My settings tab
+
* <span style="font-family:Pictos;">y</span> <code><nowiki><span style="font-family:Pictos;">y</span></nowiki></code> My Settings tab
 
* <span style="font-family:dicefontd20;">t</span> <code><nowiki><span style="font-family:dicefontd20;">t</span></nowiki></code> d20
 
* <span style="font-family:dicefontd20;">t</span> <code><nowiki><span style="font-family:dicefontd20;">t</span></nowiki></code> d20
 
* <span style="font-family:dicefontd4;">d</span> <code><nowiki><span style="font-family:dicefontd4;">d</span></nowiki></code> d4
 
* <span style="font-family:dicefontd4;">d</span> <code><nowiki><span style="font-family:dicefontd4;">d</span></nowiki></code> d4
Line 53: Line 51:
 
* <span style="font-family:dicefontd12;">l</span> <code><nowiki><span style="font-family:dicefontd12;">l</span></nowiki></code> d12
 
* <span style="font-family:dicefontd12;">l</span> <code><nowiki><span style="font-family:dicefontd12;">l</span></nowiki></code> d12
  
===Macros and other Code Snippets===
+
=== Displaying Macros and other Code Snippets===
  
 
If you want to share Macros, complicated dice rolls, or CSS and HTML code, it might be a good idea to put your examples inside <code>&#60;pre&#62;</code> tags.
 
If you want to share Macros, complicated dice rolls, or CSS and HTML code, it might be a good idea to put your examples inside <code>&#60;pre&#62;</code> tags.
Line 69: Line 67:
 
<nowiki> <nowiki> tag ignores all wiki formatting/templates/linkcreation as can at time be needed together with <code> tag to show some code without problem.</nowiki> <br />'''Click "Edit" for this page to see how the above examples work.'''
 
<nowiki> <nowiki> tag ignores all wiki formatting/templates/linkcreation as can at time be needed together with <code> tag to show some code without problem.</nowiki> <br />'''Click "Edit" for this page to see how the above examples work.'''
  
See also [https://meta.wikimedia.org/wiki/Help:HTML_in_wikitext#Tags_with_special_effect WikiMedia's documentation on formatting tags].
+
==Structure==
 +
A few things makes the wiki easier to use and easier to find related pages.
 +
 
 +
===Categories===
 +
A categorized page is easier to find, so please add at least one relevant category to any new page you create. There are few of the main wiki categories:
 +
 
 +
====Content====
 +
* '''[[:Category:Games]]''': For thorough run-through of how to play a particular tRPG system in Roll20
 +
** '''[[:Category:Character Sheet Documentation]]''' For guides dedicated to specific character sheets
 +
* '''[[:Category:Guides]]''': Many pages under the Games category fall in here too; anything extensively explained should use this category
 +
* '''[[:Category:Tips]]''': For smaller pages that cover a portion of the Roll20 platform (I.e. tips and tricks)
 +
* '''[[:Category:Macros]]''' For pages largely dedicated to Roll20 macros
 +
* '''[[:Category:Marketplace]]''': This Category are for creators regarding their content placed on the Roll20 Marketplace
 +
* [[Special:Categories|Full list of existing categories]]
 +
 
 +
====Wiki Administration====
 +
* '''[[:Category:NeedsUpdates]]''' for outdated or half-done pages
 +
* '''[[:Category:Stubs]]''' for short articles that could use more content
 +
* '''[[:Category:Articles for deletion]]''' page that is clearly
 +
 
 +
To add a category to a page, simply add this line of text at the very bottom:
 +
<pre>[[Category:Category Name]]</pre>
 +
If the page falls under multiple categories, add another category tag underneath first and so forth (don't combine them in one tag).
 +
<br />
 +
 
 +
===Linking to other pages===
 +
If an article mentions things that have a wiki page, it's useful to link to that relevant page the first time it's mentioned. For example, there exists several [[Star Wars RPG|Star Wars RPGs]] and some of them have guides on the wiki. Sometime it's useful to link a subsection of an article, like when mentioning there are [[Compendium_Sharing#What_are_the_Limitations_of_Compendium_Sharing.3F|limits to compendium sharing]].
 +
If you want to link to a Category of pages you need to place a ':' in front of the page name, like:
 +
<pre>[[:Category:Tips]]</pre>
 +
 
 +
==='See Also' section===
 +
Sometimes it's useful to have a section at the end of an articles dedicated to a list of relevant other articles or links elsewhere. A character sheet guide could have a GitHub link to the sheet's source code, or [[Geomorphic Map Tiles#See Also|article on making maps]] could link to other map-related wiki pages.
 +
 
 +
==See also==
 +
* [https://meta.wikimedia.org/wiki/Help:HTML_in_wikitext#Tags_with_special_effect WikiMedia's documentation on formatting tags].
 +
 
 +
<br />
 +
[[Category:Wiki Administration]]

Revision as of 20:15, 3 June 2019

The Roll20 Wiki is intended to serve as a community resource for help and documentation as well as tips and tricks for best using Roll20 with your tabletop games. We welcome community contributions and would love for you to help us create the best resource we can for your fellow Roll20 users!

Check Category:Stubs and Category:NeedsUpdates for existing pages that need help

That said, there are a few things we actively discourage at this time:

  • The wiki is for content that the entire community will find useful. Please don't use it to post information relevant to a specific game/Campaign that you are running.
  • The pages in the Docs Category are only to contain factual information on official Roll20 functionality. These pages are created and maintained only by the Roll20 Staff. Feel free to create additional pages outside that category for workarounds and other non-official tips.
  • Please do not use wiki pages to lobby for changes to Roll20 features. Instead use the Suggestions forum. Talk pages should only be used to discuss changes that need to be made to the wiki page itself or to clarify existing functionality.
  • Don't use the wiki to ask questions, the Forums are better used for this.


Contents

Using the Wiki

If you're new to the MediaWiki software that we're utilizing (the same used to power Wikipedia), you can view a lot of helpful information on it here.

Page formatting

The exists a few tips and tricks how to make pages look better and more readable, here are few main pointers.

Headings

Use headings to structure a page if it contains multiple sections. If a page have enough sections, it will automatically generate a Table of Content. Heading Showcase

Uploading Images

If you are a new user adding content to the wiki, the option to upload images is disabled by default. If you need to include screenshots or diagrams, contact a Roll20 Developer to enable upload privileges.

Message Boxes



To add a message box to a wikipage, use this insert:

{{mbox | text = Insert Whatever You Want to Say Here}}

Roll20 UI Icons

If you want to display the actual icons used on the Roll20 interface (such as y, l, F, etc.) for clearer instructions in your wiki, you can add a span tag that briefly changes the needed font-family that is used for them.

The font families used for the Roll20 icons are Pictos, Pictos Custom, and dicefontd20, and they're available for use within the Roll20 wiki. Going to the font's storefront will give you the character key for the font. Use this key to identify which character displays which icon.

When you want to add an icon in your wiki, include these HTML snippets, substituting the letter you need for the Pictos or Pictos Custom font family.

  • q <span style="font-family:Pictos;">q</span> Chat tab
  • P <span style="font-family:Pictos;">P</span> Art Library tab
  • N <span style="font-family:Pictos;">N</span> Journal tab
  • u <span style="font-family:Pictos Custom;">u</span> Jukebox tab
  • l <span style="font-family:Pictos;">l</span> Collection tab
  • y <span style="font-family:Pictos;">y</span> My Settings tab
  • t <span style="font-family:dicefontd20;">t</span> d20
  • d <span style="font-family:dicefontd4;">d</span> d4
  • f <span style="font-family:dicefontd6;">f</span> d6
  • h <span style="font-family:dicefontd8;">h</span> d8
  • j <span style="font-family:dicefontd10;">j</span> d10
  • l <span style="font-family:dicefontd12;">l</span> d12

Displaying Macros and other Code Snippets

If you want to share Macros, complicated dice rolls, or CSS and HTML code, it might be a good idea to put your examples inside <pre> tags.

A messy example:
/roll 2d5+@{attribute|max}+4d4
The 4d4 here is supposed to be surrounded by square brackets, but they disappear if they're left naked to WikiMedia's markup conventions. Worse still, in this case, markup attempts to link it to non-existent page called "4d4".

This looks cleaner (and appears precisely as written) when surrounded by <pre> tags:

/roll 2d5+@{attribute|max}+[[4d4]]

For inline notes and asides you can use <code> tags to embellish things like /roll 3d10 or #macroname.

To avoid creating links to non-existing pages when writing inline rolls, use <pre> or <nowiki> tag. <nowiki> tag ignores all wiki formatting/templates/linkcreation as can at time be needed together with <code> tag to show some code without problem.
Click "Edit" for this page to see how the above examples work.

Structure

A few things makes the wiki easier to use and easier to find related pages.

Categories

A categorized page is easier to find, so please add at least one relevant category to any new page you create. There are few of the main wiki categories:

Content

Wiki Administration

To add a category to a page, simply add this line of text at the very bottom:

[[Category:Category Name]]

If the page falls under multiple categories, add another category tag underneath first and so forth (don't combine them in one tag).

Linking to other pages

If an article mentions things that have a wiki page, it's useful to link to that relevant page the first time it's mentioned. For example, there exists several Star Wars RPGs and some of them have guides on the wiki. Sometime it's useful to link a subsection of an article, like when mentioning there are limits to compendium sharing. If you want to link to a Category of pages you need to place a ':' in front of the page name, like:

[[:Category:Tips]]

'See Also' section

Sometimes it's useful to have a section at the end of an articles dedicated to a list of relevant other articles or links elsewhere. A character sheet guide could have a GitHub link to the sheet's source code, or article on making maps could link to other map-related wiki pages.

See also