Wiki.js hosten, zonder iets te installeren
Een wiki die haar pagina's ook in een Git-repository wegschrijft: de documentatie blijft in de browser leesbaar en wordt geversioneerd als code.
Vanaf 8,99 €/maand
Introductie
Wiki.js door ons geïnstalleerd, bijgewerkt en geback-upt, op een machine in Frankrijk. Een moderne en snelle wiki, met een Markdown- of visuele editor, fijn rechtenbeheer en ingebouwd zoeken. Uitstekend om een vereniging of een team te documenteren. U installeert niets, u stelt geen server in: de applicatie staat enkele minuten na de bestelling online, op uw naam.
Het aanbod dat haar past is App Comfort voor 8,99 €/maand incl. btw — 4 GB geheugen. Wiki.js is een Node.js-applicatie met PostgreSQL erachter, en het geheugen dient er voor drie dingen: de renderketen, die Markdown omzet in HTML met syntaxiskleuring van code en het tekenen van diagrammen; de zoekindex over de volledige tekst, die bij elke opgeslagen pagina wordt bijgewerkt; en de Git-synchronisatie, die echte git-processen start om de repository te lezen en te schrijven. Een wiki van enkele duizenden pagina's met haar afbeeldingen past zonder moeite in dit aanbod.
Hier vervangt men Confluence, een gedeelde Notion-pagina, of een map met Word-bestanden die niemand terugvindt. Wat Wiki.js onderscheidt is haar vermogen om elke pagina tegelijk in een Git-repository en in haar eigen database te schrijven: de documentatie wordt een boom van geversioneerde Markdown-bestanden, die u buiten de wiki kunt nalezen en elders opnieuw kunt inbrengen. Het is ook de veiligste importweg: Markdown-bestanden die in de repository worden gezet verschijnen als pagina's. Voor de toegang kan het aanmelden via de bedrijfsdirectory lopen — LDAP en Active Directory, SAML, OpenID Connect — in plaats van via nóg een wachtwoord.
Wat beheerde hosting verandert
Git-synchronisatie in beide richtingen
Elke opgeslagen pagina wordt in een Git-repository geschreven, en een wijziging die naar de repository wordt gepusht komt terug in de wiki. De documentatie leeft dan op dezelfde plek als de code die ze beschrijft, met haar commitgeschiedenis, en een back-up die zonder de software leesbaar is.
Vier editors voor één wiki
Markdown met live voorbeeld voor wie snel schrijft, een visuele editor voor wie dat niet wil, ruwe HTML voor een bijzonder geval, AsciiDoc voor technische documentatie. De keuze gebeurt pagina per pagina, en een pagina kan van editor wisselen.
Rechten die de boomstructuur volgen
De regels worden per pad geschreven: openbaar lezen op /public, schrijven voorbehouden aan één groep op /procedures, onzichtbaar elders. U kunt dus een open wiki en een intern gedeelte in dezelfde installatie houden, zonder het hulpmiddel te verdubbelen.
Aanmelden via de bestaande directory
LDAP en Active Directory, SAML, OpenID Connect, of de gebruikelijke aanbieders. De groepen uit de directory voeden de rechten van de wiki: een vertrek regelt u op één plaats, en niemand heeft een extra wachtwoord te onthouden.
Waarom haar uitbesteden in plaats van zelf installeren
Een technisch team dat zijn documentatie in Git wil
De beheersprocedures leven naast de code, worden in een merge request nagelezen, en blijven leesbaar in een browser voor wie geen editor opent. Het is de meest voorkomende reden om Wiki.js boven een andere wiki te kiezen.
Een vereniging die elke twee jaar van bestuur wisselt
Hoe je een evenement aanmeldt, waar de sleutels van het lokaal liggen, welke verzekering je moet bellen: die kennis gaat bij elke overdracht verloren. Eén keer opgeschreven, gaat ze met het mandaat mee.
Een bedrijf met een Active Directory
De accounts komen uit de directory, de groepen bepalen wat ieder ziet, en een medewerker die vertrekt verliest zijn toegang zonder dat er aan de wiki wordt geraakt. De beheerder hoeft geen twee lijsten meer bij te houden.
Een wiki in meerdere talen
De pagina's worden per taal geordend en de gebruiker schakelt van de ene naar de andere. Nuttig zodra een team over twee landen verspreid zit, of wanneer openbare documentatie ook in het Engels moet bestaan.
Een kennisbank die voor het publiek open staat
De helpartikelen zijn zonder account te lezen, de kladversies en interne procedures blijven achter slot, en het zoeken toont aan de anonieme bezoeker alleen wat voor hem bedoeld is.
Gehost in Frankrijk
In onze eigen infrastructuur in Nouvelle-Aquitaine, dat we zelf beheren. Interne documentatie beschrijft uw toegangen, uw leveranciers en uw procedures: die verlaat het land niet.
Veelgestelde vragen
Via de Git-repository of de opslag op bestanden, wat de veiligste ingang is: elk Markdown-bestand dat in de boom wordt gezet wordt een pagina, met zijn pad en zijn titel. Confluence exporteert in HTML of XML, Notion in Markdown; er moet dus omgezet worden, en die omzetting verdient een apart hulpmiddel — pandoc voor HTML, de Markdown-export van Notion voor de rest. Reken op nakijken van afbeeldingen en tabellen, de twee punten waar exports achteruitgaan.
Alles, want alles kan naar bestanden worden geschreven: met de Git-synchronisatie of de lokale opslag aan, bestaan uw pagina's permanent als Markdown-bestanden in een boomstructuur, met hun commitgeschiedenis. Het is een doorlopende export in plaats van een handeling die u moet starten. Een pagina laat zich ook als pdf afdrukken vanuit de browser, en de PostgreSQL-database is als zodanig te exporteren.
De stabiele versie is 2, en die biedt slechts één thema: het aanpassen gaat via het injecteren van CSS, niet via een editor voor de vormgeving. Versie 3 is al lang aangekondigd; reken bij uw beslissing op versie 2. De reacties zijn summier, het is geen nakijkhulpmiddel. De visuele editor blijft minder voorspelbaar dan Markdown bij complexe tabellen. En er is geen mobiele app die offline werkt.
App Comfort, voor 8,99 €/maand incl. btw. Het brengt 4 GB geheugen waar de applicatie er minstens 1 GB vraagt: de marge is voor het systeem, niet voor de etalage. U kunt later van aanbod wisselen zonder opnieuw te installeren.
Niets. U kiest de applicatie, vult de velden in die ze vraagt — vaak een e-mailadres en een naam — en ze staat online. De toegang komt per e-mail, met het adres en de inloggegevens.