ITS-Website

    it-syndikat.org

  ▀███▀  ███  ▄██▀██▄
   ▓██   ███  ▓██ ███
   ▒▓█  ▄▓██▄ ▒▓█▄▄▄▄
   ▄▄▄   ███  ▄▄▄ ███
 · ▓██   ▓██  ▓██ ▓██ ·
   ▒██   ▒██  ▒██ ▒██
   ░▒█   ░▒█  ░▒█ ░▒█
   ▄▄▄   ▄▄▄  ▄▄▄▄▄▄▄
  ▄███▄  ███  ▀█dH.█▀

 glory to the syndicate

About

This repository contains the https://it-syndikat.org or https://www.it-syndikat.org website, whichever one floats your boat higher.

Edit the site

Dependencies

• hugo
• git
• git-lfs
• Golang (for hugo modules)
• clang-format (for formating javascript files)
• markdownlint-cli2 (for formating markdown)
  • for debian the easiest way to use it is to intall it via node as a global command: npm install markdownlint-cli2 --global
• just or make (please keep the Makefile and the Justfile feature-equivalent)

After installing git-lfs run git lfs install once to make it available system-wide.

Cloning

This site uses git submodules and lfs. Clone this repo with --recursive or run git submodule init && git submodule update after cloning for submodule availability. If you had git-lfs installed already, you should be good to go, if not, you need to run git lfs pull.

Testing

This site was built using Hugo. To preview the site while editing it, you can use the hugo server command.

To make sure all formatting is correct, run just check/just format.

To build it locally run just build.

Deployment

This website is auto deployed using a forgejo runner and forgejo actions. A testing step including a linter has been included to prevent the pipeline from deploying broken sites. If your changes do not deploy, please check the actions tab.

Markdown header entries

Please use the following:

• draft: true - to mark an entry as draft
• todo: notes what needs to be done
• recovery-source: link to archive.org