Cloud Native Linz Website

Official website for the Cloud Native Linz community.

🌐 Website: https://cloudnativelinz.at

📅 Meetup page: https://www.meetup.com/Cloud-Native-Linz/

💬 Community page: https://ocgroups.dev/cncf/group/cloud-native-linz

Quick Start

This site is built with Jekyll.

Recommended: Dev Container or Codespaces

The easiest setup is GitHub Codespaces or VS Code Dev Containers, where tooling is preconfigured.

Run locally:

bundle install
bundle exec jekyll serve --livereload

Open preview at: http://127.0.0.1:4000

If file watching is unreliable on your machine (commonly Windows), use:

bundle exec jekyll serve --livereload --force_polling

Makefile Commands

This repository includes common shortcuts in makefile:

• install: Install Ruby dependencies and run a build
• build: Run a strict production build
• lint: Check Python, YAML, and Ruby sources
• test: Generate the calendar and run a production build
• check: Run all lint and test checks
• serve: Run Jekyll server on all interfaces
• serve-livereload: Run server with live reload
• serve-windows: Live reload with force polling
• clean: Remove build and cache artifacts
• calendar: Generate calendar.ics from event data

Examples:

make install
make check
make serve-livereload
make calendar

Content and Data

Key locations:

• Pages: _pages
• Layouts: _layouts
• Includes: _includes
• Styles: assets/style.scss
• Event data: _data/events.yml
• Event banners: images/events

Event Banners

Store event banners in images/events/ as <id>.jpg, using the numeric id from _data/events.yml. For example, event 51 uses images/events/51.jpg. Keep filenames lowercase and use the .jpg extension. No additional image field is needed in the event data.

Upcoming event cards, past event cards, and event detail pages all use the same local banner. Separate -550.jpg thumbnails are not required. If an image is missing, the site displays images/cloudnativelinz-banner.png as a fallback.

Add new banners directly to images/events/, not the generated _site/ directory. Jekyll copies them to the built site automatically. Speaker photos are separate from these event banners.

This repository publishes supplied banners; it does not generate them automatically. When creating or updating an event, commit the corresponding images/events/<id>.jpg if a new or updated banner is needed. Changes to event data do not regenerate existing banners.

Event URL Redirects

Event pages use stable slugs to avoid broken links when titles change.

• Guide: REDIRECT_MANAGEMENT.md
• Helper script: manage_redirects.rb
• Redirect generator plugin: _plugins/datapage_redirect_generator.rb

Typical workflow:

ruby manage_redirects.rb
bundle exec jekyll build

Calendar Generation

The repository can generate calendar.ics from event data.

• Script: generate_calendar.py
• Python deps: requirements.txt

Run via Makefile:

make calendar

Build and Deploy

GitHub Pages builds and serves this site from this repository.

To validate locally before pushing:

make check

Contributing

Contributions are welcome.

1. Create a branch
2. Make your changes
3. Build locally and verify
4. Open a pull request