Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(theme-translations): Added Turkmen (tk) default theme translations #10151

Merged
merged 3 commits into from
May 21, 2024
Merged

feat(theme-translations): Added Turkmen (tk) default theme translations #10151

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
a6c1557
Added feature Turkmen language translations
ilmedova May 20, 2024
b7b53dd
Update packages/docusaurus-theme-translations/locales/tk/theme-common…
ilmedova May 20, 2024
52821c7
Updated all the plurals to meet CLDR (one + other)
ilmedova May 20, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions packages/docusaurus-theme-translations/locales/tk/plugin-ideal-image.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"theme.IdealImageMessage.404error": "404. Surat tapylmady",
"theme.IdealImageMessage.error": "Ýalňyşlyk çykdy. Gaýtadan açmak üçin basyň",
"theme.IdealImageMessage.load": "Ýüklemek üçin basyň {sizeMessage}",
"theme.IdealImageMessage.loading": "Yüklenýär...",
"theme.IdealImageMessage.offline": "Brauzeriňiz awtonom ýagdaýynda. Surat ýüklenmedi"
}
5 changes: 5 additions & 0 deletions packages/docusaurus-theme-translations/locales/tk/plugin-pwa.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"theme.PwaReloadPopup.closeButtonAriaLabel": "Ýapmak",
"theme.PwaReloadPopup.info": "Täze wersiýa elýeterli",
"theme.PwaReloadPopup.refreshButtonText": "Täzele"
}
74 changes: 74 additions & 0 deletions packages/docusaurus-theme-translations/locales/tk/theme-common.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
{
"theme.AnnouncementBar.closeButtonAriaLabel": "Ýapmak",
"theme.BackToTopButton.buttonAriaLabel": "Başyna süýşmek",
"theme.CodeBlock.copied": "Göçürildi",
"theme.CodeBlock.copy": "Göçürmek",
"theme.CodeBlock.copyButtonAriaLabel": "Bufere göçürmek",
"theme.CodeBlock.wordWrapToggle": "Setir boýy geçir",
"theme.DocSidebarItem.collapseCategoryAriaLabel": "Gapdal paneli gizle '{label}'",
"theme.DocSidebarItem.expandCategoryAriaLabel": "Gapdal paneli görkez'{label}'",
"theme.ErrorPageContent.title": "Sahypada näsazlyk ýüze çykdy.",
"theme.ErrorPageContent.tryAgain": "Gaýtadan synanyşyň",
"theme.NavBar.navAriaLabel": "Esasy",
"theme.NotFound.p1": "Gynansakda, ýüzlenen sahypaňyz tapylmady",
"theme.NotFound.p2": "Web sahypanyň dolandyryjylaryna habar bermegiňizi sizden haýyş edýäris",
"theme.NotFound.title": "Sahypa tapylmady",
"theme.TOCCollapsible.toggleButtonLabel": "Bu sahypanyň mazmuny",
"theme.admonition.caution": "duýduryş",
"theme.admonition.danger": "howp",
"theme.admonition.info": "maglumat",
"theme.admonition.note": "bellik",
"theme.admonition.tip": "maslahat",
"theme.admonition.warning": "duýduryş",
"theme.blog.archive.description": "Arhiw",
"theme.blog.archive.title": "Arhiw",
"theme.blog.paginator.navAriaLabel": "Blog sahypasynda nawigasiýa",
"theme.blog.paginator.newerEntries": "Täze ýazgylar",
"theme.blog.paginator.olderEntries": "Köne ýazgylar",
"theme.blog.post.paginator.navAriaLabel": "Blog ýazgysynyň sahypasyndaky nawigasiýa",
"theme.blog.post.paginator.newerPost": "Täze ýazgy",
"theme.blog.post.paginator.olderPost": "Köne ýazgy",
"theme.blog.post.plurals": "{count} ýazgy|{count} ýazgylar|{count} ýazgylary",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CLDR says Turkmen only has 2 cardinal forms

https://www.unicode.org/cldr/cldr-aux/charts/34/supplemental/language_plural_rules.html#:~:text=Turkmen,tk

My browser also says so:

function getLocalePluralForms(locale) {
  const AllPluralForms = ['zero','one','two','few','many','other']
  const pluralCategories = new Intl.PluralRules(locale).resolvedOptions().pluralCategories;
  pluralCategories.sort((c1,c2) => AllPluralForms.indexOf(c1) > AllPluralForms.indexOf(c2) ? 1 : -1);
  return pluralCategories;
}

const myLocale = "tr"; // Change this variable!
console.log("Plural forms for this locale are =>>> ",getLocalePluralForms(myLocale));

So, why are you using 3 plural forms?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here as you can mention plural changes its form. So 3rd form is important in this particular case.

Regarding the code snippet you provided, I have executed it before I made PR, but as I mentioned before, the plural form changes itself according to the accusative form of speech (in formal written Turkmen language, it is crucially important). That is the reason why I made it to 3 forms everywhere in the translations

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know Turkmen, but the problem is that if you provide 3 forms, the 3rd one will never ever be used by our translation system, so it's better to provide 2.

I don't think our system atm is able to handle "accusative form of speech" so please only consider the 2 CLDR "one"+"other" plural forms. It seems to be a particularity of your language that the JS Intl API is maybe not designed to solve. It is unlikely we will be able to support this in Docusaurus unless JS add support for it first 😅 .

I can't advise more what you should do exactly, but please only keep 2 plural forms. Otherwise I'll merge by just removing the last one (because it won't be used anyway so it won't change anything in terms of outcomes)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok ok, I got it, I will update it soon

"theme.blog.post.readMore": "Dowamyny okamak",
"theme.blog.post.readMoreLabel": "{title} hakda doly okamak",
"theme.blog.post.readingTime.plurals": "{readingTime} min okamak|{readingTime} min okamak|{readingTime} min okamak",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 forms instead of 3?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here plural form doesn't change itself, but as grammatically plural changes according to cases I thought it would be correct to put the 3rd form regardless of its change

"theme.blog.sidebar.navAriaLabel": "Soňky blog barada nawigasiýa",
"theme.blog.tagTitle": "\"{tagName}\" bilen {nPosts} ýazgylar",
"theme.colorToggle.ariaLabel": "Gijeki ýa-da gündizki temany saýlamak (häzirki wagtda {mode} ulanylýar)",
"theme.colorToggle.ariaLabel.mode.dark": "Gijeki tema",
"theme.colorToggle.ariaLabel.mode.light": "Gündizki tema",
"theme.common.editThisPage": "Bu sahypany üýtgetmek",
"theme.common.headingLinkTitle": "{heading} sahypa göni geçiň",
"theme.common.skipToMainContent": "Esasy mazmuna geç",
"theme.docs.DocCard.categoryDescription.plurals": "{count} element|{count} elementler|{count} elementler",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 forms instead of 3?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here also plural form doesn't change itself, but as grammatically plural changes according to cases I thought it would be correct to put the 3rd form regardless of its change

"theme.docs.breadcrumbs.home": "Baş sahypa",
"theme.docs.breadcrumbs.navAriaLabel": "Häzirki sahypa üçin nawigasiýa",
"theme.docs.paginator.navAriaLabel": "Dokument sahypasy",
"theme.docs.paginator.next": "Indiki sahypa",
"theme.docs.paginator.previous": "Öňki sahypa",
"theme.docs.sidebar.closeSidebarButtonAriaLabel": "Nawigasiýa panelini ýap",
"theme.docs.sidebar.collapseButtonAriaLabel": "Gapdal paneli ýygnamak",
"theme.docs.sidebar.collapseButtonTitle": "Gapdal paneli ýygnamak",
"theme.docs.sidebar.expandButtonAriaLabel": "Gapdal paneli giňeltmek",
"theme.docs.sidebar.expandButtonTitle": "Gapdal paneli giňeltmek",
"theme.docs.sidebar.navAriaLabel": "Dokumentleriň gapdal paneli",
"theme.docs.sidebar.toggleSidebarButtonAriaLabel": "Navigasiýa panelini üýtgetmek",
"theme.docs.tagDocListPageTitle": "\"{tagName}\" bilen {nDocsTagged} dokumentler",
"theme.docs.tagDocListPageTitle.nDocsTagged": "1-nji sahypa|{count}-nji(y) sahypa|{count}-nji(y) sahypa",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 forms instead of 3?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here plural form doesn't change itself, but as grammatically plural changes according to cases I thought it would be correct to put the 3rd form regardless of its change

"theme.docs.versionBadge.label": "Wersiýa: {versionLabel}",
"theme.docs.versions.latestVersionLinkLabel": "iň soňky wersiýa",
"theme.docs.versions.latestVersionSuggestionLabel": "Iň soňky dokumentasiýa {latestVersionLink} ({versionLabel}) sahypasynda.",
"theme.docs.versions.unmaintainedVersionLabel": "{versionLabel} wersiýasy üçin {siteTitle} dokumentleri indi goldanmaýar.",
"theme.docs.versions.unreleasedVersionLabel": "Bu {siteTitle} {versionLabel} wersiýasy üçin geljekki dokumentler.",
"theme.lastUpdated.atDate": " {date}",
"theme.lastUpdated.byUser": " {user} tarapyndan",
"theme.lastUpdated.lastUpdatedAtBy": "Soňky täzelenme{atDate}{byUser} tarapyndan",
"theme.navbar.mobileLanguageDropdown.label": "Diller",
"theme.navbar.mobileSidebarSecondaryMenu.backButtonLabel": "← Esasy menýua geç",
"theme.navbar.mobileVersionsDropdown.label": "Wersiýalar",
"theme.tags.tagsListLabel": "Tegler:",
"theme.tags.tagsPageLink": "Ähli tegleri gör",
"theme.tags.tagsPageTitle": "Tegler",
"theme.unlistedContent.message": "Bu sahypa sanawda ýok. Bu sahypa gözleg enjamlarynda indekslemezler, diňe göni baglanyşygy bolan ulanyjylar elýeterli bolar.",
"theme.unlistedContent.title": "Sanawda ýok sahypa"
}
4 changes: 4 additions & 0 deletions packages/docusaurus-theme-translations/locales/tk/theme-live-codeblock.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"theme.Playground.liveEditor": "Göni Redaktor",
"theme.Playground.result": "Netije"
}
35 changes: 35 additions & 0 deletions packages/docusaurus-theme-translations/locales/tk/theme-search-algolia.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
{
"theme.SearchBar.label": "Gözleg",
"theme.SearchBar.seeAll": "Ähli netijeleri gör ({count})",
"theme.SearchModal.errorScreen.helpText": "Internet birikmäňizi barlaň.",
"theme.SearchModal.errorScreen.titleText": "Gözleg netijelerini ýüklemek mümkin däl",
"theme.SearchModal.footer.closeKeyAriaLabel": "Escape düwmesi",
"theme.SearchModal.footer.closeText": "ýapmak",
"theme.SearchModal.footer.navigateDownKeyAriaLabel": "Aşak ok düwmesi",
"theme.SearchModal.footer.navigateText": "nawigasiýa",
"theme.SearchModal.footer.navigateUpKeyAriaLabel": "Ýokary ok düwmesi",
"theme.SearchModal.footer.searchByText": "Gözleg",
"theme.SearchModal.footer.selectKeyAriaLabel": "Enter düwmesi",
"theme.SearchModal.footer.selectText": "saýlamak",
"theme.SearchModal.noResultsScreen.noResultsText": "Sorag boýunça netijeler ýok",
"theme.SearchModal.noResultsScreen.reportMissingResultsLinkText": "Bize habar beriň.",
"theme.SearchModal.noResultsScreen.reportMissingResultsText": "Gözleg netijesi ýokmy?",
"theme.SearchModal.noResultsScreen.suggestedQueryText": "Synanyşyň",
"theme.SearchModal.placeholder": "Gözleg",
"theme.SearchModal.searchBox.cancelButtonText": "Ýatyrmak",
"theme.SearchModal.searchBox.resetButtonTitle": "Arassalamak",
"theme.SearchModal.startScreen.favoriteSearchesTitle": "Halaýanlar",
"theme.SearchModal.startScreen.noRecentSearchesText": "Gözleg taryhy ýok",
"theme.SearchModal.startScreen.recentSearchesTitle": "Soňky",
"theme.SearchModal.startScreen.removeFavoriteSearchButtonTitle": "Halaýan ýazgyny aýyrmak",
"theme.SearchModal.startScreen.removeRecentSearchButtonTitle": "Taryh ýazgysyny aýyrmak",
"theme.SearchModal.startScreen.saveRecentSearchButtonTitle": "Gözleg soragyny ýatda saklaň",
"theme.SearchPage.algoliaLabel": "Algolia tarapyndan gözleg",
"theme.SearchPage.documentsFound.plurals": "{count} dokument|{count} dokumentler|{count} dokumentler",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 forms instead of 3?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are 2, but Turkmen has six cases: nominative, (specifically definite) accusative, dative, genitive, instrumental/ablative and locative. And all the plurals are formed from -lar/ler, but it is not used when the quantity is explicit, but also plurals can also change according to these six cases. There will be one exceptional situation for accusative case that changes plural form, which makes it up to 3 forms in total.
I know why they didn't provide this information on the website link you provided, the reason for this is that in there they provided information only for the countable numbers and not the suffixes of the noun which is followed by that certain number.
And you can also mention that in the translations I provided not in all the accusative forms it changes the form, sometimes it stays the same (if compared to English, plurals in Turkmen are like 3 forms of past tenses in English, for some it changes, but for some it does not. For example: (cut, cut, cut) - does not change, (worked, worked, worked) - does not change, (write, wrote, written) - changes). That is the reason why I made it 3 forms. Because for some nouns and cases it changes the form and for some it does not.
Should I redo that according to only those situations that exactly changes the plural? Because currently they have their third form regardless if it changes or not.

"theme.SearchPage.emptyResultsTitle": "Sahypada gözleg",
"theme.SearchPage.existingResultsTitle": "\"{query}\" boýunça gözleg netijeleri",
"theme.SearchPage.fetchingNewResults": "Täze gözleg netijeleri ýüklenýär...",
"theme.SearchPage.inputLabel": "Gözleg",
"theme.SearchPage.inputPlaceholder": "Gözleg sözbaşysyny ýazyň",
"theme.SearchPage.noResultsText": "Sorag boýunça hiç zat tapylmady"
}
Loading