Template talk:Doc: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (Bot: Substituting template: Message)
(Removing the Template:Message)
Line 1: Line 1:
{{Discussion page}}
{{Discussion page}}
==Default Language==
I really like the language bar with the flags of all available docs at the top right, but what I really don't like is that the doc language defaults to the client's language even though a doc in the client's language does not exist. It even becomes ridiculous when the page uses {{code|style=2|<nowiki>{{doc|nolang=1}}</nowiki>}}, such that you get a non-existent doc and you don't even get the languages bar to switch to english. Please fix? --[[User:Popcorn|Popcorn]] ([[User talk:Popcorn|talk]]) 18:26, 23 Jan 2023
{{Message|user=Popcorn|time=18:26, 23 Jan 2023|I really like the language bar with the flags of all available docs at the top right, but what I really don't like is that the doc language defaults to the client's language even though a doc in the client's language does not exist. It even becomes ridiculous when the page uses {{code|style=2|<nowiki>{{doc|nolang=1}}</nowiki>}}, such that you get a non-existent doc and you don't even get the languages bar to switch to english. Please fix?}}


{{Message|user=Max34|time=19:39, 23 Jan 2023|Fixed. Actually, I was just thinking about doing this. The thing is, I'm currently working on another template that will probably get rid of 90% of the mess with languages, both in templates and documentation. If everything works, the {{code|style=1|{{param|suf}}}} parameter will no longer be needed anywhere. And I also removed the {{code|style=2|nolang}} parameter. I don't even remember why I added it.}}
:Fixed. Actually, I was just thinking about doing this. The thing is, I'm currently working on another template that will probably get rid of 90% of the mess with languages, both in templates and documentation. If everything works, the {{code|style=1|{{param|suf}}}} parameter will no longer be needed anywhere. And I also removed the {{code|style=2|nolang}} parameter. I don't even remember why I added it. --[[User:Max34 |Max34 ]] ([[User talk:Max34 |talk]]) 19:39, 23 Jan 2023


{{Message|user=1416006136|time=21:52, 23 Jan 2023|There is a problem that the template can't load the documentation of default language when the translations don't exist and using the {{code|style=1|{{param|content}}}} parameter. Please add support for the parameter.}}
:There is a problem that the template can't load the documentation of default language when the translations don't exist and using the {{code|style=1|{{param|content}}}} parameter. Please add support for the parameter. --[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 21:52, 23 Jan 2023


==The buttons and message box can not work correctly==
==The buttons and message box can not work correctly==
There is a problem in the template that when your language is English, the Creating button on the right top and an empty message box before the documentation will be displayed whether the documentation exists. --[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 11:36, 21 Feb 2023 (UTC)


<small>(using [[Template:Message]])</small>&nbsp;There is a problem in the template that when your language is English, the Creating button on the right top and an empty message box before the documentation will be displayed whether the documentation exists.&nbsp;--[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 11:36, 21 Feb 2023 (UTC)
:Unless move the English documentation to {{Code|…/doc/en}}. --[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 15:55, 21 Feb 2023 (UTC)


:The problem has solved by adding new parameter, {{code|style=1|{{param|default-none}}}} to {{code|style=2|<nowiki>{{uselang}}</nowiki>}}.}} --[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 16:17, 21 Feb 2023


<small>(using [[Template:Message]])</small>&nbsp;Unless move the English documentation to {{Code|/doc/en}}.&nbsp;--[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 15:55, 21 Feb 2023 (UTC)
::It was worth just rolling back the change from {{code|style=2|<nowiki>{{uilang}}</nowiki>}} to {{code|style=2|<nowiki>{{uselang}}</nowiki>}}. In any case, this is not important, since it is planned to switch from this template to the original template {{code|style=2|<nowiki>{{documentation}}</nowiki>}}. Everything will work differently in it, so there will be no need for the {{code|style=1|{{param|default-none}}}} parameter in {{code|style=2|<nowiki>{{uselang}}</nowiki>}}. --[[User:Max34|Max34]] ([[User talk:Max34|talk]]) 16:28, 21 Feb 2023


{{Message|user=1416006136|time=16:17, 21 Feb 2023|The problem has solved by adding new parameter, {{code|style=1|{{param|default-none}}}} to {{code|style=2|<nowiki>{{uselang}}</nowiki>}}.}}
:::Any changes in plans? --[[User:Amicdict|Amicdict]] ([[User talk:Amicdict|talk]]) 18:43, 4 Apr 2023 (UTC)


{{Message|user=Max34|time=16:28, 21 Feb 2023|It was worth just rolling back the change from {{code|style=2|<nowiki>{{uilang}}</nowiki>}} to {{code|style=2|<nowiki>{{uselang}}</nowiki>}}. In any case, this is not important, since it is planned to switch from this template to the original template {{code|style=2|<nowiki>{{documentation}}</nowiki>}}. Everything will work differently in it, so there will be no need for the {{code|style=1|{{param|default-none}}}} parameter in {{code|style=2|<nowiki>{{uselang}}</nowiki>}}.}}
::The new design of {{tl|Doc}} looks good. But it will take some time to make these changes. --[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 18:18, 8 Apr 2023
 
 
<small>(using [[Template:Message]])</small>&nbsp;Any changes in plans?&nbsp;--[[User:Amicdict|Amicdict]] ([[User talk:Amicdict|talk]]) 18:43, 4 Apr 2023 (UTC)
 
The new design of {{tl|Doc}} looks good. But it will take some time to make these changes. --[[1416006136]] ([[User talk:1416006136|talk]]) 18:18, 8 Apr 2023


== {{Bug|Extra slash "/" on "Template:(Page)/doc/" does not exist.}} ==
== {{Bug|Extra slash "/" on "Template:(Page)/doc/" does not exist.}} ==
Line 29: Line 25:
That's related to its working principle. {{tl2|Doc/subpage}} will try to check if the {{Code|<nowiki>{{SUBPAGENAME}}</nowiki>}} is {{Code|doc}}, or language suffixes ({{Code|en}}, {{Code|eo}}, {{Code|de}}, ...). {{Code|about}}, {{Code|preload}} are also valid value.
That's related to its working principle. {{tl2|Doc/subpage}} will try to check if the {{Code|<nowiki>{{SUBPAGENAME}}</nowiki>}} is {{Code|doc}}, or language suffixes ({{Code|en}}, {{Code|eo}}, {{Code|de}}, ...). {{Code|about}}, {{Code|preload}} are also valid value.
*If {{Code|<nowiki>{{SUBPAGENAME}}</nowiki>}} is valid value, {{tl2|Doc/subpage}} will display the notice.
*If {{Code|<nowiki>{{SUBPAGENAME}}</nowiki>}} is valid value, {{tl2|Doc/subpage}} will display the notice.
*If it is not, the template will display nothing. --[[1416006136]] ([[User talk:1416006136|talk]]) 17:24, 29 Aug 2023
*If it is not, the template will display nothing. --[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 17:24, 29 Aug 2023


As for the message box with a slash after the link, that may be a bug. <s>You can use the button "Create" to the right top to create page.</s> --[[1416006136]] ([[User talk:1416006136|talk]]) 17:43, 29 Aug 2023
As for the message box with a slash after the link, that may be a bug. <s>You can use the button "Create" to the right top to create page.</s> --[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 17:43, 29 Aug 2023


The bug should be fixed now. I have changed the parameter {{Code|<nowiki>{{{pref}}}</nowiki>}} of {{tl2|Uselang}}. --[[1416006136]] ([[User talk:1416006136|talk]]) 18:22, 29 Aug 2023
The bug should be fixed now. I have changed the parameter {{Code|<nowiki>{{{pref}}}</nowiki>}} of {{tl2|Uselang}}. --[[User:1416006136|1416006136]] ([[User talk:1416006136|talk]]) 18:22, 29 Aug 2023


Yea it's looking good now. --[[Kr0tchet]] ([[User talk:Kr0tchet|talk]]) 11:36, 30 Aug 2023
Yea it's looking good now. --[[User:Kr0tchet|Kr0tchet]] ([[User talk:Kr0tchet|talk]]) 11:36, 30 Aug 2023

Revision as of 04:23, 13 July 2024

Icon-message-48px.png
This is the discussion page of Template:Doc. To add a comment, use the Edit button near the headline of the appropriate section. To create a new section, you can use the Add topic button at the top of this page.
Comments on talk pages should be signed with "~~~~", which will be converted into your signature and a timestamp.

I really like the language bar with the flags of all available docs at the top right, but what I really don't like is that the doc language defaults to the client's language even though a doc in the client's language does not exist. It even becomes ridiculous when the page uses {{doc|nolang=1}}, such that you get a non-existent doc and you don't even get the languages bar to switch to english. Please fix? --Popcorn (talk) 18:26, 23 Jan 2023

Fixed. Actually, I was just thinking about doing this. The thing is, I'm currently working on another template that will probably get rid of 90% of the mess with languages, both in templates and documentation. If everything works, the {{{suf}}} parameter will no longer be needed anywhere. And I also removed the nolang parameter. I don't even remember why I added it. --Max34 (talk) 19:39, 23 Jan 2023
There is a problem that the template can't load the documentation of default language when the translations don't exist and using the {{{content}}} parameter. Please add support for the parameter. --1416006136 (talk) 21:52, 23 Jan 2023

The buttons and message box can not work correctly

There is a problem in the template that when your language is English, the Creating button on the right top and an empty message box before the documentation will be displayed whether the documentation exists. --1416006136 (talk) 11:36, 21 Feb 2023 (UTC)

Unless move the English documentation to …/doc/en. --1416006136 (talk) 15:55, 21 Feb 2023 (UTC)
The problem has solved by adding new parameter, {{{default-none}}} to {{uselang}}.}} --1416006136 (talk) 16:17, 21 Feb 2023
It was worth just rolling back the change from {{uilang}} to {{uselang}}. In any case, this is not important, since it is planned to switch from this template to the original template {{documentation}}. Everything will work differently in it, so there will be no need for the {{{default-none}}} parameter in {{uselang}}. --Max34 (talk) 16:28, 21 Feb 2023
Any changes in plans? --Amicdict (talk) 18:43, 4 Apr 2023 (UTC)
The new design of {{Doc}} looks good. But it will take some time to make these changes. --1416006136 (talk) 18:18, 8 Apr 2023

Icon-Bug.pngBug:Extra slash "/" on "Template:(Page)/doc/" does not exist.  [todo tested in ?]

See image below.
Bug-Doc-template.png
Beside, docs page that are created with "/doc/" instead of "/doc", example: Template:YouTube/doc/ instead of Template:YouTube/doc would cause the {{Doc/subpage}} (documentation subpage) notice to not show up at all, unless it is "doc", without slash after it. --Kr0tchet (talk) 14:35, 29 Aug 2023

That's related to its working principle. {{Doc/subpage}} will try to check if the {{SUBPAGENAME}} is doc, or language suffixes (en, eo, de, ...). about, preload are also valid value.

  • If {{SUBPAGENAME}} is valid value, {{Doc/subpage}} will display the notice.
  • If it is not, the template will display nothing. --1416006136 (talk) 17:24, 29 Aug 2023

As for the message box with a slash after the link, that may be a bug. You can use the button "Create" to the right top to create page. --1416006136 (talk) 17:43, 29 Aug 2023

The bug should be fixed now. I have changed the parameter {{{pref}}} of {{Uselang}}. --1416006136 (talk) 18:22, 29 Aug 2023

Yea it's looking good now. --Kr0tchet (talk) 11:36, 30 Aug 2023