Template talk:Doc: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(automatically repair discussion (indenting will need to be done manually))
m (Reverted edits by DiscussionRepairBot (talk) to last revision by NOUG4AT)
Tag: Rollback
Line 1: Line 1:
{{Discussion page}}
{{Discussion page}}
==Default Language==
==Default Language==
nolang=1 [[User:Popcorn|Popcorn]] ([[User talk:(Popcorn)|talk]]) 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</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=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?}}


nolang [[User:Max34|Max34]] ([[User talk:(Max34)|talk]]) 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 parameter. I don't even remember why I added it.}}
{{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.}}


content [[User:1416006136|1416006136]] ([[User talk:(1416006136)|talk]]) 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}} parameter. Please add support for the parameter.}}
{{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.}}


==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|edited=11:58, 21 Feb 2023
{{Message|user=1416006136|time=11:36, 21 Feb 2023|edited=11:58, 21 Feb 2023|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.}}


…/doc/en [[User:1416006136|1416006136]] ([[User talk:(1416006136)|talk]]) 15:55, 21 Feb 2023|Unless move the English documentation to {{Code.}}
{{Message|user=1416006136|time=15:55, 21 Feb 2023|Unless move the English documentation to {{Code|…/doc/en}}.}}


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


<nowiki>{{uselang [[User:Max34|Max34]] ([[User talk:(Max34)|talk]]) 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>}}.}}
{{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>}}.}}


Any changes in plans? [[User:Amicdict|Amicdict]] ([[User talk:(Amicdict)|talk]]) 18:43, 4 Apr 2023
{{Message|user=Amicdict|time=18:43, 4 Apr 2023|Any changes in plans?}}


The new design of {{tl|Doc [[User:1416006136|1416006136]] ([[User talk:(1416006136)|talk]]) 18:18, 8 Apr 2023 looks good. But it will take some time to make these changes.
{{Message
| user = 1416006136
| time = 18:18, 8 Apr 2023
| The new design of {{tl|Doc}} looks good. But it will take some time to make these changes.
}}
}}


== {{Bug|Extra slash "/" on "Template:(Page)/doc/" does not exist.}} ==
== {{Bug|Extra slash "/" on "Template:(Page)/doc/" does not exist.}} ==


See image below.<br> [[File:Bug-Doc-template.png|512px]]<br>Beside, docs page that are created with "{{code|/doc/ [[User:Kr0tchet|Kr0tchet]] ([[User talk:(Kr0tchet)|talk]]) 14:35, 29 Aug 2023" instead of "{{code|/doc}}", example: {{code|Template:YouTube/doc/}} instead of {{code|Template:YouTube/doc}} would cause the {{t|Doc/subpage}} (documentation subpage) notice to not show up at all, unless it is "{{code|doc}}", without slash after it.
{{Message
| user = Kr0tchet
| time = 14:35, 29 Aug 2023
| See image below.<br> [[File:Bug-Doc-template.png|512px]]<br>Beside, docs page that are created with "{{code|/doc/}}" instead of "{{code|/doc}}", example: {{code|Template:YouTube/doc/}} instead of {{code|Template:YouTube/doc}} would cause the {{t|Doc/subpage}} (documentation subpage) notice to not show up at all, unless it is "{{code|doc}}", without slash after it.
}}
}}


That's related to its working principle. {{tl2|Doc/subpage [[User:1416006136|1416006136]] ([[User talk:(1416006136)|talk]]) 17:24, 29 Aug 2023 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.
{{Message
| user = 1416006136
| time = 17:24, 29 Aug 2023
| 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.
*If it is not, the template will display nothing.
}}
}}


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
{{Message
| user = 1416006136
| time = 17:43, 29 Aug 2023
| edited = 17:48, 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>
}}


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


Yea it's looking good now. [[User:Kr0tchet|Kr0tchet]] ([[User talk:(Kr0tchet)|talk]]) 11:36, 30 Aug 2023
{{Message
| user = Kr0tchet
| time = 11:36, 30 Aug 2023
| Yea it's looking good now.
}}

Revision as of 15:56, 17 June 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.

Default Language

(using Template:Message) 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 (UTC)


(using Template:Message) 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 (UTC)


(using Template:Message) 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 (UTC)

The buttons and message box can not work correctly

(using Template:Message) 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)


(using Template:Message) Unless move the English documentation to …/doc/en. --1416006136 (talk) 15:55, 21 Feb 2023 (UTC)


(using Template:Message) The problem has solved by adding new parameter, {{{default-none}}} to {{uselang}}. --1416006136 (talk) 16:17, 21 Feb 2023 (UTC)


(using Template:Message) 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 (UTC)


(using Template:Message) Any changes in plans? --Amicdict (talk) 18:43, 4 Apr 2023 (UTC)


(using Template:Message)  The new design of {{Doc}} looks good. But it will take some time to make these changes.  --1416006136 (talk) 18:18, 8 Apr 2023 (UTC)

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

(using Template:Message)  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 (UTC)


(using Template:Message)  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 (UTC)


(using Template:Message)  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 (UTC)


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


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