Rails Girls Guide の邦訳です。
翻訳に参加する場合は、issue を開いて、どの部分を翻訳しているかを書きましょう。翻訳が終わって push したら issue を close します。
Rails Girls Tokyo 開催に向けて話しあうメーリングリストは https://groups.google.com/forum/#!forum/rails-girls-tokyo です。ML は公開していないので、参加リクエストをください。
Rails Girls JP (Japanese) のサイトを編集したい場合は、このリポジトリの "Fork" ボタンをクリックして fork してください。以下の手順でローカルにファイルをダウンロードし、環境をつくります。
$ git clone [email protected]:YOURNAME/railsgirls.jp.git
$ cd railsgirls.jp
$ bundle install
閲覧する場合は、以下の手順で Web サーバを起動し、ブラウザから http://localhost:4000 へアクセスします。
$ bundle exec jekyll serve --watch
各コンテンツは以下で管理されています。
| ページ | 管理ディレクトリ |
|---|---|
| ガイド | _pages |
| 独自コンテンツ | _pages-jp |
| ブログ | _posts |
既存のページを編集したい場合は内容に応じて管理ディレクトリ配下をご確認ください。
$ bundle exec rake guide title="my fabulous guide"
を実行すると、YYYY-MM-DD-my-fabulous-guide.markdown というテンプレートが _pages ディレクトリに作られるので、これを編集します。_pages ディレクトリ以下のファイルは最初の部分に permalink の記述がなければ、ブログポストして扱われます。permalink がある場合は、どこかのページから permalink で指定した URL へリンクします。
独立したページを作成する場合以下の２通りの方法があります。
$ bundle exec rake directory_with_page name="something"
を実行します。この場合、something/index.html という名前でテンプレートが作られるので、これを編集します。編集完了後、Homeなどのページからリンクさせます。
$ bundle exec rake original_content title="new original content"
を実行します。
YYYY-MM-DD-new_original_content.markdown というテンプレートが _pages-jp ディレクトリに作られるので、これを編集します。Homeなどのページから permalink で指定した URL へリンクさせます。
$ bundle exec rake blog title="a cool entry"
を実行すると YYYY-MM-DD-a-cool-entry.markdown というテンプレートが _posts/blog ディレクトリに作られるので、これを編集します。
画像は images/blog におきます。
ブログエントリは markdown だけでなく、html でも書くことができます。html で書きたい場合は、post_ext オプションをつけてください。
$ bundle exec rake blog title="a cool entry" post_ext="html"
ファイルの先頭の image に設定されている画像が記事一覧に表示されます。表示したい画像のパスに変更してください。
image: /images/blog/awesome.png
pull request を送ることで、本家のページに変更依頼をすることができます。
まず、ブランチを作成し、変更をコミットします。
$ git checkout -b something_nice_branch_name
$ git add 変更したファイル
$ git commit -m "変更内容をここにコメントとして書きます"
github の自分の (fork した先の) リポジトリへ push します。
$ git push origin something_nice_branch_name
github の自分のリポジトリへブラウザでアクセスし、 "compare & pull request" ボタンを押し、内容を記述し、pull request を送ります。
みなさんのご協力に感謝します！
以下、オリジナルの README そのままです。
Our aim is to give tools for women to understand technology. The Rails Girls events do this by providing a great first experience on building the Internet.
Rails Girls was founded in end of 2010 in Helsinki. Originally intended as a onetime event, we never thought to see so many local chapters all around the world! This guide has been put together to help you get started.
You can use our materials and instructions to roll out your own workshop in your city, workplace or kitchen! Read more about Rails Girls at http://railsgirls.com
View the guides at http://guides.railsgirls.com or clone this repo and install & run jekyll
$ cd railsgirls.github.com
$ bundle install
The guides use the pygments library to do syntax highlighting. If you don't have it installed you won't be able to see the highlight sections like the following:
{% highlight %}
{% endhighlight %}
If you aren't editing the code blocks, you can safely ignore this. If you want pygments, you can follow the install instructions in the "Pygments" section.
$ bundle exec jekyll serve --watch
You might find some useful hints in this jekyll issue if it's not working as expected: Issue 503
To contribute a guide, view the instructions at http://guides.railsgirls.com/contributing
For updates and more follow @railsgirls
Official website and blog for Rails Girls movement can be found at http://railsgirls.com
Global mailing list for Rails Girls events at https://groups.google.com/group/rails-girls-team
- Karri Saarinen / @karrisaarinen / github
- Linda Liukas / @lindaliukas / github
- Vesa Vänskä / @vesan / github
- Terence Lee / @hone02 / github
..and all the other coaches and people making Rails Girls awesome. Please add yourself!