Maemo.org team/Updating maemo.org sites

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.

= maemo.org =

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:
 * List modules here

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.

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 =

The Maemo Wiki is a standard 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. The following custom extensions are installed and deployed on the Maemo wiki:
 * "Edit Help" extension
 * List modules here

= bugzilla.maemo.org =