Bay

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

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

Table of contents

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

Installation

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.

Header

Open the _config.yml file and add the following:

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

Re-run jekyll serve to see the header updated.

Footer

Open the _config.yml file and add the following:

footer:
show_powered_by: truecontact:
- type: emailname: Emailvalue: yourmail@domain.com
- type: wechatvalue: YourWeChatUsernamelink: "#"follow:
- type: twittername: Twitterlink: http://twitter.com/YourTwitterUsernameusername: "@YourTwitterUsername"
- type: facebookname: Facebooklink: http://facebook.com/YourFacebookUsername
- type: linkedinname: LinkedInlink: http://linkedin.com/in/YourLinkedInUsername
- type: githubname: GitHublink: http://github.com/YourGitHubUsername
- type: dribbblename: Dribbblelink: https://dribbble.com/YourDribbbleUsername
- type: rssname: RSSlink: /feed.xml

Re-run jekyll serve to see the footer updated.

Home page

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

---
layout: homeprofile_picture:
src: /assets/img/profile-pic.jpgalt: website picture
---
<p>Welcome to my site!</p>

Blog page

Create `blog.markdown` file and add the following:
---
layout: blogtitle: Blogslug: /blog
---
This is an example of a "Blog" page, displaying a list of posts.<br />

Your website is ready!

GitHub Pages

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.

Development

Run development instance (with hot-reload)

bundle exec jekyll serve

Build and publish the gem

Simply push and tag a new version, Github Actions will handle the rest.