Manual of the Extended Wiki System (dr_wiki)
Contents
1. y FIDIS Future of Identity in the Information Society Title D1 3 Manual of the Extended Wiki System DR_Wiki Author WPI Editors Denis Royer JWG Germany Andr Deuker JWG Germany Reviewers Mark Gasson University of Reading UK Identifier D1 3 Type Manual Version 1 20 Date Wednesday 31 May 2006 Status Draft Class Public File fidis wp1 del1 3 manual extended wiki doc Summary This document details the technical aspects e g features development notes user manual of the customised Wiki system DR Wiki used on the FIDIS Communication Infrastructure FCI The original Wiki software on which this is based is published under the GPL and is publicly available at www typo3 org This document is aimed towards both the general Wiki user and the Workpackage administrators for configuring the DR Wiki Typo3 extension Copyright O 2004 05 b IS consor The FIDIS NOE receives research fu C Contract Community 075 amework Prog Inf ud ei iii W K FIDIS D1 3 Future of Identity in the Information Society No 507512 Copyright Notice This document is published under the Open Content License available from http www opencontent org opl shtml The content of this document is based on Typo3 a GNU GPL CMS Framework available from www typo3 org All rights reserved PLEASE NOTE This document may change without notice Updated ve2. 8 8 Version 0 7 2 e Added support for external templates via FlexForm e Enhanced the detection of the user user username IP anonymous e Introduced basic namespaces NS and InterWiki links 8 9 Version 0 7 1 e Fixed a bug in the setting of the Startingpoint 8 10 Version 0 7 e Added FlexForm configuration for TOC Caching etc e Added back link for discussion e Added Read Only option for Wiki Wiki Viewer e Added localisation of BE Module en de e Clear cache from BE e General code clean up 8 11 Version 0 6 2 e Got rid of the bug to explicitly set the Startingpoint of the Wiki now the actual page is used as default value and Sys Folders can be used as Startingpoint to store Wiki pages 8 12 Version 0 6 1 amp 0 6 e Added check for newer versions of a Wiki page that has been edited while another user saved his her changes e Got rid of the bug to explicitly set the startingpoint now the actual page is used as default value e Added some additional usability features reload button for Wiki pages link for the key word when aborting the edit of a page the user gets redirected to the referring page and not to the HomePage Draft Version 1 20 Page 33 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 e The issue with regard to the php_flag allow_call_time_pass_reference is solved so this flag does not need to
3. a 2 b 2 item 2 3 item 3 Both types of lists can also be combined e item l a 2 b Draft Version 1 20 Page 19 File fidis wp1 dell 3 manual_extended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 e item 2 e item 3 A colon indents a line or paragraph Works similar to the bulleted and numbered lists text gt more text text even more text even more text even more text A word between double square brackets creates a new internal link to a Wiki page in this case for the term word word i l ae Links appear as bold text when the article is viewed See section 4 1 for more information HomePage Creates a link specifically to the starting page of the Wiki word alternative Creates a new internal link to a Wiki page called word but text using the alternative text as link title Creates a new internal link to a Wiki page using the LI d trail combination wordtrail as link title wor rai e machine s gt machines link to page called machine Creates a new internal link to a Wiki page called word in the namespace ns Currently the following namespaces are available e Wikipedia gt creates an external link to the English version of the Wikipedia encyclopaedia Discussion gt discussion pages of the individual Wiki pages ns word IMDB gt Link to the international movies databas
4. CURRENTMONTHNAMEGEN Nov CURRENTDAY Returns the current day as numerical value e g 1 CURRENTDAYNAME Returns the current day as word e g Wednesday CURRENTYEAR Returns the current year e g 2005 CURRENTT IME Returns the current time hh mm SWATCHBEATS Returns the current time in Swatch Internet Beats PAGEAUTHOR Displays the author of the current page NUMBEROFARTICLES Displays the number of articles in a Wiki ALLCONTRIBUTINGAUTHORS Displays oll authors contributing to a Wiki CONTRIBUTINGAUTHORS Displays all authors contributing to an article of a Wiki __NOTOC__ Deactivates the generation of a TOC __NONUMBERHEADINGS__ Deactivates the generation of a header numbers VERSION Displays the release number of the Wiki engine Draft Version 1 20 Page 23 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 6 3 Special Characters Other special characters such as Diacritical marks punctuation commercial symbols Greek characters mathematical characters amp Agrave amp Aacute amp Acirc amp Atilde amp Auml amp Aring sAElig amp Ccedil amp Egrave amp Eacute amp Ecirc amp Euml amp Igrave amp Iacute amp Icirc amp Iuml amp Ntilde amp Ograve amp 0acute amp Ocirc amp Otilde amp Ouml amp Oslash amp Ugrave amp Uacute amp Ucirc
5. DEF General Settings TOC Settings Editor Settings Advanced Settings TOC Disable the creation of the table of contents TOC E TOC Maximum level of headings to create TOC Default 4 TOC Minimum count of headers for displaying the TOC Default 4 TOC Disable the nubering of heading E Figure 5 TOC settings Disable the creation of table True or false By default this option is contents false Maximum level of headings to Enter the favoured maximum level of create TOC headings The default level is 4 Use this option to limit the count of headers in your TOC Default value is 4 headers for the creation of a TOC Minimum count of headers for displaying the TOC True or false By default this option is Disable the numbering of heading Elsa Draft Version 1 20 Page 29 File fidis wpl dell 3 manual_extended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 7 2 3 Editor Settings DEF General Settings TOC Settings Editor Settings Advanced Settings Editor Humber of editor lines Default 301 Editor Number of editor columns Default 50 Editor Turn on line wraping Default OFF E Editor Summary characters Default 501 Figure 6 Editor settings Number of editor lines Default 30 Numeric Default value is 30 lines Number of editor columns Default 50 Numeric Default value is 50 columns Change the wrapping of lines in the Tur
6. Future of Identity in the Information Society No 507512 the original table again This will result in the following output nested al the original table again table Please note Nested tables have to start on a new line 6 6 Further resources HTML to Wiki table converters e http www uni bonn de manfear html2wiki tables php e http diberri dyndns org html2wiki html CSV to Wiki table converters e http area23 brightbyte de csv2wp php Draft Version 1 20 Page 26 File fidis wpl dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 6 7 Wiki Plug Ins Currently the following dynamic Wiki plug ins are available In order to use these simply insert the following markups into the source of a Wiki page Inserts a Search Form on the Wiki page and displays the result This plug in searches the body and the keywords of the database HHHLASTCHANGEDHHH days LASTCHANGED Inserts a list of the pages changed in the last days days CRRRINDENLISTARE CHHEINDEXLISTARR HHRINDEXLISTH HH Lists the Wiki words in a Wiki C ee the creator of the Wiki page This is done by picking the author of AUTHOR H HHHAUTHOR HF the oldest Wiki page entry and creating a new Wiki page link for the author SEARCH FF SEARCH F F Displays the list of available TEMPLATELIST H TEMPLATELIST as i i templates in the current
7. be set in the htaccess file anymore e Finally the bug with regard to the formatting of external links missing spaces 1s solved 8 13 Version 0 5 2 e Fixed a bug in the rendering of links e Added support for multiple redirects e Removed unused cancelEdit function from source code 8 14 Version 0 5 1 e Fixed a small bug in the discussion section when adding a discussion e Added REDIRECT Link for redirecting to other pages 8 15 Version 0 5 e Added caching of rendered pages e Added toolbar for the editor e Needed JS Code is now externalised for easier maintenance e General code clean up and removal of unused elements 8 16 Version 0 4 e First public release containing basic Mediawiki markups e Added better rendering of headers including TOC for Wiki pages Draft Version 1 20 Page 34 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 9 Annex II Glossary Application programming interface API An application programming interface API is a set of definitions specifying the ways one piece of computer software communicates with another It is a method of achieving abstraction usually but not necessarily between lower level and higher level software Content Management System CMS In computing a content management system CMS is a system used to organise and facilitate collaborative creation of documents and other
8. gt Sets the text to italic Sets the text to bold Sets the text to bold amp italic Draft Version 1 20 Page 21 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS DI 3 Future of Identity in the Information Society No 507512 params HTML Tags REDIRECT IDM You can lt s gt strike out deleted material lt s gt and lt u gt underline new material lt u gt PS PS PS Discussion only Ad PS FS PIS Discussion only Discussion only templatename Draft Version 1 20 Creates a new table cp Chapter 6 4 Some HTML tags are allowed inside a Wiki By default the the tags below are currently supported lt br gt lt b gt lt i gt lt p gt lt u gt lt center gt lt hr gt lt sub gt lt s gt lt small gt lt blockquote gt lt td gt lt tr gt lt th gt lt table gt Redirect one article to another by placing a directive like the one shown on the left on the first line of the article such as at a page titled IDM gt Identity Management The example on the left would display You can strke eutdeleted_materiat and underline new material Adds the user s login name to the article as signature Only works for the Discussion namespaces e will be replaced by Frank Idis Adds the user s login name and date to the article as signature Only works for the Discussion namespaces 0 will
9. quality content or to address issues that can occur in collaborative authoring contexts such as correcting errors disambiguating terms resolving disputes or addressing vandalism Wikipedia online encyclopedia www wikipedia org gt For instance the first Wiki the Portland Pattern Repository was created in 1995 to help a community of software designers to share programming patterns For instance CNET news com has defined the ID Theft Wiki www idtheftwiki com to involve its reader to contribute to the writing of a special report on the subject of Identity Thieft See also Terdiman 2005 for an article describing how Esquire magazine writer A J Jacobs describes his experience of using a Wiki to write an article For instance the company JotSpot www jot com commercialises a Wiki engine to be used essentially within organizations Draft Version 1 20 Page 8 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 2 2 DR_Wiki The Typo3 Wiki Engine Extension 2 2 1 Foundations DR_Wiki is the Typo3 Wiki Engine Extension that has been developed for the FIDIS project to implement the FIDIS Wiki This extension is used in the project both as a standard Wiki and to facilitate the work of the individual Workpackages DR_Wikt itself is based on another Typo3 Wiki Engine which was customised to meet all of the FIDIS requirements e g advance
10. redirected to the page stated in the redirect markup One example usage could be the use of abbreviations 1 e IDM actually refers to the page Identity Management another would be if a page has been removed altogether with its original content added to a different page and a final example would be if a page has had its name changed Method Nulla blandit auguej quis The first step is to create a new page by creating a new link double square brackets as shown in section 4 1 or by editing an existing page REDIRECT porro quisquam In the page to be redirected from enter the redirect markup into the first line pointing to the target page of the redirect The redirect markup 1s shown here in the image to the left of this text with the target page summary II celia name in the double square brackets In this example anyone attempting to see the page with the redirect link in it will actually be redirected to the page porro quisquam After entering the markup press the save button or ALT s to preserve the changes Article porro quisquam Discussion Now anyone using the blandit augue link will be automatically redirected to the article porro quisquam Draft Version 1 20 Page 16 File fidis wpl dell 3 manual_extended_wiki doc FIDIS DI 3 Future of Identity in the Information Society No 507512 4 3 Case 3 Compare Different Page Versions Summary The
11. P7D 52 Wiki Type 2 Select the kind of page content this element represents New options will appear when you save the record Insert plugin y Language Columns _ Before After Frame Index To top Default Y 2 Normal Y Ez Fi v 2 VIB Header Enter a headline for the content element New Wiki Align Type Link YP MIE Normal iG Ol F Plugin 2 Select a plugin to insert DR Wiki Extension v Plugin Options 2 FlexForm Configuration of Plugins DEF General Settings OC Settings Redirect Settings Startingpoint E Page Recursive v Draft Version 1 20 Page 28 File fidis wp1 dell 3 manual_extended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 7 2 Configuration options This section describes the configuration values that can be used to configure the Wiki extension All the options and values are set in a FlexForm allowing an easy configuration of DR Wiki 7 2 1 General Settings General Settings TOC Settings Editor Settings Advanced Settings Startingpoint ai Sl Recursive Figure 4 General settings Select manually the page where the DR Wiki data Startingpoint will be taken from Default value is the page where the extension is installed Can be set but is generally not necessary Includes the Recursive y re sub pages to be searched for Wiki database entries 7 2 2 TOC settings
12. SA IA 33 O o A ov A A eae Scot cole au os wea 33 SES A A 33 S12 DAN A RO 33 A EA ee Cone ee Senet On eee ete ae Gore eee men 34 A RRR Yr 0 0 1080 AA A Ree OE SE RO Ne A A TI ER OR DO 34 O A ON 34 sO e o eee ier eer a TN MU ae eT ME Ye eMC TT eee RecerREn meio TRE eae 34 9 Annex I Glossaries 35 IU MME A A II A A A 36 Draft Version 1 20 Page 6 File fidis wpl dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 1 Executive Summary In today s digital world Wikis information systems that allow users to very easily create edit and link Web pages have proven to be very successful means of exchanging information They are widely used for all kinds of information which range from general encyclopaedias to topical Wikis Some of these Wiki projects have become very successful and evolved into widely used information pools e g Wikipedia The use of Wikis has therefore been adopted into the FIDIS project to facilitate the management the authoring and the diffusion of knowledge related to the domain of Identity The term Wiki also refers to the collaborative software Wiki engine used to create such information collections In essence the Wiki as a software system is a vast simplification of the process of creating HTML pages and thus is a very effective way to exchange information through collaborative effort This document describes the technical aspects e g the feat
13. Wiki Draft Version 1 20 Page 27 File fidis wpl dell 3 manual_extended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 7 Annex Ill Configuration 7 1 Basic Configuration In order to use the DR_ Wiki you have to take the following steps 1 Insert the extension into a page by using either the context menu of the Typo3 page tree or the Create page content button Edit page header Create page content NORMAL 2 Click on the DR Wiki icon in the content element menu to insert the extension into a page Plugins O a General Plugin Select this element type to insert a plugin which cannot be found amongst the options below O EF Susstbook Guestbook Adds a guestbook to the page F lt p Mininews Mini news Mini mews O 25 Message board Adds a message board list stule forum to the page O f g Discussion forum Discussion forum Add a threaded discussion forum tree style forum to the page O E Extended Table Extended Table Adds a table that provides a lot of possibilities for editing tables oO 2 Better login box Adds a login box to the page more advanced than the default O Add the CHC forum plugin 3 Ifnecessary set the Startingpoint for the plug in in the FlexForm configuration tabs and click on the Save button to store the changes Further configuration parameters can be found in the following chapter Pagecontent NEW
14. amp Uuml amp szlig amp agrave taacute amp acirc amp atilde amp auml amp aring taelig amp ccedil amp egrave teacute amp ecirc amp euml amp igrave amp iacute amp icirc amp iuml ntilde amp ograve amp oacute tocirc amp 0elig totilde ouml amp oslash amp ugrave amp uacute amp ucirc amp uuml amp yuml amp iquest amp iexcl amp sect amp para amp dagger amp Dagger amp bull amp ndash amp mdash amp lsaquo amp rsaquo amp laquo amp raquo amp lsquo amp rsquo amp ldquo amp rdquo LD amp trade amp copy amp reg amp cent amp euro amp yen amp pound amp curren amp alpha amp beta amp gamma amp delta amp epsilon amp zeta seta amp theta amp iota amp kappa amp lambda amp mu nu amp X1 amp omicron pi amp rho amp sigma amp sigmaf tau amp upsilon amp phi amp chi amp psi amp omega amp Gamma amp Delta amp Theta amp Lambda amp Xi Pi amp Sigma amp Phi amp Psi amp Omega amp int amp sum amp prod amp radic amp minus amp plusmn amp infin amp asymp amp prop amp equiv ne amp le amp ge amp times amp middot amp divide amp part amp prime amp Prime amp nabla amp permil amp deg amp there4 S amp alefsym amp oslash amp isin amp notin amp cap amp cup amp sub amp sup amp sube amp supe amp not amp and amp or amp exist amp forall amp rA
15. be replaced by Frank Idis date Adds the current date to the Wiki page Templates are an easy way of adding pre fabricated text elements to a Wiki page This mechanism can be used to insert repeating text elements to a Wiki page such as notes pre formated tables and so on Generally talking templates are Wiki pages that reside in the namespace Template such as Template templatename By adding the name of the template into curled braces without the namespace marker the content of a template page is added into the Wiki page and rendered into HTML Page 22 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 6 2 Wiki Variables These markups can be used to automatically display additional dynamic Meta information on a Wiki page Markup Description PAGENAME Displays the name of the current Wiki page GETDISCUSSIONLINK Returns an internal link to the connected discussion page or an empty string 1f no discussion is present REVISIONID Returns the ID of the current Wiki page NAMESPACE Returns the name of the current namespace DATE Returns the current date string Y m d H 1 s CURRENTMONTH Returns the current month as numerical value e g 11 CURRENTMONTHNAME Returns the current month as word e g November Returns the current month as 3 letter short version e g
16. content A CMS is frequently a web application used for managing websites and web content though in many cases content management systems require special client software for editing and constructing articles The market for content management systems remains fragmented with many open source and proprietary solutions available FlexForm FlexForms are a configuration mechanism used by Typo3 to configure extensions in an easy way Instead of using database fields the information is stored in XML files for easier and faster retrieval GNU General Public Licence GPL The GNU General Public License GNU GPL or simply GPL is a free software license originally written by Richard Stallman for the GNU project It has since become the most popular license for free software The latest version of the license version 2 was released in 1991 The GNU Lesser General Public License LGPL is a modified version of the GPL intended for some software libraries Markup A markup language combines text and extra information about the text The extra information for example about the text s structure or presentation is expressed using markup which is intermingled with the primary text The best known markup language in modern use is HTML Hypertext Markup Language one of the foundations of the World Wide Web Historically markup was and is used in the publishing industry for interoperable communication of printed work between authors editors a
17. d editing MediaWiki compliance etc The decision to develop a customised Typo3 extension rather than using one of many freely available Wiki engines was motivated by the need to provide an integrated information infrastructure for the FIDIS NoE Looking at the FIDIS Communication Infrastructure FCI the system resides on a Typo3 content management system CMS being installed on the FIDIS servers at e The FIDIS project public web site www fidis net and e The FIDIS project intranet internal fidis net 2 2 2 Technical Aspects Typo3 itself is a very modular application server based on PHP and the MySQL database allowing a developer to extend its functionality using a standardised application programming interface API These so called Typo3 extensions are pieces of PHP code which add certain functionalities to a Typo3 installation without changing the original Typo3 code core Figure 1 illustrates the API and the general design of Typo3 in more detail Therefore in order to seamlessly integrate the Wiki system into the existing CMS the extension is based on this API using the mechanisms of Typo3 such as intelligent caching user authentication and handling and its security features Furthermore this also enables the system to have several instances of the DR_Wiki extension serving different Workpackages etc S DR Wiki is based on the al wiki extension available at www typo3 org See c2 com c
18. diff tool is a utility that shows the differences between two page versions allowing a user to compare any previous version to the current one Method Sample Wiki VWorkpad dolore magnam De Id Compare Author Date 3408 compare to newest Andr Deuker 15 11 2005 10 21 3407 compare to newest Andr Deuker 15 11 2005 10 17 Displayindi Msults 1 to 2 outof 2 Summary Sample Wiki Workpad dolore magnam 3407 vs 3408 Fusce vitae purus Praesent augue mauris Praesent congue eu ultrices vel commodo in sapien Fusce porttitor elit accumsan justo Donec lobortis sagittis erat Draft Version 1 20 File fidis wp1 dell 3 manual_extended_wiki doc The first step to compare different page versions 1s to click on the version icon in the toolbars at the top or at the bottom of the Wiki Now you are shown all the different versions of the Wiki page and any additional information e g date summary etc By clicking on the compare to newest link the differences between the two versions will be shown The comparison of the page versions will be done word by word If you compare an old version to the latest one the red coloured segments refer to items found in the older version but not in the latest while the green segments represent differences found in the latest page version that were not in the older one Black means that no differences were found Page 17 FIDIS D1 3 Future of Identity in the Inf
19. dy of pages which are usually highly interconnected is called the Wiki The editing of the Wiki is based on the use of a simple markup language in which an editor can easily specify the formatting such as headings bullets and so on of Wiki pages and also to hyperlink them with one another via the terms included in this page Wikis also usually offer other functionalities for facilitating the coordination of different authors such as locking the content of pages under edition content versioning and history the system archives the different version of the Wiki page discussion pages a Wiki page may have an associated page for discussion and so on On the non technical side Wikis propose a set of principles processes and guidelines that can be used to regulate and coordinate the knowledge authoring and diffusion process in the community of the users making use of these Wikis For instance many Wikis such as Wikipedia rely on the concept of public and open source content in which everybody is allowed to create or update the Wiki pages and to make use of this content in various contexts subject to proper citation of the author In some other cases more restricted Wiki can exist in which access is restricted to a particular group or for which you need to authenticate before publishing The processes and guidelines include the description of the different practices such as style policies templates etc to be used to create high
20. e FIDIS gt Link to the FIDIS Wiki on Identity related terms e g FIDIS WP1 User gt User pages Categories are also used as namespaces o Category IDM o Category Identity word Creates a heading level 1 H1 tag Draft Version 1 20 Page 20 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 Markup Description Creates a heading level 2 H2 tag word Creates a heading level 3 H3 tag Creates a heading level 4 H4 tag Creates a heading level 5 H5 tag Creates a heading level 6 H6 tag Inserts an image from imageURL into the Wiki page Currently only gif jpeg jpg and png images are allowed imageURL Example e http somedomain org myimage jpg URLs and email addresses are automatically converted to real HTML links Currently ftp http s mailto irc gopher and news URLs are recognised oe Examples e mailto someone somedomain org eo http www somedomain org Creates a link using the name as link text Currently ftp http s mailto irc gopher and news URLs are recognised URL link text Examples e mailto someone somedomain org My Email e http www somedomain org My Domain Creates an enumerated link Currently ftp and http s URLs are recognised Examples o mailto someone somedomain org e http www somedomain org Creates a bar horizontal line lt hr
21. e HomePage of the current Wiki o The reload button updating the content of the current Wiki page This 1s useful 1f several users edit the page at the same time o A The edit button for editing the current page o The version button displaying the version history of the current Wiki page o ue The download button to export a plain HTML version of the current page which can be used in other documents 4 The Meta Data containing information about o The last person editing the page l4 For the administration and the installation of the Wiki extension see Annex III Configuration for details Draft Version 1 20 Page 12 File fidis wpl dell 3 manual_extended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 o The date and the time the last change 3 2 How to edit a Wiki page It is very easy to edit a Wiki page Simply click on the edit icon 4 of a Wiki page top or bottom This will open up the edit view of the current Wiki page The editor consists of the following basic components see Figure below for details Path SAIS Commaurricatior ivfrastmctore bogi 2 hein amp Coos Al Goes Cbcomentatior Wee Pia ygu Sample Wiki Workpad as Ba BA 20 Meque porro quisquam est qui dolorem ipsum quia dolor sit amet consectetur adipisci velit sed quia non nunquem eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem ut enim ad m
22. e d NEW Paris ii iia 15 4 2 Case 2 Create T RUI aan 16 4 3 Case 3 Compare Different Page Versl0ODS ooooonnnnncccnncnononnnonnnonononnnnnccnnnnnnnnnnnnnnnonoss t7 Conclusion and Outlook sscccsscsseesitccccbeesesecexivscccccasassevsieccesbuosass sevice tececasasieessecessoussasseesets 18 ANNE MIA SI E E tai 19 6 1 General Formatting MarkUpS dida 19 6 2 Wiki Yala ii 23 6 3 SU is PR eee ne a eee ee ee 24 OA Render OF Paes a oa 25 6 5 SF ONG A A A aaa bacasae tte te toana geen 25 6 6 PUIG ETS OUL COS pi osa 26 6 7 Wk Meg US ae ce hse sete settee N hosed tata EO 2I 7 Annex Ni COMMGULAION air a 28 7 1 Basie C onii OUEATION aeree A tet 28 T2 Contrettation options A 29 T2 General e OE reren a E E ease 29 Pa AKG Ga ina ti redseatec ic 29 Tas A ee ie A eaten ileal at nals aael a catia 30 7 2 4 Advanced SEMINE Session aE R E E id 30 TZ Redirect AU Saeni a 31 8 Annex IV DR Wiki Change LOg ssssecccccccceseoccccccesccccccccccccccccosocccccscccceccccesesesoosessesss 32 8 1 NOSO Do eer NSOE 32 8 2 Version ltda i 32 8 3 Verion LO Uan a 32 8 4 CSOD A E E E ATE O O O 32 8 5 NEST STON O Daciana a a a a a a a a a 32 8 6 O A tnt ei ni ernest Rr An oe ene SE ADR Se ie a nr nen oe Meee 32 8 7 O E T E E yates inden 32 8 8 Ner IOMO E a capa Sala epee as ea pa ala me gaa Re 33 Draft Version 1 20 Page 5 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 8 9 Her Cok
23. ft Version 1 20 Page 3 FIDIS D1 3 Future of Identity in the Information Society No 507512 Versions Version Date Description Editor 0 1 01 09 2005 e Initial release e Added specification list 15 09 2005 e Added software change log to annex e Added usage scenarios O 02 10 2005 e Added markup description 03 10 2005 e Start of Wiki testing phase on the FCI and migration of WP2 Wiki into the FIDIS Wiki 0 5 03 11 2005 e Added Contribution of Thierry Nabeth INSEAD France to the document CS 15 11 2005 e Review release of document 1 0 22 11 2005 e Final release including review remarks 28 11 2005 e Added new search and template plug in 1 2 31 05 2006 e Minor corrections and updates of the markups e Added Namespace descriptions Draft Version 1 20 Page 4 File fidis wpl dell 3 manual_extended_wiki doc FIDIS Future of DI 3 Identity in the Information Society No 507512 Table of Contents E Executive SUMMAry PA A O E E A NEERA 7 2 TOCA nsa E E 8 Del NV AG AWN IK a E T eee ee ia NRA 8 22 DR Wiki The Typo3 Wiki Engine Extension cccccccccnnnnnnnnnnnonnnnccnnnnnnnnnnnnonononnnnnnnos 9 ZA Fondan serer 9 Ze COMICAL NS eC ls AA e ROO op E A 9 2 Featuros OL DR WIK sien ch ot een A a a O 11 3 General User MO naa EEA acne 12 3 1 Fel Fes ohh Ile pe me ee ere eee ee ear ere er eee 12 32 Howto edita Wiki Parnaso T 13 4 Simple USAGE SCONALIOS APRO PO 0 Q PI aa a E 15 4 1 Case l Creat
24. gi wiki WikiEngines for a list of Wiki engines 1 Read more at www typo3 org l The details of the FIDIS Communication Infrastructure can be found in deliverable D1 2 An Information structure to provide categories and subcategories relevant for FIDIS 2 Typo3 core documentation http typo3 org documentation document library doc_core_inside Draft Version 1 20 Page 9 File fidis wpl dell 3 manual_extended_wiki doc FIDIS Future of Identity in the Information Society No 507512 UNIFIED INTERFACE Despite TYPO3 being made up of extensions they all fit seemlessly into a unified interface that provides a whole for the user of both the website and the administration backend TYPO3 EXTENSIONS Plugins modules application logic skins third party apps BACKEND Administration of the content is done by the core functions and a set of extensions needed to do the job L C 2 Y C 0 dul X W 0 0 fa EXTENSIONS Clearly confined code additions to TYPO3 contributed and supported by individuals in the community Quality control review by Core Group authorized mentors Figure 1 The Typo3 API CORE DI 3 SERVER LAYER Underneath TYPO3 lies PHP scripting language MySQL database and a normal webserver like Apache MySQL Auth DB Visual API Install 13 Source www typo3 org documentation document library doc core inside This document 1 Draft Version 1 20 Fi
25. inima veniam D summar O gt gt Cancel Exit Meed help Check the documentaion for the Wiki WWorpad here Figure 3 Editor for a Wiki page 1 The editor toolbar containing the basic markups 2 The actual text area containing the Wiki source of the current page 3 The save and preview buttons 4 The summary field for general editing notes Result Shortcut B Bold text Shift an Italic text Shift Ab Internal link Shift a External link Shift A Level 2 headline Shift Horizontal line Shift Ga Signature and Date None Table 1 The icons on the editor toolbar Draft Version 1 20 Page 13 File fidis wpl dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 The most convenient way to edit the contents of a Wiki page is to use the toolbar which works similar to a toolbar available in a standard word processor or editor Table 1 describes the icons and their functions in more detail Another way to edit a page is manual entry of the Wiki markups A detailed list of all available markups and several examples can be found in the annex of this document pp 19 In general the Wiki markup language is compliant to the syntax of the de facto MediaWiki which is used for one of the largest Wiki projects Wikipedia This also enables the user to incorporate their own articles into Wikipedia or other projects When finishing the edit one should write a short edit su
26. le fidis wp1 dell 3 manual_extended_wiki doc Interface Framework Q at es lt CORE Controlled and developed by the Core Group Page 10 FIDIS D1 3 Future of Identity in the Information Society No 507512 2 3 Features of DR Wiki The Wiki extension currently supports the following features Wiki Markup MediaWiki compliant syntax for markups cp Annex Advanced formatting and integration of external resources links images etc Support for tables allowing a more complex page layout Support for templates in Wiki pages Wiki Editing General formatting of Wiki page content in an easy to use text editor Sections for discussing content of Wiki pages Read only versions of a Wiki for public dissemination of closed Wikis Multiple redirecting of pages InterWiki links to other information repositories e g Wikipedia FIDIS Wiki etc and rudimentary namespaces for categorising information HTML export of Wiki pages for usage in other documents Versioning of Wiki pages and page history Difference engine to find changes in different page versions diff Technical Aspects Intelligent caching of rendered Wiki pages and template parts for higher performance Wiki plugins for active database access to the Wiki pages e g display of general page Meta data author edit history etc Highly customisable Typo3 extension Draft Version 1 20 Page 11 File fidis wpl dell 3 manual_ex
27. mmary in the small field below the edit box This text should describe the changes done to a page for the benefit of other editors After that the Preview function ALT p allows the user to see how the changed document will look If necessary additional changes can be applied to the preview version By pressing the Save button or ALT s the changes will be written to the data repository and immediately applied to the article The cancel Exit link on the other hand will abort the editing of a page and will leave the data untouched MediaWiki is the Wiki used for the Wikipedia project Please visit www mediawiki org wiki MediaWiki for further details Draft Version 1 20 Page 14 File fidis wp1 dell 3 manual_extended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 4 Simple usage scenarios Given below are three simple examples demonstrating a small amount of the Wiki s functionality Further markups beyond those shown here are given in section 6 4 1 Case 1 Create a new page Summary When editing an existing article or if a word or phrase ought to have an article of its own linked in just put it in double square brackets like this This is the first step to create a new page By clicking on the new link one will reach a new empty Wiki page The page title is automatically set to the text used in the double square brackets Method Navigate to the tex
28. n on line wrapping editor field True or false By default this option is false Define the number of characters in the Summary characters summary field 7 2 4 Advanced Settings TOC Settings Editor Settings Advanced Settings Adu Set template for DR Wiki ml HTML HTM TMPL Durcheucher Make the Wiki read only no editing permitted a Deactivate caching of wiki pages C Target for external links Default _blank 1 Turn off image links a Figure 7 Advanced settings Set template for DR Wiki Use this field to set an alternative template Activate this button to set the complete Wiki to read only Make the Wiki read only True or false By default this option is false and so the Wiki is editable Deactivate caching of Wiki This function deactivates the pre rendering of Wiki pages pages True or false By default this option is false Choose between self parent top Default configuration is Target for external links blank displays external link in a new window Draft Version 1 20 Page 30 File fidis wpl dell 3 manual_extended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 Toggles the inclusion of a link image True or false By default this option is false Turn off image links 7 2 5 Redirect Settings General Settings TOC Settings Editor Settings Advanced Settings Redirect Settings Red Redirect to l
29. nd printers Typo3 Typo3 is a free open source content management system written with PHP and MySQL for enterprise purposes on the web and in intranets It is available for free and licensed under the GNU General Public License It offers full flexibility and extendability while featuring an accomplished set of ready made interfaces functions and modules Draft Version 1 20 Page 35 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 10 References Terdiman D 2005 Esquire wikis article on Wikipedia CNET News com September 29 2005 http news com com Esquiret wikistarticleton Wikipedia 2 100 1038 3 5885171 html Royer D 2005 How to cope with Complexity The usage of Typo3 for Research Projects Proceedings of the 1 TYCON3 conference Karlsruhe Germany 2005 Various 2005 Typo3 core documentation http typo3 org documentation document library doc_core_inside Draft Version 1 20 Page 36 File fidis wpl dell 3 manual_extended_wiki doc
30. ogin page if nat logged in on edit Red Page to use if redirecting is active TR FC Bigfeet Seite Figure 8 Redirect settings If this option is set the user will be redirected to a login or information page if he or she is not logged in and tries to edit a Wiki page True or false By default this option is false Redirect edit user to login page if not logged in Page that is used for the redirect Redirect edit user needs to be set Default value is the page where the extension is installed Page to use if redirecting is active Draft Version 1 20 Page 31 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 8 Annex IV DR_Wik Change Log 8 1 Version 1 2 e Added DBAL patch provided by Henning Schild 8 2 Version 1 1 e Added templating capabilities for Wiuki Templates which can be inserted automatically in the Wiki editor This feature can be configured in the FlexForm of dr wiki e Minor fixes in the rendering engine 8 3 Version 1 0 0 LLES A e Fixed another issue with regard to the rendering of internal links e Added template support for Wiki pages introducing the namespace Template to store the templates e g myTemplate references Template myTemplate e Added more variables providing additional Wiki information see manual for details e Fixed redirect if a redirect is set to a non exis
31. ormation Society No 507512 5 Conclusion and Outlook Considering the features and options offered by the Wiki extension it is clear that the work of the various FIDIS Workpackages can now be facilitated in a more convenient and effective fashion Furthermore the dissemination of the internal FIDIS Wiki onto the public FIDIS website deliverable D2 7 can be easily implemented by utilising this tool specifically with its read only feature The FIDIS Wiki engine itself will be continually maintained and developed by WPI especially since its requirements will need to change as the dynamic FIDIS project evolves l Details about the methodology used for the FCI can be found in Royer D 2005 Draft Version 1 20 Page 18 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 6 Annex I Markups 6 1 General Formatting Markups In order to format the content entered into DR Wiki the following markups can be used A single newline generally has no effect on the layout These can however be used to separate sentences within a paragraph Some editors find that this aids editing and Paragraphs lt p gt improves clarity when utilising the diff tool used by the editors to compare different versions of a page see section 4 3 An empty line starts a new paragraph Creates a bulleted list such as e item 1 Creates a numbered list such as l item 1 l
32. rr amp hArr amp rarr amp harr Draft Version 1 20 Page 24 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 6 4 Rendering of tables Tables can be rendered ici cc the following syntax pipe syntax Creates a new table A table is defined by params which is the same as the HTML lt table params gt Insert non formatted text here lt table gt Please note You must include the space between and params else the first parameter is ignored Create borders Furthermore most of the standard HTML table border 1 n parameters work for Wiki tables too e g cellspacing cellpadding bgcolor etc Caption Creates a caption for the table lt caption gt Caption lt caption gt Creates a header cell lt th gt Functions the same way as lt td gt params celll except is used instead of the opening can be used instead of Fl Creates a new row lt tr gt 6 5 Table Examples A simple example for a table using the Wiki markups border 1 j bgcolor red celll width 300px bgcolor blue cell2 bgcolor green cel13 This will result in the following table cell A more complex example using a nested table border 1 alpha bgcolor ABCDEF border 2 nested Draft Version 1 20 Page 25 File fidis wpl dell 3 manual_extended_wiki doc FI DIS D1 3
33. rsions of this document can be found at the FIDIS NoE website at www fidis net Draft Version 1 20 Page 2 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 Members of the FIDIS consortium File fidis wp1 dell 3 manual_extended_wiki doc 1 Goethe University Frankfurt Germany 2 Joint Research Centre JRC Spain 3 Vrije Universiteit Brussel Belgium 4 Unabhdangiges Landeszentrum fiir Datenschutz Germany 5 Institut Europeen D Administration Des Affaires INSEAD France 6 University of Reading United Kingdom 7 Katholieke Universiteit Leuven Belgium 8 Tilburg University Netherlands 9 Karlstads University Sweden 10 Technische Universitat Berlin Germany 11 Technische Universit t Dresden Germany 12 Albert Ludwig University Freiburg Germany 13 Masarykova universita v Brne Czech Republic 14 VaF Bratislava Slovakia 15 London School of Economics and Political Science United Kingdom 16 Budapest University of Technology and Economics ISTRI Hungary 17 IBM Research GmbH Switzerland 18 Institut de recherche criminelle de la Gendarmerie Nationale France 19 Netherlands Forensic Institute Netherlands 20 Virtual Identity and Privacy Research Center Switzerland 21 Europ isches Microsoft Innovations Center GmbH Germany 22 Institute of Communication and Computer Systems ICCS Greece 23 AXSionics AG Switzerland 24 SIRRIX AG Security Technologies Germany Dra
34. t passage where you would like to add a link to a new page and click on the edit button to enter the Wiki editor HORS FRESE SRE Choose one or a few words and put them into double square brackets This creates a link to the new page After that press the save button or ALT s to preserve summary Cancel Exit the changes Negue porro quisquam est The automatically generated question mark by the new I link indicates that the link refers to an empty page Open this empty page by clicking on the link and then fill the new page with content Sample Wiki Workpad The page title is the text typed into the double square pia brackets when making the link At the bottom of the BIZDA ie editing screen you have space to write a short summary see eee ine qui ca scan itis caw about what you have done This summary will be a tema displayed in the page history and is useful for other editors Press the save button and the new page in this a example porro quisquam will be created The EE cancel ewt automatically generated question mark by the porro quisquam link on the previous page will disappear Draft Version 1 20 Page 15 File fidis wpl dell 3 manual_extended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 4 2 Case 2 Create a Redirect Summary Redirects are used to refer to other pages If a user tries to access a page containing a redirect he or she will be automatically
35. tended_wiki doc FI DIS D1 3 Future of Identity in the Information Society No 507512 3 General User Manual 3 1 A Basic Wiki Page When opening a web page containing the DR_Wiki extension one will find the following four general components sample Wiki Workpad Article exemplary title Discussion A ah AL e Lorem ipsum dolor sit amet consectetur adipisicing elit sed do eiusmod tempor incididunt ut labore et dolore magna aliqua Ut enim ad minim veniam quis nostrud exercitation ullamco arn 2 nisi ut aliquip ex ea commodo consequat Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur Excepteur sint occaecat cupidatat non proident sunt in culpa gui officia deserunt mollit anim id est laborum 4 Last changed 01 11 2005 10 44 CID by Andr Deuker 90 amp e Figure 2 Sample Wiki page of the DR_Wiki extension 1 The headline including the page title and a link to the discussion of the current page By clicking on the Discussion link on top of a page the corresponding talk page which contains comments about the page from other Wiki users will be opened If a corresponding talk page exists a will be displayed on the right of the discussion link on top of the page 2 The actual page content 3 The Wiki toolbar providing the basic functions such as o fi The home link taking the user back to the entry pag
36. ting page In this case the creation of a new page will be initiated e Updated the diff view Now both versions will be displayed for better usability e Fixed the creation of the Search lists if no item is found e Extended the search plug in e Added plug in for displaying the available templates 8 4 Version 0 9 1 e Removed a bug in the rendering of internal links if a namespace is referenced thx to Els Soenens for reporting 66 99 is present but no actual 8 5 Version 0 9 e Added diff function for comparing old page versions to the most up to date version e Added redirect to login page option if a non logged in user tries to edit a Wiki page see FlexForm configuration 8 6 Version 0 8 1 e Solved an SQL query issue resulting in corrupted queries e Added _ NOTOC__ and _NONUMBERHEADINGS __ directives for page markups and TOC manipulation 8 7 Version 0 8 e Added more options to the FlexForm configuration of the Wiki editor e Added tooltips and shortcuts to the Wiki page editor and the editor toolbar Draft Version 1 20 Page 32 File fidis wp1 dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 e Updated the extension s template e General code cleanup and removal of unused functions e Added enhanced internal links Mediawiki style e Added signatures for discussions e Added Wiki variables displaying Meta info or date time functions
37. ures general development notes the user manual and so on of the Wiki implementation used for the FIDIS project The software itself is based on the Typo3 extension framework The resulting custom Typo3 extension is called DR_Wiki and is published under the GNU General Public Licence GPL Currently there are about 2000 installations of this extension available on the Internet http www wikipedia org See www gnu org copyleft gpl html for details According to the Typo3 Extension Repository TER available at typo3 org extensions Draft Version 1 20 Page 7 File fidis wpl dell 3 manual_extended_wiki doc FIDIS D1 3 Future of Identity in the Information Society No 507512 2 Introduction 2 1 What is a Wiki A Wiki is an online collaborative information system infrastructure in which a community of users or small groups can create content edit it and make this content available to a large audience In today s digital world Wikis are widely used to support the collaborative construction of large general encyclopaedias e g Wikipedia the knowledge sharing of small groups or communities working on a specialised topic or the collaborative authoring of documents On the technical side Wikis are based on a Wiki software component that allows users to very easily create edit and link Web page using a standard Web browser Single pages in a Wiki are referred to as a Wiki page while the entire bo
Download Pdf Manuals
Related Search