This is the HE:labs site, you can see the live site on http://helabs.com.br.

To run this project you need to have:

• Ruby 2.1.2 - You can use RVM
• Node - You can get Node via $ brew install node or on the website
• grunt-cli - You can get this via $ npm install -g grunt-cli or the Getting Started guide

1. Install the depedencies above

2. Clone the project

    $ git clone [email protected]:Helabs/helabs.github.com.git
   

3. Go into the project folder

    $ cd helabs.github.com
   

4. Install the gem dependencies

    $ bundle install
   

5. Install the grunt dependencies

    $ npm install
   

If everything goes OK, you can now run the project!

1. Start the server, this will start the jekyll server, will compile your sass files and compile your javascripts.

    $ bundle exec foreman start
   

2. Open http://localhost:4000.

If you want to test and browse website before you push it to public, use staging.

$ rake staging

Staging version of the website is available at http://staging.helabs.com.br.

You can edit the SCSS files in the sass folder. In the stylesheets folder we have just the generated files by Grunt/Compass.

Do not alter files inside the stylesheets folder and commit them, always use the sass folder.

The Git have a problem with SASS. So when you have a conflict in the generated file by SASS+Compass (stylesheets/style.css), please do not fix this conflict, just delete this conflicted file and generate a new. So you can run this:

$ git add stylesheets/style.css
$ git rebase --continue

• Check if the project exists inside _data/mvp.yml. If it's there jump to the last step.
• Put a screenshot of the project with 800x465 size and .jpg extension into the images/projects/ folder.
• Create a new entry in _data/mvp.yml with the following format:

  -
    name: project name
    url: external url for the project
    slug: an identifier for the project
    image: /images/projects/my_project.jpg
    description: Describe what the project does
    highlighted: true # if it's highlighted in the http://helabs.com.br/en/work/ page

• Open your profile page file. It's inside _posts/time. Add the project slug under projects property.

Run rake new_profile task to generate some basic structure for the "blog post" associated with your profile. The portuguese version of your profile will be found in _posts/time and the english version in _posts/team.

Use this rake task to import blogposts from http://helabs.com.br/blog/ and associate with the author profile.

$ rake import:blogposts

If you want to remove unused images use the following rake task.

$ rake prune_images

Use this carefully!!!

When you're developing you can receive the error "XMLHttpRequest cannot load http://helabs.com.br/blog/atom.xml. No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin 'http://localhost:4000' is therefore not allowed access" in the console of your browser. To fix it, you need to disable the cross origin policy.

This is how you disable in chrome:

Mac open -a Google\ Chrome --args --disable-web-security

Linux google-chrome --disable-web-security

Just remember to restart your browser without this option, if you need to navigate in others pages, since this option make your browser vulnerable.

• Thiago Gonzalez
• Mikael Carrara

This app was created and is maintained by HE:labs.