Skip to content
static site content for Hear Pete Speak
Branch: master
Clone or download
pH14 Merge pull request #46 from jessfuji/master
New content, fixed some URLs
Latest commit 280901f May 9, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets/css misuse hugo in the worst ways Apr 20, 2019
content misuse hugo in the worst ways Apr 20, 2019
contributing resize Mar 31, 2019
data Merge pull request #46 from jessfuji/master May 9, 2019
layouts wording Apr 20, 2019
static different icon Apr 9, 2019
.gitignore add converter to alternative format Apr 8, 2019
20190505-north-charleston-sc.yaml Create 20190505-north-charleston-sc.yaml May 6, 2019
LICENSE Initial commit Mar 17, 2019
README.md Update README.md Mar 31, 2019
config.yaml language, fix yaml Apr 4, 2019
converter.go formatting' Apr 10, 2019

README.md

Hear Pete Speak!

Hear Pete Speak is a catalogue of Mayor Pete's interviews. Check out the site

Contributing

Content

First and foremost, Hear Pete Speak is valuable because of its content! If you're interested in contributing and a little familiar with GitHub, read on. (We'll be thinking of a system that works well for users without GitHub accounts)

Currently, all interview data is stored in yaml files in the /data directory. The file naming scheme is yearmonthday-interview-name.yaml.

Each interview file has two required fields:

  • title: a name for the overall interview, often the name of the show / podcast / interviewer
  • date: the date the interview took place. The format is {year}-{month}-{day}.

Here's an example:

title: The Van Jones Show
date: 2019-03-30

Then we can include each of the individual topics discussed, and include direct links to those moments in the interview. An individual topic has three components:

  • categories: this is the top-level category . e.g. Healthcare, Democracy. The category here must be one listed in the category definitions file. If the category you're looking for isn't listed there, feel free to add it or file an issue and we can discuss!
  • direct_link: this is a link to the content with a timestamp. YouTube, Facebook and Overcast.fm (for podcasts) allow you to share links that jump directly to certain moments in the video or audio, which is strongly preferable.
  • tags: these are the descriptors for the link so people can find the discussions they're most interested in. We think it's best if the language on the tags comes from Pete's own language in the interview.

Let's say we created a file named 20190330-van-jones.yaml that contained:

title: The Van Jones Show
date: 2019-03-30

topics:
  -
    categories: "Democracy"
    direct_link: "https://youtu.be/PFZgbDNaEko?t=1033"
    tags:
        - Electoral College
        - structural remedies
        - Constitution
  -
    categories: "Values"
    direct_link: "https://youtu.be/PFZgbDNaEko?t=1480"
    tags:
        - faith
        - humility
        - community
        - relationships
        - trust

Here's what would be shown on the site:

example of van jones interview topic under Democracy header

example of van jones interview topic under Value header

As a method of coordination, you can file an Issue first saying that you're working on a particular interview.

Code

HPS is a simple static site built with Hugo. It's hosted on Amazon S3 and uses Cloudflare CDN. The site's intent is to work well on spotty Internet connections, browsers old and new, devices large and small, some with displays and others not (screenreaders).

If you're interested in contributing, check out the open code-related Issues or file your own.

Feature Requests / Suggestions / Bugs

Anything bugging you about the site? Create an Issue

Design Goals

We want to make Pete's content as universally accessible as possible. Timestamped links, accurate tags, fast page loads, and simple page structure are all part of this.

You can’t perform that action at this time.