albertchae / jupiterbroadcasting.com

JupiterBroadcasting.com, hugo-based and community-driven!

JupiterBroadcasting.com, et al. Websites

Repo here includes issue tracking for:

• JupiterBroadcasting.com
• LINUX Unplugged
• Self-Hosted
• Coder Radio
• Linux Action News
• Jupiter Extras
• Office Hours

Contributing

Firstly - thank you for being here! We appreciate you.

Please read our Contributor Guidelines on how to contribute wisely for all to benefit.

Discussions via Matrix

Our base of operations for group discussions: Jupiter Web Site on Matrix

---

Built with Hugo and deployed with Github Actions

Demo: https://jupiterbroadcasting.com - currently the production site!

Development Environment Setup

The site is deployed to production as a container and therefore we recommend development is done using docker. A convenient command in the makefile is provided to help you get started. If you're new to docker start here.

To build and run the site run

make dev

This will build the site (all 28000+ pages) and takes anywhere from 30s - 5 minutes depending on your hardware. This is expected due to the size of the site.

Deployment

Deployment is done with Github Actions, see workflow file in .github/workflows/deploy-prod.yml At the moment it is only triggered when something in the main branch is changing, but it can also be set up to run at certain times. This would also enable scheduled publishing, since Hugo per default only builds pages which have set date in frontmatter to <= now.

When upgrading the hugo version these are the locations whicht it needs to be updated at:

• Dockerfile
• Dockerfile.dev

Currently we're at hugo version 0.101.0

Credits

• Parts of the functionality are from the Castanet Theme: https://github.com/mattstratton/castanet Mainly the RSS feed generation and managing of hosts / guests.

• ironicbadger and JB Show Notes project which was used as the base for the show-scraper

Content Migration and Scraper

We moved the scraper to it's own repository here: https://github.com/JupiterBroadcasting/show-scraper Much love to https://github.com/kbondarev aka Kiro in Matrix <3!