Agency Jekyll Theme - Work in Progress
This is the Agency Bootstrap theme converted to a gem-based Jekyll theme. While this had been done before, (here, here, and here), these are outdated and have not been updated or maintained for years. I built this theme from the most recent Bootstrap source. I also added a lot of new features that go beyond the original theme's capabilities:
- contact form functionality powered by Formspree.io
- custom pages
- 404 page
- legal/Privacy Policy page
- Google Analytics support
- Markdown support
- custom images
- logo support (instead of just text)
- automatically updating copyright years
- custom navigation bar, even without the header image(s)
- about section (different from the timeline)
- custom footer <!-- - portfolio carousel (coming soon) -->
- custom colors with automatic gradient generation (coming soon)
- site title logo text font customization (coming soon)
The Jekyll structure of this theme includes:
_portfolio
files - what generate the portfolio grid. YAML front matter handles all the details- the
page
layout allows custom pages, as seen in the legal and 404 pages sitetext.yml
enables complete customization of all site textnav.yml
enables fully customizable navigationstyle.yml
enables fully customizable colors and background images
If you enjoy this theme, please consider supporting me to continue developing and maintaining it.
Installation
Add this line to your Jekyll site's Gemfile
:
gem "jekyll-agency"
And add this line to your Jekyll site's _config.yml
:
theme: jekyll-agency
And then execute:
$ bundle
Or install it yourself as:
$ gem install jekyll-agency
Then, replace the contents of your _config.yml
file with this.
Usage
navheader is used only for the home page. nav is used everywhere else.
Contributing
This project is intended to be a welcoming space for collaboration. If you have an idea, suggestion, feature request, etc., feel free to open an issue or pull request. For bug reports, follow the provided template.
Improvements - Up for Grabs
- multiple language support
- custom background images
Development
To set up your environment to develop this theme, clone this repo, then run bundle install
. To test the theme, run bundle exec jekyll serve
and open your browser at http://localhost:4000
. Add pages, documents, data, etc. like normal to test the theme's contents. As you make modifications, 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 MIT License.