Book Image

GitHub Essentials

By : Achilleas Pipinellis
Book Image

GitHub Essentials

By: Achilleas Pipinellis

Overview of this book

<p><span id="description" class="sugar_field">Whether you are an experienced developer or a novice, learning to work with Version Control Systems is a must in the software development world. Git is the most popular tool for that purpose and GitHub was built around it leveraging its powers by bringing it to the web.</span></p> <p><span id="description" class="sugar_field">Starting with the basics of creating a repository you will then learn how to manage the issue tracker, the place where discussion about your project takes place. Continuing our journey we will explore how to use the wiki and write rich documentation that will accompany your project. Organization and team management will be the next stop and then onto the feature that made GitHub so well known, Pull Requests. Next we focus on creating simple web pages hosted on GitHub and lastly we explore the settings that are configurable for a user and a repository.</span></p>
Table of Contents (13 chapters)

Tips and tricks


The next tip is to use some advanced techniques that use the GitHub API.

Making use of pages metadata with Jekyll

GitHub provides some metadata when using Jekyll for GitHub Pages. This means that you can add certain keywords in the Jekyll templates and these will be rendered automatically.

For example, you could add the {{ site.github.project_title }} variable, and the project title would be filled by GitHub automatically.

Following the example in the Introduction to Jekyll section of this chapter, we will add a new post to the Jekyll site. Firstly, head over the repository directory and make sure you are in the gh-pages branch:

git checkout gh-pages

We will copy the default post to have it as a reference (the dates in your site will differ):

cp _posts/2015-08-03-welcome-to-jekyll.markdown _posts/2015-08-04- testing-github-metadata-with-jekyll.markdown

Open the new file and remove all contents, except for the following:

---
layout: post
title:  "Welcome to Jekyll!"
date:   2015-08...