{"id":21529161,"url":"https://github.com/everx-labs/ton-surf-localization","last_synced_at":"2025-07-26T07:13:06.056Z","repository":{"id":37803083,"uuid":"386176247","full_name":"everx-labs/TON-Surf-Localization","owner":"everx-labs","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-20T14:16:06.000Z","size":8204,"stargazers_count":3,"open_issues_count":0,"forks_count":7,"subscribers_count":7,"default_branch":"development","last_synced_at":"2025-05-14T02:52:15.770Z","etag":null,"topics":["blockchain","debots","everscale","wallet"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/everx-labs.png","metadata":{"files":{"readme":"README-en.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":"2021-07-15T05:36:03.000Z","updated_at":"2024-05-20T14:16:08.000Z","dependencies_parsed_at":"2025-04-09T23:43:25.160Z","dependency_job_id":"5ce7b0a3-03ed-4455-9f18-af9bbcfc3f14","html_url":"https://github.com/everx-labs/TON-Surf-Localization","commit_stats":null,"previous_names":["everx-labs/ton-surf-localization"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/everx-labs/TON-Surf-Localization","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everx-labs%2FTON-Surf-Localization","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everx-labs%2FTON-Surf-Localization/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everx-labs%2FTON-Surf-Localization/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everx-labs%2FTON-Surf-Localization/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/everx-labs","download_url":"https://codeload.github.com/everx-labs/TON-Surf-Localization/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/everx-labs%2FTON-Surf-Localization/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267133958,"owners_count":24040789,"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","status":"online","status_checked_at":"2025-07-26T02:00:08.937Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["blockchain","debots","everscale","wallet"],"created_at":"2024-11-24T01:56:02.331Z","updated_at":"2025-07-26T07:13:05.992Z","avatar_url":"https://github.com/everx-labs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Guide for Localization in GitHub\n\nAll localization files of the Surf app are stored on GitHub. You need a GitHub account to access them. If you haven’t previously used GitHub, please [create one](https://github.com/signup?ref_cta=Sign+up\u0026ref_loc=header+logged+out\u0026ref_page=%2F\u0026source=header-home).\n\n## Create a repository copy\n\nAll changes to the strings you make in your own repository without affecting the original TON Surf repository. This step is performed only once, you don't need to create a copy of repository every time you want to edit strings.\n\n1. Go to the [TON-Surf-Localization](https://github.com/tonlabs/TON-Surf-Localization) repository.\n   ![alt text](images/screenshot-00.png)\n2. In the upper right corner, click **Fork**.\n   ![alt text](images/screenshot-01.png)\n3. Click you local repository name. GitHub will copy the TON-Surf-Localization repository there.\n   ![alt text](images/screenshot-27.png)\n\nWell done! Now you have a copy of the TON-Surf-Localization repository and you are ready to edit string files.\n![alt text](images/screenshot-02.png)\n\nDo not close the tab. We recommend you to add this webpage to your Favourites or Bookmarks in your browser to easily revisit it later.\n\n## Switch to the right branch\n\nIt's extremely important to edit strings in the latest version of file. Otherwise, your changes can cause conflicts when merging them.\nFirst, please check the current Surf version number. Then, switch to the Github branch with the same number to get the file latest version.\n\n1. Open [Surf for Translators](https://ton-surf-translate.firebaseapp.com/). If opening for the fist time, please comply with legal requirements as described in the [Help Center](https://help.ever.surf/en/support/solutions/articles/77000236686-do-i-need-to-register-to-use-surf-).\n2. On the main screen, click the Settings icon.\n   ![alt text](images/screenshot-28.png)\n3. At the bottom of the screen, find the Surf current version number.\n   ![alt text](images/screenshot-19.png)\n4. If you closed the browser tab with your local repository on GitHub, please reopen it.\n5. Click on the branch name and enter the version number you found at [Surf for Translators](https://ton-surf-translate.firebaseapp.com/).\n   ![alt text](images/screenshot-23.png)\n6. If there is no appropriate branch in the list, create it the following way:\n   ![alt text](images/screenshot-20.png)\n   a. Enter the branch name starting from the \"surf@\" and containing the Surf version number. For example, surf@6.6.9\n   b. Click **Create branch**.\n7. Click **Fetch upstream** and click **Fetch and merge**.\n   ![alt text](images/screenshot-21.png)\n\n## Open file for edit\n\nAll localization files are stored in the **src** folder. Every localization file named according to the two-letter country code.\n![alt text](images/screenshot-24.png)\n\nYou can edit files right in GitHub or download them to your computer and edit locally.\n\n### Edit on GitHub\n\n1. In your local repository, switch to the right branch.\n2. Click the **src** folder.\n3. Click on the file you want to edit.\n4. Click the pencil icon.\n   ![alt text](images/screenshot-03.png)\n\nThe file opens in GitHub build-in editor.\n\n### Download file\n\n1. In your local repository, switch to the right branch.\n2. Click the **src** folder.\n3. Click on the file you want to edit.\n4. Right-click the **Raw** button and select **Download Linked File**.\n   ![alt text](images/screenshot-04.png)\n   The name of the context menu varies from the browser you use.\n\nFile downloaded on your computer. Now you can open it with any editor supporting JSON format. For example, VSCode or Notepad++\n\n## Check a string ID\n\nSometimes different strings can have the same translation. To know exactly what string you change, you can enable the Localization Helper in the Surf app.\n\n1. Open [Surf for Translators](https://ton-surf-translate.firebaseapp.com/).\n2. In the upper left corner, click the Surf icon.\n3. Select **Advanced settings**.\n4. Select **Language**.\n5. Click **Enable localization helper**.\n\nNow, when you put the cursor in the string, its ID is displayed above the screen.\n![alt text](images/screenshot-05.png)\n\nEvery ID consists of keys separated with commas. Knowing the string ID you can search the localization file for keys and find the string you need. For example, the string ID **TON-Surf.setup.promoCards.faq.initial** consists of the following keys:  \n![alt text](images/screenshot-25.png)\n\n## Commit changes\n\nOnce you're satisfied with your work, you can open a pull request to merge the changes in your repository into TON-Surf-Localization.\n\n1. Scroll down to the end of the file editor page.\n2. Click **Commit changes**.\n\nIf you make translations locally, copy changed strings. Then, open a file for edit in GitHub and paste changes there.\n\n## Create Pull Request\n\nPull Request allows you to merge your changes to the original repository. When creating the pull request follow these rules:\n\n-   Create one Pull Request for one language. If you edit two or more languages, create separate Pull Requests.\n-   Pull Requests are accepted only for the latest version of the application.\n\nMake sure that your changes correspond to the JSON format. You can use, for example, \u003chttps://jsonformatter.curiousconcept.com/\u003e\n\n1. Open the **Pull Requests** tab.\n   ![alt text](images/screenshot-06.png)\n2. Click **New pull request**.\n   ![alt text](images/screenshot-07.png)\n3. In the **Compare changes** section, verify you're going to commit changes to the branch of the same name.\n   ![alt text](images/screenshot-22.png)\n4. Click **Create pull request**.\n   ![alt text](images/screenshot-08.png)\n5. Enter a title and describe the changes.\n6. Tag people who you want to review these changes by mentioning their usernames, for example, @AnnStepanova. List of reviewers you can check here.\n   ![alt text](images/screenshot-09.png)\n7. Click **Create pull request**.\n\nAs you aren’t a member of Team Surf, you’ll see the following message after creating pull request:\n![alt text](images/screenshot-10.png)\nDon’t worry, people you’ve mentioned will receive notifications to review and take a look at your changes.\n\nYour changes appear in the app within a few weeks after the approval and acceptance of the Pull Request.\n\n## Subscribe to updates\n\nTo receive notifications when strings changed and you need to take part in review, you need to set up participating notifications in GitHub.\n\n1. In the upper-right corner of the page, click your profile photo, then select **Settings**.\n   ![alt text](images/screenshot-11.png)\n2. In the **Account settings** menu, select **Notifications**.\n3. ![alt text](images/screenshot-12.png)\n4. In the **Participating** section, select how you want to receive notifications: **Email** or **Web and Mobile**.\n   ![alt text](images/screenshot-13.png)\n\nNow, you never miss strings changes that require your attention. When someone @mentions your username, you get it right away: receive an email with a link to view changes or see the icon badge next to the 🔔.\n![alt text](images/screenshot-26.png)\nIf you faced problems setting notifications, you can learn more about notifications at [GitHub Docs](https://docs.github.com/en/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications).\n\n## Review and approve changes\n\nWhen someone asks you to review updated strings, you can give the green light to the changes or ask the author to improve translations.\n\n1. Open notification where you were mentioned as a reviewer.\n2. Go to the **Files changed** tab.\n   ![alt text](images/screenshot-14.png)\n3. Review edited strings. If you want to discuss changes with its author, you can leave comments by clicking **+** next to the string number.\n   ![alt text](images/screenshot-15.png)\n4. If edited strings have no mistakes, click **Review changes**.\n   ![alt text](images/screenshot-16.png)\n5. Select **Approve** and click **Submit review**.\n   ![alt text](images/screenshot-17.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feverx-labs%2Fton-surf-localization","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feverx-labs%2Fton-surf-localization","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feverx-labs%2Fton-surf-localization/lists"}