Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ruby/tryruby

This 4th iteration of TryRuby is a website where you can learn the Ruby language.
https://github.com/ruby/tryruby

hacktoberfest ruby translation

Last synced: about 1 month ago
JSON representation

This 4th iteration of TryRuby is a website where you can learn the Ruby language.

Awesome Lists containing this project

README 

        
# TryRuby R4



This repo holds the source of the TryRuby website. TryRuby is a website

where you can learn the Ruby language. Starting from zero knowledge about

programming you can learn the basics of Ruby in 56 short lessons.



## Credits

Try Ruby version 1 by _why the lucky stiff_  

Try Ruby version 2 by _Andrew McElroy & David Miani_  

Try Ruby version 3 by _Eric Allam & Nick Walsh_  

Try Ruby version 4 by _Ivo Herweijer_  



This website is partially based on OpalRb.com by _Adam Beynon_.



### Translations

Spanish translation by _Jesus Gabriel y Galan_ & _Pablo García_  

Dutch translation by [_Ivo Herweijer_](https://github.com/easydatawarehousing)  

Brazilian Portuguese translation by [_Ricardo da Verdade Silva_](https://github.com/ricardovsilva)  

Japanese translation by _Koji Shimada_ & _Masayoshi Takahashi_  

Russian translation by [_Alexander Nikolaev_](https://github.com/startaper)  

Ukrainian translation by [_Andrii Palchik_](https://github.com/andriipalchik)  

Macedonian translation by [_Violeta Pavleska_](https://github.com/violeta-p)  

Chinese translation by [_Ye Junzhe_](https://github.com/McF4r) & [_Bitfox_](https://github.com/bitfoxtop) & [_Heng Li_](https://github.com/iheng)  

Turkish translation by [_Ali Rıza Şahin_](https://github.com/ARS-coding)  

French translation by [_Olivier Lacan_](https://github.com/olivierlacan) & [_Idris TAKERBOUST_](https://github.com/idrista)



Suggestions to improve translations are welcome.

If you submit a pull request updating a translation please

only change the files in folder _translations_,

not the json files in folder _source_.

These files will be updated automatically by the build/publish task.



## Frontend website

The TryRuby is kind of unique in a way, that it is a frontend application created

in Ruby with [Opal](https://opalrb.com/). The source code for this application is

located in `app` directory.



## Docker

You can deploy the website using docker by running the following commands:

```

# creating the image

docker build -f Dockerfile . -t tryruby

# running the image, you can access tryruby on http://localhost:9099

docker run -p 9099:4567 -d tryruby:latest

```



## Preparing

Clone this repo, and use bundler to get dependencies:



    $ bundle install



The website is built using middleman. Livereload is enabled.



Note: to install the 'eventmachine' gem a ruby development environment needs to

be present. You may need to run something like:



    $ sudo apt-get install ruby2.3-dev



## Run development website



    $ bin/middleman server



Then visit `http://localhost:4567`.



## Publishing



    $ bin/rake publish



Git branch 'gh-pages' now holds the publishable version of TryRuby, accessible

via [try.ruby-lang.org/](https://try.ruby-lang.org/).



## Translators

When adding a new translation: see the README file in /translations.



## Why

See the website [try-ruby-version-4](https://try.ruby-lang.org/articles/try-ruby-version-4/)

for more background information on how and why this website was created.



## The MIT License



Copyright (C) 2014-2024 Ivo Herweijer



Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:



The above copyright notice and this permission notice shall be included in

all copies or substantial portions of the Software.



THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

THE SOFTWARE.