afbeelding van demeesterroel

Drupal handleiding(en)

Voor de oplettenden onder jullie..
Er is een nieuwe sectie aangemaakt waar binnenkort nederlandstalige drupal handleidingen zullen ondergebracht worden.
Te vinden op http://drupal.be/handleiding of gewoon door te klikken op "Handleiding" in het menu hierboven.

Om de handleiding van Tille te kunnen integreren ben ik op zoek naar iemand die weet hoe je een docbook kan integreren binnen een drupal 5.x site.
Ik weet dat http://www.puregin.org/ bezig is (geweest) met een docbook import module. http://drupal.org/project/bookimport

Auteur: 
demeesterroel
afbeelding van Sutharsan
Door Sutharsan op 6 maart, 2007 - 12:33

Een goed initiatief om een handboek in het Nederlands te maken. Het past goed bij de traininingsinitiatieven om zodoende de drempel voor Drupal in Nederland en België te verlagen. M.i. is het wel belangrijk om de grenzen te bepalen. Willen we ons richten op Site installatie en configuratie, technisch beheer, inhoudelijk beheer, theming, module ontwikkeling, enz.? Beter goede Nederlandstalige informatie over een beperkt aantal onderwerpen dan redelijke informatie over een groot aantal onderwerpen.

Mijn voorkeur gaat uit naar een Nederlandstalige handleiding voor installatie, configuratie en inhoudelijk beheer. Verder aangevuld met verzamelingen van verwijzingen naar de Engelstalige informatie over andere onderwerpen.

-- Sutha

-- Erik

afbeelding van demeesterroel
Door demeesterroel op 6 maart, 2007 - 14:22

Naar de vragen die ik hier meestal zie verschijnen op drupal.be zou ik ook denken dat er vooral vraag is naar
installatie, configuratie en inhoudelijk beheer en als ik ga kijken in de handboeken die nu al online staan dan dekken die wel de lading.

De meesten die komen met meer geavanceerde vragen over module ontwikkeling vinden meestal hun weg wel naar drupal.org, eventueel met een doorverwijzing vanuit onze forums.

Maar over theming ben ik nog niet helemaal uit.
Ik heb gemerkt dat bij mensen die nu op training willen komen dat 1 op 3 vraagt naar theming.
Jammer genoeg ben ik geen grafisch talent en ken ik alleen de basis principes daarvan, dus dat zal maar lichtjes aangeraakt worden tijdens de sessie.

Maar vandaar dat ik toch denk dat we op zoek moeten gaan naar iemand die daar wel beter in thuis is, en die eventueel toch een paar bookpages kan volpennen over hoe je een simpel grafisch design omzet in een drupal theme.
Dus die nood zie ik wel, maar pas op de 2de plaats, als de andere handboeken goed in orde zijn.

Door Passero op 6 maart, 2007 - 16:09

Is het dan niet bijvoorbeeld handig om met een aantal mensen samen te werken aan de handleiding waarbij iedereen een eigen deeltje op zich wil nemen waarin die zich specialiseert.
Zo kan 1 persoon zich richten op 1 onderdeel en dit goed uitdiepen. Op die manier vermijden we ook dat er dubbele documentatie beschikbaar is wat eigenlijk beetje verspilling is.

---------------------
http://blog.yonaweb.be

http://blog.yonaweb.be

afbeelding van demeesterroel
Door demeesterroel op 6 maart, 2007 - 16:54

Naar mijn weten zijn er momenteel 3 mensen bezig met documentatie
Tille op http://tille.xalasys.com/training/drupal/
Passero op http://blog.yonaweb.be
Promes op http://www.handboek.promes.nl/

Yannick,
wil jij dat opnemen met die andere 2 om onderling af te spreken wie dat welk deel doet?

Door Passero op 6 maart, 2007 - 18:50

Ik zal met beide contact opnemen om te zien wie wat kan doen en hoeveel tijd ze hebben om dit te doen.

-----------------------
http://blog.yonaweb.be

http://blog.yonaweb.be

afbeelding van Sutharsan
Door Sutharsan op 28 maart, 2007 - 21:01

Passero, heeft navraag nog iets opgeleverd?
Ook nog advies over structuur gekregen?

-- Sutha

-- Erik

afbeelding van demeesterroel
Door demeesterroel op 6 maart, 2007 - 14:26

De structuur van de handboeken.

Vooral het feit dat we meerdere versies van drupal zullen moeten gaan ondersteunen.

Opties zijn.

A)
4.x
- installatie
- configuratie
- beheer
-- 4.7.x
--- installatie
--- configuratie
--- beheer
5.x
5.0.x
5.1.x
...

B)
installatie
versie1
versie2
configuratie
versie1
versie2
beheer
versie1
versie2

C)
gebruik van taxonomieen.
versies (4.x,4.7.X,5.X,...)
handboek (installatie, configuratie, ..)

D) ??

Door Passero op 6 maart, 2007 - 16:10

Optie A lijkt me het meest logische.
Als mensen dan de structuur zien zullen ze onmiddellijk zien dat ze hun versie moeten kiezen. Zo moet je ook maar 1 maal je versie kiezen. Bij optie 2 zal je per onderwerp nog eens je versie moeten kiezen wat voor meer clicks zal zorgen en dus minder gebruiksvriendelijk is.

---------------------
http://blog.yonaweb.be

http://blog.yonaweb.be

afbeelding van Sutharsan
Door Sutharsan op 6 maart, 2007 - 22:36

Optie A is voor de gebruiker (lees: handboek gebruiker) het meest logisch. Gestructureerd naar de vraag van de gebruiker. Bijv. "Ik het een Drupal 4.7 site en ik wil een gebruiker van mijn site weren". Dan is dan 4.7 > Beheer > ... Doet mij trouwens denken aan de menustructuur van D5.

Zowel optie A als B brengen met zich mee dat delen die voor alle versies gelden of dubbel in het handboek staan, of in een algemeen gedeelte staan. En de gebruiker zich bij de tweede optie maar afvragen "moet ik in 'algemeen' of in 'Drupal 4.7' zijn?"

Misschien dat Optie C het gebruiksgemak kan combineren met eenvoudig onderhoud. Kan een gebuiker filteren op taxonomie? "Ik wil alleen informatie zien die op Drupal 5 betrekking heeft" Delen die voor alle versies gelden krijgen alle versie-tags. Is een algemene pagina niet langer van toepassing voor D6, dan wordt een nieuwe node aangemaakt voor D6, de bestaande node blijft in gebruik voor D5 en D4.7.

Ik realiseer mij dat de opbouw goed doordacht moet worden met gebruiksgemak en onderhoudsvriendelijkheid als criteria. Bestaande documentatie kan hierbij misschien als inspiratie of voorbeeld worden gebruikt.

-- Sutha

-- Erik

Door Passero op 6 maart, 2007 - 23:15

Er zit wat in maar ik ben bang dat je dan van optie meer een search gaat nodig hebben dan een mooie gestructureerde handboek.
Ik denk dat je zonder problemen optie A en C kan combineren. je maakt een structuur die opgegeven is (zoals op drupal.org) maar toch voeg je de nodige tags toe zoals versie en dan kan je een dropdown gebruiken net zoals bij de modules om te kunnen filteren op de juiste module. Dit lijkt me eigenlijk ook wel gebruiksvriendelijk, alleen weet ik niet of het echt realiseerbaar is binnen huidige installatie op drupal.be

---------------------
http://blog.yonaweb.be

http://blog.yonaweb.be

afbeelding van Bart Van Herreweghe
Door Bart Van Herreweghe op 6 maart, 2007 - 22:41

Jullie kunnen misschien feedback vragen aan "tille". Zij heeft hier veel relevante ervaring mee.

Bart Van Herreweghe

Bookmark and Share

Drupal is een geregistreerd merk van Dries Buytaert. | Powered by Pantheon.

Drupal.be/Drupal.nl is de website van de Nederlandstalige Drupalgemeenschap.