Website-2026/README.md

Marcus Allison — Portfolio (Static site)

Quick deploy instructions for an nginx host (Debian/Ubuntu):

1. Copy files to the web root on the server:

   sudo mkdir -p /var/www/marcus sudo cp -r "*" /var/www/marcus/ # run from the project folder or copy files individually sudo chown -R www-data:www-data /var/www/marcus

2. Place the nginx server block (nginx/marcus_allison.conf) into /etc/nginx/sites-available/ and enable it:

   sudo cp "nginx/marcus_allison.conf" /etc/nginx/sites-available/marcus_allison sudo ln -s /etc/nginx/sites-available/marcus_allison /etc/nginx/sites-enabled/

3. Test nginx config and reload:

   sudo nginx -t sudo systemctl reload nginx

4. (Optional) Provision HTTPS with Certbot (Let's Encrypt):

   sudo apt update && sudo apt install certbot python3-certbot-nginx sudo certbot --nginx -d portfolio.example.com -d www.portfolio.example.com

5. Docker alternative (serve static site with nginx container):

   docker run --rm -p 80:80 -v "$(pwd):/usr/share/nginx/html:ro" nginx:stable

Customize:

• Replace portfolio.example.com with your real domain.
• Update contact email in index.html (now set to marcus.sailer@organic-server.org).

Photography gallery:

• To regenerate images/manifest.json after adding/removing photos, run:

python3 scripts/generate_manifest.py

• Alternatively, enable Nginx directory listing for /images/ so the site can probe the directory. Example server block fragment for /images/ only:

location /images/ {
   alias /var/www/marcus/images/;
   autoindex on;
}

Blog support:

• Add plain text files to the blog/ directory. Supported extensions are .txt and .text. Each file should start with a date/time line, then a title line, then the body.
• To attach a file, place it in blog/files/ and reference it in the post with [[file: filename.ext]] or [[attachment: filename.ext]].
• Run python3 scripts/generate_blog_manifest.py from the project root to refresh blog/manifest.json after adding or removing posts.

Git sync:

• Use ./scripts/sync_site.sh from the website root to pull changes from Git via HTTP.
• The default remote is https://git.organic-server.org/organic-CPU/website-but-better.git and the branch is main.
• By default it deploys to /var/www/html, which is the default nginx document root on most Linux distributions.
• Override with GIT_REPO_URL, GIT_BRANCH, or DEPLOY_DIR if needed.

Automatic sync every 12 hours:

• Copy scripts/sync_site.service and scripts/sync_site.timer to /etc/systemd/system/.
• Update sync_site.service to point at the actual repository path on your server.
• Then enable and start the timer:

sudo systemctl daemon-reload
sudo systemctl enable --now sync_site.timer

This makes the website sync twice per day and deploy the latest files to nginx root.

Editing the Git link:

• Update the header Git link in index.html at the element with id git-link to your repository URL.

If you want, I can also:

• Add a Docker Compose service for a static site + automatic certs.
• Produce a small resume/JSON-LD metadata file for SEO.