Add docs
This commit is contained in:
StefMa
21
docs/config.yml
Normal file
21
docs/config.yml
Normal file
@@ -0,0 +1,21 @@
|
||||
baseURL: "https://stefma.github.io/hugo-fresh"
|
||||
languageCode: "en-us"
|
||||
title: "Hugo Fresh documentation"
|
||||
module:
|
||||
imports:
|
||||
path: github.com/StefMa/hugo-fresh
|
||||
|
||||
params:
|
||||
navbarlogo:
|
||||
image: logos/fresh.svg
|
||||
link: /hugo-fresh
|
||||
hero:
|
||||
title: hugo fresh documentation
|
||||
subtitle: Probably the best hugo theme out there!
|
||||
buttontext: Go to docs
|
||||
buttonlink: getstarted
|
||||
image: illustrations/worker.svg
|
||||
navbar:
|
||||
- title: GitHub
|
||||
url: https://github.com/StefMa/hugo-fresh
|
||||
button: true
|
||||
80
docs/content/getstarted.md
Normal file
80
docs/content/getstarted.md
Normal file
@@ -0,0 +1,80 @@
|
||||
---
|
||||
title: Get Started
|
||||
sidebar: true
|
||||
sidebarlogo: fresh-white
|
||||
include_footer: false
|
||||
---
|
||||
|
||||
## The Fresh theme for Hugo
|
||||
|
||||
**Fresh** is a theme for the [Hugo](https://gohugo.io) static site generator adapted from the gorgeous, [Bulma](https://bulma.io)-based theme of the same name from [CSS Ninja](https://cssninja.io/themes/fresh). You can find a live demo of the original theme [here](https://cssninjastudio.github.io) and a live demo of the Hugo theme [here](https://hugo-fresh.now.sh/).
|
||||
|
||||
<img src="https://raw.githubusercontent.com/StefMa/hugo-fresh/master/images/screenshot.png" style="margin-left:auto;margin-right:auto;" />
|
||||
|
||||
## Getting started
|
||||
|
||||
To create a new site using this theme
|
||||
|
||||
<details open>
|
||||
<summary>with git submodules</summary>
|
||||
|
||||
```bash
|
||||
# Create site and cd into it
|
||||
hugo new site my-site && cd my-site
|
||||
|
||||
# Clone the Fresh theme
|
||||
git clone https://github.com/StefMa/hugo-fresh themes/hugo-fresh
|
||||
|
||||
# Remove the default config
|
||||
rm config.toml
|
||||
|
||||
# Fetch the example config
|
||||
curl -O https://raw.githubusercontent.com/StefMa/hugo-fresh/master/exampleSite/config.yaml
|
||||
|
||||
# Run the site locally
|
||||
hugo server
|
||||
|
||||
# Open the site in your browser
|
||||
open http://localhost:1313
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>with hugo modules</summary>
|
||||
|
||||
```bash
|
||||
# Create site and cd into it
|
||||
hugo new site my-site && cd my-site
|
||||
|
||||
# Transform your hugo site to an module
|
||||
hugo mod init YOUR_MODULE_NAME
|
||||
|
||||
# Remove the default config
|
||||
rm config.toml
|
||||
|
||||
# Fetch the example config
|
||||
curl -O https://raw.githubusercontent.com/StefMa/hugo-fresh/master/exampleSite/config.yaml
|
||||
|
||||
# Replace theme with module in config.yaml
|
||||
#theme: [hugo-fresh]
|
||||
module:
|
||||
imports:
|
||||
path: github.com/StefMa/hugo-fresh
|
||||
|
||||
# Run the site locally
|
||||
hugo server
|
||||
|
||||
# Open the site in your browser
|
||||
open http://localhost:1313
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## Customizing your page
|
||||
|
||||
Checkout the [Landing page docs](../landingpage) to customize the landing page.
|
||||
|
||||
There is also the option to create single pages. Check the [Single page docs](../singlepage) for more.
|
||||
|
||||
Have some troubles? Check our [troubleshooting](../troubleshooting) guide.
|
||||
307
docs/content/landingpage.md
Normal file
307
docs/content/landingpage.md
Normal file
@@ -0,0 +1,307 @@
|
||||
---
|
||||
title: Landing page
|
||||
sidebar: true
|
||||
sidebarlogo: fresh-white
|
||||
include_footer: false
|
||||
---
|
||||
|
||||
## Customize the landing page
|
||||
There's a wide variety of customizations that you can make to your Hugo Fresh landing page by modifying the `config.yaml` file that you downloaded.
|
||||
|
||||
### navbarlogo
|
||||
Define the logo of the navigationbar in the upper left corner.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
navbarlogo:
|
||||
image: logos/fresh.svg # Logo (from static/images/logos/)
|
||||
link: /
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### font
|
||||
Set the font of the site.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
font:
|
||||
name: "Open Sans"
|
||||
sizes: [400,600]
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### hero
|
||||
The "main" page which you see when you open the website.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
hero:
|
||||
title: Manage. Deploy.
|
||||
subtitle: Lorem ipsum sit dolor amet is dummy text used by the typography industry
|
||||
buttontext: Get started
|
||||
buttonlink: "#"
|
||||
image: illustrations/worker.svg
|
||||
# Footer logos (from static/images/logos/clients/*.svg)
|
||||
clientlogos:
|
||||
- systek
|
||||
- tribe
|
||||
- kromo
|
||||
- infinite
|
||||
- gutwork
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### navbar
|
||||
The navigation bar which is at the top of the site.
|
||||
For a dropdown, add a "sublinks" list.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
navbar:
|
||||
- title: Features
|
||||
url: /
|
||||
- title: Pricing
|
||||
url: /
|
||||
- title: Dropdown
|
||||
sublinks:
|
||||
- title: Dropdown item
|
||||
url: /
|
||||
- title: Dropdown item
|
||||
url: /
|
||||
- title: Dropdown item
|
||||
url: /
|
||||
- title: Log in
|
||||
url: /
|
||||
- title: Sign up
|
||||
url: /
|
||||
button: true
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### sidebar
|
||||
The sidebar is an optional parameter where you can place even more navigation items.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
sidebar:
|
||||
# Logo (from /images/logos/___.svg)
|
||||
logo: fresh-square
|
||||
sections:
|
||||
- title: User
|
||||
icon: user
|
||||
links:
|
||||
- text: Profile
|
||||
url: /
|
||||
- text: Account
|
||||
url: /
|
||||
- text: Settings
|
||||
url: /
|
||||
- title: Messages
|
||||
icon: envelope
|
||||
links:
|
||||
- text: Inbox
|
||||
url: /
|
||||
- text: Compose
|
||||
url: /
|
||||
- title: Images
|
||||
icon: image
|
||||
links:
|
||||
- text: Library
|
||||
url: /
|
||||
- text: Upload
|
||||
url: /
|
||||
- title: Settings
|
||||
icon: cog
|
||||
links:
|
||||
- text: User settings
|
||||
url: /
|
||||
- text: App settings
|
||||
url: /
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### section1
|
||||
Describes the second "page" which you will see when you scroll down. Currently it will have **always** three `titles`.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
section1:
|
||||
title: Great power comes
|
||||
subtitle: with great responsibility
|
||||
tiles:
|
||||
- title: App builder
|
||||
icon: mouse-globe
|
||||
text: This is some explanatory text that is on two rows
|
||||
url: /
|
||||
buttonText: Free trial
|
||||
- title: Cloud integration
|
||||
icon: laptop-cloud
|
||||
text: This is some explanatory text that is on two rows
|
||||
url: /
|
||||
buttonText: Get started
|
||||
- title: Add-ons & plugins
|
||||
icon: plug-cloud
|
||||
text: This is some explanatory text that is on two rows
|
||||
url: /
|
||||
buttonText: Get started
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### section2
|
||||
Shows information why someone should use this product.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
section2:
|
||||
title: You're here because you want the best
|
||||
subtitle: And we know it
|
||||
features:
|
||||
- title: Powerful and unified interface
|
||||
text: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin ornare magna eros, eu pellentesque tortor vestibulum ut. Maecenas non massa sem. Etiam finibus odio quis feugiat facilisis.
|
||||
# Icon (from /images/illustrations/icons/___.svg)
|
||||
icon: laptop-globe
|
||||
- title: Cross-device synchronisation
|
||||
text: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin ornare magna eros, eu pellentesque tortor vestibulum ut. Maecenas non massa sem. Etiam finibus odio quis feugiat facilisis.
|
||||
icon: doc-sync
|
||||
- title: Nomad system
|
||||
text: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin ornare magna eros, eu pellentesque tortor vestibulum ut. Maecenas non massa sem. Etiam finibus odio quis feugiat facilisis.
|
||||
icon: mobile-feed
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### section3
|
||||
Display a bright image of your product.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
section3:
|
||||
title: One platform
|
||||
subtitle: To rule them all
|
||||
image: illustrations/mockups/app-mockup.png
|
||||
buttonText: Get started
|
||||
buttonLink: "#"
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### section4
|
||||
What clients says about us.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
section4:
|
||||
title: Our Clients love us!
|
||||
subtitle: Lorem ipsum sit dolor amet is a dummy text used by typography industry
|
||||
clients:
|
||||
- name: Irma Walters
|
||||
quote: Lorem ipsum dolor sit amet, elit deleniti dissentias quo eu, hinc minim appetere te usu, ea case duis scribentur has. Duo te consequat elaboraret, has quando suavitate at.
|
||||
job: Accountant
|
||||
img: 1 # From (static/images/illustrations/faces)
|
||||
- name: John Bradley
|
||||
quote: Lorem ipsum dolor sit amet, elit deleniti dissentias quo eu, hinc minim appetere te usu, ea case duis scribentur has. Duo te consequat elaboraret, has quando suavitate at.
|
||||
job: Financial Analyst
|
||||
img: 2
|
||||
- name: Gary Blackman
|
||||
quote: Lorem ipsum dolor sit amet, elit deleniti dissentias quo eu, hinc minim appetere te usu, ea case duis scribentur has. Duo te consequat elaboraret, has quando suavitate at.
|
||||
job: HR Manager
|
||||
img: 3
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### section5
|
||||
Write us.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
section5: true # or false to hide it
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
### footer
|
||||
The footer of the site.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
footer:
|
||||
# Logo (from /staticimages/logos/___)
|
||||
logo: fresh-white-alt.svg
|
||||
# Social media links (GitHub, Twitter, etc.). All are optional.
|
||||
socialmedia:
|
||||
- link: https://github.com/StefMa/hugo-fresh
|
||||
# Icons are from Font Awesome
|
||||
icon: github
|
||||
- link: https://dribbble.com/#
|
||||
icon: dribbble
|
||||
- link: https://facebook.com/#
|
||||
icon: facebook
|
||||
- link: https://twitter.com/lucperkins
|
||||
icon: twitter
|
||||
- link: https://bitbucket.org/#
|
||||
icon: bitbucket
|
||||
bulmalogo: true
|
||||
quicklinks:
|
||||
column1:
|
||||
title: "Product"
|
||||
links:
|
||||
- text: Discover features
|
||||
link: /
|
||||
- text: Why choose our product?
|
||||
link: /
|
||||
- text: Compare features
|
||||
link: /
|
||||
- text: Our roadmap
|
||||
link: /
|
||||
- text: AGB
|
||||
link: /agb
|
||||
column2:
|
||||
title: "Docs"
|
||||
links:
|
||||
- text: Get started
|
||||
link: /
|
||||
- text: User guides
|
||||
link: /
|
||||
- text: Admin guide
|
||||
link: /
|
||||
- text: Developers
|
||||
link: /
|
||||
column3:
|
||||
title: "Blog"
|
||||
links:
|
||||
- text: Latest news
|
||||
link: /blog/first
|
||||
- text: Tech articles
|
||||
link: /blog/second
|
||||
```
|
||||
|
||||
</details>
|
||||
27
docs/content/singlepage.md
Normal file
27
docs/content/singlepage.md
Normal file
@@ -0,0 +1,27 @@
|
||||
---
|
||||
title: Single page
|
||||
sidebar: true
|
||||
sidebarlogo: fresh-white
|
||||
include_footer: false
|
||||
---
|
||||
|
||||
## Creating a single page
|
||||
Single pages displays a single unit of information and are more or less independent from the landing page above.
|
||||
|
||||
You can create single pages in the `content` directory (even sub-dirs are possible).
|
||||
|
||||
If you'd like to have the footer displayed on your single page include `include_footer: true` in your front matter.
|
||||
|
||||
<details>
|
||||
<summary>Code</summary>
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: AGB
|
||||
sidebar: true # or false to display the sidebar
|
||||
sidebarlogo: fresh-white-alt # From (static/images/logo/)
|
||||
include_footer: true # or false to display the footer
|
||||
---
|
||||
```
|
||||
|
||||
</details>
|
||||
10
docs/content/troupleshooting.md
Normal file
10
docs/content/troupleshooting.md
Normal file
@@ -0,0 +1,10 @@
|
||||
---
|
||||
title: Troubleshooting
|
||||
sidebar: true
|
||||
sidebarlogo: fresh-white
|
||||
include_footer: false
|
||||
---
|
||||
|
||||
## Hugo extended
|
||||
|
||||
If you see `error: failed to transform resource: TOCSS: failed to transform "style.sass"` when attempting to run your `hugo server`, make sure you have the extended version of Hugo installed!
|
||||
5
docs/go.mod
Normal file
5
docs/go.mod
Normal file
@@ -0,0 +1,5 @@
|
||||
module github.com/stefma/hugo-fresh/docs
|
||||
|
||||
go 1.15
|
||||
|
||||
require github.com/StefMa/hugo-fresh v0.0.0-20210215141724-0fa1741f382c // indirect
|
||||
2
docs/go.sum
Normal file
2
docs/go.sum
Normal file
@@ -0,0 +1,2 @@
|
||||
github.com/StefMa/hugo-fresh v0.0.0-20210215141724-0fa1741f382c h1:QYmEuOnjZddrD7PAaMfOF5QcK6DuuQRANhb7CWY2h4o=
|
||||
github.com/StefMa/hugo-fresh v0.0.0-20210215141724-0fa1741f382c/go.mod h1:0kyrjS5vdFJ47D7bPs6JwXTkctiMaQbToeBaOQsw1Tw=
|
||||
Reference in New Issue
Block a user