Help talk:Templates - Revision history

DoggoBit: /* Use of file template vs syntaxhighlight */ Reply

2025-06-08T00:04:47Z

Use of file template vs syntaxhighlight: Reply

← Older revision		Revision as of 00:04, 8 June 2025
Line 10:		Line 10:
	:I disagree, but only in nuance. Using {{template link\|file}} gives us a "semantic handle" to lift and shift to whatever implementation we want in the future. In this direction, I added {{template link\|code}}, which {{template link\|file}} could easily use. However, I would propose we delete {{template link\|bc}}, {{template link\|ic}} and {{template link\|commands}}, as they have no syntax highlighting, being functionally obsolete now.		:I disagree, but only in nuance. Using {{template link\|file}} gives us a "semantic handle" to lift and shift to whatever implementation we want in the future. In this direction, I added {{template link\|code}}, which {{template link\|file}} could easily use. However, I would propose we delete {{template link\|bc}}, {{template link\|ic}} and {{template link\|commands}}, as they have no syntax highlighting, being functionally obsolete now.
	:But in general, I think we should avoid using raw tags if possible inside articles.[[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 21:04, 5 June 2025 (UTC)		:But in general, I think we should avoid using raw tags if possible inside articles.[[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 21:04, 5 June 2025 (UTC)
			::As an update, now {{tl\|file}} uses {{tl\|code}} under the hood. This allowed us to lift and shift all file blocks easily to include the copy functionality. However {{tl\|bc}} and {{tl\|ic}} and {{tl\|commands}} are no longer necessary. [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 00:04, 8 June 2025 (UTC)

	== Merge proposal between [[Template:Security Warning]] and [[Template:Warning]] ==		== Merge proposal between [[Template:Security Warning]] and [[Template:Warning]] ==

	This is a notice to notify anyone interested in the topic of templates that I have proposed merging the two templates. Further information can be found at {{talk page link\|talk=Template talk:Security Warning\|its discussion page}} [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 19:03, 5 June 2025 (UTC)		This is a notice to notify anyone interested in the topic of templates that I have proposed merging the two templates. Further information can be found at {{talk page link\|talk=Template talk:Security Warning\|its discussion page}} [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 19:03, 5 June 2025 (UTC)

DoggoBit: DoggoBit moved page Help talk:Template to Help talk:Templates: better name

2025-06-07T23:38:59Z

DoggoBit moved page Help talk:Template to Help talk:Templates: better name

← Older revision		Revision as of 23:38, 7 June 2025
(No difference)

DoggoBit: /* Use of file template vs syntaxhighlight */

2025-06-05T21:04:21Z

Use of file template vs syntaxhighlight

← Older revision		Revision as of 21:04, 5 June 2025
Line 8:		Line 8:

	The main caveat to using the syntaxhighlight tag is the koss of the filename at the top of the codeblock. That could be addresses by recommending putting it at the top of the codeblock in a comment, or ideally somehow adding a MediaWiki extension to allow the file name to be added to the top in mich the same way as the template (which afaik is possible, but I've never written MediaWiki extensions so not entirely sure what it involves yet). [[User:Fidgetingbits\|Fidgetingbits]] ([[User talk:Fidgetingbits\|talk]]) 13:23, 26 October 2024 (UTC)		The main caveat to using the syntaxhighlight tag is the koss of the filename at the top of the codeblock. That could be addresses by recommending putting it at the top of the codeblock in a comment, or ideally somehow adding a MediaWiki extension to allow the file name to be added to the top in mich the same way as the template (which afaik is possible, but I've never written MediaWiki extensions so not entirely sure what it involves yet). [[User:Fidgetingbits\|Fidgetingbits]] ([[User talk:Fidgetingbits\|talk]]) 13:23, 26 October 2024 (UTC)
			:I disagree, but only in nuance. Using {{template link\|file}} gives us a "semantic handle" to lift and shift to whatever implementation we want in the future. In this direction, I added {{template link\|code}}, which {{template link\|file}} could easily use. However, I would propose we delete {{template link\|bc}}, {{template link\|ic}} and {{template link\|commands}}, as they have no syntax highlighting, being functionally obsolete now.
			:But in general, I think we should avoid using raw tags if possible inside articles.[[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 21:04, 5 June 2025 (UTC)

	== Merge proposal between [[Template:Security Warning]] and [[Template:Warning]] ==		== Merge proposal between [[Template:Security Warning]] and [[Template:Warning]] ==

	This is a notice to notify anyone interested in the topic of templates that I have proposed merging the two templates. Further information can be found at {{talk page link\|talk=Template talk:Security Warning\|its discussion page}} [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 19:03, 5 June 2025 (UTC)		This is a notice to notify anyone interested in the topic of templates that I have proposed merging the two templates. Further information can be found at {{talk page link\|talk=Template talk:Security Warning\|its discussion page}} [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 19:03, 5 June 2025 (UTC)

DoggoBit: /* Merge proposal between Template:Security Warning and Template:Warning */ new section

2025-06-05T19:03:11Z

Merge proposal between Template:Security Warning and Template:Warning: new section

← Older revision		Revision as of 19:03, 5 June 2025
Line 8:		Line 8:

	The main caveat to using the syntaxhighlight tag is the koss of the filename at the top of the codeblock. That could be addresses by recommending putting it at the top of the codeblock in a comment, or ideally somehow adding a MediaWiki extension to allow the file name to be added to the top in mich the same way as the template (which afaik is possible, but I've never written MediaWiki extensions so not entirely sure what it involves yet). [[User:Fidgetingbits\|Fidgetingbits]] ([[User talk:Fidgetingbits\|talk]]) 13:23, 26 October 2024 (UTC)		The main caveat to using the syntaxhighlight tag is the koss of the filename at the top of the codeblock. That could be addresses by recommending putting it at the top of the codeblock in a comment, or ideally somehow adding a MediaWiki extension to allow the file name to be added to the top in mich the same way as the template (which afaik is possible, but I've never written MediaWiki extensions so not entirely sure what it involves yet). [[User:Fidgetingbits\|Fidgetingbits]] ([[User talk:Fidgetingbits\|talk]]) 13:23, 26 October 2024 (UTC)

			== Merge proposal between [[Template:Security Warning]] and [[Template:Warning]] ==

			This is a notice to notify anyone interested in the topic of templates that I have proposed merging the two templates. Further information can be found at {{talk page link\|talk=Template talk:Security Warning\|its discussion page}} [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 19:03, 5 June 2025 (UTC)

Fidgetingbits: /* Use of file template vs syntaxhighlight */ new section

2024-10-26T13:23:03Z

Use of file template vs syntaxhighlight: new section

New page

== Use of file template vs syntaxhighlight ==

This page currently recommends <nowiki>{{file}}</nowiki> template over the <nowiki><syntaxhighlight></nowiki> tag, but I'd like to propose we change that around for two reasons.

1) As of the next release of MediaWiki 1.43 there will be a [https://m.mediawiki.org/wiki/Extension:SyntaxHighlight copy flag] added to the tag, which adds a button allowing you to copy the entire code block. This is especially useful for accessibility (I happen to be a voice coder, so front of mind). I would like to see all existing code blocks get auto updated to include the copy flag once the update happens.

2) The ability to include line numbers and highlights to referenced code is much clearer (I think), so having people use the tag instead of the template makes it easier to make edits when improving other people's content. For example see the highlighting added to the vscode + language support section here [http://wiki.nixos.org/wiki/Java here].

The main caveat to using the syntaxhighlight tag is the koss of the filename at the top of the codeblock. That could be addresses by recommending putting it at the top of the codeblock in a comment, or ideally somehow adding a MediaWiki extension to allow the file name to be added to the top in mich the same way as the template (which afaik is possible, but I've never written MediaWiki extensions so not entirely sure what it involves yet). [[User:Fidgetingbits|Fidgetingbits]] ([[User talk:Fidgetingbits|talk]]) 13:23, 26 October 2024 (UTC)

← Older revision		Revision as of 00:04, 8 June 2025
Line 10:		Line 10:
	:I disagree, but only in nuance. Using {{template link\|file}} gives us a "semantic handle" to lift and shift to whatever implementation we want in the future. In this direction, I added {{template link\|code}}, which {{template link\|file}} could easily use. However, I would propose we delete {{template link\|bc}}, {{template link\|ic}} and {{template link\|commands}}, as they have no syntax highlighting, being functionally obsolete now.		:I disagree, but only in nuance. Using {{template link\|file}} gives us a "semantic handle" to lift and shift to whatever implementation we want in the future. In this direction, I added {{template link\|code}}, which {{template link\|file}} could easily use. However, I would propose we delete {{template link\|bc}}, {{template link\|ic}} and {{template link\|commands}}, as they have no syntax highlighting, being functionally obsolete now.
	:But in general, I think we should avoid using raw tags if possible inside articles.[[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 21:04, 5 June 2025 (UTC)		:But in general, I think we should avoid using raw tags if possible inside articles.[[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 21:04, 5 June 2025 (UTC)
			::As an update, now {{tl\|file}} uses {{tl\|code}} under the hood. This allowed us to lift and shift all file blocks easily to include the copy functionality. However {{tl\|bc}} and {{tl\|ic}} and {{tl\|commands}} are no longer necessary. [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 00:04, 8 June 2025 (UTC)

	== Merge proposal between [[Template:Security Warning]] and [[Template:Warning]] ==		== Merge proposal between [[Template:Security Warning]] and [[Template:Warning]] ==

	This is a notice to notify anyone interested in the topic of templates that I have proposed merging the two templates. Further information can be found at {{talk page link\|talk=Template talk:Security Warning\|its discussion page}} [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 19:03, 5 June 2025 (UTC)		This is a notice to notify anyone interested in the topic of templates that I have proposed merging the two templates. Further information can be found at {{talk page link\|talk=Template talk:Security Warning\|its discussion page}} [[User:DoggoBit\|DoggoBit]] ([[User talk:DoggoBit\|talk]]) 19:03, 5 June 2025 (UTC)