1 19:31 <+RawChid> Is goed laten we dan maar beginnen.
2 19:31 <+RawChid> Welkom allemaal bij de workshop Werken met de Wiki.
3 19:32 <+RawChid> Deze workshop wordt gegeven in #ubuntu-nl-mwanzo-klas en vragen kunnen gesteld worden in #ubuntu-nl-mwanzo.
4 19:32 <+RawChid> Het eerste gedeelte zal ik vooral vertellen over wiki's. En bij het tweede gedeelte gaan we zelf aan de slag.
5 19:32 <+RawChid> = Wat is wiki =
6 19:33 <+RawChid> Een wiki is een website van verschillende gekoppelde pagina's welke door iedereen aangepast en aangemaakt kunnen worden.
7 19:33 <+RawChid> De ontwikkelaar van de eerste wiki-software beschreef het als "de eenvoudigste online database die mogelijk zou kunnen werken".
8 19:33 <+RawChid> Wiki is trouwens een Hawaiiaans voor snel.
9 19:34 <+RawChid> Het aanpassen van pagina's wordt gedaan in een vereenvoudige opmaaktaal of in een zogenaamde WYSIWYG-editor.
10 19:34 <+RawChid> Hier zal ik later wat meer over vertellen
11 19:35 <+RawChid> Wiki's zijn onder andere handig voor websites van een gemeenschap, intranet of kennisbeheer binnen organisaties.
12 19:35 <+RawChid> Zoals je merkt kun je een wiki voor veel verschillende doeleinden gebruiken.
13 19:35 <+RawChid> Daarom kun je wiki-software tegenwoordig in allerlei soorten en maten vinden.
14 19:35 <+RawChid> Sommige zijn erg specifiek gericht op 1 bepaald doel, andere weer wat algemener in gebruik.
15 19:36 <+RawChid> De syntax (of wiki-taal) kan ook verschillen per wiki-software. Maar meestal zijn ze in grote lijnen hetzelfde.
16 19:37 <+RawChid> == MoinMoin ==
17 19:37 <+RawChid> Ik zal deze workshop vaker spreken over "onze wiki". Hiermee bedoel ik dan de wiki op wiki.ubuntu-nl.org
18 19:37 <+RawChid> Op wiki.ubuntu.com en onze wiki wordt er gebruik gemaakt van MoinMoin.
19 19:38 <+RawChid> MoinMoin is een wiki-software gebouwd in Python.
20 19:38 <+RawChid> Zoals eerder gezegd kan de syntax per wiki-software verschillen. Daarom zullen we ons vanaf nu geheel richten op MoinMoin en haar syntax.
21 19:38 <+RawChid> Trouwens, Moinmoin is ook een Nigeriaanse gestoomde bonenpudding: http://en.wikipedia.org/wiki/Moin_moin
22 19:39 <+RawChid> = Wiki taal =
23 19:39 <+RawChid> Ik heb verteld dat je een wiki vaak kunt bewerken met een WYSIWYG-editor, of doormiddel van een opmaaktaal.
24 19:40 <+RawChid> == opmaaktaal ==
25 19:40 <+RawChid> Bij een opmaaktaal kun je bijvoorbeeld denken aan HTML.
26 19:40 <+RawChid> Dit houdt in dat je in het bronbestand de tekst kan opmaken met codes, en in de browser zie je hoe het er daadwerkelijk uit komt te zien.
27 19:40 <+RawChid> Een wikitaal is meestal wel een stuk simpeler dan HTML.
28 19:41 <+RawChid> == WYSIWYG editor ==
29 19:41 <+RawChid> WYSIWYG staat voor What You See Is What You Get (wat u ziet is wat u krijgt)
30 19:41 <+RawChid> Als je hier een stukje tekst dikgedrukt wilt maken, selecteer je dat, en drukt op een knop of sneltoets, en je krijgt gelijk te zien hoe de tekst eruit hoort te zien.
31 19:42 <+RawChid> Denk hierbij aan OpenOffice Writer of Word.
32 19:42 <+RawChid> Op onze wiki kun je helaas geen gebruik maken van een WYSIWYG-editor, dus je zult met de opmaaktaal aan de slag moeten.
33 19:43 <+RawChid> Veel basisdingen kun je terugvinden op de pagina: http://wiki.ubuntu-nl.org/community/WerkenMetDeWiki
34 19:43 <+RawChid> hannie gaf net ook een hele handige link: http://wiki.ubuntu-nl.org/HelpOnMoinWikiSyntax#TableofContents
35 19:43 <+RawChid> Vooral in het begin heb je hier veel aan
36 19:44 <+RawChid> == Voorbeeld ==
37 19:44 <+RawChid> Ik heb een simpel voorbeeld gemaakt op: http://wiki.ubuntu-nl.org/SimpelePagina
38 19:45 <@leoquant> erkan^> is wiki gebaseerd op HTML 4.01 ?
39 19:45 <+RawChid> Kunnen jullie deze link even openen?
40 19:45 <+RawChid> erkan^, een wiki bewerken doe je in een opmaaktaal die een stuk simpeler is dan HTML.
41 19:46 <+RawChid> De wiki software maakt hier uiteindelijk wel HTML van, die weer netjes door je browser weergegeven kan worden
42 19:46 <+RawChid> Het is dus niet speciaal gebaseerd op HTML 4.01
43 19:46 <+RawChid> Ik ga nu die opmaaktaal uitleggen
44 19:47 <+RawChid> Dan wordt het misschien wat duidelijker
45 19:47 <+RawChid> Hebben jullie de link die ik net gaf geopend?
46 19:47 <+RawChid> Om te bekijken hoe de broncode van deze pagina eruit ziet kun je linksboven klikken op: Bewerken
47 19:47 <+RawChid> Mocht je nog geen account hebben, dan is hier een screenshot van wat je zou moeten zien: http://wiki.ubuntu-nl.org/community/mwanzo/Workshop/WikiInleiding/Les1?action=AttachFile&do=view&target=edit-wiki.png
48 19:48 <+RawChid> Eerst zal ik het scherm uitleggen wat je te zien krijgt, en daarna ga ik in op de inhoud van de pagina (de opmaaktaal).
49 19:48 <+RawChid> == De editor ==
50 19:48 <+RawChid> Bovenaan zie je vier knoppen.
51 19:48 <+RawChid> De eerste twee zijn het belangrijkst, "Wijzigingen opslaan" en "Proeflezing".
52 19:49 <+RawChid> De eerste hoef ik hopelijk niet uit te leggen.
53 19:49 <+RawChid> De knop "Proeflezing" is erg handig! Deze laat je zien hoe je tekst eruit komt te zien wanneer je op "Opslaan" klikt.
54 19:49 <+RawChid> Het is belangrijk dat je met deze knop altijd je wijzigingen controleert voordat je daadwerkelijk opslaat
55 19:50 <+RawChid> Onder die knoppen staat de editor. Dit is een tekstvak met de broncode van de betreffende wiki-pagina.
56 19:50 <+RawChid> Is iedereen bij?
57 19:50 <@leoquant> RawChid, 1 vraagje, kan iedereen inloggen cq bewerken?
58 19:50 <+RawChid> Iedereen die een account heeft kan inloggen
59 19:51 <+RawChid> Oh, ik zie dat ze deze niet mogen bewerken natuurlijk
60 19:51 <+RawChid> Ik zal de pagina even verplaatsen zodat iedereen op bewerken kan klikken
61 19:52 <+RawChid> http://wiki.ubuntu-nl.org/community/SimpelePagina
62 19:53 <+RawChid> OKe, ik ga weer verder
63 19:54 <+RawChid> Onder de editor is een tekstveld om commentaar in te vullen. Dit veld is niet verplicht.
64 19:54 <+RawChid> Als je problemen hebt met die pagina, open dan gewoon de screenshot.
65 19:54 <+RawChid> Ik licht nu alleen even toe wat de knoppen enzo betekenen
66 19:54 <+RawChid> Onder de editor is een tekstveld om commentaar in te vullen. Dit veld is niet verplicht.
67 19:54 <+RawChid> Toch wordt het erg gewaardeerd als je hier beknopt neerzet wat je hebt veanderd. Dan is het later ook duidelijker te zien wat waar en wanneer is veranderd.
68 19:55 <+RawChid> De opties op de volgende regel laat ik nu even buiten beschouwing.
69 19:56 <+RawChid> Onderaan zie je een groot vlak met wat voorbeelden hoe je tekst kunt opmaken. (dikgedrukt, schuingedrukt, etc)
70 19:56 <+RawChid> De 2 links onderaan (rood) geven je een schat aan informatie en voorbeelden hoe je tekst kunt opmaken. Vooral in het begin kun je hier veel van leren.
71 19:56 <+RawChid> Verder is erg leerzaam om veel af te kijken. Als je bijvoorbeeld iets wilt maken, en je hebt het eerder gezien. Kopieer het stukje tekst van die pagina en pas het aan op je eigen pagina.
72 19:57 <+RawChid> == Opmaaktaal ==
73 19:57 <+RawChid> Nu genoeg over het scherm. Ik zal uitleggen hoe die opmaaktaal nou werkt...
74 19:57 <+RawChid> De eerste regel begint met ## Commentaar: ...
75 19:58 <+RawChid> Elke regel die begint met ## is commentaar en is alleen te zien in de broncode.
76 19:58 <+RawChid> Commentaar zie je alleen als je de bron bekijkt
77 19:58 <+RawChid> Als je de pagina zelf bekijkt in de wiki zie je deze regel dus niet.
78 19:58 <+RawChid> Is dit duidelijk?
79 19:59 <+RawChid> Vervolgens zie je een regel die begint met =
80 19:59 <+RawChid> Dit is een titel (of koptekst)
81 19:59 <+RawChid> Je kunt een koptekst maken door het tussen = = te zetten.
82 19:59 <@leoquant> <erkan^> betekent # (br) ?
83 19:59 <+RawChid> Nee
84 20:00 <+RawChid> De wiki is erg streng met spaties enzo. Let er dus op dat de regel begint met = en ook eindigt met een =.
85 20:00 <+RawChid> Als er maar een spatie voor of achter staat zie je dat de wiki er geen titel van maakt, maar gewoon de tekst afdrukt.
86 20:01 <+RawChid> Een stelletje pubers hebben al ontdekt hoe je de wiki wijzigt :P
87 20:01 <+RawChid> heeft*
88 20:02 <+RawChid> Op de volgende regel zie je: == 1.1. Een subtitel ==
89 20:02 <+RawChid> Dit is een kop2 tekst, dus een subtitel van die andere.
90 20:02 <+RawChid> De wiki maakt hier dan ook een iets kleiner lettertype van.
91 20:03 <+RawChid> Vervolgens zie je nog gewone, vet- en schuingedrukte tekst.
92 20:03 <+RawChid> Die nummers zijn niet verplicht FOAD
93 20:03 <+RawChid> Je kunt ook automatisch een inhoudsopgave laten tonen, deze bedenkt er dan zelf nummertjes bij. Maar dat is iets voor later
94 20:04 <+RawChid> = Aan de slag =
95 20:04 <+RawChid> Ik denk dat het nu wel tijd wordt dat we even zelf aan de slag gaan.
96 20:04 <+RawChid> Als je rechtsbovenin op je naam klikt, kom je op jouw homepage terecht.
97 20:04 <+RawChid> (als het goed is)
98 20:04 <+RawChid> Helaas is er nog een probleem met de rechten van onze wiki. Dit zorgt ervoor dat je je eigen homepage niet kunt bewerken.
99 20:05 <+RawChid> Voor degene die zich hebben opgegeven op de lijst heb ik een verwijzing ingesteld.
100 20:05 <+RawChid> Mensen die niet op de inschrijflijst staan kunnen even in het andere kanaal vragen aan mij of Cees om de verwijzing in te stellen.
101 20:05 <+RawChid> Heeft iedereen rechtsboven op zijn/haar naam geklikt?
102 20:05 <+RawChid> Als je nog geen homepage hebt, moet je daarna klikken op "Create new empty page".
103 20:06 <+RawChid> De mensen die al eerder een pagina hebben aangemaakt kunnen gewoon op bewerken klikken.
104 20:06 <+RawChid> 20:06:14 <+leoquant> ---- /!\ '''Edit conflict - other version:''' ---- waarom verschijnt dit soms RawChid ?
105 20:06 <+RawChid> Als je een pagina opent om te bewerken, dan vergrendel je deze.
106 20:07 <+RawChid> Als iemand anders de pagina dan opent. Krijgt deze een melding te zien dat de pagina vergrendeld is door gebruikt X
107 20:07 <+RawChid> gebruiker*
108 20:07 <@leoquant> ah ok
109 20:07 <+RawChid> Het is wel zo netjes om dat te wachten tot de pagina weer ontgrendeld is
110 20:08 <+RawChid> Als je dat niet doet, kan het zo zijn dat jullie beiden tegelijk iets wijzigen
111 20:08 <+RawChid> Dan krijg je dus zulke conflicts, en is je pagina vaak verklooid om het zo maar te zeggen
112 20:09 <+RawChid> Let ook op hoe lang deze al vergrendeld is. Als het langer dan een dag is kun je er vanuit gaan dat die andere gebruiker niet meer bezig is
113 20:09 <+RawChid> Als je ergens op bewerkend klikt, is het dus ook handig om op annuleren te klikken als je niets ermee doet.
114 20:10 <+RawChid> Want als je op bewerken klikt vergrendel je de pagina gelijk
115 20:10 <+RawChid> Ik stel voor dat iedereen dus even iets op zijn/haar homepage zet
116 20:10 <@leoquant> erkan^> het lukt neit met ##
117 20:10 <+RawChid> Is er iemand waarbij het niet lukt?
118 20:11 <+RawChid> Wat lukt er niet met ## ?
119 20:11 <+RawChid> http://wiki.ubuntu-nl.org/community/tmp/erkan?action=raw
120 20:11 <+RawChid> Als je regel begint met ##, wordt deze niet weergegven
121 20:11 <+RawChid> erkan^: heeft nu dus alleen commentaar
122 20:11 <+RawChid> Je kunt al die ## weghalen
123 20:12 <+RawChid> Is het nu duidelijk erkan^ ?
124 20:13 <+RawChid> Oke, nu zal ik even uitleggen hoe links werken
125 20:13 <+RawChid> Je kunt linken naar interne pagina's door ze tussen blokhaken te zetten [[ ]]
126 20:13 <+RawChid> Zet bijv. dit in je pagina:
127 20:14 <+RawChid> [[Rachid]] geeft een workshop
128 20:14 <+RawChid> Is het toevoegen van een link gelukt?
129 20:15 <@leoquant> hannie> RawChid, het kan toch ook zonder {}
130 20:15 <@leoquant> <hannie> *[]
131 20:16 <+RawChid> Dat kan wel als je een volledige URL invult (met http:// )
132 20:16 <+RawChid> Dan maakt de wiki er automatisch een klikbare link van
133 20:16 <+RawChid> Het is alleen afgeraden om volledige URL's te gebruiken wanneer je naar pagina's op onze wiki verwijst
134 20:16 <+Cees> Of zonder [] als de link in WikiFormaat is (mix van HoofdenKleineLetters dus)
135 20:16 <@leoquant> <erkan^> ik wil een tekst wijzigen, maar het blijft nog steeds:..........hoe komt dat?
136 20:17 <+RawChid> De structuur van de wiki kun je vergelijken met de mappen op je computer
137 20:18 <+RawChid> Een nieuwe pagina aanmaken kan trouwens door gewoon de URL in te typen
138 20:18 <+RawChid> erkan^: als het ff niet lukt kun je bijv. gaan naar http://wiki.ubuntu-nl.org/community/tmp/erkan/test
139 20:18 <+RawChid> En daar even een nieuwe pagina maken
140 20:20 <+RawChid> Je kunt linkt ook nog een naam geven
141 20:20 <+RawChid> Bijvoorbeeld: ik las laatst iets [[http://www.nu.nl/|op deze site]].
142 20:21 <+RawChid> In de wiki zie je dan "op deze site" waar je op kunt klikken
143 20:22 <+RawChid> Als je naar pagina's binnen onze wiki linkt, moet je geen volledige URL's gebruiken (http://)
144 20:22 <@leoquant> we kunnen door
145 20:23 <+RawChid> Als je bijvoorbeeld naar deze URL wilt linken: http://wiki.ubuntu-nl.org/community/Documentatieteam
146 20:23 <+RawChid> Maak je [[ommunity/Documentatieteam|docu team]]
147 20:23 <+RawChid> Maak je [[community/Documentatieteam|docu team]]
148 20:23 <+RawChid> Die eerste had een typfoutje
149 20:24 <+RawChid> hannie, het gaat niet fout. Maar het is minder handig.
150 20:24 <+RawChid> Bijvoorbeeld wanneer de wiki zou verhuizen naar een ander domein, dan kloppen alle links niet meer
151 20:26 <+RawChid> Nu even genoeg over links
152 20:26 <+RawChid> Ik wil jullie nog even wat info meegeven
153 20:26 <+RawChid> Elke keer als je een wijziging aan een wiki doet, doorloop je eigenlijk de volgende stappen:
154 20:26 <+RawChid> 1. De pagina bewerken
155 20:26 <+RawChid> 2. Commentaar invullen
156 20:26 <+RawChid> 3. Klik op proeflezing
157 20:26 <+RawChid> 4. Controleer de veranderingen. Zijn ze goed, ga verder naar stap 5, zo niet ga terug naar stap 1.
158 20:26 <+RawChid> 5. Klik op "Wijzigingen opslaan"
159 20:27 <+RawChid> Sommige wiki-pagina's zijn erg lang
160 20:27 <+RawChid> Ze bevatten lappen tekst, en in die editor in je browser kan dat onverzichtelijk zijn
161 20:27 <+RawChid> Daarom ben ik een grote fan van de add-on ItsAllText
162 20:28 <+RawChid> Dit is een Firefox add-on waarmee je een teksteditor in je browser kunt openen met je favoriete tekst editor op je OS (voor mij gedit)
163 20:28 <+RawChid> Volgens mij is er iets soortgelijks voor Chromium, maar daar ga ik nu even niet op in
164 20:28 <+RawChid> ItsAllText kun je vinden op https://addons.mozilla.org/en-US/firefox/addon/4125/ Dit is echt een aanrader!
165 20:29 <+RawChid> Oke, we naderen nu het einde
166 20:30 <+RawChid> Voor degenen die nog verder willen stoeien zal ik straks nog wel even rondhangen in -mwanzo
167 20:30 <+RawChid> Ik heb alleen nog 1 verzoek
168 20:30 <+RawChid> Bij Ubuntu NL gebruiken we de wiki ook voor agenda's en notulen
169 20:31 <+RawChid> Ik heb hier een tekstbestand met de log van deze klas
170 20:31 <+RawChid> Wie wil deze op de wiki plaatsen?