You can see progress on tasks at http://waffle.io/devopsdays/devopsdays-web
This is the website for DevOpsDays.org
Here are the steps to follow to get going as an DevOpsDays content contributor (or heck, even a code contributor)
- Install Hugo v0.15+
- Fork this repo
- If you want to fire up a local copy to see your changes as you go, enter this command
hugo server -w --baseUrl="http://localhost:1313"
- The
--baseUrl
flag is kind of flaky, so a good solution is to change theconfig.toml
file to point tolocalhost
before startinghugo server -w
. DO NOT COMMIT THIS CHANGED FILE BACK TO GITHUB. Just exclude it for now. We don't add it to.gitignore
because we might need to muck with that file...although once everything is stable we might do this for safety. - You probably want to do the previous thing in another pane/window, as it needs to keep running. The -w watches for any changes and rebuilds on the fly.
- Before you make any changes, create a new branch, i.e.,
git checkout -b fix-that-thing
- Make your changes, test them locally, then push that branch up to origin (
git push origin BRANCHNAME
) - Submit a pull request from the branch you just pushed
- Ideally, this will be reviewed by someone else, but if you have commit bit on this repo and feel bold, approve it yourself :)
- When you merge to master on github, wercker will automatically build the site and publish it to http://devopsdays.github.io.
This is by no means complete, but a couple things to know:
- Create a data file for your event in
data/events
, for example,data/events/2015chicago.yml
. Note that the name of the file can NOT include special characters, such as a dash. It should follow the format ofyyyycity.yml
. It is highly recommended to just duplicate one from another event. - Generate the pages for your event, in the following manner for each page.
hugo new events/2016-kiel/welcome.md --kind=event
- The
welcome.md
file needs to have a field added to its frontmatter for the alias, i.e.,aliases = ["/events/2015-chicago"]
- Sponsors each need a file in the data directory, as such:
data/sponsors/chef.yml
. If there is an existing sponsor and you can use it, you do not need to create the data file (or the image). If your information is different, please create a new file, such asdata/sponsors/2015chicagochef.yml
. Again, no special characters in the filename, please. - Put the images for your sponsors in the
/static/img/sponsors
directory. They need to be PNG files and named exactly after the name of the sponsor in your event file (and the corresponding sponsor data file), i.e.,/static/img/sponsors/chef.png
.