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
In addition to GitHub, you can update the website via DecapCMS for example adding new blog posts and events by going to /admin interface. For local development, visit this tutorial (run npx decap-server from a different shell)
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.
Inside _data/press.yml file, add a media entry, with date format in YYYY-MM-DD
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.
To include only certain languages, specify the exact language keys you want inside the page front matter. For example languages: ["en", 'ja']
- Landing Page index.md
- Community Guide _i18n/en/guide.md and guide.md
- English
- Russian
- Portuguese
- Italian
- Portuguese (BR)
- Spanish (ES)