{"id":18725767,"url":"https://github.com/binaryage/totalterminal-i18n","last_synced_at":"2025-04-12T16:25:43.660Z","repository":{"id":1583972,"uuid":"2074337","full_name":"binaryage/totalterminal-i18n","owner":"binaryage","description":"TotalTerminal internationalization","archived":false,"fork":false,"pushed_at":"2017-01-03T22:03:10.000Z","size":14862,"stargazers_count":4,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-26T10:52:17.257Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://totalterminal.binaryage.com","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/binaryage.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-07-19T20:27:45.000Z","updated_at":"2022-12-21T15:15:51.000Z","dependencies_parsed_at":"2022-08-26T21:54:13.113Z","dependency_job_id":null,"html_url":"https://github.com/binaryage/totalterminal-i18n","commit_stats":null,"previous_names":[],"tags_count":146,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryage%2Ftotalterminal-i18n","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryage%2Ftotalterminal-i18n/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryage%2Ftotalterminal-i18n/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryage%2Ftotalterminal-i18n/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/binaryage","download_url":"https://codeload.github.com/binaryage/totalterminal-i18n/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248595382,"owners_count":21130511,"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":[],"created_at":"2024-11-07T14:11:52.740Z","updated_at":"2025-04-12T16:25:43.628Z","avatar_url":"https://github.com/binaryage.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TotalFinder Internationalization ([totalfinder.binaryage.com](http://totalfinder.binaryage.com))\n\n**TotalFinder** is a plugin for Apples's Finder.app which brings tabs, dual panels and more! This project gathers localizable resources.\n\n\u003cimg src=\"http://totalfinder.binaryage.com/shared/img/totalfinder-mainshot.png\"\u003e\n\n## Do you want to translate TotalFinder into your language?\n\nTotalFinder is not an open-source, but you should be still able to easily tweak resource files and add your preferred language.\n\nThe idea is to install TotalFinder and then sym-link its `Resources` folder to the copy of this repository where you can edit it.\nWhen you are satisfied with your work, you should push your changes back to GitHub. I will then incorporate your work into next TotalFinder release.\n\nYou may want to read [TotalFinder opened for localization](http://blog.binaryage.com/totalfinder-localization/) blog post to get an idea why I like GitHub for this.\n\n## Where to start?\n\n1. Read something about git version control system. Here is [the best place to start](http://git-scm.com/documentation).\n2. Get familiar with GitHub. They have also [nice docs](http://help.github.com).\n3. Create GitHub user and don't forget to [setup your local git](http://help.github.com/mac-set-up-git) so your commits are linked to your GitHub account.\n4. See how others are working on [TotalFinder localization](http://github.com/binaryage/totalfinder-i18n/network).\n\n## The Workflow\n\n### Initial step\n\n1. [fork this project](http://help.github.com/fork-a-repo) on GitHub\n2. [clone your fork](http://help.github.com/remotes) (let's assume you have it in `~/totalfinder-i18n`)\n3. make sure you have [installed latest TotalFinder](http://totalfinder.binaryage.com/beta-changes) version\n4. `cd ~/totalfinder-i18n` and run `./dev.sh`\n\n### Development\n\n1. edit files\n2. validate your changes with `rake validate` (before first run execute `sudo gem install cmess` to install supporting library)\n3. use `./restart.sh` to restart TotalFinder to reflect your changes\n4. commit if needed - you can `./commit.sh`\n5. goto 1\n\n### Final step\n\n1. [push to github](http://help.github.com/remotes) and send a [pull request](http://help.github.com/pull-requests)\n2. (optional) run `./undev.sh` to return to unaltered TotalFinder state (this won't delete your files, it will [just unlink](totalfinder-i18n/blob/master/undev.sh) sym-linked folder)\n\n## Questions?\n\n### What encoding should I use for my files?\n\u003e Please use always UTF-8. Other encodings will probably fail to load or you will see wrong characters. If you are unsure please run `rake validate` task to check your files.\n\n### I have created MYLANGUAGE.lproj and modified string files.\u003cbr\u003eI've restarted the Finder.app, but I don't see my localization. What's wrong?\n\u003e And do you see Finder.app in MYLANGUAGE? First, double check you have MYLANGUAGE as top-most language in the `System Preferences \u003e Language \u0026 Text \u003e Language` list. Second, please note that TotalFinder is a plugin for Finder.app and it inherits preferred language from Finder.app. Finder.app does not pick MYLANGUAGE in case there is not language folder present here `/System/Library/CoreServices/Finder.app/Contents/Resources/MYLANGUAGE.lproj`. You may create empty folder by hand or you may fix this by running `sudo rake normalize` task, which will create missing folders in `/System/Library/CoreServices/Finder.app/Contents/Resources` according to language folders available in TotalFinder's Resources. Hope this helped.\n\n### How do I keep my fork in sync with [binaryage/totalfinder-i18n](http://github.com/binaryage/totalfinder-i18n)?\n\u003e You can use the automatic sync file like this:\n\n    cd /path/to/local/git/repo\n    ./sync.sh\n    \n\u003e or alternatively define new remote server pointing to my repo (which will be read-only for you). Then you may pull from it and merge it into your repo as you wish.\n\n    cd /path/to/git/local/repo\n    Initial step: `git remote add ba git://github.com/binaryage/totalfinder-i18n.git`\n    Fetch + merge: `git fetch ba \u0026\u0026 git merge ba/master`\n\n\u003e Please note that it may end in conflict if you modified same files as I did. Please consult [git docs](http://git-scm.com/documentation) how to resolve it.\n\n### I want to modify the UI. How can I compile XIB files?\n\u003e TotalFinder uses NIBs, to compile them from source XIBs please run `./compile.sh` (you have to have installed [XCode4 command line tools from Apple](http://developer.apple.com/technologies/tools/xcode.html))\n\n### May I alter dimensions in the UI to fit my language?\n\u003e Although it is possible to copy XIB into language folder and make it language-specific I prefer to keep one shared XIB file for all languages. I'm using technique for defining flexible areas to fit different languages as [described here](http://code.google.com/p/google-toolbox-for-mac/wiki/UILocalization). Please see the `TotalFinder.xib` where it is already used on several places in the Preferences Window.\n\n## Thank you!\n\nEach contributor in [http://github.com/binaryage/totalfinder-i18n/contributors](http://github.com/binaryage/totalfinder-i18n/contributors) will get a free TotalFinder license. Please note that you will appear there with delay and only if your commits are properly recognized as authored by your github's account. You have to [setup your local git user](http://help.github.com/git-email-settings) properly.\n\n**To be clear. Please note that:**\n\n1. I may not accept changes in your fork\n2. You are contributing your work under [MIT license](totalfinder-i18n/raw/master/license.txt)\n3. You may want to explore [Network Graph](http://github.com/binaryage/totalfinder-i18n/network) to see if someone has not already been working on your language\n\n#### License: [MIT-Style](totalfinder-i18n/raw/master/license.txt)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinaryage%2Ftotalterminal-i18n","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbinaryage%2Ftotalterminal-i18n","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinaryage%2Ftotalterminal-i18n/lists"}