#Königspress
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 would recommend this theme for site content conducive to lengthy lecture and high immersion (e.g. memoir-like blogs, diaries, short stories, novellas).
The theme was, concept-wise, 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.
##Demos
Default theme: Märzwasser
Slightly customized: Take a Byte
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
$ bundle exec rake install[Koenigspress]
$ bundle exec generate
From your octopress blog directory:
$ cd .themes/Koenigspress
$ git pull
$ bundle exec rake install['whitespace']
$ bundle exec rake generate
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.
Header example:
---
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>.
---
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 source/_includes/custom/head.html.
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 fontsize:110%.
You can also see the source of that article on this GitHub page.
The theme can be customized just as the default octopress theme - by edditing the files under /sass/custom and under /source/_includes/custom.
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 /source/logo.png file.
The "favourite icon" (displayed by many browsers in the tabs or bookmarks list) can be changed by changing the /source/favicon.png file.
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 /sass/partials/_blog.scss file.
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 /source/_includes/custom/head.html.
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 /sass/base/_typograpphy.scss file.
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.
##Meta
Released under the GPLv3 license. Project led by Horea Christian (address all correspondence to: h.chr@mail.ru, or contact via chymera.eu).