Wiki facile. La tua prima guida

Questa pagina non è completa o non condivisa, quindi è da considerarsi una bozza in fase di elaborazione o di consenso.

Premessa

Innanzitutto, Cos'è un Wiki? È un sito web caratterizzato dal fatto che ogni utente abilitato (questo dipende dalle policy di utilizzo di chi crea il Wiki o della comunità che lo gestisce) può direttamente modificare le pagine o crearne di nuove (l'esempio più noto è Wikipedia).

ReTer ha adottato come piattaforma di Wiki DokuWiki perché semplice e minimalista, ma non per questo privo di funzionalità.

Nonostante l'estrema facilità di utilizzo di DokuWiki, è comprensibile che generi qualche perplessità in chi non ha molta dimestichezza con gli strumenti digitali, o comunque che risulti non così immediato per chi non ha esperienza con i Wiki o in generale con l'editing di contenuti web. Per questa ragione, oltre alle diverse risorse di autoapprendimento disponibili, abbiamo realizzato questa guida essenziale contenente le basi per cominciare a metterci le mani dentro.

La configurazione di un Wiki può cambiare tra le varie installazioni sia nell'estetica che nelle funzionalità rese disponibili oltre a funzionalità aggiuntive abilitabili grazie a moduli aggiuntivi. Per questa ragione noi faremo riferimento nelle spiegazioni e nelle schermate al ReTerWiki, eventualmente indicando gli elementi meno sandard rispetto ad altre configurazioni.

L'interfaccia

Questo è lo screenshot di una tipica pagina con tutti gli elementi utili alla navigazione e all'interazione col Wiki. Vediamo nel dettaglio gli elementi principali:

1. Il menu di navigazione

Come in tutti i siti Web contiene i link ai contenuti principali del sito. Da notare, a proposito del ReTerWiki, che oltre ai contenuti interni ci sono nel sottomenu “Altrove” i link a siti esterni (riconoscibili dall'iconcina del mondo).

2. Breadcrumb

Altrimenti detti “Briciole di pane”. Ce ne sono di due tipi:

Ti trovi qui. Percorso gerarchico della pagina visualizzata (nell'esempio si può notare l'icona di Home, seguita da “howto” che contiene la pagina “nasonydry”)

Traccia. Le vere e proprie “Briciole di pane”, ovvero le ultime 10 pagine visitate del sito

3. URL

Tipicamente l'url è composto dal nome di dominio https://wiki.reter.info/ (da cui si può notare che il dominio ReTer.info è protetto dal protocollo https che garantisce una maggiore sicurezza sulla privacy) e dal percorso della pagina visualizzata, che nel caso dell'esempio è howto:nasonydry. Da notare la corrispondenza con il “Ti trovi qui” del punto 2. Un'attenzione che sarà approfondita nella sezione Pagine e categorie

4. Motore di ricerca interno

Per ricerche interne al sito.

5. Strumenti del sito

Contiene alcune utility del wiki e se si è loggati anche strumenti utente (raggiungibili anche da altri punti dell'interfaccia).

6. Profilo utente

In questa posizione se non è stato effettuato l'accesso trovano posto i pulsanti per la registrazione al wiki e per l'ingresso. Dopo il login al posto di questi due pulsanti ci saranno l'eventuale avatar e il menu utente.

7. Titolo pagina

Il titolo tipicamente è il primo elemento della pagina. Viene visualizzato come titolo nelle ricerche e negli indici. Il titolo, come anche gli altri livelli di intestazioni (vedi Titolo sezione), dall'editor si scrivono facendoli precedere e seguire da una serie di caratteri “=” in base al livello. Per il livello 1 che corrisponde al titolo pagina gli “=” devono essere 6.
Es. ====== NasonyDry. Segnalare le fontanelle chiuse ======

8. Titolo sezione

All'interno della pagina si possono usare titoli per intestare sezioni a livelli inferiori rispetto al titolo della pagina, che dovranno essere racchiusi tra 5, 4, 3 o 2 caratteri “=”, rispettivamente per i livelli 2, 3, 4 e 5. Nell'esempio dello screenshot il titolo “Attivare il Bot Telegram” è di livello 2, quindi scritto nell'editor nella forma:
===== Attivare il Bot Telegram =====.
Altri esempi:

==== Livello di intestazione 3 ====
=== Livello di intestazione 4 ===
== Livello di intestazione 5 ==

9. Indice sezioni

L'indice delle sezioni è un indice interno ai contenuti della pagina e si genera automaticamente in base alle impostazioni predefinite del wiki. Nel nostro caso appare quando in una pagina ci sono più di 3 titoli/sezioni e si può sviluppare fino a 3 livelli.

10. Condivisioni

Per condividere la pagina sui social, inviarla via Email o alla stampante.

11. Funzioni di pagina

La prima icona in alto apre l'editor per modificare la pagina.
A seguire l'icona per visualizzare la cronologia delle revisioni.
Poi c'è l'icona per verificare se ci sono link che puntano alla pagina (utile da verificare prima di cancellare una pagina per prevenire link corrotti).
Oltre a questri 3 pulsanti presenti di default in DokuWiki, ce ne possono essere altri aggiunti da plugin. Infatti in ReTerWiki c'è un quarto pulsante che permette di esportare la pagina in formato ODT e quindi editabile poi offline con un editor di testo.

12. Modifica sezione

Per i primi 3 livelli di sezione all'interno della pagina appare un pulsante “Modifica” per ogni sezione, per poter editare la sola sezione senza editare tutta la pagina (vedi Modifica sezione).

13. Link esterno

I link esterni sono quelli che rimandano a una pagina di un altro sito e si riconoscono dall'iconcina del mondo alla loro sinistra. Vengono riconosciuti automaticamente semplicemente inserendoli nel testo. Volendo invece applicare il link a un testo che lo descriva, tipo Questo collegamento punta a OpenStreetMap, va usato il seguente formato:

[[http://www.openstreetmap.org/|Questo collegamento punta a OpenStreetMap]]

Sono riconosciuti automaticamente anche gli indirizzi di posta elettronica come dico@sapevatelo.voi scrivendolo nel formato:

<dico@sapevatelo.voi>

14. Link interno

I link interni puntano a pagine del wiki e non sono accompagnati da nessuna icona.
I collegamenti interni sono creati mettendo il nome della pagina tra parentesi quadre, si possono comprendere anche le categorie ed è possibile mettere un testo alternativo. Ad esempio, il link alla pagina dello screenshot, senza e con testo alternativo (nasonydry - Vai alla pagina dell'HowTo), sarebbe così:

[[howto:nasonydry]] - [[howto:nasonydry|Vai alla pagina dell'HowTo]]

Da notare che per nome della pagina non si intende il titolo, bensì quello indicato nell'URL (vedi URL).

Se la pagina è inesistente, il link apparirà di tipo differente (ad es. HowTo: Come andare su Orione), rimanderà comunque alla pagina col messaggio di pagina inesistente ed invito alla creazione (a patto di avere i privilegi per farlo).

15. Testo equispaziato

I font equispaziati tipicamente sono quelli usati dagli editor usati dagli sviluppatori di software. Nel caso del Wiki nascono proprio per evidenziare codice inserito nel contenuto di una pagina, tuttavia sono utilizzabili anche per evidenziare termini che fanno riferimento a funzioni, url o altri elementi “tecnici”. Per marcare il testo come equispaziato va compreso in doppi apici, in questo modo:

''equispaziato''

Pagine e categorie

Le pagine sono l'elemento centrare del wiki, organizzate e raggruppate in categorie. Ogni singola pagina in DokuWiki è come un file e le categorie sono come le directory in cui sono contenuti. Il tutto si traduce nel Web nel percorso visualizzato nell'url di seguito al nome dominio, con il carattere “:” come separatore delle categorie.

Per fare un esempio, se la pagina con titolo “HowTo / Come fare a...” ha come nome “howto” e si trova nella directory principale del sito, l'url corrispondente sarà:

https://wiki.reter.info/howto

Tornando all'esempio usato nello screenshot della sezione “L'interfaccia”, il nome della pagina è “nasonydry” e la cartella in cui si trova, ovvero la categoria di cui fa parte, è “howto”, quindi l'url completo di questa pagina sarà:

https://wiki.reter.info/howto:nasonydry

Da ciò deduciamo che “howto” è sì una pagina, ma anche il nome di una categoria che contiene la pagina “nasonydry”, come anche “coordinate” e altre.

Per creare una nuova pagina basta comporre adeguatamente l'url. Se per esempio volessimo creare un HowTo di spiegazione su come raggiungere Orione e decidiamo di chiamare la pagina “andaresuorione”, da posizionare ovviamente nella categoria “howto”, dovremmo scrivere nell'indirizzo:

https://wiki.reter.info/howto:andaresuorione

Se la pagina non è ancora esistente, ci apparirà il messaggio “Questo argomento non esiste ancora” e l'invito a crearla tramite l'apposita icona di creazione/modifica (vedi 11. Funzioni di pagina).

Creando una pagina in una categoria ancora non esistente, automaticamente viene creata anche la nuova categoria. Se ad esempio volessimo creare una nuova pagina “saleprova” nella categoria “musica”, a sua volta nella categoria “territorio”, il percorso da scrivere di seguito all'url del dominio sarebbe “territorio:musica:saleprova”. L'url completo quindi sarebbe:

https://wiki.reter.info/territorio:musica:saleprova

Così anche se si cancellano tutte le pagine presenti in una categoria sarà automaticamente cancellata anche la categoria.

Per cancellare una pagina entrare in modifica, svuotare completamente il contenuto e risalvarla.

Per spostare una pagina da una categoria a un'altra entrare in modifica, selezionare tutto il contenuto, copiarlo e risalvare la pagina. A questo punto editare l'url con il percorso e il nome nuovo da voler dare alla pagina, creare la pagina e incollarci dentro il contenuto precedentemente copiato.

Il testo

Titoli e sezioni

Collegamenti

Liste