Maemo.org team/Updating maemo.org sites

(Updating maemo.org specific styles)
m (wikify links)
 
(5 intermediate revisions not shown)
Line 25: Line 25:
The modules installed on maemo.org are:
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''
* ''List modules here''
-
 
-
 
-
maemo.org/packages interface: http://trac.midgard-project.org/browser/branches/ragnaroek/midcom/org.maemo.packages
 
-
 
-
Brainstorm: http://trac.midgard-project.org/browser/branches/ragnaroek/midcom/org.maemo.brainstorm
 
== Updating maemo.org specific styles ==
== 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].
+
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.
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.
Line 57: 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:
+
[[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]]
* [[User:Dneary#.22Edit_help.22_extension | "Edit Help" extension]]
-
* ''List modules here''
+
* 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 =
= bugzilla.maemo.org =

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.

Contents

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

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

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:

  • "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