= UABgrid Documentation =

UABgrid-docs is the project page for UABgrid Documentation.  This is where the infrastructure for [http://docs.uabgrid.uab.edu UABgrid Documentation] is supported and maintained.  The primary component of uabgrid-docs at this time is !MediaWiki.  UABgrid Documentation is deployed on a Debian4 platform with the included !MediaWiki package. At this point, the source components in this project site are mainly used to handle differences and extensions to that base. 

= Authentication and Authorization =

The authn/z modifications for uabgrid-docs mainly consists of a fairly vanilla implementation of the !MediaWiki Shibboleth extension.  Relying mainly on REMOTE_USER to automatically identify users and leaving further attribute-based authorizations to later expansion.

= !MediaWiki Notes =

== !MediaWiki Documentation ==

The best way to find answers in the mediawiki documentation is to use google. I don't find mediawiki.org documentation to have an obvious structure and have trouble looking in the manual pages for answers like, "enabling file uploads".  google searches seem to work best here, and surprisingly, mediawiki pages don't turn out on top. maybe i'm not alone.

= Themes =

The [http://webapp.lab.ac.uab.edu/projects/uabgrid-theme UABgrid theme] needs to be adapted to the !MediaWiki skins infrastructure. See [wiki:UABgridMediaWikiTheme] for further details building and testing a customized !MediaWiki theme for UABgrid.

= Enabling Features =

== File Upload ==

File upload was enabled on UABgrid Docs as described in [http://www.mediawiki.org/wiki/Manual:Configuring_file_uploads MediaWiki instructions].  All requirements were in place except the flag to actually enable updates.  That was changed with: 
{{{
patch --directory /var/lib/mediawiki1.7 LocalSettings.php << EOF
87c87
< \$wgEnableUploads              = false;
---
> \$wgEnableUploads              = true;
EOF
}}}

The max file size was increased in php:
{{{
patch --directory /etc/php5/apache2 --backup php.ini << EOF
440c440
< post_max_size = 8M
---
> post_max_size = 30M
EOF
}}}

The web server was restarted `/etc/init.d/apache2 restart`

The file uploads are now enabled. 

The `$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );`  has been augmented by turning off the strict enforcement of extensions ($wgStrictFileExtensions = false;) in LocalSettings.php.

= UABgrid Docs Theming = 

To better understand the visual configuration options for !MediaWiki so it can be customized to meet the needs of UABgrid and integrate with the general [http://dev.uabgrid.uab.edu/UABgridTheme UABgrid Theme] and increase the visual appeal of http://docs.uabgrid.uab.edu we need to survey others approaches to customizing the !MediaWiki look.

== Links on Customizing Themes ==

 * [http://www.liquidben.com/wiki/index.php?title=Public:MediaWiki_CSS_reference CSS Reference for MonoBook] - this is a CSS reference for the default !MediaWiki theme !MonoBook
 * [http://www.jonobacon.org/?p=566 High-level overview of theme modification] - useful to get a rough idea of the steps involved.
 * [http://meta.wikimedia.org/wiki/Gallery_of_user_styles MediaWiki theme gallery]
 * [http://meta.wikimedia.org/wiki/Gallery_of_user_styles#Bright_and_professional_skin_for_personal_and_corporate_web_applications MediaWiki theme of interest]

== Sites that use !MediaWiki ==

 * http://en.opensuse.org - opensuse is another nice example of a mediawiki based site. it also uses a style that should fit well with the uabgrid basic theme in layout and structure.  interestingly they use [http://www.yaml.de/en/home.html yaml] for their CSS layout.
 * http://beagle-project.org/Main_Page
 * http://www.sciencezero.org/index.php/Main_Page
 * http://www.lugradio.org/live/2006/index.php/Main_Page