Todo el mundo conoce wikipedia, algunos estudiantes incluso agradecen a wikipedia por su título. En este artículo, le mostraré cómo instalar el software de wikipedia, mediawiki, en su servidor FreeBSD con Apache y MySQL.
En mi caso, instalé nuestro propio mediawiki para documentar mi trabajo. Cuando comencé a trabajar aquí, mi entonces jefe me dio mi primera tarea:instalar algún servidor para algún servicio y me entregó su hoja de trucos sobre cómo hacerlo. Esta hoja de trucos era una hoja de papel real escrita a mano; también tenía un bloque de papel con diferentes hojas de trucos para diferentes servicios.
Menos de un mes después de esa primera tarea, innumerables visitas a su escritorio en busca de otras hojas de trucos y un par de sistemas nuevos (que no documenté cómo hacerlo), ambos nos dimos cuenta de que necesitábamos un sistema mejor. Además, mi letra es muy difícil de leer y, en el futuro, algunas personas nuevas podrían comenzar a trabajar con nosotros y necesitaremos una mejor documentación. Por eso sugerí instalar mediawiki y mi jefe estuvo de acuerdo.
Requisitos
Mediawiki puede ejecutarse en cualquier servidor web que admita PHP (es decir, apache, nginx, etc.) y almacenar su contenido en una base de datos que puede ser MySQL (o MariaDB), PostgreSQL o Sqlite. En caso de que no tenga un servidor web o una base de datos en funcionamiento, puede consultar este tutorial:https://unixcop.com/install-lamp-on-freebsd-12-x/
Se necesitan las siguientes extensiones de PHP:Expresiones regulares compatibles con Perl (PCRE), session, spl, openssl, json, mbstring, fileinfo e intl.
En caso de que desee cargar imágenes (es decir, capturas de pantalla, diagramas, fotos u otro tipo de imágenes), necesitará ImageMagick para manejar las miniaturas, no es obligatorio, pero se recomienda.
Compila los puertos requeridos
Usaremos el sistema de puertos para descargar e instalar el software mediawiki y sus dependencias. Ejecutar:
$ su -
cd /usr/ports/www/mediawiki135
make config install clean
Aparecerá la siguiente pantalla, donde elijo ImageMagick para manejar imágenes y usar MySQL como base de datos:
Siga las instrucciones en pantalla y cuando termine, verá una pantalla como esta:
En caso de que le falte algún módulo php, puede agregarlo con las extensiones php73:
# cd /usr/ports/lang/php73-extensions
# make config install clean
Base de datos para mediawiki
Si tiene muchas dependencias para instalar como yo, abra otra consola y cree la base de datos y el usuario de la base de datos mientras el sistema está compilando cosas; si no, simplemente espere hasta que termine el trabajo principal de compilación e instalación.
Siempre es una buena idea no usar el mismo usuario para todo, así que crea un usuario para mediawiki:
# mysql -p
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 3
Server version: 10.5.10-MariaDB FreeBSD Ports
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
root@localhost [(none)]> CREATE USER 'mediawiki'@'localhost' IDENTIFIED BY 'wikimedia';
Query OK, 0 rows affected (0.003 sec)Ahora tenemos un usuario mysql llamado mediawiki con contraseña wikimedia. También es una buena idea elegir una mejor contraseña. Ahora vamos a crear una base de datos y hacer que ese usuario sea el propietario:
root@localhost [(none)]> CREATE DATABASE mediawiki;
Query OK, 1 row affected (0.001 sec)
root@localhost [(none)]> GRANT ALL PRIVILEGES ON mediawiki.* TO 'mediawiki'@'localhost';
Query OK, 0 rows affected (0.003 sec)Por supuesto, puede hacer esto con otras herramientas como PhpMyAdmin.
Configuración de Apache
Los archivos de Mediawiki se instalan en /usr/local/www/mediawik i puede mover ese directorio dentro del directorio apache24/data o agregar las siguientes líneas a /usr/local/etc/apache24/httpd.conf :
Alias /mediawiki "/usr/local/www/mediawiki/"
<Directory "/usr/local/www/roundcube/">
AllowOverride All
Require all granted
</Directory>Configurar mediawiki
Vuelva a cargar apache y vaya con su navegador web a http://your-webserver/mediawiki, en mi caso la url es http://192.168.122.234/mediawiki y siga las instrucciones en pantalla:
Elija el idioma, mediawiki intentará detectar el idioma del navegador; como soy hablante nativo de español, elijo inglés:
A continuación, el instalador comprobará las dependencias y el entorno:
Preste atención a las advertencias y, en particular, a las advertencias de seguridad. Para este tutorial, ignoraré el de caché, pero corregiré la advertencia sobre /usr/local/www/mediawiki/images vulnerable a la ejecución de scripts agregando esto a httpd.conf:
<Directory "/usr/local/www/mediwWiki/images">
AllowOverride None
# Serve HTML as plaintext, don't execute SHTML
AddType text/plain .html .htm .shtml .phtml
# Don't run arbitrary PHP code.
php_admin_flag engine off
</Directory>La siguiente pregunta es sobre la base de datos:
Rellena los datos con el usuario que hemos creado en el apartado anterior:
- Host:localhost (o 127.0.0.1 si recibe un error)
- Nombre:mediawiki
- Prefijo:opcional, cada nombre de tabla comenzará con este prefijo
- Nombre de usuario:mediawiki
- Contraseña:wikimedia
Complete este formulario con la información de su propia base de datos.
Elija un nombre para su wiki, iré con "GonzWiki" y configuraré la información de usuario y contraseña del administrador. Y elegiré la opción “Ya estoy aburrido, solo instala el wiki” para terminar.
El instalador creará las tablas de la base de datos, inicializará las cosas y creará su página principal:
Finalmente, el instalador te permitirá descargar el archivo de configuración que necesitas poner en tu directorio wikimedia /usr/local/www/mediawiki .
Formato básico de wiki
Haga clic en "editar" y este es el formato de texto básico:
| Tipo | Para ver |
| ”cursiva” | cursiva |
| ”’negrita”’ | negrita |
| ””’cursiva y negrita””’ | cursiva y negrita |
| =Sección = ==Subsección == | cuanto más canta ‘=’, menor nivel de sección |
| Listas * elemento de la lista */ elemento de la lista * elemento de la lista | Cambiar asteriscos con signo de número (#) para listas numeradas |
| [[Página]] | Enlace interno a la página wiki llamada Página |
| [http://algún.host/url] | Enlace a sitio externo |