The new hamburg.ccc.de
Find a file
echtnurich 8ffc773367 CI: enable build by build debugging
Also add other untracked files to build artifact.
2023-11-04 21:57:31 +01:00
assets/snippets Content: Add home page content 2023-11-03 21:37:51 +01:00
content Content: Add home page content 2023-11-03 21:37:51 +01:00
layouts/shortcodes [TIDY] Apply editorconfig 2023-10-29 22:52:32 +01:00
static/thirdparty/fontawesome6 Add font-awesome v6.4.2 2023-10-02 12:10:10 +02:00
themes/ccchh CI: Set timezone to Europe/Berlin 2023-11-04 19:43:29 +00:00
.editorconfig Add .editorconfig for consistent formatting 2023-10-29 22:52:32 +01:00
.gitignore Home: Add calendar 2023-10-20 23:37:17 +02:00
.gitlab-ci.yml CI: enable build by build debugging 2023-11-04 21:57:31 +01:00
CONTRIBUTING.md Docs: Add contributing guidlines 2023-10-29 23:39:31 +01:00
fetch-calendar.sh calendar: Update URL 2023-10-29 22:52:39 +01:00
hugo.toml settings: Clean dest dir by default and enable gitinfo 2023-11-03 20:48:00 +01:00
LICENSE Add LICENSE 2023-10-02 10:16:51 +00:00
README.md Home: Add calendar 2023-10-20 23:37:17 +02:00

CCCHH Website

The new CCCHH website powered by the HUGO static site generator.

Website vs. Wiki

The website should contain information for new people about the club as well as upcoming events. The blog should also still exist. All other information like details on groups, projects and recurring events should be in the wiki.

  • start page (onepager)
    • who we are
    • announcements aka current blog entry (if in the future)
    • visit us -> open chaos + link to wiki for all recurring events
    • event calendar
    • groups, e.g. CTF team, CMS, freifunk, etc.
    • directions (map)
  • blog, split into:
    • (event) announcements
    • other blog posts and press releases
  • imprint

Usage

Build and Deploy

To populate the calendar data, please run fetch-calendar.sh before running hugo.

Running the hugo command without and parameters will re-generate the site in the public directory. To deploy the website, just copy the whole folder to a directory which is servered by the webserver of your preference.

Please note, that the website should be re-deployed at least daily to update the "announcement" section on the front page even if there were no changed to the content.

Add Pages

To run a local version, just install HUGO by following the instructions for your operating system. To build the website and run a development webserver, execute:

hugo server

To also build posts in the future or in draft state, run this instead:

hugo server -D

Add an Event Announcement

There are two basic types of posts: Events and articles. Events will be shown on the home page from their publishing date until they have happened.

To create a new event blog post, run a command like this:

hugo new content --kind event blog/your-event-title.md

Add a Blog Entry

As mentioned before, you can also create blog posts for things which aren't events. They will only be shown in the "blog" section and posted to the RSS feeds.

To create a new general blog post, run a command like this:

hugo new content --kind article blog/your-article-title.md

By default the first 70 words are shown as a summary on list pages. Please use <!--more--> to manually separate the summary from other post content.

Icons

You can use solid and brand icons from https://fontawesome.com/icons version 6 in your posts like this:

{{< fa envelope >}}
{{< fa brands gitlab >}}

Home One-Pager Architecture

The Home page is a one-pager which combines multiple files from the content/home directory. Each sub-directory is creating a section of the home page and all content files in these directories must have headless: true in their front matter.

If a directory only contains an index.md, it will be rendered as normal content. If there are additional markdown files, those will be rendered as a flexbox column layout. An image gallery can be added by providing a list of resources in the front matter.