Come impostare Wiki.js e avere il proprio wiki in pochi minuti
Wiki.js è una potente piattaforma wiki open-source costruita su Node.js. Supporta sia l’editing Markdown che WYSIWYG, la collaborazione in tempo reale, il controllo delle versioni e opzioni di autenticazione flessibili, incluso Google e LDAP. In questa guida, ti mostreremo come impostare Wiki.js con Docker in modo da poter avviare il tuo wiki in pochi minuti.
Installa Wiki.js utilizzando Docker Compose
Utilizzando Docker e Docker Compose, è incredibilmente facile impostare wiki.js. Prima di tutto, crea una directory chiamata “wikijs-docker” e accedivi utilizzando il comando cd:
mkdir wikijs-docker && cd wikijs-dockerDopo questo, crea un file “docker-compose.yml” in qualsiasi editor di testo:
nano docker-compose.ymlE poi, incolla il seguente contenuto in questo file:
services:
db:
image: postgres:16
environment:
POSTGRES_DB: wiki
POSTGRES_PASSWORD: wikijsrocks
POSTGRES_USER: wikijs
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql/data
wiki:
image: ghcr.io/requarks/wiki:2
depends_on:
- db
environment:
DB_TYPE: postgres
DB_HOST: db
DB_PORT: 5432
DB_USER: wikijs
DB_PASS: wikijsrocks
DB_NAME: wiki
restart: unless-stopped
ports:
- "80:3000"
volumes:
db-data:Salva e chiudi il file, quindi avvia i contenitori utilizzando il seguente comando:
docker compose up -d
Una volta completata l’installazione, apri wiki.js nel tuo browser all’indirizzo http://localhost. Specifica i dettagli dell’account admin e fai clic sul pulsante Installa per avviare l’installazione:
Dopo l’installazione, inserisci le tue credenziali per effettuare il login.
Creazione e Gestione delle Pagine in Wiki.js
Ora puoi creare la pagina principale per iniziare ad aggiungere contenuti oppure accedere al pannello di amministrazione per gestire impostazioni, utenti e funzionalità:
Se fai clic sul pulsante Crea Pagina Principale, ti verrà chiesto di selezionare un editor per la pagina. Seleziona quello in base alle tue preferenze e requisiti:
Specifica le proprietà della pagina e fai clic sul pulsante OK per creare una nuova pagina:
Scrivi ciò che vuoi e fai clic sul pulsante Crea per creare la pagina:
Gestire e Organizzare i Contenuti
Nella dashboard, puoi visualizzare e modificare le pagine esistenti, creare nuove pagine utilizzando il tuo editor preferito e organizzare i tuoi contenuti spostando, rinominando o eliminando pagine. Puoi anche aggiungere tag per categorizzare i contenuti in modo efficace. Inoltre, la barra laterale e la barra di ricerca rendono facile navigare rapidamente verso pagine specifiche all’interno del tuo wiki:
Impostazioni del Sito Wiki.js
Nel pannello di amministrazione di Wiki.js, puoi configurare le impostazioni del sito come locale, navigazione, temi e tag. Queste opzioni aiutano a definire la configurazione globale della tua istanza di Wiki.js.
Puoi configurare le impostazioni di base del sito nella scheda Generale, come titolo del sito, descrizione, homepage predefinita e visibilità del sito (pubblica o privata):
Naviga alla scheda Locale per impostare la lingua predefinita, il fuso orario e i formati di data/ora utilizzati in tutto il sito:
Per gestire la struttura dei menu del tuo wiki e controllare come gli utenti navigano nei contenuti, vai alla Barra di Navigazione.
Nella scheda Pagine, puoi visualizzare, gestire e organizzare tutte le pagine del wiki. Puoi creare nuove pagine, modificare quelle esistenti o gestire la gerarchia delle pagine.
Puoi anche creare e gestire tag di contenuto nella scheda Tag per aiutare a categorizzare le pagine e migliorare la ricercabilità. Allo stesso modo, puoi modificare l’aspetto e il feeling del tuo wiki dalla scheda Tema. Ad esempio, puoi modificare il logo del sito, i colori, i caratteri e i temi del layout.
Gestire i Gruppi nel Tuo Wiki
Nella sezione Gruppi, puoi creare gruppi di utenti, assegnare membri e impostare permessi a livello di gruppo per controllare l’accesso. Utilizza i gruppi per organizzare gli utenti in base al ruolo e gestire il loro accesso in modo coerente in tutto il tuo wiki.
Puoi fare clic su un gruppo particolare per aggiornare le sue impostazioni, permessi, regole di pagina e gestire gli utenti all’interno di quel gruppo. La scheda Impostazioni ti consente di configurare opzioni come l’URL di reindirizzamento dopo il login.
Inoltre, puoi navigare attraverso le schede Permessi, Regole di Pagina e Utenti per controllare a cosa può accedere il gruppo e quali utenti sono assegnati ad esso.
Gestione Utenti in Wiki.js
Per creare un nuovo utente, vai alla sezione Utenti, fai clic sul pulsante NUOVO UTENTE e specifica i dettagli richiesti.
Dopo questo, fai clic sul pulsante CREA o CREA E CHIUDI per creare un nuovo utente:
Fai clic su un utente specifico per visualizzarne e modificarne il profilo, assegnarlo a gruppi di utenti, impostare metodi di autenticazione come password e autenticazione a due fattori, e gestire il loro stato utilizzando azioni come Disattiva, Verifica o Elimina:
Puoi anche aggiornare le loro informazioni di base, metadati estesi (come posizione e titolo di lavoro) e monitorare la loro cronologia delle attività:
Gestisci i Moduli del Tuo Wiki
I moduli sono funzionalità opzionali che migliorano la funzionalità di Wiki.js. Ad esempio, il modulo Analytics ti consente di abilitare e configurare integrazioni come Google Analytics per tracciare il comportamento degli utenti e il traffico sul tuo wiki.
Usa la scheda Autenticazione per impostare e gestire i fornitori di autenticazione (come login locale, LDAP, OAuth) e configurare opzioni di login.
Puoi abilitare o disabilitare il sistema di commenti e scegliere come gli utenti interagiscono con le discussioni delle pagine.
Configurazione del Sistema
Puoi anche gestire come i contenuti vengono visualizzati, cercati e memorizzati configurando motori di rendering, indicizzazione di ricerca e opzioni di archiviazione. Ad esempio, puoi navigare alla scheda Rendering per personalizzare come i contenuti vengono visualizzati, come le impostazioni del motore Markdown o il supporto per diagrammi, espressioni matematiche, ecc.
Nella sezione Motore di Ricerca, puoi configurare opzioni di indicizzazione di ricerca interne e integrazioni con motori di ricerca:
Vai alla sezione Archiviazione per impostare backup e obiettivi di sincronizzazione per i tuoi contenuti. Qui puoi gestire dove e come vengono memorizzati i media e gli allegati di pagina (filesystem locale, AWS S3, ecc.):
Gestione della Sicurezza e della Connettività
Puoi gestire la sicurezza e la connettività configurando l’accesso API, impostando email per notifiche, regolando le politiche di sicurezza e abilitando SSL per proteggere il tuo sito Wiki.js. Ad esempio, puoi gestire token API per integrare Wiki.js con sistemi esterni o le tue applicazioni personalizzate:
Possiamo impostare impostazioni email in uscita per gestire notifiche, inviti e recupero password in Wiki.js.
Puoi configurare impostazioni di Sicurezza come timeout di sessione, politiche di password e restrizioni di accesso.
A parte questo, puoi impostare certificati SSL/TLS per proteggere il tuo sito Wiki.js con HTTPS.
Al di là di ciò, puoi confermare le informazioni del tuo Wiki, come visualizzare diagnosi di sistema, dettagli del server e statistiche dell’ambiente di runtime, dalla sezione Informazioni di Sistema.
Puoi eseguire azioni di manutenzione come reindicizzazione della ricerca, cancellazione della cache o ripristino delle configurazioni dalla scheda Utilità.
Infine, gli Strumenti per Sviluppatori ti permettono di accedere a strumenti avanzati come GraphQL playground, registri di debug o script personalizzati:
Ora che hai imparato come impostare Wiki.js con Docker, puoi usarlo per costruire documentazione interna, wiki di team o persino basi di conoscenza pubbliche con facilità. Se stai ancora valutando le tue opzioni, dai un’occhiata al nostro confronto tra DokuWiki e Wiki.js per vedere quale piattaforma è la più adatta al tuo progetto.
