Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/railsgirls/guides.railsgirls.com
Rails Girls Guides
https://github.com/railsgirls/guides.railsgirls.com
hacktoberfest rails ruby tutorial
Last synced: 23 days ago
JSON representation
Rails Girls Guides
- Host: GitHub
- URL: https://github.com/railsgirls/guides.railsgirls.com
- Owner: railsgirls
- License: other
- Created: 2012-04-18T16:28:59.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2024-04-01T12:14:14.000Z (7 months ago)
- Last Synced: 2024-04-13T06:57:04.257Z (7 months ago)
- Topics: hacktoberfest, rails, ruby, tutorial
- Language: HTML
- Homepage: https://guides.railsgirls.com/
- Size: 11.1 MB
- Stars: 6,224
- Watchers: 510
- Forks: 736
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Rails Girls Guides
The purpose of Rails Girls 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 at the end of 2010 in Helsinki. Originally intended as a one-time event, we never thought to see so many chapters from all around the world! This guide will 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 https://railsgirls.com
## Quick start
View the guides at https://guides.railsgirls.com or clone this repo and install & run [jekyll](https://github.com/mojombo/jekyll)
### Installing jekyll
```
$ cd guides.railsgirls.com
```
```
$ bundle install
```
### Pygments and Code Highlighting
The guides use the [pygments](https://pygments.org/) 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](https://jekyllrb.com/docs/installation/) in the "Pygments" section.
### Coach highlights
A custom Liquid tag is available for coach notes. Add these to guides when you want the coach to explain something. Use this tag to make sure the visual element is always the same and easy to recognize.
```
{% coach %}
Add helpful text here for the coach!
{% endcoach %}
```
### Run jekyll
```
$ bundle exec jekyll server --watch
```
### Styling
Wrap keyboard shortcuts with [kbd](https://www.w3.org/wiki/HTML/Elements/kbd) HTML tag.
To make posts consistent in style use `Ctrl+C` over `CTRL-c`/`ctrl+c`
```
To shut down the server you can hit Ctrl+C
```
### Having trouble?
You might find some useful hints in this jekyll issue if it's not working as expected: [Issue 503](https://github.com/mojombo/jekyll/issues/503)
## Contributing a Guide
To contribute a guide, view the instructions at https://guides.railsgirls.com/contributing
## X
For updates and more, follow [@railsgirls](https://twitter.com/railsgirls) on X
## Website & Blog
Official website and blog for Rails Girls movement can be found at https://railsgirls.com
## E-mail list
Global mailing list for Rails Girls events can be found at https://groups.google.com/group/rails-girls-team
## Credits
* Karri Saarinen / [@karrisaarinen](https://twitter.com/karrisaarinen) / [github](https://github.com/ksaa)
* Linda Liukas / [@lindaliukas](https://twitter.com/lindaliukas) / [github](https://github.com/lindaliukas)
* Vesa Vänskä / [@vesan](https://twitter.com/vesan) / [github](https://github.com/vesan)
* Terence Lee / [@hone02](https://twitter.com/hone02) / [github](https://github.com/hone)
* Tom de Bruijn / [@tombruijn](https://mastodon.social/@tombruijn) / [GitHub](https://github.com/tombruijn)
..and all the other coaches and people making Rails Girls awesome. Please add yourself!
## LICENSE
[](https://creativecommons.org/licenses/by-sa/2.0/)