| | 1 | [[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]] |
| | 2 | [[TOC(heading=Hoofdstukken, sectionindex, compact, depth=2, allactive, indirect=Documentatie/Ontwikkelhandleiding/TOC)]] |
| | 3 | [[TOC(heading=Onderwerpen, sectionindex, compact, depth=3, allactive, indirect=Documentatie/Ontwikkelhandleiding/Ontwikkelomgeving/TOC)]] |
| | 4 | |
| | 5 | == Ontwikkelomgeving (IDE) == |
| | 6 | |
| | 7 | Een ontwikkelomgeving -- integrated development environment -- biedt je een omgeving waarbinnen je de sources van OpenAC kunt bewerken; een goede IDE biedt daarbij onderstaeuning aan voor het debuggen van problemen, het volgen van de programma-flow en helpt fouten te voorkomen. |
| | 8 | |
| | 9 | De standaard ontwikkelomgeving voor OpenAC is [#PyCharm PyCharm]. Dit is een gratis (community versie) of betaalde IDE die speciaal voor Python-ontwikkeling is gemaakt. |
| | 10 | |
| | 11 | Naast !PyCharm zijn Netbeans en Eclipse ook mogelijke IDEs voor het ontwikkelen van OpenAC, maar die hebben wij niet in gebruik en dus geen instellingen gedocumenteerd. Het is uiteraard ook mogelijk om gewoon met een tekst-editor de sources te bewerken, maar dan heb je geen ondersteuning van de IDE. |
| | 12 | |
| | 13 | === !PyCharm === #PyCharm |
| | 14 | |
| | 15 | [https://www.jetbrains.com/pycharm/download/ PyCharm] is een gratis (en Free Software) IDE voor Python; er is ook een betaalde versie. De documentatie van !PyCharm zelf is behoorlijk uitgebreid. |
| | 16 | |
| | 17 | - !PyCharm volgt nauwkeurig PEP8, de standaard voor Python code, dus je hoeft niks aan tabs en spaties in te stellen. Het gebruikt vanzelf 4 spaties indent. |
| | 18 | - Ga via ''File'' -> ''Settings'' om de instellingen van de editor op te vragen. |
| | 19 | - Onder het kopje ''Editor'' -> ''File Encodings'', kies ISO-8859-1 (Latin 1) als project encoding. De IDE encoding kan je op UTF-8 laten staan, of in Latin 1 varianderen. Klik dan apply. |
| | 20 | - Onder ''Tools'' -> ''Python Integrated Tools'', kies bij ''Docstring format'' het formaat ''Epytext''. Dit lijkt het meest op Doxygen. |
| | 21 | |
| | 22 | [[NoteBox(warn, TODO: OpenAC als project toevoegen, project-instellingen voor interpreter/runtime, enz.)]] |
| | 23 | |
| | 24 | |
| | 25 | === Tekst-Editor === |
| | 26 | |
| | 27 | Er zijn verschillende tekst-editors die gewoonlijk onder Linux worden gebruikt. Kate biedt een soort halve-IDE aan, met projecten en plugins, zonder dat het al te zwaar wordt. |
| | 28 | |
| | 29 | Hier staan instellingen die in de tekst-editor gedaan moeten worden; oe dat moet hangt van de editor af: |
| | 30 | |
| | 31 | - Tab width 4. |
| | 32 | - Expand tabs to spaces. |
| | 33 | - End-of-line is LF (niet CR/LF). |
| | 34 | - File encoding is ISO-8859-1 (Latin 1). |
