View source for Template talk:Code

{{Talk header}}
{{User:MiszaBot/config
| counter = 1
| archiveheader = {{tan}}
| algo = old(180d)
| maxarchivesize = 200k
| archive = Template talk:Code/Archive %(counter)d
| minthreadstoarchive = 1
| minthreadsleft = 0
}}
{{permprot}}
{{copied|from=Template:Code|from_oldid=714246016|to=:incubator:Template:Wp/nod/code|to_diff=4241320}}
{{Archivebox|1=<nowiki />
*[[/Archive 1|Archive 1]]
}}

== RFC Syntaxhighlighting one word code ==

<!-- [[User:DoNotArchiveUntil]] 08:01, 27 February 2025 (UTC) -->{{User:ClueBot III/DoNotArchiveUntil|1740643268}}
There is no point in syntaxhighlighting a word code.
{{qf|The feature displays text, especially source code, in different colours and fonts according to the category of terms. This feature facilitates writing in a structured language such as a programming language or a markup language as both structures and syntax errors are visually distinct.|[[Syntax highlighting]]}}
The meaning of 'distinct' is "different from one another." -- [[User:Cedar101|Cedar101]] ([[User talk:Cedar101|talk]]) 01:40, 22 January 2025 (UTC)

:Semantic markup. Also, not all users are sighted. No bots are. Not yet. 
:And if that doesn't convince you, that's fine, too. I don't think there is anyone for whom Wikipedia is {{em|exactly}} like they think it should be. <span style="display:inline-block;position:relative;transform:rotate(-3deg);bottom:-.1em;">[[user:Paradoctor|Paradoctor]]</span> ([[user talk:Paradoctor|talk]]) 02:05, 22 January 2025 (UTC)
::{{tl|code}} only means that the text is code, and provides little semantics for the language. {{tl|c-lang}}, {{tl|java}} and other templates in [[:Category:Programming typing-aid templates]] provide some more semantics. There should be some general [[wikipedia:consensus|consensus]] on whether to apply the template that provides semantics for the language. -- [[User:Cedar101|Cedar101]] ([[User talk:Cedar101|talk]]) 05:17, 22 January 2025 (UTC)
:::{{tq|This template is used on 63,000+ pages}} <span style="display:inline-block;position:relative;transform:rotate(-3deg);bottom:-.1em;">[[user:Paradoctor|Paradoctor]]</span> ([[user talk:Paradoctor|talk]]) 10:28, 22 January 2025 (UTC)

{{Moved discussion from|Talk:Integer (computer science)#Syntaxhighlighting one word code|2=This is the more common venue.}}
[[User:Cedar101|Cedar101]] ([[User talk:Cedar101|talk]]) 06:57, 23 January 2025 (UTC)
:I'm sorry, I don't understand what this RfC is about. The statement, as copied to [[WP:RFC/POLICY]], consists of a broken {{tlx|Moved discussion from}} tag. It's broken because the closing double braces are ''after'' the timestamp, in violation of [[WP:RFC#Formatting example]]. --[[User:Redrose64|<span style="color:#a80000; background:#ffeeee; text-decoration:inherit">Red</span>rose64]] &#x1f339; ([[User talk:Redrose64|talk]]) 23:17, 23 January 2025 (UTC)
:: Okay, I moved and fixed {{tlx|Moved discussion from}} tag. -- [[User:Cedar101|Cedar101]] ([[User talk:Cedar101|talk]]) 23:42, 23 January 2025 (UTC)
:Does this RFC mean something like this? 
:"I don't want people to use this template if there is only one word inside the template.  If you want to write 'The pun about sharing the [[Split pea soup|pea soup]] relies on being familiar with the verb convention in [[Lisp (programming language)|Lisp]], which treats {{code|split-p|Common Lisp}} as an action", then you should not use this template, because that's only one word."
:Or does it mean something else? [[User:WhatamIdoing|WhatamIdoing]] ([[User talk:WhatamIdoing|talk]]) 08:11, 4 February 2025 (UTC)
:'''Oppose''' - Non-English words are italicized. Analogously, it is natural that programming keywords should be monospaced. This is a convention in programming: See how even single-word commands are monospaced in chapter 2 of [https://texdoc.org/serve/texbytopic/0 <code>texdoc texbytopic</code>]. Also see the monospacing at [[malloc]]. However, ''theoretical'' computer science ''concepts'' are not monospaced: "ordered", "linear", "affine", and "relevant" in [[Substructural type system]] are not monospaced, but ''pseudocode'' is monospaced.
:The goal of "distinct" here is not only {{tq|different from one another}}, but also "different from the surrounding prose". The implied meaning also changes based on font:
:* int - to intentionally lose a game
:* <code>int</code> - a 32-bit primitive data type in many programming languages
:* <code>INT</code> / <code>INTEGER</code> - a 32-bit SQL data type
:* Integer - any numeric data type, theoretically of any precision
:* <code>Integer</code> - a non-primitive 32-bit data type in Java
:[[Special:Contributions/173.206.40.108|173.206.40.108]] ([[User talk:173.206.40.108|talk]]) 17:37, 16 February 2025 (UTC)

== Edit request 6 April 2025 - Performance improvement ==

{{Edit template-protected|Template:Code|answered=yes}}

Hello, you may be interested by the code used by this template on frwiki: [https://fr.wikipedia.org/w/index.php?title=Mod%C3%A8le:Code&oldid=224590690&action=edit].

When the template is used without "lang" parameter, I figured out a way to use "code + nowiki" instead of "syntaxhighlight". The result is visually identical, but we avoid the expensive syntaxhighlight call.

(Refs a previous, failed attempt: [[Template talk:Code/Archive 1#Template-protected edit request on 4 March 2024]].)

[[User:Od1n|Od1n]] ([[User talk:Od1n|talk]]) 18:03, 6 April 2025 (UTC)
:I have pushed (pushed back, actually) the suggested change to the [[Template:Code/sandbox|sandbox]]. Note that, as it happens, there is a difference in behavior with HTML entities. See third table in the [[Template talk:Code/Archive 1#Template-protected edit request on 4 March 2024|previous discussion]]. [[User:Od1n|Od1n]] ([[User talk:Od1n|talk]]) 01:19, 7 April 2025 (UTC)
::I note that {{diff|Template:Code/sandbox|prev|1284352948|this edit}} removes the {{para|id}} parameter on the grounds that it's unused. That may be the case; but it was {{diff|Template:Code|prev|601948955|added}} on the grounds of harmonisation. I think that it should not be removed. --[[User:Redrose64|<span style="color:#a80000; background:#ffeeee; text-decoration:inherit">Red</span>rose64]] &#x1f339; ([[User talk:Redrose64|talk]]) 16:56, 7 April 2025 (UTC)
:::Some relevant examples from the previous discussion have been copied to the testcases page. I see differences in rendering between the live template and the sandbox in the second "Markup behaviour" table. Are those differences intended? – [[User:Jonesey95|Jonesey95]] ([[User talk:Jonesey95|talk]]) 18:37, 8 April 2025 (UTC)
::::* No opinion regarding the removal of the {{para|id}} parameter. I just synchronized with the production template, where it has been removed. I lean toward keeping it removed, but that’s a secondary consideration.
::::* I noticed the discrepancy with HTML entities only after posting the suggested change. On one hand, the change would make the template significantly faster (eliminating the expensive <code><nowiki><syntaxhighlight></nowiki></code> call on all simple uses), but on the other hand, it introduces that discrepancy with HTML entities. Thoughts?
::::[[User:Od1n|Od1n]] ([[User talk:Od1n|talk]]) 20:58, 10 April 2025 (UTC)
: What's the use case for this? Are there actually a significant number of pages running into the expensive parser function limit because of calls to this template with lang=text? Otherwise [[WP:PERF]] applies and it's not worth the extra complexity. [[User:Pppery|* Pppery *]] [[User talk:Pppery|<sub style="color:#800000">it has begun...</sub>]] 20:17, 22 April 2025 (UTC)
::Are there ''any'' pages that have {{code|1= lang=text}}? I for one have never seen any in the wild. [[User:JMF|𝕁𝕄𝔽]] ([[User talk:JMF|talk]]) 20:40, 22 April 2025 (UTC)
::: "Text" is the default, so any pages that don't specify a language would trigger this, which is probably fairly common. But even given that [https://en.wikipedia.org/w/index.php?search=hastemplate%3ACode+incategory%3A%22Pages+with+too+many+expensive+parser+function+calls%22&title=Special%3ASearch&profile=advanced&fulltext=1&ns0=1&ns1=1&ns2=1&ns3=1&ns4=1&ns5=1&ns6=1&ns7=1&ns8=1&ns9=1&ns10=1&ns11=1&ns12=1&ns13=1&ns14=1&ns15=1&ns100=1&ns101=1&ns118=1&ns119=1&ns710=1&ns711=1&ns828=1&ns829=1 there are only 6 pages using this template with too many expensive parser function calls] so I still don't think it's worth it. [[User:Pppery|* Pppery *]] [[User talk:Pppery|<sub style="color:#800000">it has begun...</sub>]] 23:26, 24 April 2025 (UTC)
:[[File:X mark.svg|20px|link=|alt=]] '''Not done for now''': please establish a [[Wikipedia:Consensus|consensus]] for this alteration '''[[Wikipedia:Edit requests#Planning a request|before]]''' using the {{Tlx|Edit template-protected}} template.<!-- Template:ETp --> [[User:Jlwoodwa|jlwoodwa]] ([[User talk:Jlwoodwa|talk]]) 01:35, 27 April 2025 (UTC)
::A great solution for this issue would be upstream, in the extension code: when no syntax highlighting is applied, there is no reason for the tag to be expensive.
::When using <code>lang="text"</code>, we should ensure that the tag execution is fast, and does not increment the expensive function count. For instance, I thought of an early return [https://github.com/wikimedia/mediawiki-extensions-SyntaxHighlight_GeSHi/blob/37de6fb00d3608c9f45716712d1484d14ccf66c0/includes/SyntaxHighlight.php#L271 in SyntaxHighlight.php]: <syntaxhighlight lang="php">
//if ( $lexer === null ) {
if ( $lexer === null || $lexer === 'text' ) {
	// When syntax highlighting is disabled..
	$status->value = self::plainCodeWrap( $code, $isInline );
	return $status;
}
</syntaxhighlight>
::[[User:Od1n|Od1n]] ([[User talk:Od1n|talk]]) 20:36, 19 May 2025 (UTC)
:::One caveat with the above change: it would break the "line numbers" feature on plain text, i.e. <code><nowiki><syntaxhighlight lang="text" line></nowiki></code>. So my proposed change requires further refinement.
:::By the way, I noticed a related bug that would impact this change too: when using <code><nowiki><syntaxhighlight line></nowiki></code> (erroneously omitting the <code>lang</code> attribute), the lines placeholder appears but does not contain line numbers.
:::[[User:Od1n|Od1n]] ([[User talk:Od1n|talk]]) 20:52, 19 May 2025 (UTC)