4.4 KiB
Portfolio Landing Page + Git Instance Visuals
Architecture
- Root domain (
https://gabrielpereira.me/) → Portfolio landing page - Git subdomain (
https://git.gabrielpereira.me/) → Gitea/Forgejo instance
This separation means visitors hit the curated portfolio first, then choose which repository to explore.
1. Portfolio Landing Page
The site is a static, single-page portfolio with no build step. index.html contains the page, styles, translations, and interactions; assets/gabriel-pereira.jpg is the locally hosted profile photo. Google Fonts supplies the typography, with system-font fallbacks.
Languages
- English (EN-US) is the default at
https://gabrielpereira.me/. - Portuguese (PT-BR) is available through the language switch or directly at
https://gabrielpereira.me/?lang=pt-BR. - An explicit language choice is saved in the visitor's browser and restored on their next visit. A language in the URL takes priority over the saved choice.
- The English content is also the no-JavaScript fallback. PT-BR switching and the language selector require JavaScript.
- Service interest links use a localized email subject in the selected language.
Deployment: Static Host (Recommended)
GitHub Pages
- Create repo
gabrielpereira/gabrielpereira.me - Commit
index.htmlas the repo root (or in/docsfolder) - Enable Pages → deploy from root (or
/docs) - In repo Settings → Pages, add custom domain
gabrielpereira.me - Add DNS A record pointing to GitHub Pages IPs
Cloudflare Pages
- Deploy the
portfolio/folder, includingindex.htmlandassets/ - Custom domain:
gabrielpereira.me
Netlify / Vercel
- Drag the
portfolio/folder into deploy UI - Set custom domain to
gabrielpereira.me
Deployment: Self-Hosted (Nginx/Caddy)
Copy index.html and the complete assets/ directory to:
/var/www/gabrielpereira.me/
The resulting profile photo path should be:
/var/www/gabrielpereira.me/assets/gabriel-pereira.jpg
Nginx config:
server {
listen 443 ssl;
server_name gabrielpereira.me;
root /var/www/gabrielpereira.me;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
server {
listen 443 ssl;
server_name git.gabrielpereira.me;
location / {
proxy_pass http://localhost:3000; # your Gitea/Forgejo
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Caddyfile:
gabrielpereira.me {
root * /var/www/gabrielpereira.me
file_server
}
git.gabrielpereira.me {
reverse_proxy localhost:3000
}
2. Gitea / Forgejo Visual Improvements
The file git-custom-header.html contains both CSS overrides and an HTML banner.
How to apply
Forgejo / Gitea v1.20+ (Admin Panel)
- Log in as admin → Site Administration → Customizations
- Paste the
<style>block into "Custom Header" (or "Custom CSS" if available) - If your version supports HTML injection, also paste the banner
<div>block - Save
Direct file (self-hosted server access) Create the custom templates directory for your instance:
# For Gitea/Forgejo installed from package
sudo mkdir -p /etc/gitea/templates/custom
# Or if installed from binary in /opt
sudo mkdir -p /opt/gitea/custom/templates/custom
Create header.tmpl:
sudo tee /etc/gitea/templates/custom/header.tmpl << 'EOF'
{{/* Paste the contents of git-custom-header.html here */}}
EOF
Restart Gitea/Forgejo:
sudo systemctl restart gitea
# or
sudo systemctl restart forgejo
What the CSS changes
- A darker, simplified color palette for repository pages
- Repository cards with rounded corners and hover effects
- Better typography and spacing
- A subtle "Open Evidence" badge concept on the homepage
- Improved navbar and footer styling
3. DNS Configuration
| Record | Type | Target |
|---|---|---|
gabrielpereira.me |
A | Your static host IP (GitHub Pages / server / CDN) |
git.gabrielpereira.me |
CNAME or A | Your Gitea/Forgejo server |
Files
| File | Purpose |
|---|---|
index.html |
Portfolio landing page (no build step) |
assets/gabriel-pereira.jpg |
Locally hosted profile photo used by the page and social metadata |
git-custom-header.html |
CSS + HTML for Gitea/Forgejo customizations |
DEPLOY.md |
This file — deployment instructions |