Freifunk Berlin

This is the repository for the website of the Freifunk Community Berlin.

The website is built using the static website generator Hugo.

Install

• Clone this repository
• Load submodule with git submodule init and git submodule update
• Install Hugo

Run for development

hugo server -w

You can change the base address -b and the bind address --bind if your run it on a remote machine.

hugo server -w -b http://localhost:1313/ --bind 0.0.0.0

You can set the environment variables HUGO_MATRIX_ACCESS_TOKEN, HUGO_MATRIX_HOME_SERVER and HUGO_GITHUB_ACCESS_TOKEN to get real activity informations. Else some dummy data is used.

HUGO_GITHUB_ACCESS_TOKEN="secret" HUGO_MATRIX_ACCESS_TOKEN="secret" HUGO_MATRIX_HOME_SERVER="htps://matrix.org" hugo server -w

Build for production

hugo build --minify -b <baseURL>

Structure

├── .github/workflows           # Config for pipelines to test and deploy
├── archetypes                  # Template for new content
├── content                     # Pages as markdown files
├── layouts/partials            # Reusable elements
├── static                      # Images and videos
├── themes                      # Theme, integrated via submodule
└── apache                      # Server configs

Deployment

The website is deployed automatically via GitHub actions. The main branch is at berlin.freifunk.net. The other branches could be accessed via dev.berlin.freifunk.net/<BRANCH_NAME>/.

The actions are defined in .github/workflows and could be configured with GitHub variables and secrets. The configurations for the production and development webserver are in the apache directory.

Data fetching

To display up to date information, we fetch and generate some data during the build process. These informations are available as shortcodes for the content and as partials for the templates. They are used at various places of the website.

• map-nodecount (ff-community api)
• community-lastchange (ff-community api)
• activities-mailinglist (activities section)
• activities-matrix (activities section)
• activities-github (activities section)