hs3pl

Overview

Type: Infrastructure
Purpose: Hackerspace official public webiste
Current maintainer: Allgreed

Contributing

Submit ideas and reporting bugs

Just drop'em as issues :D

Write content

All content is located in ~/content
Markdown knwolegde is required.

Write content
Preview it in development mode
Submit via PR

Look for bugs

Run the app in development mode
Try strange use cases
When you find a bug - submit an issue.

Other / Code

If you'd like to write code please contact the maintainer.

Prerequisites

To begin you'll need to have installed:

Hugo

Caution! - make sure to install the latest version of Hugo

Setup

Clone the repo

    $ git clone https://github.com/hs3city/inf_main-site

Navigate to the main folder
```
    $ cd hs3pl
```

Dev

    hugo serve

Adding new pages

    hugo new PAGENAME.md

Adding items to the menu

Pages

Pages are added automatically, just specify the weight and title in front matter.

External links

To config.toml append following snippet:

    [[menu.main]]
    name = "MENU-ITEM-NAME"
    weight = WEIGHT
    url = "https://example.com"

Where weight is an integer from that describes items order (ascending from the left)

Building

    hugo

The resulting build will be in ~/public

Deploy

    . deploy.sh

deploy.sh requires executive privilages, trash alias (as deleting / moving to trash), hugo alias and push access to hs3city.github.io repository

Shoutout

Based on After Dark theme for Hugo

allgreed/hs3pl