Maemo.org team/Updating maemo.org sites

(Updating maemo.org specific styles)
(wiki.maemo.org)
Line 55: Line 55:
{{Server admins| maintenance.maemo.org | Niels, Ferenc, Daniel}}
{{Server admins| maintenance.maemo.org | Niels, Ferenc, Daniel}}
-
[http://wiki.maemo.org The Maemo Wiki] is a standard [http://www.mediawiki.org MediaWiki] installation on ''name of server''. The stylesheets used for the wiki are taken directly from ''static.maemo.org'', and are the same as those used for [http://maemo.org]. The following custom extensions are installed and deployed on the Maemo wiki:
+
[http://wiki.maemo.org The Maemo Wiki] is a standard [http://www.mediawiki.org MediaWiki] installation on ''wiki.maemo.org''. The stylesheets used for the wiki are taken directly from ''static.maemo.org'', and are the same as those used for [http://maemo.org the Maemo site].
 +
 
 +
The <nowiki>MediaWiki</nowiki> install is from the following standard Debian packages:
 +
 
 +
{| class="wikitable"
 +
! !! !!
 +
|-
 +
| mediawiki || 1:1.12.0-2lenny3 ||website engine for collaborative work
 +
|-
 +
| mediawiki-extensions || 1.4 ||set of extensions for MediaWiki
 +
|-
 +
| mediawiki-math || 1:1.12.0-2lenny3 ||math rendering plugin for MediaWiki
 +
|}
 +
 
 +
The following custom extensions are installed and deployed on the Maemo wiki:
* [[User:Dneary#.22Edit_help.22_extension | "Edit Help" extension]]
* [[User:Dneary#.22Edit_help.22_extension | "Edit Help" extension]]
* ''List modules here''
* ''List modules here''

Revision as of 14:52, 11 February 2010

There are several ways to modify the behaviour of the main maemo.org website, and there are similarly several steps required to update the site when changes have been made.

Contents

maemo.org

  • Hosting server: maintenance.maemo.org
  • Admins: Niels, Ferenc, Daniel


Installation details

maemo.org is based on the Midgard CMS, which contains a persistent storage system and provides infrastructure for custom page templates, and dynamic and static content.

Midgard is installed on the server maintenance.maemo.org, and consists of a core application, plus a set of PHP components (such as socialnews, brainstorm, midcom) which are packaged upstream and deployed using Pear. The same Midgard install is then duplicated across several nodes.

There is a central DB instance which is used to serve content. Templates and config snippets are served from this database.

Static content (CSS files, image files, etc) is served from the server static.maemo.org, which runs a lighttpd server.

On top of this, like every CMS, page contents can be created through a web admin interface, for users connected with sufficient privileges.

Updating Midgard

On maemo.org, Midgard can be updated by root via apt-get or dpkg.

Midgard components are updated by being published in the Midgard pear channel and updated on maintenance.maemo.org using

datagard -a pear -p package_name

where package_name can be any of the modules available for Midgard.

The modules installed on maemo.org are:

Updating maemo.org specific styles

Modules, styles and snippets specific to maemo.org (typically sidebars, RSS feeds, footers and headers) are stored in the SVN module maemo2midgard (see the project's Garage page for more information). You can get a copy of the module with the command

svn checkout https://vcs.maemo.org/svn/maemo2midgard

The page style for maemo.org is currently maemo2009. To modify the sidebar of the development page, for example, we should modify the page template development/style-init.php. To change the CSS applied to files, we modify the relevant CSS files in the static/css directory. Once we have made and tested modifications, we can commit to the maemo2midgard subversion repository.

Once a change has been made, to push it live, we must update the checked out working copy of maemo2midgard on maintenance.maemo.org. This requires root access, and can this only be done by list people who have admin rights for maintenance.

If we have modified any of the static files for the site, we must also synchronise these files with static.maemo.org. TODO: how is this done?

Finally, we must update the Midgard database with any config or style snippets which have changed. This is done by running the admin utility scripts

midcom-import-styles

and

midcom-import-snippets

Updating page content

Finally, to update the content of a page such as the development page, log on to the system with a valid maemo.org account with admin privileges, and in the floating menu, choose Page->Edit. You will be able to modify the content of everything inside

...

wiki.maemo.org

  • Hosting server: maintenance.maemo.org
  • Admins: Niels, Ferenc, Daniel


The Maemo Wiki is a standard MediaWiki installation on wiki.maemo.org. The stylesheets used for the wiki are taken directly from static.maemo.org, and are the same as those used for the Maemo site.

The MediaWiki install is from the following standard Debian packages:

mediawiki 1:1.12.0-2lenny3 website engine for collaborative work
mediawiki-extensions 1.4 set of extensions for MediaWiki
mediawiki-math 1:1.12.0-2lenny3 math rendering plugin for MediaWiki

The following custom extensions are installed and deployed on the Maemo wiki:

bugzilla.maemo.org

  • Hosting server: maintenance.maemo.org
  • Admins: Niels, Ferenc, Daniel, Andre