Wiki Admin: Difference between revisions

From Minetest
m (Poetry moved page Wiki Setup to Wiki Admin)
No edit summary
Line 22: Line 22:
----
----


This subject area (Wiki Setup):
This subject area (Wiki Admin):


<div class="p44_navbar">
<div class="p44_navbar">
[[Wiki_Setup|This page]]
[[Wiki_Admin|This page]]
[[Wiki_Backup|Back-up wiki]]
[[Wiki_Backup|Back-up wiki]]
[[Wiki_Images|Wiki images]]
[[Wiki_Images|Wiki images]]
Line 47: Line 47:


This page discusses setup and maintenance issues related to this MediaWiki. It doesn't include instructions to install from scratch yet.
This page discusses setup and maintenance issues related to this MediaWiki. It doesn't include instructions to install from scratch yet.
For common operations, see the links further up.


<span id="wiki-mid-2023"></span>
<span id="wiki-mid-2023"></span>

Revision as of 23:53, 3 September 2023



This subject area (Wiki Admin):

Note: If you edit the CSS code, you and other visitors will need to clear browser cache before the changes will be visible.


Introduction

This page discusses setup and maintenance issues related to this MediaWiki. It doesn't include instructions to install from scratch yet.

For common operations, see the links further up.

Changes relative to base

The mid-2023 iteration of this wiki was based initially on MediaWiki 1.38.7. The distribution tarball used, which may no longer exist at the original link, was:

https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.7.tar.gz

As of early September 2023, three files in the Timeless skin code had been modified. Those changes are described at this link.

No other changes to existing files had been made.

A number of new files had been added. The additions may be summarized as follows:

  • LocalSettings.php
  • a site logo image
  • a site wordmark image
  • images imported using a maintenance script
  • a subdirectory "admin/" for admin notes and files
  • a subdirectory "misc/" for misc. public files

Some configuration pages had been modified [in the GUI and MariaDB database] as well. Partial list for that:

  • Skins CSS pages
  • Sidebar

Key settings in LocalSettings.php 

This is a partial list of site-specific settings that were used in "LocalSettings.php" as of September 2023:

 $wgSitename    = "Minetest";
 $wgServer      = "https://wiki.minetest.org";
 $wgEnableEmail = false;
 
 $wgLogos = [
     '1x'       => "fmlogo.png" ,
     'icon'     => "fmlogo.png" ,
     'wordmark' => [
         'src' => 'fmwordmark-text.png' ,
         'alt' => 'Final Minetest wordmark' ,
     ] ,
 ];
 
 $wgDBtype     = "mysql";
 $wgDBserver   = "localhost";
 $wgDBname     = "mediawiki";
 $wgDBuser     = "mediawiki";
 $wgDBpassword = "(a password)";
 $wgDBprefix   = "mw_";
 
 $wgEnableUploads = false;
 $wgPingback      = false;
 $wgLocaltimezone = "America/Los_Angeles";
 $wgDefaultSkin   = "timeless";
 
 wfLoadSkin( 'MonoBook' );
 wfLoadSkin( 'Timeless' );
 wfLoadSkin( 'Vector'   );
 
 wfLoadExtension( 'WikiEditor'  );
 wfLoadExtension( 'Cite'        );
 wfLoadExtension( 'Scribunto'   );
 
 wfLoadExtension( 'ParserFunctions'       );
 wfLoadExtension( 'SyntaxHighlight_GeSHi' );

Note: The 'alt' feature used above depended on the patches at this link.

How one update was done 

The wiki was updated from 1.38.7 to 1.39.4 in early September 2023. The distribution tarball used, which may no longer exist at the original link, was:

https://releases.wikimedia.org/mediawiki/1.39/mediawiki-1.39.4.tar.gz

The following procedure was used:

1. Back-up the MS-SQL database. Important: This step is essential because MediaWiki updates are one-way in this context.

2. Execute commands similar to the following with paths modified appropriately:

 rm -fr                     mediawiki-1.39.4
 tar zxf         /somewhere/mediawiki-1.39.4.tar.gz
 chown -R www-data.www-data mediawiki-1.39.4
 cd                         mediawiki-1.39.4
 
 rm -fr images # Empty except for a README
 cp -a /somewhere/oldwiki/LocalSettings.php   .
 cp -a /somewhere/oldwiki/{admin,misc,images} .
 cp -a /somewhere/oldwiki/*.png .

3. Move the old wiki tree out of the way, move the new wiki tree to the appropriate pathname, go to the top directory of the new wiki tree after moving it, and execute:

 cd maintenance
 php update.php

4. Apply the patches at this link.

5. Clear your browser cache.

6. If you'd added any extensions to the old wiki, at this point, you'd install updated copies.

Issues with MediaWiki 1.40.X  

If this MediaWiki hasn't already been updated to the 1.40.X series, be aware of the following issues with that series:

1. An "nginx" config change may be needed. Specifically, the following line should be added, if it isn't already present, to the appropriate "server { ... }" block in the appropriate domain configuration file:

add_header X-Content-Type-Options nosniff;

Note: This change has already been made on the web server used but may need to be re-made if things change.

2. Minimum password length has been increased.

3. Maintenance scripts should now be executed using commands of the form "php run.php update" as opposed to "php update.php".