This repository is responsible for most content visible on the website techworkerscoalition.org. The site is made with a static site generator called Jekyll in a language called Ruby.
- Install dependencies:
bundle install - Start a local server:
bundle exec jekyll serve
Open a browser to localhost:8080
If your country/city's TWC chapter is not mentioned in the website, link to it on the homepage here and if you want a local markdown page (as opposed to external link) see the other examples here.
I18n (internationalization) is made available with the jekyll-multiple-languages-plugin. When a page has a translated version available, a link will show up on the top right if you use the default_translate layout. English is the default language, while other languages have their two letter ISO code prefixed, for example TechWorkersCoalition.org/ru for Russian.
- Add new language key to en.yml
- Add two letter iso code in config. The order here determines the order shown on the page. English must be first.
- Inside the i18n directory create a
LANGUAGE/(where LANGUAGE is two letter ISO code for that language)LANGUAGE.ymlwith the language key and value in its own language, for examplees: Español
Note, only the default en.yml must contain the names of each language. The other language yml files contain just their own language key.
Each translation file, should have same version as other languages. Sometimes that is not possible, and having different versions, helps document the disparities. For example, a new city is added, but no translation is provided in Russian yet.
- Landing Page index.md
- Community Guide _i18n/en/guide.md and guide.md
- English
- Russian
- Portuguese
- Italian
- Portuguese (BR)
- Spanish (ES)