Difference between revisions of "Help:Links"
From Roll20 Wiki
Andreas J. (Talk | contribs) m |
Andreas J. (Talk | contribs) m (→Inter-Wiki) |
||
(6 intermediate revisions by one user not shown) | |||
Line 9: | Line 9: | ||
instead of {{twitter|roll20app/status/1354617919653752832?s=20 tweet}}</pre> | instead of {{twitter|roll20app/status/1354617919653752832?s=20 tweet}}</pre> | ||
− | You may also replace the <code>=</code> with <code><nowiki>&#61;</nowiki></code> in the url, to keep | + | You may also replace the <code>=</code> with <code><nowiki>&#61;</nowiki></code> in the url, to keep a link from breaking. |
===Inter-Wiki=== | ===Inter-Wiki=== | ||
Line 21: | Line 21: | ||
Link to the wiki's [[Main_Page|front page]], with a custom link name. | Link to the wiki's [[Main_Page|front page]], with a custom link name. | ||
<pre>[[Main_Page|front page]]</pre> | <pre>[[Main_Page|front page]]</pre> | ||
+ | |||
+ | '''Link to section of same article''' | ||
+ | |||
+ | You can link to a subsection of the same page, making it easier to jumping between related sections of larger articles. You can find the exact name of an sub-section, by copying the link from the ToC. | ||
+ | |||
+ | Example: [[#Wikipedia]], [[#Wikipedia|Wikipedia]] | ||
+ | <pre>[[#Wikipedia]], [[#Wikipedia|Wikipedia]]</pre> | ||
'''Link a subsection of an article.''' | '''Link a subsection of an article.''' | ||
Line 26: | Line 33: | ||
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. | 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> | <pre>[[Compendium_Sharing#What_are_the_Limitations_of_Compendium_Sharing.3F|limits to compendium sharing]]</pre> | ||
− | |||
Line 37: | Line 43: | ||
====Wiki Meta==== | ====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 | + | '''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 {{code|:}} in front of the page name, like: |
<pre>[[:Category:Tips]]</pre> | <pre>[[:Category:Tips]]</pre> | ||
'''Link to a wiki template:''' {{tlx|forum}} - <code><nowiki>{{tlx|forum}}</nowiki></code> | '''Link to a wiki template:''' {{tlx|forum}} - <code><nowiki>{{tlx|forum}}</nowiki></code> | ||
− | |||
===Roll20 links=== | ===Roll20 links=== | ||
Line 62: | Line 67: | ||
<pre>{{forum|post/125912/roll20-community-code-of-conduct Roll20 Community Code of Conduct}}</pre> | <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>< | + | The url placed in the forum-template is everything after <code><nowiki>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 | + | 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 | + | <pre>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: | The more compact {{tlx|fpl}} only requires the permalink number to a forum reply/thread, so individual comments can also be linked to: | ||
Line 78: | Line 83: | ||
Documentation: {{tlx|blogs}}, {{tlx|blog}} | Documentation: {{tlx|blogs}}, {{tlx|blog}} | ||
− | Link to Roll20 blog posts. You discard the < | + | Link to Roll20 blog posts. You discard the <code><nowiki>https://blog.roll20.net/posts/</nowiki></code> 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}} | If the blog post url contains <code>/posts/</code> in the url, use {{tlx|blogs}}; if it has <code>/post/</code>, use {{tlx|blog}} | ||
Line 114: | Line 119: | ||
===External Link=== | ===External Link=== | ||
− | If you want to link to a page outside the wiki, you need to use single brackets. | + | If you want to link to a page outside the wiki, you need to use single brackets. An icon ([https://google.com like this]) appear after these links by default. |
+ | * any links leading to other parts of roll20 will show a roll20 logo | ||
+ | * for a number of sites like youtube, github, wikipedia ([[MediaWiki:Common.css|and more]]), instead shows that site's logo. | ||
+ | * below is a number of templates to simplify/shorten some urls for commonly referenced sites | ||
Example: [https://blog.roll20.net/ Roll20 Blog] | Example: [https://blog.roll20.net/ Roll20 Blog] | ||
Line 162: | Line 170: | ||
* [[Help:Contents]] | * [[Help:Contents]] | ||
* [[Help:Table]] | * [[Help:Table]] | ||
+ | * [[Help:Transclusion]] | ||
* [[:Category:Wiki Editing]] | * [[:Category:Wiki Editing]] | ||
[[Category:Wiki Editing]]</noinclude> | [[Category:Wiki Editing]]</noinclude> |
Latest revision as of 08:20, 9 June 2024
Page Updated: 2024-06-09 |
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 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 =
may result in broken links, unless you specify that it's the 1st parameter which is used. Templates - Anonymous parameters
Example:
use {{twitter|1=roll20app/status/1354617919653752832?s=20 tweet}} instead of {{twitter|roll20app/status/1354617919653752832?s=20 tweet}}
You may also replace the =
with =
in the url, to keep a link from breaking.
Contents |
[edit] Inter-Wiki
How to link to other pages on the Roll20 Community Wiki.
Example:
Simple link to Journal wiki page:
[[Journal]]
Link to the wiki's front page, with a custom link name.
[[Main_Page|front page]]
Link to section of same article
You can link to a subsection of the same page, making it easier to jumping between related sections of larger articles. You can find the exact name of an sub-section, by copying the link from the ToC.
Example: #Wikipedia, Wikipedia
[[#Wikipedia]], [[#Wikipedia|Wikipedia]]
Link a subsection of an article.
For example you might need to mentioning there are limits to compendium sharing. You can find the exact name of an sub-section, by copying the link from the ToC.
[[Compendium_Sharing#What_are_the_Limitations_of_Compendium_Sharing.3F|limits to compendium sharing]]
[edit] Main Article
Shortcut to make a link to another article, and indicate it to be the main article on the subject.
Main Page: Journal
{{main|Journal}}
[edit] 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:
[[:Category:Tips]]
Link to a wiki template: {{forum}}
- {{tlx|forum}}
[edit] 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.)
[edit] 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.
[https://app.roll20.net/users/4/ Roll20 Dev Team]
{{user profile|4|Roll20 Dev Team}}
[edit] Forum
Documentation: {{forum}}
, {{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: Roll20 Community Code of Conduct(Forum)
{{forum|post/125912/roll20-community-code-of-conduct Roll20 Community Code of Conduct}}
The url placed in the forum-template is everything after https://app.roll20.net/forum/
, which the templates will ad automatically.
Compare 5E Bug thread(Forum) and 5E Bug thread
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]
The more compact {{fpl}}
only requires the permalink number to a forum reply/thread, so individual comments can also be linked to:
Roll20 Dev reply(Forum)
{{fpl|10245813/ Roll20 Dev reply}}
[edit] Blog
Documentation: {{blogs}}
, {{blog}}
Link to Roll20 blog posts. You discard the https://blog.roll20.net/posts/
part of the url.
If the blog post url contains /posts/
in the url, use {{blogs}}
; if it has /post/
, use {{blog}}
Lost Mine of Phandelver: Roll20 Q & A(Blog) Updated DL version 1.0 is live(Blog, Archived)
{{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}}
[edit] Help Center
It's often a good idea to link to the Official Roll20 Help Center page.
{{hc|categories/360003756533-Getting-Started Getting Started}}
Documentation: {{hc}}
, {{HCbox}}
[edit] Marketplace
Roll20 Marketplace(Market)
Free Spacer - Ptolemy Sector Archive(Market)
{{market| Roll20 Marketplace}}<br> {{market|browse/module/7363/free-spacer-ptolemy-sector-archive Free Spacer - Ptolemy Sector Archive}}
Documentation: {{market}}
[edit] External Link
If you want to link to a page outside the wiki, you need to use single brackets. An icon (like this) appear after these links by default.
- any links leading to other parts of roll20 will show a roll20 logo
- for a number of sites like youtube, github, wikipedia (and more), instead shows that site's logo.
- below is a number of templates to simplify/shorten some urls for commonly referenced sites
Example: Roll20 Blog
[https://blog.roll20.net/ Roll20 Blog]
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: Roll20, tweet by Roll20 -
{{twitter}}
[edit] 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: {{repo}}
, {{gist}}
, {{sheet-gh}}
, {{api-gh}}
Example:
Roll20's Character Sheet Repository,
{{repo|Roll20/roll20-character-sheets Roll20's Character Sheet Repository}}
The url placed in the forum-template is everything after https://github.com/
, which the templates will add automatically.
Example:
code snippet by GiGs
{{gist|G-G-G/52b96cff0b827c42f9d04ab411fb42e8 code snippet}} by GiGs
[edit] Youtube
Documentation: {{yt}}
, {{yt.be}}
, {{yt.playlist}}
Example:
Rolling Dice –
Roll20 Tutorials
{{yt.be|xKXpKIiB5WM Rolling Dice}} {{yt.playlist|PLTj75n3v9eTljjooh-nIr_LFAeHatTeI4 Roll20 Tutorials}}
[edit] Wikipedia
Wikipedia link: HTML or Computer Accessibility (a11y) to have logo.
[[wikipedia:HTML|HTML]] or {{wiki|Computer_accessibility|Computer Accessibility (a11y)}}
{{wiki}}