2.2 KiB
Running Locally
- Install dependencies:
npm install - Start Gulp for asset compilation:
gulp - In a new terminal window, start the server:
docker-compose up - Open
http://localhost:1313in a browser
Edit the .scss and .js files in the /src directory (NOT in /static).
Adding new episodes
docker exec awebpodcast_hugo_1 hugo new episodes/201X-XX-XX-SXXEXX-episode-title-here.md
You can create this file by hand in the filesystem, but the above command will use the
archetypes/episodes.md template to populate all the necessary front matter, saving
you precious, precious time.
Adding new pages
This probably won't happen often, but if needed, run:
docker exec awebpodcast_hugo_1 hugo new somepage.md
Pushing to dev
- Push your changes to the
devbranch:git push origin my-branch-name:dev - Test on
https://dev.awebpodcast.org
Pushing to stage
Any merge to the master branch will automatically update the staging site:
https://stage.awebpodcast.org/
A notice will be posted in #irlpodcast-notify on Slack when the push has completed.
Pushing to production
Episode deployments typically happen at 6AM PT on the publish date. Please post in #a-web-podcast-page (private channel) on Slack.
It is responsibility of the person who codes the episode to find someone to push if 6AM PT is too early for them. All members of MozMEAO are happy to do this.
- Verify all is good on the staging site
- If the episode was merged before the publish date it will not be visible on staging. You can see it on staging by either re-running the Jenkins job (if you have permission) or by merging a new pull request. If there are no reviewed pull requests that are ready you can submit one that changes the publish date to 1 minute earlier.
- Make sure your local
masterbranch is up to date - Push the
masterbranch to theprodbranch:git push origin master:prod
A notice will be posted in #irlpodcast-notify on Slack when the push has completed.