| Volgende revisie | Vorige revisieLaatste revisieBeide kanten volgende revisie |
| nl:slackdocs:news [2012/10/30 16:00 (UTC)] – aangemaakt - initiele vertaling (niet compleet) alienbob | nl:slackdocs:news [2012/10/31 12:14 (UTC)] – Vertaald: "Respecteer andermans werk" alienbob |
|---|
| ======= De keuze van de gebruikte software ======= | ======= De keuze van de gebruikte software ======= |
| |
| This Wiki runs the [[http://dokuwiki.org/ | DokuWiki]] software. This choice was made by the initiator of the project, [[wiki:user:alienbob|Alien BOB]]. Basically when setting up a serious wiki there are two choices: [[http://mediawiki.org/ | MediaWiki]] and DokuWiki. [[wiki:user:alienbob|Alien BOB]] has extensive experience with both - running DokuWiki for his own [[http://alien.slackbook.org/ | Slackware knowledgebase]], and running a MediaWiki based knowledgebase for the customer Helpdesk of which he is the teamleader. | Deze Wiki draait op de [[http://dokuwiki.org/ | DokuWiki]] software. Dit was een keus die door de initiator van het project, [[wiki:user:alienbob|Alien BOB]] gemaakt is. In essentie zijn er twee mogelijkheden wanneer een serieuze Wiki opgezet moet worden: [[http://mediawiki.org/ | MediaWiki]] en DokuWiki. [[wiki:user:alienbob|Alien BOB]] heeft uitgebreide ervaring met beide - DokuWiki is de motor van zijn eigen [[http://alien.slackbook.org/ | Slackware kennisbank]], en hij beheert een op MediaWiki gebaseerde kennisbank voor de IT Helpdesk waarvan hij teamleider is. |
| |
| The choice for DokuWiki was made for several reasons; its syntax makes it more suitable for writing documentation as opposed to MediaWiki, which is more general-purpose. Also, DokuWiki is self-contained in a single directory and does not require an SQL database, which makes it highly portable (the intention is to make a "daily snapshot" tarball available for download once the Wiki foundation is complete). The DokuWiki also allows the use of Access Control Lists - a quality control measure which will be implemented after the formation of a proper team of editors (those who are going to be responsible for having high-quality texts while you, the authors, are responsible for the technical content). | De keuze is op DokuWiki gevallen vanwege een aantal redenen: diens eenvoudige syntax maakt het beter geschikt voor het document-gericht schrijven. Dit in tegenstelling tot MediaWiki, dat meer algemeen georienteerd is. Ook is een DokuWiki installatie een onafhankelijk geheel; in een enkele directory en zonder de noodzaak voor een SQL database. Dit maakt dat een DokuWiki installatie gemakkelijk over te brengen is naar een nieuwe server (de intentie is om een "dagelijks snapshot" archief beschikbaar te maken als download wanneer het Wiki fundament compleet is). De DokuWiki kent ook ACL (//Access Control Lists// ofwel granulaire toegangscontrole). Wij zullen hiermee een vorm van kwaliteitscontrole implementeren wanneer we een goed werkend team van //editors// hebben verzameld (dwz de mensen die verantwoordelijk gaan worden voor de kwaliteit van de website en diens artikelen terwijl jullie, de auteurs, verantwoordelijk worden voor de feitelijke inhoud van die artikelen). |
| |
| The Wiki's functionality has been extended with several syntax plugins, which you will find listed at the bottom of the [[wiki:syntax|Wiki syntax]] page. You can follow the links for those plugins if you want to learn what they allow you to do when writing an article. | De basis DokuWiki installatie is inmiddels voorzien van diverse plugins die de syntax mogelijkheden aanzienlijk uitgebreid hebben. Die plugins worden vermeld onder aan de [[wiki:syntax|Wiki syntax]] pagina. Je kunt de link bij deze plugins volgen naar de respectieve websites om daar te weten te komen welke toegevoegde functionaliteit ze bieden voor het schrijven van goede documentatie. |
| |
| ====== Artwork ====== | ====== Beeldmateriaal ====== |
| |
| The artwork used at the moment was created by [[wiki:user:asteroid|asteroid]] who has some more examples of nice graphics on his own user page. \\ The admins asked (and received permission) from Patrick Volkerding to use these modifications of original Slackware artwork here on the Wiki. | Het beeldmateriaal dat momenteel gebruikt wordt voor deze website werd gecreëerd door [[wiki:user:asteroid|asteroid]]. Op zijn eigen Wiki pagina heeft hij nog wat meer aardige voorbeelden van logo's. \\ De admins hebben Patrick Volkerding gevraagd (en ook toestemming gekregen) om deze modificaties van origineel Slackware beeldmateriaal op onze Wiki te mogen gebruiken. |
| |
| ====== Sidebar ====== | ====== Zijbalk ====== |
| |
| To the left of the page you will find a sidebar with several boxes which can be edited (by the admins). Only the "toolbox" box is part of the wiki's //[[https://www.dokuwiki.org/template:monobook | monobook]]// template, and can not be modified. More specifically,modifying the content of that toolbox would make future upgrades a pain. \\ If you have suggestions about entries which should absolutely be in one of those boxes, let us know (use the [[talk:slackdocs:news|discussion page]]). | Aan de linkerkant van de pagina zie je een zijbalk, met daarin een aantal afgebakende blokken. Deze kunnen door de admins worden aangepast. Enkel het "gereeedschappen" blok is standaard onderdeel van de Wiki's //[[https://www.dokuwiki.org/template:monobook | monobook]]// sjabloon, en kan daarom niet worden aangepast. Een verandering in dat blok zou toekomstige upgrades van de Wiki software lastiger maken. \\ Indien je suggesties hebt over pagina-verwijzingen waarvan je vindt dat die absoluut in een van de overige blokken in de zijbalk thuishoren, dan kun je ons dat laten weten via de (engelstalige) [[talk:slackdocs:news|discussie pagina]]. |
| |
| | ====== Aangestuurd door de gemeenschap ====== |
| |
| ====== Community driven ====== | Ook al heeft de Wiki van ons documentatie project een //hostname// in het [[http://slackware.com/ | slackware.com]] domein, dan betekent dat nog niet dat dit project ook door Slackware gecontroleerd of gesponsord wordt. Het gebruik van de domein naam mag beschouwd worden als een goedkeurings-stempel. Dat werd mede in de hand gewerkt door het feit dat dit project gestart is door [[wiki:user:alienbob|Alien BOB]], die een van de leden is van het "Slackware coreteam".\\ De inhoud van de Wiki zal niet gereguleerd worden door enige "//hogere macht//". De inhoud van iedere pagina in deze Wiki wordt volledig bepaald door diens auteur(s) en verdere contributeuren. |
| |
| Even though this documentation site has a hostname in the [[http://slackware.com/ | slackware.com]] domain, that does not mean it is a Slackware-controlled or sponsored project. The use of the domain name is a token of approval, rather. Also, the project was bootstrapped by [[wiki:user:alienbob|Alien BOB]], a Slackware coreteam member.\\ The content of the Wiki will not be controlled by "//higher powers//". The content on any page in this wiki is determined by its author(s) and contributor(s). | ====== Wiki structuur ====== |
| |
| | De basis-structuur van de Wiki wordt onderhouden door de project admins. Daaronder vallen: [[https://www.dokuwiki.org/namespaces | namespaces]], visuele identiteit, toegangscontrole enzovoort. Ook betekent dit, dat de kern //namespaces// "[[slackware:|slackware:]]", "[[slackdocs:|slackdocs:]]" en "[[slackbook:|slackbook:]]" niet gewijzigd kunnen worden tenzij je deel uitmaakt van het editor/admin team. |
| |
| ====== Wiki structure ====== | Suggesties voor veranderingen in de kernstructuur van de Wiki kunnen worden doorgegeven via onze mailing lijst ([[http://lists.alienbase.nl/mailman/listinfo/slackdocs|http://lists.alienbase.nl/mailman/listinfo/slackdocs]]) of door je suggestie achter te laten op de [[talk:slackdocs:news|discussie page]] (engelstalig). //__De feitelijke inhoud van de Wiki wordt door jou bepaald!__// Wij staan open voor goede ideeën die de bestaande structuur (en inhoud) kunnen verbeteren. We zullen geen enkel artikel weigeren in de "[[howtos:|howtos:]]" sectie dat binnen de doelstellingen van deze Wiki valt. |
| | |
| The core structure of the Wiki will be maintained by the site admins. That means: [[https://www.dokuwiki.org/namespaces | namespaces]], visual identity, access controls and the like. It also means that the namespaces "[[slackware:|slackware:]]", "[[slackdocs:|slackdocs:]]" and "[[slackbook:|slackbook:]]" are read-only for everyone except the editor/admin team. | |
| | |
| Ideas for changing the core structure of the Wiki can be submitted through our mailing list ([[http://lists.alienbase.nl/mailman/listinfo/slackdocs | http://lists.alienbase.nl/mailman/listinfo/slackdocs]]) or by editing the [[talk:slackdocs:news|discussion page]]. //__The actual content is all up to you!__// We are open to good ideas for enhancement of the existing structure and content, and will not refuse any article in the "[[howtos:|howtos:]]" section. | |
| |
| ====== Assuring quality ====== | ====== Assuring quality ====== |
| In order to assist the editor with his work, the Wiki implements a mechanism of "publishing a page". This means that the creation of a new page, or editing an existing page, will automatically put that page in "Draft" mode. The "Draft" message will be prominently visible on the page. If you are editing an existing page, then the original (approved) page will remain be visible to visitors of our Wiki. Only the registered users of the wiki (i.e. your fellow authors) will be able to see the draft instead of the approved version. \\ You have to consult one of our editors to get your page revision approved. That action will make it visible to the world. | In order to assist the editor with his work, the Wiki implements a mechanism of "publishing a page". This means that the creation of a new page, or editing an existing page, will automatically put that page in "Draft" mode. The "Draft" message will be prominently visible on the page. If you are editing an existing page, then the original (approved) page will remain be visible to visitors of our Wiki. Only the registered users of the wiki (i.e. your fellow authors) will be able to see the draft instead of the approved version. \\ You have to consult one of our editors to get your page revision approved. That action will make it visible to the world. |
| |
| | ====== Respecteer andermans werk ====== |
| |
| ====== Respect other people's work ====== | Indien een kopie van origineel werk van iemand anders in onze Wiki wordt gebruikt, zullen alle eventuele licenties en copyright bepalingen moeten worden gerespecteerd die aan het originele werk verbonden zijn. \\ De naam van de originele auteur(s) alsmede de originele locatie URL moeten worden genoemd in de voettekst van jouw (wellicht aangepaste) kopie van die tekst. |
| | |
| Whenever other people's content is copied into this Wiki, any license and copyright terms which are applicable to the original content will be respected. \\ The name of the original author(s) as well as the originating URL have to be mentioned in the footer of your (possibly modified) copy of that content. | |
| |
| The content of this wiki is published under a liberal "Creative Commons" license: [[http://creativecommons.org/licenses/by-sa/3.0/ | CC Attribution-Share Alike 3.0 Unported]] . Take this into consideration if you intended to publish copyrighted information here. | De inhoud van deze Wiki wordt gepubliceerd onder een liberale "Creative Commons" licentie: [[http://creativecommons.org/licenses/by-sa/3.0/ | CC Attribution-Share Alike 3.0 Unported]] . Houd dit in de gaten wanneer je van plan bent om materiaal aan de Wiki toe te voegen waarop een copyright rust. |
| |
| ====== Bronnen ====== | ====== Bronnen ====== |
