Template:DebianIRC: Difference between revisions

Latest revision as of 15:13, 30 August 2025

<onlyinclude><span class="plainlinks">[ircs://irc.oftc.net/{{{name|{{{1}}}}}} {{{text|{{{2|#{{{name|{{{1}}}}}}}}}}}}] <span class="plainlinks">[https://webchat.oftc.net/?channels={{{name|{{{1}}}}}} {{{webchat|{{{3|(webchat)}}}}}}]</span></onlyinclude>

Link to an IRC channel on the OFTC network.

Template parameters[Edit template data]
Parameter		Description	Type	Status
Channel name	`name` `1`	Name of IRC channel without # prefix. Example debian-devel	Line	required
text	`text` `2`	Link text	Line	optional
webchat	`webchat` `3`	Link text Default (webchat)	Line	optional

The old wiki has a large inter-wiki map, for links like [[DebianIRC:channel]]. MediaWiki also supports interwiki links, but would we rather just use templates?

This page shows an example of how templates can provide a better user experience - editors can see documentation that tells them not to include the # in the channel name, and viewers get both an IRC and webchat link.

@@ Line 1: / Line 1: @@
-[ircs://irc.oftc.net/{{{1}}} #{{{1}}}] ([https://webchat.oftc.net/?channels={{{1}}} webchat])
+<pre><onlyinclude><span class="plainlinks">[ircs://irc.oftc.net/{{{name|{{{1}}}}}} {{{text|{{{2|#{{{name|{{{1}}}}}}}}}}}}] <span class="plainlinks">[https://webchat.oftc.net/?channels={{{name|{{{1}}}}}} {{{webchat|{{{3|(webchat)}}}}}}]</span></onlyinclude></pre>
+<templatedata>
+{
+    "description": "Link to an IRC channel on the OFTC network.",
+    "params": {
+        "name": {
+            "label": "Channel name",
+            "type": "line",
+            "required": true,
+            "description": "Name of IRC channel without # prefix.",
+            "aliases": ["1"],
+            "example": "debian-devel"
+        },
+        "text": {
+            "type": "line",
+            "required": false,
+            "description": "Link text",
+            "aliases": ["2"]
+        },
+        "webchat": {
+            "type": "line",
+            "required": false,
+            "description": "Link text",
+            "default": "(webchat)",
+            "aliases": ["3"]
+        }
+    }
+}
+</templatedata>
+The old wiki has a large [https://wiki.debian.org/InterWikiMap inter-wiki map], for links like <kbd><nowiki>[[DebianIRC:channel]]</nowiki></kbd>.  MediaWiki also supports [https://www.mediawiki.org/wiki/Manual:Interwiki interwiki links], but would we rather just use templates?
+This page shows an example of how templates can provide a better user experience - editors can see documentation that tells them not to include the <kbd>#</kbd> in the channel name, and viewers get both an IRC and webchat link.
+[[Category:Example]]
+[[Category:InterWikiLinkTemplate]]