Roll20 Wiki

<noinclude>{{revdate}}{{main|Help:Contents}}</noinclude>
If an article mentions things that have a wiki page, it's useful to link to that  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. Sometimes links outside the wiki is also useful.

With some link templates, urls that contains <code>=</code> may result in broken links, unless you specify that it's the 1st parameter which is used. [https://www.mediawiki.org/wiki/Help:Templates/en#Anonymous_parameters Templates - Anonymous parameters]

{{ex}}
<pre>use
{{twitter|1=roll20app/status/1354617919653752832?s=20 tweet}}
instead of {{twitter|roll20app/status/1354617919653752832?s=20 tweet}}</pre>

You may also replace the <code>=</code> with <code><nowiki>&amp;#61;</nowiki></code> in the url, to keep the link from breaking.

===Inter-Wiki===
How to link to other pages on the Roll20 [[About:Community Wiki|Community Wiki]].

'''Example:'''

Simple link to [[Journal]] wiki page:
<pre>[[Journal]]</pre>

Link to the wiki's [[Main_Page|front page]], with a custom link name.
<pre>[[Main_Page|front page]]</pre>

'''Link a subsection of an article.'''

For example you might need to mentioning there are [[Compendium_Sharing#What_are_the_Limitations_of_Compendium_Sharing.3F|limits to compendium sharing]]. You can find the exact name of an sub-section, by copying the link from the ToC.
<pre>[[Compendium_Sharing#What_are_the_Limitations_of_Compendium_Sharing.3F|limits to compendium sharing]]</pre>



====Main Article====
Shortcut to make a link to another article, and indicate it to be the main article on the subject.

{{main|Journal}}

<pre>{{main|Journal}}</pre>

====Wiki Meta====
'''Link to a Category page.''' It can be useful to link to a category page, such as all user-created [[:Category:Tips]]. You need to place a ':' in front of the page name, like:
<pre>[[:Category:Tips]]</pre>

'''Link to a wiki template:''' {{tlx|forum}} - <code><nowiki>{{tlx|forum}}</nowiki></code>


===Roll20 links===
Here are a few templates that makes linking to other parts of the roll20 site better, and make it clear to what part the links lead(Forum, Blog, Marketplace, etc.)

====User Profile====
You can link directly to a Roll20 user's profile from the wiki, instead of typing the full url. The second method doesn't show the symbol for the link going outside Roll20.

<pre>[https://app.roll20.net/users/4/ Roll20 Dev Team]</pre>
<pre>{{user profile|4|Roll20 Dev Team}}</pre>


====[[Forum]]====
Documentation: {{tlx|forum}}, {{tlx|fpl}}


A template that can be used to link to Roll20 forum post, showing the roll20 logo, and indicating it's a link to the forum.

Example: {{forum|post/125912/roll20-community-code-of-conduct Roll20 Community Code of Conduct}}

<pre>{{forum|post/125912/roll20-community-code-of-conduct Roll20 Community Code of Conduct}}</pre>
The url placed in the forum-template is everything after <code><nomwiki>https://app.roll20.net/forum/</nowiki></code>, which the templates will ad automatically.

Compare {{forum|post/8033570/d-and-d-5th-edition-by-roll20-q1y2020 5E Bug thread}} and [[https://app.roll20.net/forum/post/8033570/d-and-d-5th-edition-by-roll20-q1y2020 5E Bug thread}]]

<pre style="overflow:auto;white-space:pre-wrap;">Compare {{forum|post/8033570/d-and-d-5th-edition-by-roll20-q1y2020 5E Bug thread}} and [[https://app.roll20.net/forum/post/8033570/d-and-d-5th-edition-by-roll20-q1y2020 5E Bug thread}]]</pre>

The more compact {{tlx|fpl}} only requires the permalink number to a forum reply/thread, so individual comments can also be linked to:

{{fpl|10245813/ Roll20 Dev reply}}
<pre style="overflow:auto;white-space:pre-wrap;">{{fpl|10245813/ Roll20 Dev reply}}</pre>



====Blog====
Documentation: {{tlx|blogs}}, {{tlx|blog}}

Link to Roll20 blog posts.  You discard the <nowiki><code>https://blog.roll20.net/posts/</code></nowiki> part of the url.

If the blog post url contains <code>/posts/</code> in the url, use {{tlx|blogs}}; if it has <code>/post/</code>, use {{tlx|blog}}

{{blogs|lost-mine-of-phandelver-roll20-q-a/ Lost Mine of Phandelver: Roll20 Q & A}}
{{blog|640321601818198016/updated-dynamic-lighting-10-is-live Updated DL version 1.0 is live}}

<pre>
{{blogs|lost-mine-of-phandelver-roll20-q-a/ Lost Mine of Phandelver: Roll20 Q & A}}
{{blog|640321601818198016/updated-dynamic-lighting-10-is-live Updated DL version 1.0 is live}}
</pre>

====[[Help Center]]====
It's often a good idea to link to the Official Roll20 [[Help Center]] page.

{{hc|categories/360003756533-Getting-Started Getting Started}}

<pre style="overflow:auto;white-space:pre-wrap;">
{{hc|categories/360003756533-Getting-Started Getting Started}}
</pre>

Documentation: {{tlx|hc}}, {{tlx|HCbox}}

====[[Marketplace]]====

{{market| Roll20 Marketplace}}<br>
{{market|browse/module/7363/free-spacer-ptolemy-sector-archive Free Spacer - Ptolemy Sector Archive}}<br>

<pre style="overflow:auto;white-space:pre-wrap;">
{{market| Roll20 Marketplace}}<br>
{{market|browse/module/7363/free-spacer-ptolemy-sector-archive Free Spacer - Ptolemy Sector Archive}}
</pre>

Documentation: {{tlx|market}}

===External Link===
If you want to link to a page outside the wiki, you need to use single brackets. There will appear a "lock" icon after the link to indicate it's  a link that goes outside the wiki.

Example: [https://blog.roll20.net/ Roll20 Blog]

<pre>[https://blog.roll20.net/ Roll20 Blog]</pre>

'''There are a few sites that have custom links that can make it easy to see where they lead''', and using them looks better than the normal single bracket method.

* '''Twitter:''' {{twitter|roll20app Roll20}}, {{twitter|roll20app/status/1360745454347169795 tweet by Roll20}} - {{tlx|twitter}}

====Github====
A template you can use to link to code or other things that are on GitHub. It will also show a small Github icon after the link to show where it leads. 

Documentation: {{tlx|repo}}, {{tlx|gist}}, {{tlx|sheet-gh}}, {{tlx|api-gh}}

{{ex}} {{repo|Roll20/roll20-character-sheets  Roll20's Character Sheet Repository}}, 

<pre style="overflow:auto;white-space:pre-wrap;">{{repo|Roll20/roll20-character-sheets  Roll20's Character Sheet Repository}}</pre>
The url placed in the forum-template is everything after <code><nowiki>https://github.com/</nowiki></code>, which the templates will add automatically.

{{ex}} {{gist|G-G-G/52b96cff0b827c42f9d04ab411fb42e8 code snippet}} by GiGs

<pre style="overflow:auto;white-space:pre-wrap;">
{{gist|G-G-G/52b96cff0b827c42f9d04ab411fb42e8 code snippet}} by GiGs
</pre>

====Youtube====
Documentation: {{tlx|yt}}, {{tlx|yt.be}}, {{tlx|yt.playlist}}

{{ex}}
{{yt.be|xKXpKIiB5WM Rolling Dice}} –
{{yt.playlist|PLTj75n3v9eTljjooh-nIr_LFAeHatTeI4 Roll20 Tutorials}} 
<pre style="overflow:auto;white-space:pre-wrap;">
{{yt.be|xKXpKIiB5WM Rolling Dice}}
{{yt.playlist|PLTj75n3v9eTljjooh-nIr_LFAeHatTeI4 Roll20 Tutorials}} 
</pre>

====Wikipedia====
Wikipedia link: [[wikipedia:HTML|HTML]] or {{wiki|Computer_accessibility|Computer Accessibility (a11y)}} to have logo.

<pre>[[wikipedia:HTML|HTML]] or {{wiki|Computer_accessibility|Computer Accessibility (a11y)}}</pre>

{{tlx|wiki}}
<noinclude>[[Category:Wiki Editing]] </noinclude>