Belangrijk

Vertalen is een inspanning van de gemeenschap waaraan u deel kunt nemen <translation_guidelines>. Deze pagina is momenteel voor 100.00% vertaald.

19. Appendix: Bijdragen aan deze handleiding

U moet de richtlijnen in deze Appendix volgen om materiaal aan deze cursus toe te voegen. Het is niet toegestaan de voorwaarden in deze Appendix te wijzigen, behalve om ze te verduidelijken. Dat is om er voor te zorgen dat de kwaliteit en consistentie van deze handleiding kunnen worden onderhouden.

19.1. Bronnen downloaden

De bron van dit document is beschikbaar op GitHub. Consulteer GitHub.com voor instructies over hoe het versiebeheerssysteem GIT te gebruiken.

19.2. Indeling handleiding

Deze handleiding is geschreven met behulp van Sphinx, een Python documentgenerator door middel van de opmaaktaal reStructuredText . Instructies over hoe deze gereedschappen te gebruiken zijn beschikbaar op hun respectievelijke sites.

19.3. Een module toevoegen

Een nieuwe module toevoegen:

  1. Maak eerst een nieuwe map (direct onder het bovenste niveau van de map qgis-training-manual) met de naam voor de nieuwe module.

  2. Maak, onder deze nieuwe map, een bestand genaamd index.rst. Laat dit voor nu blanco.

  3. Open het bestand index.rst in de map van het bovenste niveau. De eerste regels daarvan zijn:

    .. toctree::
   :maxdepth: 2

   foreword/index
   introduction/index

Het zal u opvallen dat dit een lijst met namen van mappen is, gevolgd door de naam index. Dit verwijst het index-bestand op het bovenste niveau naar de indexbestanden in elke map. De volgorde waarin zij staan bepaalt de volgorde die zij in het document zullen hebben.

  1. Voeg de naam van uw nieuwe module (d.i. de naam die u aan de nieuwe map gaf), gevolgd door /index, aan die lijst toe, waar u wilt dat uw module zou moeten verschijnen.

  2. Onthoud om de volgorde van de modules logisch te houden, en wel zo dat latere modules zijn gebouwd op de in eerder modules gepresenteerde kennis.

  3. Open het indexbestand van uw eigen module ([naam_module]/index.rst).

  4. Maak, aan de bovenzijde van de pagina, de koptekst voor de module:

    1. schrijf eerst een regel met asterisken (*).

    2. Vervolg deze regel met een regel die de frase voor opmaak Module: bevat, gevolgd door de naam van uw module.

    3. Sluit dit af met nog een regel met hetzelfde aantal asterisken.

    Notitie

    De onderregel en bovenregel zouden niet korter moeten zijn dan de regel die de titel van de module bevat.

  5. Laat hieronder een regel open.

  6. Schrijf een korte alinea die het doel en de inhoud van de module uitlegt.

  7. Laat één regel open en voeg dan de volgende tekst toe:

    .. toctree::
   :maxdepth: 2

   lesson1
   lesson2

    … waar les1, les2, etc., de namen zijn van uw geplande lessen.

Het indexbestand op het niveau van de module zal er zo uitzien dit:

*******************************************************************************
Module: Module Name
*******************************************************************************

Short paragraph describing the module.

.. toctree::
   :maxdepth: 2

   lesson1
   lesson2

19.4. Een les toevoegen

Een les toevoegen aan een nieuwe of bestaande module:

  1. Open de map van de module.

  2. Open het bestand index.rst (hierboven gemaakt in het geval van nieuwe modules).

  3. Zorg er voor dat de naam van de geplande les is vermeld onder de vermelding toctree, zoals hierboven weergegeven.

  4. Maak een nieuw bestand aan in de map van de module.

  5. Noem dit bestand exact hetzelfde als de naam die u heeft vermeld in het bestand index.rst van de module, en voeg de extensie .rst toe.

Notitie

Voor bewerkingsdoeleinden werkt een .rst-bestand exact hetzelfde als een normaal tekstbestand (.txt).

  1. Schrijf de frase voor opmaak Les, gevolgd door de naam van de les, om te beginnen met het schrijven van de les.

  2. Schrijf, op de volgende regel, een regel van is gelijk aan-tekens (=), niet korter dan de titel van de les.

  3. Laat hieronder een regel open.

  4. Schrijf een korte omschrijving van het beoogde doel van de les.

  5. Neem een algemene introductie op voor het onderwerp. Bekijk de bestaande lessen in de handleiding voor voorbeelden.

  6. Begin hieronder een nieuwe alinea, beginnend met deze frase:

    **The goal for this lesson:**

  7. Leg in het kort de bedoelde leerdoelen uit van het voltooien van deze les.

  8. Als u het doel van de les niet kunt uitleggen in één of twee zinnen, overweeg dan om het onderwerp op te delen in meerdere lessen.

Elke les zal worden opgedeeld in meerdere gedeelten, die hierna zullen worden besproken.

19.5. Een gedeelte toevoegen

Er zijn twee typen gedeelten: “follow along” en “try yourself”.

  • Een gedeelte “follow along” is een gedetailleerde verzameling aanwijzingen die zijn bedoeld om de lezer te leren hoe een bepaald aspect van QGIS te gebruiken. Dit wordt over het algemeen gedaan door zo duidelijk mogelijke klik-na-klik aanwijzingen te geven, afgewisseld met schermafdrukken.

  • Een gedeelte “try yourself” geeft de lezer een korte opdracht om zelf te proberen. Het wordt gewoonlijk geassocieerd met een item in het vak met antwoorden eronder, wat zal weergeven of verklaren hoe de opdracht te voltooien, en zal, indien mogelijk, de verwachte uitvoer weergeven.

Elk gedeelte heeft een niveau van moeilijkheid. Een eenvoudig gedeelte wordt vermeld als ★☆☆, gemiddeld door ★★☆, en moeilijk door ★★★.

19.5.1. Een gedeelte “follow along” toevoegen

  1. Vermeld, om dit gedeelte te beginnen, de frase voor opmaak van de bedoelde moeilijkheidsgraad (zoals hierboven weergegeven).

  2. Plaats een spatie en schrijf dan Volgen:.

  3. Plaats nog een spatie en vermeld de naam van het gedeelte (gebruik alleen een hoofdletter aan het begin, en voor eigennamen).

  4. Schrijf, op de volgende regel, een regel van tekens minus/streepjes (-), niet korter dan de titel van het gedeelte.

  5. Schrijf een korte introductie voor het gedeelte, die het doel ervan uitlegt. Geef dan gedetailleerde (klik-na-klik) instructies over de procedure die moet worden gedemonstreerd.

  6. Neem in elk gedeelte de benodigde interne links, externe links en schermafdrukken op.

  7. Probeer elk gedeelte af te sluiten met een korte alinea met een conclusie en die op natuurlijke wijze leidt naar het volgende gedeelte, indien mogelijk.

19.5.2. Een gedeelte “try yourself” toevoegen

  1. Vermeld, om dit gedeelte te beginnen, de frase voor opmaak van de bedoelde moeilijkheidsgraad (zoals hierboven weergegeven).

  2. Plaats een spatie en schrijf dan Probeer zelf:.

  3. Schrijf, op de volgende regel, een regel van tekens minus/streepjes (-), niet korter dan de titel van het gedeelte.

  4. Leg de oefening uit die u de lezer wilt laten voltooien. Verwijs, indien nodig, naar eerdere gedeelten, lessen of modules.

  5. Neem schermafdrukken op om de vereisten te verduidelijken als een heldere tekstuele omschrijving niet duidelijk is.

In de meeste gevallen zult u een antwoord willen verschaffen met betrekking tot hoe de in dit gedeelte vermelde opdracht zou moeten worden voltooid. U zult een blok met antwoorden onder de instructies moeten toevoegen om dat te doen.

  1. Maak eerst het in te klappen widget dat de antwoorden bevat:

    .. admonition:: Answer
   :class: dropdown

  2. Met inspringen om rekening te houden met bovenstaand blok, schrijf de instructies over hoe de opdracht te voltooien, gebruik, waar nodig, koppelingen en afbeeldingen.

19.6. Een conclusie toevoegen

Een les beëindigen:

  1. Schrijf de frase Conclusie, gevolgd door een nieuwe regel van tekens minus/streepjes (-).

  2. Schrijf een conclusie voor de les, die uitlegt welke concepten in de les werden behandeld.

19.7. Een gedeelte Meer informatie toevoegen

Dit gedeelte is optioneel.

  • Schrijf de frase Lees verder, gevolgd door een nieuwe regel van tekens minus/streepjes (-).

  • Neem koppelingen op naar de van toepassing zijnde externe websites.

19.8. Een gedeelte Wat nu toevoegen

  1. Schrijf de frase Wat volgt?, gevolgd door een nieuwe regel van tekens minus/streepjes (-).

  2. Leg uit hoe deze les studenten heeft voorbereid voor de volgende les of module.

  3. Onthoud om het gedeelte “what’s next” van de vorige les indien nodig te wijzigen, zodat die verwijst naar uw nieuwe les. Dit zal nodig zijn als u een nieuwe les tussen bestaande lessen heeft ingevoegd, of na een bestaande les.

19.9. Opmaak gebruiken

U zult standaard opgemaakte tekst zullen moeten toevoegen aan uw tekst om de standaarden van dit document te volgen,

19.9.1. Nieuwe concepten

Als u een nieuw concept uitlegt, zult u de naam van het nieuwe concept cursief moeten schrijven door het te omsluiten met asterisken (*).

This sample text shows how to introduce a *new concept*.

19.9.2. Benadrukken

  • Een cruciale term benadrukken die geen nieuw new concept is, schrijf de term vet door die te omsluiten met dubbele asterisken (**).

  • Gebruik dit spaarzaam! Als u dit teveel gebruikt kan het voor de lezer lijken of u schreeuwt of neerbuigend doet.

This sample text shows how to use **emphasis** in a sentence. Include the
punctuation mark if it is followed by a **comma,** or at the **end of the
sentence.**

19.9.3. Afbeeldingen

  • Bij het toevoegen van een afbeelding, sla die op in een map img naast het bestand met de les.

  • Neem die als volgt op in het document:

    .. figure:: img/image_file.extension
   :align: center

  • Onthoud om een lege regel over te laten boven en onder de opmaak voor de afbeelding.

19.9.6. Mono gespatieerde tekst gebruiken

  • Wanneer u tekst schrijft die de gebruiker moet invoeren, een padnaam, of de naam van een element van een database, zoals een naam van een tabel of kolom, moet u die schrijven in mono gespatieerde tekst. Bijvoorbeeld:

    Enter the following path in the text box: ``path/to/file``.

19.9.7. Items voor de GUI labelen

  • Indien u verwijst naar een item van de GUI, zoals een knop, moet u de naam ervan schrijven in de opmaak voor label van de GUI. Bijvoorbeeld:

    To access this tool, click on the :guilabel:`Tool Name` button.

  • Dit is ook van toepassing als u de naam van een gereedschap vermeld, zonder dat de gebruiker op een knop hoeft te drukken.

19.9.9. Opmerkingen toevoegen

  • U wilt misschien een opmerking aan de tekst toevoegen, die extra details uitlegt die niet eenvoudig deel van de les kunnen worden gemaakt. Dit is de opmaak:

    [Normal paragraph.]

.. note:: Note text.
  New line within note.

  New paragraph within note.

[Unindented text resumes normal paragraph.]

19.9.10. Een opmerking voor sponsors/auteurs toevoegen

Als u een nieuwe module, les of gedeelte schrijft ten behoeve van een sponsor, moet u een kort bericht van de sponsor opnemen, naar hun keuze. Dit moet de gebruiker attenderen op de naam van de sponsor en moet onder de kop van de module, les of gedeelte, dat zij sponsoren, verschijnen. Het mag echter geen advertentie voor hun bedrijf zijn.

Als u op vrijwillige basis, op eigen titel, een module, les of gedeelte, schrijft, en niet ten behoeve van een sponsor, mag u een opmerking over de auteur opnemen onder de kop van de module, les of het gedeelte dat u schreef. Dat moet in de vorm Deze [module/les/gedeelte] is bijgedragen door [naam auteur]. Voeg geen verdere tekst, contactdetails, etc. toe. Dergelijke details dienen te worden toegevoegd in het gedeelte “Contributors” van het Voorwoord, tezamen met de namen van de gedeelte(n) die u heeft toegevoegd. Als u alleen verbeteringen, correcties en/of toevoegingen heeft gemaakt, vermeldt u zichzelf als een editor.

19.10. Dank u wel!

Dank u voor uw bijdrage aan dit project! Hierdoor maakt u QGIS meer toegankelijk voor gebruikers en voegt u waarde toe aan het project QGIS als geheel.