{"id":13625177,"url":"https://github.com/dekdevy/hordes-loc","last_synced_at":"2025-04-16T06:31:56.562Z","repository":{"id":34525768,"uuid":"179952971","full_name":"dekdevy/hordes-loc","owner":"dekdevy","description":"Community driven Hordes.io string localization","archived":false,"fork":false,"pushed_at":"2024-07-25T16:33:12.000Z","size":6036,"stargazers_count":63,"open_issues_count":4,"forks_count":150,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-08-01T22:04:18.401Z","etag":null,"topics":["hordesio","iogame","localization"],"latest_commit_sha":null,"homepage":"https://hordes.io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dekdevy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-07T10:56:30.000Z","updated_at":"2024-07-25T16:33:16.000Z","dependencies_parsed_at":"2024-04-16T18:49:02.523Z","dependency_job_id":"70eff77c-6857-4852-8917-7183504316ee","html_url":"https://github.com/dekdevy/hordes-loc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekdevy%2Fhordes-loc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekdevy%2Fhordes-loc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekdevy%2Fhordes-loc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dekdevy%2Fhordes-loc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dekdevy","download_url":"https://codeload.github.com/dekdevy/hordes-loc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223700266,"owners_count":17188288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hordesio","iogame","localization"],"created_at":"2024-08-01T21:01:51.732Z","updated_at":"2024-11-08T14:30:36.513Z","avatar_url":"https://github.com/dekdevy.png","language":"JavaScript","funding_links":[],"categories":["localization"],"sub_categories":[],"readme":"# hordes-loc\n\nCommunity-driven text and localization repository for the browser game Hordes.io. This is a library of strings for all in-game text, user interface labels, game lore, item descriptions, etc.  \n\nThis repository is a public submodule of the [hordes.io](https://hordes.io) sourcecode, containing a build script to compile files found in `loc/` into individual language specific `.json` files (here are the [Russian](https://hordes.io/assets/loc/ru.json) and [German](https://hordes.io/assets/loc/de.json) files for an example). Translations for any respective language do not have to be complete, as the build script will substitute the original English text for any strings that have not been translated for the language.\n\nResources for first timers and GitHub beginners:\n* [Language codes](http://www.lingoes.net/en/translator/langcode.htm) - Pick language codes from here when introducing a new language. Ignore post-dash text.\n* [GitHub video tutorial](https://www.youtube.com/watch?v=0fKg7e37bQE)\n* [GitHub guides](https://guides.github.com/)\n* [Tutorial on updating your fork](https://github.com/KirstieJane/STEMMRoleModels/wiki/Syncing-your-fork-to-the-original-repository-via-the-browser) - Updating your repository to match the master's state.\n\n## Contributing\n\nFor your first translations, please fork the repository and start editing files that way. If everything looks good, your edits will be merged into the main repository. \n\nMake sure to read all of the comments in the files and take them seriously. Do not translate placeholder texts. Do not translate unique names. If you are unsure, cross-check with other translations to see whether a word is translated or not. For example, words like *party*, *clan*, or unique names like *Yggdrasil* will generally not be translated to make sure players can communicate effectively regarding fundamental concepts of the game. Any text which has a `$$` tag before it is also not to be translated.\n**Please make sure to add thorough and informative descriptions of your changes in the PR (Pull Request) and commit descriptions, otherwise we will likely ignore or close your PR.**\n\nNew languages and translations are always welcome, so feel free to make a PR. Any language types are welcome.\nIn order to contribute translations, simply add them to the respective files in the `loc/` directory.\nMake sure to check the build results (Github Action) after you make a Pull Request to correct any errors that may arise. Join our [Discord](https://discord.gg/hordes) if you need help.\n\nIf you want to check the status of any translation, go to [this link](https://github.com/dekdevy/hordes-loc/actions), select the first entry, select \"build (16.x)\" under the Jobs section, and finally select \"Run npm test\". This gives us the translation status of all present languages.\n```bash\nDetecting loc types...\n  Found 23 languages\nCompiling...\n  en → 534/534 100%\n  fr → 460/534  86%\n  ru → 459/534  85%\n  it → 408/534  76%\n  de → 405/534  75%\n  ...\nExporting...\n  en -\u003e en.json\n  de -\u003e de.json\n  ru -\u003e ru.json\n  ...\n```\nIf you want to check which languages are missing in a file, scroll down to the bottom of the \"Run npm test\" output.\n```bash\nFinding missing translations...\n   classes archer description → [de, tr, es]\n```\n### Examples\nLets say we want to add a German translation to some of the strings for the Archer class. We navigate to `loc/classes/archer.js`, and find: \n\n```js\nexport default {\n  // The class name\n  name: {\n    en: 'Archer',\n    ru: 'Лучник'\n  },\n  // Class description, visible during character creation\n  description: {\n    en: 'Archers deal high single target damage and bursty...',\n    ru: 'Лучники наносят высокий урон по одиночной цели и...'\n  }\n}\n```\nAll strings are contained in objects that hold translations for any amount of languages. The default language will generally be `en` for English, but any language can be added. In this case, we can see the Archers name being held in the `name: { ... }` object, and the Russian translation is already present, along with the original English text.\n\nTo add a translation entry, find your [language code](http://www.lingoes.net/en/translator/langcode.htm) (``en, de, fr...``) and include it with your translation text. For example, to add a German translation for the name \"Archer\":\n```js\n  // The class name\n  name: {\n    en: 'Archer',\n    ru: 'Лучник',\n    de: 'Jäger'\n  }\n  ```\nWe do not have to add a German translation for the `description` string (you can if you want to, of course). It is perfectly fine if the translations are incomplete as the build system will automatically resolve the incomplete translations to English.\nOnce you finished your translation, scroll down to the bottom of the page to find a button named `Commit changes`. Leave the option below as `Commit directly to the master branch` and click the button.\nNow that you're done comitting the translation, go to your fork's main page and click the button `New pull request`, add in a name for your Pull Request and click `Create Pull Request`.\nIf everything went fine and your translation passed the syntax checks, your translations will be available in future game updates.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdekdevy%2Fhordes-loc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdekdevy%2Fhordes-loc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdekdevy%2Fhordes-loc/lists"}