$ brew install hugo
Pick the appropriate binary from here: https://github.com/gohugoio/hugo/releases
$ hugo
$ hugo server -w
Hit http://localhost:1313 to verify that the site was generated correctly
Creating a new page can be as simple as creating a file (xyz.html) in the /content folder. Or via the command line (at the root directory of this repo):
$ hugo new xyz.html
These new pages will follow the layout template in /themes/digitalservices/_default/single.html
- When a new person joins the team, get their profile photo in .jpg or .png formats
- Add their profile photo to the
themes/static/assets/staff-imgsfolder, name it like this:firstname.jpgorfirstname.png - Follow the instructions above to build the site locally and preview changes.
- Edit the
content/ourteam.htmlfile, add team members in<div id="staff">by adding a new<li class="col-xs-12 col-md-6 col-lg-4">block - Make sure that their name, job title and photo are correct
- Submit a PR
- Once your PR has been approved by a reviewer, who will also send you a preview of your changes (in the form of a Pantheon link), check your preview then merge your PR. If you are not happy with the changes, commit to the same branch, which will generate another Pantheon preview.
- Merge your PR
- Reach out to someone with server access (currently, that would be @skinnylatte, @aekong and @henryjiang-sfgov) to deploy with the following commands
As of August 2021, you no longer have sudo access to this server. This readme file is being updated to remove all mention of using sudo for git fetch.
$ cd /opt/rh/httpd24/root/var/www/html/digitalservices/public
$ git fetch --all
$ git reset --hard origin/gh-pages
- Never ever edit files in /public directly (this is hugo generated)
- This repo is a very basic site, with very few (what hugo calls) content types
- Refer to Hugo documentation at https://gohugo.io/documentation/