Montando BookStack, la mejor Wiki del mundo

Bo, perdonadme pero hoy vengo muy contento, os presento una joyita, para mí personalmente la millor Wiki open source, super lleugera, super senzilla, personalitzable, bonita… ¡me tiene enamoradito! ¡BookStack!

Si eres de los que te gusta tener notas y todo organizadito; o si eres una empresa y te interesa montar una Wiki muy potente de manera gratuita, aquest és el teu post! Com sabem, vivimos en el siglo de la información, por todos lados, es necesario organizarse, take notas, tener nuestros propios apuntes… I el dit, en las empresas super útil como lugar para FAQ, centro de documentación… tras mucho buscar, la que personalmente destacaba frente al resto es BookStack.

Permetre primer indicar com os lo podéis instal·la i després les damos un passeig i vemos la seva interfaz, ¡qué ganas! ¡es que es una preciosidad! Hay documentación para instalarlo de manera manual, en este caso de manera cómoda con este script, que lo hará todo, en un par de minuts tendremos el sistema montado, con tener una máquina con un Ubuntu 20.04 ready, comencem:

wget https://raw.githubusercontent.com/BookStackApp/devops/master/scripts/installation-ubuntu-20.04.sh
chmod a+x installation-ubuntu-20.04.sh
sudo ./installation-ubuntu-20.04.sh

Ese script instal·lará todo por nosotros, nos despreocuparemos, lo único, preguntarà per el FQDN o el nombre de domini que volem utilitzar com a Wiki:

Introduïu el domini que voleu allotjar BookStack i premeu [ENTER]
Exemples: my-site.com o docs.my-site.com
wiki.openservices.local

¡Y ya está! Una vegada instal·lat entramos en la URL de la nostra màquina, amb els següents credencials predeterminados: ad***@***in.com / password

A partir d'aquest moment, ja es rellenarà tot 😉 Lo dicho, si no importa els veus dando un passeig i els intents explicar la idea de la Wiki. És molt molt senzill. Consta d'Estants o estants que es digues (per a mi) la temàtica/fabricant; i després cada Estant té els seus Llibres; i cada Llibre per a mí normalment és un Producte de cada temàtica/fabricant o similar, ¿si?

En la imagen superior seria el meu exemple, on des d'un mirado inicial pots triar la temàtica i després adentrarte en el seu contenido. Y ya se ve com aprofitat a canviar la temàtica de la Wiki haciéndola super corporativa, ¡tengamos a los jefes contentos!

Per exemple, dentro del Estante 'Monitorización', pues organizado por Libros, uno de ellos Centreon con sus cosas raras dentro, otro para ELK, o los que fueren, ¿a que es bonito, bonito?

Y luego dentro de cada Libro pues tenemos su contenido, que podem organitzarlo por capítulos, páginas… ya dentro como queráis. En mi caso meto pues eso, 'cositas’ de how to's o como hacer, o alguna librada…

Otra cosa impresionante que tiene es el campo de búsqueda superior, està tot indexat i salen els resultats immediatament, ¡qué chulo!

Esta seria la visualización por ejemplo de algún documento que tengamos, i com no, tiene Modo Oscuro y Modo Claro. ¿Qué no es para montarlo ya?

Tenemos un control del versionado para tornar a cualquier momento de cada pàgina, podem exportar el contingut en PDFs entre altres, assignar permisos d'accés si nos interesa… Te indica quién hace qué, últimes modificacions, els més populars, interfície multillenguatge 20 idiomes, gairebé tots (anglès, francès, brasileny, italià, japonès, xinès…)

I si vols veure l'editor, aquí el tens, mira quina cosa més senzilla, està basat en WYSIWYG, tot i que també té un altre tipus Markdown. L'editor ens permet enganxar d'internet qualsevol text amb el seu format i les seves imatges, que en un tres i no res et documentes BÉ tot com necessitis, no hi ha excuses ja. Super senzill, pots posar text en format codi (fins i tot triant el seu llenguatge perquè el pinti més maco), distints ressaltats xulos… a més pots adjuntar si vols fitxers a les pàgines… què més!

I res, us deixo una captura de la seva configuració, dels Ajustos. Perquè vegeu que resultona i senzilla és, podeu canviar el logotip, els colors dels temes, amagar comentaris, tenim una Paperera de reciclatge per recuperar qualsevol cosa eliminada si ho volem, tenim un registre d'auditoria on quedaran registrades totes les accions que es realitzin, podem gestionar usuaris locals o integrar-ho amb un Directori Actiu mitjançant LDAP per a l'autenticació dels usuaris, tenim rols…

Bo, espero que us hagi semblat super interessant, la veritat és que, com veieu, estic completament enamorat d'ell, és molt lleuger, flexible… He tingut molts anys de problemes amb la qüestió de documentar, no trobava cap solució que em permetés accedir al contingut des de qualsevol lloc o tot el que heu anat veient que ofereix. El que s'ha dit, gràcies si doneu a M'agrada a les xarxes socials o a recomanar i tal, i si no també per leer fins aquí.

¡Un abrazo!

Posts recomanats

Autor

nheobug@bujarra.com
Autor del blog Bujarra.com Cualquier necesidad que tengas, no dubtis a contactar amb mi, us intentareu ajudar sempre que pugui, compartir és viure ;) . Gaudir dels documents!!!