tldr pages
-
QuestionWhat is the precedent in this example? Contexttldr-pages client specification Important For page lookup it is highly RECOMMENDED to give precedence to the platform over the language. In other words, look for a platform under each language, before checking the next preferred language. This ensures a meaningful and correct page resolution. Here's an example of how the lookup should be done on
📝 Setup of my exampleThese are the available documentation files (TLDR pages) for the command
Main Rule: The platform has higher precedence than the language. ⚙️ Combinations of my example
Are these combinations correct? |
Beta Was this translation helpful? Give feedback.
Replies: 1 comment 7 replies
-
|
I'm having trouble parsing what the issue here is. Pages always have an English page created of them before any translation is created. Thus the example you created of German in Linux and English in Common doesn't apply. If there is a German page of a command in Common then there is an English page of the command in common. |
Beta Was this translation helpful? Give feedback.
-
|
Let me add more information and add more languages. CONTEXTIn the TLDR client specifications for the arguments of the CLI (command-line interface). I can pass the argument Arguments
LanguageImportant For page lookup it is highly RECOMMENDED to give precedence to the platform over the language. In other words, look for a platform under each language, before checking the next preferred language. This ensures a meaningful and correct page resolution. Here's an example of how the lookup should be done on
ACTUAL BEHAVIORThere are the following files in TLDR pages for te
I am testing these commands. tldr --language de --platform linux precedence-check
tldr --language de precedence-check
tldr --platform linux precedence-check
tldr --language en --platform linux precedence-check
tldr --language en precedence-check
tldr --language es --platform linux precedence-check
tldr --language es precedence-check
tldr precedence-checkIn the following table, I have the following scenarios.
QUESTIONS
|
Beta Was this translation helpful? Give feedback.
-
|
I can already say that it isn't expected behavior because |
Beta Was this translation helpful? Give feedback.
-
|
No, this is all hypothetical; the |
Beta Was this translation helpful? Give feedback.
-
|
Do whatever you want when a translation page doesn't have a corresponding english page. It's undefined behavior and needs to be fixed in the page repository.
Assuming that the user is on Linux themselves. |
Beta Was this translation helpful? Give feedback.
-
|
Thank you so much for the information. It clarifies a lot. |
Beta Was this translation helpful? Give feedback.
-
|
Also sorry. I forgot to change the a couple of words. I think I fixed it now. I had left common in the last row of the table for example. |
Beta Was this translation helpful? Give feedback.
-
|
Thank you for the update. In general, all make sense, and I got the main idea. |
Beta Was this translation helpful? Give feedback.
Do whatever you want when a translation page doesn't have a corresponding english page. It's undefined behavior and needs to be fixed in the page repository.
What is defined is this
pages.en/common/precedence-check.mdpages.de/common/precedence-check.mdpages.en/linux/precedence-check.mdpages.de/linux/precedence-check.mdAssuming that the user is on Linux themselves.