Foxtrott has submitted this change and it was merged. Change subject: Add detailed installation instructions for Linux ......................................................................
Add detailed installation instructions for Linux Change-Id: I1dc04d7ca24f3ccfc642eb33bc0c731d9d416b01 --- A docs/installation-unix.md M docs/installation.md 2 files changed, 43 insertions(+), 8 deletions(-) Approvals: Foxtrott: Verified; Looks good to me, approved diff --git a/docs/installation-unix.md b/docs/installation-unix.md new file mode 100644 index 0000000..c3b583d --- /dev/null +++ b/docs/installation-unix.md @@ -0,0 +1,29 @@ +## Installation on Linux - Step by Step + +Here is a step by step procedure for Linux, that should work for other unixy +operating systems as well: + +1. Open a command line window (Konsole, XTerm) and navigate to the root folder + of your MediaWiki installation. That's the one with the `LocalSettings.php` + file in it. +2. [Install Composer][]: + + ``` sh + curl -sS https://getcomposer.org/installer | php + sudo mv composer.phar /usr/local/bin/composer + ``` + +3. For MediaWiki 1.23.5 you need to copy the file `composer.json.example` to + `composer.json`. For this, run `cp composer.json.example composer.json`. +4. To actually install Chameleon run the command + `composer require "mediawiki/chameleon-skin:~1.0"` +5. If there were no errors, close the command line window. +6. Open `LocalSettings.php` in an editor (e.g. Kate). Include + `$wgDefaultSkin='chameleon';` as the last line. Save the file and close the + editor. +7. Open your wiki in a browser. Chameleon should be installed. +8. If not, force reload the page to [refresh your browser cache][cache-refresh]. + (On Firefox or Chrome press Ctrl+F5) + +[Install Composer]: https://getcomposer.org/doc/00-intro.md#installation-nix +[cache-refresh]: http://www.refreshyourcache.com/en/home/ diff --git a/docs/installation.md b/docs/installation.md index e6d7e07..636f7cf 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -10,16 +10,23 @@ ### Installation -1. Go to your MediaWiki installation directory -2. If necessary (on MediaWiki up to 1.23) copy the file `composer.json.example` to `composer.json` -3. With Composer installed, run `composer require "mediawiki/chameleon-skin:~1.0"` -4. __Done:__ Navigate to _Special:Version_ on your wiki to verify that the skin is successfully installed. +If unsure try the detailed installation instructions for +[Windows](installation-windows.md) or [Linux](installation-linux.md). + +Here is the short version: + +1. On a command line go to your MediaWiki installation directory +2. If necessary (on MediaWiki up to 1.23) copy the file `composer.json.example` + to `composer.json` +3. With Composer installed, run + `composer require "mediawiki/chameleon-skin:~1.0"` +4. To set Chameleon as the default skin, open `LocalSettings.php` in an editor, + find `$wgDefaultSkin` and amend it: `$wgDefaultSkin='chameleon';` +5. __Done:__ Navigate to _Special:Version_ on your wiki to verify that the skin + is successfully installed. If you run into problems, try the [troubleshooting](installation-troubleshooting.md). - -There is also a longer, step-by-step instruction available for [installation on -Windows](installation-windows.md). ### Update @@ -39,6 +46,5 @@ From your MediaWiki installation directory run `composer remove "mediawiki/chameleon-skin"` - [composer]: https://getcomposer.org/ -- To view, visit https://gerrit.wikimedia.org/r/172048 To unsubscribe, visit https://gerrit.wikimedia.org/r/settings Gerrit-MessageType: merged Gerrit-Change-Id: I1dc04d7ca24f3ccfc642eb33bc0c731d9d416b01 Gerrit-PatchSet: 2 Gerrit-Project: mediawiki/skins/chameleon Gerrit-Branch: master Gerrit-Owner: Foxtrott <[email protected]> Gerrit-Reviewer: Foxtrott <[email protected]> Gerrit-Reviewer: jenkins-bot <> _______________________________________________ MediaWiki-commits mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
