These pages are all written in markdown.
I believe you have to be an author/member of SBNSoftware in order to be able to edit the site. You can ask one of the site owners for permission.
You should also have a Github username and Personal Access Token (PAT). You can create a PAT here: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
Directly
Direct edits work best when editing a single page
- Go here:
- https://sbnsoftware.github.io/
- Go to the page you want to edit
- Click on “improve this page” at the top
- This will take you to the github repository where you can directly edit and commit to the master branch.
On own working branch
Creating a working branch works best when editing or creating multiple pages.
- Go to the github repository for our website:
- https://github.com/SBNSoftware/SBNSoftware.github.io
- Copy the url to clone the repo
- On your own local computer or a Fermilab computer, clone the repository:
git clone <url>
- Create your own local working branch:
git checkout -b <your_branch>
- Make your local changes. Unfortunately, there does not seem to be an easy way to test these local changes on a development version of the website. If anyone wants to dig into the Jekyll framework and add instructions, that would be great.
- Push your new local branch to the upstream repository:
git push -u origin <your_branch>
- The
-u
is short for--set-upstream
- The
- You may have to enter your Github username and PAT when it prompts you.
- On the repo https://github.com/SBNSoftware/SBNSoftware.github.io, PR your branch with the master branch
- In about 5 minutes, you should see your edits live on the site.