From WaterWiki.net

Jump to: navigation, search

Semi-Structured Pages and Templates

= Development & deployment issues (to be adjusted duly) =

These UNIWIKI extensions have been installed

http://www.mediawiki.org/wiki/Extension:Uniwiki_Layouts http://www.mediawiki.org/wiki/Extension:Uniwiki_Generic_Edit_Page

These provide pre-set layouts for creation of new pages; and an improved editor, broken down by sections; and the ability to set restrictions on sections.

Layouts live in the "Layout" namespace.

= Layouts we want =

== Available for users when creating new pages ==

  • Layout:Article: as to add the standard "See else" et al. sections whenever anybody creates a new (also "empty") Wiki-page. Alternatively, and maybe an even better solution, can we create a super-layout that would add these standard sections to each and every page-type.

== Only for Admins (= NOT available for users) ==

* Layout:Country, Layout:Country/Sector_coordination, Layout:Organization/Projects, [[Layout:]], [[Layout:]], [[Layout:]], [[Layout:]]

= Controlling Layouts =

  • @optional: The section will not be added to the new page as default, but a relevant checkbox will be added to the "sections" menu in the top-right of the Generic Editor.
  • @required: The section will be added to the new page, along with a checkbox in the menu, but it will be disabled, dissuading (not preventing) the user from removing the section. The user is still able to remove the section via the "Classic Mode" of the Generic Edit Page.
  • @lock-header: The section will be added to the new page, but the ==Title== will not be editable in the usual way. As above, this is not enforced in "Classic Mode".
  • @lock-text: As above, but applied to the section body.

See all: on MediaWiki


  • layout tag appearing in project and publication editing screens. (waiting on example from Katy)
  • duplication of headings on editing the external resources section (waiting on example from Katy)
    • something to do with the statement in this field?
  • references are not working (although they are on pages without a layout). ex. Tajikistan
    • conflict between these templates and references: Using

<ref> within a template will create correctly numbered reference mark but it will be missing from the output of a

<reference /> on the calling page (example) unless the references tag is transcluded too!. http://www.mediawiki.org/wiki/Extension:Cite/Cite.php#Templates

      • look at how dpl works, protect references in some way during dpl processing?
  • Project layouts will be our first migration. Look into tools for assisting manual correction
  • unnecessary intermediate page when directly loading an unknown article?
  • how should map work in this layout? (see Layout:Project)
  • feature request: assign layout to existing page
  • feature request: REORGANISATION of section headings
    • unicef given feedback on next steps...
  • allow sysop to edit restricted sections (just like locked pages).
  • TABLESEC .. works but this is fragile. need better solution.
  • Sections-list inteferring with edit-box still
  • Trouble if same section title is used twice. Possibly problems with blank sections titles. Extension should check and enforce errors.
  • Troubles with using

{{VARIABLES}} (try creating a new page using Layout:Country/Sector_coordination)

  • allow
template and


into a separate box (locked), but without showing a seperate section (new directive??) .. ex. Layout:Publication
Required Changes/Hacks
  • When creating new page using a layout, 1 line-break should be added in each box by default (reason: for the cursor to be easily placed BELOW possible INSTRUCTION TEXT)
  • related or alternative: hack the extension so it preserves/imposes line-breaks when it's used to create a new page (reason: would help us move down possible instruction text or templates in a given box)
  • can size of the various edirt-boxes be changed (TABLESEC-boxes can be smaller, but others must be a bit bigger for comfort for users)
  • until we have a WYSIWYG solution, re-introduce the convenient style/format-buttons above each edit-window


  • it appears '/' cannot be used in chapter headings (see http://waterwiki.net/index.php/Case_Study_mockup).
    • Can't reproduce, is this still a problem? -Mikel)
  • Subsections not parsed correctly in Layout:X
    • Subsections not allowed in layouts .. can we live with this? -Mikel
  • @lock-header does not prevent it from being removed by right side menu as it should
    • use @required -Mikel
  • on layout choice page, not all layouts should be available (this is configurable in the layout itself)
    • use @namespace directive without no arguments



one step towards a database. consistent structure of page types.

  • use: transclusion and cross linking.
  • user wizard/interface to make these either.
  • leads to the db fields, UI layout & content questions. need good admin interface for this.
  • templates with additional stuff, on particular page types
  • Templates (per content type)
  • break down pages into sections, which are semi-structured, and some UI element to show/hide sections
  • subpages
  • some uneditable sections within the semi-structured pages (like complex DPL functions? .. "mediawiki templates" might be more suitable)
  • usability of layout construction -- directives into UI components
  • automatic maintenance and application of new layouts. updating layouts.
  • customize layout screen according to type of section (standard 3 last Wiki-chapters ("See also'", "References" and "External resources") could be in single wide bottom box)


wiki bots are to migrate existing content to new schemes

Change existing TABLESEC-formated pages
(A) for the current para-titles to become (pre-defined and protected!) sub-sections (= one level down from the standard section headings) in the semi-structured lay-outs
(B) once the semi-structured extension and respective templates are up and running, change some of the headings as follows:
  • Change all existing Report-pages (see the new template created on 26 March 2008 - NB: all report-pages created after that date should be according to the new layout already)
    • change "Type of report" into "Type" and move it down just below "Author"
    • change "Year published" into "Date"
    • add a new heading reading "ISBN/ISSN" just below "Date"
  • Change all existing organization-pages (see the new template created on 26 March 2008 - NB: all organization-pages created after that date should be according to the new layout already)
    • add a new title "Contact" after "Address"
  • Change all existing CoP-Member-pages (see the new template created on 26 March 2008 - NB: all pages created after that date should be according to the new layout already)
    • check if all contain "SKYPE" in the heading "Telephone / SKYPE"
  • Change all existing Contact-pages (see the new template created on 26 March 2008 - NB: all pages created after that date should be according to the new layout already)
    • replace the separate "Telephone" and "SKYPE" headings by a combined one ("Telephone / SKYPE")
  • convert all old "TABLESEC"-pages that contain

<nobr>-like code still into TABLESEC-pages (see e.g. Dialogue_on_Effective_Water_Governance)

  • IF POSSIBLE: add on each TABLESEC-styled page (and particularly the templates) an advisory text that is viewable in edit-mode only, saying something like "DON'T REMOVE THIS CODE-LINE OR CHANGE THE HEADINGS IN THE SECTION ABOVE" or so..
  • in project pages (and template) exchange "Region" with "Location"