- bincio_wiki/pages/ — new home for all wiki content (2 wiki pages + _docs/ with 13 docs pages), tracked by the
container repo - bincio_wiki/blog/ — new home for all blog content - site/src/content.config.ts — base: '../pages' (was ./src/content/entries) - site/astro.config.mjs — added vite.server.fs.allow: ['..'] so Vite serves files from outside the project root; updated the delete watcher to watch ../pages/ - edit/server.py — default WIKI_PAGES_DIR is now pages (was site/src/content/entries) Content is now versioned in bincio_wiki. The submodule stays clean — it's just the engine.
This commit is contained in:
brutsalvadi
@@ -0,0 +1,89 @@
|
||||
---
|
||||
title: 'Come scrivere una storia di viaggio (il vostro prossimo articolo)'
|
||||
pubDate: '2026-05-02'
|
||||
description: 'Guida per raccontare le vostre avventure in bicicletta'
|
||||
---
|
||||
|
||||
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.
|
||||
|
||||
## Cos'è un blog post qui?
|
||||
|
||||
Un blog post è una **storia completa e autosufficiente** di un'avventura in bicicletta.
|
||||
|
||||
**Esempi di titoli:**
|
||||
- "Bike trip to Morocco — 2 weeks, 1200 km"
|
||||
- "Barcelona—Valencia non-stop: come siamo riusciti (e cosa ci ha ucciso)"
|
||||
- "La tempesta di luglio che non dimenticheremo"
|
||||
- "Primo bike packing: che cosa ho imparato (e cosa non fare)"
|
||||
- "100 km notturni: un'esperienza che ti cambia"
|
||||
|
||||
## Struttura semplice
|
||||
|
||||
Non servono capitoli complicati. Un'idea:
|
||||
|
||||
```markdown
|
||||
---
|
||||
title: "Il titolo del vostro viaggio"
|
||||
pubDate: '2026-05-15'
|
||||
description: "Una frase che cattura l'essenza"
|
||||
heroImage: "/foto-principale.jpg"
|
||||
---
|
||||
|
||||
### Perché abbiamo deciso di farlo
|
||||
|
||||
Una o due frasi che spiegano il motivo. Perché? Chi? Quando?
|
||||
|
||||
### La preparazione
|
||||
|
||||
Se rilevante: cosa abbiamo fatto prima, come ci siamo organizzati, che cosa abbiamo sbagliato.
|
||||
|
||||
### Il viaggio (giorno per giorno, o per fasi)
|
||||
|
||||
La storia vera. Dove siamo andati? Cosa è successo? Che sensazione era?
|
||||
|
||||
### Le cose che non sapevamo
|
||||
|
||||
Quello che abbiamo imparato. Le sorprese. I dettagli che nessuno ti dice.
|
||||
|
||||
### Saremmo tornati?
|
||||
|
||||
Una conclusione onesta: è stato worth it? Faremmo di nuovo la stessa rotta?
|
||||
```
|
||||
|
||||
## Regole non scritte
|
||||
|
||||
1. **Siate voi stessi** — non scrivete come se fosse un articolo di magazine. Scrivete come raccontereste la storia al bar.
|
||||
|
||||
2. **Includete i dettagli viscerali** — non solo "era bello", ma "il vento ci ha spinto contro la parete rocciosa e abbiamo capito quanto era fragile il manubrio".
|
||||
|
||||
3. **I fallimenti sono meglio dei successi** — la non-stop che è andata male è più interessante della normale gita.
|
||||
|
||||
4. **Numeri e foto aiutano** — "130 km in un giorno" è più vivido di "molti chilometri". Una foto vale mille parole.
|
||||
|
||||
5. **Collegate ad altri contenuti** — se fate menzione di un componente, di una tecnica, di un posto: usate i `[[wikilink]]` per collegarlo.
|
||||
|
||||
Esempio:
|
||||
> "Abbiamo usato le [salopette da donna](oppure [[SalopettaNera]]) che avevamo testato in [[BincioAbbigliamento]], e anche bene. La [[rotta al passo del Brennero]] che avevamo mappato a casa è stata perfetta."
|
||||
|
||||
6. **Data e ora importante** — quando è successo? Se è una storia di anni fa, è ancora rilevante? Datela chiaramente.
|
||||
|
||||
## Cosa NON è un blog post
|
||||
|
||||
- Non è "5 consigli per il viaggio" → mettete quello in [[BincioTour]] come guide
|
||||
- Non è "come riparare il cambio" → quello va in [[BincioOfficina]]
|
||||
- Non è "review del mio nuovo Garmin" → quello va in [[BincioTech]]
|
||||
|
||||
Un blog post è **il vostro viaggio, il vostro racconto, la vostra avventura**.
|
||||
|
||||
## Dopo averlo scritto
|
||||
|
||||
- Rileggete una volta (non serve perfezione)
|
||||
- Aggiungete foto se le avete
|
||||
- Collegate pagine correlate con wikilink
|
||||
- Pubblicate
|
||||
|
||||
Il resto lo fa il giardino.
|
||||
|
||||
---
|
||||
|
||||
**Pronti a raccontare?** Il prossimo viaggio aspetta una storia.
|
||||
@@ -0,0 +1,214 @@
|
||||
---
|
||||
title: 'Markdown Style Guide'
|
||||
description: 'Here is a sample of some basic Markdown syntax that can be used when writing Markdown content in Astro.'
|
||||
pubDate: 'Jul 01 2022'
|
||||
heroImage: '/blog-placeholder-3.jpg'
|
||||
---
|
||||
|
||||
Here is a sample of some basic Markdown syntax that can be used when writing Markdown content in Astro.
|
||||
|
||||
## Headings
|
||||
|
||||
The following HTML `<h1>`—`<h6>` elements represent six levels of section headings. `<h1>` is the highest section level while `<h6>` is the lowest.
|
||||
|
||||
# H1
|
||||
|
||||
## H2
|
||||
|
||||
### H3
|
||||
|
||||
#### H4
|
||||
|
||||
##### H5
|
||||
|
||||
###### H6
|
||||
|
||||
## Paragraph
|
||||
|
||||
Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.
|
||||
|
||||
Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.
|
||||
|
||||
## Images
|
||||
|
||||
#### Syntax
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
#### Output
|
||||
|
||||
|
||||
|
||||
## Blockquotes
|
||||
|
||||
The blockquote element represents content that is quoted from another source, optionally with a citation which must be within a `footer` or `cite` element, and optionally with in-line changes such as annotations and abbreviations.
|
||||
|
||||
### Blockquote without attribution
|
||||
|
||||
#### Syntax
|
||||
|
||||
```markdown
|
||||
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
|
||||
> **Note** that you can use _Markdown syntax_ within a blockquote.
|
||||
```
|
||||
|
||||
#### Output
|
||||
|
||||
> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
|
||||
> **Note** that you can use _Markdown syntax_ within a blockquote.
|
||||
|
||||
### Blockquote with attribution
|
||||
|
||||
#### Syntax
|
||||
|
||||
```markdown
|
||||
> Don't communicate by sharing memory, share memory by communicating.<br>
|
||||
> — <cite>Rob Pike[^1]</cite>
|
||||
```
|
||||
|
||||
#### Output
|
||||
|
||||
> Don't communicate by sharing memory, share memory by communicating.<br>
|
||||
> — <cite>Rob Pike[^1]</cite>
|
||||
|
||||
[^1]: The above quote is excerpted from Rob Pike's [talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) during Gopherfest, November 18, 2015.
|
||||
|
||||
## Tables
|
||||
|
||||
#### Syntax
|
||||
|
||||
```markdown
|
||||
| Italics | Bold | Code |
|
||||
| --------- | -------- | ------ |
|
||||
| _italics_ | **bold** | `code` |
|
||||
```
|
||||
|
||||
#### Output
|
||||
|
||||
| Italics | Bold | Code |
|
||||
| --------- | -------- | ------ |
|
||||
| _italics_ | **bold** | `code` |
|
||||
|
||||
## Code Blocks
|
||||
|
||||
#### Syntax
|
||||
|
||||
we can use 3 backticks ``` in new line and write snippet and close with 3 backticks on new line and to highlight language specific syntac, write one word of language name after first 3 backticks, for eg. html, javascript, css, markdown, typescript, txt, bash
|
||||
|
||||
````markdown
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>Example HTML5 Document</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>Test</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
````
|
||||
|
||||
Output
|
||||
|
||||
```html
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<title>Example HTML5 Document</title>
|
||||
</head>
|
||||
<body>
|
||||
<p>Test</p>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
## List Types
|
||||
|
||||
### Ordered List
|
||||
|
||||
#### Syntax
|
||||
|
||||
```markdown
|
||||
1. First item
|
||||
2. Second item
|
||||
3. Third item
|
||||
```
|
||||
|
||||
#### Output
|
||||
|
||||
1. First item
|
||||
2. Second item
|
||||
3. Third item
|
||||
|
||||
### Unordered List
|
||||
|
||||
#### Syntax
|
||||
|
||||
```markdown
|
||||
- List item
|
||||
- Another item
|
||||
- And another item
|
||||
```
|
||||
|
||||
#### Output
|
||||
|
||||
- List item
|
||||
- Another item
|
||||
- And another item
|
||||
|
||||
### Nested list
|
||||
|
||||
#### Syntax
|
||||
|
||||
```markdown
|
||||
- Fruit
|
||||
- Apple
|
||||
- Orange
|
||||
- Banana
|
||||
- Dairy
|
||||
- Milk
|
||||
- Cheese
|
||||
```
|
||||
|
||||
#### Output
|
||||
|
||||
- Fruit
|
||||
- Apple
|
||||
- Orange
|
||||
- Banana
|
||||
- Dairy
|
||||
- Milk
|
||||
- Cheese
|
||||
|
||||
## Other Elements — abbr, sub, sup, kbd, mark
|
||||
|
||||
#### Syntax
|
||||
|
||||
```markdown
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> is a bitmap image format.
|
||||
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
Press <kbd><kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Delete</kbd></kbd> to end the session.
|
||||
|
||||
Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and other small creatures.
|
||||
```
|
||||
|
||||
#### Output
|
||||
|
||||
<abbr title="Graphics Interchange Format">GIF</abbr> is a bitmap image format.
|
||||
|
||||
H<sub>2</sub>O
|
||||
|
||||
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
|
||||
|
||||
Press <kbd><kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Delete</kbd></kbd> to end the session.
|
||||
|
||||
Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and other small creatures.
|
||||
Reference in New Issue
Block a user