JDOC

Difference between revisions of "Local interwiki links"

From Joomla! Documentation

(New page: An interwiki link is a kind of short-cut link that allows you to link to an external website (it doesn't have to be another wiki) using a simple syntax similar to an internal page link. T...)
 
Line 9: Line 9:
 
</pre>
 
</pre>
 
where ##### is replaced by the board number.  For example, the Developer Documentation Forum is board number 60 and so can be linked to by inserting <nowiki>[[jforum:60]]</nowiki> into the wiki page.  Just to prove it works, here it is: [[jforum:60]].  Piped links work too, so <pre>[[jforum:60|Developer Documentation Forum]]</pre> is rendered as: [[jforum:60|Developer Documentation Forum]]
 
where ##### is replaced by the board number.  For example, the Developer Documentation Forum is board number 60 and so can be linked to by inserting <nowiki>[[jforum:60]]</nowiki> into the wiki page.  Just to prove it works, here it is: [[jforum:60]].  Piped links work too, so <pre>[[jforum:60|Developer Documentation Forum]]</pre> is rendered as: [[jforum:60|Developer Documentation Forum]]
 +
 +
To make things a little bit easier when linking to any of the well-known ''Working Group'' fora you can use the {{tlx|jforum}} template. It accepts a (hopefully) easy to remember keyword instead of a number to create a link. Instead of <nowiki>[[jforum:60]]</nowiki> you can use {{tlx|jforum|devdoc}} or {{tlx|jforum|ddt}} ('''D'''eveloper '''D'''ocumentation '''T'''eam). And to prove the template works equally well, here's how both keywords are rendered: {{jforum|devdoc}} and {{jforum|ddt}}.
  
 
===Linking to a topic in forum.joomla.org===
 
===Linking to a topic in forum.joomla.org===

Revision as of 15:17, 18 January 2008

An interwiki link is a kind of short-cut link that allows you to link to an external website (it doesn't have to be another wiki) using a simple syntax similar to an internal page link. The interwiki reference takes a single parameter and uses it to construct the full URL to the external site.

The following Joomla!-specific interwiki links are supported in this wiki.

Linking to a board in forum.joomla.org[edit]

To link to a specific forum board in forum.joomla.org you can use this syntax:

[[jforum:#####]]

where ##### is replaced by the board number. For example, the Developer Documentation Forum is board number 60 and so can be linked to by inserting [[jforum:60]] into the wiki page. Just to prove it works, here it is: jforum:60. Piped links work too, so

[[jforum:60|Developer Documentation Forum]]

is rendered as: Developer Documentation Forum

To make things a little bit easier when linking to any of the well-known Working Group fora you can use the {{jforum}} template. It accepts a (hopefully) easy to remember keyword instead of a number to create a link. Instead of [[jforum:60]] you can use {{jforum|devdoc}} or {{jforum|ddt}} (Developer Documentation Team). And to prove the template works equally well, here's how both keywords are rendered: Developer Documentation forum and DevDocs forum.

Linking to a topic in forum.joomla.org[edit]

To link to a specific forum topic (thread) in forum.joomla.org you can use this syntax:

[[jtopic:#####]]

where ##### is replaced by the topic number. For example, the forum thread announcing the first Joomla! Doc Camp is topic number 248141 and so can be linked to by inserting [[jtopic:248141]] into the wiki page. Just to prove it works, here it is: jtopic:248141. Piped links work too, so

[[jtopic:248141|Joomla! Doc Camp]]

is rendered as: Joomla! Doc Camp

Linking to a tracker item in JoomlaCode.org[edit]

To link to a specific tracker item (eg. a bug report) in JoomlaCode.org you can use this syntax:

[[jtracker:#####]]

where ##### is replaced by the tracker ID number. For example, the tracker item "Issue with (Today) string" is tracker number 8867 and so can be linked to by inserting [[jtracker:8867]] into the wiki page. Just to prove it works, here it is: jtracker:8867. Piped links work too, so

[[jtracker:8867|Issue with (Today) string]]

is rendered as: Issue with (Today) string. Note that you will probably need to be logged into JoomlaCode for these links to work as expected.

Linking to a help screen on help.joomla.org[edit]

To link to a help screen on the Joomla! help site using a key reference you can use this syntax:

[[jhelp:#####]]

where ##### is replaced by the help screen key reference. For example, the help screen for the Global Configuration screen in Joomla! 1.5 has key reference "screen.config.15" and so can be linked to by inserting [[jhelp:screen.config.15]] into the wiki page. Just to prove it works, here it is: jhelp:screen.config.15. Piped links work too, so

[[jhelp:screen.config.15|Global Configuration]]

is rendered as: Global Configuration.

Linking to PHP documentation[edit]

To link to a reference page on php.net you can use this syntax:

[[php:xxxxxxxxx]]

where xxxxxxxxx is replaced by a word, usually a PHP function name. For example, the reference page for the PHP strlen() function can be linked to by inserting [[php:strlen]] into the wiki page. Just to prove it works, here it is: php:strlen. Piped links work too, so

[[php:strlen|strlen()]]

is rendered as: strlen().