Kuinka asentaa Wiki.js ja saada oma wiki minuuteissa

Wiki.js on tehokas avoimen lähdekoodin wiki-alusta, joka voidaan asentaa helposti Dockerin avulla. Tämä opas opastaa sinut asennusprosessin läpi nopeasti ja vaivattomasti.

Wiki.js on tehokas avoimen lähdekoodin wiki-alusta, joka on rakennettu Node.js:n päälle. Se tukee sekä Markdown- että WYSIWYG-muokkautumista, reaaliaikaista yhteistyötä, versionhallintaa ja joustavia todennusvaihtoehtoja, mukaan lukien Google ja LDAP. Tässä oppaassa näytämme, kuinka voit asentaa Wiki.js:n Dockerin avulla, jotta saat wikisi toimintakuntoon vain muutamassa minuutissa.

Asenna Wiki.js Docker Compose:lla

Dockerin ja Docker Compose:n avulla Wiki.js:n asentaminen on uskomattoman helppoa. Ensiksi, luo hakemisto nimeltä “wikijs-docker” ja siirry siihen cd-komennolla:

mkdir wikijs-docker && cd wikijs-docker

Tämän jälkeen, luo “docker-compose.yml” tiedosto missä tahansa tekstieditorissa:

nano docker-compose.yml

Ja liitä sitten seuraava sisältö tähän tiedostoon:

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:

Tallenna ja sulje tiedosto, ja käynnistä kontit seuraavalla komennolla:

docker compose up -d

Kun asennus on valmis, avaa wiki.js selaimessasi osoitteessa http://localhost. Määritä ylläpitotilin tiedot ja napsauta Asenna-painiketta aloittaaksesi asennuksen:

Asennuksen jälkeen syötä käyttäjätietosi kirjautuaksesi sisään.

Sivujen luominen ja hallinta Wiki.js:ssä

Nyt voit luoda etusivun aloittaaksesi sisällön lisäämisen tai käyttää hallintapaneelia asetusten, käyttäjien ja ominaisuuksien hallintaan:

Jos napsautat Luo etusivu -painiketta, sinua pyydetään valitsemaan muokkaustyökalu sivua varten. Valitse omaan mieltymykseesi ja tarpeisiisi perustuva vaihtoehto:

Määritä sivun ominaisuudet ja napsauta OK -painiketta luodaksesi uuden sivun:

Kirjoita mitä haluat ja napsauta Luoda -painiketta luodaksesi sivun:

Sisällön hallinta ja organisointi

Kojelaudalla voit tarkastella ja muokata olemassa olevia sivuja, luoda uusia sivuja käyttäen haluamaasi muokkaustyökalua sekä organisoida sisältöä siirtämällä, nimeämällä tai poistamalla sivuja. Voit myös lisätä tageja luokitellaksesi sisältöä tehokkaasti. Lisäksi sivupalkki ja hakupalkki helpottavat nopeaa navigointia erityisiin sivuihin wikissäsi:

Wiki.js:n sivustoa asetukset

Wiki.js:n hallintapaneelissa voit määrittää sivuston asetuksia, kuten paikallisuuden, navigoinnin, teemat ja tagit. Nämä vaihtoehdot auttavat määrittämään Wiki.js-instanssisi globaalin konfiguraation.

Voit määrittää perussivustokohtaisia asetuksia Yleiset -välilehdellä, kuten sivuston nimen, kuvauksen, oletusetusivun ja sivuston näkyvyyden (julkinen tai yksityinen):

Siirry Paikallisuus -välilehdelle asettaaksesi oletuskielen, aikavyöhykkeen ja päivämäärä/aika-muodot, joita käytetään koko sivustolla:

Hallinnoi wikin valikoiden rakennetta ja säätele, kuinka käyttäjät selviävät sisällöstä siirtymällä Navigointipalkki -osioon.

Sivut -välilehdellä voit tarkastella, hallita ja organisoida kaikkia wiki-sivuja. Voit luoda uusia sivuja, muokata olemassa olevia tai hallita sivuhierarkiaa.

Voit myös luoda ja hallita sisältötageja Tagit -välilehdellä auttaaksesi luokittelemaan sivuja ja parantamaan hakutuloksia. Samoin voit muuttaa wikin ulkoasua ja tunnelmaa Teema -välilehdellä. Esimerkiksi voit muuttaa sivuston logoa, värejä, fontteja ja ulkoasuteemoja.

Hallinnoi ryhmiä Wikissäsi

Ryhmä -osiossa voit luoda käyttäjäryhmiä, määrittää jäseniä ja asettaa ryhmätason käyttöoikeuksia hallitaksesi pääsyä. Käytä ryhmiä järjestääksesi käyttäjiä roolien mukaan ja hallitaksesi heidän käyttöoikeuksiaan johdonmukaisesti koko wikissäsi.

Voit napsauttaa tiettyä ryhmää päivittääksesi sen asetuksia, käyttöoikeuksia, sivusääntöjä ja hallitaksesi käyttäjiä kyseisessä ryhmässä.

Asetukset-välilehti mahdollistaa kirjautumisen yhteydessä käytettävän uudelleenohjaus-URL:n määrittämisen.

Lisäksi voit siirtyä Oikeudet, Sivusäännöt ja Käyttäjät -välilehtiin hallitaksesi, mihin ryhmä voi osallistua ja ketkä käyttäjät on sille määrätty.

Käyttäjien Hallinta Wiki.js:ssä

Uuden käyttäjän luomiseksi siirry Käyttäjät osioon, napsauta UUSI KÄYTTÄJÄ -painiketta ja määritä tarvittavat tiedot.

Tämän jälkeen klikkaa Luo tai Luo ja sulje -painiketta uuden käyttäjän luomiseksi:

Napsauta tiettyä käyttäjää nähdäksesi ja muokataksesi heidän profiiliaan, määrittääksesi heidät käyttäjäryhmiin, asettaaksesi todennusmenetelmiä, kuten salasanoja ja kaksivaiheista todennusta, ja hallitaksesi heidän tilaansa toimilla, kuten Deaktivoi, Vahvista tai Poista:

Voit myös päivittää heidän perustietonsa, laajennetut metatiedot (kuten sijainti ja työnimike) ja seurata heidän toimintahistoriaansa:

Hallitse Wiki-moduulejasi

Moduulit ovat valinnaisia ominaisuuksia, jotka parantavat Wiki.js:n toiminnallisuutta. Esimerkiksi Analytiikka -moduuli mahdollistaa Google Analyticsin kaltaisten integraatioiden käyttöönoton ja määrittämisen käyttäjäkäyttäytymisen ja liikenteen seuraamiseksi wikiisi.

Käytä Todennus -välilehteä todennuspalveluntarjoajien (kuten paikallisen kirjautumisen, LDAP:n, OAuthin) asentamiseen ja hallintaan sekä kirjautumisvaihtoehtojen määrittämiseen.

Voit ottaa käyttöön tai poistaa käytöstä kommentointijärjestelmän ja valita, kuinka käyttäjät voivat osallistua sivujen keskusteluihin.

Järjestelmän Asetukset

Voit hallita myös, miten sisältöä renderöidään, haetaan ja tallennetaan määrittämällä renderointimoottoreita, hakukoneita ja tallennusvaihtoehtoja. Esimerkiksi voit siirtyä Renderointi -välilehteen mukauttamaan, miten sisältöä renderöidään, kuten Markdown-moottorin asetukset tai tuki kaavioille, matemaattisille lausekkeille jne.

Hakukone -osiossa voit määrittää sisäiset hakukoneindeksointi vaihtoehdot ja integraatiot hakukoneiden kanssa:

Siirry Tallennus -osioon asettaaksesi varmuuskopioinnin ja synkronoinnin kohteet sisällöllesi. Tässä voit hallita, minne ja miten media ja sivuliitteet tallennetaan (paikallinen tiedostojärjestelmä, AWS S3 jne.):

Hallitse Turvallisuutta ja Yhteyksiä

Voit hallita turvallisuutta ja yhteyksiä määrittämällä API-käytön, asettamalla sähköpostin ilmoituksia varten, säätämällä turvallisuuspolitiikkaa ja ottamalla SSL:n käyttöön suojataksesi Wiki.js -sivustosi. Esimerkiksi voit hallita API-tokeneita integroidaksesi Wiki.js:n ulkoisiin järjestelmiin tai omiin mukautettuihin sovelluksiisi:

Voimme asettaa lähtevät sähköposti -asetukset käsittelemään ilmoituksia, kutsuja ja salasanan palautusta Wiki.js:ssä.

Voit määrittää Turvallisuus -asetuksia, kuten istuntoaikoja, salasanakäytäntöjä ja pääsyrajoituksia.

Lisäksi voit asentaa SSL/TLS -sertifikaatteja suojataksesi Wiki.js -sivustoasi HTTPS:llä.

Muuten voit tarkistaa Wiki-tietosi, kuten järjestelmädiagnostiikat, palvelintiedot ja suoritusympäristön tilastot Järjestelmä Tiedot -osiossa.

Voit suorittaa ylläpitotoimia, kuten hakukoneindeksoinnin uusimista, välimuistin tyhjentämistä tai asetusten palauttamista Työkalut -välilehdeltä.

Viimeisenä, Kehittäjätyökalut antavat sinulle pääsyn edistyneisiin työkaluihin, kuten GraphQL-leikkikenttään, virheenkorjauslokeihin tai mukautettuihin skripteihin:

Nyt kun olet oppinut kuinka asentaa Wiki.js Dockerilla, voit käyttää sitä sisäisen dokumentaation, tiimivihkojen tai jopa julkisten tietopankkien rakentamiseen vaivattomasti. Jos harkitset vielä vaihtoehtojasi, tutustu DokuWiki vs Wiki.js -vertailuumme nähdäksesi, mikä alusta sopii parhaiten projektiisi.

Nyt kun olet lukenut Kuinka asentaa Wiki.js ja saada oma wiki minuuteissa loppuun, kutsumme sinut tutustumaan lisää Oppaat-kategoriaan. Löydät sieltä muita mielenkiintoisia artikkeleita, jotka laajentavat tietojasi ja pitävät sinut ajan tasalla. Älä lopeta lukemista ja löytämistä!