hugo-scroll/README.md

98 lines
4.3 KiB
Markdown
Raw Permalink Normal View History

# Hugo Scroll ![Test](https://github.com/janraasch/hugo-scroll/workflows/CI/badge.svg?branch=master&event=push) [![Pay me][paypal-svg]][paypal-dot-me] [![Sponsor me][github-sponsors-svg]][github-sponsors]
2020-07-07 08:37:57 +00:00
2020-07-07 16:03:40 +00:00
📜 A [Hugo](https://gohugo.io/)-theme for pretty, quick and simple single-page websites.
2020-07-07 08:37:57 +00:00
![Screenshot Hugo Scroll Theme](https://raw.githubusercontent.com/janraasch/hugo-scroll/master/images/tn.png)
2020-07-09 09:36:44 +00:00
## Demo
For a current & working demo of this theme please check out https://janraasch.github.io/hugo-scroll/ 🎯.
## Sponsor 💟
Support my work on this theme via [GitHub Sponsors][github-sponsors] (recurring) or [PayPal][paypal-dot-me] (one-time).
[![GitHub Stats](https://github-readme-stats.vercel.app/api/?username=janraasch)][github-sponsors]
## Installation
2020-07-07 08:37:57 +00:00
If you already have a hugo site on your machine, you can simply add this theme via
```
git submodule add https://github.com/janraasch/hugo-scroll.git themes/hugo-scroll
```
Then, adjust the `config.toml` as detailed below.
If you simply want to check out the `exampleSite`, you can run
```
git clone https://github.com/janraasch/hugo-scroll.git hugo-scroll
cd hugo-scroll
hugo server --source=exampleSite --themesDir=../..
2020-07-07 08:37:57 +00:00
```
For more information read the official [setup guide][hugo-setup-guide] of Hugo.
2020-07-07 08:37:57 +00:00
## Adjust configuration / config.toml
2020-07-07 16:04:10 +00:00
Please check out the [config.toml](https://github.com/janraasch/hugo-scroll/blob/master/exampleSite/config.toml) included on the [exampleSite](https://github.com/janraasch/hugo-scroll/tree/master/exampleSite) of this theme.
2020-07-07 08:37:57 +00:00
## Content & structure
### Starting fresh
2020-08-17 09:57:55 +00:00
If you are starting fresh, simply copy over the contents of the `exampleSite`-directory included in this theme to your source directory. That should give you a good idea about how things work, and then you can go on from there to make the site your own.
### Adding content
2020-07-07 08:37:57 +00:00
You can add **a new section to the homepage** via running
```
hugo new homepage/my-new-content.md
```
To create **a page separate from the homepage**, run
```
hugo new my-new-page.md
```
2020-09-21 11:52:32 +00:00
### Using icons
This theme includes the full set of [Fork Awesome 1.1.7 Icons][fork-awesome-icons]. Use the `{{<icon>}}`-[shortcode][hugo-shortcodes] with the respective "fa fa-ICONNAME"-`class` to use an icon directly in your `.markdown` files à la
2020-09-21 11:52:32 +00:00
```markdown
Look at this nice »envelope«-icon: {{<icon class="fa fa-envelope">}}. I took this from https://forkaweso.me/Fork-Awesome/icon/envelope/ :-)
2020-09-21 11:52:32 +00:00
```
For the full list of icons, see [Fork Awesome 1.1.7 Icons][fork-awesome-icons].
2020-09-21 11:52:32 +00:00
### Adding your branding / colors / css
2020-09-09 16:00:59 +00:00
Add a `custom_head.html`-file to your `layouts/partials`-directory. In there you may add a `<style>`-tag _or_ you may add a `<link>`-tag referencing your own `custom.css` (in case you prefer to have a separate `.css`-file). Checkout the [`custom_head.html`](https://github.com/janraasch/hugo-scroll/blob/master/exampleSite/layouts/partials/custom_head.html)-file from the `exampleSite`-directory to get started and to find more detailed instructions.
2020-07-07 16:04:28 +00:00
## Issues / Feedback / Contributing
2020-09-09 16:00:59 +00:00
2020-07-07 16:04:28 +00:00
Please use [GitHub issues](https://github.com/janraasch/hugo-scroll/issues) and [Pull Requests](https://github.com/janraasch/hugo-scroll/pulls).
If you do not have a GitHub-account, feel free to hit me up via e-mail (see [janraasch.com](https://www.janraasch.com)).
2020-07-07 08:37:57 +00:00
## Special Thanks 🎁
2020-09-09 16:00:59 +00:00
- Go to [Yonatan Wolowelsky](https://github.com/grmmph), for the great [GhostScroll](https://github.com/grmmph/GhostScroll)-theme which formed the basis of this [Hugo](https://gohugo.io/)-theme.
- Go to [Pexels](https://www.pexels.com), for supplying those wonderful _free_ stock photos on the [exampleSite](https://github.com/janraasch/hugo-scroll/tree/master/exampleSite).
2020-07-07 08:37:57 +00:00
## License
2020-09-09 16:00:59 +00:00
2020-07-07 08:37:57 +00:00
[MIT License](http://en.wikipedia.org/wiki/MIT_License) © [Jan Raasch](https://www.janraasch.com)
[paypal-dot-me]: https://www.paypal.me/janraasch/29,00
2020-08-31 18:54:21 +00:00
[github-sponsors]: https://github.com/sponsors/janraasch
2020-09-11 17:26:53 +00:00
[paypal-svg]: https://img.shields.io/badge/onetime-donation-11dde2.svg?logo=paypal
[github-sponsors-svg]: https://img.shields.io/badge/recurring-sponsorship-ee4aaa.svg?logo=github
[hugo-setup-guide]: https://gohugo.io/getting-started/installing
[fork-awesome]: https://forkaweso.me/Fork-Awesome/
[fork-awesome-icons]: https://forkaweso.me/Fork-Awesome/icons/
2020-09-21 11:52:32 +00:00
[hugo-shortcodes]: https://gohugo.io/content-management/shortcodes/