Premier destination to learn and master the Elixir programming language
Clone or download
doomspork Update lesson to mention the new @derive functionality (#1700)
* Update lesson to mention the new @derive functionality

* Update all language output
Latest commit 47af652 Jan 21, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_assets Add codealong to connect elixir to kafka through kaffe. (#1675) Jan 16, 2019
_data add distillery to lessons (#1644) Jan 15, 2019
_includes fix contributor globe icon (#1642) Dec 4, 2018
_layouts fix jekyll-assets (#1627) Nov 27, 2018
_plugins/elixir_school Merge interlang into locales (#1488) Aug 24, 2018
_posts recursion blog post (#1691) Jan 19, 2019
ar [AR] Translate index page and Update basics/basics lesson (#1557) Oct 25, 2018
bg Add .formatter.exs to documentation lessons Jan 20, 2019
bn Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
de Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
en Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
es Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
fr Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
gr Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
id Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
it Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
ja Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
ko Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
ms Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
no Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
pl Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
pt Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
ru Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
script add travis YAML + build script (#1639) Dec 3, 2018
sk Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
ta Fix broken markdown in TA translation index page May 30, 2018
th Add .formatter.exs to all languages Jan 20, 2019
tr Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
uk Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
vi Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
zh-hans Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
zh-hant Update lesson to mention the new @derive functionality (#1700) Jan 21, 2019
.gitignore fix jekyll-assets (#1627) Nov 27, 2018
.travis.yml add travis YAML + build script (#1639) Dec 3, 2018
CONTRIBUTING.md add 'gotcha' for liquid tag syntax vs. elixir tuple issue (#1638) Dec 3, 2018
GLOSSARY.md [RU] Add the 'libraries/poolboy' lesson translation (#892) Jan 5, 2017
Gemfile Update Ruby version and dependecies (#1623) Nov 26, 2018
Gemfile.lock Fix asset tag Nov 29, 2018
LICENSE Correct license placeholders Oct 2, 2018
Procfile Setup Jekyll on Heroku Nov 26, 2015
README.md Merge interlang into locales (#1488) Aug 24, 2018
Rakefile rake assets:precompile should use 'system' not 'puts' (#1678) Jan 6, 2019
_config.yml Bump for Elixir 1.8 release (#1699) Jan 20, 2019
_config_dev.yml Leverage `jekyll-assets` capabilities (#1162) Sep 23, 2017
app.json Update references to repo (#1150) Aug 21, 2017
blog.html fixes bogus link to /blog in layout (#1441) May 8, 2018
config.ru Setup Jekyll on Heroku Nov 26, 2015
contributors.html Refactor contributors.yml (#1544) Oct 11, 2018
robots.txt Add Sitemap.xml and Robots.txt Mar 16, 2016

README.md

Elixir School

Elixir School is the premier destination for people looking to learn and master the Elixir programming language.

Lessons can now be viewed at ElixirSchool.com.

Feedback and participation is strongly encouraged! Please see Contributing for more details on how to get involved.

Running

ElixirSchool.com is generated using Jekyll. To run locally you need both Ruby and Bundler installed.

  1. Install dependencies:

    $ bundle install
  2. Run Jekyll:

    $ bundle exec jekyll s
  3. Read it at http://localhost:4000

Translating

In addition to the steps above there are a few addition steps required for translation.

New Language

  1. Create a folder using the ISO language code (e.g. ja, zh-hans, es, et al) with lesson subfolders. Not sure which language code to use? Check here for the official list.
$ cd elixirschool
$ mkdir -p ja/lessons/{basics,advanced,specifics,libraries}
$ touch ja/lessons/{basics,advanced,specifics,libraries}/.gitkeep
  1. Add your language code to interlang in _data/locales/en.yml:
interlang:
 ja: Japanese
  1. Create a locale file for your new language using _data/locales/en.yml as a guide:
$ touch _data/locales/ja.yml
  1. If the new language is RTL (right-to-left) it should be added to the rtl_languages list in config.yml:
script_direction: rtl

Translated Lesson

  1. Translated lessons must include the page metadata.

    • title should be a translation of the original lesson's title.
    • version should be set to the original English version

    For example /ja/lessons/basics/basics.md:

---
title: 基本
version: 1.0.0
---

New Lessons

Contributing a new lesson? Wonderful! In addition to creating the new lesson be sure to add it to _data/contents.yml.