start

# Localisation Guide

This is being migrated from http://translate.sourceforge.net/doc

## Introduction

If you would like to help expand this document then please take a quick look at our editing guidelines.

The general aim of this document is not to replace other well written works but to draw them together. So for instance the section on projects contains information that should help you get started and point you to the documents that are often hard to find. The section of translation should provide a general enough overview of common mistakes and pitfalls. We have found the localisation community very fragmented and hope that throught this document we can bring people together and unify information that is out there but in many many different places. The one section that we feel is unique is the guide to developers --- they make assumptions about localisation without fully understanding the implications, we complain but honestly there is not one place that can help give a developer and overview of what is needed from them, we hope that the developer section goes a long way to solving that issue.

- Purpose
- Contributing
- Credits
- Copyright

## Managing a translation effort

- Running a translateathon
- Setting direction
  - Philosophical
    - Creating project objectives
    - Golden rules
  - Automated methods
    - Message marking
    - Profiling
  - Practical
    - 1, 2, short, long
    - Let the bootup process be your guide
- Glossaries
  - Existing Glossaries
  - Creating glossaries
- Translators
  - Skills required
- Costing

## Project specific information

- Desktop Systems
  - GNOME
  - KDE
  - XFCE
- Major Applications
  - Mozilla: Firefox, Thunderbird
  - OpenOffice.org
- Distributions
  - Debian
  - Fedora/Red Hat
  - Mandriva
  - SUSE
  - Ubuntu

- The Translation Project (some parts need to move to other sections)
- Other
  - Google
  - MediaWiki (used for Wikipedia)

- Translating Manpages

## Translation

- Per language translation guidelines
- Online resource for word definitions
- When translating
  - Common translation errors with pofilter examples
  - Accelerator keys
  - Plurals
  - Variables
  - Equations
  - Program syntax and spreadsheet functions
  - Paths and example URLs
  - What bits of HTML to translate
  - Escaping
  - Casual Language
  - Capitalisation
  - Creating new words
  - Brand names
  - Program names
  - Punctuation
  - Words that you should watch out for
- British English

## Locales

- All about locales
- Resource for locale data content
- Creating locale files
  - glibc
  - OpenOffice.org
  - CLDR
  - KDE
- Patching X11 to accept your locale files

## Tools

### Translation Tools

- Choosing a translation editor
- Comparison Chart
- A list of available tools
- Online or web-based tools
- Using your spreadsheet to translate

### Glossary Tools

- Glossary creation and management

### Other tools

- Using CVS
  - Tortoise and WinCVS --- CVS applications for Windows
  - LinCVS -- cross-platform CVS front-end
- Using SVN
  - The SVN Manual
  - SVN Summary -- Command-comparison and other very useful info. for people switching from CVS
  - SVN Tips for Translators
  - svnX -- intuitive SVN front-end for Mac OSX
- Gettext hacks
- Statistics generation
- Comparing Files -- how to find changes in translations

### Working with proprietary tools

- WordFast
  - Translating PO with WordFast
  - Creating a Translation Memory with WordFast

## Fonts, characters and rendering

- Unicode
- Fonts
  - FOSS fonts
  - Microsoft Core Fonts
  - Other fonts
- Keyboards
- Rendering
  - Web-based font rendering

## Other localisation

- Language Tools
  - Spelling checkers
  - Hyphenation
  - Thesaurus
  - Automatic correction
  - Grammar checkers
- Other
  - A list of programs with application specific, non-translation, localisation requirements
  - Calenders
  - Weather applications
  - KStars

## Notes to programmers

- Other guides
  - KDE Programmer's i18n howto
- Working with Gettext
- Plurals
- Variables
- Translation comments

## WikiDịch Việt

- Hướng dẫn thân thiện

- Dự án Việt hóa Debian

- Danh sách các tập tin trong bản cài đặt Debian

- Danh sách các tập tin debconf dịch xong