frogtek.com

This is the source code for frogtek.com website. It is based on Jekyll and deployed to Github pages.

Install/run from local

First time only

You must have ruby and bundler installed:

gem install bundler

To install all dependencies:

make install

Every time

To run the web locally on http://localhost:4000

make

To execute all tests (or HTML tests or Css tests only):

make test
make test_html
make test_css

Contributing

General rules:

• Run the tests (and fix them) before creating a pull request to master.
• Use markdown (.md) instead of HTML (.html) when possible.

Writing posts

1. Create a file on _posts folder. Follow name convention (reverse date + "slugified" title). For example: 2018-01-20-my-first-post.md
2. Add the post header (with at least title, date, author and tags):
3. Write your post (preferably in markdown)

Note that:

• The first paragraph (text until first line break) is used as excerpt in post lists
• Post images/files must be on ./assets/posts folder
• If the post is from a new author you must create his profile file into _authors folder
• To refer internal link you must use a liquid expression like: {{ site.baseurl }}/relative_url

Sample:

---
layout: post
title: My first post`
date: 2018-01-20 13:13:54.000000000 +01:00
author: guillermo
tags:
- tag1
- tag2
---
This is the excerpt of my first post.

I can use [Markdown](https://daringfireball.net/projects/markdown)

![sample image](https://media.giphy.com/media/A49qRTnZhaZDW/giphy.gif)

Include YouTube videos in posts

If you want to include a YouTube video in your post, use this snippet (change the youtube_id)

{% include youtube.html youtube_id="BoDtuEUO328" %}

Tweak site style

Put your Css on _sass folder.

Run Css tests after changes ;)

Related documentation

• Jekyll site
• About Github pages and Jekyll
• Mastering Markdown