Handleiding OpenOrg.nl
1. Inleiding OpenOrg.nl is een wiki, een webtoepassing waarmee webdocumenten gezamenlijk kunnen worden bewerkt. Meerdere personen kunnen elkaars documenten en bijdragen aanvullen en wijzigen. De specifieke wiki-software die we gebruikt hebben voor OpenOrg.nl is de open source variant genaamd PmWiki. Hieronder wordt uitgelegd hoe je binnen de speciale stylesheet van OpenOrg.nl onderwerpen aan kunt maken. Maar voor meer uitgebreide informatie over het werken met deze PmWiki, zijn er de volgende links: De homepage van de PmWiki community: http://pmwiki.org/ Help-sectie van PmWiki: http://www.pmwiki.org/wiki/cookbook/cookbook Tekstopmaak tips: http://www.pmwiki.org/wiki/pmwiki/basicediting 2. Algemeen Alle informatie in de OpenOrg wiki is ondergebracht in categorieën. Het is mogelijk om paginaʼs te kiezen voor meerdere categorieën. Hierdoor kunnen gebruikers van de wiki op verschillende manieren documenten opsporen. Rechtsboven op de pagina zie je de knoppen ʻhistoryʼ, ʻeditʼ, ʻattachʼ. De ʻhistoryʼ-knop verwijst naar een overzicht van werkzaamheden aan de wiki in chronologische volgorde. Via de ʻeditʼ-knop kun je de pagina waarop je je bevindt wijzigen / aanvullen. Met ʻattachʼ kun je plaatjes en documenten op onze server zetten. Later kun je dan in je hypertext verwijzen naar dit plaatje of desbetreffend document en die worden dan op de pagina getoond. Alle documenten op de website worden aangeboden onder een Creative Commons Licentie, nl. de licentie Naamsvermelding-Niet Commercieel Gelijk delen 3.0 Nederland. Dit wil zoveel zeggen dat mensen gebruik kunnen maken van de documenten en de documenten mogen aanpassen zolang ze vermelden wie de maker is en ze er geen geld mee verdienen. 2
3. Pagina aanmaken Je kunt niet zomaar een nieuwe pagina aanmaken. Het idee achter een wiki is dat de informatie onderling verweven is. Dit is (nog) niet altijd het geval, wanneer je een lemma aanmaakt. Hierdoor moet je een omweggetje nemen om een onderwerp aan te maken. Onder ʻContributieʼ in het navigatiemenu vindt je de clickable link naar de ʻDocumentenlijstʼ. Door hierop te klikken ga je naar een pagina die ertoe dient om lemmaʼs, die je aan wilt maken, in te voeren. Invoeren geschiedt door op de ʻeditʼ knop rechtsboven in het venster te klikken. Hierna opent zich een bewerkveld waarin je de titel van de nieuwe pagina tussen dubbele rechte haken plaatst: [[onderwerp]] Door de toevoeging op te slaan verschijnt het ʻonderwerpʼ als een link met een vraagtekentje op het scherm. Door daar weer op te klikken ga je naar de edit-pagina van het desbetreffende onderwerp en kun je aan de slag met het vullen van de pagina. 4. Pagina opmaken De wiki is een hyperflexibel systeem waarmee je informatie op tal van manieren kunt opmaken. Omdat het oog ook wat wil, hebben we een vast opmaakstramien (een stylesheet) ontwikkeld, waarbij je plaatjes en extra opmerkingen in kunt vullen. Dit hoef je niet perse te gebruiken. Je kunt alle info ook gewoon als volgt erop gooien, waarbij je i.p.v. de gemarkeerde tekst je eigen verhaal schrijft: (:Title Pagina titel:) categorie: [[!Categorie1]], [[!Categorie2]] De tekst die op de pagina moet, waarbij je links naar een [[nieuwe pagina]] of een [[bestaande pagina]] aangeeft met dubbele rechte haken openen en sluiten. Attach:bijlage.xls \\ Attach:bijlage.pdf Er zijn geen werkbalk-knoppen bijvoorbeeld voor vetgedrukt, schuingedrukt, onderstreept, inspringen e.d. Alle opmaak geschiedt met speciale codes. Verderop vind je de belangrijkste codes op een rijtje, maar eerst uitleg over de stylesheet van OpenOrg.nl: 3
Er zijn 3 stijlen aangemaakt, waarvan er twee door >>stijlnaam<< geopend worden en door >><< gesloten worden. de stijl >>col2<< is een stijl voor het uitlijnen van plaatjes in de tekst de standaard stijl van de tekst van het onderwerp, volgt automatisch na het afsluiten van de stijl ʻcol2ʼ. De stijl >>opmerkingen<< onder de infotekst en gescheiden door een witte streep, die gebruikt kan worden voor aanvullende info en verwijzigen buiten de wiki. In onderstaande veld is precies aangegeven welke codes je dient te gebruiken om de juiste stylesheets te activeren. De geel gemarkeerde tekst kun je vervangen. (:Title Pagina titel:) categorie: [[!Categorie1]], [[!Categorie2]] >>col2<< Attach:plaatje.jpg >><< De tekst die op de pagina moet, waarbij je links naar een [[nieuwe pagina]] of een [[bestaande pagina]] aangeeft met dubbele rechte haken openen en sluiten. Attach:bijlage.xls \\ Attach:bijlage.pdf ---- >>opmerkingen<< Opmerking:\\ Mocht je nog aanvullende informatie hebben en door willen verwijzen naar een [[onderwerp]]\\ \\ Meer info:\\ %newwin%[[hyperlink omschrijving hyperlink]]\\ \\ Thanks to:\\ Optionele mogelijkheid om iemand te bedanken o.i.d. >><< 5. Uploaden van documenten De documenten, die je als download aan wilt bieden, moeten eerst apart ge-upload worden. Als tweede stap dien je in je wiki-tekst te verwijzen naar het document dat je op de server hebt gezet. Hoe gaat dit precies in zijn werk? Ga naar het artikel in de wiki waarbij je een document wilt toevoegen. Rechtsboven in het venster vind je de knop ʻattachʼ. Door hierop te klikken kom je in het zgn. Upload-venster dat bij de desbetreffende pagina hoort. Via de knop ʻBladerenʼ kun je het document op je eigen computer selecteren. Deze knop bevindt zich achter het veld met Te verzenden bestand. Vul in het veld Bijlage bewaren als: de naam in van het document (bijv. urenoverzicht.xls) en klik op ʻVerzendʼ. 4
Om het document tevoorschijn te toveren in je wiki-artikel type je simpelweg ʻAttach:bestandsnaam.extensieʼ. Ofwel: Attach:urenoverzicht.xls 6. De belangrijkste codes in OpenOrg stylesheet (:Title paginatitel :) Titel van de pagina [[woord]] Hyperlink! Categorie [[!catergoriex]] Betekent dus: linkt door naar categorie x >>col2<< Openen ʻcolumn 2ʼ, stijlopmaak voor plaatje aan rechterkant pagina Attach:paatje.jpg Verwijzing naar via attach knop aan de rechter bovenzijde van het scherm ge-upload plaatje met de naam ʻplaatje.jpgʼ. Afmetingen plaatje = 170 pixels breed Bestandsformaten:.jpeg,.gif,.png >><< Sluiten stijlopmaak voor plaatje aan rechterkant pagina \\ witregel (enter) Attach:bijlage.xls Verwijzing naar downloadable document getiteld ʻbijlage.xlsʼ dat al via ʻattachʼ functionaliteit op de server is gezet. ---- Witte lijn in pagina >>opmerkingen<< Open stijlopmaak ʻopmerkingenʼ, i.e. de tekst onderaan de pagina (italic / times) %newwin% [[link omschrijving link]] Open link in een nieuw venster Voor verwijzingen naar webpaginaʼs buiten de wiki kunnen ook de dubbele rechte haken gebruikt worden, die dan voor en achter het [[webadres]] staan. Door het webadres middels een rechte streep ( ) te scheiden van een hierop volgende omschrijving van de website, kun je lange hyperlinks ook wat netter weergeven >><< Afsluiten stijl ʻopmerkingenʼ, i.e. de tekst onderaan de pagina (italic / times) 7. Overige velden Samenvatting Auteur Hiermee beschrijf je kort de aanpassing / toevoeging en kan men in de History section makkelijk zien wat er toegevoegd is. Initialen invoegen 5
8. Overige tekstopmaak regels Paragraaf voor een nieuwe paragraaf, druk 2 keer op de Enter toets; -> inspringen * puntenlijst # genummerde lijst ''woord'' woord (italics) '''woord''' woord (bold) '''''woord''''' woord (italics + bold) [[hyperlink]] hyperlink weergegeven zoals tussen haakjes [[hyperlink omschrijving]] hyperlink weergegeven zoals omschreven na teken (= staande streep)!,!!,!!! voor koppen met verschillende niveauʼs ---- horizontale lijnen [+...+] groter formaat tekst [-...-] kleiner formaat tekst [=...=] voorkom opmaak \\ of [[<<]] nieuwe regel 6