Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- wiki:wikifacile [08/04/2018 17:07]
FelynX [L'interfaccia]
+++ wiki:wikifacile [22/01/2021 14:45] (versione attuale)
@@ Linea 1: / Linea 1: @@
 ====== Wiki facile. La tua prima guida ======
-<callout type="warning" icon="fa fa-edit" title="Pagina in bozza">
-Questa pagina non è completa o non condivisa, quindi è da considerarsi una bozza in fase di elaborazione o di consenso.
-</callout>
 ===== Premessa =====
-{{:wiki:scrittura-collaborativa.jpg?nolink&360 }}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 è [[wpit>Pagina_principale|Wikipedia]]).
+{{:wiki:scrittura-collaborativa.jpg?nolink&360 }}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 è [[wpit>Pagina_principale|Wikipedia]]).
 ReTer ha adottato come piattaforma di Wiki [[doku>it:DokuWiki|DokuWiki]] perché semplice e minimalista, ma non per questo privo di funzionalità.
@@ Linea 19: / Linea 15: @@
 === 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).
+Come in tutti i siti Web contiene i link ai contenuti principali **nel Wiki**. 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")
+  * **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
+  * **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" (vedi [[#breadcrumb|2. Breadcrumb]]). Un'attenzione che sarà approfondita nella sezione [[#pagine_e_categorie|Pagine e categorie]]
+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" (vedi [[#breadcrumb|2. Breadcrumb]]). Un'attenzione che sarà approfondita nella sezione [[#pagine_e_categorie|Pagine e categorie]]
 === 4. Motore di ricerca interno ===
@@ Linea 33: / Linea 29: @@
 === 5. Strumenti del sito ===
-Contiene alcune utility del wiki e se si è loggati anche strumenti utente (raggiungibili anche da altri punti dell'interfaccia).
+Contiene alcune utility del Wiki e se si è loggati anche strumenti utente.
 === 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.
+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, rispetto agli altri titoli interni è di livello 1.
+Il titolo tipicamente è il primo elemento della pagina ed è di **livello 1**.
 === 8. Titolo sezione ===
-All'interno della pagina si possono usare titoli per intestare sezioni, a livelli inferiori rispetto al titolo della pagina, rispettivamente per i livelli dal 2 al 5.
+All'interno della pagina si possono usare titoli per intestare sezioni, a livelli inferiori rispetto al titolo della pagina, rispettivamente per i **livelli dal 2 al 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.
+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.
+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.\\
+{{:wiki:wikifacile-f-editor.png?nolink|}} La prima icona in alto apre l'editor per **creare o 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).\\
+{{:wiki:wikifacile-f-cronologia.png?nolink|}} A seguire l'icona per visualizzare la **cronologia delle revisioni**.
-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.
+{{:wiki:wikifacile-f-link.png?nolink|}} 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.
+{{:wiki:wikifacile-f-odt.png?nolink|}} 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.
+Per le sezioni di livello 1, 2 e 3 al piede di ognuna appare un pulsante "**Modifica**" per poter editare la sola sezione senza editare l'intera pagina.
 === 13. Link esterno ===
@@ Linea 63: / Linea 64: @@
 === 14. Link interno ===
-I link interni puntano a pagine del wiki e non sono accompagnati da nessuna icona.
+I link interni puntano a pagine del Wiki e non sono accompagnati da nessuna icona.
 === 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:
+I font equispaziati tipicamente sono quelli usati dagli editor per sviluppatori di software. Nel caso del Wiki nascono proprio per mostrare codice inserito nella pagina senza eseguirlo, tuttavia sono utilizzabili anche per **evidenziare** termini che fanno riferimento a funzioni, url o altri elementi tipicamente "tecnici". Per marcare il testo come ''equispaziato'' va compreso tra 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 (vedi [[#url|3. URL]]) di seguito al nome dominio, con il carattere ":" come separatore delle 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 (vedi [[#url|3. URL]]) di seguito al nome dominio, con il carattere ":" come separatore delle categorie.
 Per fare un esempio, se la pagina con titolo "[[:howto|HowTo / Come fare a...]]" ha come nome "howto" e si trova nella directory principale del sito, l'url corrispondente sarà:
@@ Linea 87: / Linea 88: @@
 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
+<callout type="info" icon="true">
+In ReTerWiki la creazione di nuove pagine è facilitata da un plugin visibile nelle pagine principali di snodo all'interno del box "**Indice dei contenuti**". Se attivo sarà presente un bottoncino "**Add a page...**"
+</callout>
 Così anche se si cancellano tutte le pagine presenti in una categoria sarà automaticamente cancellata anche la categoria.
@@ Linea 93: / Linea 98: @@
 Per spostare una pagina da una categoria a un'altra entrare in ''modifica'', selezionare tutto il contenuto, copiarlo, cancellarlo dalla pagina da eliminare 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 =====
-Entrando nell'editor è possibile inserire il testo della pagina da cui è stato aperto. Oltre al testo propriamente detto è possibile inserire dei testi che vengono riconosciuti come "codici" che il wiki interpreta e ne restituisce il risultato. Questi codici, o marcatori, vengono usati ad esempio per inserire i link, le immagini, o per la formattazione del testo stesso. Normalmente i marcatori non sono altro che dei simboli testuali convenzionali da inserire prima e dopo il testo a cui sono applicati. In aiuto ci viene anche l'interfaccia dell'editor stessa da cui è possibile richiamare i principali marcatori.
+Entrando nell'editor è possibile inserire il testo della pagina da cui è stato aperto. Oltre al testo propriamente detto è possibile inserire dei testi che vengono riconosciuti come "codici" che il Wiki interpreta e ne restituisce il risultato. Questi codici, o marcatori, vengono usati ad esempio per inserire i link, le immagini, o per la formattazione del testo stesso. Normalmente i marcatori non sono altro che dei simboli testuali convenzionali da inserire prima e dopo il testo a cui sono applicati.
-Ma vediamo quali sono i marcatori utilizzati nella formattazione del testo per applicare il **grassetto**, il //corsivo//, il __sottolineato__, o l'''equispaziato'', tutti anche **//__''combinabili tra loro''__//**.
+Ma vediamo quali sono i marcatori utilizzati nella formattazione del testo per applicare il **grassetto**((funzione presente anche nell'interfaccia dell'editor)), il //corsivo//((funzione presente anche nell'interfaccia dell'editor)), il __sottolineato__((funzione presente anche nell'interfaccia dell'editor)), o l'''equispaziato'', tutti anche **//__''combinabili tra loro''__//**.
 Il precedente paragrafo nell'editor è scritto in questa forma:
   Ma vediamo quali sono i marcatori utilizzati nella formattazione del testo, per esempio per applicare il **grassetto**, il //corsivo//, il __sottolineato__, o l'''equispaziato'', tutti anche **//__''combinabili tra loro''__//**.
-Ci sono invece marcatori che si differenziano dall'apertura alla chiusura, come ad esempio quello di <del>barrato</del>.
+Ci sono invece marcatori che si differenziano dall'apertura alla chiusura, come ad esempio quello di <del>barrato</del>((funzione presente anche nell'interfaccia dell'editor)).
 Questo paragrafo nell'editor appare così:
   Ci sono invece marcatori che si differenziano dall'apertura alla chiusura, come ad esempio quello di <del>barrato</del>.
-Un'altra cosa importante da sapere è come definire i paragrafi, ovvero, per andare a capo con un nuovo paragrafo bisogna lasciare dal primo un rigo vuoto.\\ Invece per mandare il testo a capo senza chiudere il paragrafo, non è importante che nell'editor il testo vada a capo, ma che nel punto in cui il testo deve essere spezzato vengano messe due barre retroverse seguite da uno spazio.
+Un'altra cosa importante da sapere è come definire i paragrafi, ovvero, per andare a capo con un nuovo paragrafo bisogna lasciare un rigo vuoto.\\ Invece per mandare il testo a capo senza chiudere il paragrafo, non è importante che nell'editor il testo vada a capo, ma che nel punto in cui il testo deve essere spezzato vengano messe due barre retroverse seguite da uno spazio.
 Vediamo come appare nell'editor il paragrafo precedente:
-  Un'altra cosa importante da sapere è come definire i paragrafi, ovvero, per andare a capo con un nuovo paragrafo bisogna lasciare dal primo un rigo vuoto.\\ Invece per mandare il testo a capo senza chiudere il paragrafo, non è importante che nell'editor il testo vada a capo, ma che nel punto in cui il testo deve essere spezzato vengano messe due barre retroverse seguite da uno spazio.
+  Un'altra cosa importante da sapere è come definire i paragrafi, ovvero, per andare a capo con un nuovo paragrafo bisogna lasciare un rigo vuoto.\\ Invece per mandare il testo a capo senza chiudere il paragrafo, non è importante che nell'editor il testo vada a capo, ma che nel punto in cui il testo deve essere spezzato vengano messe due barre retroverse seguite da uno spazio.
 ===== Titoli e sezioni =====
-Il titolo tipicamente è il primo elemento della pagina. Viene visualizzato come titolo nelle ricerche e negli indici. Il titolo (vedi [[#titolo_pagina|7. Titolo pagina]]), come anche gli altri livelli di intestazioni (vedi [[#titolo_sezione|8. 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.\\
+Il titolo tipicamente è il primo elemento della pagina. Viene visualizzato come titolo nelle ricerche e negli indici. Il titolo (vedi [[#titolo_pagina|7. Titolo pagina]]), come anche gli altri livelli di intestazioni (vedi [[#titolo_sezione|8. Titolo sezione]]), dall'editor si scrivono comprendendoli tra una serie di caratteri "=" in base al livello((funzione presente anche nell'interfaccia dell'editor)). Per il livello 1 che corrisponde al titolo pagina gli "=" devono essere 6.\\
 Es. ''====== NasonyDry. Segnalare le fontanelle chiuse ======''
-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:\\
+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 "="((funzione presente anche nell'interfaccia dell'editor)), 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:
@@ Linea 125: / Linea 132: @@
 I collegamenti, più propriamente link, sono gli elementi ipertestuali che caratterizzano la navigazione web e permettono il collegamento di un elemento con un altro contenuto dello stesso sito o di un altro.
-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 dal wiki semplicemente inserendoli nel testo. Volendo invece applicare il link a un testo che lo descriva, tipo [[http://www.openstreetmap.org/|Questo collegamento punta a OpenStreetMap]], va usato il seguente formato:
+I link esterni sono quelli che rimandano a una pagina di un altro sito e sono preceduti dall'iconcina del mondo. Vengono riconosciuti automaticamente dal wiki semplicemente inserendoli nel testo. Volendo invece applicare il link a un testo che lo descriva, tipo [[http://www.openstreetmap.org/|Questo collegamento punta a OpenStreetMap]], va usato il seguente formato((funzione presente anche nell'interfaccia dell'editor)):
   [[http://www.openstreetmap.org/|Questo collegamento punta a OpenStreetMap]]
@@ Linea 131: / Linea 138: @@
   <dico@sapevatelo.voi>
-I link interni puntano invece a pagine del wiki stesso e non sono accompagnati da nessuna icona.\\
+I link interni puntano invece a pagine del wiki stesso e non sono preceduti 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.
+I collegamenti interni sono creati mettendo il nome della pagina tra doppie parentesi quadre, si possono comprendere anche le categorie ed è possibile mettere un testo alternativo((funzione presente anche nell'interfaccia dell'editor)).
-Ad esempio, il link alla pagina dello screenshot, senza e con testo alternativo ([[howto:nasonydry]] - [[howto:nasonydry|Vai alla pagina dell'HowTo]]), sarebbe così:
+Ad esempio, il link alla pagina dello screenshot, senza e con testo alternativo ([[howto:nasonydry]] - [[howto:nasonydry|Vai alla pagina dell'HowTo]]), è scritto in questo modo:
   [[howto:nasonydry]] - [[howto:nasonydry|Vai alla pagina dell'HowTo]]
@@ Linea 141: / Linea 148: @@
 ===== Liste =====
+Le liste nel testo possono essere non ordinate o ordinate. Per creare un elemento di una lista, indentare il testo con due spazi e usare un asterisco ''*'' per le liste non ordinate((funzione presente anche nell'interfaccia dell'editor)) oppure un trattino ''-'' per quelle ordinate((funzione presente anche nell'interfaccia dell'editor)). Per nidificazioni di livello aggiungere ulteriori due spazi prima del testo per ogni livello. Ecco qualche esempio:
+  * Primo elemento di lista non ordinata
+  * secondo elemento
+    * secondo livello
+      * terzo livello, ecc...
+  * terzo elemento
+  - Lista ordinata
+  - secondo elemento
+    - secondo livello
+      - terzo livello, ecc...
+  - terzo elemento
+Nell'editor queste liste sono scritte così:
+<code>
+  * Primo elemento di lista non ordinata
+  * secondo elemento
+    * secondo livello
+      * terzo livello, ecc...
+  * terzo elemento
+  - Lista ordinata
+  - secondo elemento
+    - secondo livello
+      - terzo livello, ecc...
+  - terzo elemento
+</code>