79 lines
3.1 KiB
Markdown
79 lines
3.1 KiB
Markdown
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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.
|