Git Product home page Git Product logo

summer-of-code's Introduction

Rails Girls Summer of Code

We are using GitHub Pages for the website. You can have a look at the gh-pages branch, and the site can be found at RailsGirlsSummerOfCode.org.

Blog post requirements

Every team has to write two blog posts during the summer. The first blog post has to be done by August 16th; the second blog post should be scheduled between September 19th and October 31st.
Please add your team name to the editorial calendar next to the date you wish to publish your blog posts on; the posts will be published at 12:00pm UTC.
Note: The blog post pull request must be submitted a minimum of 24h before publishing time to allow for feedback.

How to create a new blog post

In order to add your blog post to our blog, you will go through the following steps:

  • fork our repo
  • add your blog post
  • commit and push your changes
  • send us a pull request

(By contributing, you agree to adhere to our Code of Conduct)

Forking the repo

"Forking" basically just means "making a copy"; this allows you to copy our summer-of-code repo (found here) without affecting it. Follow the instructions on forking a repo in the GitHub docs. When forking, you might be asked where you want to fork the repository to; select your own Github profile.

Run the website locally

The website is build with Jekyll. In order to see the pages on your machine you have to bundle the Gems and start jekyll.

gem install bundler
bundle
jekyll serve

then you type: localhost:4000 in your browser and ๐ŸŽ‰

Note: if your post has a future date, you will not see it when running jekyll serve; in order to view your post correctly, you have to run the jekyll command with a --future flag, like this:

jekyll serve --future

Writing your blog post

Once you have your local copy set up:

  • create a new file in the summer-of-code/blog/_posts folder (on your computer).
  • Call this file yyyy-mm-dd-your-blog-post-name.md, where yyyy-mm-dd is the publishing date for your post. Don't forget the .md extension, which stands for MarkDown.
  • Add the Jekyll header for the meta data. See any of the posts in the blog/_posts folder for an example. Include the top section including the --- lines and change the attributes where required (probably all of them except the layout attribute). The date (created_at) should be the publishing date of your post. On the twitter line, please just add your twitter handle without @ character.
  • Add all your text.
  • don't forget to save your changes ;)

Permalink

Ideally, your blog post's permalink is all lowercase letters. That's not mandatory, though, but please include the date in your blog post's permalink like so:

title: Hello World
layout: post
created_at: Sun Jul 12 2015
permalink: blog/2015-07-12-hello-world
# ...

Images

Please upload the images referenced by your blog post to the img/blog/<year> folder and name them so that they can easily be linked to your article. Uploading the images is the preferred way since externally referenced graphics may become unavailable, leaving your blog post with missing image data.

Images will be downscaled to a maximum width of approx. 600 pixels. Please do not upload images much larger than that (resize them using a very simple image manipulation tool of your choosing). As a rule of thumb: An image "heavier" than 250 kilobytes is too big.

Please add a line with image credits and be sure to respect the privacy of others when uploading photos.

Committing your changes and sending a pull request

Once you're happy with your changes, commit them:

  • git add .
  • git commit -m "your commit message"
  • git push origin gh-pages (this will push your changes to the branch gh-pages of your own fork of the summer-of-code repo on github)
  • make a pull request by navigating to your repo (http://www.github.com/your_username/summer-of-code) and your branch (gh-pages), and by clicking the "Compare & Review" button, as explained here.

summer-of-code's People

Contributors

svenfuchs avatar alicetragedy avatar anikalindtner avatar sareg0 avatar lislis avatar carpodaster avatar carladrago avatar katrin-k avatar claucece avatar anasofiapinho avatar carlad avatar jmentz avatar karla-isabel-sandoval avatar ankonym avatar roidrage avatar sakshi-keepworks avatar nada1996 avatar inescoelho avatar emkosz avatar plexus avatar fanxhe-pair avatar juliaguar avatar bastilian avatar mkalininait avatar lucaspinto avatar lipenco avatar morvenn avatar realtin avatar flyjwayur avatar floord avatar

Watchers

James Cloos avatar Adam Niedzielski avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.