Königspress is an Octopress theme designed with an emphasis on typography. The main goal of this theme is to provide a similar reading experience as a high-quality typeset book or PDF document. We recommend this theme for content conducive to lengthy lecture and high immersion (e.g. memoir-like blogs, diaries, short stories, novellas).
The theme was, conceptually, strongly inspired by Pageturner by Elise Hein, which is in turn visually based on a design blog by Simon Foster. Our code is however completely different, and more closely based on proper in-place editing of the default octopress theme.
Default theme: Themespace Preview
If you are using Königspress and would like to showcase your website, we would be very happy to add you to the list! Just tell us your URL via the issue tracking system!
From your octopress blog root directory:
$ git clone https://github.com/TheChymera/Koenigspress.git .themes/Koenigspress $ rake install[Koenigspress] $ rake generate
From your octopress blog directory:
$ git -C .themes/Koenigspress pull origin master $ rake install[Koenigspress] $ rake generate
Update and Keep Customizations
For this to work, you have to track your website theme customizations on a remote (we call it
$ git -C .themes/Koenigspress pull origin master $ rake install[Koenigspress] $ cd ../.. $ git fetch --all $ git reset --hard mywebsiterepo/master $ rake generate
Awesome Authoring and Licensing Features!
Königspress is designed to be compatible with multi-authored blogs and even multi-authored articles. The footer of the website specifies a website license - which for instance you could make proprietary if you don't want anybody cloning your website structure.
Separately, you - or guest authors - can specify per-article licenses for your content.
You may do this by adding a
license: specification to your post header.
Per-article licensing also supports hyperlinks, which we encourage you to use.
--- layout: post title: "Lorem" date: 2013-12-28 17:49:17 +0200 comments: true categories: author: <a rel="author" href="https://your.website.org">A. U. Thor</a> license: <a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International License</a>. ---
Per-Article Font Specification
Our focus on typography extends to providing the user with an easy interface to specify fonts per-article.
You can use the
font: tag in your article header to choose any of the fonts imported under
Additionally, if the font of your choice has a lower legibility at the default font size you can use a percent specification in the
fontsize tag to increase the article font size.
For a published per-article example, check out this page - using only
font: UnifrakturMaguntia and
You can also see the source of that article on this GitHub page.
Edit and History Links
If you choose to track your content via an open repository (on GitHub, Bitbucket, etc.) you can also link to your article's history (in the footer) or allow users to contribute via the version controlling backend (link in the header, next to "COMMENTS").
Whitespace automatically enables this if you set the following variables in your
_config.yml - e.g.:
history: https://github.com/youruser/yourblog/commits/master/source/ edit: https://github.com/youruser/yourblog/edit/master/source/
AdSense for Search
You can enable Google AdSense™ for search via your whitespace search bar.
For this to work you have to set
adsense_cse_partner_ID in your
_config.yml file (you will have to add a line for the second variable, as it is not used with any other themes).
The value for this variable can be extracted from the custom code for your search bar from a line such as the following:
<input type="hidden" name="cx" value="<adsense_cse_partner_ID>" />
simple_search: https://www.google.com/search adsense_cse_partner_ID: partner-pub-9999999999999999:9999999999
The theme can be customized just as the default octopress theme - by edditing the files under
/sass/custom and under
Additionally, Königspress allows font and logo customization:
The logo displayed in the upper right corner of the screen can be changed by changing the
The "favourite icon" (displayed by many browsers in the tabs or bookmarks list) can be changed by changing the
Both these changes will only take effect after you run the next
$ bundle exec generate
Additionally, favicon changes may take a while to become visible due to browser caching.
You can customize the way in which the logo is displayed by editing its HTML under
/source/_includes/logo.html and its CSS at the end of the
Our emphasis on typography goes hand in hand with permitting the user to choose a typographical style to best complement his content. We use the convenient Google Fonts framework for importing free, open, and high-quality webfonts.
A number of these (which we believe are in tune with our design paradigm) are already loaded under
You can add any other font from Google Fonts via that file.
Of these fonts the ones which the website will actually use to display your content are specified in the
Please report any glitches or theme inconsistencies that may bother you (preferably alongside a link to your website). We highly appreciate forks, hacks, pull request, or any other kinds of contributions.