Wiki.js on tehokas avoimen lähdekoodin wiki-alusta, joka on rakennettu Node.js. Se tukee sekä Markdown- että WYSIWYG-muokkaamista, reaaliaikaista yhteistyötä, versionhallinta- ja joustavia todennusvaihtoehtoja, mukaan lukien Google ja LDAP. Tässä oppaassa näytämme sinulle, kuinka asentaa wiki.js Dockerin kanssa, jotta voit saada wikiäsi ja toimimaan vain muutamassa minuutissa.
Sisällysluettelo
- Asenna wiki.js käyttämällä Docker Compose -sovellusta
- Sivujen luominen ja hallinta wiki.js
- Hallitse ja järjestä sisältöä
- Wiki.js -sivustoasetukset
- Hallitse ryhmiä wiki
- Käyttäjän hallinta Wiki.js
- Hallitse wiki -moduulejasi
- Järjestelmän kokoonpano
- Hallitse turvallisuutta ja yhteyksiä
Asenna wiki.js käyttämällä Docker Compose -sovellusta
Docker- ja Docker Compose -sovelluksen avulla on uskomattoman helppoa asentaa wiki.js. Luo ensin hakemisto nimeltä “Wikijs-Docker” ja käytä sitä CD-komennolla:
mkdir wikijs-docker && cd wikijs-dockerTämän jälkeen luo ”Docker-compose.yml” -tiedosto missä tahansa tekstieditorissa:
nano docker-compose.ymlJa 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ä sitten säilöt seuraavan komennon avulla:
docker compose up -dKun asennus on valmis, avaa Wiki.js selaimessa osoitteessahttps: // localhost. Määritä järjestelmänvalvojan tilin tiedot ja napsauta Asenna -painiketta aloittaaksesi asennuksen:
Asennuksen jälkeen kirjoita käyttöoikeustiedot kirjautuaksesi sisään.
Sivujen luominen ja hallinta wiki.js
Nyt voit luodakotisivuAloita sisällön lisääminen tai hallintapaneelin käyttäminen asetusten, käyttäjien ja ominaisuuksien hallintaan:
Jos napsautatLuo kotisivuPainike, sinua pyydetään valitsemaantoimittajasivulle. Valitse yksi mieltymysten ja vaatimusten perusteella:
Määritä sivun ominaisuudet ja napsautaHyväPainike uuden sivun luomiseen:
Kirjoita mitä haluat ja napsautaLuodaPainike sivun luomiseen:
Hallitse ja järjestä sisältöä
Kojelaudassa voit tarkastella ja muokata olemassa olevia sivuja, luoda uusia sivuja haluamasi editorilla ja järjestää sisältösi siirtämällä, uudelleennimeämällä tai poistamalla sivuja. Voit myös lisätä tunnisteita sisällön luokittelemiseksi tehokkaasti. Lisäksi sivupalkki ja hakupalkki helpottavat navigoida nopeasti tietyille sivuille wiki:
Wiki.js -sivustoasetukset
Wiki.js -hallintapaneelissa voit määrittää sivustoasetukset, kuten sijainti, navigointi, teemat ja tunnisteet. Nämä vaihtoehdot auttavat määrittelemään wiki.js -ilmentymän globaalin kokoonpanon.
Voit määrittää perussivuston laajuiset asetuksetYleinenTAB, kuten sivuston otsikko, kuvaus, oletuskotisivu ja sivuston näkyvyys (julkinen tai yksityinen):
SiirtyäPaikallinenTAB Aseta oletuskieli, aikavyöhyke ja päivämäärä-/aikamuodot, joita käytetään sivustolla:
Mene wiki -valikoidesi rakenteen hallintaan ja hallitaksesi sitä, kuinka käyttäjät selaavat sisältöä, meneNavigointipalkki.
SiinäSivutTAB, voit tarkastella, hallita ja järjestää kaikki wiki -sivut. Voit luoda uusia sivuja, muokata olemassa olevia sivuja tai hallita sivuhierarkiaa.
Voit myös luoda ja hallita sisältötunnisteitaTunnisteetTAB auttaaksesi luokittelemaan sivuja ja parantamaan hakutettavuutta. Samoin voit muokata wikin ulkoasua ja tunnettaTeemavälilehti. Voit esimerkiksi muokata sivuston logoa, värejä, fontteja ja asetteluteemoja.
Hallitse ryhmiä wiki
SiinäRyhmätOsa, voit luoda käyttäjäryhmiä, määrittää jäseniä ja asettaa ryhmätason käyttöoikeudet pääsyn hallintaan. Käytä ryhmiä käyttäjien järjestämiseen roolilla ja hallita heidän pääsyä johdonmukaisesti wiki -alueellasi.
Voit napsauttaa aerityinen ryhmäPäivittää asetukset, käyttöoikeudet, sivusäännöt ja hallita käyttäjiä kyseisessä ryhmässä. SeAsetuksetTAB: n avulla voit määrittää vaihtoehdot, kuten uudelleenohjaus -URL -osoitteen kirjautumisen yhteydessä.
Lisäksi voit selataKäyttöoikeudet-SivusäännötjaKäyttäjätVälilehdet hallitaan, mitä ryhmä voi käyttää ja mitkä käyttäjät sille määritetään.
Käyttäjän hallinta Wiki.js
Luo uuden käyttäjän siirtymälläKäyttäjätnapsautaUusi käyttäjäPainike ja määritä vaadittavat tiedot.
Lue lisää:Dokuwiki vs wiki.js: Mikä itse isännöity wiki on sinulle sopiva?
Napsauta tämän jälkeenLUODAtaiLuo ja suljePainike uuden käyttäjän luomiseen:
Napsauta atietty käyttäjäJos haluat tarkastella ja muokata heidän profiiliaan, määritä ne käyttäjäryhmille, aseta todennusmenetelmät, kuten salasanat ja kaksikerroinen todennus, ja hallita heidän tilaaan sellaisten toimintojen avullaDeaktivoida-VahvistaataiPoistaa-
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 -toiminnallisuutta. EsimerkiksiAnalytiikkaModuulin avulla voit ottaa käyttöön ja määrittää integraatiot, kuten Google Analytics, seuraamaan käyttäjän käyttäytymistä ja liikennettä wiki -alueellasi.
KäyttääTodennusTAB Aseta ja hallita todennustoimittajia (kuten paikallinen kirjautumisen, LDAP, OAuth) ja määritä kirjautumisvaihtoehdot.
Voit ottaa kommentointijärjestelmän käyttöön tai poistaa käytöstä ja valita, kuinka käyttäjät ovat vuorovaikutuksessa sivukeskustelujen kanssa.
Järjestelmän kokoonpano
Voit myös hallita sitä, miten sisältöä tehdään, haetaan ja tallennetaan määrittämällä renderointimoottorit, hakuindeksointi- ja tallennusvaihtoehdot. Esimerkiksi voit siirtyäRenderointiTAB MUUTOA, MITEN Sisältöä, kuten merkinnän moottorin asetukset tai kaavioiden, matematiikan lausekkeiden jne. Tuki
SiinäHakukoneOsa, voit määrittää sisäiset haun indeksointivaihtoehdot ja integroinnit hakukoneisiin:
MennäSäilytys-Osa asettaa varmuuskopio- ja synkronointikohteet sisältöllesi. Tässä voit hallita missä ja miten media- ja sivuliitteet tallennetaan (paikallinen tiedostojärjestelmä, AWS S3 jne.):
Hallitse turvallisuutta ja yhteyksiä
Voit hallita suojausta ja liitettävyyttä määrittämällä sovellusliittymän käyttöoikeus, määrittämällä sähköpostia ilmoituksia varten, säätämällä suojauskäytäntöjä ja antamalla SSL: n avulla varmistaa Wiki.js -sivustosi. Esimerkiksi voit hallitaAPI -rahakkeetintegroida wiki.js ulkoisiin järjestelmiin tai omiin mukautetuihin sovelluksiin:
Voimme perustaa lähtevänsähköpostiAsetukset hoitamaan ilmoituksia, kutsuja ja salasanan palautusta wiki.js.
Voit määrittääTurvallisuusAsetukset, kuten istunnon aikakatkaisut, salasanakäytännöt ja pääsyrajoitukset.
Tämän lisäksi voit perustaaSSL/TLSSertifikaatit Wiki.js -sivustosi turvaamiseksi HTTPS: llä.
Muuten kuin voit vahvistaa wiki -tietosi, kuten näkymäjärjestelmän diagnostiikka, palvelintiedot ja suoritusympäristötilastot,Järjestelmätiedotosa.
Voit suorittaa huoltotoimenpiteitä, kuten haun uudelleenohjauksen, välimuistien tyhjentämisen tai kokoonpanojen nollaamisenLaitoksetvälilehti.
Lopuksi,KehittäjätyökalutVoit käyttää edistyneitä työkaluja, kuten GraphQL -leikkikenttä, virheenkorjauslokit tai mukautetut skriptit:
Nyt kun olet oppinut perustamaan Wiki.js Dockerin kanssa, voit käyttää sitä sisäisten dokumentaation, tiimin wikien tai jopa julkisten tietokantojen rakentamiseen helposti. Jos punnitset edelleen vaihtoehtoja, tutustu Dokuwiki vs wiki.js -vertailuun nähdäksesi, mikä alusta sopii projektillesi.
