agusmakmun / agusmakmun.github.io

:coffee: Free and open-source Jekyll theme
https://agusmakmun.github.io
MIT License
444 stars 569 forks source link
github-pages jekyll jekyll-theme

My Stack Problems

This project forked and has been modified from A simple grey theme for Jekyll, and the search posts using Super Search

Demo

Features

Screenshot

Screenshot Post Page

Install & Configuration

  1. Fork this repository
  2. Edit site settings inside file of _config.yml
  3. Edit your projects at file of projects.md, _data/projects.json and inside path of _project/ (for detail project).
  4. Edit about yourself inside file of about.md

How to Use?

a. Add new Category

All categories saved inside path of category/, you can see the existed categories.

b. Add new Posts

2013-09-23-welcome-to-jekyll.md

# or

2013-09-23-welcome-to-jekyll.markdown

Inside the file of it,

---
layout: post                          # (require) default post layout
title: "Your Title"                   # (require) a string title
date: 2016-04-20 19:51:02 +0700       # (require) a post date
categories: [python, django]          # (custom) some categories, but makesure these categories already exists inside path of `category/`
tags: [foo, bar]                      # (custom) tags only for meta `property="article:tag"`
image: Broadcast_Mail.png             # (custom) image only for meta `property="og:image"`, save your image inside path of `static/img/_posts`
---

# your content post with markdown syntax goes here...

Installing in your local

Option 1:

bundle install --path vendor/bundle

bundle exec jekyll serve

Option 2: If you already installed the jekyll

bundle install
jekyll serve

Then visit the http://127.0.0.1:4000

Updating the Gemfile.lock

bundle update

Contributing

Feel free to open a bug or contribute to code!