Basic article editing on the student council website

Applicability⌗

This guide shows you how to do make small changes to the public  and internal  website of the student council. Larger edits, such as creating new pages or changing more than a few sentences, should be done locally. A guide for local edits will follow.

System Requirements⌗

• Web browser

Editing an article⌗

1. Go to the page you want to edit.
2. Click on Bearbeite diese Seite im GitLab/Edit this page in GitLab

   

   1. If you are familiar with Janus you can skip to step 3.
      Otherwise, sign in to the GitLab with Janus.

      

   2. Login with the type Password and use the credentials of your RZ account (this is the account that you also use to login to ILIAS).

      

3. Edit the markdown  source of the website.
4. Publish the changes by committing them to the repository.
   1. Open the web editor’s Source Control pane by clicking on the git icon on the left, or by pressing Ctrl+Shift+G.

      

   2. Summarise the changes in the Commit message box at the top of the Source Control pane.
   3. Click on Commit to 'master' to publish the changes.

The changes are now saved. Wait a few minutes for the CI pipeline to build and deploy the new version. It should take no more than 5 minutes to see the changes on the live site.

If you are impatient, you can check the status of the pipeline (public website , internal website ). The CI pipeline is complete when all the circles have turned green or yellow. It should then take less than a minute to deploy.

Troubleshooting⌗

Symptom	Problem	Solution
The changes are not visible on the website.	The CI pipeline takes some time to build and deploy the site.	Wait 5 minutes and try again. Reload the website without the browser cache using Ctrl+Shift+R. The footer shows the date when the page was last changed. The last commit can be found at about/version/.
Sorry, you are not authorized to access this application. when trying to log in to Janus.	Your user account does not have the fachschaft group set in Janus.	Contact an admin of the student council.
You don't have write access when editing the page in GitLab.	You are not in the fachschaft group in the GitLab.	Contact an admin of the student council.
There are no or very few (<10) items are listed on your GitLab front page.	You are probably missing the fachschaft group in the GitLab.	Contact an admin of the student council.