OpenFF website is built on Hugo and hosted on GitHub Pages.
Detailed content structure documentation is available in content/manual/_index.md
.
- Create a local copy of the OpenFF website repo:
git clone https://github.com/openforcefield/openforcefield.org
. Make sure you are on the defaultv2
branch (git checkout v2
) before yougit pull
. - Create a new branch with
git checkout -b <mybranch>
, where<mybranch>
is the name of your new branch. - Make changes and preview the site locally in your browser (see below) to make sure that your page display as intended.
- Commit the changes (
git commit .
) and push the repository to your branch (git push origin <mybranch>
). - Open a PR and request review.
- When ready, merge your PR into the
v2
branch. Deployment is automatically handled by a GitHub Action namedDeploy Hugo site to Pages
followed by the automated GitHub deployment using the new GitHub Actions method.
See more detailed instructions for creating or updating content below.
- Download and install Hugo.
- In the top-level directory, run
hugo server -D
- Copy the Web address from this line (in this example, it is
localhost:1313
):
Web Server is available at //localhost:1313/ (bind address 127.0.0.1)
- Paste the Web address into your browser