Bay

Bay is a simple theme for Jekyll. [view live]

Inspired by dangrover.com. Current theme used at eliottvincent.com.

1. Installation
2. Website sections
   1. Header
   2. Footer
   3. Home page
   4. Blog page
3. GitHub Pages
4. Development instructions

The easiest solution is to fork this repo. If you want to start from a clean website, follow the steps below:

Create a new Jekyll website:

jekyll new mysite

Open Gemfile and replace the line:

gem "minima"

with:

gem "bay_jekyll_theme"

Open _config.yml and replace the line:

theme: minima

with:

theme: bay_jekyll_theme

or, for GitHub Pages:

remote_theme: eliottvincent/bay

Finally, install the dependencies:

bundle install

and build the website!

jekyll serve

The website will look somewhat empty at first. That's normal. Follow the next instructions to complete the header and footer components, and the home and blog pages.

Open the _config.yml file and add the following:

header:
  pages:
    - name: Home
      slug: /     # <-- index.md
    - name: Blog  # <-- blog.md
    - name: Whatever  # <-- whatever.md

Re-run jekyll serve to see the header updated.

Open the _config.yml file and add the following:

footer:
  show_powered_by: true
  contact:
    - type: email
      name: Email
      value: yourmail@domain.com
    - type: wechat
      value: YourWeChatUsername
      link: "#"
  follow:
    - type: twitter
      name: Twitter
      link: http://twitter.com/YourTwitterUsername
      username: "@YourTwitterUsername"
    - type: facebook
      name: Facebook
      link: http://facebook.com/YourFacebookUsername
    - type: linkedin
      name: LinkedIn
      link: http://linkedin.com/in/YourLinkedInUsername
    - type: github
      name: GitHub
      link: http://github.com/YourGitHubUsername
    - type: dribbble
      name: Dribbble
      link: https://dribbble.com/YourDribbbleUsername
    - type: rss
      name: RSS
      link: /feed.xml

Re-run jekyll serve to see the footer updated.

Create (or edit) the index.markdown file and add the following:

---
layout: home
profile_picture:
  src: /assets/img/profile-pic.jpg
  alt: website picture
---

<p>
  Welcome to my site!
</p>

Create blog.markdown file and add the following:

---
layout: blog
title: Blog
slug: /blog
---

This is an example of a "Blog" page, displaying a list of posts.
<br />

Your website is ready!

You can deploy your website to GitHub Pages, but you cannot use the 1-click GitHub Pages build and deploy system. The issue is that the Bay theme relies on Jekyll 4.3+ (which uses a more modern Sass processor), whereas the GitHub Pages build system uses an older version of Jekyll.

However, it's fairly easy to build and deploy your website with GitHub Actions, yet use GitHub Pages to host it.

Further explanations and instructions can be found on the official Jekyll website.

You can also refer to the .github/workflows/deploy.yml file in this repository.

bundle exec jekyll serve

gem build bay_jekyll_theme.gemspec

gem push bay_jekyll_theme-1.x.x.gem