Install git and check out the website repository using the following command:

git clone https://github.com/pine64/website.git
cd website

Install Hugo as explained under https://gohugo.io/installation/, as well as Asciidoctor and Rouge:

• Arch Linux: sudo pacman -S hugo asciidoctor ruby-rouge
• Debian: sudo apt install hugo asciidoctor ruby-rouge
• Fedora: sudo dnf install hugo rubygem-asciidoctor rubygem-rouge
• Gentoo: sudo emerge --ask www-apps/hugo dev-ruby/asciidoctor dev-ruby/rouge (SASS/SCSS support not required)
• NixOS: nix-shell -p hugo asciidoctor rubyPackages.rouge (to temporarily test it in a nix-shell)
• openSUSE: sudo zypper install hugo rubygem-asciidoctor rubygem-rouge
• Windows: See here
• MacOS: See here
• BSD: See here

The website can be previewed with Hugo using an in-built webserver for development purposes. Hugo will also watch for file changes and automatically rebuild the site and reload the page in your browser. To preview the website, run:

hugo server

Then point your browser to http://localhost:1313/

For further details see https://gohugo.io/commands/hugo_server/.

The html pages can be generated to the public folder using:

hugo

website/
├── archetypes/
│   └── default.md
├── assets/
├── config/_default/
│   └── config.toml [site configuration]
├── content/
│   │── blog/
│   │── community/
│   │── contests/
│   │── documentation/
│   └── podcast/
├── data/
├── layouts/
├── public/ [contains the html files generated with "hugo"]
├── static/
└── themes/pinetheme/
    │── archetypes/
    |   └── default.md
    │── layouts/
    │── static/
    │   │── artwork [background artwork]
    │   │── css [css files]
    │   │── img [static images]
    │   │── js [static javascripts]
    │   │── podcast [podcast episodes]
    │   └── podlove [podcast player]
    └── theme.toml [theme configuration]

For an explanation of the folder structure see https://gohugo.io/getting-started/directory-structure/.

To contribute to the website, you can edit the files as listed above. For example to make corrections at blog posts, go to the folder where the blog posts are stored:

project/content/blog/

Then open the markdown file (such as april-update-no-more-unicorns.md) and edit it. The documentation pages can be edited under project/content/documentation/.

Changes to the theme can be made in the following folder:

project/themes/pinetheme/

Make sure to test your changes with Hugo's in-built preview:

hugo server

Join the community platforms, we're happy to help!