Merge branch 'wiki-install-pi'

Guides/wiki.md

@@ -0,0 +1,134 @@
+# Media Wiki
+
+[Debian / Ubuntu packages](https://www.mediawiki.org/wiki/Manual:Running_MediaWiki_on_Debian_or_Ubuntu)
+[Download and install](https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki)
+[UI config with browser](https://www.mediawiki.org/wiki/Manual:Config_script)
+[LocalSettings.php guide](https://www.mediawiki.org/wiki/Manual:LocalSettings.php)
+
+## Config
+
+### Tweak MediaWiki
+
+File at `/var/lib/mediawiki/LocalSettings.php`
+
+### Look at postgresql tables
+
+When logged as *wiki_app*, use command `\\dt mediawiki.*`
+
+## Warning
+
+Do not use wiki in url filepath.
+
+## Install Media Wiki
+
+### PostgreSQL
+
+Install profile, used during the installation phase :
+```
+CREATE USER install WITH SUPERUSER PASSWORD '1eh87x2_tt';
+```
+
+Wiki profile :
+
+```
+sudo -u postgres psql
+
+CREATE USER wiki_app WITH NOCREATEDB NOCREATEROLE NOSUPERUSER ENCRYPTED PASSWORD '52w7maa';
+
+CREATE DATABASE wiki_db WITH OWNER wiki_app;
+```
+
+### GNU/Linux packages
+
+Minimal :
+```
+sudo apt install apache2 php libapache2-mod-php php-xml php-mbstring
+```
+
+Optimal :
+```
+sudo apt install php-apcu php-intl php-gd php-cli php-curl
+```
+
+If php-apcu :
+`sudo service apache2 reload`
+
+
+### Download
+
+```
+cd /tmp/
+
+wget https://releases.wikimedia.org/mediawiki/1.33/mediawiki-1.33.0.tar.gz
+
+tar -xvzf /tmp/mediawiki-1.33.0.tar.gz
+
+sudo mkdir /var/www/mediawiki
+
+sudo mv mediawiki-*/* /var/www/mediawiki
+
+sudo chown -R www-data:www-data /var/www/mediawiki
+
+```
+
+### Cli config
+
+This config is very difficult to handle. It is much easier to use the configuration with browser.
+
+```
+php maintenance/install.php
+```
+
+### Configuration with browser
+
+Make the folder `/var/www/mediawiki` served by _httpd_.
+
+Then open the url : `http://domain.com/mw-config`
+
+At the end, you have to download the `LocalConfig.php` file.
+
+Put it in the folder `/var/www/mediawiki`.
+
+BEWARE : if you have enabled the accelerated cache, you have to add this line to the `LocalConfig.php` file :
+
+```
+$wgSessionCacheType = CACHE_DB;
+```
+
+Note : if you don't, the wiki can work but it would be impossible to log in or to create any account.
+
+### Apache HTTPS
+
+_todo_
+
+### Optional : configure PHP
+
+_todo_
+
+## Uninstall Mediawiki
+
+### Disable site
+
+Required to disable database connection :
+
+```
+sudo a2dissite 'wiki.*'
+
+sudo service apache2 reload
+```
+
+### Drop postgreSQL stuff
+
+As _postgres_ user :
+
+```
+DROP DATABASE wiki_db ;
+
+DROP ROLE wiki_app ;
+```
+
+### Delete web server files
+
+```
+sudo rm -r /var/www/mediawiki
+```

Install/Templates/mediawiki/LocalSettings.php

@@ -0,0 +1,154 @@
+<?php
+# This file was automatically generated by the MediaWiki 1.33.0
+# installer. If you make manual changes, please keep track in case you
+# need to recreate them later.
+#
+# See includes/DefaultSettings.php for all configurable settings
+# and their default values, but don't forget to make changes in _this_
+# file, not there.
+#
+# Further documentation for configuration settings may be found at:
+# https://www.mediawiki.org/wiki/Manual:Configuration_settings
+
+# Protect against web entry
+if ( !defined( 'MEDIAWIKI' ) ) {
+	exit;
+}
+
+
+## Uncomment this to disable output compression
+# $wgDisableOutputCompression = true;
+
+$wgSitename = "Asset Bot";
+$wgMetaNamespace = "Ab";
+
+## The URL base path to the directory containing the wiki;
+## defaults for all runtime URL paths are based off of this.
+## For more information on customizing the URLs
+## (like /w/index.php/Page_title to /wiki/Page_title) please see:
+## https://www.mediawiki.org/wiki/Manual:Short_URL
+$wgScriptPath = "";
+
+## The protocol and server name to use in fully-qualified URLs
+$wgServer = "https://wiki.jovian-hersemeule.eu";
+
+## The URL path to static resources (images, scripts, etc.)
+$wgResourceBasePath = $wgScriptPath;
+
+## The URL path to the logo.  Make sure you change this from the default,
+## or else you'll overwrite your logo when you upgrade!
+$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png";
+
+## UPO means: this is also a user preference option
+
+$wgEnableEmail = false;
+$wgEnableUserEmail = true; # UPO
+
+$wgEmergencyContact = "apache@wiki.jovian-hersemeule.eu";
+$wgPasswordSender = "apache@wiki.jovian-hersemeule.eu";
+
+$wgEnotifUserTalk = false; # UPO
+$wgEnotifWatchlist = false; # UPO
+$wgEmailAuthentication = true;
+
+## Database settings
+$wgDBtype = "postgres";
+$wgDBserver = "localhost";
+$wgDBname = "wiki_db";
+$wgDBuser = "wiki_app";
+$wgDBpassword = "52w7maa";
+
+# Postgres specific settings
+$wgDBport = "5432";
+$wgDBmwschema = "assetbot";
+
+## Shared memory settings
+$wgMainCacheType = CACHE_ACCEL;
+$wgMemCachedServers = [];
+
+## To enable image uploads, make sure the 'images' directory
+## is writable, then set this to true:
+$wgEnableUploads = true;
+#$wgUseImageMagick = true;
+#$wgImageMagickConvertCommand = "/usr/bin/convert";
+
+# InstantCommons allows wiki to use images from https://commons.wikimedia.org
+$wgUseInstantCommons = false;
+
+# Periodically send a pingback to https://www.mediawiki.org/ with basic data
+# about this MediaWiki instance. The Wikimedia Foundation shares this data
+# with MediaWiki developers to help guide future development efforts.
+$wgPingback = true;
+
+## If you use ImageMagick (or any other shell command) on a
+## Linux server, this will need to be set to the name of an
+## available UTF-8 locale
+$wgShellLocale = "C.UTF-8";
+
+## Set $wgCacheDirectory to a writable directory on the web server
+## to make your wiki go slightly faster. The directory should not
+## be publicly accessible from the web.
+#$wgCacheDirectory = "$IP/cache";
+
+# Site language code, should be one of the list in ./languages/data/Names.php
+$wgLanguageCode = "en";
+
+$wgSecretKey = "68a7abfecbaa6c5f05b00188a21a5e2f969e4ba07a817a6e251ebeacd12fbfd9";
+
+# Changing this will log out all existing sessions.
+$wgAuthenticationTokenVersion = "1";
+
+# Site upgrade key. Must be set to a string (default provided) to turn on the
+# web installer while LocalSettings.php is in place
+$wgUpgradeKey = "bb32c88168ddd07e";
+
+## For attaching licensing metadata to pages, and displaying an
+## appropriate copyright notice / icon. GNU Free Documentation
+## License and Creative Commons licenses are supported so far.
+$wgRightsPage = ""; # Set to the title of a wiki page that describes your license/copyright
+$wgRightsUrl = "";
+$wgRightsText = "";
+$wgRightsIcon = "";
+
+# Path to the GNU diff3 utility. Used for conflict resolution.
+$wgDiff3 = "/usr/bin/diff3";
+
+# The following permissions were set based on your choice in the installer
+$wgGroupPermissions['*']['createaccount'] = false;
+$wgGroupPermissions['*']['edit'] = false;
+$wgGroupPermissions['*']['read'] = false;
+
+## Default skin: you can change the default skin. Use the internal symbolic
+## names, ie 'vector', 'monobook':
+$wgDefaultSkin = "timeless";
+
+# Enabled skins.
+# The following skins were automatically enabled:
+wfLoadSkin( 'MonoBook' );
+wfLoadSkin( 'Timeless' );
+wfLoadSkin( 'Vector' );
+
+
+# Enabled extensions. Most of the extensions are enabled by adding
+# wfLoadExtensions('ExtensionName');
+# to LocalSettings.php. Check specific extension documentation for more details.
+# The following extensions were automatically enabled:
+wfLoadExtension( 'CategoryTree' );
+wfLoadExtension( 'Cite' );
+wfLoadExtension( 'CodeEditor' );
+wfLoadExtension( 'Gadgets' );
+wfLoadExtension( 'ImageMap' );
+wfLoadExtension( 'InputBox' );
+wfLoadExtension( 'MultimediaViewer' );
+wfLoadExtension( 'PdfHandler' );
+wfLoadExtension( 'WikiEditor' );
+
+
+# End of automatically generated settings.
+# Add more configuration options below.
+
+# Fix login error
+$wgSessionCacheType = CACHE_DB;
+
+# Add file extensions
+$wgFileExtensions = array('ppt', 'pptx', 'pdf', 'doc', 'docx', 'odt', 'odp', 'xml', 'json');