• Intro
• Downloads
• Community
• Development
• News
• TALK

Maemo.org team/Updating maemo.org sites

Latest revision as of 15:09, 8 April 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.

[edit] maemo.org

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

[edit] 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.

[edit] 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:

• Packages interface
• Brainstorm
• List modules here

[edit] 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

[edit] 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

...

[edit] 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:

The following custom extensions are installed and deployed on the Maemo wiki in /var/lib/mediawiki/extensions:

• "Edit Help" extension
• BugzillaReports
• CategoryTree
• Cite
• ConfirmEdit
• DynamicPageList
• GForgeAuthentication
• ImageMap
• ParserFunctions
• RSSReader
• Userlogin_maemo
• UserMerge

Indented plug-ins are available as part of the Debian packages mentioned previously

The stylesheets for wiki pages come from three separate sources:

• maemo2midgard static CSS files used for the main site (in the midgard-data/style/maemo2009/static/css directory of maemo2midgard svn)
• Wiki specific style sheets (in the /mediawiki/2009/monobookmaemo2009 directory of maemo2midgard)
• Stylesheets which are stored directly as wiki pages (MediaWiki:Common.css)

[edit] bugzilla.maemo.org

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