Opasnet:Technical documentation: Difference between revisions

From Opasnet
Jump to navigation Jump to search
(→‎Templates: parameters updated)
Line 245: Line 245:
'''Parameters'''
'''Parameters'''


# {{{Dispute}}} is topic of discussion<br>
# {{{Statements}}} is the topic of discussion.
# {{{Outcome}}} is outcome of discussion<br>
# {{{Resolution}}} is the outcome of discussion. It may be a full resolution (only one statement is valid after the discussion), or partial resolution (several competing statements are still valid).
# {{{Argumentation}}} contains argumentation supporting/attacking/commenting the dispute
# {{{Argumentation}}} contains argumentation supporting/attacking/commenting the statements.
# If {{{Closed}}} parameter contains something, the page will be categorised into [[:Category:Closed discussions]], otherwise [[:Category:Open discussions]].





Revision as of 18:11, 3 January 2010

This page contains all the technical documentation related to this Mediawiki environment.

Technical background and installation requirements

Versions:

  • MediaWiki: 1.11.0
  • PHP: 5.1.6 (apache2handler)
  • MySQL: 5.0.27

Requirements:

  • XML / Latin-UTF-8 conversion support (php-xml?)
  • PHP memory limit 8M -> 20M
  • GNU diff3
  • GD graphics library (php-gd)

Upcoming/Future extensions

  • Graphical editor
  • Distribution database
  • Analytica <-> Wiki converter

Extensions and add-ons

PageCSS

Used to change background color of variable pages.

PageID

This extension digs Page_id from wiki database. Used to create Analytica identifiers.

Lockdown

Used for page protection purposes.

FCKeditor

WYSIWYG editor for wiki.
More information: http://mediawiki.fckeditor.net/index.php/Main_Page

Discussion Threading

Better discussion possibilities
More information: http://www.mediawiki.org/wiki/Extension:DiscussionThreading

EmailForm

Used for creating email -forms.
More information: http://www.mediawiki.org/wiki/Extension:EmailForm

ParserFunctions

This extension enables various kinds of functions (ie. math and conditional templates)
More information: http://meta.wikimedia.org/wiki/ParserFunctions

Google Maps

This extension enables GoogleMaps in wikipages
More information: http://www.mediawiki.org/wiki/Extension:Google_Maps

ToolTip

This extension is used to add tooltip-boxes into wikitext
More information: http://www.mediawiki.org/wiki/Extension:Tooltip

SidebarEx

This extension provides a means of adding page links to the 'sidebar' based on group membership & per-user basis
More information: http://www.mediawiki.org/wiki/Extension:SidebarEx

DynamicPageList2

This extension is used for making lists etc. automatically
More information: http://www.mediawiki.org/wiki/Extension:DynamicPageList

Password Reset

This extension is used for password resetting in case user has forgotten her password
More information: http://www.mediawiki.org/wiki/Extension:Password_Reset

Contribution Scores & Contributors

Extensions for counting contribution scores
More information -> http://www.mediawiki.org/wiki/Extension:Contribution_Scores

GroupBasedAccessControl

Extension for access control
More detailed information ->http://www.mediawiki.org/wiki/Extension:Group_Based_Access_Control

AjaxShowEditors

This extension allows you to see who is editing a page that you're editing.

More detailed information can be found from http://www.mediawiki.org/wiki/Extension:Ajax_Show_Editors

Files: located in /extension/AjaxShowEditors

News

News extension allows dynamic page-listing functions.

Files: (/extensions/News/)

  • install.settings
  • News.php
  • NewsRenderer.php

More detailed information about News extension can be found from http://www.mediawiki.org/wiki/Extension:News

Cite

Cite extension is used for making references and footnotes

More detailed information can be found from http://www.mediawiki.org/wiki/Extension:Cite/Cite.php

CreateBox

CreateBox extension is used for page creation. This extension replaces old inputbox extension.

More detailed information can be found from http://www.mediawiki.org/wiki/Extension:CreateBox

Imagemap

Imagemap extension is used for creating imagemaps.

Files: (/extensions/ImageMap/)

  • desc-20.png
  • desc.svg
  • Foo.jpg
  • ImageMap.i18n.php
  • ImageMap.php
  • ImageMap_body.php

More detailed information about ImageMap extension available from http://www.mediawiki.org/wiki/Extension:ImageMap

Additional buttons

All extra buttons require additions to Monobook.js

Table

Table -button is used to create tables. Icon available: Button_array.png

New Discussion

Discussion -button is used to create new discussion. Button implements discussion -template. Icon available: discussion.png

Attack

Attack -button is used to create attacking argumentations. Button implements attack -template. Icon available: attack.png

Defend

Defend -button is used to create defending argumentations. Button implements defend -template. Icon available: defend.png

Comment

Comment -button is used to create comments in argumentations. Button uses comment -template. Icon available: comment.png

Variable

Variable -button creates automatically variable structures. Icon available: variable.png

Link to discussion

Link to discussion -button creates link to discussion to the related discussion page. Button uses disclink -template. Icon available: disclink.png

Modifications

Printable version CSS

  • This needs to be fixed

Supported filetypes

File Type
ana Analytica
ppt Microsoft PowerPoint
pps Powerpoint Show
xls Microsoft Excel
pdf Adobe
doc Microsoft Word
tif Tagged Image File -picture
png Portable Network Graphics -picture
gif Graphics Interchange Format -picture
jpg & jpeg Joint Photographic Experts Group -picture
ogg Audio -file
zip Compressed file format

Changes made to LocalSettings.php

Linking

Font changed

Main font is changed to Arial Unicode Ms due to problems with Internet Explorer and arrows used in argumentation. Printable version's font is changed to Times
Changes in Main.css (Monobook skin)

body {
	font: x-small sans-serif;
	font-family: "Arial Unicode Ms", Arial, sans-serif; 
	background: #f9f9f9 url(headbg.jpg) 0 0 no-repeat;
	color: black;
	margin: 0;
	padding: 0;
}


Changes in commonPrint.css

body {
    background: White;
    /*font-size: 21pt important;*/
    color: Black;
    font-family: times;
    margin: 0;
    padding: 0;
}

Templates

Discussion

This template is implemented when user creates discussions using Add discussion -button. Template contains basic structure of a discussion/argumentation model.

Parameters

  1. {{{Statements}}} is the topic of discussion.
  2. {{{Resolution}}} is the outcome of discussion. It may be a full resolution (only one statement is valid after the discussion), or partial resolution (several competing statements are still valid).
  3. {{{Argumentation}}} contains argumentation supporting/attacking/commenting the statements.
  4. If {{{Closed}}} parameter contains something, the page will be categorised into Category:Closed discussions, otherwise Category:Open discussions.


Attack

This template is implemented when user creates attacking argumentation using Attack -button. Template contains attack argumentation structure and parameters for user to add.

Parameters

  1. {{{1}}} is number of statement
  2. {{{2}}} is content of statement
  3. {{{3}}} is name of argumentor


Defend

This template is implemented when user creates defending argumentation using Defend -button. Template contains defend argumentation structure and parameters which are set by user.

Parameters

  1. {{{1}}} is number of statement
  2. {{{2}}} is content of statement
  3. {{{3}}} is name of argumentor


Comment

This template is implemented when user creates comment using Comment -button. Template contains comment argumentation structure and parameters which are set by user.

Parameters

  1. {{{1}}} is number of statement
  2. {{{2}}} is content of statement
  3. {{{3}}} is name of argumentor


Disclink

This template is implemented when user creates a link to a discussion using Link to discussion -button. Template generates a link to the discussion page.

Parameters

  1. {{{1}}} is topic of discussion


Prettytable

This style-template is used in tables to make them look a little better. Template is copied from Wikipedia.