From eabb2693c04d0156691a4d4fcddff619e9eeb574 Mon Sep 17 00:00:00 2001 From: Henne Vogelsang Date: Wed, 30 Jan 2019 01:46:20 +0100 Subject: [PATCH] Move Translation docu into the wiki This doesn't need to live in the code base... --- CONTRIBUTING.md | 4 ++++ INSTALL.md | 10 ++++++++++ README.md | 19 +++--------------- TRANSLATION.md | 52 ------------------------------------------------- 4 files changed, 17 insertions(+), 68 deletions(-) delete mode 100644 TRANSLATION.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 5f321f29..42f96a0f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,6 +8,7 @@ We need your input and contributions to OSEM. In particular we seek the followin * **code**: contribute your expertise in an area by helping us expand OSEM with features/bugfixes/UX * **code editing**: fix typos, clarify language, and generally improve the quality of the content of OSEM * **ideas**: participate in an issues thread or start your own to have your voice heard +* **translations**: translate OSEM into other languages than English Read this guide on how to do that. @@ -107,6 +108,9 @@ You can access the app [localhost:3000](http://localhost:3000). Whatever you cha vagrant ssh ``` +## How to contribute translations +Please refer to our [translation guide](https://github.com/openSUSE/osem/wiki/Translation) in the wiki. + ## Want to know more? In our wiki you can find more information about what is possible in our development environment, how we work with each other on github or other topics of interest for developers. Visit us at diff --git a/INSTALL.md b/INSTALL.md index c9279bbb..39f9ce4c 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -10,6 +10,16 @@ If you never deployed a Ruby on Rails app before we **strongly** suggest you see *You should know what you do and you have been warned*. +## Versions +OSEM is an [semantic versioned](http://semver.org/) app. That means given a version number MAJOR.MINOR.PATCH we increment the: + +1. MAJOR version when we make incompatible changes, +2. MINOR version when we add functionality in a backwards-compatible manner +3. PATCH version when we make backwards-compatible bug fixes + +## Download +You can find the latest OSEM releases on our [release page](https://github.com/openSUSE/osem/releases) + ## Deploy to the cloud The easiest way to deploy OSEM is to use one of the many platform as a service providers that support ruby on rails. We have prepared OSEM to be used with [heroku](https://heroku.com). So if you have an account there, you can deploy OSEM by pressing this button: diff --git a/README.md b/README.md index 44ab2aa3..2fe87dcf 100644 --- a/README.md +++ b/README.md @@ -6,29 +6,16 @@ Deploy -# Open Source Event Manager +# Open Source Event Manager - [osem.io](https://osem.io) ![OSEM Logo](doc/osem-logo.png) An event management tool tailored to Free and Open Source Software conferences. -## Versions -OSEM is an [semantic versioned](http://semver.org/) app. That means given a version number MAJOR.MINOR.PATCH we increment the: - -1. MAJOR version when we make incompatible changes, -2. MINOR version when we add functionality in a backwards-compatible manner -3. PATCH version when we make backwards-compatible bug fixes - -## Download -You can find the latest OSEM releases on our [release page](https://github.com/openSUSE/osem/releases) - ## Installation -Please refer to [installation guide](INSTALL.md) +Please refer to our [installation guide](INSTALL.md). ## How to contribute to OSEM -Please refer to our [contributing guide](CONTRIBUTING.md) - -## How to translate OSEM into your language -Please refer to our [translation guide](TRANSLATION.md) +Please refer to our [contributing guide](CONTRIBUTING.md). ## Contact GitHub issues are the primary way for communicating about specific proposed changes to this project. If you have other questions feel free to subscribe to the [opensuse-web@opensuse.org](http://lists.opensuse.org/opensuse-web/) mailinglist, all OSEM contributors are on that list! Additionally you can use #osem channel on freenode IRC. diff --git a/TRANSLATION.md b/TRANSLATION.md deleted file mode 100644 index 3923584c..00000000 --- a/TRANSLATION.md +++ /dev/null @@ -1,52 +0,0 @@ -# Translation -We are using [Transifex](https://www.transifex.com/opensuse-community/osem/) to manage our translations. - -We are also using the _Live_ feature of Transifex. That means that all strings from OSEM instances are automatically collected and are available for translating. ->Automated collection only works if you use the API key (See at the end of this file) - -## 1. Translate - * Start translating: - - 1. Navigate to the [project's page](https://www.transifex.com/opensuse-community/osem) - 2. Click **translation** button - 3. Select **language** - 4. Select **resource** (events.opensuse.org) - -Eg. Assuming you have signed up yourself as a translator for OSEM, to translate in German, for example, you go to: https://www.transifex.com/projects/p/osem/translate/#de_DE/eventsopensuseorg/31056760 - - * Request a new language - - If you want to translate OSEM into a language that does not already exist, you can request a new language from the Transifex interface. Your request will have to be approved by an admin of the OSEM project in Transifex. - -## 2. Publish translations - * How to make translations visible (if you have the proper access): - 1. Visit https://www.transifex.com/projects/p/osem/live/#en/events.opensuse.org - 2. Click **Publish** (from right sidebar menu) - 3. Select the language(s) - 4. Click **Publish** - - * How to request to publish translated strings - - After you make sure that you have properly reviewed the newly translated strings (they need to be marked as **reviewed** otherwise they won't go live), you can open a [new issue](https://github.com/openSUSE/osem/issues/new) with the following information: - - Title: [Transifex] Publish translation for EN - - Content: Publish new reviewed strings for language EN - - (You substitute EN with the initials of the language you want to publish) - -> Note: We only publish **reviewed** translated strings - -## 3. Use translations -You can view OSEM in other languages by selecting the language you want from the language selector icon (bottom right corner). - -## 4. API key -When you run your own instance of OSEM, if you want to have the translations available you need to add the api key in the `.env.development` file: - -`OSEM_TRANSIFEX_APIKEY="cf866a61277842b39c897c5a0b5ec075"` - -## 5. Strings with dynamic contents - -Strings containing dynamic content should be tagged in the haml file with "notranslate" classes as described in: - -http://docs.transifex.com/live/webmasters/#how-to-handle-inline-block-variables