The languages
The Bitcoin Valley site and bitmentor, the till's software, are two different things, each with its own languages. We accept translations and re-readings for both.
The Bitcoin Valley site
The site is for everyone. The lessons, the stories, the games and the map speak to anyone who wants to understand Bitcoin, wherever they live. We chose the eight languages for the tourists who most often pass through these parts.
Italian is the reference. The other languages are a starting point: each community adapts them to its currency, its laws, its words.
The translations are generic. English, Spanish or Portuguese are spoken in dozens of countries, with different currencies, tax systems and laws. A translation can't know where you are. A community that wants to use these pages adapts them: the currency of the examples, the laws, the words that Bitcoin people use where you live.
Tax
It is the part that matters most. In Italian the sheet Il fisco in negozio is written for Italy: agencies, forms, rates, deadlines.
In the other languages the same sheet starts from what holds almost everywhere:
- the price stays in your currency;
- the takings are worth their equivalent at the moment of payment;
- a refund is a new payment;
- what to keep on file.
Then comes the European part, because it matters outside Italy too. The Italian rules are at the end, closed: you open them if they interest you, and their sources are in there.
The asterisk
In the language menu an asterisk next to the name says that no native speaker has re-read that language yet. Today all of them have it except Italian: we translated them with the help of software agents, and checked them with programs and by sampling, but a translation can only be trusted by those who speak it.
Before using a language of the site with your community, have it re-read by a native speaker who uses Bitcoin: someone who knows the words their community really uses. Ask them to look above all at:
- the Bitcoin words, comparing them with Bitcoin words in their language;
- numbers, dates, the currency and signs such as quotation marks;
- sentences that sound translated, or that keep an Italian wordplay that doesn't work in their language;
- the pages for shops and the tax sheet, the first ones a shopkeeper reads.
When they have finished, write to us who they are (even just the name the community knows them by), what they re-read and what they changed. We remove the asterisk from that language only after a re-reading like that.
bitmentor, the till's software
The till, the shop's panel and the emails are made by bitmentor, the free software this site runs on. It is a project of its own, on GitHub: it can have a life of its own and speak more languages than the ones we keep for the Valley.
The till works anywhere. In Italian it has a few Italian specifics. In the other languages it is more generic, used as it is, and it can already work in any country.
You can send translations of the software to us or propose them directly on GitHub. For a language the site doesn't have, write to us: we'll send you the software's texts to translate.
The files to translate
Each language of the site has its files in a zip, in .tar.zst format: it opens with tar --zstd -xf or with a program such as PeaZip.
Inside there are:
translations/: one.pofile per page, with the Italian sentence and the translation next to it, and two.jsonfiles with the texts of the quizzes, the games and the pages made by programs;community-texts.yml: the texts of the menu, the walk and the merchant pass, one per entry, with the Italian, the English and your language. Send it back to us as it is: we put them back in their place;locale/: the site's texts in the templates and scripts (django.po,djangojs.po) and bitmentor's as the Valley uses them (bitmentor.po).
They open with any text editor or with a program for .po files, such as Poedit. You write only the translation. Leave the rest as it is:
- placeholders, such as
%(name)sor{n}; - HTML tags;
- links.
An empty translation stays in English on the site.
For a new language start from the English zip: it has Italian and English side by side. Write your language in place of the English.
The rules for translators
- Italian is the reference. If the Italian and the English say two different things, the Italian holds.
- Italian wordplay isn't translated. Write the sentence as it sounds in your language, and drop the wordplay if it doesn't work.
- Three words for the chain of blocks. “Ledger” in the lessons for beginners, “blockchain” in the pages in between, “timechain” in the technical parts.
- The names of our things are translated: the till, the merchant pass, the shop window. Proper names stay as they are: Satoshi Spritz, Comproeuro, the names of streets and institutions. No Italian words left for local colour.
- The Valley isn't an organisation. It is an idea carried forward by a group of bitcoiners, with no statute: never “association”, in any language.
- “sats” only with a number: “1,000 sats”. Otherwise write “satoshis”.
Write to us
To send us a translation, a re-reading or a mistake, for the site or for bitmentor: i18n@bitcoinvalley.eu. Write in Italian or in English and, if you can, tell us the page and the sentence.