Instructions for translating this site

Dictionary

The original dictionary is a file called pandunia-lekse.csv. It is in character-separated format (CSV) and the cell separator is the vertical bar "|". It includes translations to english and many other languages. All dictionaries in different languages are created from this file.

You can edit the file in Microsoft Excel, LibreOffice Calc, other spreadsheet tools and text editors.

Downloading source texts

Most of the textual contents of this website are stored in a version control system that is hosted by GitHub in here. The system maintains change history, list of contributors and other things. You can get started with GitHub by reading their guides.

GitHub offers two ways to download the contents of the version repository. Click the button that reads "Clone or download".

  1. You can download it as a ZIP file.
    • In this case you can send the files that you have updated by email to risto@pandunia.info
  2. If you are used to programming, you can clone the repository with Git.
    • In this case you can create a pull request in GitHub.

Writing in Markdown syntax

Contents of Pandunia website is written in plain-text using Markdown format. Markdown is a light-weight and easy-to-use syntax that is perfectly readable in plain-text. Read description of the Markdown syntax here or here.

Preview changes locally

Pandunia website uses Markdown-based content management system called Up for displaying the contents. You don't need to install it locally.

Instead you can use MDwiki. Just copy mdwiki.html to the same folder where pandunia texts are (index.md, navigation.md and the rest), double-click mdwiki.html to open it in your browser and you're ready!

Translating

Source language

English version is the original version of the site. Translate to your language from the English version if possible! Otherwise use another language that is up-to-date and complete.

What to translate first?

When you begin translating for a new language, start from these files.

Translating entire documents

  1. Copy the source file to the folder of the new language
    • Keep the original name! Names are in Pandunia so that contents of different language versions can be compared more easily.
  2. Translate text
  3. If translation is incomplete in the end
    • Delete untranslated text
    • or hide it between < ! - - and - - > (without spaces) so that it won't be visible in the web site

Updating translations

The best way to update translations and to translate parts of documents is to use a program that compares two files side by side. A good tool for this is BeyondCompare.

Pandunia words and sentences should be the same in both language versions, so they function as anchor points that keep the versions in the same line.

Tips