Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Changed

  • Switched typescript plugin from rollup-plugin-typescript to rollup-plugin-typescript2 to be better aware of errors.
  • Adjusted typescript module to fit all conventions.
  • Updated autoprefixer, rollup, some of it's plugins, typescript and inner dependencies.
  • Regular pages (not posts) are omitted on the main index pages.
  • Explicitly hide the scroll bars inside code blocks.
  • Dropped compatibility stylesheet for old Internet Explorer versions.

Fixed

  • Fixed errors in typescript module (some interface not missing, wrong type as function parameter).
  • Fixed configuration of example site to restore demo on Hugo Themes website.

v0.3.0

Added

  • Introduced Hugo Pipes to include CSS and JavaScript files. This introduces fingerprinting (Custom stylesheets can now be placed under assets to fingerprint them as well).
  • Enable placement of favicon into assets folder to enable fingerprinting as well.
  • Updated feed template to honor the services.rss.limit setting.

Changed

  • Updated rollup, autoprefixer, fonts and inner dependencies.
  • Use local files for screenshots in changelog site.
  • Reimplemented JavaScript part in typescript for better code quality and compatibility.
  • Cleanup the build-sites.js script using template literals.
  • Replaced deprecated .Site.RSSLink with .OutputFormats.Get "RSS".
  • Changed link building to use .RelPermalink or relUrl for proper canonifyURLs behavior.
  • Updated README.md.
  • Added horizontal spacing for all code blocks.

Fixed

  • Prevent adding the pure-table CSS class to tables containing code listings. This fixes broken display of code, and allows better output of line numbers alongside code samples.
  • Generate feed from the proper input source to find all matching pages.
  • Changed CSS rule to match highlighted line in code blocks.

v0.2.2

Added

  • Created some 404 page.
  • Display README.md file in changelog site - rewritten shortcode template to support this.

Changed

  • Replaced hardcoded text in the 404 page with something freely configurable.
  • Updated rollup, autoprefixer, del-cli and inner dependencies.
  • Updated purecss and source-serif-pro font.
  • Dropped usage of now deprecated Page's .Hugo and .URL functions.
  • Rewritten terms listing to use the taxonomy pages - this avoids manual creation of links, allows usage of link titles and outputs proper taxonomy names (instead of only lowercased ones).

Fixed

  • Reintroduce left aligning of subtitle on small viewports; Prevents missplaced subtitle when no site navigation is configured.

v0.2.1

Added

  • Added new example site called changelog - displaying this file.

Changed

  • Moved old exampleSite into _sites/example, using a symlink to keep (required) exampleSite intact.
  • Updated autoprefixer.
  • Let build-example.js script pass through the exit code of hugo on error.
  • Renamed build-example.js to build-site.js.
  • Make build-site.js evaluate some commandline flag to build any site below _sites. Use e.g. npm run site -- changelog to build changelog.
  • Dropped right aligning of the subtitle on smaller viewports.
  • Changed the breakpoint size in the JavaScript to match with the CSS.

Fixed

  • Allow build-site.js script to be launched from any directory.
  • Fix spacing issues for inline code tags and leading indent of code blocks.
  • Changed the order how the grid of purecss is bundled together. Fixes issue where the responsive grid elements did not work.

v0.2.0

Added

  • Introduced showNavHeader setting which allows hiding the top navigation with title/subtitle if set to false. Tanks @mattt-b for the idea & subtle hint.
  • Introduced showEmptyPagination setting which hides the pagination if there is not enough content to paginate if set to false. Tanks @mattt-b for the idea & subtle hint.
  • Added setting showMetaDates which allows hiding the date field of posts.
  • Added build target for dist versions of assets without deleting them first. This prevents a parallel running hugo serve from getting confused.
  • Added setting showMetaLinks which allows hiding the meta info of posts.
  • Introduced new menu.meta navigation settings → meta info links for posts are now freely configurable: Names and URLs can be changed, Titles may be set, ordering (weight) can be influenced. Tanks @mattt-b for the idea & subtle hint.
  • Added meta links to taxonomy RSS feeds in the html header.

Changed

  • Option to show full content is now called showFullContent (camelCase).
  • Replaced all cond isset ($.Site.Params "foo") $.Site.Params.foo "bar" constructs with default "bar" $.Site.Params.foo.
  • Changed all relative URLs inside README.md so the demo page does not have broken links.
  • Clarified consequences when title is not set in config.
  • Set preserveTaxonomyNames to true for exampleSite/config.toml (allows to spot bugs early from improper taxonomy handling).
  • Updated autoprefixer and rollup.
  • Option to format date is now called dateFmt (camelCase).
  • Set fallback date (if dateFmt not set) to RFC822.
  • Renamed footer-content CSS class to footer.
  • Introduced navigation CSS class wrapping navigation-header and navigation-content.
  • Display of subtitle will not be right aligned anymore on small viewports.
  • Using path.Join to construct URLs - This is more robust if any part contains leading or trailing slashes.
  • Information of meta links for posts is not hardcoded anymore and can be configured using menu.meta setting.

Fixed

  • Cleaned up some minor parts (mostly whitespace and formatting issues).
  • Adjusted line below header to relate to the new header class.
  • Ensured that an empty navigation does not draw an empty navigation-content container. → This allows a site to be completely without any navigation, only one of both, or all of them.
  • Added a clearfix CSS rule to prevent display issues with sites that only use a subtitle as navigation.

v0.1.5 - 2019-03-02

Added

  • Links in the header and footer now honor and display the title attribute.

Changed

  • Using sensible URLs for the exampleSite/config.toml footer links.
  • Unified headline style outside and inside post content.
  • Updated rollup.

Fixed

  • Changed some tags to output valid html.
  • Fix cursor display for “Go to top” button.

v0.1.4 - 2019-03-02

Added

  • Ability to add custom stylesheet to the header. Thanks @dtieber for the pull request.
  • Explicit check if files exist on disk before including them (custom stylesheet, favicon) - This avoids unnecessary 404 requests.
  • Introduced this CHANGELOG.md file.

Fixed

  • Generation of URLs when BaseURL is below some subfolder. This fixes the demo preview on the Hugo themes site. Thanks @onedrawingperday for the hint and solution.

v0.1.3 - 2019-02-24

Changed

  • Updated autoprefixer, postcss-discard-comments, rollup and rollup-plugin-postcss.
  • Replaced rollup-plugin-copy with rollup-plugin-copier. The former package used deprecated build hooks from rollup.

Removed

  • Dropped postcss-advanced-variables package from the build toolchain. This allows proper linting of CSS files.

v0.1.2 - 2019-01-16

Added

  • Some screenshots.

Changed

  • Replaced trash-cli package with del-cli for the build toolchain.
  • Using recommended url inside the exampleSite/config.toml.
  • Updated source-sans-pro and source-serif-pro fonts.
  • Updated autoprefixer and rollup.

v0.1.1 - 2018-12-23

Changed

  • Updated inner dependencies inside the build toolchain.

Fixed

  • Some issues/missing parts in the exampleSite/config.toml.
  • Placement of images inside figure tag is now centered on page.
  • Links to categories, tags and series are now properly generated when the names contain spaces.

v0.1.0 - 2018-12-21

Added

  • Added .editorconfig file.
  • Started packace.json file for npm.
  • Added source-code-pro, source-sans-pro and source-serif-pro fonts.
  • Added purecss as css framework.
  • Implemented a build toolchain using rollup, postcss-import, postcss-url.
  • Added Twitter Cards, Open Graph and Schema.org integration (using internal hugo templates).
  • Added a fully customizable menu for the footer.
  • Added RSS Feed with complete entries (Atom format).
  • Added a fully customizable menu for the header.
  • Implemented pagination for posts and taxonomies displays.
  • Added Tomorrow Night color scheme for syntax highlighting.
  • Extended build toolchain with autoprefixer, postcss-discard-comments, postcss-advanced-variables.
  • Implemented a custom stylesheet using colors from the Tomorrow color scheme.
  • Added build-example.js script to build exampleSite locally (through node).
  • Extended build toolchain with run commands (dev, dist, version, etc…).

Changed

  • Unified whitespace inside all templates from the fork.
  • Updated entries for exampleSite to more recent versions.
  • Copyright notice in footer sets year automatically.
  • Merged main and font stylesheets into one.
  • Updated README.md with current information.
  • Improved display of page metadata.
  • Changed inclusion of templates using blocks instead of partials.
  • Reduced css size (including only parts of purecss which are in use).

Fixed

  • Replaced “Back to top” feature with some proper JavaScript implementation.
  • Using RFC 3339 time format inside <time> tags.
  • Unified and simplified the usage of the css grid columns.
  • Improve behaviour when config entries are missing (by setting/using sane defaults).

Removed

  • Dropped custom_head.html Template.
  • Dropped Google Analytics feature.
  • Dropped Google Fonts for enhanced privacy.
  • Dropped highlightjs (hugo can do that using pygments or chroma).
  • Cleaned many parts with duplicated code.
  • Dropped unused single.html Template.
  • Dropped all prebuilt stylesheets (building them with rollup now).

Pre-Fork

Please have a look into the fork: Temple

And the fork of the fork: Nofancy

Readme

A Hugo theme focused on content, cleanliness, speed, responsiveness and privacy.

Slick is a fork of Temple with many improvements.

Temple is a fork of Nofancy with many improvements.

Table of Contents

Features

The main features of this theme include:

  • Supports taxonomies of tags, categories and series with their own pages
  • Pagination of content lists
  • RSS Feed with complete entries
  • Open Graph, Schema.org and Twitter Cards support
  • Fully customizable menu entries in the header
  • Footer with fully customizable links and RSS
  • Customizable favicon (with correct mime type for png files) and ability to inject own css file
  • Relies on chroma for syntax highlighting
  • Not even one external request (privacy!) - Everything needed is part of this theme (Fonts, CSS, JS, …)
  • 404 page with customizable text

Installation

Just download the theme or clone it into your themes/ directory:

$ cd themes && git clone https://github.com/spookey/slick.git

Then reference it in your config:

theme = "slick"

Or when building the site, pass it in to the CLI:

$ hugo -t slick

To setup the 404 page please read the instructions.

Customizing

Your config file will hold all your options.

Please have a look into the subfolders of _sites for working examples. It is highly recommended to make some adjustments to the main and the footer menu (e.g. to link to your About page).

Components

Please Note: Files inside the static folder are only updated on tagged commits (releases).

Development

This theme uses rollup.js and postCSS to bundle all files together. JavaScript is compiled from TypeScript. Components are drawn in by npm.

Please have a look inside package.json for commands and tools required for building.

Use npm version to tag a commit.

Contributing

Contributions are welcome.

Features

If you are adding a feature, fork the repository, create a new branch for your feature and submit a PR. Please make sure to put documentation for your new feature:

  • Place a comment about what your feature is doing above the code.
  • If making additions that will affect the config file, make sure you update the config.toml and config.yaml below the _sites folder as well as the CHANGELOG.md.

Issues/Bugs

Submit a new issue with information about your issue and/or bug. If you have a solution, then submit a new PR with the guidelines posted above in the features section and link your issue to it using the keyword “closes".

License

Licensed under the MIT License. See the LICENSE.

Images

Screenshot

Screenshot

Thumbnail

Thumbnail