CoderDojo Japan official website integrated with Cloud-based Rails CMS (Scrivito)
Ruby HTML CSS JavaScript Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app Update CoderDojo stats based on renewal website: Aug 19, 2018
bin Prepare `bin/update` Nov 26, 2017
config Tweak URL: /docs/charter[_en] -> /charter[_en] Jul 9, 2018
db Update CoderDojo stats based on renewal website: Aug 19, 2018
docs Add instructions to get group_id by Event API #339 May 31, 2018
lib 道場を非表示にする仕組みの追加 Jun 5, 2018
log Add rails command to create application file Apr 26, 2016
public 🆕 Add CoderDojo 館林 Aug 13, 2018
scripts Add comment on which columns shows what information Feb 4, 2018
scrivito/migrate Add scrivito files by rails command Apr 26, 2016
spec skip scrivito tests when env is not set Jul 10, 2018
vendor/assets Add rails command to create application file Apr 26, 2016
.dockerignore add docker files Jul 4, 2018
.env.sample add dotenv sample Jul 4, 2018
.gitignore Ignore spec/examples.txt Nov 12, 2017
.rspec Re-initialize with RSpec 3.5.2 Jan 19, 2017
.ruby-version update Ruby 2.4.1 to 2.5.1 Apr 2, 2018
.travis.yml Remove env.global and use encrypted-long-term token in Travis Jul 27, 2018
CODE_OF_CONDUCT.md Rename: code_of_conduct -> code-of-conduct to follow URL patterns Dec 14, 2017
Dockerfile add docker files Jul 4, 2018
Gemfile add dotenv-rails gem Jul 4, 2018
Gemfile.lock add dotenv-rails gem Jul 4, 2018
LICENSE Put MIT license with the approval of @Scrivito! 🎉 Dec 14, 2016
NOTICE.md Update NOTICE.md Jan 17, 2018
README.md Update contributors in README Aug 13, 2018
Rakefile Add rails command to create application file Apr 26, 2016
config.ru Remove rack-rewrite gem; instead, redirect by JavaScript Dec 12, 2016
docker-compose.yml add docker files Jul 4, 2018

README.md

Cover

CoderDojo Japan

Build Status

一般社団法人 CoderDojo Japan の公式サイトです。Ruby on Rails で実装されています。

開発に参加するには?

coderdojo.jp の開発には以下のいずれかの方法で参加できます。Dojo 情報の修正やドキュメントの追加・執筆であれば、ブラウザだけで参加できます。

  1. Dojo 情報やドキュメントの修正 (ブラウザのみ)
  2. CoderDojo Kata の執筆・編集 (ブラウザ + ユーザー登録)
  3. 新機能の開発やデザインの改善 (各種ツールのセットアップ)

新機能の開発やデザインの改善には開発環境が必要ですが、ちょっとした文言の追記・修正であればブラウザだけで参加できるようになっているのが特徴です 📝💨 それぞれの参加方法は次のとおりです。

1. Dojo 情報やドキュメントの修正

Dojo 情報は以下の手順で簡単に修正できます。

  1. db/dojos.yaml を開く
  2. 画面右にある ✎ アイコン (Fork this project and edit this file) をクリックする
  3. 気になる箇所を修正し、修正内容にタイトルと説明文を付け、Propose file change をクリックする
  4. 修正内容を確認し、問題なければ Create pull request をクリックする

以上で完了です。提案された修正はメンテナーによってチェックされ、問題なければ提案された内容が反映されます。もし問題があってもメンテナー側で気付いて修正できるので、まずはお気軽に提案してみてください ;)

https://coderdojo.jp/docs にあるドキュメントの編集方法も同様です。db/docsディレクトリをブラウザで開き、修正したいファイルをクリックして、修正内容を提案してください。同ディレクトページの右上にある Create new file ボタンをクリックすると、新しいドキュメントの追記を提案することもできます。

2. CoderDojo Kata の執筆・編集

KataSotechsha などのいくつかのページは、Scrivito と呼ばれる CMS (コンテンツ管理サービス) で運営しています。背景や使用例については次のスライドをご参照ください。

CoderDojo を支える Rails CMS の活用事例 - Speaker Deck
https://speakerdeck.com/yasulab/case-study-rails-cms-for-coderdojo

編集方法については下記の手順書をご参考にしてください。

記事の編集手順書 - Google Drive
http://bit.ly/coderdojo-kata-edit

編集用のユーザーアカウントを発行したい場合は @yasulab までお問い合わせください。

3. 新機能の開発やデザインの改善

本サイトでは以下の技術が使われているので、それぞれのツールをセットアップします。

セットアップ方法

  1. 本リポジトリを fork 後、clone します
  2. ターミナルから $ bin/setup を実行します
  3. $ rails server でローカルサーバーを立ち上げます
  4. ブラウザから localhost:3000 にアクセスします
  5. coderdojo.jp と同様のサイトが表示できれば完了です

Dockerを利用したセットアップ方法

Dockerを利用する場合は上記ツールをインストールする必要はありません。

その代わり、Dockerをインストールする必要があります。

  1. 本リポジトリを fork 後、clone します
  2. .env.sample をコピーして .env にリネームします
  3. ターミナルから $ docker-compose up を実行します
  4. ターミナルから $ docker-compose exec rails bin/setup を実行します
  5. ブラウザから localhost:3000 にアクセスします
  6. coderdojo.jp と同様のサイトが表示できれば完了です

Development with Scrivito

Some pages require Scrivito, Professional Cloud-Based Rails CMS, such as:

  • /kata
  • /news/*
  • /sotechsha/*

CMS enables wider people to contribute to editing contents,
but on the other hand, this requires Scrivito API Keys for
engineers to join developing Scrivito-used pages like above.

If interested in developing them, contact @yasulab to get production keys (SCRIVITO_TENANT and SCRIVITO_API_KEY).

他、開発に関する資料

開発に関する資料は /docs や下記サイトにまとめてあります。必要に応じて適宜ご参照ください。

Contributors

Initially designed by @cognitom in 2015,
being developed by @YassLab team since 2016, and
had been migrated to @coderdojo-japan organization in 2017.

YassLab Logo

License

Although Scrivito gem is publishd under LGPL-3.0, the author allows us to put MIT license. 😆

Sorry for the late reply, I wanted to confer with our team.
There is no conflict in the licenses and you are welcome to use the MIT license.

So, this application can be used and modified under the MIT License! 🆗

The MIT License (MIT)

Copyright © 2012-2018 CoderDojo Japan

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.

About ICON

The icons used in the website are created by Font Awesome, licensed under SIL OFL 1.1.