Skip to content
This repository has been archived by the owner on Jul 29, 2021. It is now read-only.
/ master-rust Public archive

A two-column Jekyll theme for websites that require a master-detail layout for viewing of content

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.md
Notifications You must be signed in to change notification settings

twocolumn/master-rust

Repository files navigation

BlackDoc

Jekyll version

BlackDoc is a two-column Jekyll theme that's ideal for websites that require a master-detail layout for viewing of content. It's based on Poole, the Jekyll butler, and the Hyde theme.

BlackDoc screenshot

Contents

Features

  • Now compatible with Jekyll 3.x
  • Two-column layout with scrolling sidebar content
  • Ideal for websites that require master-detail view of content

Quick Start

Download the zip file or clone the BlackDoc repo.

$ git clone git@github.com:karloespiritu/BlackDoc.git mysite
$ cd mysite

Make sure you have Ruby 2.2.5 or higher installed.

$ ruby --version
ruby 2.2.5

Install bundler and install dependencies.

$ gem install bundler
$ bundle install

Build and run your BlackDoc site.

$ jekyll serve

Usage

BlackDoc is a theme built on top of Poole, which provides a fully furnished Jekyll setup—just download and start the Jekyll server. See the Poole usage guidelines for how to install and use Jekyll.

Options

BlackDoc includes some customizable options, typically applied via classes on the <body> element.

Sidebar menu

Create a list of nav links in the sidebar by assigning each Jekyll page the correct layout in the page's front-matter.

---
layout: page
title: About
---

Why require a specific layout? Jekyll will return all pages, including the atom.xml, and with an alphabetical sort order. To ensure the first link is Home, we exclude the index.html page from this list by specifying the page layout.

Scrolling sidebar content

By default, BlackDoc includes a scrolling sidebar that will display your markdown files in alphabetical order.

Themes

BlackDoc ships with eight optional themes based on the base16 color scheme. Apply a theme to change the color scheme (mostly applies to sidebar and links).

To use a theme, add anyone of the available theme classes to the <body> element in the default.html layout, like so:

<body class="theme-base-08">
  ...
</body>

To create your own theme, look to the Themes section of included CSS file. Copy any existing theme (they're only a few lines of CSS), rename it, and change the provided colors.

Reverse layout

BlackDoc reverse screenshot

BlackDoc's page orientation can be reversed with a single class.

<body class="layout-reverse">
  ...
</body>

Author

Karlo Espiritu

License

Open sourced under the MIT license.

\m/

Thanks

Thanks to @mdo for creating the awesome Poole project.

About

A two-column Jekyll theme for websites that require a master-detail layout for viewing of content

Topics

Resources

License

MIT, Unknown licenses found

Licenses found

MIT
LICENSE
Unknown
LICENSE.md

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published