pi-www-theme-soho/README.md

# Hyde

Hyde is a brazen two-column [hugo](https://gohugo.io) theme based on the [Jekyll](http://jekyllrb.com) theme of the same name.
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

- [Installation](#installation)
- [Options](#options)
  - [Sidebar menu](#sidebar-menu)
  - [Sidebar description](#sidebar-description)
  - [Sticky sidebar content](#sticky-sidebar-content)
  - [Themes](#themes)
  - [Reverse layout](#reverse-layout)
  - [Disqus](#disqus)
  - [Google Analytics](#google-analytics)
- [Author](#author)
- [Ported by](#ported-by)
- [License](#license)


## Installation

### Quick Start

To give you a running start this installation puts a fully configured [starter repo](https://github.com/forestryio/hyde-hugo-starter) into your Git account and sets it up in a content manager / CMS. 

_[Forestry](https://forestry.io) Starter-Kit:_

[![Import this project into Forestry](https://assets.forestry.io/import-to-forestry.svg)](https://app.forestry.io/quick-start?repo=forestryio/hyde-hugo-starter&provider=github&engine=hugo&version=0.49)

### Standard 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.


## 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, like so:

**TOML**
```toml
theme = "hyde"

[Menus]
  main = [
      {Name = "Github", URL = "https://github.com/username/"},
      {Name = "LinkedIn", URL = "https://www.linkedin.com/in/username/"}
  ]
```

**YAML**
```yaml
theme: "hyde"

Menus:
  main:
    - Name: "Github"
      URL: "https://github.com/username/"
    - Name: "LinkedIn"
      URL: "https://www.linkedin.com/in/username/"
```

### Sidebar description
Customise the describe of your page using `description`, like so:

**TOML**
```toml
theme = "hyde"

[params]
  description = "Your custom description"
```

**YAML**
```yaml
theme: "hyde"

params:
  description = "Your custom description"
```


### 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)

To use a theme, add the `themeColor` variable under `params`, like so:

**TOML**
```toml
theme = "hyde"

[params]
  themeColor = "theme-base-09"
```

**YAML**
```yaml
theme: "hyde"

params:
  themeColor: "theme-base-09"
```

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)

To reverse page orientation, add the `layoutReverse` variable under `params`, like so:

**TOML**
```toml
theme = "hyde"

[params]
  layoutReverse = true
```

**YAML**
```yaml
theme: "hyde"

params:
  layoutReverse: true
```

### Disqus

You can optionally enable a comment system powered by Disqus for the posts. Simply add the variable `disqusShortname` to your config file.

**TOML**
```toml
disqusShortname = "spf13"
```

**YAML**
```yaml
disqusShortname : spf13
```

> **Note:** Previous version 1.0 the Disqus shortname had to be defined inside the `[params]` block.


## 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
```

## 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
Adding the hyde theme 2014-04-27 01:25:13 +03:00			`# Hyde`

Update link to Hugo site The http://hugo.spf13.com is unreachable. By the context, the https://gohugo.io will be appropriate. 2017-09-01 14:30:25 +03:00			`Hyde is a brazen two-column [hugo](https://gohugo.io) theme based on the [Jekyll](http://jekyllrb.com) theme of the same name.`
Adding the hyde theme 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`

Add installation section 2016-07-26 15:27:07 +03:00			`- [Installation](#installation)`
Adding the hyde theme 2014-04-27 01:25:13 +03:00			`- [Options](#options)`
			`- [Sidebar menu](#sidebar-menu)`
Add section for Sidebar description 2019-08-30 21:58:38 +03:00			`- [Sidebar description](#sidebar-description)`
Adding the hyde theme 2014-04-27 01:25:13 +03:00			`- [Sticky sidebar content](#sticky-sidebar-content)`
			`- [Themes](#themes)`
			`- [Reverse layout](#reverse-layout)`
Added Disqus support 2015-07-17 13:21:50 +03:00			`- [Disqus](#disqus)`
Add Google Analytics support Closes #44 2017-09-07 22:56:31 +03:00			`- [Google Analytics](#google-analytics)`
Adding the hyde theme 2014-04-27 01:25:13 +03:00			`- [Author](#author)`
small tweak to hyde read me 2014-04-27 01:41:16 +03:00			`- [Ported by](#ported-by)`
Adding the hyde theme 2014-04-27 01:25:13 +03:00			`- [License](#license)`


Add installation section 2016-07-26 15:27:07 +03:00			`## Installation`

Add Quick Start Forestry Button to Readme.md 2018-10-18 17:35:12 +03:00			`### Quick Start`

			`To give you a running start this installation puts a fully configured [starter repo](https://github.com/forestryio/hyde-hugo-starter) into your Git account and sets it up in a content manager / CMS.`

			`_[Forestry](https://forestry.io) Starter-Kit:_`

			`[![Import this project into Forestry](https://assets.forestry.io/import-to-forestry.svg)](https://app.forestry.io/quick-start?repo=forestryio/hyde-hugo-starter&provider=github&engine=hugo&version=0.49)`

			`### Standard Installation`

Add installation section 2016-07-26 15:27:07 +03:00			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.`


Adding the hyde theme 2014-04-27 01:25:13 +03:00			`## Options`

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


			`### Sidebar menu`

Add example for Sidebar menus 2019-08-30 21:57:59 +03:00			`Create a list of nav links in the sidebar by assigning "menu=main" in the front matter, like so:`

			`TOML`
			```toml
			`theme = "hyde"`

			`[Menus]`
			`main = [`
			`{Name = "Github", URL = "https://github.com/username/"},`
			`{Name = "LinkedIn", URL = "https://www.linkedin.com/in/username/"}`
			`]`
			```

			`YAML`
			```yaml
			`theme: "hyde"`

			`Menus:`
			`main:`
			`- Name: "Github"`
			`URL: "https://github.com/username/"`
			`- Name: "LinkedIn"`
			`URL: "https://www.linkedin.com/in/username/"`
			```
Adding the hyde theme 2014-04-27 01:25:13 +03:00
Add section for Sidebar description 2019-08-30 21:58:38 +03:00			`### Sidebar description`
			Customise the describe of your page using `description`, like so:

			`TOML`
			```toml
			`theme = "hyde"`

			`[params]`
			`description = "Your custom description"`
			```

			`YAML`
			```yaml
			`theme: "hyde"`

			`params:`
			`description = "Your custom description"`
			```

Adding the hyde theme 2014-04-27 01:25:13 +03:00
			`### 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)`

Updated README 2015-07-15 13:19:53 +03:00			To use a theme, add the `themeColor` variable under `params`, like so:
Adding the hyde theme 2014-04-27 01:25:13 +03:00
Added an option change the theme globally in the configs 2015-06-02 20:14:54 +03:00			`TOML`
			```toml
			`theme = "hyde"`

			`[params]`
			`themeColor = "theme-base-09"`
			```

			`YAML`
Updated README 2015-07-15 13:19:53 +03:00			```yaml
Added an option change the theme globally in the configs 2015-06-02 20:14:54 +03:00			`theme: "hyde"`
Updated README 2015-07-15 13:19:53 +03:00
Added an option change the theme globally in the configs 2015-06-02 20:14:54 +03:00			`params:`
			`themeColor: "theme-base-09"`
Adding the hyde theme 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)`

Add configuration to Reverse layout 2016-03-09 00:15:24 +02:00			To reverse page orientation, add the `layoutReverse` variable under `params`, like so:
Adding the hyde theme 2014-04-27 01:25:13 +03:00
Add configuration to Reverse layout 2016-03-09 00:15:24 +02:00			`TOML`
			```toml
			`theme = "hyde"`

			`[params]`
			`layoutReverse = true`
			```

			`YAML`
			```yaml
			`theme: "hyde"`

			`params:`
			`layoutReverse: true`
Adding the hyde theme 2014-04-27 01:25:13 +03:00			```

Added Disqus support 2015-07-17 13:21:50 +03:00			`### Disqus`

Add Google Analytics support Closes #44 2017-09-07 22:56:31 +03:00			You can optionally enable a comment system powered by Disqus for the posts. Simply add the variable `disqusShortname` to your config file.
Added Disqus support 2015-07-17 13:21:50 +03:00
			`TOML`
			```toml
Switch to Hugo's built-in Disqus template 2017-09-07 22:52:10 +03:00			`disqusShortname = "spf13"`
Added Disqus support 2015-07-17 13:21:50 +03:00			```

Add YAML example for Disqus in README 2017-09-07 22:57:31 +03:00			`YAML`
			```yaml
			`disqusShortname : spf13`
			```

Switch to Hugo's built-in Disqus template 2017-09-07 22:52:10 +03:00			> Note: Previous version 1.0 the Disqus shortname had to be defined inside the `[params]` block.
Added Disqus support 2015-07-17 13:21:50 +03:00
Add Google Analytics support Closes #44 2017-09-07 22:56:31 +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`
			```

Adding the hyde theme 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`