Philly CocoaHeads Website

The following site is still in development.

This repo is the source for the Philly CocoaHeads website, hosted at: https://phillycocoa.org. The site is built using the static site generator Hugo and is intended to be deployed on Cloudflare Pages from GitHub.

How to Contribute

If you spot a typo, other bug or want to work towards an existing issue, please fork the repo and do a pull request.

If you have a new idea, we'd ask you make a GitHub issue so the idea can be discussed before serious work is started.

Once changes are merged into master, Cloudflare Pages should automatically deploy the production site.

Deployment

The production deployment target is Cloudflare Pages, not the legacy S3 website.

Recommended Cloudflare Pages settings:

• Production branch: master
• Build command: hugo
• Build output directory: public
• Environment variable: HUGO_VERSION set to the Hugo version you want Pages to use

Custom domain configuration should point:

• phillycocoa.org to the Cloudflare Pages project
• www.phillycocoa.org to a redirect or alias for phillycocoa.org
• podcast.phillycocoa.org to domains.transistor.fm
• Mail records to Hover's hosted email service

After the Cloudflare cutover, the old S3 website DNS records and legacy CircleCI/S3 deployment pipeline should remain disabled.

Working with Hugo

Hugo is a static site generator written in Go. The easiest way to get Hugo is through Homebrew.

brew update
brew install hugo

Then from the command line, to launch a local server use:

hugo server --theme=phillycocoaheadtheme --buildDrafts

Afterwords, point your browser at http://localhost:1313/ and you'll see our site. The site should Live Reload as you make content changes.

Hugo has some great documentation but I'll try to cover the basics here.

To make a new page or blog post, just duplicate one of the current files. Be sure the front matter (the metadata at the top) is up to date and accurate.

While there is a command line for hugo to make new pages or blog post we have not built those tools into our custom template yet.

For example pages usually have a type and title:

---
type: page
title: About
---

The type helps identify how the content should be rendered and the title will be the title used for the HTML title tag.

For blog posts there is a date (should not be a future date) and draft flag.

If you need to add images, look to the /static/ folder. Those files will be posted to the root of the site and you can assume your image will live at: /images/hello.png.