pi-www-theme-soho/README.md

167 lines
3.8 KiB
Markdown
Raw Normal View History

2014-04-27 01:25:13 +03:00
# Hyde
Hyde is a brazen two-column [hugo](https://gohugo.io) theme based on the [Jekyll](http://jekyllrb.com) theme of the same name.
2014-04-27 01:25:13 +03:00
It pairs a prominent sidebar with uncomplicated content.
![Hyde screenshot](https://f.cloud.github.com/assets/98681/1831228/42af6c6a-7384-11e3-98fb-e0b923ee0468.png)
## Contents
2016-07-26 15:27:07 +03:00
- [Installation](#installation)
2014-04-27 01:25:13 +03:00
- [Options](#options)
- [Sidebar menu](#sidebar-menu)
- [Sticky sidebar content](#sticky-sidebar-content)
- [Themes](#themes)
- [Reverse layout](#reverse-layout)
2015-07-17 13:21:50 +03:00
- [Disqus](#disqus)
- [Google Analytics](#google-analytics)
2014-04-27 01:25:13 +03:00
- [Author](#author)
2014-04-27 01:41:16 +03:00
- [Ported by](#ported-by)
2014-04-27 01:25:13 +03:00
- [License](#license)
2016-07-26 15:27:07 +03:00
## Installation
To install Hyde as your default theme, first install this repository in the `themes/` directory:
$ cd themes/
$ git clone https://github.com/spf13/hyde.git
Second, specify `hyde` as your default theme in the `config.toml` file. Just add the line
theme = "hyde"
at the top of the file.
2014-04-27 01:25:13 +03:00
## Options
Hyde 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 "menu=main" in the front matter.
### Sticky sidebar content
By default Hyde ships with a sidebar that affixes it's content to the bottom of the sidebar. You can optionally disabled this by removing the `.sidebar-sticky` class from the sidebar's `.container`. Sidebar content will then normally flow from top to bottom.
```html
<!-- Default sidebar -->
<div class="sidebar">
<div class="container sidebar-sticky">
...
</div>
</div>
<!-- Modified sidebar -->
<div class="sidebar">
<div class="container">
...
</div>
</div>
```
### Themes
Hyde ships with eight optional themes based on the [base16 color scheme](https://github.com/chriskempson/base16). Apply a theme to change the color scheme (mostly applies to sidebar and links).
![Hyde in red](https://f.cloud.github.com/assets/98681/1831229/42b0b354-7384-11e3-8462-31b8df193fe5.png)
There are eight themes available at this time.
![Hyde theme classes](https://f.cloud.github.com/assets/98681/1817044/e5b0ec06-6f68-11e3-83d7-acd1942797a1.png)
2015-07-15 13:19:53 +03:00
To use a theme, add the `themeColor` variable under `params`, like so:
2014-04-27 01:25:13 +03:00
**TOML**
```toml
theme = "hyde"
[params]
themeColor = "theme-base-09"
```
**YAML**
2015-07-15 13:19:53 +03:00
```yaml
theme: "hyde"
2015-07-15 13:19:53 +03:00
params:
themeColor: "theme-base-09"
2014-04-27 01:25:13 +03:00
```
To create your own theme, look to the Themes section of [included CSS file](https://github.com/poole/hyde/blob/master/public/css/hyde.css). Copy any existing theme (they're only a few lines of CSS), rename it, and change the provided colors.
### Reverse layout
![Hyde with reverse layout](https://f.cloud.github.com/assets/98681/1831230/42b0d3ac-7384-11e3-8d54-2065afd03f9e.png)
2016-03-09 00:15:24 +02:00
To reverse page orientation, add the `layoutReverse` variable under `params`, like so:
2014-04-27 01:25:13 +03:00
2016-03-09 00:15:24 +02:00
**TOML**
```toml
theme = "hyde"
[params]
layoutReverse = true
```
**YAML**
```yaml
theme: "hyde"
params:
layoutReverse: true
2014-04-27 01:25:13 +03:00
```
2015-07-17 13:21:50 +03:00
### Disqus
You can optionally enable a comment system powered by Disqus for the posts. Simply add the variable `disqusShortname` to your config file.
2015-07-17 13:21:50 +03:00
**TOML**
```toml
disqusShortname = "spf13"
2015-07-17 13:21:50 +03:00
```
2017-09-07 22:57:31 +03:00
**YAML**
```yaml
disqusShortname : spf13
```
> **Note:** Previous version 1.0 the Disqus shortname had to be defined inside the `[params]` block.
2015-07-17 13:21:50 +03:00
## Google Analytics
Google Analytics can be enabled by assigning your tracking code to the `googleAnalytics` variable in the config file:
**TOML**
```toml
googleAnalytics = "Your tracking code"
```
**YAML**
```yaml
googleAnalytics: Your tracking code
```
2014-04-27 01:25:13 +03:00
## Author
**Mark Otto**
- <https://github.com/mdo>
- <https://twitter.com/mdo>
## Ported By
**Steve Francia**
- <https://github.com/spf13>
- <https://twitter.com/spf13>
## License
Open sourced under the [MIT license](LICENSE.md).
<3