A bare-bones template to help you get started on your next blog or website.
Explore the docs 禄
View Demo
路
Report Bug
路
Request Feature
Use Watery as a reusable theme in your Jekyll site.
Gemfile
:
```ruby
gem "jekyll", "group :jekyll_plugins do gem "jekyll-feed" gem "jekyll-seo-tag" gem "jekyll-paginate" gem "jekyll-sitemap" end
2) Configure your site `_config.yml`:
```yml
theme: watery
plugins:
- jekyll-feed
- jekyll-seo-tag
- jekyll-paginate
- jekyll-sitemap
paginate: 5
paginate_path: "/page/:num/"
bundle install
bundle exec jekyll serve
Watery is published on RubyGems:
gem install watery
Ruby projects should prefer adding it to your site Gemfile
(see Quickstart above).
Watery is a minimalist, bare-bones theme for the popular JAMstack file-based CMS Jekyll that only uses the <80kb
Water.css framework (hence the name!), while still following the best practices possible for accessibility and search-engine optimization.
I created this because I wasn't able to find an up-to-date starter/skeleton theme for Jekyll. Even the default theme, Minima, uses the large Bootstrap framework.
This project is aimed towards those curious about using Jekyll for the first time, and want to build from as close to scratch as possible. Alternatively, it still has all the features required for creating a hassle-free, informational website or blog in just a few clicks.
As of November 1st, 2020, with >70 posts on Watery, the website scores a perfect 100 in Performance, Accessibility, Best Practices, and SEO on an audit with Google Lighthouse.
For an example, you can view my blog, Journal.kim/ using this theme with the Writ.css framework.
New! Change the CSS framework with a single button, thanks to Dropin Minimal CSS.
Despite Watery's minimalist nature, there are a few interesting features that have been added:
_BLANK_config.yml
to make getting up-and-running easy._pages
collection for easier organization._pages
._inclues/author.html
)base16.solarized.light
)Jekyll requires the following:
Note: Ruby 3 no longer bundles Webrick. This project declares webrick
in the Gemfile
, so bundle exec jekyll serve
will work out of the box.
See Requirements for guides and details.
gem install jekyll bundler
git clone https://github.com/brennanbrown/watery.git
cd watery
Gemfile
.bundle install
On macOS/Linux, this will regenerate Gemfile.lock
for your platform (the repo previously contained a Windows-specific lockfile). Commit the updated lockfile.
bundle exec jekyll serve
If you encounter any errors during this process, check that you have installed all the prerequisites in Requirements.
If you still have issues, see Troubleshooting.
Once you have Jekyll up-and-running, there are only a few steps needed to make this theme your own:
_BLANK_config.yml
configuration file and replace the current _config.yml
example_posts
folder in _posts
and start writing your own!_pages
to however you see fit.README.md
with information about your own project or blog.assets
folder to customize the site.switcher.js
from the assets
folder, choose another framework to use!.github/workflows/link-check.yml
and .lycheeignore
.assets/scss/sample.scss
and notes in Gemfile
comments.jekyll-paginate-v2
(not GitHub Pages鈥搒afe). See docs/PAGINATION.md
.docs/CHANGELOG.md
docs/GEM-THEME-GUIDE.md
docs/PAGINATION.md
docs/COLLECTIONS.md
Also see theme/README.md
for gem-specific consumer instructions.
There are several features that I'm still planning to create and integrate, including:
robots.txt
, asset-manifest.json
, light.css.map
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
git checkout -b feature/AmazingFeature
)git commit -m 'Add some AmazingFeature'
)git push origin feature/AmazingFeature
)Distributed under the MIT License. You can use this project however you see fit without needing to give attribution.
See LICENSE
for more information.
While creating this theme, I came across a lot of helpful and hard-to-find resources. If you'd like to dive deeper into Jekyll, check them out:
.gitignore
: https://miguelmota.com/bytes/extensive-gitignore/Water.css was created by Kognise.
Dropin Minimal CSS was created by Dohliam.