Rewrite user docs, trim developer-only _docs pages, add python-multipart

2026-05-04 13:51:36 +02:00
parent 83f48f09d4
commit 3b8476ce7f
20 changed files with 276 additions and 577 deletions
@@ -1,19 +1,37 @@
 ---
-title: WikiRefs
+title: Come usare i wikilink
 ---

-plugin::[[remark-wikirefs]]
+Un wikilink collega una pagina a un'altra. Si scrive così:

+```
+[[nome-della-pagina]]
+```

-I `[[WikiRefs]]`[^nomi] sono una parte fondamentale del mondo del [[digital-garden|digital gardening]]. Sono il mattone di base dell'interconnessione realizzata in molti giardini digitali, incluso questo. Vengono renderizzati con il plugin [[remark-wikirefs]], appaiono in un colore diverso rispetto ai link web esterni, e puoi consultare quella documentazione per ulteriori dettagli.
+## Come funziona

-In breve, questo particolare tipo di `[[wikirefs]]` comprende tre costrutti wiki: wikiattr, wikilink e wikimbed.
+Scrivi il nome della pagina tra doppie parentesi quadre. Il sistema crea il link automaticamente. Nella pagina collegata comparirà in fondo la lista delle pagine che la citano.

-I _WikiAttr_ sono attributi formalizzati di un file. Includono un tipo di attributo descrittivo e un wikilink a un altro file. Si scrivono `:così::[[wikilink]]` (con un'a capo dopo) e vengono renderizzati nell'attributebox (attrbox).
+## Esempio

-I _WikiLink_ sono i tradizionali link bidirezionali con la sintassi a parentesi quadre e possono comparire ovunque in un file. Esistono `:tipizzati::[[wikilink]]` e normali `[[wikilink]]` non tipizzati. Sono evidenziati in un colore diverso rispetto ai link web esterni.
+Stai scrivendo un racconto di un tour e vuoi rimandare alla pagina sull'equipaggiamento:

-I _WikiEmbed_ incorporano il contenuto del file collegato direttamente nella pagina corrente. È possibile incorporare file markdown, immagini, audio o video. I WikiEmbed si scrivono `![[così]]`.
+```
+Per i dettagli su cosa portare, vedi [[zaino-da-bikepacking]].
+```

+## Collegare una categoria

-[^nomi]: "wikiref" porta in realtà molti nomi: "[wikilink](https://en.wikipedia.org/wiki/Help:Link)", "[link bidirezionale](https://maggieappleton.com/bidirectionals)", "[wikitext linking](https://tiddlywiki.com/#Linking%20in%20WikiText)", "backlink", "[link interno](https://help.obsidian.md/How+to/Internal+link)", per citarne solo alcuni...
+Per posizionare una pagina sotto una categoria, aggiungi il wikilink della categoria da qualche parte nel testo:
+
+```
+Questo fa parte di [[BincioTour]].
+```
+
+Le categorie disponibili sono: [[BincioTech]], [[BincioOfficina]], [[BincioTour]], [[BincioCorsa]], [[BincioAbbigliamento]].
+
+Nell'editor, il wikilink della categoria viene inserito automaticamente quando scegli la sezione dal menu.
+
+## Il nome nel link
+
+Il nome nel link deve corrispondere esattamente al nome file della pagina (senza `.md`). Se la pagina si chiama `garmin-edge-540.md`, il link sarà `[[garmin-edge-540]]`.