Pages & Documentation

For 2026 HTGAA Committed Listeners are required to submit their homework and documentation with and through the git-based HTGAA 2026 Documentation Server. Each students will get their own git repository, from which your personal student website will be automatically build.

Access

Registered participants of HTGAA 2026 will be given access to the HTGAA Documentation Server after Class #1 on Feburary 3rd.

Example Repository:
https://edit.htgaa.org/georg-tremmel/webpages

Example Website: (will be build automatically from the repository)
https://pages.htgaa.org/georg-tremmel

All your homework and documentation will be publicly accessible.

To Do: Add Screenshots

Authoring

Markdown Syntax

Your content will be written in Markdown, a simple syntax to add formatting to plain text. If you are unfamiliar with Markdown, please have a look at this Introduction to Markdown.

Editing Files with the Online Editor (easy)

The HTGAA Repositories have a web-based editor:

Log into your account
Navigate to the file you want to edit
Click the Edit file icon
Edit
After Editing, save the changes by clicking Commit Changes

To Do: Add Screenshots

Adding Images

To Do: How to add images
To Do: How to scale down images

Cloning your Repo and runnig a Local Instance of Hugo (advanced)

cd my-local-directory
git clone https://edit.htgaa.org/georg-tremmel/webpages.git

git clone https://edit.htgaa.org/georg-tremmel/webpages.git my-local-directory

Git

Files can now be edited on your computer. To push the changes to the server and update the website, the follow steps are necessary:

Git Command
1. `git add *`	Add all new and changed files
2. `git commit`	Locally commit your changed. You will be asked to provide add a short message. Can also be concatenated into `git commit -m ‘my message``
3. `git push`	Uploads and pushes the changes onto the HTGAA Server, the website is rebuilt after a few seconds. You will be asked for your credentials.

Git is much more powerful - and complex - but these 3 commands will be used most often.

If you change file on the server, make sure to do a git pull to download the latest changes.

Running a Local Version of Hugo

Install the lastest version of Hugo.

Technical Details

Forgejo self-hosted lightweight git-based software forge’, functional similar to GitHub and GitLab
Hugo SSG (Static Site Generator) with the Relearn Theme

You don’t need to edit/change your Hugo theme. But if you really (really) want, you can. But make sure we can navigate the site and find your homework.

To Do

Add Screenshots showing the login process