Menu

Skim_Localization Log in to Edit

Christiaan Hofman Michael McCracken

Skim Languages

Skim currently supports the following languages:

  • English
  • Dutch
  • French (thanks to Corentin Cras-Méneur)
  • Spanish (thanks to Alejandro Cámara Iglesias)
  • German (thanks to Jonas Zimmermann)
  • Russian (thanks to Michael Krekin)
  • Italian (thanks to Mauro Mazzieri)
  • Traditional Chinese (thanks to Jim Chiu)
  • Simplified Chinese (thanks to LiFeng Zhang)
  • Polish (thanks to Adam Strzelecki)
  • Japanese (thanks to Toru Ishizaki)

If you want to help translate Skim in another language, or help with one of these languages, please contact us at the users list.

Notes for Localizers

The basic procedure to add a localization to a Cocoa application is described at Apple's Localization Tools page. The main tool to create localization is AppleGlot, which can be downloaded from that page.

An alternative is to use the tools in Localization Suite 3.0 or the iLocalize tool.

Basic Procedure for Skim Localization Using AppleGlot

  1. Use and setup AppleGlot, for details see the AppleGlot User Guide (in particular starting at page 25)
  2. Create a new AppleGlot environment for Skim, if necessary
  3. Move any previous base and localized bundles to the corresponding _Old location (_NewBase → _OldBase, _NewLoc → _OldLoc), if necessary
  4. Copy a current Skim.app bundle into _NewLoc
  5. Run Actions > Initial Pass from AppleGlot
  6. Translate the Work Glossary
  7. Run the Actions > Incremental Pass and Actions > Final Pass from AppleGlot
  8. Translate other resource files not handled by AppleGlot (see below)
  9. Try out the localized version of Skim
  10. If you commit to SVN yourself, copy the localized files inside _NewLoc to your working copy, and commit

Localizable Resources Not Handled by AppleGlot

These paths are relative to Skim.app/Contents/Resources/English.lproj/. Translating the Help files is less important, if they're not translated the English help will be used.

  • Skim Help/skim.texi and Skim Help/scripts/OpenAppDict.scpt (don't translate the .html files)
  • Credits.rtf

Notes and Tips

  • Keep copies of the previous files and bundles you translated, both the base and localized version. This may help you for incremental updates
  • You can find changes in text files (such as skim.texi) using the FileMerge application that comes with the Developer Tools, or the diff command line tool
  • To see files inside a bundle, you can choose "Show Package Contents" from the contextual menu in Finder
  • If you submit to SVN, you should copy the localized files in the SkimImporter plugin source (from Skim.app/Contents/Library/Spotlight/SkimImporter.mdimporter/Contents/Resources/<lang>.lproj/, to vendorsrc/SkimImporter/<lang>.lproj/)
  • Here is a small script to copy all files localized using AppleGlot. You should edit it with a text editor to fill in the details relevant for your setup

Basic Procedure for Skim Localization Using Localization Suite

Localization Suite 3 is required (currently in beta)

  1. The developer will prepare localization (.loc) files
  2. Open the localization .loc file(s) using Localizer.app
  3. In the Keys popup, make sure you choose Missing Keys. Also you may need to try some other settings such as Changed Keys and Problematic Keys.
  4. Make sure you Select "trunk", or otherwise all subitems, in the Bundles/Files outline
  5. Translate the strings:
    1. Select a row in the main table
    2. Edit the localized string, either double-click it in the main table or use the Separate Editor near the bottom
  6. Send the updated localization file(s) to the developer

Basic Procedure for Skim Localization Using iLocalize

Sorry, you're on your own with this one. I don't have a license for it and don't know how it works. I've been told though that it works quite well, perhaps the best of the three. But then, it's not free.


Related

Wiki: Developer_Information
Wiki: Main_Page