Contributing to the blog
How to become an author and contribute your articles
You will need git and hugo to contribute, install git using your distributions package manager, windows users go here
# Ubuntu sudo apt install git # Arch sudo pacman -S git
For hugo, check out https://gohugo.io/getting-started/installing/#debian-and-ubuntu
Getting the source
Clone the source for the blog
# The theme is installed as a submodule hence recurse-submodules is needed git clone https://projects.sucs.org/sucs/sucs-blog --recurse-submodules
Add your bio
Create your author bio.
# Replace firstname/lastname with your name hugo new authors/firstname-lastname/_index.md
Alternatively you can copy an existing author folder and edit to suite.
Edit content/authors/firstname-lastname/_index.md, write a short bio and fill in your handles
Getting your change submitted
Checkout a new branch
# name-of-branch should be changed to represent the 'feature' you're adding, e.g "add-author" git checkout -b name-of-branch
Commit your changes (NOTE: If you’re a member you will need to )
# git status will show you which files changed, make sure you didn't modify any others! git status git add . # Will 'stage' your changed to be commited git commit -m "new-author: Add Bob Bobson as an author"
Create a fork of the blog by going to https://projects.sucs.org/sucs/sucs-blog and clicking the
fork button on the top right.
# change YOUR_USER to be your sucs username git remote add me https://projects.sucs.org/YOUR_USER/sucs-blog git push --set-upstream me name-of-branch
This tells git to push your new branch up to a new repo under your user in gitlab, you can now visit https://projects.sucs.org/YOUR_USER/sucs-blog and use the banner at the top to create a merge request.
As only SUCS members have access to our gitlab, non members will need to email in a patch that we can apply for you.
# Generate a patch, outputted to the patches folder git format-patch HEAD~1 -o patches
Send en email to firstname.lastname@example.org with the patch as an attachment, someone will review it and apply it for you.
Alternatively you can also use
git send-email, see this guide for a how-to: https://www.freedesktop.org/wiki/Software/PulseAudio/HowToUseGitSendEmail/