Skip to content
/ jekyll-now-bs4 Public template

Jekyll Now + Bootstrap 4. For community or company blogs. Supports categories & multiple authors.

License

Notifications You must be signed in to change notification settings

ajitzero/jekyll-now-bs4

Repository files navigation

Jekyll Now + Bootstrap 4 Logo

Jekyll Now is a forkable starter template for creating a Jekyll blog by Barry Clark.

This project is a clone of barryclark/jekyll-now from this commit.

Jekyll Now with Bootstrap 4

In addition to the original features, this version includes some more features which I needed in multiple projects. Bootstrap is just handy.

Demo Link: https://ajitzero.github.io/jekyll-now-bs4/

Features

  • Uses Bootstrap 4.5.0 layout.

  • Supports categories as a collection:

    • Each category gets a /category/:name page with meta-data.
    • /category lists all categories, along with all articles under them so far.
  • Supports authors as a collection:

    • Each author gets a /authors/:name page with social links and bio.
    • /authors lists all authors. For now.
  • Includes /_data, currently used for navigation links only.

    This one isn't a "necessary" addition but allows for much freedom in the long run. Or so I think 🙌

  • Supports Profile Pictures, which falls back to a placeholder avatar with custom initials set in the author's markdown file.

  • Plugins used:

    • jekyll-paginate: Pagination as /articles/:num/
    • jekyll-mentions: Support for mentions, defaulting to Twitter.
    • jekyll-redirect-from: Support for redirecting pages. Must-have, really.
    • jekyll-gist: Supports for gists.
  • Basic styling options with Sass variables:

    • primary-light & primary-dark.
    • accent: This is the only one I've used everywhere.
  • Layout options:

    • default: Includes the navigation and footer.
    • jumbo-section: Adds a hero navigation jumbotron component from bootstrap.
    • none: For truly independent pages.
    • page: Standard go-to page template.
    • standalone: Includes default setup with <main>.

Notes

  • This is by default no longer meant for user or organisation websites, like <username/org-name>.github.io, unlike how Jekyll Now was made. However, it can be easily be made to do support that.

  • For project websites, update baseurl in _config.yml as the repository name.

    e.g. If the name of the repository is assumed to be repo then the baseurl should be set as /repo, while the website can be viewed on <username/org-name>.github.io/repo/.

  • Removed Disqus related code.

    This part can be easily restored from Jekyll Now. I don't ever use it though.

  • jekyll-avatar was added, then removed later due to this issue.

  • /articles/index.html is needed instead of a simpler /articles.md since jekyll-paginate requires an index.html file. No support for *.md 😔

Contributing

As a template, I'm adding only those features which I deem necessary. For any features you may need, raise an issue and let's discuss!

Meta

GitHub followers

Ajit Panigrahi – @AjitZero – Ping me on Twitter for any urgent queries, raise an issue for anything else.

Distributed under the MIT License. See LICENSE for more information.