Mantenere il tuo Wiki utile e produttivo

Ora che comprendi cosa sono i wiki e come possono essere utilizzati nella tua attività, non resta che avviare la tua wiki e far sì che il tuo team la utilizzi per organizzare le tue informazioni.

Sarebbe bello se potessi indicarti un singolo sito web dove il "Wiki" visse. Ma i wiki in realtà hanno molti sapori. Le costanti sono sempre le stesse: sono tutte progettate per permetterti di creare facilmente contenuti in modo collaborativo e facilmente collegabili a qualsiasi cosa con riferimenti semplici, ma ognuno di essi ha i propri punti di forza.

In questo tutorial, ti mostrerò i migliori strumenti per costruire il tuo wiki e poi ti insegnerò come avviare, modificare e far crescere il tuo wiki.

I migliori strumenti per costruire un Wiki

Prima di iniziare a costruire la tua wiki, dovrai decidere cosa vuoi alimentare la tua wiki. Proprio come potresti creare un sito Web con un semplice HTML, un CMS completo come WordPress, un CMS più semplice come il nuovo Ghost, o qualsiasi cosa nel mezzo, puoi usare un sacco di strumenti diversi per alimentare il tuo wiki.

Innanzitutto, ecco i 3 migliori strumenti solo per creare un wiki. Se tutto quello che vuoi è un wiki semplice e diretto, questi sono per te. Quindi, esamineremo alcuni degli altri strumenti popolari che ti consentono di creare un wiki e hanno anche funzionalità extra.

MediaWiki

Diamo prima un'occhiata al grande: MediaWiki. Questo impressionante motore wiki è ciò che alimenta Wikipedia e molti altri wiki che probabilmente hai visto prima. Se vuoi usare gli stessi strumenti dei wiki più popolari online, MediaWiki per te.

Ma c'è qualcosa da tenere a mente qui: MediaWiki alimenta Wikipedia. Lo so, l'ho già detto. Ma pensa per un secondo a cosa significa. Wikipedia è tremendamente grande, edito da milioni di utenti diversi. Quindi, per estensione, MediaWiki è progettato con un sacco di funzioni orientate verso un wiki enormemente grande che viene modificato da milioni di utenti. Se non pensi che tu o la tua piccola impresa abbiate bisogno di tutto questo, allora forse uno dei wiki più semplici della lista potrebbe soddisfare meglio le vostre esigenze.

Detto questo, MediaWiki svolge il lavoro molto bene. È ampiamente supportato grazie alla sua popolarità, relativamente facile da installare e, considerando il suo potere su Wikipedia, sarà sicuramente presente da molto tempo. È il WordPress dei motori wiki.

dokuwiki

Dokuwiki mi sembra il migliore esempio di wiki con tutto ciò di cui hai bisogno senza qualcosa che non ti serve davvero. Non usa un database per archiviare il contenuto del wiki, rendendo più semplice l'installazione, il backup e la gestione rispetto al wiki medio. Ma non fatevi ingannare nel pensare che Dokuwiki non sia un software wiki completo. Ha una sintassi di formattazione del testo elegante e semplice, offre controlli di accesso e autenticazione, e ha anche una community di plugin.

Se vuoi qualcosa di più semplice di MediaWiki - e questo è più facile da eseguire rispetto a MediaWiki poiché funziona senza un database - Dokuwiki vale sicuramente la pena di provarlo.

Roadkill

Roadkill merita una menzione speciale qui in quanto è l'unica wiki con tecnologia .NET nell'elenco. Se la tua azienda utilizza internamente Windows Server, quindi Roadkill potrebbe essere la scelta più semplice in questo elenco. Funziona con un moderno stack di tecnologie web ed è basato sul framework .NET. Mentre MediaWiki e dokuwiki sono concepiti per funzionare nello stack LAMP, Roadkill sarà semplice da eseguire sul tuo Windows Server, e include ancora le moderne funzionalità di cui hai bisogno per rendere il processo di impostazione del wiki più facile e veloce, giusto?

È un Wiki e poi alcuni

Probabilmente vorrai usare MediaWiki, dokuwiki o Roadkill, ma non sono gli unici modi per creare un wiki. Ecco una breve lista di alcuni dei più eccitanti strumenti wiki che offrono funzionalità extra. Se hai già deciso di utilizzare uno degli strumenti di cui sopra, però, puoi semplicemente passare alla procedura guidata Wiki.

Trac

Trac è tutto ciò che puoi desiderare da un wiki se ne stai usando uno per documentare il tuo software. In sostanza, prendi uno strumento di controllo della versione come Github, combinalo con il rilevamento dei problemi e un wiki per la documentazione, e hai Trac.

Se stai sviluppando software o qualsiasi altra cosa in cui devi tenere traccia dei bug, allora Trac potrebbe essere un grande soluzione wiki per te. Combina il rilevamento dei problemi e il software di controllo delle versioni con un wiki. Puoi ispezionare il tuo codice, tenere traccia dei bug e documentare l'intero processo in un unico posto. Se la tua attività implica la codifica, è difficile migliorare rispetto a Trac.

Redmine

Prendi tutto ciò che è bello su Trac e aggiungi la gestione dei progetti e hai Redmine. È un wiki, controllo di versione, bug tracker e tutto ciò che ti aspetteresti da un project manager: diagrammi di Gantt, calendari, forum, tracciamento del tempo e altro ancora, tutto in uno.

È impressionante, ma potrebbe anche essere troppo per le tue esigenze o potrebbe essere l'unica app per portare tutto nel tuo business insieme.

XWiki

XWiki si autodefinisce "wiki di seconda generazione", poiché utilizza i principi del design wiki per creare un Web collaborativo applicazioni invece di solo pagine web. Ci sono molte cose che potresti realizzare con esso - basta per un intero tutorial separato - ma per ora ti lascerò con la guida introduttiva. Per lo meno, se ti piacciono le idee dietro a un wiki ma vuoi fare molto più di un semplice sito, Xwiki vale la pena di provarlo.

È lontano da tutti

Questo non è affatto un elenco completo di strumenti wiki. In effetti, ce ne sono così tanti, potresti passare ore a guadare solo gli oltre 140 più popolari di WikiMatrix. Ma gli strumenti elencati qui sono molti per iniziare.

Molto probabilmente vorrai andare con MediaWiki, ma in caso contrario, abbiamo appena esaminato i wiki per Windows Server, quelli che seguiranno i tuoi bug e ti aiuteranno a gestire i tuoi progetti e ti permetteranno di creare app.

Ora è il momento di mettere tutto insieme e iniziare a usare un wiki.

Costruire e usare un Wiki

I wiki possono essere un po 'intimidatori. Non sembrano esattamente Microsoft Word, o Facebook, o qualsiasi altra cosa tu abbia mai usato prima. Anche se hai usato Wikipedia, la modifica e l'uso efficace di una wiki nella tua azienda sono completamente diversi.

Quindi, esaminiamo le basi dell'utilizzo di una wiki. Vedrai che non è affatto una giungla oscura e spaventosa; è un piccolo giardino calmo e piacevole.

Innanzitutto, devi far funzionare la tua wiki. Questo non dovrebbe essere troppo difficile se si dispone di un account di hosting, in quanto la maggior parte dei servizi di hosting ha un installer one-click (come Softaculous) per ottenere MediaWiki e la maggior parte degli altri wiki menzionati e attivi. Quindi, è il momento di usare la tua wiki.

Ho usato MediaWiki in questo tutorial perché è il più comune. I compiti che stiamo per affrontare sono basilari e il modo in cui li fai in altri wiki è spesso molto simile a quanto descritto qui. Iniziamo.

Leggere una pagina Wiki

Potresti pensare che sia assurdo essere coprendo qualcosa di così semplice come lettura una pagina wiki. Ma, per essere onesti, una wiki è leggermente diversa dalla tua pagina web media. Ci sono alcune cose importanti che troverai in modo coerente su ogni pagina wiki. Ecco un esempio, con le aree importanti descritte di seguito:

Le parti importanti di una pagina wiki

1. Immagine / logo intestazione: Se ti senti perso mentre leggi la tua wiki, ricorda che un semplice clic sul logo qui ti invierà direttamente alla prima pagina del wiki, proprio come nella maggior parte dei siti.

2. Navigazione superiore: La navigazione principale è in alto. È importante guardare fino in fondo a destra perché è lì che si trovano i pulsanti "Modifica" e "Visualizza cronologia", di cui parleremo più avanti. Troverai anche una casella di ricerca standard, che è il modo migliore per trovare informazioni non collegate nella pagina corrente.

3. Navigazione laterale: Questa è una navigazione supplementare, per aiutarti a saltare rapidamente a pagine importanti all'interno del wiki. MediaWiki, ad esempio, ha collegamenti alle pagine principali del wiki, nonché una sezione nella sua navigazione laterale che contiene quelli che chiama "Strumenti", che sono collegamenti che contengono informazioni aggiuntive sulla pagina in questione.

4. Titolo dell'articolo: Questa è, forse, la parte più auto-esplicativa della pagina wiki, ed è esattamente ciò che sembra.

5. Indice: Questo è uno strumento utile, specialmente per i documenti lunghi con molte sezioni. Il sommario viene generato automaticamente, utilizzando i livelli di intestazione nella pagina per creare una struttura del suo contenuto.

Non è tanto diverso dalla pagina web media, ma noterai che c'è una maggiore enfasi sui collegamenti con informazioni extra e una semplice navigazione su tutta la pagina. Questi sono alcuni dei modi in cui i wiki sono più adatti all'organizzazione di informazioni rispetto a una pagina Web standard.

Modifica di una pagina Wiki

La lettura di una wiki è semplice e la ricerca di un wiki è ancora più semplice rispetto a una pagina Web standard grazie ai suoi collegamenti aggiuntivi, al sommario generato automaticamente e altro ancora. Ora è il momento di modificare una pagina wiki. Ecco come appare una pagina di modifica wiki standard:

Modifica di una pagina MediaWiki, qui, all'interno di Wikipedia

Questo può sembrare molto da capire, ma non essere sopraffatto. Per modificare la pagina, basta iniziare a digitare nella casella. Questo è tutto. Alla sua base, una pagina wiki è semplicemente testo.

La formattazione di ciò che scrivi non complica le cose un po ', ma non molto. Ci sono due diversi approcci che puoi adottare per la formattazione di una pagina wiki. Per ogni wiki esiste una sorta di sintassi di stile semplice che puoi usare per contrassegnare la tua pagina wiki. Guarda l'immagine qui sopra. Riesci a distinguere il sottotitolo "Birding, birdwatching e spasmi"? Se guardi da vicino vedrai che la frase è racchiusa tra "==". Ciò significa che la frase diventerà un'intestazione di livello 1.

C'è una sintassi basata sul testo simile per aggiungere ogni tipo di formattazione che vedrai in una pagina wiki. MediaWiki ha una bella pagina che documenta tutti i vari modi per lo stile dei contenuti, e troverai una documentazione simile per altri motori wiki. La cosa fantastica della sintassi wiki di base è che è facile da digitare senza lasciare la tastiera e funziona da qualsiasi dispositivo.

Se questo è troppo travolgente, però, la maggior parte dei wiki ha anche un editor WYSIWYG (WYSIWYG sta per "What You See Is What You Get"), che assomiglia a una versione mini di Word o ad altri word processor a cui sei già abituato. Ciò aiuta a semplificare ulteriormente il processo di modifica e non rende più difficile la modifica di un documento normale. Se il tuo wiki ha una funzione di modifica WYSIWYG, sentiti libero di usarlo. E, cosa più importante, dillo ai tuoi dipendenti. Aiuterà a temere di modificare una pagina wiki ancora meno.

Collegamento tra pagine Wiki

Nel nostro ultimo articolo ci sono state molte discussioni sull'importanza del linking, su come aiuta un wiki a crescere e maturare, e dà così tanto del suo potere e utilità. Quindi, come possiamo creare un link?

[[My Link]]

Questo è tutto. Sul serio. Con due parentesi quadre hai appena creato un link alla pagina "My Link" sulla tua wiki. Potresti scrivere "Cucumber", invece, per collegarti alla tua pagina sui cetrioli, o qualsiasi altra cosa desideri. Non è necessario digitare un URL per la pagina, ma solo digitare il titolo della pagina tra parentesi quadre. Oppure, se vuoi, puoi speziare quel collegamento un po ':

[[Il mio link | qualche testo personalizzato]]

Ora hai un link che, invece di apparire sulla pagina come "My Link", appare come "un testo personalizzato" ma è collegato alla pagina "My Link". Non è così semplice? Questa è la caratteristica migliore in assoluto dei wiki: è incredibilmente semplice creare collegamenti. E ricorda, puoi anche collegare a contenuti che non ci sono ancora. Puoi creare il link "My Link", anche se la pagina "My Link" non è stata ancora creata e il wiki si collegherà automaticamente a quella pagina quando sarà stata creata.

Viaggiare nel tempo con le pagine Wiki

No, non hai letto male. ho detto viaggio nel tempo. Di cosa sto parlando? Bene, oggi la maggior parte dei wiki ha un Cronologia delle revisioni per ogni pagina wiki. Tiene traccia di ogni modifica apportata a una pagina wiki, elencando chi ha apportato la modifica, quando è stata creata e nella maggior parte dei casi una breve descrizione di ciò che è stato cambiato.

Vedi tutto ciò che è mai stato cambiato in una pagina wiki

Ciò che è ancora meglio è che puoi confrontare le modifiche apportate in due diverse revisioni. Guarda l'immagine qui sotto:

Guardando le differenze tra due revisioni di una pagina wiki

Qui vediamo due diverse versioni della pagina "Birdwatching" da Wikipedia. La linea che è stata modificata è evidenziata: il giallo a sinistra rappresenta la versione precedente, mentre il blu a destra rappresenta la versione più recente. In questo caso il cambiamento era minore, solo qualche punteggiatura corretta. Ma pensa al potere di questo.

Contenuto nella tua wiki è una macchina del tempo! Ogni modifica, apportata a ogni pagina, per l'intera vita della tua wiki è accessibile a te. Puoi andare avanti o indietro, osservando come una pagina è cresciuta e cambiata nel tempo.

La funzionalità di revisione trovata nella maggior parte dei wiki non è qualcosa da trascurare. È la tua garanzia che i dati della tua squadra non andranno mai persi.

Mantenere il tuo Wiki utile e produttivo

Bene, ora hai una wiki completamente nuova. Congratulazioni! Avere un wiki è solo l'inizio. Pensa al tuo wiki come un giardino. Hai fatto un sacco di lavoro per arrivare a questo punto, e ora devi solo iniziare ad aggiungere contenuti e far sì che il tuo wiki sia adottato dai membri del tuo team.

L'unico problema è che è facile per i tuoi contenuti sfuggire di mano, obsoleti e più difficili da risolvere. Oppure, peggio ancora, la tua wiki può facilmente essere trascurata e dimenticata. Quindi ecco alcuni suggerimenti per mantenere la tua wiki da stagnante.

Avere un piano di organizzazione Wiki

A questo punto, dovresti avere in mente ciò che vuoi dal tuo wiki. Prendi quelle idee per iscritto, rendi il primo contenuto della tua wiki e mettile in evidenza sulla prima pagina. Se non spieghi ai membri del tuo team qual è lo scopo del wiki, quali sono i tuoi obiettivi, allora la tua wiki non diventerà utile. Non riescono a leggerti nella tua mente. E apprezzeranno sicuramente alcune indicazioni e indicazioni su come utilizzare questo nuovo strumento.

Ora, lavora con quell'idea generale e seguitela. E fai tutto il contenuto di cui hai bisogno, aggiungendo link ovunque che abbia senso. Crescerà da lì, con l'organizzazione che desideri.

Insegna a tutti come usare la Wiki

Questo potrebbe sembrare troppo ovvio per essere menzionato, ma i nuovi strumenti eccitanti finiscono spesso per essere trascurati e trascurati perché le persone semplicemente non sanno come usarli. Se tutti vedono solo il wiki come un luogo in cui cercare informazioni, non cresceranno mai. Quindi assicurati che tutti sappiano come usare e modifica il wiki.

Ognuno ha roba da dare e il wiki consente loro di farlo. Devi solo assicurarti che lo sappiano.

Registra regolarmente le modifiche

La maggior parte dei wiki lo rende davvero facile, richiamando le pagine modificate di recente in modo considerevole, magari nella pagina principale o nella pagina delle modifiche recenti. Questo ti dà la possibilità di vedere come la tua wiki sta crescendo e cosa è cambiata di recente. Ciò ti aiuterà a stare al passo con la tua squadra, a rimanere informato su nuove cose e ad assicurarti che la wiki stessa funzioni bene per la tua squadra allo stesso tempo.

Incorporare il Wiki nei tuoi flussi di lavoro

Vuoi ottenere il massimo dalla tua wiki? Usalo. Affidati alla tua documentazione, per tenerti aggiornato con le informazioni che altrimenti dovresti avere su Google, per qualsiasi cosa desideri scrivere o condividere con il tuo team. Rendilo l'unico posto per tutti i tuoi scritti e tutti impareranno a renderlo il primo posto che controlleranno. Crescerà da solo da lì.

In conclusione

Questo dovrebbe essere tutto ciò di cui hai bisogno per avere una Wiki funzionante e funzionante, e ottenere il massimo dal tuo team. I wiki sono semplici ma potenti software. E anche se ci sono molte opzioni tra cui scegliere, spero che ne abbiate trovato uno che soddisfi al meglio te e la tua piccola impresa.

Se hai iniziato a utilizzare un wiki, ci piacerebbe sapere come lo stai mettendo nei commenti qui sotto!