xHain hack+makespace Homepage

Staging: https://staging.x-hain.de

Production: https://www.x-hain.de

Getting started

Install Hugo

Mac OS

• Install brew (for installing the rest): /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• Install go: brew install go
• Install hugo: brew install hugo

For Windows/Linux

• Install hugo: Hugo Website

Pull Submodules (eg. Theme)

• Initial pull submodule xhain-theme: git submodule update --init --recursive
• Submodule update: git submodule foreach git pull origin master

Generate Site

• Run hugo to generate HTML: hugo

• Run hugo for local development:

  hugo server --config config.toml,home.toml

  or

  hugo server --config config.toml,home.toml -w --cleanDestinationDir

Content Editing

New Post

• create new post (using archetypes):

  hugo new de/post/YYYY-MM-DD_title.de.md -k post

  or

  hugo new en/post/YYYY-MM-DD_title.en.md -k post

• just edit new post in the "content"-folder

Link Checking

Dead links are automatically checked on pull requests. To run locally:

# Build the site first
hugo -d public_html --config config.toml,home.toml --cleanDestinationDir

# Check for broken links (via Docker)
docker run --rm -v "$PWD:/src" -w /src ghcr.io/untitaker/hyperlink:0.2.0 \
  public_html --sources .

# Or install natively and run
npm install -g @untitaker/hyperlink
hyperlink public_html/ --sources .

See hyperlink documentation for more options.

Calendar

The calendar is managed by Nextcloud.