Files
AndreaSlopFotografie/design/andreaslop-static/README.md
T

177 lines
6.9 KiB
Markdown

# Andrea Slop Fotografie — statisch HTML/CSS/JS template
Statische herbouw van [andreaslop.nl](https://andreaslop.nl/) (WordPress + Solene-thema),
bedoeld als tussenstap naar een React Vite front-end met een .NET API back-end.
Geen build-stap, geen npm, geen framework. Openen in de browser en klaar.
---
## 1. Aan de slag
```bash
# 1. Haal de afbeeldingen op van de live site
bash scripts/download-images.sh # macOS / Linux / WSL / Git Bash
```
Op Windows: dubbelklik `scripts\download-images.cmd`. Draai het `.ps1`-bestand
niet direct aan (`.\download-images.ps1`), want dan blokkeert de execution
policy het met "is not digitally signed". Zie
[scripts/POWERSHELL-PROBLEMEN.md](scripts/POWERSHELL-PROBLEMEN.md) als het
alsnog misgaat.
```bash
# 2. Start een lokale server (nodig voor correcte paden en fonts)
python3 -m http.server 8080
# of: npx serve .
```
Ga daarna naar <http://localhost:8080>.
`index.html` direct openen met `file://` werkt ook, maar een lokale server is
prettiger omdat je dan geen CORS-gedoe krijgt als je later een API aanhaakt.
Het downloadscript slaat bestaande bestanden over. Gebruik `--force` (bash) of
`-Force` (PowerShell) om alles opnieuw op te halen.
---
## 2. Structuur
```
.
├── index.html Home
├── over-mij.html Over mij
├── portfolio.html Portfolio (raster + lightbox)
├── soorten-fotoshoots.html Soorten fotoshoots
├── contact.html Contact
├── assets/
│ ├── css/style.css Alle styling, met design-tokens bovenaan
│ ├── js/main.js Alle interactie, opgesplitst per module
│ └── img/
│ ├── manifest.txt Lokale bestandsnaam -> bron-URL
│ └── ... Wordt gevuld door het downloadscript
├── scripts/
│ ├── download-images.sh
│ ├── download-images.ps1
│ ├── download-images.cmd Dubbelklikbaar op Windows
│ └── POWERSHELL-PROBLEMEN.md
└── README.md
```
Header, mobiel menu, side area en footer staan letterlijk in elke pagina in
plaats van via JavaScript ingeladen. Dat is bewust: het blijft pure HTML, en
elk van die blokken is straks een-op-een een React-component.
---
## 3. Design-tokens
Alles wat je waarschijnlijk wilt bijstellen staat bovenaan `assets/css/style.css`
in `:root`. Kleuren, lettertypes, typeschaal, spacing, breedtes, header-hoogtes,
schaduwen en animatieduur. Verander daar één waarde en het werkt door in de hele
site.
De gekozen richting: warm papier als achtergrond zodat de foto's alle kleur
dragen, een heidegroen accent (`--c-accent`) dat verwijst naar de locaties in de
teksten (Soesterduinen, de heide), Marcellus als displayfont en Jost voor de
lopende tekst. Beide fonts komen van Google Fonts; wil je offline kunnen werken,
download ze dan en zet ze lokaal in `assets/fonts` met een `@font-face`-blok.
---
## 4. JavaScript
`assets/js/main.js` bevat losse init-functies, elk gekoppeld via `data-`
attributen zodat CSS-klassen puur voor styling blijven:
| Module | Hook | Wat het doet |
| --- | --- | --- |
| `initHeader` | `data-header` | Voegt `header--sticky` toe bij scrollen |
| `initMobileNav` | `data-nav-toggle`, `data-mobile-nav` | Mobiel menu |
| `initSideArea` | `data-side-area` | Het "Info Menu" paneel rechts |
| `initHeroSlider` | `data-hero` | Crossfade-slider met thumbnails en voortgangsbalk |
| `initLightbox` | `data-lightbox` | Portfolio-lightbox met pijltjestoetsen en Esc |
| `initContactForm` | `data-contact-form` | Validatie en verzending |
| `initReveal` | `.reveal` | Fade-in bij scrollen via IntersectionObserver |
| `initToTop` | `data-to-top` | Terug-naar-boven-knop |
`prefers-reduced-motion` wordt overal gerespecteerd: de slider stopt met
autoplay en alle transities worden uitgezet.
---
## 5. Het contactformulier
Velden: **Naam**, **E-mail**, **Onderwerp**, **Bericht** (placeholder
"Stel hier je vraag"). Validatie gebeurt in JavaScript, met foutmeldingen per
veld en `aria-invalid` voor screenreaders.
Er is nog geen back-end. `submitContactForm(payload)` in `main.js` logt de
payload en doet alsof het gelukt is. Voor je .NET API vervang je alleen de body
van die functie:
```js
function submitContactForm(payload) {
return fetch('/api/contact', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
}).then(function (res) {
if (!res.ok) throw new Error('Versturen mislukt');
return res.json();
});
}
```
De payload is `{ naam, email, onderwerp, bericht }` — dat mapt direct op een
`ContactRequest` record in C#.
---
## 6. Wat ik niet uit de live site kon halen
Dit staat hier zodat je het kunt controleren voor je verder bouwt:
- **Exacte fonts, kleuren en spacing.** De Solene-instellingen zitten in de
WordPress-database, niet in de HTML. Wat er nu staat is mijn interpretatie;
pas `:root` aan als je de echte waarden hebt.
- **De Instagram-feed** (op Home en Portfolio) is op WordPress een widget die
live data ophaalt. Ik heb er een raster van zes bestaande foto's neergezet als
placeholder, met links naar het profiel. Voor echte data heb je de Instagram
Basic Display API of een dienst als Behold/SnapWidget nodig.
- **Alt-teksten.** De originele afbeeldingen hebben bestandsnamen als
`DSC_0445` als titel. Ik heb beschrijvende Nederlandse alt-teksten geschreven;
laat Andrea die nalopen, ze zijn ook goed voor SEO.
- **Het hero-gedrag.** Op de live site is dit een Slider Revolution-slider. Ik
weet niet welke timing en overgang daar ingesteld staan. Nu: crossfade van 6
seconden per slide met een langzame inzoom. Aanpassen kan in `initHeroSlider`
(constante `DURATION`) en in `.hero__slide img` in de CSS.
- **De portfolio-layout.** Ik heb er een raster van drie kolommen met lightbox
van gemaakt. Als het origineel masonry is met wisselende hoogtes, zeg het even.
## 7. Opgeruimde demo-restanten
Op de live contactpagina zaten nog twee links uit de Solene-demo:
`mailto:Solene@qodeinteractive.com` achter het Email-blok en
`tel:123456789045678` achter het Instagram-blok. Die heb ik hier weggelaten.
Ze staan nog wél op de WordPress-site — dat is los van dit project het
opruimen waard.
---
## 8. Naar React Vite
De vertaling ligt er redelijk voor:
- `Header`, `MobileNav`, `SideArea`, `Footer`, `ToTop` → layout-componenten
- `HeroSlider`, `IntroGallery`, `AboutBlock`, `PricingCard`, `ShootBlock`,
`PortfolioGrid`, `Lightbox`, `ContactForm`, `InstagramGrid` → losse componenten
- De pagina's worden routes; `aria-current="page"` wordt `NavLink`
- `initReveal` wordt een `useReveal`-hook rond dezelfde IntersectionObserver
- `style.css` kan als losse stylesheet mee, of je knipt hem per component op —
de tokens in `:root` blijven in beide gevallen hetzelfde
- De teksten en de fotolijsten staan nu hard in de HTML. Wil je dat Andrea zelf
content beheert, dan zijn dat de eerste endpoints voor de .NET API
(`/api/pages`, `/api/portfolio`, `/api/packages`).