Skip to content

bananaoomarang/blog

 
 

Repository files navigation

This is a clone of the qraftlabs blog at http://blog.qraftlabs.com.

This blog uses Jekyll.

Create a new blog post

rake new_post["title of the new blog post"]

Manage posts in the "Top Reads" section

To add a post to the "Top Reads" section you must add the tag featured to it. Use the pr: yaml front matter to sort its position. (e.g. pr: 1 is the top post in the section).

Add reply links to your posts

Reply links

Use yaml front-matter to add reply links to your post on Hacker News or Twitter.

Example:

---
reply:
 hn: https://news.ycombinator.com/item?id=9447536
 twitter: https://twitter.com/auth0/status/592765437634555904
---

Dealing with outdated content

To mark a post as outdated, add the outdated front matter. Aditionally, you can direct the link in the disclaimer to a specific page using the tag doc_reference, otherwise the link will go to the docs homepage.

Example:

---
outdated: true
doc_reference: https://auth0.com/docs/apiv2#!/clients/get_clients_by_id
---

Customize your post's design

Post design

Use the yaml front matter in your post to customize its design. The design variable supports the following parameters. All of these parameters are optional.

---
design:
  bg_color: Set the background color for your post's header. (You can use rgb or hex colors inside double quotes) 
  bg_merge: Set to true to merge your image with your header's background color (default is false)
  image: A url path to your posts image, it will be downsized if too big to fit inside a circle.
  image_bg_color: Set a color for the circle in wich the image is placed. Use `none` for a transparent circle. (Default is `#eaeef3`).
  image_size: Set the maximum size your image will have relative to the circle. (Default is "120%")
  image_top: Set the the top offset relative to the center of the image. (Default is "50%")
  image_left: Set the the left offset relative to the center of the image. (Default is "50%")
---

Run

  1. Make sure you have RVM or other ruby version manager installed.
  2. Enter the blog directory and make sure with ruby --version that you are running the right ruby version (.ruby-version file).
  3. Install dependencies with bundle install
  4. bundle exec jekyll serve --watch
  5. Open http://localhost:4000/blog/. Make sure you don't leave out the trailing slash (/), otherwise you will get: error

License

All the infrastracture to run this blog is open sourced under the MIT license.

The exact content of the articles (the _posts folder) is Qraftlabs Copyright.

Releases

No releases published

Packages

No packages published

Languages

  • HTML 49.3%
  • CSS 26.2%
  • Ruby 23.7%
  • Nginx 0.8%