diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..773419a
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+_site/
+.jekyll-cache/
\ No newline at end of file
diff --git a/Blog/404.md b/Blog/404.md
new file mode 100644
index 0000000..8930792
--- /dev/null
+++ b/Blog/404.md
@@ -0,0 +1,4 @@
+---
+layout: not-found
+permalink: 404.html
+---
diff --git a/Blog/CHANGELOG.md b/Blog/CHANGELOG.md
new file mode 100644
index 0000000..6126044
--- /dev/null
+++ b/Blog/CHANGELOG.md
@@ -0,0 +1,1243 @@
+---
+layout: page
+---
+
+# CHANGELOG
+{:.no_toc}
+
+* this list will be replaced by the toc
+{:toc .large-only}
+
+## v9.0.3
+July 9 2020
+{:.heading.post-date}
+
+* Updated print resume style
+* Updated docs for GitHub Pages
+* Slightly decreased size of dark mode icon
+* Fixed a bug that caused a GitHub Pages build to fail with an empty configuration file
+* Changed default icon so that it less resembles slashdot.org\~\~
+
+## v9.0.2
+July 7 2020
+{:.heading.post-date}
+
+* Fixed a bug that prevented the search from updating when offline is enabled
+* Fixed a bug that caused search terms to get lost during initialization
+* Fixed a bug that prevented `site.legal` from getting stored for offline during service worker installation
+* Added support to for `no-cache` param to service worker.
+
+## v9.0.1
+July 6 2020
+{:.heading.post-date}
+
+* Changing app icons has been revamped. See [this section](./docs/config.md#adding-custom-favicons-and-app-icons) in the docs.
+* Changed default icons
+* Changed default sidebar background
+* Added `jekyll-compose` defaults to config file
+* Slightly adjusted dark mode colors
+* Fixed resume layout breakpoint
+
+## v9.0.0
+July 3 2020
+{:.heading.post-date}
+
+### Major
+* Added Built-In Search Functionality
+
+ Hydejack now has its own built-in search solution, that integrates well with the existing page style and the new navbar.
+
+ The solution is entirely browser-based which means it even works while offline and doesn't depend on an 3rd party.
+ This works, because Hydejack is designed for personal sites that generally have less than 1000 pages.
+ In my testing, Jekyll build times have been a problem long before search query times.
+
+ The results of the search are surprisingly good, but have only been tested in English and (somewhat) German.
+ For better language support, I might build an integration with Algolia at some point, which has the best results,
+ but requires stable internet connection and an API key.
+ I'd be interested to hear about problems with search in other languages to determine if this is necessary.
+
+* Added Table of Contents that is prettier, sticky, and dynamic.
+
+ Adding a table of contents is part of kramdown and can be done in all versions of Hydejack.
+ However, v9 adds a dynamic version that will stick to the 3rd column on large screens and highlight the current section.
+
+ Note that this will reduce the amount of space freed up by the `no_break_layout: false` setting (otherwise the ToC would overlap with code blocks, math blocks, etc).
+
+* Added a scroll-linked navbar that disappears when scrolling down and re-appears when scrolling up.
+
+* Math support has been revamped because the old solution stopped working with Jekyll 4. Hydejack now supports both KaTeX and MathJax.
+
+ The MathJax implementation is more similar to the old solution. It comes with a client-side runtime (MathJax in this case)
+ and works on GitHub Pages. It is the more heavy-weight of the two and doesn't work without JavaScript enabled.
+ Due to the size of the complete MathJax package, it only works partially with offline support enabled.
+
+ The KaTeX implementation has been changed to pre-render the KaTeX output during site building.
+ It _does not_ ship a client-side runtime, which is more lightweight and works _without_ JavaScript.
+ In my opinion, it is the more elegant solution, but it requires a JavaScript runtime on the machine that builds the site.
+ This means that this solution doesn't work on GitHub Pages.
+
+ You can switch between the two implementations by changing the `kramdown.math_engine` key to either `katex` or `mathjax` in your config file.
+ The KaTeX implementation also requires the `kramdown-math-katex` gem in your `Gemfile`.
+
+* Drastically improved build times through the use of `jekyll-include-cache`.
+ Most of the previous tips on [improving page build speed](hydejack/_posts/2019-02-18-improving-site-build-speed.md) should now be obsolete.
+
+* Added `grid` layout in PRO version that mirrors the `projects` layout, but for posts.
+ If you've set `image`s for your posts, it will give your blog a more modern look.
+
+### Minor
+* CSS variables are now configurable via `_data/variables.yml`. While there are other ways to change them, this has the broadest reach across HTML (`img[sizes]` attribute!), CSS and JS.
+* Many JS content features (such as `#` heading links) now work even when `hydejack.no_push_state` is enabled.
+* Linking to posts in the `home` and `post` layout now accept either paths or URLs. [Read more](docs/basics.md#adding-related-posts-to-a-post).
+* The star icons in the resume layout can now be disabled via `no_skill_icons` and `no_language_icons`.
+* Resume layout now supports the following keys: `born`, `citizenship`, and `maritalStatus`.
+* PRO only: Added `hide_dates` option to disable showing blog post dates.
+* The `blog` layout now works without pagination, simply showing all posts on a single page when the `jekyll-pagination` plugin is not found.
+* The `projects`, `resume`, and `grid` layout now make better use of large screens, by letting content expand to the right of the screen. Restore the previous , set `no_break_columns` in front matter.
+* Removed smooth scroll polyfill for Safari/Webkit as it has caused problems with sticky content.
+* Figure captions can now be added to code blocks, math blocks, and tables in addition to just images using the `.figcaption` CSS class.
+* The order of the comment section relative to the about and related posts sections can now be customized via the `hydejack.post_addons` and `hydejack.project_addons` keys. See the example `_config.yml` for more.
+* Clicking the image in the `blog` layout will now navigate to the blog post. In the PRO version it will do so with the classic "move image in place" animation.
+* Grouping projects by year can now be disabled. Use `no_groups: true` in the front matter. This also applies to the new `grid` layout and the old `list` layout.
+* hy-img has been removed and replaced with browser's native `loading=lazy` attribute
+* Now serving separate JavaScript files for old and new browsers, allowing it to take advantage of many new language features.
+* JavaScript files are now chunked, so that only what is needed is loaded on demand.
+* hy-drawer and hy-push-state have been rewritten in TypeScript and LitHTML, fixing many bugs in the process.
+* Updated to Jekyll 4.1
+* Hydejack now has a dedicated offline page that will be shown when the client is offline and tries to open a page that hasn't been cached.
+ The content of the page can be customized by creating `offline.md` file in the root with `layout: offline`, similar to `404.md`.
+* The code font can now be customized in the config file via the `font_code` key.
+
+### Design
+* Many layouts (`projects`, `resume`, `home`) will now use more space on large screens (disable via `hydejack.no_third_column`)
+* Headings now appear "oversized" on larger screens and extend to the right end of the screen (disable via `hydejack.no_large_headings`)
+* The base font size is now smaller across screen sizes (can be configured in `_sass/_variables.scss`)
+* The content width is now larger across screen sizes (can be configured in `_sass/_variables.scss`)
+* The link style has been changed to make picking accent colors easier for dark mode. It's also possible to link images now without worrying about underlines.
+* The amount of whitespace has been reduced. Previously it had been increased but it felt too much.
+* Added a [`note` class](docs/writing.md#adding-notes) that succeeds the `message` for adding auxillary content. The `message` class still exists.
+* The navbar buttons made to look more like buttons
+* Dark mode colors have been toned down a bit
+* Improved dark mode text rendering on macOS
+* The permalink style has been changed to use "#" instead of an icon.
+* Definition list now have a double colon after the definition term.
+* Changed the style of footnote links on small screens to make them easier to click.
+
+### Fixes
+* Horizontal scrolling on a code block, math black, or table can no longer accidentally open the drawer.
+* The client-side scripts are now more robust to missing HTML elements. This should ease theme customization.
+* Setting `sitemap: false` will now also add a `noindex` meta tag to prevent accidental search engine indexation.
+* Fixed back button not showing when opening in standalone mode for the first time.
+* The menu icon is now hidden when the drawer is disabled.
+* Using `no_drawer: true` is now working properly on cover pages when `no_push_state: false` is set.
+* Reduced the amount of pixels cached by the `will-change` optimization and fixed the corresponding warning in Firefox.
+
+
+## v8.5.2
+August 31 2019
+{:.heading.post-date}
+
+* Fixed breaking builds due to name collision when upgrading to 8.5
+ This is caused when using both `_plugins/jekyll-replace-imgs` and the new `jekyll-replace-img` ruby gem.
+ I recommend deleting `_plugins/jekyll-replace-imgs` when using the `jekyll-replace-img` gem.
+ Note that this is an optional plugin.
+* Fixed `nomodule` script loading for Safari 10.1
+* Fixed [#176](https://github.com/hydecorp/hydejack/issues/176)
+
+## v8.5.1
+Aug 1 2019
+{:.heading.post-date}
+
+* Fixed minification bug
+
+## v8.5.0
+Aug 1 2019
+{:.heading.post-date}
+
+### Changed
+* [PRO] The theme now matches the operating system's dark mode.
+* Scrolling down on a page with an open drawer will now close the drawer
+* Reloading a cover page after the drawer has been closed will now open the page with the drawer closed
+* Removed JavaScript-based web font swapping in favor of using `font-display: swap`
+* Darkened font color in dark mode to reduce contrast
+* Updated KaTeX to the latest version
+* Increased the durations of various animations slightly
+* Now using [`jekyll-replace-img`](https://github.com/qwtel/jekyll-replace-img) instead of custom code in `_plugins` folder
+* Added a separate, smaller JavaScript bundle for modern browsers
+
+### Added
+* Added support for figure captions on code blocks
+* Added `keybase` to social media icons
+* [PRO] There's now a forward button when using the theme as a PWA
+
+### Fixed
+* Fixed print layout when dark mode is enabled
+* Using `CSSTransformValue` correctly
+* Fixed a minor style bug for dates
+* Fixed a bug where light mode would flash when loading a page in dark mode
+* Minimal support for IE11
+
+## v8.4.0
+Mar 9 2019
+{:.heading.post-date}
+
+* Added support for `noindex` property in the front matter
+* Fixed ordering of selected projects/post in welcome layout
+* Updated dependencies
+
+## v8.3.0
+Feb 18 2019
+{:.heading.post-date}
+
+This version adds new options to increase production build speed. Read [this post](hydejack/_posts/2019-02-18-improving-site-build-speed.md) for details.
+
+### Added
+* Added `no_page_style` config option to increase site build speed.
+* Added `menu` config option to increase site build speed.
+* Copying math will now add the LaTeX source to the clipboard.
+
+### Changed
+* Upgraded KaTeX to version 0.10.0.
+
+## v8.2.0
+Feb 1 2019
+{:.heading.post-date}
+
+* Added support for custom `related_posts`
+* Removed footer from print layout
+* Increased photo size in print resume
+* Improved `welcome` layout generation performance
+* Fixed a bug that prevented scrolling to headlines with non-ascii characters (Thanks [@ForelaxX](https://github.com/ForelaxX))
+
+
+## v8.1.1
+Sep 1 2018
+{:.heading.post-date}
+
+### Fixes
+* Fixed an issue that prevented the drawer from working on iOS 10.
+* Changing the page via push state will now also update the `link[rel=canonical]` tag.
+* Changing the page via push state will now also update the `meta[name=description]` tag.
+* Fixed an issue that prevented the JS from building on Netlify.
+
+## v8.1.0
+Aug 18 2018
+{:.heading.post-date}
+
+This release adds Dark Mode for Hydejack PRO customers.
+
+### Breaking
+* Removed cookie banner from free version
+* Removed offline support from free version
+
+In an attempt to make the PRO offering more appealing, I'm removing features that arguably should have never been included in the free version.
+As software licenses go, nobody is stopping you from using the old code, but updates will no longer be included.
+
+### Changed
+* The cookies banners is now showing at the bottom of the page and its background color is no longer transparent to increase visibility
+* Changed the default syntax theme from "GitHub" to "Atom One Light"
+* Adapted `figure` CSS class to accommodate different children, not just `img`s
+* `video` tags now have a `max-width` of 100%
+* Increased margin before headings to `5rem`, up from 4
+* Increased margin of `hr` elements.
+* Cookies banner can now be enabled without using Google Analytics
+* Clicking the cookie banner "Okay" button will now fire a `hy--cookies-ok` event on `document`, so that custom analytics solutions can plug in.
+* All Google Analytics code has been removed from Hydejack's core and moved to `_includes/body/analytics.js`.
+* All Disqus code has been removed from Hydejack's core and moved to `_includes/comments.html` and `_includes/my-comments.html`.
+* Using CSS Custom Properties instead of SASS variables for certain properties to enable style customization using only CSS.
+* Added shadow to sidebar
+* Navbar is longer positioned `fixed`
+
+### Added
+* [PRO] Added Dark Mode
+* `border` CSS class
+
+
+## v8.0.0
+Jul 16 2018
+{:.heading.post-date}
+
+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 `` 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 `` and `` markers. The `content_separator` front matter opton is now ignored.
+
+ Comment: The old behavior felt arbitrary, and `` 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][ffd] instead.
+
+ E.g. to set the accent color and image for every post in the `hydejack` folder, use:
+
+ ~~~yml
+ 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. {:.no-push-state}
+
+* Added a `_plugin` that automatically replaces `` tags with lazy-loading `` 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.
+
+ ~~~md
+ ![Some image](assets/img/some-img.png){:width="800" 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](docs/advanced.md#enabling-offline-support).
+
+* Added the `figure` CSS class, which allows images to have nicer-looking captions. E.g.
+
+ ~~~md
+ ![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.
+
+[ffd]: https://jekyllrb.com/docs/configuration/#front-matter-defaults
+
+## v7.5.1
+Apr 2 2018
+{:.heading.post-date}
+
+### Changed
+* Moved from browserify to webpack
+* Updated ruby dependencies
+* Updated JS dependencies
+* Updated hy-push-state and hy-drawer to latest versions
+
+## v7.5.0
+Dec 18 2017
+{:.heading.post-date}
+
+### Added
+* Added secondary `legal` nav in footer:
+
+ ```yml
+ # file: `_config.yml`
+ legal:
+ - title: Cookies Policy
+ href: /cookies-policy/
+ - title: Foobar
+ href: https://foobar.com/
+ ```
+
+* The "heading permalink" can now be configured via `strings.yml`:
+
+ ```yml
+ # file: `_data/strings.yml`
+ permalink: Permalink
+ permalink_icon: icon-link
+ ```
+
+* Sections on resume layout can now be rearranged, e.g.:
+
+ ```yml
+ # file: `resume.md`
+ left_column:
+ - work
+ - volunteer
+ - education
+ - awards
+ - publications
+ - references
+ right_column:
+ - languages
+ - skills
+ - interests
+ ```
+
+
+### Fixed
+* Fixed a bug that caused `` tags to render as regular text ([#52](https://github.com/hydecorp/hydejack/pull/52))
+* Fixed a bug that caused Disqus to load the same thread on all pages ([#53](https://github.com/hydecorp/hydejack/pull/52))
+* Fixed a bug that prevented Disqus comments to be loaded on sites that didn't cause scroll events
+* Fixed a bug that caused Disqus to be loaded over HTTP instead of HTTPS.
+* Fixed a bug that caused an extra space in URLs ([#55](https://github.com/hydecorp/hydejack/pull/55)).
+* Comments no longer show up in the print version of the page.
+
+### Other
+* Set base font to `11pt` in print layout.
+* Set resume print layout to use 2 columns (A4 sheet)
+
+## v7.4.2
+Dec 1 2017
+{:.heading.post-date}
+
+### Fixed
+* Dramatically improved resume print layout.
+ It is now much less likely that there will be page breaks within logical units.
+* Fixed a bug that cause the page to break when setting `no_drawer`.
+* Fixed a bug that cased the "Random Posts" heading to appear, even when there are no posts to show
+
+## v7.4.1
+Nov 27 2017
+{:.heading.post-date}
+
+### Fixed
+* Fixed storing user-related data before accepting cookies.
+* Fixed tab order of cookie banner, so keyboard users can access it more easily.
+* Accepting cookies no longer causes a page reload in some browsers.
+* Fixed appearance of the okay button in the free version.
+* Menu icon now useable while the cookies banner is active.
+* Loading icon is now visible while the cookies banner is active.
+* Removed cookies banner from print layout.
+* Removed inline styles from cookie banner.
+
+## v7.4.0
+Nov 25 2017
+{:.heading.post-date}
+
+### Added
+* Allow markdown in copyright string
+* Added `theme_color` front-matter property to micro-manage the value of the the `theme-color` meta tag.
+ When not set, will use `accent_color`.
+* Added `theme_color` site setting, to set the value of `themeColor` in the app manifest.
+ When not set, will use `accent_color`.
+* Added `cookies_banner` setting:
+
+ ~~~yml
+ # file: `_config.yml`
+ hydejack:
+ cookies_banner: true
+ ~~~
+
+ Enabling this setting will show a notice at the top of the page to new visitors.
+ You can change the wording of the notice in `_data/strings.yml`
+ with the `cookies_banner.text` and `cookies_banner.okay` keys:
+
+ ~~~yml
+ # file: `_data/strings.yml`
+ cookies_banner:
+ text: This site uses cookies.
+ okay: Okay
+ ~~~
+
+### Fixed
+* Drawer no longer resizes/repaints in iOS Safari (iPhone) and Chrome for Android when the address bar autohides.
+* Fixed a bug that caused the drawer flicker/open unexpectedly when scrolling in mobile browsers.
+* Fixed how `image` works when using the `jekyll-seo-tag` plugin.
+
+### Design
+* Changed how line breaks work in resume layout
+* Changed margins of horizontals lines
+
+### Other
+* Updated docs
+* Updated posts
+
+
+## v7.3.0
+Nov 17 2017
+{:.heading.post-date}
+
+### Added
+* Allow markdown content on `projects` layout.
+* Renamed `big_project` option on projects to `featured` (`big_project` still works)
+
+### Fixed
+* Fixed default font weights
+* Fixed hard-coded `/projects/` URL in project layout
+* Link to feed.xml is only generated when using the `jekyll-feed` plugin
+
+
+## v7.2.0
+Nov 13 2017
+{:.heading.post-date}
+
+### Added
+* Added `_sass/my-variables.scss` file, which you can use to selectively override SCSS variables.
+* Font weights can now be configured via SCSS variables:
+ * `$font-weight` for normal font.
+ * `$font-weight-bold` for `strong` tags and similar.
+ * `$font-weight-heading` for headings.
+
+### Design
+* Message boxes will no longer span the full width, even with the break layout feature enabled.
+* Increased space between project card rows, so they look less like a brick wall.
+
+### Fixes
+* Reduced the draw range of the drawer on iOS, so that a larger portion of the screen is available for zooming (a11y).
+* Default images are now optimized, so they are no longer flagged by Google PageSpeed Insights and similar tools.
+* Query parameters are no longer used for cache busting.
+ Instead, the version number is no part of the file name for the CSS and JS resources.
+
+
+## v7.1.1
+Nov 3 2017
+{:.heading.post-date}
+
+### Fixes
+* Fix IE11 feature detection
+
+## v7.1.0
+Nov 2 2017
+{:.heading.post-date}
+
+### Changed
+* Renamed `no_description` to `hide_description`.
+ Since this feature isn't yet documented outside of the change log, the old name *will not* continue to work.
+* When providing images to `image`, `image.path`, `image.src`, `image.srcset` and `accent_image `,
+ it is no longer necessary to prepend the url with the `baseurl` of the site,
+ e.g. values like `accent_image: /assets/img/sidebar-bg.jpg` are now valid.
+* Limited scope of `a` and `img` styles to content areas.
+* Upgraded KaTeX to v0.8.3
+* Upgraded `jekyll-relative-links` to v5.0.1
+
+### Fixes
+* `font` and `font_heading` are now properly set when using the `no_inline_css` option [#47](https://github.com/hydecorp/hydejack/issues/47).
+* Fixed default values for `image` and `logo` that were referring to non-existing images.
+* Added missing JS dev dependencies.
+
+### Content
+* Updated documentation
+* Updated index, download, about and README pages.
+
+## v7.0.1
+Oct 27 2017
+{:.heading.post-date}
+
+### Fixes
+* Removed readme files from `assets` that would show up as pages when building on GitHub Pages [#42](https://github.com/hydecorp/hydejack/issues/42).
+* Disabled push state on Firefox for iOS
+* Changed some default settings in `_config.yml`
+
+### Content
+* Updated documentation
+
+### Removed
+* Removed outdated example script in `my-scripts.html`
+
+## v7.0.0
+Oct 24 2017
+{:.heading.post-date}
+
+### License Change
+The *free version* of Hydejack is now [GPL-3.0] licensed, which is a more restrictive license than MIT (but still *Open Source*).
+This was necessary because the two major components that make up Hydejack,
+[hy-push-state](https://hydecorp.github.io/hy-push-state/){:.external} and
+[hy-drawer](https://hydecorp.github.io/hy-drawer/){:.external},
+are now GPL licensed in turn.
+
+How will this affect you?
+* If you bought the *PRO version* you are not affected at all.
+* You can continue to use previous versions of Hydejack according to their license (MIT).
+* If you upgrade, keep the source code in a public repository and make sure you include the new `LICENSE.md` file.
+ DO NOT publish the *new code* with an *old license*.
+* If you upgrade and make changes to the source code, you are required to make those changes available to the public
+ under a GPL-3.0 compatible license.
+
+The full license text is available [here][GPL-3.0].
+You can read a summary on [tl;drLegel](https://tldrlegal.com/license/gnu-general-public-license-v3-(gpl-3)).
+
+If this change is not acceptable to you, DO NOT upgrade or consider [buying][buy] a [PRO license][PRO-license].
+
+Note that the above does not constitute legal advice.
+
+### Breaking
+This is a major release, but almost all options and APIs that were described in the docs continue to work.
+Some names have changed and are no longer mentioned in the docs, but they are still part of the code and continue to work.
+
+That being said, you should be aware of these (small) breaking changes:
+
+* The favicon is now located in `assets/icons`. To change the favicon of the page, edit `favicon.ico` (png) in the folder.
+
+* Changed the way tables work, so that they do the right thing more often.
+ Tables are now scrollable by default, but small tables are no longer stretched to span the full width.
+ Setting `scroll-table` on a larger table is sill recommended, as it will set `white-space: nowrap`.
+
+* Autogenerated ids for posts now look like `post-2017-01-01-my-title` instead of `post-2017/01/01/my-title`.
+
+* Event names described in the scripting chapter have changed from `y-push-state-*` to `hy-push-state-*`,
+ except `y-push-state-animationend`, which has been removed. See the [docs][pstate] for more.
+
+[pstate]: docs/scripts.md#registering-push-state-event-listeners
+
+### Changes
+* `image` has been renamed to `accent_image`, but `image` continues to work unless you add the `jekyll-seo-tag` plugin.
+ This change was necessary because `jekyll-seo-tag` uses the `image` keyword to set the thumbnail image of a page.
+ While it *may* be desirable to use the same image for both the sidebar and the thumbnail,
+ the new preferred way to set sidebar images is by using the `accent_image` key.
+
+* `color` has been renamed to `accent_color` to be consistent with the new `accent_image` key, but `color` continues to work.
+
+* Various options that do not make sense outside the context of Hydejack (like `no_push_state` or `no_drawer`)
+ have been moved under a common `hydejack` key. However, the old options continue to work.
+
+ ```yml
+ hydejack:
+ no_push_state: false
+ no_drawer: false
+ ```
+
+* All plugins (gems) are now optional.
+ The gem-based version of the theme no longer uses any plugins by default,
+ while the download version follow a "batteries-included" approach and enables some by default.
+
+* Links to the `/assets/` folder are no longer intercepted by the push state features,
+ which means clickable images and download links should work fine now.
+
+* Reader views in Firefox and Safari have an easier time recognizing the main content.
+
+* [Internal] No more `