GithubHelp home page GithubHelp logo

pageturner's Introduction

Note: This project is not actively maintained, but open to any pull requests

A simple responsive Octopress theme

There isn't a very wide choice of Octopress themes out there, so I decided to make my own. It's inspired heavily by Simon Foster's blog (http://simonfosterdesign.com/blog/), relying mostly on typography (all typographical elements are stored as variables for simple customization).

The theme makes use of bourbon for SASS mixins, lettering.js for typography, and prettify.js and zclip.js for displaying code blocks.

Demo

See http://fivetonine.eu

Install

From your Octopress root directory:

# git clone https://github.com/elisehein/Pageturner.git .themes/Pageturner
# rake install['Pageturner']
# rake generate

About

sass/_variables.scss allows for a lot of customization.

Fonts

I experimented with a lot of fonts and didn't bother removing the ones I didn't like so there's a lot to choose from. See sass/_typography.scss for a full list of fonts that come with this theme.

Code blocks and syntax highlighting

The theme comes with Prettify.js for syntax highlighting. My color scheme of choice for Prettify was Hemisu from http://jmblog.github.com/color-themes-for-google-code-prettify/. To use a different color scheme, add the css file to sass/. change the stylesheet name in the <head> section of source/_layouts/default.html (this is the base layout that all other pages use). You will need to save the css file as .scss, otherwise rake generate won't pick it up.

Using Prettify does not require any special markdown syntax. You simply begin a code block with the usual indentation or grave characters.

Of course, the the standard of using Pygments and {% codeblock %} should work as well, but this theme does not include styling for any {% codeblock %} elements.

Issues

  • zclip.js error PPB_Graphics2D.PaintImageData: Rectangle is outside bounds.
  • _responsive.scss mixins are causing syntax errors. This is probably caused by the way rake compiles sass files. Using regular @media queries instead until fixed.
  • No styling for Octopress codeblock and gist plugins yet
  • If you've enabled like buttons or disqus comments in your _config.yml, you will need to add relevant tags and styling

pageturner's People

Contributors

adrianbautista avatar elisehein avatar guneysus avatar kalafut avatar kristenmills avatar lsinger avatar mahirrudin avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.