Partint del bon objectiu de cadascú (i cada empresa), sabem que hem de tenir documentat tot el que puguem, evitant tenir-lo al cap o quan se'ns va un tècnic no se'ns vagi amb informació vital, sí o sí tots hem de documentar. Així que el que s' ha dit, os dejo Matterwiki, que no és més que una Wiki súper simple, podem fer-la servir de repositori i emmagatzemar ací tots els nostres How To's, trucs, apunts…

I per suposat cadascú pot fer servir el que vulgui, aquesta Wiki vaig estar bastant temps fent-la servir i sense pegues, es basa en un contenidor de docker, així que més fàcil impossible, la descarreguem, l'arrenquem i la tenim llista. Personalment veureu que m'agrada treure les dades fora, això és, s'emmagatzema usant un MySQL local, més avall us posaré els passos per fer-ne servir un d'extern si us interessés, i ja per rematar, doncs un exemple personalitzant-lo i canviant-li el tema per fer-lo més corporatiu i s'integri millor a la nostra empresa.

Ens basem en una Debian 9.9, us deixo els passos si necessiteu per instal·lar Docker, on primer instal·larem les dependències, posteriorment importarem la clau GPG del repositori de Docker i finalment instal·lem Docker:

[sourcecode]sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg2 git -y
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add –
sudo add-apt-repository "deb [arch = amd64] https://download.docker.com/linux/debian $(lsb_release -cs) estable"
sudo apt update
sudo apt install docker-c[/sourcecode]

I un cop tinguem Docker corrent, Matterwiki l'instal·lem en un minut, primer ens clonem el seu repositori i creem la imatge del contenidor

[sourcecode]git clone https://github.com/hydrog3n/dockerfiles.git
cd dockerfiles/matterwiki
docker build -t matterwiki .[/sourcecode]

Modifiquem el secret al fitxer de JWT:

[sourcecode]/var/lib/docker/overlay2/[ID]/diff/matterwiki/config.js[/sourcecode]

I podríem arrencar ja el contenidor amb:

[sourcecode]docker run –name=matterwiki -p 5000:5000 matterwiki[/sourcecode]

En el meu cas com comentava, utilitzo un servidor MySQL extern, així que us passo els paràmetres que hauríem d'indicar a l'hora d'arrencar el contenidor:

[sourcecode]docker run –name matterwiki -p 5000:5000 -e MYSQL_HOST=DIRECCION_IP_SERVIDOR_MYSQL -e MYSQL_USER=USUARIO_MYSQL -e MYSQL_PASSWORD=CONTRASEÑA_MYSQL -e MYSQL_DATABASE=BASE_DE_DATOS -e AUTHSECRET=SECRETO_JWT matterwiki[/sourcecode]

I ja podríem accedir a la URL del nostre Matterwiki, des de: “http://DIRECCION_IP:5000/#/setup”, crearem el nostre primer compte amb privilegis d'administrador dins de Matterwiki, indiquem nom, cognom, email i contrasenya, posem en “Setup My Account”,

I res, aquest seria la nostra vista principal, a l'esquerra veurem les categories, i això és molt simple, només podrem crear més categories per ordenar el nostre contingut, i l'altre que podrem fer, doncs serà crear els documents a la wiki des de “New Article”,

El que s'ha dit, podrem crear les Categories que necessitem per ordenar el contingut, així com pujar el nostre propi logo per donar-li un toc més personal o afegir més usuaris per accedir a la wiki. Per cert, si voleu personalitzar també els colors de Matterwiki per posar el vostre color corporatiu, necessitareu modificar aquests 2 CSS:

[sourcecode]/diff/matterwiki/client/assets/bootstrap.css
/diff/matterwiki/client/assets/style.css[/sourcecode]

Aquest seria una pantalla de com és l'interfície per crear posts a la nostra Wiki., és molt simpló, senzill…

Aquest seria un pantalla de com quedaria un document a la Wiki per a la seva consulta posterior, podrem editar-lo i repassar el seu historial de modificacions si fos necessari.

I aquest últim seria de la pantalla inicial, on podrem veure els últims documents, podrem navegar per les categories o directament fent servir el botó de recerca podrem localitzar ràpidament qualsevol article.