diff options
author | StefMa <StefMaDev@outlook.com> | 2021-02-16 11:46:15 +0300 |
---|---|---|
committer | StefMa <StefMaDev@outlook.com> | 2021-02-16 11:46:15 +0300 |
commit | cc18a363d922354beed7dd33a167debec89a280d (patch) | |
tree | afe8367d9411740bd387b76c586c301d4555a0bb | |
parent | fa13a72e606540ab7e0ff925935e08a4d74bf55e (diff) |
Adjust readme
-rw-r--r-- | README.md | 391 |
1 files changed, 3 insertions, 388 deletions
@@ -1,393 +1,8 @@ # The Fresh theme for Hugo +[![Documentation](https://img.shields.io/badge/Documentation-red)](https://stefma.github.io/hugo-fresh) +[![Live Demo](https://img.shields.io/badge/Live%20Demo-blue)](https://hugo-fresh.vercel.app) + **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/). ![Fresh theme logo](images/screenshot.png) - -## 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 - -### 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/lucperkins/github-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> - -### 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> - -## Troubleshooting - -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! |