[MediaWiki-commits] [Gerrit] Doc updates - change (mediawiki...chameleon)
Foxtrott has uploaded a new change for review. https://gerrit.wikimedia.org/r/168262 Change subject: Doc updates .. Doc updates Change-Id: Ibbe7655a3526d1e00e18e3a9de7185f90b6fd766 --- A docs/installation-troubleshooting.md A docs/installation-windows.md 2 files changed, 42 insertions(+), 0 deletions(-) git pull ssh://gerrit.wikimedia.org:29418/mediawiki/skins/chameleon refs/changes/62/168262/1 diff --git a/docs/installation-troubleshooting.md b/docs/installation-troubleshooting.md new file mode 100644 index 000..21c0171 --- /dev/null +++ b/docs/installation-troubleshooting.md @@ -0,0 +1,11 @@ +== Installation Troubleshooting == + +* To actually activate Chameleon as the default skin of your wiki, include + `$wgDefaultSkin]]='chameleon'` in your `LocalSettings.php` +* It is not necessary to install any dependencies anymore. Composer will take + care of that. +* If instead of a proper installation you end up with a `mediawiki` subdirectory + in the `vendor` directory of your MediaWiki installation directory, + * remove that `mediawiki` subdirectory and all its contents from the `vendor` +directory + * run `composer update` from the MediaWiki installation directory again diff --git a/docs/installation-windows.md b/docs/installation-windows.md new file mode 100644 index 000..1d717e0 --- /dev/null +++ b/docs/installation-windows.md @@ -0,0 +1,31 @@ +## Installation on Windows - Step by Step + +Here is a step by step procedure for Windows: + +1. You first need to install Composer. On Windows just [download the +installer][composer-installer] and run it. +2. Open a Windows Explorer window and navigate to the root folder of +your MediaWiki installation. That's the one with the +`LocalSettings.php` file in it. +3. For MediaWiki 1.22 and 1.23 you need to copy the file +`composer.json.example` to `composer.json`. For this, select +`composer.json.example`, press Ctrl+C, then Ctrl+V and then rename +the new file to `composer.json`. +4. Right-click on the new file and select *Use composer here*. A +command line window will open. +5. On the command line run the command +`composer require mediawiki/chameleon-skin:~1.0` +6. If there were no errors, close the command line window. +7. Open `LocalSettings.php` in an editor capable to do UNIX style line +endings (e.g. [Notepad++][] or [Kate][], but *not* the standard Notepad!) +Include `[[Manual:$wgDefaultSkin|$wgDefaultSkin]]='chameleon';` as +the last line. Save the file and close the editor. +8. Open your wiki in a browser. Chameleon should be installed. +9. If not, force reload the page to +[refresh your browser cache][cache-refresh]. (Press Ctrl+F5 on Firefox, +Ctrl+Shift+F5 on Internet Explorer.) + +[composer-installer]: https://getcomposer.org/Composer-Setup.exe +[Notepad++]: http://notepad-plus-plus.org/ +[Kate]:http://kate-editor.org/ +[cache-refresh]: http://www.refreshyourcache.com/en/home/ \ No newline at end of file -- To view, visit https://gerrit.wikimedia.org/r/168262 To unsubscribe, visit https://gerrit.wikimedia.org/r/settings Gerrit-MessageType: newchange Gerrit-Change-Id: Ibbe7655a3526d1e00e18e3a9de7185f90b6fd766 Gerrit-PatchSet: 1 Gerrit-Project: mediawiki/skins/chameleon Gerrit-Branch: master Gerrit-Owner: Foxtrott s7ep...@gmail.com ___ MediaWiki-commits mailing list MediaWiki-commits@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
[MediaWiki-commits] [Gerrit] Doc updates - change (mediawiki...chameleon)
Foxtrott has submitted this change and it was merged. Change subject: Doc updates .. Doc updates Change-Id: Ibbe7655a3526d1e00e18e3a9de7185f90b6fd766 --- A docs/installation-troubleshooting.md A docs/installation-windows.md 2 files changed, 42 insertions(+), 0 deletions(-) Approvals: Foxtrott: Verified; Looks good to me, approved diff --git a/docs/installation-troubleshooting.md b/docs/installation-troubleshooting.md new file mode 100644 index 000..21c0171 --- /dev/null +++ b/docs/installation-troubleshooting.md @@ -0,0 +1,11 @@ +== Installation Troubleshooting == + +* To actually activate Chameleon as the default skin of your wiki, include + `$wgDefaultSkin]]='chameleon'` in your `LocalSettings.php` +* It is not necessary to install any dependencies anymore. Composer will take + care of that. +* If instead of a proper installation you end up with a `mediawiki` subdirectory + in the `vendor` directory of your MediaWiki installation directory, + * remove that `mediawiki` subdirectory and all its contents from the `vendor` +directory + * run `composer update` from the MediaWiki installation directory again diff --git a/docs/installation-windows.md b/docs/installation-windows.md new file mode 100644 index 000..1d717e0 --- /dev/null +++ b/docs/installation-windows.md @@ -0,0 +1,31 @@ +## Installation on Windows - Step by Step + +Here is a step by step procedure for Windows: + +1. You first need to install Composer. On Windows just [download the +installer][composer-installer] and run it. +2. Open a Windows Explorer window and navigate to the root folder of +your MediaWiki installation. That's the one with the +`LocalSettings.php` file in it. +3. For MediaWiki 1.22 and 1.23 you need to copy the file +`composer.json.example` to `composer.json`. For this, select +`composer.json.example`, press Ctrl+C, then Ctrl+V and then rename +the new file to `composer.json`. +4. Right-click on the new file and select *Use composer here*. A +command line window will open. +5. On the command line run the command +`composer require mediawiki/chameleon-skin:~1.0` +6. If there were no errors, close the command line window. +7. Open `LocalSettings.php` in an editor capable to do UNIX style line +endings (e.g. [Notepad++][] or [Kate][], but *not* the standard Notepad!) +Include `[[Manual:$wgDefaultSkin|$wgDefaultSkin]]='chameleon';` as +the last line. Save the file and close the editor. +8. Open your wiki in a browser. Chameleon should be installed. +9. If not, force reload the page to +[refresh your browser cache][cache-refresh]. (Press Ctrl+F5 on Firefox, +Ctrl+Shift+F5 on Internet Explorer.) + +[composer-installer]: https://getcomposer.org/Composer-Setup.exe +[Notepad++]: http://notepad-plus-plus.org/ +[Kate]:http://kate-editor.org/ +[cache-refresh]: http://www.refreshyourcache.com/en/home/ \ No newline at end of file -- To view, visit https://gerrit.wikimedia.org/r/168262 To unsubscribe, visit https://gerrit.wikimedia.org/r/settings Gerrit-MessageType: merged Gerrit-Change-Id: Ibbe7655a3526d1e00e18e3a9de7185f90b6fd766 Gerrit-PatchSet: 2 Gerrit-Project: mediawiki/skins/chameleon Gerrit-Branch: master Gerrit-Owner: Foxtrott s7ep...@gmail.com Gerrit-Reviewer: Foxtrott s7ep...@gmail.com Gerrit-Reviewer: jenkins-bot ___ MediaWiki-commits mailing list MediaWiki-commits@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits