jekyll-theme-experiment

Since I started using Jekyll I have wanted to make a theme, so I have decided to create it to publish my portfolio.

Made with ♥️ by @anxhe

Your can see a demo here

Installation

You will need to have installed ruby.

Then, in a bash terminal execute the following commands:

gem install bundler jekyll

Usage

jekyll new <your-blog-name>
cd <your-blog-name>
# Gemfile
- gem "minima", "~> 2.0"
+ gem 'jekyll-theme-experiment'

bundle install

# _config.yml
theme: jekyll-theme-experiment

Replace the sample data with your own:

title: Your awesome title
description: >- # this means to ignore newlines until "baseurl:"
  Write an awesome description for your new site here. You can edit this
  line in _config.yml. It will appear in your document head meta (for
  Google search results) and in your feed.xml site description.

jekyll-theme-experiment allows you to customize the following sections in the main layout:

Add the following sample data to try it:

jekyll-theme-experiment:
  about: # optional
    avatar: https://robohash.org/experiment-avatar.png?size=300x300

  portfolio: # optional
    title: Portfolio
    # Depending of the number of projects, you will need to update $projects
    # variable in a sass file. e.g.
    # _sass/main.scss
    #
    projects:
      - name: Jekyll Theme experiment
        link: http://example.com
        github: https://github.com/anxhe/jekyll-theme-experiment
        img_relative_url: /assets/example.png

  tools: # optional
    title: Tools and Experience 
    icons:
      - relative_url: /assets/icons/bitbucket/bitbucket-original.svg

By default, jekyll generates a couple markdown files, we'll need to make a few changes:

---
layout: blog
title: blog
permalink: /blog/
---

Now we're ready, start the server:

bundle exec jekyll serve

Finally, open 127.0.0.1:4000/ in the browser, and that's it, feel free to poke around.

Taken from minima theme

This allows you to set which pages you want to appear in the navigation area and configure order of the links. For instance, to only link to the about and the portfolio page, add the following to your _config.yml:

header_pages:
  - about.md
  - portfolio.md

Contributing

Bug reports and pull requests are welcome on GitHub at github.com/anxhe/jekyll-theme-experiment/issues. 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.

Credits

License

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