.forgejo | ||
archetypes | ||
assets | ||
content | ||
i18n | ||
layouts | ||
static | ||
themes | ||
trololo | ||
.clang-format | ||
.editorconfig | ||
.gitattributes | ||
.gitignore | ||
.gitmodules | ||
.hvm | ||
.markdownlint-cli2.jsonc | ||
convert.py | ||
create_versioned_hugo_toml.sh | ||
hugo.toml | ||
Justfile | ||
Makefile | ||
README.md |
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
- for debian the easiest way to use it is to intall it via node as a global
command:
- 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