Wikipedii zná každý, svobodní někteří studenti dokonce wikipedii děkují za její diplom. V tomto článku vám ukážu, jak nainstalovat software wikipedie, mediawiki, na váš server FreeBSD s Apache a MySQL.
V mém případě jsem si nainstaloval naši vlastní mediawiki, abych zdokumentoval svou práci. Když jsem zde začal pracovat, můj tehdejší šéf mi zadal můj první úkol:nainstalovat nějaký server pro nějakou službu a předat mi jeho cheat sheet, jak to udělat. Tento podvodný list byl skutečný list papíru psaný ručně; měl také blok papíru s různými cheatsheety pro různé služby.
Méně než měsíc po tomto prvním úkolu, nespočetných návštěvách u jeho stolu, kde hledali další cheaty a pár nových systémů (které jsem nezdokumentoval, jak to udělat), jsme si oba uvědomili, že potřebujeme lepší systém. Také můj rukopis je velmi špatně čitelný a v budoucnu by s námi mohli začít spolupracovat někteří noví lidé a budeme potřebovat lepší dokumentaci. Proto jsem navrhl nainstalovat mediawiki a můj šéf byl v pořádku.
Předpoklady
Mediawiki může běžet na jakémkoli webovém serveru, který podporuje PHP (tj. Apache, nginx atd.), a ukládat svůj obsah do databáze, kterou může být MySQL (nebo MariaDB), PostgreSQL nebo Sqlite. V případě, že nemáte funkční webový server nebo databázi, můžete se podívat na tento návod:https://unixcop.com/install-lamp-on-freebsd-12-x/
Jsou zapotřebí následující rozšíření PHP:Perl Compatible Regular Expressions (PCRE), session, spl, openssl, json, mbstring, fileinfo a intl.
V případě, že chcete nahrát obrázky (tj. screenshoty, diagramy, fotografie nebo jiné druhy obrázků), budete potřebovat ImageMagick, aby zpracoval miniatury, není to povinné, ale doporučené.
Zkompilujte požadované porty
Ke stažení a instalaci softwaru mediawiki a jeho závislostí použijeme systém portů. Spustit:
$ su -
cd /usr/ports/www/mediawiki135
make config install clean
Zobrazí se následující obrazovka, kde zvolím ImageMagick pro zpracování obrázků a použití MySQL jako databáze:
Postupujte podle pokynů na obrazovce a po skončení se zobrazí obrazovka podobná této:
V případě, že vám chybí nějaký php modul, můžete jej přidat pomocí php73-extensions:
# cd /usr/ports/lang/php73-extensions
# make config install clean
Databáze pro mediawiki
Pokud potřebujete nainstalovat mnoho závislostí jako já, otevřete další konzoli a vytvořte databázi a uživatele databáze, zatímco systém kompiluje věci; pokud ne, počkejte, až bude dokončena hlavní úloha kompilace a instalace.
Vždy je dobré nepoužívat stejného uživatele pro všechno, takže si vytvořte uživatele pro 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)Nyní máme uživatele mysql s názvem mediawiki s heslem wikimedia. Je také dobré zvolit lepší heslo. Nyní vytvořte databázi a udělejte z tohoto uživatele vlastníka:
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)Můžete to udělat s jinými nástroji, jako je PhpMyAdmin, samozřejmě.
Konfigurace Apache
Soubory Mediawiki jsou nainstalovány v /usr/local/www/mediawik i můžete přesunout tento adresář do adresáře apache24/data nebo přidat následující řádky do /usr/local/etc/apache24/httpd.conf :
Alias /mediawiki "/usr/local/www/mediawiki/"
<Directory "/usr/local/www/roundcube/">
AllowOverride All
Require all granted
</Directory>Nastavení mediawiki
Znovu načtěte apache a přejděte pomocí webového prohlížeče na http://your-webserver/mediawiki, v mém případě je adresa URL http://192.168.122.234/mediawiki a postupujte podle pokynů na obrazovce:
Vyberte jazyk, mediawiki se pokusí detekovat jazyk prohlížeče; jelikož jsem rodilý mluvčí španělštiny, volím angličtinu:
Dále instalační program zkontroluje závislosti a prostředí:
Věnujte pozornost varováním a zejména bezpečnostním varováním. V tomto tutoriálu budu ignorovat mezipaměť, ale varování o /usr/local/www/mediawiki/images zranitelném vůči spouštění skriptů opravím přidáním tohoto do 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>Další otázka se týká databáze:
Vyplňte data uživatelem, kterého jsme vytvořili v předchozí sekci:
- Hostitel:místní hostitel (nebo 127.0.0.1, pokud se zobrazí chyba)
- Jméno:mediawiki
- Prefix:volitelné, každý název tabulky bude začínat tímto prefixem
- Uživatelské jméno:mediawiki
- Heslo:wikimedia
Vyplňte tento formulář informacemi o vaší vlastní databázi.
Vyberte název pro svou wiki, já půjdu s „GonzWiki“ a nastavím informace o uživateli a hesle správce. A pro dokončení zvolím možnost „Už se nudím, stačí nainstalovat wiki“.
Instalační program vytvoří databázové tabulky, inicializuje věci a vytvoří vaši hlavní stránku:
Nakonec vám instalační program umožní stáhnout konfigurační soubor, který musíte umístit do adresáře wikimedia /usr/local/www/mediawiki .
Základní formátování wiki
Klikněte na „upravit“ a toto je základní formátování textu:
| Typ | Chcete-li vidět |
| ”kurzíva” | kurzíva |
| “‘tučné“‘ | tučné |
| """kurzíva a tučné""" | kurzíva a tučné písmo |
| =Sekce = ==Podsekce == | čím více „=“ zpívá, tím nižší úroveň sekce |
| Seznamy * položka seznamu */ položka seznamu * položka seznamu | U číslovaných seznamů změňte hvězdičky na znak čísla (#) |
| [[Stránka]] | Interní odkaz na stránku wiki s názvem Stránka |
| [http://some.host/url] | Odkaz na externí web |
V následujících odkazech můžete najít mnohem více informací:
- https://www.mediawiki.org/wiki/Help:Formátování
- https://www.mediawiki.org/wiki/Help:Odkazy
Hodně štěstí při úpravách!