From 0fc2da40955e68a8a6f5ff2e1db7830af60ebce6 Mon Sep 17 00:00:00 2001 From: brutsalvadi Date: Thu, 7 May 2026 12:28:00 +0200 Subject: [PATCH] updated pages/blog from vps --- blog/come-scrivere-un-viaggio.md | 2 + pages/bincio-activity.md | 142 +++++++++++++++++++++++++++++ pages/come-funziona-il-giardino.md | 59 ++++++++++++ pages/come-usare-le-categorie.md | 80 ++++++++++++++++ 4 files changed, 283 insertions(+) create mode 100644 pages/bincio-activity.md create mode 100644 pages/come-funziona-il-giardino.md create mode 100644 pages/come-usare-le-categorie.md diff --git a/blog/come-scrivere-un-viaggio.md b/blog/come-scrivere-un-viaggio.md index 22bb194..193b136 100644 --- a/blog/come-scrivere-un-viaggio.md +++ b/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. diff --git a/pages/bincio-activity.md b/pages/bincio-activity.md new file mode 100644 index 0000000..632eb2a --- /dev/null +++ b/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. diff --git a/pages/come-funziona-il-giardino.md b/pages/come-funziona-il-giardino.md new file mode 100644 index 0000000..38ef1da --- /dev/null +++ b/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 diff --git a/pages/come-usare-le-categorie.md b/pages/come-usare-le-categorie.md new file mode 100644 index 0000000..9877655 --- /dev/null +++ b/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.