/CERNSummerStudentDevlog

Template for a Devlog based on Jekyll served via GitHub pages.

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Devlog Template

This is a template for a Devlog blog based on Jekyll. It can easily be deployed via GitHub to show of continuous development work, e.g., during the Google Summer of Code project.

This template is not our work but is based on Karan's devlog (source :octocat:) with modifications by Mikhail. The source code was cleaned from content and enriched with some comments to help people get set up.

The design of the devlog page uses Material Design with Roboto font.

Setup and Configuration

To set up your personal devlog you just have to clone this repository and fill it with content. Read more about using Jekyll with GitHub page on GitHub and/or Jekyll.

You should change your personal information and links to your project in _config.yml. The site title and description is also adjustable in this file.

Tracking Progress

The devlog will show progress entries grouped by categories. Each entry is prefixed with its posting date and can hold arbitrary content in Markdown format.

Have a look at the example instance instance.

Please find posting examples in the _posts directory of the gh-pages branch.

Example screenshot of the Devlog.

To start blogging, just create a file for each entry in _posts. The filename should start with the date, e.g., 2017-07-01-first_entry.md. The Front Matter holds information on the category and date.

---
date: 2017-07-01
category: week1
---

< .. content .. >

Contributing

Contributions to this template are always welcome. Please open a pull request (PR) for adding new features or fixing bugs. If you want to report a problem please use the issue tracker on GitHub.


Credits

This template was not made from scratch. We would like to give special credit to: