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 "Template:Api repository link/doc"

From Roll20 Wiki

Jump to: navigation, search
(Created page with "Links to a file on the [https://github.com/Roll20/roll20-api-scripts API Script Repository] == Parameters == {| class="wikitable" |- ! Name ! Description |- || directory || D...")
 
m
(3 intermediate revisions by one user not shown)
Line 1: Line 1:
 +
{{documentation subpage|override=api repository link/doc|Api repository link}}
 
Links to a file on the [https://github.com/Roll20/roll20-api-scripts API Script Repository]
 
Links to a file on the [https://github.com/Roll20/roll20-api-scripts API Script Repository]
  
Line 11: Line 12:
 
|-
 
|-
 
|| file
 
|| file
|| File within the <code>directory</code> to link to. Defaults to the first anonymous parameter. This ''does'' mean that if neither <code>directory</code> nor <code>file</code> are specified, the linked file will be something to the effect of <code>foo/foo.js</code> (file and directory with the same name).
+
|| File within the <code>directory</code> to link to. Defaults to the second anonymous parameter.
 
|-
 
|-
|| extension
+
|| ext
 
|| File extension of the file to link to. Defaults to the third anonymous parameter.
 
|| File extension of the file to link to. Defaults to the third anonymous parameter.
|-
 
|| display name
 
|| Name to display for the link. Defaults to the second anonymous parameter, which in turn defaults to <code>file</code>.
 
 
|}
 
|}
 +
 +
If <code>ext</code> is supplied, the link is guaranteed to link to a file; if <code>file</code> is ''not'' supplied (for example, <code><nowiki>{{api repository link|ext=js|Foo}}</nowiki></code>), the <code>directory</code> will be used for the file name as well.
  
 
== Usage ==
 
== Usage ==
Line 25: Line 25:
 
! Wikitext
 
! Wikitext
 
! Output
 
! Output
 +
! Notes
 
|-
 
|-
|| <code><nowiki>{{api repository link|The Darkness is Closing In}}</nowiki></code>
+
|| <code><nowiki>{{api repository link|Foo}}</nowiki></code>
|| {{api repository link|The Darkness is Closing In}}
+
|| {{api repository link|Foo}}
 +
|| This links to <code>/tree/master/Foo</code>
 
|-
 
|-
|| <code><nowiki>{{api repository link|The Darkness is Closing In|file=package|extension=.json}}</nowiki></code>
+
|| <code><nowiki>{{api repository link|Foo|Bar}}</nowiki></code>
|| {{api repository link|The Darkness is Closing In|file=package|extension=.json}}
+
|| {{api repository link|Foo|Bar}}
 +
|| This links to <code>/blob/master/Foo/Bar</code>
 +
|-
 +
|| <code><nowiki>{{api repository link|Foo|ext=md}}</nowiki></code>
 +
|| {{api repository link|Foo|ext=md}}
 +
|| This links to <code>/blob/master/Foo/Foo.md</code>
 +
|-
 +
|| <code><nowiki>{{api repository link|Foo|Bar|json}}</nowiki></code>
 +
|| {{api repository link|Foo|Bar|json}}
 +
|| This links to <code>/blob/master/Foo/Bar.json</code>
 
|}
 
|}
 +
 +
<includeonly>[[Category:API Templates]]</includeonly>

Revision as of 22:45, 14 January 2015

Links to a file on the API Script Repository

Parameters

Name Description
directory Directory from the root of the repository that the file is located in. Defaults to the first anonymous parameter.
file File within the directory to link to. Defaults to the second anonymous parameter.
ext File extension of the file to link to. Defaults to the third anonymous parameter.

If ext is supplied, the link is guaranteed to link to a file; if file is not supplied (for example, {{api repository link|ext=js|Foo}}), the directory will be used for the file name as well.

Usage

Wikitext Output Notes
{{api repository link|Foo}} Foo This links to /tree/master/Foo
{{api repository link|Foo|Bar}} Bar This links to /blob/master/Foo/Bar
{{api repository link|Foo|ext=md}} Foo This links to /blob/master/Foo/Foo.md
{{api repository link|Foo|Bar|json}} Bar This links to /blob/master/Foo/Bar.json