Contributing to the blog
How to become an author and contribute your articles
Dependencies
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"
SUCS members
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.
Non-members
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 staff@sucs.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/