Files
codevisoft/README.md
T
2026-09-06 11:56:26 +02:00

54 lines
1.9 KiB
Markdown

# codevisoft.com
Static about/portfolio page for Codevisoft (Paweł Szudarek), meant to be hosted on a Raspberry Pi.
## Structure
- `index.html` — page content
- `materials.html` — downloadable talk/workshop materials (slides, project files)
- `styles.css` — styling
- `script.js` — small footer-year script
- `images/` — logo assets
- `materials/<talk-name>/` — one folder per talk, holding its `slides.pdf` and `project.zip`
No build step — plain static files.
## Deploying on the Raspberry Pi (nginx)
1. Install nginx if not already installed:
```
sudo apt update && sudo apt install nginx
```
2. Copy the site files to the web root, e.g.:
```
sudo mkdir -p /var/www/codevisoft
sudo cp -r index.html styles.css script.js images /var/www/codevisoft/
```
3. Create an nginx server block, e.g. `/etc/nginx/sites-available/codevisoft`:
```
server {
listen 80;
server_name codevisoft.com www.codevisoft.com;
root /var/www/codevisoft;
index index.html;
}
```
4. Enable it and reload nginx:
```
sudo ln -s /etc/nginx/sites-available/codevisoft /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
```
5. Point your router's port forwarding (80/443) and DNS `A` record for `codevisoft.com` at your public IP, or use a tunnel (e.g. Cloudflare Tunnel) if you don't want to expose the Pi directly.
6. For HTTPS, use `certbot` (`sudo apt install certbot python3-certbot-nginx`) once DNS is pointed at the Pi.
## Editing content
Edit `index.html` directly — sections are marked `About`, `Portfolio`, and `Contact`. Update the email address, portfolio entries, and links as needed.
## Adding a new set of materials
1. Create a folder under `materials/`, e.g. `materials/my-talk/`.
2. Drop the files in it, e.g. `slides.pdf` and `project.zip`.
3. Add a `<article class="card">` entry in `materials.html` with download links pointing at those files (copy an existing card as a template).