Editing Maemo.org team/Updating maemo.org sites

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

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

= maemo.org =
{{Server admins}}

== Installation details ==

maemo.org is based on the [http://www.midgard-project.org/ 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 [http://pear.php.net/ 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 [http://www.lighttpd.net/ 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 [http://ragnaroek.pear.midgard-project.org/ 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:
* [http://trac.midgard-project.org/browser/branches/ragnaroek/midcom/org.maemo.packages Packages interface]
* [http://trac.midgard-project.org/browser/branches/ragnaroek/midcom/org.maemo.brainstorm Brainstorm]
* ''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 [https://garage.maemo.org/plugins/scmsvn/viewcvs.php/?root=maemo2midgard maemo2midgard] (see [https://garage.maemo.org/projects/maemo2midgard/ 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 [https://garage.maemo.org/plugins/scmsvn/viewcvs.php/midgard-data/style/maemo2009/?root=maemo2midgard maemo2009]. To modify the sidebar of [http://maemo.org/development the development page], for example, we should modify the page template [https://garage.maemo.org/plugins/scmsvn/viewcvs.php/midgard-data/style/maemo2009/development/style-init.php?root=maemo2midgard&view=markup development/style-init.php]. To change the CSS applied to files, we modify the relevant CSS files in the [https://garage.maemo.org/plugins/scmsvn/viewcvs.php/midgard-data/style/maemo2009/static/css/?root=maemo2midgard 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 [http://maemo.org/development 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
 <div id="content">
 ...
 </div>

= wiki.maemo.org =
{{Server admins}}

[[Main Page|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"
! Name !! Version !! Description
|-
| 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 in /var/lib/mediawiki/extensions:
* [[User:Dneary#.22Edit_help.22_extension | "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]])

= bugzilla.maemo.org =

[[Category:Maemo.org]]
[[Category:Community]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Server admins (edit)

Retrieved from "https://wiki.maemo.org/Maemo.org_team/Updating_maemo.org_sites"

Personal tools

Navigation

Views

Editing Maemo.org team/Updating maemo.org sites

@@ Line 2: / Line 2: @@
 = maemo.org =
-{{Server admins| maintenance.maemo.org | Niels, Ferenc, Daniel}}
+{{Server admins}}
 == Installation details ==
@@ Line 53: / Line 53: @@
 = wiki.maemo.org =
-{{Server admins| maintenance.maemo.org | Niels, Ferenc, Daniel}}
+{{Server admins}}
 [[Main Page|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].
@@ Line 93: / Line 93: @@
 = bugzilla.maemo.org =
-{{Server admins| maintenance.maemo.org | Niels, Ferenc, Daniel, Andre}}
+{{Server admins}}
 [[Category:Maemo.org]]
 [[Category:Community]]