Wiki.js je výkonná open-source wiki platforma postavená na Node.js. Podporuje úpravy Markdown i WYSIWYG, spolupráci v reálném čase, správu verzí a flexibilní možnosti ověřování, včetně Google a LDAP. V této příručce vám ukážeme, jak nastavit Wiki.js pomocí Dockeru, abyste mohli svou wiki zprovoznit během několika minut.
Obsah
- Nainstalujte Wiki.js pomocí Docker Compose
- Vytváření a správa stránek ve Wiki.js
- Spravujte a organizujte obsah
- Nastavení webu Wiki.js
- Správa skupin na vaší Wiki
- Správa uživatelů ve Wiki.js
- Spravujte své moduly Wiki
- Konfigurace systému
- Správa zabezpečení a připojení
Nainstalujte Wiki.js pomocí Docker Compose
Pomocí Docker a Docker Compose je neuvěřitelně snadné nastavit wiki.js. Nejprve vytvořte adresář s názvem „wikijs-docker“ a otevřete jej pomocí příkazu cd:
mkdir wikijs-docker && cd wikijs-dockerPoté vytvořte soubor „docker-compose.yml“ v libovolném textovém editoru:
nano docker-compose.ymlA poté do tohoto souboru vložte následující obsah:
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:Uložte a zavřete soubor a poté spusťte kontejnery pomocí následujícího příkazu:
docker compose up -dPo dokončení nastavení otevřete wiki.js ve svém prohlížeči na adresehttps://localhost. Zadejte podrobnosti o účtu správce a kliknutím na tlačítko Instalovat spusťte instalaci:
Po instalaci zadejte své přihlašovací údaje pro přihlášení.
Vytváření a správa stránek ve Wiki.js
Nyní můžete vytvořitdomovskou stránkuChcete-li začít přidávat obsah nebo otevřít panel pro správu pro správu nastavení, uživatelů a funkcí:
Pokud kliknete naVytvořit domovskou stránkutlačítko, budete požádáni o výběreditorpro stránku. Vyberte si ten na základě vašich preferencí a požadavků:
Zadejte vlastnosti stránky a klikněte naOKtlačítko pro vytvoření nové stránky:
Napište co chcete a klikněte naVytvořittlačítko pro vytvoření stránky:
Spravujte a organizujte obsah
Na řídicím panelu můžete prohlížet a upravovat stávající stránky, vytvářet nové stránky pomocí preferovaného editoru a organizovat obsah přesouváním, přejmenováním nebo mazáním stránek. Můžete také přidat štítky pro efektivní kategorizaci obsahu. Postranní panel a vyhledávací panel navíc usnadňují rychlou navigaci na konkrétní stránky ve vaší wiki:
Nastavení webu Wiki.js
V administračním panelu Wiki.js můžete konfigurovat nastavení webu, jako je národní prostředí, navigace, motivy a značky. Tyto možnosti pomáhají definovat globální konfiguraci vaší instance Wiki.js.
Základní nastavení pro celý web můžete nakonfigurovat vGenerálkartu, jako je název webu, popis, výchozí domovská stránka a viditelnost webu (veřejné nebo soukromé):
Přejděte naNárodní prostředíkartu pro nastavení výchozího jazyka, časového pásma a formátů data/času používaných na webu:
Chcete-li spravovat strukturu nabídek vaší wiki a ovládat, jak uživatelé procházejí obsah, přejděte na stránkuNavigační lišta.
VStránkymůžete prohlížet, spravovat a organizovat všechny stránky wiki. Můžete vytvářet nové stránky, upravovat stávající nebo spravovat hierarchii stránek.
Můžete také vytvářet a spravovat značky obsahu podTagykartu, která vám pomůže kategorizovat stránky a zlepšit možnosti vyhledávání. Podobně můžete upravit vzhled a chování vaší wiki zTématab. Můžete například upravit logo webu, barvy, písma a motivy rozvržení.
Správa skupin na vaší Wiki
VSkupinymůžete vytvářet skupiny uživatelů, přiřazovat členy a nastavovat oprávnění na úrovni skupiny pro řízení přístupu. Pomocí skupin organizujte uživatele podle rolí a spravujte jejich přístup konzistentně na vaší wiki.
Můžete kliknout na akonkrétní skupinaaktualizovat jeho nastavení, oprávnění, pravidla stránky a spravovat uživatele v rámci této skupiny. TheNastaveníumožňuje konfigurovat možnosti, jako je adresa URL přesměrování při přihlášení.
Kromě toho můžete procházetOprávnění,Pravidla stránkyaUživatelékartách pro kontrolu, k čemu má skupina přístup a kteří uživatelé jsou k ní přiřazeni.
Správa uživatelů ve Wiki.js
Chcete-li vytvořit nového uživatele, přejděte naUživateléklikněte naNOVÝ UŽIVATELa zadejte požadované podrobnosti.
Poté klikněte naVYTVOŘITneboVYTVOŘIT A ZAVŘÍTtlačítko pro vytvoření nového uživatele:
Klikněte na akonkrétního uživateleprohlížet a upravovat jejich profil, přiřazovat je do skupin uživatelů, nastavovat metody ověřování, jako jsou hesla a dvoufaktorové ověřování, a spravovat jejich stav pomocí akcí, jako jeDeaktivovat,OvěřteneboVymazat:
Můžete také aktualizovat jejich základní informace, rozšířená metadata (jako je poloha a název práce) a sledovat historii jejich aktivit:
Spravujte své moduly Wiki
Moduly jsou volitelné funkce, které vylepšují funkčnost Wiki.js. Například,Analyticsumožňuje povolit a nakonfigurovat integrace, jako je Google Analytics, pro sledování chování uživatelů a provozu na vaší wiki.
PoužijteAutentizacek nastavení a správě poskytovatelů ověřování (jako je místní přihlášení, LDAP, OAuth) a konfiguraci možností přihlášení.
Doporučené čtení:125 nejlepších nástrojů umělé inteligence k dokončení hodin práce během několika minut (2025)
Můžete povolit nebo zakázat systém komentářů a zvolit způsob interakce uživatelů s diskusemi na stránce.
Konfigurace systému
Můžete také spravovat způsob vykreslování, vyhledávání a ukládání obsahu konfigurací vykreslovacích strojů, indexování vyhledávání a možností úložiště. Můžete například přejít doVykreslováníkartu pro přizpůsobení způsobu vykreslování obsahu, jako je nastavení modulu Markdown nebo podpora diagramů, matematických výrazů atd.
VVyhledávaččásti, můžete nakonfigurovat možnosti interního indexování vyhledávání a integraci s vyhledávači:
Přejít naSkladováníčásti pro nastavení cílů zálohování a synchronizace pro váš obsah. Zde můžete spravovat, kde a jak se ukládají přílohy médií a stránek (místní souborový systém, AWS S3 atd.):
Správa zabezpečení a připojení
Zabezpečení a konektivitu můžete spravovat konfigurací přístupu k rozhraní API, nastavením e-mailu pro upozornění, úpravou zásad zabezpečení a povolením protokolu SSL k zabezpečení vašeho webu Wiki.js. Například můžete spravovatAPI tokenypro integraci Wiki.js s externími systémy nebo vašimi vlastními aplikacemi:
Můžeme nastavit odchozíe-mailnastavení pro zpracování oznámení, pozvánek a obnovení hesla ve Wiki.js.
Můžete konfigurovatZabezpečenínastavení, jako jsou časové limity relace, zásady hesel a omezení přístupu.
Kromě toho můžete nastavitSSL/TLScertifikáty k zabezpečení vašeho webu Wiki.js pomocí HTTPS.
Kromě toho můžete potvrdit své informace na Wiki, jako je zobrazení diagnostiky systému, podrobností o serveru a statistiky runtime prostředí, zInformace o systémusekce.
Můžete provádět akce údržby, jako je přeindexování vyhledávání, vymazání mezipaměti nebo resetování konfigurací zUtilitytab.
Konečně,Vývojářské nástrojevám umožní přístup k pokročilým nástrojům, jako je hřiště GraphQL, protokoly ladění nebo vlastní skripty:
Nyní, když jste se naučili, jak nastavit Wiki.js pomocí Dockeru, můžete jej snadno použít k vytváření interní dokumentace, týmových wiki nebo dokonce veřejných znalostních bází. Pokud stále zvažujete své možnosti, podívejte se na naše srovnání DokuWiki vs Wiki.js a zjistěte, která platforma je pro váš projekt ta pravá.
