Maintained by the global NAV community
Want to add a project, update or fix some errors. Then please fork the project and get changing.
The NAV community site is built with the static site generator Hugo.
This website is built using Hugo Version 0.46.
You will need Hugo installed on your system to preview any changes. Follow the install instructions for your OS here: https://gohugo.io/getting-started/installing/
You will need to fork and clone the project on github if you wish to make any changes to the site
After cloning the site, cd into the project directory and run it up:
cd navcoin-org
hugo server
This will serve the site on http://localhost:1313
Please note that Hugo is a hot loading site and that changing and saving files will auto rebuild the site for you.
All content for the site is held in markdown files in the content folder. The content sections match the sections of the site.
This project uses SASS so you will need to do the follow to compile the SASS to CSS:
npm install
npm run sass # this will watch the sass folder and recompile when a change is detected
For the new theme's shortcodes, see /themes/nav-community-v2/docs/how-to-use-shortcodes.md
When creating a new item it is recommend you use the Hugo commandline tool as this will use the right archetype and populate the properties
hugo new news/[year]/[month]/[post-title]/index.md
You should keep all the post related images in the folder with the index.md folder
title: "New Title" - The title of the news item
date: 2018-03-07T10:27:21+13:00 - The date and time published - defaults to date created
draft: false - Is the item a draft - if true it is not built
author: "" - Who authored the article
description: "" - currently unused
categories: ["NavCoin Updates"] - Cats
resources: [] - currently unused
slug: "" - currently unused
feature_image: "image.png" - The image that should be hero'd
show_title_text: false - If you want to show the title below the image
When adding a project it is recommend you use the Hugo commandline tool as this will use the right archetype and populate the properties
hugo new projects/project-name/index.md
title: "Project name" - Project Name
date: 2018-03-07T10:27:21+13:00 - The date and time published - defaults to date created
lastmod: 2018-03-19T10:27:21+13:00 - The date md was last changed
draft: true - Is the item a draft - if true it is not included in the site
author: "" - Who is the project lead
description: "" - currently unused
resources: [] - currently unused
categories: [] - currently unused
slug: "" - currently unused
type: "project" - Defines this is a project - DO NOT CHANGE
feature_image: "" - currently unused
show_title_text: false - currently unused
in_progress: false - Signal that the project has been started
completed: false - Signal project is complete
show_on_roadmap: false - Show the project on the road map
percent_complete: 0 - How much of the project has been completed
github_url: "" - Github repo of the project - Optional
project_url: "" - The project URL - Optional
reddit_url: "" - Reddit thread / URL - Optional
twitter_url: "" - Project twitter url - Optional
card_color: "" - Change the card colour - Optional
font_color: "" - Change the card font colour - Optional
weight: 0 - Allows the default position on the roadmap to be overridden
The layouts are held in the theme folder currently nav-commnity-v1
. Please review the Hugo documentation for layout template information
CSS styles can be added/edited in the static/css
directory. Most of the main styles are in style.css