En el següent article anem a fer una ullada a Wiki.js. Aquesta és una aplicació wiki de codi obert lleugera i gratuïta construïda amb NODE.JS. A diferència d'altres plataformes wiki, aquesta guarda tot el teu contingut directament en arxius Markdown (.md). Aquest contingut és automàticament sincronitzat amb el repositori remot de Git de l'usuari.
Es tracta d'una aplicació wiki de codi obert, moderna i potent basada en NODE.JS, Git i Markdown. El codi font de Wiki.js està disponible públicament en Github, A punt per descarregar i instal·lar. Això és possible perquè Wiki.js és completament de codi obert, sota la llicència GNU AGPLv3.
Característiques generals de Wiki.js
- Anem a poder escriure el nostre contingut en format Markdown. utilitzarem el editor visual incorporat.
- A diferència d'un altre programari wiki que guarda contingut en una base de dades, Wiki.js guarda tot el contingut directament en arxius Markdown (.md). Aquest contingut es sincronitza automàticament amb el nostre repositori remot de Git. Si és que ens interessa.
- L'aplicació s'executa en el motor Node.js. està optimitzat per utilitzar pocs recursos de CPU. Es basa, en gran mesura, en l'emmagatzematge en memòria cau per mostrar contingut ràpidament als usuaris.
- El contingut que es generi es processa automàgicament en un format de lectura net. Es presenta dins d'una elegant interfície d'usuari.
- Anem a poder restringir l'accés a la nostra Wiki a certs usuaris o fins i tot sol a parts de l'contingut.
- Podrem iniciar sessió utilitzant la base de dades local. També podrem connectar-nos usant proveïdors externs d'autenticació com Microsoft Account, Google ID, etc.
- El programa ens donarà la possibilitat d'inserir imatges, esquemes, documents, vídeos, enllaços, etc. Per això s'utilitzarà el administrador d'actius que incorpora.
- Anem a poder trobar ràpidament l'entrada wiki que estiguem buscant utilitzant el motor de cerca incorporat. Ens va proporcionar resultats i suggeriments rellevants a l'analitzar les metadades i el contingut de les nostres entrades wiki.
Requisits de l'servidor
Per poder fer funcionar aquest programa, necessitarem disposar d'algunes coses al nostre servidor.
- NODE.JS 6.9.0 o superior.
- MongoDB 3.2 o superior.
- Git 2.7.4 o superior.
- Un repositori de Git (públic o privat). Això és opcional.
Instal·lar Wiki.js en Ubuntu
Aquest breu post veurem com instal·lar Wiki.js en un servidor Ubuntu 18.04 amb tots els seus requisits necessaris.
instal·lar Git
Per començar necessitarem instal·lar Git per executar Wiki.js. Git ve preinstal·lat al servidor Ubuntu. És possible que no necessitis instal·lar-lo. No obstant això, si necessites l'última versió de Git, Afegeix el següent repositori i instal·la:
sudo add-apt-repository -y ppa:git-core/ppa sudo apt update && sudo apt upgrade sudo apt install git
instal·lar NODE.JS
NODE.JS és un altre requisit obligatori per fer funcionar Wiki.js. Només haurem d'executar les ordres següents per instal·lar NODE.JS:
sudo apt install curl curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - sudo apt install -y nodejs
instal·lar MongoDB
MongoDB és també un dels requisits obligatoris per Wiki.js. anem a instal·lar la versió que ve en el repositori d'Ubuntu. Tan sols haurem d'executar la comanda:
sudo apt install mongodb
Descarregar i instal·lar Wiki.js
Un cop complerts tots els requisits, ja podem descarregar l'script d'instal·lació de Wiki.js i llançar-. Per fer-ho executa:
sudo mkdir /var/www/wikijs cd /var/www/wikijs curl -sSo- https://wiki.js.org/install.sh | sudo bash
Després executar el darrera comanda, hauries veure un missatge d'èxit com el següent:
Després de la instal·lació, se'ns demanarà que executem el assistent de configuració. Podem iniciar executant:
sudo node wiki configure
Aquesta comanda ens mostrarà un missatge per obrir en el navegador l'URL http: // localhost: 3000 per a configurar Wiki.js.
Si obrim el nostre navegador i busquem el nom de sistema principal de servidor o l'adreça IP seguits pel port s'iniciarà l'assistent. Aquí tindrem diferents pantalles de configuració. Si no volem complicar-nos molt, podem acceptar els paràmetres per defecte i continuar.
El programa validarà que el sistema compleix amb els requisits necessaris.
El següent que haurem de complimentar serà la configuració general.
Després haurem de configurar la connexió de MongoDB. Si la instal·lació que realitzem abans ha estat correcta, podem prémer el botó «Connecta«. La següent finestra serà la de la configuració dels Paths. Aquí recomanen deixar-podi defecte així que continuem amb la instal·lació.
A la següent pantalla podrem afegir les dades del nostre compte Git, O ometre aquest pas.
Ara haurem de crear un compte d'administrador per loguearnos més tard.
Després d'això i algunes altres pantalles de configuració, Wiki.js hauria d'estar instal·lat i llest per utilitzar.
En acabar haurem de loguearnos. Farem servir el compte d'administrador que hem creat abans per crear la nostra pàgina principal.
I després tot això, arribarem a l'editor. Aquí és des d'on podrem començar a crear.
Aquesta és només una instal·lació bàsica. per obtenir més informació sobre aquesta plataforma wiki, Sobre la seva instal·lació, el seu ús o per veure la documentació oficial, podem visitar la pàgina de el projecte.