Build a Jekyll blog in minutes, without touching the command line.
Switch branches/tags
Clone or download
Pull request Compare This branch is 454 commits ahead, 4 commits behind barryclark:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_includes
_layouts
_posts
assets
build
images
public
trash
.gitignore
CNAME
COPYING
Gemfile
README.md
_config.yml
about.md
categories.md
contact.md
index.html
projects.md
tags.md

README.md

MatJek

A responsive Material theme based on Materialize.css for jekyll sites.

Features

Installation

Clone or fork this repo and edit _config.yml as needed.

Configuration

Most of the configurations can be found in _config.yml. The configurations listed below are specific to MatJek. If you are not using google_tracking_id or disqus_shortname, just remove them completely.

github_profile: "github_profile_url"
user: "your_name" # Appears at sidebar
user_email: "your_email" # Appears at sidebar, remove whole variable if unwanted
contact_url: "google_form_link"
google_tracking_id: "google_analytics_ID"
disqus_shortname: "shortname_given_by_Disqus"

Edit the images in assets/res to suit your liking, but try to stick to the original resolutions.

If you would like to enable comments in a post (disqus_shortname must be provided), add this line to the front matter of the post.

comments: 1

Add tags and categories to your posts in the front matter as well. Multiple tags/categories can be assigned but need to be separated by spaces.

categories: default default2
tags: test test2

Contributing

Bug reports and pull requests are welcomed on GitHub at https://github.com/shawnteoh/matjek. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Development

To set up your environment to develop this theme, clone/fork the repo and run bundle install.

To test your theme, run bundle exec jekyll serve and open your browser at http://localhost:4000/matjek/. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

License

The theme is available as open source under the terms of the GPL v3 License.

Libraries

References