Tutti conoscono wikipedia, il gratuito alcuni studenti anche ringrazia wikipedia per la sua laurea. In questo articolo ti mostrerò come installare il software wikipedia, mediawiki, sul tuo server FreeBSD con Apache e MySQL.
Nel mio caso, ho installato il nostro mediawiki per documentare il mio lavoro. Quando ho iniziato a lavorare qui, il mio capo di allora mi ha dato il mio primo compito:installare un server per qualche servizio e passarmi il suo cheat sheet su come farlo. Questo cheat sheet era un vero foglio di carta scritto a mano; aveva anche un blocco di carta con diversi cheatsheet per diversi servizi.
Meno di un mese dopo quel primo compito, innumerevoli visite alla sua scrivania alla ricerca di altri cheat sheet e un paio di nuovi sistemi (di cui non ho documentato come farlo), entrambi ci siamo resi conto che abbiamo bisogno di un sistema migliore. Inoltre la mia calligrafia è molto difficile da leggere e in futuro alcune nuove persone potrebbero iniziare a lavorare con noi e avremo bisogno di una migliore documentazione. Ecco perché ho suggerito di installare mediawiki e il mio capo era ok.
Prerequisiti
Mediawiki può essere eseguito su qualsiasi server web che supporti PHP (ad esempio apache, nginx, ecc.) e memorizzarne il contenuto in un database che può essere MySQL (o MariaDB), PostgreSQL o Sqlite. Nel caso in cui non disponi di un server web o di un database funzionante, puoi controllare questo tutorial:https://unixcop.com/install-lamp-on-freebsd-12-x/
Sono necessarie le seguenti estensioni PHP:Perl Compatible Regular Expressions (PCRE), session, spl, openssl, json, mbstring, fileinfo e intl.
Nel caso in cui desideri caricare immagini (ad esempio schermate, diagrammi, foto o altri tipi di immagini) avrai bisogno di ImageMagick per gestire le miniature, non è obbligatorio ma consigliato.
Compila le porte richieste
Useremo il sistema delle porte per scaricare e installare il software mediawiki e le sue dipendenze. Corri:
$ su -
cd /usr/ports/www/mediawiki135
make config install clean
Apparirà la seguente schermata, in cui scelgo ImageMagick per gestire le immagini e utilizzare MySQL come database:
Segui le istruzioni sullo schermo e al termine vedrai una schermata come questa:
Nel caso in cui manchi qualche modulo php, puoi aggiungere con le estensioni php73:
# cd /usr/ports/lang/php73-extensions
# make config install clean
Banca dati per mediawiki
Se hai molte dipendenze da installare come me, apri un'altra console e crea il database e l'utente del database mentre il sistema sta compilando le cose; in caso contrario, aspetta solo che il lavoro di compilazione e installazione principale sia terminato.
È sempre una buona idea non utilizzare lo stesso utente per tutto, quindi crea un utente per 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)Ora abbiamo un utente mysql chiamato mediawiki con password wikimedia. È anche una buona idea scegliere una password migliore. Ora creiamo un database e rendiamo quell'utente il proprietario:
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)Puoi farlo con altri strumenti come PhpMyAdmin ovviamente.
Configurazione di Apache
I file Mediawiki vengono installati in /usr/local/www/mediawik posso spostare quella directory all'interno della directory apache24/data o aggiungere le seguenti righe a /usr/local/etc/apache24/httpd.conf :
Alias /mediawiki "/usr/local/www/mediawiki/"
<Directory "/usr/local/www/roundcube/">
AllowOverride All
Require all granted
</Directory>Imposta mediawiki
Ricarica Apache e vai con il tuo browser web su http://your-webserver/mediawiki, nel mio caso l'url è http://192.168.122.234/mediawiki e segui le istruzioni sullo schermo:
Scegli la lingua, mediawiki proverà a rilevare la lingua del browser; essendo madrelingua spagnola, scelgo l'inglese:
Successivamente, il programma di installazione verificherà le dipendenze e l'ambiente:
Prestare attenzione agli avvisi e in particolare agli avvisi di sicurezza. Per questo tutorial, ignorerò quello della cache, ma l'avviso su /usr/local/www/mediawiki/images vulnerabile all'esecuzione di script correggerò aggiungendolo 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 prossima domanda riguarda il database:
Completa i dati con l'utente che abbiamo creato nella sezione precedente:
- Host:localhost (o 127.0.0.1 se ricevi un errore)
- Nome:mediawiki
- Prefisso:opzionale, ogni nome di tabella inizierà con questo prefisso
- Nome utente:mediawiki
- Password:wikimedia
Compila questo modulo con le informazioni del tuo database.
Scegli un nome per la tua wiki, andrò con "GonzWiki" e imposterò le informazioni sull'utente e la password dell'amministratore. E sceglierò l'opzione "Sono già annoiato, installa il wiki" per finire.
Il programma di installazione creerà le tabelle del database, inizializzerà le cose e creerà la tua pagina principale:
Infine, il programma di installazione ti consentirà di scaricare il file di configurazione che devi inserire nella tua directory wikimedia /usr/local/www/mediawiki .
Formattazione wiki di base
Clicca su “modifica” e questa è la formattazione di base del testo:
| Tipo | Per vedere |
| "corsivo" | corsivo |
| "'grassetto'' | grassetto |
| ””’corsivo e grassetto””’ | corsivo e grassetto |
| =Sezione = ==Sottosezione == | più '=' canta, il livello di sezione inferiore |
| Elenchi * voce di elenco */ voce dell'elenco * voce di elenco | Cambia gli asterischi con il segno numerico (#) per gli elenchi numerati |
| [[Pagina]] | Link interno alla pagina wiki denominata Pagina |
| [http://some.host/url] | Collegamento a un sito esterno |
Nei seguenti link puoi trovare molte più informazioni:
- https://www.mediawiki.org/wiki/Help:Formattazione
- https://www.mediawiki.org/wiki/Help:Link
Buona modifica!