Topic on Project:Village Pump

Installation guide consolidation

Nemo bis (talkcontribs)

Manual:Installation guide has one section with a 400 words summary, but then links to a "Main installation guide" composed of 4+4 more pages. None of these pages is translatable. Can we consolidate truly important information and make it translatable? Currently one is supposed to find the following logical steps.

  1. Download
  2. Requirements
  3. The actual installation
  4. Misc troubleshooting and alternatives if something went wrong
  5. Configuration
  6. Maintenance
  7. Informative material

The pages in bold are part of the official Template:InstallationNav (which complements Template:MediaWiki Introduction): they are supposed to be the official path and need special care and coordination.

Nemo bis (talkcontribs)
MarkAHershberger (talkcontribs)

Thank you for this!

This post was hidden by Clump (history)
Nemo bis (talkcontribs)

I made Manual:LocalSettings.php translatable and expanded Manual:System administration by merging Manual:Configuration.

  • Manual:System administration could be useful if it becomes a reasonable index/step by step guide/tutoring of the really important pages in Category:MediaWiki for site admins (allowing to remove respective information from the general installation manual), but I'm not sure of its current role.
  • Manual:LocalSettings.php is very visited, but it's quite a mess. I doubt it kept anywhere close up to date, is it currently making a good service to users?
Ciencia Al Poder (talkcontribs)

I wonder what's the purpose of making Manual:LocalSettings.php translatable if you doubt about the usefulness of that page or if you plan/propose to improve/restructure it.

Nemo bis (talkcontribs)

The page is vastly correct and the strings contained in it look rather stable, so it's ok to translate it. It is my impression that some consolidation will be needed for that page (reducing total amount of text around), but not a rewriting.

Nemo bis (talkcontribs)

I've tried to make the essential stuff transcludable, and I've trimmed some more pages.

IMHO the direction is rather clear:

  • always defer to other sites for guides on how to set up PHP etc.;
  • keep all the steps internal to MediaWiki (like installer, config script, LocalSettings.php) in their own, shared manual pages;
  • in all the setup-specific pages, just transclude the former and maintain only:
    • information on packages available and how to use them (debatable, should be on their sites whenever possibles),
    • OS-specific instructions which can't be found anywhere else, like specific paths to put in MediaWiki config or RAM/suhosin requirements and the like. (talkcontribs)

Please, can someone give consideration to Raspberry PI 3, Raspbian GNU/Linux 9, LAMP. Where due to some GNU license issue, mySQL redirects to MariaDB. Need to know how to get superuser on phpMyAdmin (the commands given are for mySQL, and are not the right format for MariaDB. There is no password for root initially for MariaDB, but no direct relationship (it seems) between MariaDB and phpMyAdmin. Might be proven wrong here once I start creating databases in MariaDB.

However this really good documentation, it just doesn't go far enough. Thanks.

Ciencia Al Poder (talkcontribs)

Looks like your question is about MariaDB/phpMyadmin, not MediaWiki. Have you tried asking on a mariaDB forum or stackoverflow?

Mitra.ardron (talkcontribs)

I've added a solution to MariaDB password problem - which hit me as well on Raspbian (talkcontribs)

Install to the correct directory to avoid SELinux issues. Placing the content under /var/www/html (or /opt/rh/httpd24/root/var/www/html/ for httpd24) instead of just /var/www will automatically provide the correct SELinux context.

Do not forget to change the owner and group of the content tree with 'chown -R apache: mediawiki/'

Reply to "Installation guide consolidation"