# https://köln.sonoj.org/

This is the root copy of the Sonoj Köln website.
The webserver uses it's own read-only git clone of this repository.

## Main Site

https://köln.sonoj.org/

Dates for the next meetings are automatically calculated.
For everything else edit the HTML files by hand.

## Deploying the website

This website is deployed to our Uberspace as simple read-only https git clone from upstream
Codeberg, which has LFS (see below) We got an out-of-memory error for git lfs for one single file.

On ssh sonoj.org

First time setup:
```
cd ~
composer require vstelmakh/url-highlight
#Later adjust the user home directory in protokolle.php so PHP can find the vendor directory.

cd domains/xn--kln-sna.sonoj.org

# 1) clone without LFS smudge (avoids the checkout-time failure)
GIT_LFS_SKIP_SMUDGE=1 git clone --depth 1 https://codeberg.org/Sonoj/koeln.sonoj.org.git .
#or for write access, not on the server:
# GIT_LFS_SKIP_SMUDGE=1 git clone --depth 1 ssh://git@codeberg.org/Sonoj/koeln.sonoj.org.git


# 2) reduce LFS memory/parallelism (repo-local)
git config --local lfs.concurrenttransfers 1
git config --local lfs.transfer.maxretries 10

# 3) download LFS objects and materialize them into the working tree
git lfs pull
git lfs checkout
```

Update later:
```
git pull --ff-only
git lfs pull
git lfs checkout
```

## Archive

https://köln.sonoj.org/archiv/

Each sub directory is one talk or project.
Everything that has a metadata.ini file will be parsed by the index generator program.
Possible index files are index.html index.php and index.pdf

## Large File Storage

Since we host large files, like music sessions, in the archive it needs git large file storage for
codeberg. git lfs is detected by codeberg, you or other users don't need to setup anything on codeberg,
just in the local repositories.


Install git-lfs on your system.  https://git-lfs.com/
Go into the git root


Check for potential files:
`git lfs migrate info --everything`

Track large files

```
git lfs install
git lfs track "*.ardour-session-archive"
git lfs track "*.zip"
git lfs track "*.wav"
git lfs track "*.flac"
git lfs track "*.tar.gz"
git add .gitattributes
```

Now the usual git stuff:

```
git add mysong.ardour-session-archive
git commit -m "Add ardour project"
git push
```

If you accidentally commited files before adding them to the lfs tracker you need git lfs migrate:
https://codeberg.com/git-lfs/git-lfs/blob/main/docs/man/git-lfs-migrate.adoc?utm_source=gitlfs_site&utm_medium=doc_man_migrate_link&utm_campaign=gitlfs


Convert the existing files:
`git lfs migrate import --everything --include="*.ardour-session-archiv"`