hugo-theme-terminal/README.md

163 lines
6.2 KiB
Markdown
Raw Normal View History

2019-01-28 00:11:02 +00:00
# Terminal
![Terminal](https://github.com/panr/hugo-theme-terminal/blob/master/images/screenshot.png?raw=true)
### DEMO - https://hugo-terminal.now.sh/
2019-03-06 00:13:31 +00:00
---
- [Features](#features)
- [Built-in shortcodes](#built-in-shortcodes)
- [Code highlighting](#code-highlighting)
- [How to start](#how-to-start)
- [How to configure](#how-to-configure)
- [Add-ons](#add-ons)
- [How to run your site](#how-to-run-your-site)
- [How to edit the theme](#how-to-edit-the-theme)
- [How to contribute](#how-to-contribute)
- [Terminal theme user?](#terminal-theme-user)
- [Licence](#licence)
2019-01-28 00:11:02 +00:00
## Features
- **5 duetone themes**, depending on your preferences (orange is default, red, blue, green, pink)
2019-01-28 00:28:30 +00:00
- [**Fira Code**](https://github.com/tonsky/FiraCode) as default monospaced font. It's gorgeous!
- **really nice duotone**, custom syntax highlighting based on [**PrismJS**](https://prismjs.com)
2019-01-28 00:11:02 +00:00
- fully responsive
#### Built-in shortcodes
- **`image`** (prop required: **`src`**; props optional: **`alt`**, **`position`** (**left** is default | center | right), **`style`**)
- eg: `{{< image src="/img/hello.png" alt="Hello Friend" position="center" style="border-radius: 8px;" >}}`
- **`figure`** (same as `image`, plus few optional props: **`caption`**, **`captionPosition`** (left | **center** is default | right), **`captionStyle`**
- eg: `{{< figure src="/img/hello.png" alt="Hello Friend" position="center" style="border-radius: 8px;" caption="Hello Friend!" captionPosition="right" captionStyle="color: red;" >}}`
#### Code highlighting
A custom syntax highlighting based on PrismJS. All you need to do is to wrap you code like this:
<pre>
```html
// your code here
```
</pre>
**Supported languages**: bash/shell, css, clike, javascript, apacheconf, actionscript, applescript, c, csharp, cpp, coffeescript, ruby, csp, css-extras, diff, django, docker, elixir, elm, markup-templating, erlang, fsharp, flow, git, go, graphql, less, handlebars, haskell, http, java, json, kotlin, latex, markdown, makefile, objectivec, ocaml, perl, php, php-extras, r, sql, processing, scss, python, jsx, typescript, toml, reason, textile, rust, sass, stylus, scheme, pug, swift, yaml, haml, twig, tsx, vim, visual-basic, wasm.
## How to start
You can download the theme manually by going to [https://github.com/panr/hugo-theme-terminal.git](https://github.com/panr/hugo-theme-terminal.git) and pasting it to `themes/terminal` in your root directory.
You can also clone it directly to your Hugo folder:
```
$ git clone https://github.com/panr/hugo-theme-terminal.git themes/terminal
```
If you don't want to make any radical changes, it's the best option, because you can get new updates when they are available. You can also include it as a git submodule:
```
$ git submodule add https://github.com/panr/hugo-theme-terminal.git themes/terminal
```
## How to configure
The theme doesn't require any advanced configuration. Just copy:
```
baseurl = "/"
languageCode = "en-us"
theme = "terminal"
paginate = 5
[params]
# dir name of your blog content (default is `content/posts`)
contentTypeName = "posts"
# ["orange", "blue", "red", "green", "pink"]
themeColor = "orange"
2019-02-01 09:15:28 +00:00
# if you set this to 0, only submenu trigger will be visible
showMenuItems = 2
# set theme to full screen width
2019-03-02 00:13:27 +00:00
fullWidthTheme = false
# center theme with default width
2019-03-02 00:13:27 +00:00
centerTheme = false
2019-03-13 01:40:07 +00:00
# set a custom favicon (default is a `themeColor` square)
# favicon = "favicon.ico"
2019-01-28 00:11:02 +00:00
[languages]
[languages.en]
title = "Terminal"
subtitle = "A simple, retro theme for Hugo"
keywords = ""
copyright = ""
2019-02-01 09:15:28 +00:00
menuMore = "Show more"
2019-01-28 00:11:02 +00:00
readMore = "Read more"
readOtherPosts = "Read other posts"
[languages.en.params.logo]
2019-01-29 08:10:06 +00:00
logoText = "Terminal"
2019-01-28 00:11:02 +00:00
logoHomeLink = "/"
[languages.en.menu]
[[languages.en.menu.main]]
identifier = "about"
name = "About"
url = "/about"
[[languages.en.menu.main]]
identifier = "showcase"
name = "Showcase"
url = "/showcase"
```
2019-01-28 00:36:15 +00:00
to `config.toml` file in your Hugo root directory and change params fields. In case you need, here's [a YAML version](https://gist.github.com/panr/9eeea6f595c257febdadc11763e3a6d1).
2019-01-28 00:11:02 +00:00
2019-02-01 07:39:12 +00:00
**NOTE:** Please keep in mind that currently `main menu` doesn't support nesting.
2019-03-06 00:00:08 +00:00
## Add-ons
2019-03-06 00:01:50 +00:00
- **Comments** — for adding comments to your blog posts please take a look at `layouts/partials/comments.html` https://github.com/panr/hugo-theme-terminal/blob/master/layouts/partials/comments.html.
2019-03-06 00:00:08 +00:00
- **Extended Head** — please take a look at `layouts/partials/extended_head.html` https://github.com/panr/hugo-theme-terminal/blob/master/layouts/partials/extended_head.html
- **Extended Footer** — please take a look at `layouts/partials/extended_footer.html` https://github.com/panr/hugo-theme-terminal/blob/master/layouts/partials/extended_footer.html
2019-01-28 00:11:02 +00:00
## How to run your site
From your Hugo root directory run:
```
$ hugo server -t terminal
```
and go to `localhost:1313` in your browser. From now on all the changes you make will go live, so you don't need to refresh your browser every single time.
## How to edit the theme
2019-02-25 20:13:28 +00:00
If you have to override some of the styles, **you can do this easily** by adding `static/style.css` in your root directory and point things you want to change.
2019-01-28 15:41:56 +00:00
2019-02-01 07:39:12 +00:00
Otherwise, if you really want to edit the theme, you need to install Node dependencies. To do so, go to the theme directory (from your Hugo root directory):
2019-01-28 00:11:02 +00:00
```
$ cd themes/terminal
```
and then run:
```
$ npm install
$ npm i yarn
$ yarn
```
## How to contribute
If you spot any bugs, please use [Issue Tracker](https://github.com/panr/hugo-theme-terminal/issues) or if you want to add a new feature directly please create a new [Pull Request](https://github.com/panr/hugo-theme-terminal/pulls).
2019-03-06 00:01:50 +00:00
## Terminal theme user?
2019-03-06 00:03:29 +00:00
I'd be happy to know more about you and what you are doing. If you want to share it, please make a contribution and [add your site to the list](https://github.com/panr/hugo-theme-terminal/blob/master/USERS.md)! 🤗
2019-03-06 00:01:50 +00:00
2019-01-28 00:11:02 +00:00
## Licence
Copyright © 2019 Radosław Kozieł ([@panr](https://twitter.com/panr))
The theme is released under the MIT License. Check the [original theme license](https://github.com/panr/hugo-theme-terminal/blob/master/LICENSE.md) for additional licensing information.