updated pages/blog from vps

blog/come-scrivere-un-viaggio.md

@@ -2,6 +2,8 @@
 title: 'Come scrivere una storia di viaggio (il vostro prossimo articolo)'
 pubDate: '2026-05-02'
 description: 'Guida per raccontare le vostre avventure in bicicletta'
+heroImage: '/blog-placeholder-2.jpg'
+
 ---
 
 I blog post sono il **cuore emozionale** di questo giardino. Sono i vostri racconti veri: il viaggio in Marocco, la non-stop Barcellona-Valencia, il disastro meteo a 2000m.

pages/bincio-activity.md

@@ -0,0 +1,142 @@
+---
+title: BincioActivity
+---
+
+BincioActivity è il sito dove raccogliamo tutte le nostre attività in bici: uscite, gare, gite. Ogni membro ha il proprio profilo con le sue uscite, distanze, dislivelli e tracce GPS.
+
+[[BincioTech]]
+
+---
+
+## Come caricare le attività
+
+### Da file GPX / FIT / TCX
+
+Questi sono i file che producono il Garmin, il Karoo, o qualsiasi altro ciclocomputer. Anche Strava ti permette di esportarli.
+
+1. Apri il sito e clicca **Upload**
+2. Trascina i file nella finestra, oppure clicca per sceglierli
+3. Il sito li elabora e li aggiunge al tuo profilo
+
+Puoi caricare più file in una volta sola. I duplicati vengono ignorati automaticamente.
+
+### Da Strava
+
+Se usi Strava, puoi collegare il tuo account e importare le attività direttamente:
+
+1. Nel menu di upload, clicca **Sync from Strava**
+2. Autorizza l'accesso (una sola volta)
+3. Le attività vengono importate automaticamente
+
+La connessione a Strava è opzionale — puoi sempre usare i file diretti dal ciclocomputer.
+
+---
+
+## Come modificare un'attività
+
+Clicca **Edit** su qualsiasi attività per:
+
+- **Cambiare il titolo** — rinominare l'uscita
+- **Aggiungere una descrizione** — racconta com'è andata, scrivi note, aggiungi riflessioni (supporta il markdown)
+- **Caricare foto** — aggiungi immagini scattate durante l'uscita
+- **Scegliere il tipo di sport** — ciclismo, corsa, escursione, sci...
+- **Assegnare la bici o il gear** — per tenere traccia di quale mezzo hai usato
+- **Nascondere l'attività** — se non vuoi che appaia nel feed
+
+Le modifiche si salvano subito.
+
+### Ricalcolare il dislivello
+
+Se il dislivello sembra strano (troppo alto o troppo basso), nel pannello di modifica ci sono due pulsanti per correggerlo:
+
+- **Ricalcola (hysteresis)** — usa i dati di quota già registrati, ma applica un filtro per eliminare il rumore. Veloce, funziona offline. Ideale per Garmin, Karoo, Wahoo (che hanno l'altimetro barometrico).
+- **Ricalcola (DEM)** — scarica i dati di quota dal terreno reale (modello digitale del terreno) e sostituisce quelli GPS. Più preciso per dispositivi senza altimetro barometrico.
+
+---
+
+## Privacy
+
+Ogni attività può essere:
+
+- **Pubblica** — visibile a tutti i membri del sito
+- **Non elencata** — non appare nel feed, ma è accessibile a chi ha il link diretto (utile per condividere con qualcuno senza metterla in evidenza)
+
+---
+
+## App mobile
+
+C'è anche un'app per Android (e presto iOS) che permette di:
+
+- Importare le attività direttamente dal telefono o dal Karoo
+- Vedere il proprio feed offline
+- Sincronizzare le attività con il sito
+
+Per il Karoo: l'app legge i file FIT direttamente dalla cartella `/Rides` senza bisogno di esportarli. Apri l'app dopo un'uscita e le attività compaiono da sole.
+
+---
+
+## Per i più autarchici: deployment e federazione
+
+BincioActivity è software libero, pensato per girare ovunque — dal telefono a un VPS. I tuoi dati sono sempre file leggibili, mai intrappolati in un formato proprietario.
+
+### Dove puoi farlo girare
+
+**Sul telefono** — L'app Android funziona completamente offline, senza account e senza server. I file FIT vengono elaborati direttamente sul dispositivo. Nessun dato lascia il telefono a meno che tu non lo decida.
+
+**Sul proprio computer** — Con Python installato, puoi avviare un'istanza locale in pochi minuti. Punta la cartella dove tieni i file GPX/FIT, esegui l'estrazione e il sito gira su `localhost`. Utile per esplorare i propri dati senza mettere niente online.
+
+**Su un server casalingo o un VPS** — L'istanza condivisa di Bincio gira su un VPS privato. Chiunque del gruppo può fare lo stesso: un piccolo server Debian con nginx e il sito è online, privato, accessibile solo a chi ha le credenziali. Nessuna dipendenza da piattaforme esterne.
+
+**Su GitHub Pages o hosting statico** — Se vuoi un sito pubblico e gratuito, il sito generato è composto da file statici puri. Si può pubblicare su GitHub Pages, Netlify o Cloudflare Pages senza alcun server applicativo.
+
+### Il formato BAS — i tuoi dati sono sempre leggibili
+
+Tutte le attività vengono salvate nel formato **BAS (BincioActivity Schema)**: file JSON semplici, aperti, documentati. Chiunque può leggerli con qualsiasi strumento — un foglio di calcolo, uno script Python, un altro software.
+
+La struttura è questa:
+
+```
+i-tuoi-dati/
+  index.json          ← elenco di tutte le attività
+  activities/
+    2024-06-01T073012Z-morning-ride.json     ← dati completi
+    2024-06-01T073012Z-morning-ride.geojson  ← traccia GPS
+```
+
+Non c'è nessun database, nessun formato binario, nessuna API obbligatoria. Se domani BincioActivity sparisce, i tuoi dati restano leggibili com'erano.
+
+### Cosa puoi condividere e come
+
+Ci sono tre livelli di condivisione, dal più grezzo al più elaborato:
+
+**File originali (FIT / GPX / TCX)** — I file grezzi del ciclocomputer. Massima fedeltà, massima portabilità. Chiunque abbia Strava, Garmin Connect, o qualsiasi altro software può aprirli.
+
+**File BAS (JSON)** — I dati già estratti ed elaborati. Più compatti dei file originali, leggibili direttamente da qualsiasi script. Il tuo feed personale è sempre disponibile all'URL `/u/tuonome/index.json`.
+
+**Sito HTML** — Il sito generato è una cartella di file statici. Puoi copiarlo su una chiavetta, mandarlo per email, o pubblicarlo dove vuoi. Non richiede nessun server per funzionare in sola lettura.
+
+### Federazione
+
+La cosa più interessante: più istanze BincioActivity possono parlarsi. Se ognuno di noi ospitasse la propria istanza, il sito condiviso potrebbe semplicemente puntare al feed di ognuno:
+
+```
+bincio.org/index.json
+  → dave: https://dave.example.com/index.json
+  → alice: https://alice.example.com/index.json
+  → bob:   https://bob.example.com/index.json
+```
+
+Ogni persona mantiene il controllo totale dei propri dati. L'istanza condivisa aggrega senza possedere. Non è fantascienza — è già il modo in cui funziona il formato BAS internamente.
+
+---
+
+## Domande frequenti
+
+**Posso scaricare i miei dati?**
+Sì. Il tuo profilo è disponibile in formato JSON all'indirizzo `/u/tuonome/index.json`.
+
+**Posso eliminare un'attività?**
+Per ora non c'è un pulsante di eliminazione. Puoi nasconderla dal feed impostando la privacy su "non elencata". Per eliminarla definitivamente, chiedi a chi gestisce il sito.
+
+**Che formati di file accetta il sito?**
+GPX, FIT, TCX — e le versioni compresse `.gz` di ognuno. Sono i formati standard di tutti i ciclocomputer e le app GPS.

pages/come-funziona-il-giardino.md

@@ -0,0 +1,59 @@
+---
+title: Come funziona questo wiki
+pubDate: '2026-05-02'
+---
+
+## Cos'è
+
+Un posto dove raccogliamo quello che vogliamo non dimenticare: gite, riparazioni, gear, allenamenti. Non è un blog con post ordinati per data — è più come un archivio vivo, dove le pagine si collegano tra loro e si aggiornano nel tempo.
+
+## Due sezioni
+
+**Blog** — Storie e ricordi. Cose che abbiamo fatto: "Bike trip in Marocco", "Quella volta che ci ha piovuto addosso a 2000m".
+
+**Pagine** — Guide e riferimenti. Cose che tornano utili: "Come riparare la catena", "Quale lubrificante per la pioggia".
+
+Se non sai dove mettere qualcosa, scegli Pagine. Si può spostare.
+
+## Categorie
+
+Le pagine sono organizzate in cinque categorie. Vedi [[come-usare-le-categorie]] per scegliere quella giusta.
+
+Quando crei una pagina dall'editor, scegli la categoria dal menu — il sistema la posiziona nel posto giusto automaticamente.
+
+## Wikilink
+
+Puoi collegare una pagina a un'altra scrivendo il nome tra doppie parentesi quadre:
+
+```
+[[nome-della-pagina]]
+```
+
+Esempio: stai scrivendo di un bike packing e vuoi rimandare a una pagina sull'equipaggiamento:
+
+```
+Per i dettagli su cosa portare, vedi [[zaino-da-bikepacking]].
+```
+
+Il collegamento appare nel testo, e nella pagina collegata comparirà automaticamente "citata da questa pagina" in fondo. Non devi fare altro.
+
+Per collegare una pagina alla sua categoria, aggiungi il wikilink della categoria nel testo:
+
+```
+Questo fa parte di [[BincioTour]].
+```
+
+## Come creare una pagina
+
+1. Clicca il pulsante di modifica nel sito
+2. Scegli la sezione e la sottosezione dal menu
+3. Scrivi un nome breve per la pagina (es. `garmin-edge-540-review`)
+4. Scrivi il contenuto in markdown — vedi [[markdown]] per la sintassi
+5. Salva
+
+## Consigli pratici
+
+- **Scrivi in italiano, come se scrivessi a un amico** — niente gergo, niente formalismi
+- **Usa un nome descrittivo** per la pagina: `riparazione-raggi-ruota-posteriore` è meglio di `riparazione`
+- **Aggiungi wikilink** dove ha senso — collegare le pagine le rende più utili nel tempo
+- **Non serve che sia perfetto** — si può sempre modificare

pages/come-usare-le-categorie.md

@@ -0,0 +1,80 @@
+---
+title: Come scegliere la categoria
+pubDate: '2026-05-02'
+---
+
+Le pagine sono organizzate in cinque categorie. Scegli quella che descrive meglio l'argomento principale.
+
+---
+
+## 🔧 BincioTech
+
+Tecnologia, gadget e componenti della bici.
+
+- "Ho comprato questo ciclocomputer, ecco cosa fa"
+- "Confronto tra power meter: quale scegliere?"
+- "Come sincronizzare il Garmin con il telefono"
+
+**Sottocategorie:** Gear e accessori · Componenti e upgrade · Tecnologia e elettronica · [[BincioActivity]]
+
+---
+
+## 🛠️ BincioOfficina
+
+Manutenzione, riparazioni e lavori fai-da-te.
+
+- "Come pulire la catena senza fare danni"
+- "Mi si è rotto il deragliatore, ecco come l'ho riparato"
+- "Lubrificanti consigliati per la pioggia"
+
+**Sottocategorie:** Manutenzione · Riparazioni · Fai da te
+
+---
+
+## 🗺️ BincioTour
+
+Tour, bike packing, rotte e logistica.
+
+- "Abbiamo fatto 120 km in un giorno, ecco la rotta"
+- "Primo bike packing: cosa ho imparato"
+- "La strada verso le Tre Cime: mappa e consigli"
+
+**Sottocategorie:** Tour report · Bike packing · Rotte e itinerari · Logistica
+
+---
+
+## 🏁 BincioCorsa
+
+Allenamento, gare e performance.
+
+- "Quest'anno mi alleno con questo metodo"
+- "Report dalla gara: nuovo record personale"
+- "Analisi dei dati di allenamento"
+
+**Sottocategorie:** Allenamento · Gare e competizioni · Performance
+
+---
+
+## 👕 BincioAbbigliamento
+
+Abbigliamento tecnico, comfort e protezione.
+
+- "Ho provato questa giacca: è davvero impermeabile?"
+- "Quale salopette per l'inverno?"
+- "Guanti per il freddo: confronto"
+
+**Sottocategorie:** Abbigliamento tecnico · Comfort e protezione · Stagionalità
+
+---
+
+## Come scegliere
+
+Chiediti: **qual è il motivo principale per cui stai scrivendo?**
+
+- Racconto di una gita → [[BincioTour]]
+- Riparazione o manutenzione → [[BincioOfficina]]
+- Gadget, sensore o app → [[BincioTech]]
+- Gara o allenamento → [[BincioCorsa]]
+- Cosa indossare → [[BincioAbbigliamento]]
+
+Se non sei sicuro, scegli la più vicina. Chi gestisce il sito può spostare la pagina se serve.