Skip to content

v8.0.0

Compare
Choose a tag to compare
@qwtel qwtel released this 16 Jul 02:50
· 785 commits to master since this release
v8.0.0

So far Hydejack has been a decent Jekyll theme, but with v8 it really starts stand out among the competition: Beautiful and unique landing pages, lazy-loading images, and experimental offline support are just the most prominent new features.

Breaking

  • The expected format for sidebar images has changed.
    A sidebar image should now be a full-screen ~16:10 image.

    Comment: The sidebar can now be fully extended on desktop, which generally requires a large landscape image to fill the entire window.
    To save bandwidth, you can blur the image on the left and right edges and save it as JPG.

  • The about and welcome layout no longer prepend the content with the author information.
    Instead, the author info can be shown by adding the <!--author--> marker to the top of the file. You can also place it anywhere else.

    Comment: Showing the author description on the top of the welcome and about layouts felt like an imposition and was a left-over from when I was developing Hydejack primarily for myself.

  • [PRO] The welcome layout no longer adds recent posts and projects to the bottom of the page. Instead, they have to be explicitly set using the <!--posts--> and <!--projects--> markers. The content_separator front matter opton is now ignored.

    Comment: The old behavior felt arbitrary, and <!--more--> wasn't a good name to be replaced with recent projects ands posts.

  • Setting the accent color and sidebar image for an entire category/tag/author is no longer possible.
    To achieve a similar effect, use Front Matter defaults instead.

    E.g. to set the accent color and image for every post in the hydejack folder, use:

    defaults:
      - scope:
          path:         hydejack
        values:
          accent_color: rgb(38,139,210)
          accent_image: /assets/img/hydejack-bg.jpg

    Comment: The code to find the color for a given page was complicated and slow (potentially iterating all categories/tags to find the right one).

Changed

  • The drawer now responds to mouse inputs.
  • The default heading font is now less bold. To restore the old behavior, edit (create if it's missing) _sass/my-variables.scss and add $font-weight-heading: 700;.
  • Hydejack now uses lazy-loading hy-img tags instead of regular img tags.
    To revert to using regular images, set hydejack.no_img in the config file to true.
  • Cookie consent is now stored as a cookie (instead of LocalStorage) and expires after 1 year.
  • Scrolling to a fragment link is now smooth.
  • Font loading now works differently, and will be cancelled on slow connections.
  • The sidebar content is now centered.
  • The sidebar will now show the site's logo, which can be set in the config file under the logo key.
  • [PRO] Updated embedded Bootstrap to v4.
  • [PRO] Project cards now throw a shadow instead of having a border.

Added

  • Pages can now have the cover key in the front matter.
    When set to true, the sidebar will be opened when visiting the page directly.
    E.g. https://hydejack.com/{:.no-push-state}

  • Added a _plugin that automatically replaces <img> tags with lazy-loading <hy-img> tags. If you don't want images to load lazily, delete or rename the _plugins folder.
    Note that this plugin will never run when building the site on GitHub Pages.

    To get the most out of this plugin, it is recommended to provide the width and height of the image, e.g.

    ![Some image](assets/img/some-img.png){:data-width="800" data-height="600"}

    This will cause hy-img to render a placeholder of 800 by 600 px, preventing the document height from changing after the image has finished loading.

  • Added experimental offline support via Service Workers. Use with care!
    For details, read the docs.

  • Added the figure CSS class, which allows images to have nicer-looking captions. E.g.

    ![An image with a caption](https://placehold.it/800x50){:.lead}
    A caption to an image.
    {:.figure}
  • Clicking on a footnote will give its corresponding text a subtle highlight.

  • [PRO] Projects can now have an optional end_date field in the front matter.
    The date is treated as the start date in this case.

Fixes

  • The back button now works in combination with fragment links.