This is how I set up my environment: (I am using gitpod.io for editing)
- fork the repo to your own github account
- prepend
gitpod.io#
to the beginning of your github url. Mine becomes:https://gitpod.io#github.com/brentley/appmeshworkshop
- once gitpod has started, in the terminal, run
npm install && npm run theme
This will install the dependencies and clone the theme submodule.
From here, you can use the online IDE to edit /content/chapter/filename.md...
If you want to preview your edits, in the terminal, run:
npx hugo server
.
That will start the local hugo server.
A dialog box will pop up telling you "A service is listening on port 1313, but is not exposed." -- press the expose button. After that, choose "open browser" to get a new tab with your preview site. As you save edits, this tab should refresh.
When you're happy with your edits, commit, push, and open a pull request to the upstream repo's master branch. Once merged, the preview site (linked above) will be refreshed.