[cfinck] 27816: Add a documentation, which describes the changes that need to be done to update the ReactOS Wiki. This should make it easier for the future.

Author: cfinck
Date: Thu Jul 26 01:59:14 2007
New Revision: 27816

URL: http://svn.reactos.org/svn/reactos?rev=27816&view=rev
Log:
Add a documentation, which describes the changes that need to be done to update the
ReactOS Wiki.
This should make it easier for the future.

Added:
    trunk/documentation/web/
    trunk/documentation/web/wiki/
    trunk/documentation/web/wiki/ReactOS Wiki-Update.rtf

Added: trunk/documentation/web/wiki/ReactOS Wiki-Update.rtf
URL:
http://svn.reactos.org/svn/reactos/trunk/documentation/web/wiki/ReactOS%20W…
==============================================================================
--- trunk/documentation/web/wiki/ReactOS Wiki-Update.rtf (added)
+++ trunk/documentation/web/wiki/ReactOS Wiki-Update.rtf Thu Jul 26 01:59:14 2007
@@ -1,0 +1,71 @@
+{\rtf1\ansi\ansicpg1252\deff0\deftab708{\fonttbl{\f0\fswiss\fprq2\fcharset0
Helvetica;}{\f1\fswiss\fprq2\fcharset0 Arial;}{\f2\fmodern\fprq1\fcharset128
Courier;}{\f3\fnil\fcharset128 StarSymbol;}{\f4\fswiss\fcharset128 Helvetica;}}
+{\stylesheet{ Normal;}{\s1 heading 1;}}
+{\*\generator Msftedit
5.41.15.1507;}\viewkind4\uc1\pard\keepn\s1\sb240\sa60\lang1031\b\f0\fs32 Documentation
about the ReactOS Wiki-Update\par
+\pard\b0\i\fs24 written by Colin Finck (25-07-2007)\par
+\par
+\pard\keepn\sb240\sa120\b\f1\fs28 Introduction\par
+\pard\sa120\b0\i0\f0\fs24 This documentation has been written to describe the Update
process of the ReactOS Wiki (based on the MediaWiki software), so it is easier for the
future.\par
+As an example, I take the Update from our previous MediaWiki 1.7.1 Software to the
current version 1.10.0.\par
+\pard\keepn\sb240\sa120\b\i\f1\fs28 Comparing the ReactOS Wiki to the original
MediaWiki\par
+\pard\sa120\b0\i0\f0\fs24 The ReactOS Wiki was modified in some parts to integrate into
the ReactOS Website Design and to allow an easy login through our Global Login
System.\par
+Also some unneeded and non-working options were removed like changing the account
information on the Wiki Preferences page (this has to be done on the myReactOS page) and
selecting another skin (all skins except "roscms" were removed).\par
+\pard\keepn\sb240\sa120\b\i\f1\fs28 Changes in the files\par
+\pard\sa120\b0\i0\f0\fs24 In both MediaWiki versions, these changes had to be done in the
same files. Let's hope that this also applies to future versions :-)\par
+\pard\keepn\sb240\sa120\b\f1\fs26 Integrating the Wiki into the Global Login System\par
+\pard\sa120\b0\f0 These changes have to be done in the following files:\par
+\fs24\par
+\pard\fi-360\li720\sa120\u9679?\tab\b includes/SpecialUserlogin.php\b0\par
+\pard\li710\sa120 Here we only need the function "wfSpecialUserlogin", so the
first step is to delete everything below this function from the file.\par
+Then remove the lines in the function, which create the MediaWiki Login Form. Replace
them with the following lines:\par
+\pard\li710\fs16\par
+\f2 $target = "/wiki";\par
+roscms_subsys_login('wiki', ROSCMS_LOGIN_REQUIRED, $target);\par
+\par
+/* We should never end up here, but in case we do... */\par
+header("Location: $target");\par
+exit;\par
+\par
+\pard\li710\sa120\f0\fs24 Also you need to add a "\f2\fs16 require_once(
'../roscms/inc/subsys_login.php' );\f0\fs24 " line to the top of the file, so
the Global Login System functions will be available.\par
+This is already everything needed for the Login page.\par
+\par
+\pard\fi-360\li720\sa120\b\f3\fs18\'81\'9c\tab\f0\fs24
includes/SpecialUserlogout.php\par
+\pard\li709\sa120\b0 This file also just requires minor changes.\par
+\pard\li710 Look for a line, which contains the text "\f2\fs16
UserLogoutComplete\f4\fs24 ". The lines after this line are specific to the MediaWiki
Login System, so they have to be removed.\f0\par
+\f4 Replace them with the following line:\f0\par
+\pard\li709\fs16\par
+\pard\li709\sa120\f2 header("Location: /roscms/?page=logout");\par
+\pard\li709\par
+\pard\li709\sa120\f4\fs24 The RosCMS Logout page then does the rest for you.\par
+\pard\sa120\par
+\pard Now the Wiki should already work with our Global Login System. When you use the
MediaWiki Login feature, you will be redirected to the ReactOS Login page. The same
applies to the Logout button.\f0\par
+\par
+\pard\sa120\b\f4\fs26 Integrating the Wiki into the Website Design\par
+\b0\fs24 For this case, I created an own MediaWiki skin based on the MonoBook skin. It is
called "roscms".\par
+\pard You don't need to update the skin every time when you update MediaWiki. In this
case, I updated the skin, because our former skin was still based on the MonoBook skin
from MediaWiki 1.5.x.\f0\par
+\par
+\f4 First add a reference to the "/style.css" file, which contains all the
styles of the ReactOS Website.\f0\par
+\f4 Then remove the MonoBook "portlets" from the original MonoBook skin.
Replace them with links to the main ReactOS pages and individual links to some Wiki pages
like Login, Logout, My page, My contributions, etc. Make sure that these links are placed
before the "globalWrapper" box. Look in the "RosCMS.php" file of the
skin how I did it here.\f0\par
+\f4 Now place a "wikiContent" box around the "globalWrapper" box. In
the "main.css" file of the skin, you have to add "#wikiContent" in
front of some styles, so these styles only apply to the Wiki content and not to the rest
of the web page.\f0\par
+\f4 The "main.css" file also needs to be edited. Especially the positions of
"#content" and "#p-cactions" need to be adjusted, so the Wiki content
is displayed next to the menus.\f0\par
+\f4 Now you can do some additional adjustments. Try the skin on multiple browsers and if
there are problems, change the CSS files appropriately.\f0\par
+\par
+\pard\sa120\b\f4\fs26 Changing the Preferences page\par
+\b0\fs24 The last file changes have to be done in the
"includes/SpecialPreferences.php" page. Here we disable the some functions,
namely changing the E-Mail address, real name, password, signature and the used skin.\par
+\pard Simply put \f2\fs16 /*\f4\fs24  before and \f2\fs16 */\f4\fs24  after the sections,
which add the input fields for these values and also do this for the sections, which set
these values.\f0\par
+\f4 To find out the right sections, it's the best if you compare the current
"SpecialPreferences.php" file with the original MediaWiki 1.10.0
"SpecialPreferences.php" file.\f0\par
+\par
+\pard\keepn\sb240\sa120\b\i\f4\fs28 Final fine-tuning\f1\par
+\pard\sa120\b0\i0\f4\fs24 Finally, you can remove some files, which are not needed
now.\f0\par
+\f4 These files include the other skins and some directories, which are not required for
MediaWiki to work (like the "tests" directory).\f0\par
+\pard\keepn\sb240\sa120\b\i\f4\fs28 Changes in other components\f1\par
+\pard\sa120\b0\i0\f4\fs24 In some cases, you also have to make changes to other
components.\f0\par
+\f4 Some examples:\f0\par
+\par
+\pard\fi-360\li720\sa120\b\f3\fs18\'81\'9c\tab\f4\fs24 MediaWiki's database
layout changed\f0\par
+\pard\li709\sa120\b0\f4 If the database layout of the Wiki changed in some main parts,
the roscms/inc/subsys_wiki.php file probably needs an update to reflect the database
changes.\f0\par
+\pard\sa120\par
+\pard\fi-360\li720\sa120\b\f3\fs18\'81\'9c\tab\f4\fs24 There are login or session
problems\f0\par
+\pard\li709\sa120\b0\f4 In such cases, you often have to change the
roscms/inc/subsys_login.php file.\par
+While updating MediaWiki from version 1.7.1 to 1.10.0, I also had to make changes here as
newer MediaWiki versions require that a session is set up for working properly.\f0\par
+}
+