From 04fb3e3566861bc2ff4292ccfb6b88b933f84e10 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 12:10:16 +0100 Subject: [PATCH 01/51] Feedback --- en/faq/activities/index.md | 6 ++++++ en/faq/annotations/index.md | 10 +++++----- nl/faq/activities/index.md | 6 ++++++ nl/faq/annotations/index.md | 6 +++--- nl/guides/exercises/creating-exercises/setup/index.md | 2 +- nl/guides/exercises/examples/_common.md | 6 +++--- 6 files changed, 24 insertions(+), 12 deletions(-) diff --git a/en/faq/activities/index.md b/en/faq/activities/index.md index 5319d00db..e7b8d2ad7 100644 --- a/en/faq/activities/index.md +++ b/en/faq/activities/index.md @@ -13,3 +13,9 @@ On the home page of Dodona, you can find all your drafts under _Draft exercises_ ## How do I create new exercises? As a teacher, you can use the hundreds of exercises that are available in Dodona, but you can also create new exercises yourself. You can follow [this guide](/en/guides/exercises/creating-exercises/introduction) for this. + +## What is the difference between a course and a repository? +In Dodona, an "exercises repository" is a collection of exercises and reading activities managed in a linked GitHub repository. +These exercises can then be used in multiple "courses". + +A "course" in Dodona is again a collection of exercises and reading activities structured in sequences. Here you can, for example, structure exercises according to a desired learning path. Courses are fully managed within Dodona. A course can contain exercises from different exercise repositories. A course also includes enrolled students. In a course, you can monitor these students, make evaluations, answer questions, etc... diff --git a/en/faq/annotations/index.md b/en/faq/annotations/index.md index 917c7c0b1..68e34df51 100644 --- a/en/faq/annotations/index.md +++ b/en/faq/annotations/index.md @@ -37,13 +37,13 @@ You can also respond to an existing question from yourself or to a comment from ## How do I know if my question has been answered? -When a teacher answers your question, you will receive a notifications in Dodona. This notification will redirect you to the page where you asked the question. +When a teacher answers your question, you will receive a notification in Dodona. This notification will redirect you to the page where you asked the question. ![image](./comment_on_code.png) ## How can I enable/disable student questions? -Use the pencil in the top navigation bar of your course to go to the `edit` page. Here you can enable or disable student questions by checking or unchecking the box `Allow students to ask questions`. +Use the pencil in the top navigation bar of your course to go to the `Edit` page. Here you can enable or disable student questions by checking or unchecking the box `Allow students to ask questions`. ![img.png](./ask_questions_toggle.png) @@ -59,7 +59,7 @@ You will also see a notification in the top navigation bar of your course. Click ![img.png](./course_question_list.png) -If you want to see al open question across all your courses, you can go to the `questions` page in the navigation sidebar of Dodona. +If you want to see al open question across all your courses, you can go to the `Questions` page in the navigation sidebar of Dodona. ![img.png](./questions_index_page.png) @@ -91,11 +91,11 @@ You can either use the `Add global comment` button to add a general comment abou Students often make the same mistakes, or have similar questions. To avoid having to write the same comment over and over again, you can reuse comments. -While writing or editing a comment, you can check `save comment`. This will allow you to add a title for this comment, which should help you find the comment for future use. +While writing or editing a comment, you can check `Save comment`. This will allow you to add a title for this comment, which should help you find the comment for future use. ![Save comment while writing](./save-comment-edit.png) -You can also save an existing comment by clicking `save comment` in the comment menu. +You can also save an existing comment by clicking `Save comment` in the comment menu. ![Save existing comment](save-comment.png) diff --git a/nl/faq/activities/index.md b/nl/faq/activities/index.md index e051b0289..c713e0ea6 100644 --- a/nl/faq/activities/index.md +++ b/nl/faq/activities/index.md @@ -13,3 +13,9 @@ Op de startpagina van Dodona kan je al jouw concepten terugvinden onder _Ongepub ## Hoe maak ik nieuwe oefeningen aan? Als lesgever kan je gebruikmaken van de honderden oefeningen die in Dodona aanwezig zijn, maar je kan ook zelf nieuwe oefeningen aanmaken. Je kan hiervoor [dit stappenplan](/nl/guides/exercises/creating-exercises/introduction) volgen. + +## Wat is het verschil tussen een cursus en een repository? +In Dodona is een "oefeningen _repository_" een verzameling oefeningen en leesactiviteiten die beheerd worden in een gelinkte GitHub repository. +Deze oefeningen kunnen dan gebruikt worden in meerdere "cursussen". + +Een "cursus" in Dodona is opnieuw een verzameling oefeningen en leesactiviteiten gestructureerd in reeksen. Hier kan je bijvoorbeeld oefeningen structureren volgens een gewenst leerpad. Cursussen worden volledig beheerd binnen Dodona. Een cursus kan oefeningen van verschillende oefeningen repositories bevatten. Bij een cursus horen ook de ingeschreven studenten. In een cursus kan je deze studenten opvolgen, evaluaties maken, vragen beantwoorden, etc... diff --git a/nl/faq/annotations/index.md b/nl/faq/annotations/index.md index 8754cbad6..ee19b98c0 100644 --- a/nl/faq/annotations/index.md +++ b/nl/faq/annotations/index.md @@ -59,7 +59,7 @@ Je zal ook een melding zien in de bovenste navigatiebalk van je cursus. Klik op ![img.png](./course_question_list.png) -Als je alle open vragen over al je cursussen wil zien, kan je naar de pagina `vragen` gaan in de linkse navigatiebalk van Dodona. +Als je alle open vragen over al je cursussen wil zien, kan je naar de pagina `Vragen` gaan in de linkse navigatiebalk van Dodona. ![img.png](./questions_index_page.png) @@ -86,11 +86,11 @@ Je kan een algemene opmerking toevoegen door op de knop `Globale opmerking toevo ## Hoe kan ik opmerkingen opslaan en hergebruiken? Studenten maken vaak dezelfde fouten, of hebben gelijkaardige vragen. Om te vermijden dat je dezelfde opmerkingen steeds opnieuw moet schrijven, kan je opmerkingen hergebruiken. -Tijdens het schrijven of bewerken van een opmerking kan je `opmerking opslaan` aanvinken. Dit zal je toelaten om een titel toe te voegen aan de opmerking, wat je zal helpen om de opmerking in de toekomst terug te vinden. +Tijdens het schrijven of bewerken van een opmerking kan je `Sla opmerking op` aanvinken. Dit zal je toelaten om een titel toe te voegen aan de opmerking, wat je zal helpen om de opmerking in de toekomst terug te vinden. ![Save comment while writing](./save-comment-edit.png) -Je kan ook een bestaande opmerking opslaan door op `opmerking opslaan` te klikken in het menu van de opmerking. +Je kan ook een bestaande opmerking opslaan door op `Opmerking opslaan` te klikken in het menu van de opmerking. ![Save existing comment](save-comment-edit.png) diff --git a/nl/guides/exercises/creating-exercises/setup/index.md b/nl/guides/exercises/creating-exercises/setup/index.md index 4168457c9..0064780a6 100644 --- a/nl/guides/exercises/creating-exercises/setup/index.md +++ b/nl/guides/exercises/creating-exercises/setup/index.md @@ -43,7 +43,7 @@ Als volgende stap moet je je persoonlijke kopie van het sjabloon maken: 1. Ga naar . 2. Klik op de knop `Use this template`. -3. Kies vervolgens de eerste optie: `Create new repository`. +3. Kies vervolgens de eerste optie: `Create a new repository`. ![Template repo](./use-template-repo.png) 4. Vul de details voor de nieuwe repository in: 1. Kies een naam voor de repository. diff --git a/nl/guides/exercises/examples/_common.md b/nl/guides/exercises/examples/_common.md index 1f0a7ee3d..fcc25056c 100644 --- a/nl/guides/exercises/examples/_common.md +++ b/nl/guides/exercises/examples/_common.md @@ -43,9 +43,9 @@ Maak het bestand `config.json` in de map `minimum` met de volgende inhoud: In dit bestand worden drie dingen gespecifieerd: -- De **naam** van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). -- De **programmeertaal** van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- Het **toegangsniveau**: hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- De **namen** (_names_) van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). +- De **programmeertaal** (_programming_language_) van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. +- Het **toegangsniveau** (_access_): hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: From 6ac56b492d773c201ebf1ca08bbf55d63df02014 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 15:22:40 +0100 Subject: [PATCH 02/51] examples --- en/references/tested/dsl/index.md | 4 ++-- en/references/tested/index.md | 6 ++--- en/references/tested/json/index.md | 10 ++++---- .../creating-exercises/exercise/index.md | 2 +- nl/guides/exercises/examples/_common.md | 6 ++--- nl/guides/exercises/examples/class/index.md | 17 +++++++------- .../exercises/examples/command-line/index.md | 21 ++++++++--------- .../exercises/examples/input-output/index.md | 23 ++++++++----------- nl/references/tested/dsl/index.md | 6 ++--- nl/references/tested/index.md | 2 +- 10 files changed, 46 insertions(+), 51 deletions(-) diff --git a/en/references/tested/dsl/index.md b/en/references/tested/dsl/index.md index 20e95a104..cff846aee 100644 --- a/en/references/tested/dsl/index.md +++ b/en/references/tested/dsl/index.md @@ -73,7 +73,7 @@ In most cases, it is fine to leave the description empty. Each context must have at least one test case. Since each context is executed separately, the following two constraints apply: -- Only the first test case may have a "main call", i.e. command line arguments or stdin. +- Only the first test case may have a "main call", i.e. command line arguments or _stdin_. - Only the last test case may have a test for the program's exit code. Do note that the first and last test case may be the same one: @@ -84,7 +84,7 @@ if you only have one test case, it may be a main call and have a check for the e Test cases are the building blocks of a test suite, and contain some input and the expected outputs (the _tests_). Within each context, the following constraints apply to test cases: -- Only the first test case may have a "main call", i.e. command line arguments or stdin. +- Only the first test case may have a "main call", i.e. command line arguments or _stdin_. - Only the last test case may have a test for the program's exit code. Do note that the first and last test case may be the same one: diff --git a/en/references/tested/index.md b/en/references/tested/index.md index 055d98a5b..0558aa7b6 100644 --- a/en/references/tested/index.md +++ b/en/references/tested/index.md @@ -75,7 +75,7 @@ We'll explain how to create a simple programming exercise that uses TESTed to pr and how to make the exercise available on Dodona. The exercise is called "echo" and has the following problem statement: -> Define a function `echo` that outputs its string argument to stdout. +> Define a function `echo` that outputs its string argument to _stdout_. Here are some correct submissions for this exercise in a couple of different programming languages: @@ -203,7 +203,7 @@ We'll use the problem statement from above and add an example. Create a file `echo/description/description.en.md` with the following content: ````markdown -Define a function `echo` that outputs its string argument to stdout. +Define a function `echo` that outputs its string argument to _stdout_. ### Example in Python @@ -250,7 +250,7 @@ This test suite specifies that: 1. All feedback is included in a single tab called _Echo_. 2. The tab contains feedback on a single test case. 3. The test case calls the function `echo` with a string argument `"input-1"`. -4. The expected behavior of the test case is that the text `input-1` is generated on stdout. +4. The expected behavior of the test case is that the text `input-1` is generated on _stdout_. The file structure now looks like this: diff --git a/en/references/tested/json/index.md b/en/references/tested/json/index.md index 525b1e8e9..ec2d642f9 100644 --- a/en/references/tested/json/index.md +++ b/en/references/tested/json/index.md @@ -135,7 +135,7 @@ A test case is a statement or an expression that will be executed and evaluated. Each context has at least one test case. The following two constraints apply: -- Only the first test case may have a "main call", i.e. command line arguments or stdin. +- Only the first test case may have a "main call", i.e. command line arguments or _stdin_. - Only the last test case may have a test for the program's exit code. Do note that the first and last test case may be the same one: @@ -255,7 +255,7 @@ Here's an overview of all output channels currently supported by TESTed: ### EmptyChannel -An `EmptyChannel` describes that no output is expected on a specific file descriptor (e.g. stdout or stderr). +An `EmptyChannel` describes that no output is expected on a specific file descriptor (e.g. _stdout_ or _stderr_). Any output generated will be considered as incorrect by TESTed. The `EmptyChannel` is represented by a string constant `none`. @@ -273,7 +273,7 @@ For most output types, this is the default value, meaning you don't need to spec ### IgnoredChannel -An IgnoredChannel object describes that no output is expected on a specific file descriptor (e.g. stdout or stderr). +An IgnoredChannel object describes that no output is expected on a specific file descriptor (e.g. _stdout_ or _stderr_). Any output generated on the file descriptor will be ignored, and is considered correct by TESTed. In other words, if you do not want output, you should use [`EmptyChannel`](#emptychannel), while if you don't care about the output, you should use `IgnoredChannel`. @@ -422,8 +422,8 @@ TESTed currently supports the following two oracles: ### TextOutputChannel -A `TextOutputChannel` object represents text that is expected to be generated on an output channel (e.g. stdout or -stderr). +A `TextOutputChannel` object represents text that is expected to be generated on an output channel (e.g. _stdout_ or +_stderr_). For example, if the text `"Hello world"` must be written to `stdout`: diff --git a/nl/guides/exercises/creating-exercises/exercise/index.md b/nl/guides/exercises/creating-exercises/exercise/index.md index 6848f0fd8..f3437a369 100644 --- a/nl/guides/exercises/creating-exercises/exercise/index.md +++ b/nl/guides/exercises/creating-exercises/exercise/index.md @@ -31,7 +31,7 @@ Doe dit als volgt: 1. Klik aan de linkerkant op het icoontje voor _Source Control_. 2. Klik bovenaan de lijst met wijzigingen op de knop met `+` om alle bestanden klaar te zetten (_Stage All Changes_). 3. Kies bovenaan een _commit message_. Hierin beschrijf je wat je gedaan hebt, zoals "Voeg mijn eerste oefening toe". -4. Klik op de knop `Commit & Push`. +4. Klik op de knop `Commit & Push`. Als je een pop-up krijgt, kies je voor `Sync (Push & Pull)`. Als alles goed gegaan is, werd dit venster leeg. diff --git a/nl/guides/exercises/examples/_common.md b/nl/guides/exercises/examples/_common.md index fcc25056c..c82739949 100644 --- a/nl/guides/exercises/examples/_common.md +++ b/nl/guides/exercises/examples/_common.md @@ -6,8 +6,8 @@ Elke oefening in Dodona komt overeen met een bepaalde map in de oefeningenreposi Die map heeft een [vaste structuur](/nl/references/exercise-directory-structure), die we nu zullen maken. Maak dus eerst een nieuwe map voor de oefening, die we `minimum` zullen noemen. -Maak daarna, in deze nieuwe map, nog twee mappen: -- `description`: de map waarin de opgave komt +Maak daarna, in deze nieuwe map, nog drie mappen: +- `description`: map waarin de opgave komt - `evaluation`: map met informatie over hoe een oplossing beoordeeld moet worden - `solution`: map waarin een voorbeeldoplossing komt @@ -110,7 +110,7 @@ repository/ ## 4. Een testplan maken We willen dat deze oefening automatisch getest wordt. -Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. +Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. In dit geval houden we het testplan kort, met slechts een beperkt aantal testgevallen. In een echte oefening wil je waarschijnlijk meer testgevallen voorzien. diff --git a/nl/guides/exercises/examples/class/index.md b/nl/guides/exercises/examples/class/index.md index 026c31805..054eadabe 100644 --- a/nl/guides/exercises/examples/class/index.md +++ b/nl/guides/exercises/examples/class/index.md @@ -21,8 +21,8 @@ Elke oefening in Dodona komt overeen met een bepaalde map in de oefeningenreposi Die map heeft een [vaste structuur](/nl/references/exercise-directory-structure), die we nu zullen maken. Maak dus eerst een nieuwe map voor de oefening, die we `counter` zullen noemen. -Maak daarna, in deze nieuwe map, nog twee mappen: -- `description`: de map waarin de opgave komt +Maak daarna, in deze nieuwe map, nog drie mappen: +- `description`: map waarin de opgave komt - `evaluation`: map met informatie over hoe een oplossing beoordeeld moet worden - `solution`: map waarin een voorbeeldoplossing komt @@ -58,10 +58,9 @@ Maak het bestand `config.json` in de map `counter` met de volgende inhoud: In dit bestand worden drie dingen gespecifieerd: -- De naam van de oefening zoals getoond door Dodona in het Nederlands en in het Engels. -- We stellen de naam van het testplan in (later meer hierover). Dit is een bestand relatief ten opzicht van de map `evaluation`. -- De programmeertaal van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- Het toegangsniveau: hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- De **namen** (_names_) van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_). +- De **programmeertaal** (_programming_language_) van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. +- Het **toegangsniveau** (_access_): hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: @@ -108,7 +107,7 @@ Daarnaast moet de klasse de volgende methoden ondersteunen: ``` ```` -De `nl` in de naam van de opgave kan je vervangen door `en` als je ook een Engelstalige opgave wilt maken. +Als je ook een Engelstalige opgave wilt maken, gebruik je de naam `description.en.md` voor het tweede bestand. De opgave zelf wordt geschreven in Markdown, een redelijk eenvoudig opmaakformaat. Meer informatie over Markdown is [hier](/nl/references/exercise-description) te vinden. We voegen ook direct een voorbeeldoplossing toe. @@ -147,7 +146,7 @@ repository/ ## 4. Een testplan maken We willen dat deze oefening automatisch getest wordt. -Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. +Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. Om dit kort te houden, beperken we ons testplan tot een aantal testen. Maak een bestand `suite.yaml` in de map `evaluation` met volgende inhoud: @@ -159,7 +158,7 @@ Maak een bestand `suite.yaml` in de map `evaluation` met volgende inhoud: - statement: "counter = Counter(5)" - statement: "counter.report()" stdout: "5" - - expression: "counter.count()" + - statement: "counter.count()" - statement: "counter.report()" stdout: "6" - statement: "counter.count().count().count().count().report()" diff --git a/nl/guides/exercises/examples/command-line/index.md b/nl/guides/exercises/examples/command-line/index.md index e1d42e4cb..53e8fc7f0 100644 --- a/nl/guides/exercises/examples/command-line/index.md +++ b/nl/guides/exercises/examples/command-line/index.md @@ -6,10 +6,10 @@ order: 4 # Oefening op de commandoregel -In deze handleiding stellen we een oefening op die gebruik maakt argumenten op de commandoregel. +In deze handleiding stellen we een oefening op die gebruik maakt van argumenten op de commandoregel. We zullen een programma implementeren dat een aantal getallen binnenkrijgt als argumenten op de commandoregel. -Het programma moet vervolgens de som van deze getallen uitschrijven op stdout. +Het programma moet vervolgens de som van deze getallen uitschrijven op _stdout_. We gaan er in deze handleiding van uit dat je al een werkende oefeningenrepository hebt. Is dat niet het geval, volg dan eerst de handleiding [_Oefeningen opstellen_](/nl/guides/exercises/creating-exercises/introduction/). @@ -22,8 +22,8 @@ Elke oefening in Dodona komt overeen met een bepaalde map in de oefeningenreposi Die map heeft een [vaste structuur](/nl/references/exercise-directory-structure), die we nu zullen maken. Maak dus eerst een nieuwe map voor de oefening, die we `sum` zullen noemen. -Maak daarna, in deze nieuwe map, nog twee mappen: -- `description`: de map waarin de opgave komt +Maak daarna, in deze nieuwe map, nog drie mappen: +- `description`: map waarin de opgave komt - `evaluation`: map met informatie over hoe een oplossing beoordeeld moet worden - `solution`: map waarin een voorbeeldoplossing komt @@ -42,7 +42,7 @@ repository/ Dodona eist voor elke oefeningen ook een [configuratiebestand](/nl/references/exercise-config). Dit bestand bevat metadata, die door Dodona gebruikt worden. -Maak het bestand `config.json` in de map `counter` met de volgende inhoud: +Maak het bestand `config.json` in de map `sum` met de volgende inhoud: ```json { @@ -59,10 +59,9 @@ Maak het bestand `config.json` in de map `counter` met de volgende inhoud: In dit bestand worden drie dingen gespecifieerd: -- De naam van de oefening zoals getoond door Dodona in het Nederlands en in het Engels. -- We stellen de naam van het testplan in (later meer hierover). Dit is een bestand relatief ten opzicht van de map `evaluation`. -- De programmeertaal van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- Het toegangsniveau: hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- De **namen** (_names_) van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_). +- De **programmeertaal** (_programming_language_) van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. +- Het **toegangsniveau** (_access_): hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: @@ -101,7 +100,7 @@ invalid arguments ``` ```` -De `nl` in de naam van de opgave kan je vervangen door `en` als je ook een Engelstalige opgave wilt maken. +Als je ook een Engelstalige opgave wilt maken, gebruik je de naam `description.en.md` voor het tweede bestand. De opgave zelf wordt geschreven in Markdown, een redelijk eenvoudig opmaakformaat. Meer informatie over Markdown is [hier](/nl/references/exercise-description) te vinden. We voegen ook direct een voorbeeldoplossing toe. @@ -142,7 +141,7 @@ repository/ ## 4. Een testplan maken We willen dat deze oefening automatisch getest wordt. -Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. +Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. Om dit kort te houden, beperken we ons testplan tot een aantal testen. Maak een bestand `suite.yaml` in de map `evaluation` met volgende inhoud: diff --git a/nl/guides/exercises/examples/input-output/index.md b/nl/guides/exercises/examples/input-output/index.md index f51e5c30e..9f5db04f0 100644 --- a/nl/guides/exercises/examples/input-output/index.md +++ b/nl/guides/exercises/examples/input-output/index.md @@ -22,8 +22,8 @@ Elke oefening in Dodona komt overeen met een bepaalde map in de oefeningenreposi Die map heeft een [vaste structuur](/nl/references/exercise-directory-structure), die we nu zullen maken. Maak dus eerst een nieuwe map voor de oefening, die we `hello-world` zullen noemen. -Maak daarna, in deze nieuwe map, nog twee mappen: -- `description`: de map waarin de opgave komt +Maak daarna, in deze nieuwe map, nog drie mappen: +- `description`: map waarin de opgave komt - `evaluation`: map met informatie over hoe een oplossing beoordeeld moet worden - `solution`: map waarin een voorbeeldoplossing komt @@ -59,10 +59,9 @@ Maak het bestand `config.json` in de map `hello-world` met de volgende inhoud: In dit bestand worden drie dingen gespecifieerd: -- De naam van de oefening zoals getoond door Dodona in het Nederlands en in het Engels (in dit geval zijn beide namen hetzelfde). -- We stellen de naam van het testplan in (later meer hierover). Dit is een bestand relatief ten opzicht van de map `evaluation`. -- De programmeertaal van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- Het toegangsniveau: hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- De **namen** (_names_) van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). +- De **programmeertaal** (_programming_language_) van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. +- Het **toegangsniveau** (_access_): hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: @@ -87,7 +86,7 @@ Schrijf een Python-programma dat de naam van de gebruiker vraagt en vervolgens de gebruiker begroet met de zin `Hallo, [NAAM]!`, waarbij `[NAAM]` de naam van de gebruiker is. -Het programma moet de naam dus inlezen van standaardinvoer (stdin) +Het programma moet de naam dus inlezen van standaardinvoer (_stdin_) en de begroeting uitschrijven naar standaarduitvoer (stdout). ### Voorbeeld @@ -99,7 +98,7 @@ Hallo, Jan! ``` ```` -De `nl` in de naam van de opgave kan je vervangen door `en` als je ook een Engelstalige opgave wilt maken. +Als je ook een Engelstalige opgave wilt maken, gebruik je de naam `description.en.md` voor het tweede bestand. De opgave zelf wordt geschreven in Markdown, een redelijk eenvoudig opmaakformaat. Meer informatie over Markdown is [hier](/nl/references/exercise-description) te vinden. We voegen ook direct een voorbeeldoplossing toe. @@ -129,14 +128,13 @@ repository/ ## 4. Een testplan maken We willen dat deze oefening automatisch getest wordt. -Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. +Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. Deze oefening heeft natuurlijk een aantal voor de hand liggende testen, waarbij verschillende namen geprobeerd worden. Ook kunnen we eens een naam met cijfers of speciale tekens invullen. Nog een leuke naam is om een naam met dubbelen en enkele aanhalingstekens te proberen. -Ook een naam met _escaped newlines_ kunnen we proberen. -Om dit kort te houden, beperken we ons testplan tot zeven testen. +Om dit kort te houden, beperken we ons testplan tot zes testen. Maak een bestand `suite.yaml` in de map `evaluation` met volgende inhoud: ```yaml @@ -157,13 +155,12 @@ Maak een bestand `suite.yaml` in de map `evaluation` met volgende inhoud: ``` Een testplan wordt geschreven in YAML, en moet ook voldoen aan een bepaalde structuur. -In het voorbeeld hierboven maken we één tabblad met als naam "Testen", en definiëren zeven testen in dat tabblad: +In het voorbeeld hierboven maken we één tabblad met als naam "Testen", en definiëren zes testen in dat tabblad: - Testen 1 en 2 gebruiken twee namen. - Test 3 gebruikt cijfers en leestekens. - Test 4 gebruikt enkele aanhalingstekens. - Test 5 gebruikt dubbele aanhalingstekens. - Test 6 heeft een naam die enkel uit spaties bestaan. -- Test 7 heeft een naam met _escaped newlines_. ::: info Invoer met meerdere regels In het voorbeeldje gebruiken we nu telkens één regel invoer. diff --git a/nl/references/tested/dsl/index.md b/nl/references/tested/dsl/index.md index 9ebf93eca..6da5a7321 100644 --- a/nl/references/tested/dsl/index.md +++ b/nl/references/tested/dsl/index.md @@ -135,7 +135,7 @@ return: #### `stdout` / `stderr` -Specifieert het verwachte resultaat op respectievelijk standaarduitvoer (stdout) en standaardfout (stderr). +Specifieert het verwachte resultaat op respectievelijk standaarduitvoer (_stdout_) en standaardfout (_stderr_). De waarde van het attribuut is ofwel een string (dat dan het verwachte resultaat is), of een object voor meer complexe situaties. Het object heeft volgende attributen: @@ -253,8 +253,8 @@ Een configuratie-object op tabniveau gebruiken zal er bijvoorbeeld voor zorgen d Een configuratie-object kan volgende attributen hebben: -- `stdout`: de [configuratieopties](#testopties) voor standaarduitvoer (stdout) -- `stderr`: de [configuratieopties](#testopties) voor standaardfout (stderr) +- `stdout`: de [configuratieopties](#testopties) voor standaarduitvoer (_stdout_) +- `stderr`: de [configuratieopties](#testopties) voor standaardfout (_stderr_) - `return`: de [configuratieopties](#testopties) voor de verwachte returnwaarde ### Testopties diff --git a/nl/references/tested/index.md b/nl/references/tested/index.md index f07852e2d..f7249e959 100644 --- a/nl/references/tested/index.md +++ b/nl/references/tested/index.md @@ -245,7 +245,7 @@ Dit testplan definieert zegt: 1. Alle feedback is verzameld in één tabblad met naam _Echo_. 2. Het tabblad bevat feedback voor één testgeval. 3. Het testgeval roept we de functie `echo` op met een string `"input-1"` als argument. -4. Het verwachte resultaat is dat de tekst `input-1` op stdout geschreven wordt. +4. Het verwachte resultaat is dat de tekst `input-1` op _stdout_ geschreven wordt. Nu ziet de bestandsstructuur er als volgt uit: From ad9e23f475cb08a11474cdc02c953eef757ad826 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 15:58:52 +0100 Subject: [PATCH 03/51] Add types of syntax highlighting Based on https://github.com/dodona-edu/dodona/issues/3216 --- en/references/exercise-description/index.md | 12 ++++++++++-- nl/references/exercise-description/index.md | 13 +++++++++++-- 2 files changed, 21 insertions(+), 4 deletions(-) diff --git a/en/references/exercise-description/index.md b/en/references/exercise-description/index.md index 4875dbb25..5bf4387d0 100644 --- a/en/references/exercise-description/index.md +++ b/en/references/exercise-description/index.md @@ -252,10 +252,10 @@ When using HTML, wrap your code with `` and ``: In your solution, you can use variable someVariable. ``` -In Markdown, wrap your code with backticks (\`): +In Markdown, wrap your code with backticks (\`). You can even add the programming language's syntax highlighting with `{:.language-python}` for example. ```markdown -In your solution, use can use variable `someVariable`. +In your solution, use can use variable `someVariable`. Use the abbreviated notation `result += 1`{:.language-python}. ``` ### Code blocks @@ -301,6 +301,14 @@ Using Markdown, Dodona can automatically add syntax highlighting if you provide let a = 5; let b = 42; ``` +Syntax highlighting for the Python doctest format can be obtained this way: + + ```console?lang=python&prompt=>>> + >>> echo("Hello world!") + "Hello world!" + >>> echo(5) + 5 + ``` ## Callouts diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index da83adf2b..7de0a5c0e 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -257,10 +257,10 @@ Als je HTML gebruikt, plaats dan `` en `` rond je code. Gebruik de variabele someVariable in je oplossing. ``` -Als je Markdown gebruikt, plaats dan *backticks* (\`) rond je code. +Als je Markdown gebruikt, plaats dan *backticks* (\`) rond je code. Je kan zelfs ook de de syntax highlighting van de programmeertaal toevoegen met `{:.language-python}` bijvoorbeeld. ```markdown -Gebruik de variabele `someVariable` in je oplossing. +Gebruik de variabele `someVariable` in je oplossing. Gebruik de verkorte notatie `result += 1`{:.language-python}. ``` ### Blokken code @@ -307,6 +307,15 @@ Als je Markdown gebruikt, dan kan Dodona automatisch de code opmaken als je aang let b = 42; ``` +Syntax highlighting voor het Python doctest formaat kan je op deze manier bekomen: + + ```console?lang=python&prompt=>>> + >>> echo("Hello world!") + "Hello world!" + >>> echo(5) + 5 + ``` + ## Callouts Om de aandacht te vestigen op een stukje uit je opgave, kan je gebruik maken van *callouts*. Dit zorgt voor een opmaak zoals hier wordt getoond: From a0fc134e3137bdb7c3aeba65addfaa068fba96f9 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 16:27:30 +0100 Subject: [PATCH 04/51] testsuites --- nl/guides/exercises/testsuites/index.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/nl/guides/exercises/testsuites/index.md b/nl/guides/exercises/testsuites/index.md index ea4203206..709f49bb0 100644 --- a/nl/guides/exercises/testsuites/index.md +++ b/nl/guides/exercises/testsuites/index.md @@ -27,9 +27,9 @@ In de [referentiegids](/nl/references/tested/dsl) staat het volledige formaat vo Een testplan bestaat uit een hiërarchie van drie niveaus: -1. _Tabbladen_, die ook als apart tabblad getoond worden op Dodona. -2. _Contexten_, die een onafhankelijke eenheid van testgevallen voorstellen. -3. _Testgevallen_, die één test en zijn resultaten bevatten. +1. **Tabbladen** (_tab_), die ook als apart tabblad getoond worden op Dodona. +2. **Contexten** (_contexts_), die een onafhankelijke eenheid van testgevallen voorstellen. +3. **Testgevallen** (_testcases_), die één test en zijn resultaten bevatten. Een voorbeeld van een testplan met alle niveaus is: @@ -52,9 +52,9 @@ Een voorbeeld van een testplan met alle niveaus is: return: !v "2" ``` -In dit testplan zijn twee analoge tabbladen. +In dit testplan zijn er twee gelijkaardige tabbladen. Elk tabblad bevat twee contexten, die elk één testgeval hebben. -Elk testgeval roept de functie `echo` op met een andere parameter en bepaalt ook de verwachte returnwaarde. +Elk testgeval roept de functie `echo` op met een andere parameter en bepaalt ook de verwachte returnwaarde (_return_). Elk testgeval zit in een eigen context omdat elke functieoproep onafhankelijk van elkaar is. Een context met één testgeval komt veel voor. @@ -149,7 +149,7 @@ Hoewel de Python-syntaxis gebruikt wordt, wijken de conventies in een testplan s Een testplan gebruikt de Python-syntaxis, maar is geen Python. De gebruikte conventies zijn: -- Functieoproepen wier naam begint met een hoofdletters worden beschouwd als +- Functieoproepen waarvan de naam begint met een hoofdletter worden beschouwd als _constructors_, bijvoorbeeld `Constructor(56)`. - Identifiers die volledig in hoofdletters geschreven zijn worden beschouwd als globale constanten, bijvoorbeeld `VERY_LONG_NAME`. - Het casten van waarden gebeurt op de gebruikelijke manier van Python. Het casten van een getal naar `int64` wordt bijvoorbeeld `int64(56)`. Er is wel geen ondersteuning voor Python-constructors. Een verzameling moet je noteren als `set([1, 2, 3, 5])`, niet als `set(1, 2, 3, 5)`. @@ -227,10 +227,10 @@ def evaluate_test(expected, actual, five, six): Wat we doen in deze functie is de datum van vandaag berekenen. We geven vervolgens een `EvaluationResult` terug met vier parameters: -1. Een eerste boolean die aangeeft of de waarde uit de oplossing juist is of niet. In dit geval vergelijken we die gewoon met de datum van vandaag. -2. De verwachte waarde om te tonen op Dodona. We overschijven hier de verwachte waarde uit het testplan met de datum van vandaag. -3. De eigenlijke waarde om te tonen op Dodona. We geven hier de eigenlijke waarde gewoon door. -4. Een optionele lijst van berichten. Deze berichten worden ook getoond op Dodona en kunnen gebruikt worden om bijkomende feedback of uitleg aan de studenten te geven. +1. `result`: Een eerste boolean die aangeeft of de waarde uit de oplossing juist is of niet. In dit geval vergelijken we die gewoon met de datum van vandaag. +2. `dsl_expected`: De verwachte waarde om te tonen op Dodona. We overschijven hier de verwachte waarde uit het testplan met de datum van vandaag. +3. `dsl_actual`: De eigenlijke waarde om te tonen op Dodona. We geven hier de eigenlijke waarde gewoon door. +4. `messages`: Een optionele lijst van berichten. Deze berichten worden ook getoond op Dodona en kunnen gebruikt worden om bijkomende feedback of uitleg aan de studenten te geven. Ook `stderr` en `stdout` kunnen een eigen checkfunctie gebruiken. Hiervoor wordt dezelfde notatie gebruikt, maar met `data` in plaats van `value`: From 4695c46e216e800db264d57d54e5d385b3f6c149 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 16:48:50 +0100 Subject: [PATCH 05/51] syntax --- en/references/exercise-description/index.md | 4 ++-- nl/guides/exercises/examples/_common.md | 6 +++--- nl/guides/exercises/examples/class/index.md | 6 +++--- nl/guides/exercises/examples/command-line/index.md | 6 +++--- nl/guides/exercises/examples/input-output/index.md | 6 +++--- nl/guides/exercises/testsuites/index.md | 6 +++--- nl/references/exercise-description/index.md | 4 ++-- 7 files changed, 19 insertions(+), 19 deletions(-) diff --git a/en/references/exercise-description/index.md b/en/references/exercise-description/index.md index 5bf4387d0..3ab9a19e1 100644 --- a/en/references/exercise-description/index.md +++ b/en/references/exercise-description/index.md @@ -249,13 +249,13 @@ You can easily render code fragments in a monospaced font with syntax highlighti When using HTML, wrap your code with `` and ``: ```html -In your solution, you can use variable someVariable. +In your solution, you can use variable some_variable. ``` In Markdown, wrap your code with backticks (\`). You can even add the programming language's syntax highlighting with `{:.language-python}` for example. ```markdown -In your solution, use can use variable `someVariable`. Use the abbreviated notation `result += 1`{:.language-python}. +In your solution, use can use variable `some_variable`. Use the abbreviated notation `result += 1`{:.language-python}. ``` ### Code blocks diff --git a/nl/guides/exercises/examples/_common.md b/nl/guides/exercises/examples/_common.md index c82739949..ce6909c0a 100644 --- a/nl/guides/exercises/examples/_common.md +++ b/nl/guides/exercises/examples/_common.md @@ -43,9 +43,9 @@ Maak het bestand `config.json` in de map `minimum` met de volgende inhoud: In dit bestand worden drie dingen gespecifieerd: -- De **namen** (_names_) van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). -- De **programmeertaal** (_programming_language_) van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- Het **toegangsniveau** (_access_): hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- `names`: De **namen** van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). +- `programming_language`: De **programmeertaal** van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. +- `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: diff --git a/nl/guides/exercises/examples/class/index.md b/nl/guides/exercises/examples/class/index.md index 054eadabe..939706e6d 100644 --- a/nl/guides/exercises/examples/class/index.md +++ b/nl/guides/exercises/examples/class/index.md @@ -58,9 +58,9 @@ Maak het bestand `config.json` in de map `counter` met de volgende inhoud: In dit bestand worden drie dingen gespecifieerd: -- De **namen** (_names_) van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_). -- De **programmeertaal** (_programming_language_) van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- Het **toegangsniveau** (_access_): hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- `names`: De **namen** van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_). +- `programming_language`: De **programmeertaal** van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. +- `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: diff --git a/nl/guides/exercises/examples/command-line/index.md b/nl/guides/exercises/examples/command-line/index.md index 53e8fc7f0..26067c191 100644 --- a/nl/guides/exercises/examples/command-line/index.md +++ b/nl/guides/exercises/examples/command-line/index.md @@ -59,9 +59,9 @@ Maak het bestand `config.json` in de map `sum` met de volgende inhoud: In dit bestand worden drie dingen gespecifieerd: -- De **namen** (_names_) van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_). -- De **programmeertaal** (_programming_language_) van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- Het **toegangsniveau** (_access_): hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- `names`: De **namen** van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_). +- `programming_language`: De **programmeertaal** van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. +- `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: diff --git a/nl/guides/exercises/examples/input-output/index.md b/nl/guides/exercises/examples/input-output/index.md index 9f5db04f0..12ca625de 100644 --- a/nl/guides/exercises/examples/input-output/index.md +++ b/nl/guides/exercises/examples/input-output/index.md @@ -59,9 +59,9 @@ Maak het bestand `config.json` in de map `hello-world` met de volgende inhoud: In dit bestand worden drie dingen gespecifieerd: -- De **namen** (_names_) van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). -- De **programmeertaal** (_programming_language_) van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- Het **toegangsniveau** (_access_): hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- `names`: De **namen** van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). +- `programming_language`: De **programmeertaal** van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. +- `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: diff --git a/nl/guides/exercises/testsuites/index.md b/nl/guides/exercises/testsuites/index.md index 709f49bb0..26c16e45b 100644 --- a/nl/guides/exercises/testsuites/index.md +++ b/nl/guides/exercises/testsuites/index.md @@ -27,9 +27,9 @@ In de [referentiegids](/nl/references/tested/dsl) staat het volledige formaat vo Een testplan bestaat uit een hiërarchie van drie niveaus: -1. **Tabbladen** (_tab_), die ook als apart tabblad getoond worden op Dodona. -2. **Contexten** (_contexts_), die een onafhankelijke eenheid van testgevallen voorstellen. -3. **Testgevallen** (_testcases_), die één test en zijn resultaten bevatten. +1. `tab`: **Tabbladen**, die ook als apart tabblad getoond worden op Dodona. +2. `contexts`: **Contexten**, die een onafhankelijke eenheid van testgevallen voorstellen. +3. `testcases`: **Testgevallen**, die één test en zijn resultaten bevatten. Een voorbeeld van een testplan met alle niveaus is: diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index 7de0a5c0e..f81537330 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -254,13 +254,13 @@ Je kan op Dodona heel eenvoudig codefragmenten tonen in een *monospaced* lettert Als je HTML gebruikt, plaats dan `` en `` rond je code. ```html -Gebruik de variabele someVariable in je oplossing. +Gebruik de variabele some_variable in je oplossing. ``` Als je Markdown gebruikt, plaats dan *backticks* (\`) rond je code. Je kan zelfs ook de de syntax highlighting van de programmeertaal toevoegen met `{:.language-python}` bijvoorbeeld. ```markdown -Gebruik de variabele `someVariable` in je oplossing. Gebruik de verkorte notatie `result += 1`{:.language-python}. +Gebruik de variabele `some_variable` in je oplossing. Gebruik de verkorte notatie `result += 1`{:.language-python}. ``` ### Blokken code From 881809976668204cdf2151384a522a262c9b54dd Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 18:44:28 +0100 Subject: [PATCH 06/51] reading activity draft --- .../content/dodona_icon.png | Bin 0 -> 7004 bytes .../creating-exercises/content/index.md | 176 ++++++++++++++++++ .../creating-exercises/content/logo_UGent.png | Bin 0 -> 14054 bytes .../creating-exercises/management/index.md | 2 +- nl/guides/exercises/examples/class/index.md | 2 +- .../exercises/examples/command-line/index.md | 2 +- .../exercises/examples/function/index.md | 2 +- .../exercises/examples/input-output/index.md | 2 +- 8 files changed, 181 insertions(+), 5 deletions(-) create mode 100644 nl/guides/exercises/creating-exercises/content/dodona_icon.png create mode 100644 nl/guides/exercises/creating-exercises/content/index.md create mode 100644 nl/guides/exercises/creating-exercises/content/logo_UGent.png diff --git a/nl/guides/exercises/creating-exercises/content/dodona_icon.png b/nl/guides/exercises/creating-exercises/content/dodona_icon.png new file mode 100644 index 0000000000000000000000000000000000000000..09bfea3faf17913efa5c031a54ec81d6b69af138 GIT binary patch literal 7004 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 ABme*a literal 0 HcmV?d00001 diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md new file mode 100644 index 000000000..33312690d --- /dev/null +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -0,0 +1,176 @@ +--- +title: "Oefeningen opstellen: leesactiviteit maken" +sidebarTitle: Leesactiviteit maken +order: 4 +prev: true +next: true +--- + + +# Oefeningen opstellen: opgave en testplan schrijven + +Als je in de vorige stap van de handleiding de _template repository_ gebruikt hebt, bevat je repository al een oefening en leesactiviteit. +Hier zullen we nu zelf nog een leesactiviteit toevoegen. +De bestaande leesactiviteit kan uiteraard als voorbeeld dienen. + +## 1. Structuur + +Elke leesactiviteit in Dodona komt overeen met een bepaalde map in de repository. +Die map heeft een [vaste structuur](/nl/references/exercise-directory-structure), die we nu zullen maken. + +Maak dus eerst een nieuwe map voor de oefening, die we `markdown_demo` zullen noemen. +Maak daarna, in deze nieuwe map, de map `description` aan waarin de leesactiviteit komt. +Maak daarna de map `media` aan in de map `description` waarin de afbeeldingen en andere bestanden komen. + +De map voor deze leesactiviteit moet er als volgt uitzien: + +``` +repository/ +└── markdown_demo/ + └── description/ + └── media/ +``` + +## 2. Configuratie + +Dodona eist voor elke leesactiviteiten ook een [configuratiebestand](/nl/references/exercise-config). +Dit bestand bevat metadata, die door Dodona gebruikt worden. + +Maak het bestand `config.json` in de map `markdown_demo` met de volgende inhoud: + +```json +{ + "description": { + "names": { + "en": "Markdown demo", + "nl": "Markdown demo" + } + }, + "access": "private", + "type": "content" +} +``` + +In dit bestand worden drie dingen gespecifieerd: + +- `names`: De **namen** van de leesactiviteit zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). +- `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private leesactiviteit omdat dit maar een handleiding is, maar we moedigen aan om je leesactiviteiten publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit publieke leesactiviteiten op Dodona). +- `type`: Moet ingesteld worden op `content` voor leesactiviteiten. + +Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: + +``` +repository/ +└── markdown_demo/ + ├── description/ + | └── media/ + └── config.json +``` + +## 3. Afbeelding of bestand toevoegen + +Om een afbeelding toe te voegen heb je twee opties. +Ofwel verwijs je naar een afbeelding die in de media map staat ofwel verwijs je naar de afbeelding via een link. +In dit voorbeeld komen beide manieren aan bod. + +Download onderstaande afbeelding met het logo van de UGent. Dit is een [directe link](https://styleguide.ugent.be/files/uploads/logo_UGent_NL_RGB_2400_kleur_witbg.png). Rechtsklik op de afbeelding en kies voor `Afbeelding opslaan...`. + +![UGent logo](logo_UGent.png) + +Rechtsklik op de `media` map in VS Code web en kies voor `Upload...`. +Selecteer de afbeelding van op je computer en klik op `Openen`. + +Verwijzen naar de afbeelding kan met deze markdown code `![UGent logo](logo_UGent.png)` (zie volgende stap). + +## 4. Inhoud + +De volgende stap is de inhoud van de leesactiviteit. +Maak een bestand `description.en.md` aan in de map `description` van de leesactiviteit, met volgende inhoud: + +````markdown +# Markdown demo + +## Text formatting + +This is an example with words in *italics*, **bold**, and ~~striked through~~ and with a variable `a` in function `returnSolution()`. + +## Hyperlinks and images + +In this sentence, [these words](https://google.com) link to Google. +Below you can see the Dodona logo. + +![Dodona logo](https://dodona.be/icon.png) + +![UGent logo](logo_UGent.png) + +### Lists + +1. item 1 +2. item 2 +3. item 3 + +* item 1 +* item 2 +* item 3 + +## Images + +[Show image](https://dodona.be/icon.png) + +## Math snippets + +Some text with symbol $$a$$ and a formula $$x^2$$. + +The solution can be found with the following formula: +$$ +a^2 = b^2 + c^2 +$$ + +## Code snippets + +In your solution, use can use some code `print("text")`{:.language-python}. + + +```console?lang=python&prompt=>>> +>>> echo("Hello") +Hello +>>> echo("Other side") +Other side +``` + +## Callouts + +{: .callout.callout-success} +> #### Hello +> This is an important message. + +## Quotes + +Text that is not a quote + +> Text that is a quote +```` + +Als je ook Nederlandstalige inhoud wilt maken, gebruik je de naam `description.nl.md` voor het tweede bestand. +De inhoud wordt geschreven in Markdown, een redelijk eenvoudig opmaakformaat. Meer informatie over Markdown is [hier](/nl/references/exercise-description) te vinden. + +Nadat je deze twee bestanden gemaakt hebt, moet je repository er zo uitzien: + +``` +repository/ +└── markdown_demo/ + ├── description/ + | ├── media/ + | └── description.nl.md + └── config.json +``` + +## 5. Wijzigingen opslaan + +Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! + +Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). + +## 6. Leesactiviteit controleren + +De leesactiviteit die je daarnet gemaakt hebt, kan je terugvinden in [jouw repository](https://dodona.be/nl/repositories/) op Dodona. Controleer de leesactiviteit. Is alles naar wens? Dan kan je bovenaan de leesactiviteit publiceren (_Deze oefening publiceren_). Je leesactiviteit is nu klaar om te gebruiken op Dodona! diff --git a/nl/guides/exercises/creating-exercises/content/logo_UGent.png b/nl/guides/exercises/creating-exercises/content/logo_UGent.png new file mode 100644 index 0000000000000000000000000000000000000000..8cde9c3080ddd2ffbde7e9f61b6f4921ee1c6513 GIT binary patch literal 14054 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 P#31EYYA?&>-Ua;+eZ)CH literal 0 HcmV?d00001 diff --git a/nl/guides/exercises/creating-exercises/management/index.md b/nl/guides/exercises/creating-exercises/management/index.md index 24799dc71..1fe467c9b 100644 --- a/nl/guides/exercises/creating-exercises/management/index.md +++ b/nl/guides/exercises/creating-exercises/management/index.md @@ -1,7 +1,7 @@ --- title: "Oefeningen opstellen: volgende stappen" sidebarTitle: Volgende stappen -order: 4 +order: 5 prev: true next: false --- diff --git a/nl/guides/exercises/examples/class/index.md b/nl/guides/exercises/examples/class/index.md index 939706e6d..a5746ad74 100644 --- a/nl/guides/exercises/examples/class/index.md +++ b/nl/guides/exercises/examples/class/index.md @@ -186,4 +186,4 @@ repository/ Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! -Een voorbeeld van hoe je dit kan doen vind je in [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). +Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). diff --git a/nl/guides/exercises/examples/command-line/index.md b/nl/guides/exercises/examples/command-line/index.md index 26067c191..6448f80c0 100644 --- a/nl/guides/exercises/examples/command-line/index.md +++ b/nl/guides/exercises/examples/command-line/index.md @@ -176,4 +176,4 @@ repository/ Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! -Een voorbeeld van hoe je dit kan doen vind je in [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). +Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). diff --git a/nl/guides/exercises/examples/function/index.md b/nl/guides/exercises/examples/function/index.md index bc0661dff..1089f9cac 100644 --- a/nl/guides/exercises/examples/function/index.md +++ b/nl/guides/exercises/examples/function/index.md @@ -20,4 +20,4 @@ Is dat niet het geval, volg dan eerst de handleiding [_Oefeningen opstellen_](/n Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! -Een voorbeeld van hoe je dit kan doen vind je in [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). +Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). diff --git a/nl/guides/exercises/examples/input-output/index.md b/nl/guides/exercises/examples/input-output/index.md index 12ca625de..b72c58953 100644 --- a/nl/guides/exercises/examples/input-output/index.md +++ b/nl/guides/exercises/examples/input-output/index.md @@ -206,4 +206,4 @@ repository/ Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! -Een voorbeeld van hoe je dit kan doen vind je in [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). +Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). From ceb72ea3bc50ca8387fa2c788820b333fa3aa8cc Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 19:02:21 +0100 Subject: [PATCH 07/51] reading activity --- .../creating-exercises/content/index.md | 61 ++++++++++--------- .../creating-exercises/management/index.md | 1 - 2 files changed, 33 insertions(+), 29 deletions(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 33312690d..3b4ae769a 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -1,6 +1,6 @@ --- -title: "Oefeningen opstellen: leesactiviteit maken" -sidebarTitle: Leesactiviteit maken +title: "Oefeningen opstellen: leesactiviteit" +sidebarTitle: Leesactiviteit order: 4 prev: true next: true @@ -10,7 +10,7 @@ next: true # Oefeningen opstellen: opgave en testplan schrijven Als je in de vorige stap van de handleiding de _template repository_ gebruikt hebt, bevat je repository al een oefening en leesactiviteit. -Hier zullen we nu zelf nog een leesactiviteit toevoegen. +Hier zullen we nu zelf nog een leesactiviteit toevoegen. Dit is handig om extra informatie of kleine stukken theorie te integreren in je leerpad. De bestaande leesactiviteit kan uiteraard als voorbeeld dienen. ## 1. Structuur @@ -55,7 +55,7 @@ In dit bestand worden drie dingen gespecifieerd: - `names`: De **namen** van de leesactiviteit zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). - `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private leesactiviteit omdat dit maar een handleiding is, maar we moedigen aan om je leesactiviteiten publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit publieke leesactiviteiten op Dodona). -- `type`: Moet ingesteld worden op `content` voor leesactiviteiten. +- `type`: Moet ingesteld worden op `content` voor leesactiviteiten. De standaardwaarde indien afwezig is `exercise`. Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: @@ -71,7 +71,7 @@ repository/ Om een afbeelding toe te voegen heb je twee opties. Ofwel verwijs je naar een afbeelding die in de media map staat ofwel verwijs je naar de afbeelding via een link. -In dit voorbeeld komen beide manieren aan bod. +In het voorbeeld komen straks beide manieren aan bod. Download onderstaande afbeelding met het logo van de UGent. Dit is een [directe link](https://styleguide.ugent.be/files/uploads/logo_UGent_NL_RGB_2400_kleur_witbg.png). Rechtsklik op de afbeelding en kies voor `Afbeelding opslaan...`. @@ -80,55 +80,55 @@ Download onderstaande afbeelding met het logo van de UGent. Dit is een [directe Rechtsklik op de `media` map in VS Code web en kies voor `Upload...`. Selecteer de afbeelding van op je computer en klik op `Openen`. -Verwijzen naar de afbeelding kan met deze markdown code `![UGent logo](logo_UGent.png)` (zie volgende stap). +Verwijzen naar de afbeelding kan met deze markdown code (zie volgende stap): \ +`![UGent logo](media/logo_UGent.png)` ## 4. Inhoud De volgende stap is de inhoud van de leesactiviteit. -Maak een bestand `description.en.md` aan in de map `description` van de leesactiviteit, met volgende inhoud: +Maak een bestand `description.nl.md` aan in de map `description` van de leesactiviteit, met volgende inhoud: ````markdown # Markdown demo -## Text formatting +## Tekstopmaak -This is an example with words in *italics*, **bold**, and ~~striked through~~ and with a variable `a` in function `returnSolution()`. +Dit is een voorbeeldzin met woorden in *cursief*, **vet**, en met variabel `result` in functie `geef_oplossing()`. -## Hyperlinks and images +## Links en afbeeldingen -In this sentence, [these words](https://google.com) link to Google. -Below you can see the Dodona logo. +Dit is een zin waarbij [deze woorden](https://docs.dodona.be/nl/) linken naar de Dodona handleiding. +Hieronder staat het Dodona logo afgebeeld met een link. ![Dodona logo](https://dodona.be/icon.png) -![UGent logo](logo_UGent.png) +Er wordt rechtstreeks verwezen naar het logo van de UGent in de `media` map. + +![UGent logo](media/logo_UGent.png) -### Lists +### Populairste programmeertalen op Dodona -1. item 1 -2. item 2 -3. item 3 +1. Python +2. R +3. Java * item 1 * item 2 * item 3 -## Images - -[Show image](https://dodona.be/icon.png) ## Math snippets -Some text with symbol $$a$$ and a formula $$x^2$$. +Wat tekst met symbool $$a$$ en een formule $$x^2$$. -The solution can be found with the following formula: +De oplossing kan gevonden worden met de volgende formule: $$ a^2 = b^2 + c^2 $$ ## Code snippets -In your solution, use can use some code `print("text")`{:.language-python}. +In je oplossing, kan je deze code gebruiken: `print("text")`{:.language-python}. ```console?lang=python&prompt=>>> @@ -138,20 +138,25 @@ Hello Other side ``` +```javascript +let a = 5; +let b = 42; +``` + ## Callouts {: .callout.callout-success} -> #### Hello -> This is an important message. +> #### Hallo +> Dit is een belangrijk bericht. ## Quotes -Text that is not a quote +Dit is geen quote -> Text that is a quote +> Dit is een quote ```` -Als je ook Nederlandstalige inhoud wilt maken, gebruik je de naam `description.nl.md` voor het tweede bestand. +Als je ook Engelstalige inhoud wilt maken, gebruik je de naam `description.en.md` voor het tweede bestand. De inhoud wordt geschreven in Markdown, een redelijk eenvoudig opmaakformaat. Meer informatie over Markdown is [hier](/nl/references/exercise-description) te vinden. Nadat je deze twee bestanden gemaakt hebt, moet je repository er zo uitzien: diff --git a/nl/guides/exercises/creating-exercises/management/index.md b/nl/guides/exercises/creating-exercises/management/index.md index 1fe467c9b..19d4e7dfc 100644 --- a/nl/guides/exercises/creating-exercises/management/index.md +++ b/nl/guides/exercises/creating-exercises/management/index.md @@ -14,7 +14,6 @@ Hieronder enkele suggesties voor volgende stappen: - [Maak een cursus aan](/nl/guides/teachers/creating-a-course/). - [Gebruik je oefening in een oefeningenreeks van een cursus](/nl/guides/teachers/exercise-series-management/). - Maak nog andere soorten oefeningen. -- Maak [leesactiviteiten](/nl/references/exercise-config/) met extra informatie of kleine stukken theorie. Veel plezier met het gebruik van Dodona! Zoals steeds, als je vragen hebt of iets is niet duidelijk, aarzel dan niet om [ons te contacteren](https://dodona.be/nl/contact/). From 79cd926c4b59e6436424f32b741d3a7e9f555136 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 19:26:30 +0100 Subject: [PATCH 08/51] reading activity --- .../exercises/creating-exercises/content/index.md | 13 +++++++++---- nl/guides/exercises/examples/class/index.md | 2 +- nl/guides/exercises/examples/command-line/index.md | 2 +- nl/guides/exercises/examples/function/index.md | 2 +- nl/guides/exercises/examples/input-output/index.md | 2 +- 5 files changed, 13 insertions(+), 8 deletions(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 3b4ae769a..b76e24f45 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -13,6 +13,10 @@ Als je in de vorige stap van de handleiding de _template repository_ gebruikt he Hier zullen we nu zelf nog een leesactiviteit toevoegen. Dit is handig om extra informatie of kleine stukken theorie te integreren in je leerpad. De bestaande leesactiviteit kan uiteraard als voorbeeld dienen. +{: .callout.callout-success} +> #### Een leesactiviteit lijkt goed op een oefening +> De structuur en `config.json` voor een leesactiviteit zijn identiek aan deze van een oefening. Er zijn echter twee grote verschillen: de waarde van `type` moet ingesteld worden op `content` en alles die specifiek voor oefeningen is, mag achterwege gelaten worden. + ## 1. Structuur Elke leesactiviteit in Dodona komt overeen met een bepaalde map in de repository. @@ -70,17 +74,17 @@ repository/ ## 3. Afbeelding of bestand toevoegen Om een afbeelding toe te voegen heb je twee opties. -Ofwel verwijs je naar een afbeelding die in de media map staat ofwel verwijs je naar de afbeelding via een link. +Ofwel verwijs je naar een afbeelding die in de `media` map staat, ofwel verwijs je naar de afbeelding via een link. In het voorbeeld komen straks beide manieren aan bod. Download onderstaande afbeelding met het logo van de UGent. Dit is een [directe link](https://styleguide.ugent.be/files/uploads/logo_UGent_NL_RGB_2400_kleur_witbg.png). Rechtsklik op de afbeelding en kies voor `Afbeelding opslaan...`. ![UGent logo](logo_UGent.png) -Rechtsklik op de `media` map in VS Code web en kies voor `Upload...`. +Rechtsklik op de `media` map in VS Code web en klik op `Upload...`. Selecteer de afbeelding van op je computer en klik op `Openen`. -Verwijzen naar de afbeelding kan met deze markdown code (zie volgende stap): \ +Verwijzen naar de afbeelding kan met deze markdown code (zie volgende stap). Het start met een uitroepingsteken (`!`) en tussen de vierkante haken mag je een beschrijving geven van wat er op de afbeelding staat. Tussen de ronde haken staat het pad naar de afbeelding.: \ `![UGent logo](media/logo_UGent.png)` ## 4. Inhoud @@ -166,13 +170,14 @@ repository/ └── markdown_demo/ ├── description/ | ├── media/ + | | └── logo_UGent.png | └── description.nl.md └── config.json ``` ## 5. Wijzigingen opslaan -Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! +Vergeet niet om je wijzigingen te _committen_, anders gaan ze verloren! Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). diff --git a/nl/guides/exercises/examples/class/index.md b/nl/guides/exercises/examples/class/index.md index a5746ad74..a0053e7e2 100644 --- a/nl/guides/exercises/examples/class/index.md +++ b/nl/guides/exercises/examples/class/index.md @@ -184,6 +184,6 @@ repository/ ## 5. Wijzigingen opslaan -Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! +Vergeet niet om je wijzigingen te _committen_, anders gaan ze verloren! Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). diff --git a/nl/guides/exercises/examples/command-line/index.md b/nl/guides/exercises/examples/command-line/index.md index 6448f80c0..72419d175 100644 --- a/nl/guides/exercises/examples/command-line/index.md +++ b/nl/guides/exercises/examples/command-line/index.md @@ -174,6 +174,6 @@ repository/ ## 5. Wijzigingen opslaan -Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! +Vergeet niet om je wijzigingen te _committen_, anders gaan ze verloren! Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). diff --git a/nl/guides/exercises/examples/function/index.md b/nl/guides/exercises/examples/function/index.md index 1089f9cac..6fb674619 100644 --- a/nl/guides/exercises/examples/function/index.md +++ b/nl/guides/exercises/examples/function/index.md @@ -18,6 +18,6 @@ Is dat niet het geval, volg dan eerst de handleiding [_Oefeningen opstellen_](/n ## 5. Wijzigingen opslaan -Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! +Vergeet niet om je wijzigingen te _committen_, anders gaan ze verloren! Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). diff --git a/nl/guides/exercises/examples/input-output/index.md b/nl/guides/exercises/examples/input-output/index.md index b72c58953..13d285434 100644 --- a/nl/guides/exercises/examples/input-output/index.md +++ b/nl/guides/exercises/examples/input-output/index.md @@ -204,6 +204,6 @@ repository/ ## 5. Wijzigingen opslaan -Vergeet niet om je wijzigingen te committen, anders gaan ze verloren! +Vergeet niet om je wijzigingen te _committen_, anders gaan ze verloren! Een voorbeeld van hoe je dit kan doen vind je [hier](/nl/guides/exercises/creating-exercises/exercise/#_5-wijzigingen-opslaan). From 1c5d19739857d301fc40c96e6135d1494aeca936 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 19:45:13 +0100 Subject: [PATCH 09/51] reading activity --- .../creating-exercises/content/index.md | 37 ++++++++++--------- 1 file changed, 19 insertions(+), 18 deletions(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index b76e24f45..983fb6f8c 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -7,7 +7,7 @@ next: true --- -# Oefeningen opstellen: opgave en testplan schrijven +# Oefeningen opstellen: leesactiviteit Als je in de vorige stap van de handleiding de _template repository_ gebruikt hebt, bevat je repository al een oefening en leesactiviteit. Hier zullen we nu zelf nog een leesactiviteit toevoegen. Dit is handig om extra informatie of kleine stukken theorie te integreren in je leerpad. @@ -97,12 +97,12 @@ Maak een bestand `description.nl.md` aan in de map `description` van de leesacti ## Tekstopmaak -Dit is een voorbeeldzin met woorden in *cursief*, **vet**, en met variabel `result` in functie `geef_oplossing()`. +Dit is een voorbeeldzin met woorden in *cursief*, **vet** en met variabel `result` in functie `geef_oplossing()`. ## Links en afbeeldingen -Dit is een zin waarbij [deze woorden](https://docs.dodona.be/nl/) linken naar de Dodona handleiding. -Hieronder staat het Dodona logo afgebeeld met een link. +Dit is een zin waarbij [deze woorden](https://docs.dodona.be/nl/references/exercise-description/) linken naar de Dodona handleiding over Markdown. +Hieronder staat het Dodona logo afgebeeld via een link. ![Dodona logo](https://dodona.be/icon.png) @@ -116,25 +116,26 @@ Er wordt rechtstreeks verwezen naar het logo van de UGent in de `media` map. 2. R 3. Java -* item 1 -* item 2 -* item 3 +### Soorten ingenieurs +* Handelsingenieur +* Industrieel ingenieur (ing.) +* Burgerlijk ingenieur (ir.) +* Bio-ingenieur -## Math snippets +## Wiskundige formules -Wat tekst met symbool $$a$$ en een formule $$x^2$$. +Bereken de lengte van de schuine zijde van een driehoek $$c$$ met de formule $$c^2 = a^2 + b^2$$. De oplossing kan gevonden worden met de volgende formule: $$ -a^2 = b^2 + c^2 +c = \sqrt{a^2 + b^2} $$ -## Code snippets +## Codefragmenten In je oplossing, kan je deze code gebruiken: `print("text")`{:.language-python}. - ```console?lang=python&prompt=>>> >>> echo("Hello") Hello @@ -142,22 +143,22 @@ Hello Other side ``` -```javascript -let a = 5; -let b = 42; +```python +naam = input() +print(f"Hallo, {naam}!") ``` ## Callouts {: .callout.callout-success} -> #### Hallo +> #### Opgelet > Dit is een belangrijk bericht. ## Quotes -Dit is geen quote +Dit is geen quote. -> Dit is een quote +> Dit is een quote. ```` Als je ook Engelstalige inhoud wilt maken, gebruik je de naam `description.en.md` voor het tweede bestand. From bcc25921d64e9257a8221331d5657c6659b41ecc Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 19:55:50 +0100 Subject: [PATCH 10/51] indentation --- en/faq/activities/index.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/en/faq/activities/index.md b/en/faq/activities/index.md index e7b8d2ad7..ad42164c8 100644 --- a/en/faq/activities/index.md +++ b/en/faq/activities/index.md @@ -18,4 +18,9 @@ As a teacher, you can use the hundreds of exercises that are available in Dodona In Dodona, an "exercises repository" is a collection of exercises and reading activities managed in a linked GitHub repository. These exercises can then be used in multiple "courses". -A "course" in Dodona is again a collection of exercises and reading activities structured in sequences. Here you can, for example, structure exercises according to a desired learning path. Courses are fully managed within Dodona. A course can contain exercises from different exercise repositories. A course also includes enrolled students. In a course, you can monitor these students, make evaluations, answer questions, etc... +A "course" in Dodona is again a collection of exercises and reading activities structured in sequences. +Here you can, for example, structure exercises according to a desired learning path. +Courses are fully managed within Dodona. +A course can contain exercises from different exercise repositories. +A course also includes enrolled students. +In a course, you can monitor these students, make evaluations, answer questions, etc... From 199252e97de1f1f16021abae067d42180d9c19ef Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 20:04:11 +0100 Subject: [PATCH 11/51] newlines --- en/references/exercise-config/index.md | 2 +- nl/faq/activities/index.md | 6 +++++- .../creating-exercises/content/dodona_icon.png | Bin 7004 -> 0 bytes .../creating-exercises/content/index.md | 6 ++++-- nl/references/exercise-config/index.md | 2 +- 5 files changed, 11 insertions(+), 5 deletions(-) delete mode 100644 nl/guides/exercises/creating-exercises/content/dodona_icon.png diff --git a/en/references/exercise-config/index.md b/en/references/exercise-config/index.md index 273043f98..3e784e343 100644 --- a/en/references/exercise-config/index.md +++ b/en/references/exercise-config/index.md @@ -30,7 +30,7 @@ Dodona allows setting the configuration of an **exercise** and a **reading activ ## Config file structure for reading activities -The structure for a reading activity is identical to that of an exercise. There are 2 big differences: the value of `type` must be set to `content` and keys that are not relevant for exercises can be omitted. The format of the description is also identical. +The structure for a reading activity is identical to that of an exercise. There are two big differences: the value of `type` must be set to `content` and keys that are not relevant for exercises can be omitted. The format of the description is also identical. - **`type`**: Must be set to `content` for reading activities - **`access`** (`public` or `private`): determines who can use this exercise diff --git a/nl/faq/activities/index.md b/nl/faq/activities/index.md index c713e0ea6..f1a6b808e 100644 --- a/nl/faq/activities/index.md +++ b/nl/faq/activities/index.md @@ -18,4 +18,8 @@ Als lesgever kan je gebruikmaken van de honderden oefeningen die in Dodona aanwe In Dodona is een "oefeningen _repository_" een verzameling oefeningen en leesactiviteiten die beheerd worden in een gelinkte GitHub repository. Deze oefeningen kunnen dan gebruikt worden in meerdere "cursussen". -Een "cursus" in Dodona is opnieuw een verzameling oefeningen en leesactiviteiten gestructureerd in reeksen. Hier kan je bijvoorbeeld oefeningen structureren volgens een gewenst leerpad. Cursussen worden volledig beheerd binnen Dodona. Een cursus kan oefeningen van verschillende oefeningen repositories bevatten. Bij een cursus horen ook de ingeschreven studenten. In een cursus kan je deze studenten opvolgen, evaluaties maken, vragen beantwoorden, etc... +Een "cursus" in Dodona is opnieuw een verzameling oefeningen en leesactiviteiten gestructureerd in reeksen. Hier kan je bijvoorbeeld oefeningen structureren volgens een gewenst leerpad. +Cursussen worden volledig beheerd binnen Dodona. +Een cursus kan oefeningen van verschillende oefeningen repositories bevatten. +Bij een cursus horen ook de ingeschreven studenten. +In een cursus kan je deze studenten opvolgen, evaluaties maken, vragen beantwoorden, etc... diff --git a/nl/guides/exercises/creating-exercises/content/dodona_icon.png b/nl/guides/exercises/creating-exercises/content/dodona_icon.png deleted file mode 100644 index 09bfea3faf17913efa5c031a54ec81d6b69af138..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7004 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 ABme*a diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 983fb6f8c..32b4b025c 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -10,12 +10,14 @@ next: true # Oefeningen opstellen: leesactiviteit Als je in de vorige stap van de handleiding de _template repository_ gebruikt hebt, bevat je repository al een oefening en leesactiviteit. -Hier zullen we nu zelf nog een leesactiviteit toevoegen. Dit is handig om extra informatie of kleine stukken theorie te integreren in je leerpad. +Hier zullen we nu zelf nog een leesactiviteit toevoegen. +Dit is handig om extra informatie of kleine stukken theorie te integreren in je leerpad. De bestaande leesactiviteit kan uiteraard als voorbeeld dienen. {: .callout.callout-success} > #### Een leesactiviteit lijkt goed op een oefening -> De structuur en `config.json` voor een leesactiviteit zijn identiek aan deze van een oefening. Er zijn echter twee grote verschillen: de waarde van `type` moet ingesteld worden op `content` en alles die specifiek voor oefeningen is, mag achterwege gelaten worden. +> De structuur en `config.json` voor een leesactiviteit zijn identiek aan deze van een oefening. +> Er zijn echter twee grote verschillen: de waarde van `type` moet ingesteld worden op `content` en alles die specifiek voor oefeningen is, mag achterwege gelaten worden. ## 1. Structuur diff --git a/nl/references/exercise-config/index.md b/nl/references/exercise-config/index.md index 7c5098d7b..5c18bdacd 100644 --- a/nl/references/exercise-config/index.md +++ b/nl/references/exercise-config/index.md @@ -30,7 +30,7 @@ Dodona laat toe om de configuratie van een **oefening** of een **leesactiviteit* ## Configuratiebestandsstructuur voor leesactiviteiten -De structuur voor een leesactiviteit is identiek aan deze van een oefening. Er zijn echter 2 grote verschillen: de waarde van `type` moet ingesteld worden op `content` en bepaalde verplichte velden zoals `programming_language` mogen achterwege gelaten worden. +De structuur voor een leesactiviteit is identiek aan deze van een oefening. Er zijn echter twee grote verschillen: de waarde van `type` moet ingesteld worden op `content` en bepaalde verplichte velden zoals `programming_language` mogen achterwege gelaten worden. - **`type`**: Moet ingesteld worden op `content` voor leesactiviteiten. - **`access`** (`public` of `private`): bepaalt wie deze oefening kan gebruiken From 95699c70dea6fd58e3e3a35cb6c27e77fa1c91ac Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 17 Nov 2023 20:44:44 +0100 Subject: [PATCH 12/51] English --- .idea/.gitignore | 8 +++++++ .idea/dodona-edu.github.io.iml | 10 ++++++++ .idea/inspectionProfiles/Project_Default.xml | 19 +++++++++++++++ .../inspectionProfiles/profiles_settings.xml | 6 +++++ .idea/jupyter-settings.xml | 23 +++++++++++++++++++ .idea/misc.xml | 7 ++++++ .idea/vcs.xml | 6 +++++ .../creating-exercises/content/index.md | 9 ++++++++ .../creating-exercises/management/index.md | 2 +- 9 files changed, 89 insertions(+), 1 deletion(-) create mode 100644 .idea/.gitignore create mode 100644 .idea/dodona-edu.github.io.iml create mode 100644 .idea/inspectionProfiles/Project_Default.xml create mode 100644 .idea/inspectionProfiles/profiles_settings.xml create mode 100644 .idea/jupyter-settings.xml create mode 100644 .idea/misc.xml create mode 100644 .idea/vcs.xml create mode 100644 en/guides/exercises/creating-exercises/content/index.md diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 000000000..13566b81b --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,8 @@ +# Default ignored files +/shelf/ +/workspace.xml +# Editor-based HTTP Client requests +/httpRequests/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/.idea/dodona-edu.github.io.iml b/.idea/dodona-edu.github.io.iml new file mode 100644 index 000000000..a2e196b87 --- /dev/null +++ b/.idea/dodona-edu.github.io.iml @@ -0,0 +1,10 @@ + + + + + + \ No newline at end of file diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml new file mode 100644 index 000000000..c93289031 --- /dev/null +++ b/.idea/inspectionProfiles/Project_Default.xml @@ -0,0 +1,19 @@ + + + + \ No newline at end of file diff --git a/.idea/inspectionProfiles/profiles_settings.xml b/.idea/inspectionProfiles/profiles_settings.xml new file mode 100644 index 000000000..105ce2da2 --- /dev/null +++ b/.idea/inspectionProfiles/profiles_settings.xml @@ -0,0 +1,6 @@ + + + + \ No newline at end of file diff --git a/.idea/jupyter-settings.xml b/.idea/jupyter-settings.xml new file mode 100644 index 000000000..77bdda4e6 --- /dev/null +++ b/.idea/jupyter-settings.xml @@ -0,0 +1,23 @@ + + + + + + \ No newline at end of file diff --git a/.idea/misc.xml b/.idea/misc.xml new file mode 100644 index 000000000..812ab5a68 --- /dev/null +++ b/.idea/misc.xml @@ -0,0 +1,7 @@ + + + + + + \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml new file mode 100644 index 000000000..35eb1ddfb --- /dev/null +++ b/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/en/guides/exercises/creating-exercises/content/index.md b/en/guides/exercises/creating-exercises/content/index.md new file mode 100644 index 000000000..423da9639 --- /dev/null +++ b/en/guides/exercises/creating-exercises/content/index.md @@ -0,0 +1,9 @@ +--- +title: "Creating exercises: reading activity" +sidebarTitle: Reading activity +order: 4 +prev: true +next: true +--- + +This guide is not yet available in English. diff --git a/en/guides/exercises/creating-exercises/management/index.md b/en/guides/exercises/creating-exercises/management/index.md index 406b25f96..d37abf425 100644 --- a/en/guides/exercises/creating-exercises/management/index.md +++ b/en/guides/exercises/creating-exercises/management/index.md @@ -1,7 +1,7 @@ --- title: "Creating exercises: next steps" sidebarTitle: Next steps -order: 4 +order: 5 prev: true next: false --- From 26df33c7de1746311444b19fab4dba6d3dedb360 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Mon, 20 Nov 2023 14:54:48 +0100 Subject: [PATCH 13/51] remove author https://github.com/orgs/dodona-edu/discussions/4240#discussioncomment-4390253 --- en/references/exercise-config/index.md | 3 +-- nl/references/exercise-config/index.md | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/en/references/exercise-config/index.md b/en/references/exercise-config/index.md index 3e784e343..8417a10ff 100644 --- a/en/references/exercise-config/index.md +++ b/en/references/exercise-config/index.md @@ -97,7 +97,6 @@ The structure for a reading activity is identical to that of an exercise. There "memory_limit": 100000000 }, "programming_language": "python", - "author": "Firstname Lastname ", - "contact": "firstname_lastname@ugent.be" + "contact": "Firstname Lastname " } ``` diff --git a/nl/references/exercise-config/index.md b/nl/references/exercise-config/index.md index 5c18bdacd..350083bec 100644 --- a/nl/references/exercise-config/index.md +++ b/nl/references/exercise-config/index.md @@ -97,7 +97,6 @@ De structuur voor een leesactiviteit is identiek aan deze van een oefening. Er z "memory_limit": 100000000 }, "programming_language": "python", - "author": "Firstname Lastname ", - "contact": "firstname_lastname@ugent.be" + "contact": "Firstname Lastname " } ``` From e40abba44729b4755bac5791ab22c6d8a2b87000 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Mon, 20 Nov 2023 15:21:39 +0100 Subject: [PATCH 14/51] judge reference --- en/references/judges/index.md | 2 +- nl/references/exercise-config/index.md | 2 +- nl/references/judges/index.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/en/references/judges/index.md b/en/references/judges/index.md index 301668b0d..47a3983ed 100644 --- a/en/references/judges/index.md +++ b/en/references/judges/index.md @@ -6,7 +6,7 @@ order: 6 # Judges -On this page you can find an overview of all judges that are available on Dodona. A judge is a piece of software that is responsible for testing the solutions of students and writing the results in a format that Dodona understands. +On [this page](https://dodona.be/en/judges/) you can find an overview of all judges that are available on Dodona. A judge is a piece of software that is responsible for testing the solutions of students and writing the results in a format that Dodona understands. Most judges only support one programming language, but there are also judges like [TESTed](#TESTed) that support multiple programming languages. diff --git a/nl/references/exercise-config/index.md b/nl/references/exercise-config/index.md index 350083bec..9f24e1f79 100644 --- a/nl/references/exercise-config/index.md +++ b/nl/references/exercise-config/index.md @@ -20,7 +20,7 @@ Dodona laat toe om de configuratie van een **oefening** of een **leesactiviteit* - **`nl`**: de naam van de oefening in het Nederlands - `en`: de naam van de oefening in het Engels - **`evaluation`**: de specificatie van de evaluatieprocedure - - **`handler`** (string, optioneel): de naam van de judge die gebruikt wordt voor de evaluatie. Standaard gebruik Dodona de judge die ingesteld is voor de repository. Een overzicht van de mogelijke judges vind je [hier](/nl/references/judges). + - **`handler`** (string, optioneel): de naam van de judge die gebruikt wordt voor de evaluatie. Standaard gebruikt Dodona de judge die ingesteld is voor de repository. Een overzicht van de mogelijke judges vind je [hier](/nl/references/judges). - **`image`** (string, optioneel): de naam van de docker image die gebruikt wordt voor de evaluatie. Standaard gebruikt Dodona de image die ingesteld is voor de judge. - **`time_limit`** (integer, optioneel): de tijd in seconden waarna de evaluatie van een oefening stopgezet wordt. Standaard is dit 42 seconden - **`memory_limit`** (integer, optioneel): de hoeveelheid geheugen in bytes die gebruikt kan worden bij het uitvoeren van de evaluatie. Standaard is dit ingesteld op 100M. diff --git a/nl/references/judges/index.md b/nl/references/judges/index.md index 83bf85594..d010f9fa2 100644 --- a/nl/references/judges/index.md +++ b/nl/references/judges/index.md @@ -6,7 +6,7 @@ order: 6 # Judges -Op deze pagina vind je een overzicht van alle judges die beschikbaar zijn op Dodona. Een judge is een stukje software dat verantwoordelijk is om de oplossingen van studenten te testen en de resultaten hiervan weg te schrijven in een formaat dat Dodona begrijpt. +Op [deze pagina](https://dodona.be/nl/judges/) vind je een overzicht van alle judges die beschikbaar zijn op Dodona. Een judge is een stukje software dat verantwoordelijk is om de oplossingen van studenten te testen en de resultaten hiervan weg te schrijven in een formaat dat Dodona begrijpt. De meeste judges ondersteunen maar één programmeertaal, maar er zijn ook judges zoals [TESTed](#TESTed) die meerdere programmeertalen ondersteunen. From 96c9e736235c2c1eedf5718ae6bb5cc8e3624c0c Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:32:10 +0100 Subject: [PATCH 15/51] Update nl/guides/exercises/examples/input-output/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/examples/input-output/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/examples/input-output/index.md b/nl/guides/exercises/examples/input-output/index.md index 13d285434..18b8d0aff 100644 --- a/nl/guides/exercises/examples/input-output/index.md +++ b/nl/guides/exercises/examples/input-output/index.md @@ -61,7 +61,7 @@ In dit bestand worden drie dingen gespecifieerd: - `names`: De **namen** van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). - `programming_language`: De **programmeertaal** van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- `access`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: From 8b5fe654ce950cb1fd310f92fc68a48232440b3f Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:32:47 +0100 Subject: [PATCH 16/51] Update nl/references/exercise-description/index.md Co-authored-by: Niko Strijbol --- nl/references/exercise-description/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index f81537330..b63b860b6 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -257,7 +257,7 @@ Als je HTML gebruikt, plaats dan `` en `` rond je code. Gebruik de variabele some_variable in je oplossing. ``` -Als je Markdown gebruikt, plaats dan *backticks* (\`) rond je code. Je kan zelfs ook de de syntax highlighting van de programmeertaal toevoegen met `{:.language-python}` bijvoorbeeld. +Als je Markdown gebruikt, plaats dan *backticks* (\`) rond je code. Je kan ook de gebruikte programmeertaal toevoegen, bijvoorbeeld met `{:.language-python}`. Dat laatste zorgt dan voor _syntax highlighting_. ```markdown Gebruik de variabele `some_variable` in je oplossing. Gebruik de verkorte notatie `result += 1`{:.language-python}. From cd7553bd98f910c91a002d9ef5ab265e0180d555 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:38:49 +0100 Subject: [PATCH 17/51] Update nl/faq/activities/index.md Co-authored-by: Niko Strijbol --- nl/faq/activities/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/faq/activities/index.md b/nl/faq/activities/index.md index f1a6b808e..9a14b1f7f 100644 --- a/nl/faq/activities/index.md +++ b/nl/faq/activities/index.md @@ -15,7 +15,7 @@ Op de startpagina van Dodona kan je al jouw concepten terugvinden onder _Ongepub Als lesgever kan je gebruikmaken van de honderden oefeningen die in Dodona aanwezig zijn, maar je kan ook zelf nieuwe oefeningen aanmaken. Je kan hiervoor [dit stappenplan](/nl/guides/exercises/creating-exercises/introduction) volgen. ## Wat is het verschil tussen een cursus en een repository? -In Dodona is een "oefeningen _repository_" een verzameling oefeningen en leesactiviteiten die beheerd worden in een gelinkte GitHub repository. +In Dodona is een "oefeningen_repository_" een verzameling oefeningen en leesactiviteiten die beheerd worden in een gelinkte GitHub repository. Deze oefeningen kunnen dan gebruikt worden in meerdere "cursussen". Een "cursus" in Dodona is opnieuw een verzameling oefeningen en leesactiviteiten gestructureerd in reeksen. Hier kan je bijvoorbeeld oefeningen structureren volgens een gewenst leerpad. From bb2a97e89c3cee02cb4ad44a52dc70fb07dce0d0 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:39:14 +0100 Subject: [PATCH 18/51] Update nl/guides/exercises/examples/command-line/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/examples/command-line/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/examples/command-line/index.md b/nl/guides/exercises/examples/command-line/index.md index 72419d175..b53112288 100644 --- a/nl/guides/exercises/examples/command-line/index.md +++ b/nl/guides/exercises/examples/command-line/index.md @@ -61,7 +61,7 @@ In dit bestand worden drie dingen gespecifieerd: - `names`: De **namen** van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_). - `programming_language`: De **programmeertaal** van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- `access`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: From 9a5c53c60a3d717462069cfc5b18367b3ccdd965 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:39:34 +0100 Subject: [PATCH 19/51] Update nl/faq/activities/index.md Co-authored-by: Niko Strijbol --- nl/faq/activities/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/faq/activities/index.md b/nl/faq/activities/index.md index 9a14b1f7f..a9d39c7b0 100644 --- a/nl/faq/activities/index.md +++ b/nl/faq/activities/index.md @@ -20,6 +20,6 @@ Deze oefeningen kunnen dan gebruikt worden in meerdere "cursussen". Een "cursus" in Dodona is opnieuw een verzameling oefeningen en leesactiviteiten gestructureerd in reeksen. Hier kan je bijvoorbeeld oefeningen structureren volgens een gewenst leerpad. Cursussen worden volledig beheerd binnen Dodona. -Een cursus kan oefeningen van verschillende oefeningen repositories bevatten. +Een cursus kan oefeningen van verschillende oefeningenrepository's bevatten. Bij een cursus horen ook de ingeschreven studenten. In een cursus kan je deze studenten opvolgen, evaluaties maken, vragen beantwoorden, etc... From 1a83bd60921b24fd17f24b3b30b870a07bb84559 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:41:00 +0100 Subject: [PATCH 20/51] Update nl/references/exercise-description/index.md Co-authored-by: Niko Strijbol --- nl/references/exercise-description/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index b63b860b6..69721f2aa 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -260,7 +260,8 @@ Gebruik de variabele some_variable in je oplossing. Als je Markdown gebruikt, plaats dan *backticks* (\`) rond je code. Je kan ook de gebruikte programmeertaal toevoegen, bijvoorbeeld met `{:.language-python}`. Dat laatste zorgt dan voor _syntax highlighting_. ```markdown -Gebruik de variabele `some_variable` in je oplossing. Gebruik de verkorte notatie `result += 1`{:.language-python}. +Gebruik de variabele `some_variable` in je oplossing. + Gebruik de verkorte notatie `result += 1`{:.language-python}. ``` ### Blokken code From b4536b1e45a694944a46c0d0778ca7e01ca2ade1 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:47:19 +0100 Subject: [PATCH 21/51] Update nl/references/exercise-description/index.md Co-authored-by: Niko Strijbol --- nl/references/exercise-description/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index 69721f2aa..2055b01a9 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -308,7 +308,7 @@ Als je Markdown gebruikt, dan kan Dodona automatisch de code opmaken als je aang let b = 42; ``` -Syntax highlighting voor het Python doctest formaat kan je op deze manier bekomen: +_Syntax highlighting_ voor interactieve sessies, zoals doctests in Python, kan je op deze manier bekomen: ```console?lang=python&prompt=>>> >>> echo("Hello world!") From 4c061be149a85cbee8349da296aa554806e492ac Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:50:56 +0100 Subject: [PATCH 22/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 32b4b025c..97a672cc9 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -14,10 +14,10 @@ Hier zullen we nu zelf nog een leesactiviteit toevoegen. Dit is handig om extra informatie of kleine stukken theorie te integreren in je leerpad. De bestaande leesactiviteit kan uiteraard als voorbeeld dienen. -{: .callout.callout-success} -> #### Een leesactiviteit lijkt goed op een oefening -> De structuur en `config.json` voor een leesactiviteit zijn identiek aan deze van een oefening. -> Er zijn echter twee grote verschillen: de waarde van `type` moet ingesteld worden op `content` en alles die specifiek voor oefeningen is, mag achterwege gelaten worden. +::: info Analoog aan een oefening +De structuur en `config.json` voor een leesactiviteit zijn identiek aan deze van een oefening. +Er zijn echter twee grote verschillen: de waarde van `type` moet ingesteld worden op `content` en alles die specifiek voor oefeningen is, mag achterwege gelaten worden. +::: ## 1. Structuur From 9aaf8befc5bbea02d3259cef6c76be511b878a3d Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:51:31 +0100 Subject: [PATCH 23/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 97a672cc9..dae682119 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -73,7 +73,7 @@ repository/ └── config.json ``` -## 3. Afbeelding of bestand toevoegen +## 3. Afbeeldingen of bestanden toevoegen Om een afbeelding toe te voegen heb je twee opties. Ofwel verwijs je naar een afbeelding die in de `media` map staat, ofwel verwijs je naar de afbeelding via een link. From a7c13dbfd815869283c05d0b59a524f0f2587d88 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:51:49 +0100 Subject: [PATCH 24/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index dae682119..dff3a9d59 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -76,7 +76,7 @@ repository/ ## 3. Afbeeldingen of bestanden toevoegen Om een afbeelding toe te voegen heb je twee opties. -Ofwel verwijs je naar een afbeelding die in de `media` map staat, ofwel verwijs je naar de afbeelding via een link. +Ofwel verwijs je naar een afbeelding die in de map `media` staat, ofwel verwijs je naar de afbeelding via een link. In het voorbeeld komen straks beide manieren aan bod. Download onderstaande afbeelding met het logo van de UGent. Dit is een [directe link](https://styleguide.ugent.be/files/uploads/logo_UGent_NL_RGB_2400_kleur_witbg.png). Rechtsklik op de afbeelding en kies voor `Afbeelding opslaan...`. From 6d2afed80b43a48b3504e9b6aa0743073f516278 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:52:05 +0100 Subject: [PATCH 25/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index dff3a9d59..cef5a71d1 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -83,7 +83,7 @@ Download onderstaande afbeelding met het logo van de UGent. Dit is een [directe ![UGent logo](logo_UGent.png) -Rechtsklik op de `media` map in VS Code web en klik op `Upload...`. +Rechtsklik op de map `media` in VS Code web en klik op `Upload...`. Selecteer de afbeelding van op je computer en klik op `Openen`. Verwijzen naar de afbeelding kan met deze markdown code (zie volgende stap). Het start met een uitroepingsteken (`!`) en tussen de vierkante haken mag je een beschrijving geven van wat er op de afbeelding staat. Tussen de ronde haken staat het pad naar de afbeelding.: \ From 32c239f3256bc661432fea3fee95cc4748b1a588 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:52:38 +0100 Subject: [PATCH 26/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index cef5a71d1..95ea27ea3 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -86,7 +86,9 @@ Download onderstaande afbeelding met het logo van de UGent. Dit is een [directe Rechtsklik op de map `media` in VS Code web en klik op `Upload...`. Selecteer de afbeelding van op je computer en klik op `Openen`. -Verwijzen naar de afbeelding kan met deze markdown code (zie volgende stap). Het start met een uitroepingsteken (`!`) en tussen de vierkante haken mag je een beschrijving geven van wat er op de afbeelding staat. Tussen de ronde haken staat het pad naar de afbeelding.: \ +Verwijzen naar de afbeelding als volgt. +De code start met een uitroepingsteken (`!`) en tussen de vierkante haken zet je een beschrijving van de afbeelding. +Tussen de ronde haken staat het pad naar de afbeelding. `![UGent logo](media/logo_UGent.png)` ## 4. Inhoud From 8b9f2a5a0dcabcb8bec416e7a708bfc3b3a4f8de Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:53:38 +0100 Subject: [PATCH 27/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 95ea27ea3..5bec0bff6 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -89,7 +89,7 @@ Selecteer de afbeelding van op je computer en klik op `Openen`. Verwijzen naar de afbeelding als volgt. De code start met een uitroepingsteken (`!`) en tussen de vierkante haken zet je een beschrijving van de afbeelding. Tussen de ronde haken staat het pad naar de afbeelding. -`![UGent logo](media/logo_UGent.png)` +`![Logo van de UGent](media/logo_UGent.png)` ## 4. Inhoud From dd0938059bd3064b36bd9dd38ff8d65ae932a6c5 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:55:49 +0100 Subject: [PATCH 28/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 5bec0bff6..10d6b7981 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -105,7 +105,7 @@ Dit is een voorbeeldzin met woorden in *cursief*, **vet** en met variabel `resul ## Links en afbeeldingen -Dit is een zin waarbij [deze woorden](https://docs.dodona.be/nl/references/exercise-description/) linken naar de Dodona handleiding over Markdown. +Dit is een zin waarbij [deze woorden](https://docs.dodona.be/nl/references/exercise-description/) linken naar de Dodona-handleiding over Markdown. Hieronder staat het Dodona logo afgebeeld via een link. ![Dodona logo](https://dodona.be/icon.png) From 90f0dd51fb8c891b223d893ebae34aa6535f1140 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:57:08 +0100 Subject: [PATCH 29/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 10d6b7981..dbda2478d 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -106,7 +106,7 @@ Dit is een voorbeeldzin met woorden in *cursief*, **vet** en met variabel `resul ## Links en afbeeldingen Dit is een zin waarbij [deze woorden](https://docs.dodona.be/nl/references/exercise-description/) linken naar de Dodona-handleiding over Markdown. -Hieronder staat het Dodona logo afgebeeld via een link. +Hieronder staat het Dodona-logo afgebeeld via een link. ![Dodona logo](https://dodona.be/icon.png) From ae2ff689f9857ad76b4d1b50bad8470cfb04ca1c Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:57:23 +0100 Subject: [PATCH 30/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index dbda2478d..84b7dfde5 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -110,7 +110,7 @@ Hieronder staat het Dodona-logo afgebeeld via een link. ![Dodona logo](https://dodona.be/icon.png) -Er wordt rechtstreeks verwezen naar het logo van de UGent in de `media` map. +Er wordt rechtstreeks verwezen naar het logo van de UGent in de map `media`. ![UGent logo](media/logo_UGent.png) From 7326551f81241f141401ea784b173763aa490275 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 16:58:43 +0100 Subject: [PATCH 31/51] Update nl/guides/exercises/creating-exercises/content/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/creating-exercises/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/creating-exercises/content/index.md index 84b7dfde5..349498282 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/creating-exercises/content/index.md @@ -166,7 +166,7 @@ Dit is geen quote. ```` Als je ook Engelstalige inhoud wilt maken, gebruik je de naam `description.en.md` voor het tweede bestand. -De inhoud wordt geschreven in Markdown, een redelijk eenvoudig opmaakformaat. Meer informatie over Markdown is [hier](/nl/references/exercise-description) te vinden. +De inhoud van leesactiviteiten wordt geschreven in Markdown, een redelijk eenvoudig opmaakformaat. Meer informatie over Markdown is [hier](/nl/references/exercise-description) te vinden. Nadat je deze twee bestanden gemaakt hebt, moet je repository er zo uitzien: From 80a2c7586f557d6931dbee15162910a7ac32a9e4 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 17:00:46 +0100 Subject: [PATCH 32/51] Update nl/guides/exercises/examples/input-output/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/examples/input-output/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/nl/guides/exercises/examples/input-output/index.md b/nl/guides/exercises/examples/input-output/index.md index 18b8d0aff..c956de91b 100644 --- a/nl/guides/exercises/examples/input-output/index.md +++ b/nl/guides/exercises/examples/input-output/index.md @@ -128,7 +128,8 @@ repository/ ## 4. Een testplan maken We willen dat deze oefening automatisch getest wordt. -Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. +Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. +Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. Deze oefening heeft natuurlijk een aantal voor de hand liggende testen, waarbij verschillende namen geprobeerd worden. Ook kunnen we eens een naam met cijfers of speciale tekens invullen. From a2a669b26e377aebac9571875107d04fc8371fcd Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 17:01:11 +0100 Subject: [PATCH 33/51] Update nl/guides/exercises/examples/command-line/index.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/examples/command-line/index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/nl/guides/exercises/examples/command-line/index.md b/nl/guides/exercises/examples/command-line/index.md index b53112288..abe9d64ff 100644 --- a/nl/guides/exercises/examples/command-line/index.md +++ b/nl/guides/exercises/examples/command-line/index.md @@ -141,7 +141,8 @@ repository/ ## 4. Een testplan maken We willen dat deze oefening automatisch getest wordt. -Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. +Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. +Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. Om dit kort te houden, beperken we ons testplan tot een aantal testen. Maak een bestand `suite.yaml` in de map `evaluation` met volgende inhoud: From 4bd601cf2c50b73a1d96b50bdbf6629a741abd09 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 17:01:32 +0100 Subject: [PATCH 34/51] Update nl/guides/exercises/examples/_common.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/examples/_common.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/nl/guides/exercises/examples/_common.md b/nl/guides/exercises/examples/_common.md index ce6909c0a..c87d27c64 100644 --- a/nl/guides/exercises/examples/_common.md +++ b/nl/guides/exercises/examples/_common.md @@ -110,7 +110,8 @@ repository/ ## 4. Een testplan maken We willen dat deze oefening automatisch getest wordt. -Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. +Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. +Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. In dit geval houden we het testplan kort, met slechts een beperkt aantal testgevallen. In een echte oefening wil je waarschijnlijk meer testgevallen voorzien. From a3761918edd33d21ea84b5a182e6d438bff5270b Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 17:01:54 +0100 Subject: [PATCH 35/51] Update nl/guides/exercises/examples/_common.md Co-authored-by: Niko Strijbol --- nl/guides/exercises/examples/_common.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/guides/exercises/examples/_common.md b/nl/guides/exercises/examples/_common.md index c87d27c64..22950b733 100644 --- a/nl/guides/exercises/examples/_common.md +++ b/nl/guides/exercises/examples/_common.md @@ -45,7 +45,7 @@ In dit bestand worden drie dingen gespecifieerd: - `names`: De **namen** van de oefening zoals getoond door Dodona in het Nederlands (_nl_) en in het Engels (_en_) (in dit geval zijn beide namen hetzelfde). - `programming_language`: De **programmeertaal** van de oefening: hier kies je in welke programmeertaal je de oplossingen wilt. In dit geval is dat Python. -- `acces`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). +- `access`: Het **toegangsniveau** is hier _private_. We kiezen voor een private oefening omdat dit maar een handleiding is, maar we moedigen aan om je oefeningen publiek (_public_) te zetten: dan kunnen andere leerkrachten er ook gebruik van maken (net zoals jij de keuze hebt uit duizenden publieke oefeningen op Dodona). Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien: From 177dedc525b002bdba5e3c0455596d51f5339ad8 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 17:09:11 +0100 Subject: [PATCH 36/51] remove idea and add item to index --- .idea/.gitignore | 8 ------- .idea/dodona-edu.github.io.iml | 10 -------- .idea/inspectionProfiles/Project_Default.xml | 19 --------------- .../inspectionProfiles/profiles_settings.xml | 6 ----- .idea/jupyter-settings.xml | 23 ------------------- .idea/misc.xml | 7 ------ .idea/vcs.xml | 6 ----- en/faq/index.md | 1 + nl/faq/index.md | 1 + 9 files changed, 2 insertions(+), 79 deletions(-) delete mode 100644 .idea/.gitignore delete mode 100644 .idea/dodona-edu.github.io.iml delete mode 100644 .idea/inspectionProfiles/Project_Default.xml delete mode 100644 .idea/inspectionProfiles/profiles_settings.xml delete mode 100644 .idea/jupyter-settings.xml delete mode 100644 .idea/misc.xml delete mode 100644 .idea/vcs.xml diff --git a/.idea/.gitignore b/.idea/.gitignore deleted file mode 100644 index 13566b81b..000000000 --- a/.idea/.gitignore +++ /dev/null @@ -1,8 +0,0 @@ -# Default ignored files -/shelf/ -/workspace.xml -# Editor-based HTTP Client requests -/httpRequests/ -# Datasource local storage ignored files -/dataSources/ -/dataSources.local.xml diff --git a/.idea/dodona-edu.github.io.iml b/.idea/dodona-edu.github.io.iml deleted file mode 100644 index a2e196b87..000000000 --- a/.idea/dodona-edu.github.io.iml +++ /dev/null @@ -1,10 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml deleted file mode 100644 index c93289031..000000000 --- a/.idea/inspectionProfiles/Project_Default.xml +++ /dev/null @@ -1,19 +0,0 @@ - - - - \ No newline at end of file diff --git a/.idea/inspectionProfiles/profiles_settings.xml b/.idea/inspectionProfiles/profiles_settings.xml deleted file mode 100644 index 105ce2da2..000000000 --- a/.idea/inspectionProfiles/profiles_settings.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - \ No newline at end of file diff --git a/.idea/jupyter-settings.xml b/.idea/jupyter-settings.xml deleted file mode 100644 index 77bdda4e6..000000000 --- a/.idea/jupyter-settings.xml +++ /dev/null @@ -1,23 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/.idea/misc.xml b/.idea/misc.xml deleted file mode 100644 index 812ab5a68..000000000 --- a/.idea/misc.xml +++ /dev/null @@ -1,7 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml deleted file mode 100644 index 35eb1ddfb..000000000 --- a/.idea/vcs.xml +++ /dev/null @@ -1,6 +0,0 @@ - - - - - - \ No newline at end of file diff --git a/en/faq/index.md b/en/faq/index.md index 15db63ba4..e978a7081 100644 --- a/en/faq/index.md +++ b/en/faq/index.md @@ -21,6 +21,7 @@ In this FAQ section you will find answers to the most frequently asked questions ## Exercises and reading activities - [What is a draft activity?](./activities/#what-is-a-draft-activity) - [How do I create new exercises?](./activities/#how-do-i-create-new-exercises) +- [What is the difference between a course and a repository?](./activities/what-is-the-difference-between-a-course-and-a-repository) ## Featured courses - [What is a featured courses?](./featured-courses/#what-is-a-featured-course) diff --git a/nl/faq/index.md b/nl/faq/index.md index 012d6fb81..c86047ea0 100644 --- a/nl/faq/index.md +++ b/nl/faq/index.md @@ -28,6 +28,7 @@ In deze FAQ-sectie vind je antwoorden op de meest gestelde vragen over het gebru ## Oefeningen en leesactiviteiten - [Wat is een concept?](./activities/#wat-is-een-conceptactiviteit) - [Hoe maak ik nieuwe oefeningen aan?](./activities/#hoe-maak-ik-nieuwe-oefeningen-aan) +- [Wat is het verschil tussen een cursus en een repository?](./activities/#wat-is-het-verschil-tussen-een-cursus-en-een-repository?) ## Uitgelichte cursussen - [Wat is een uitgelichte cursus?](./featured-courses/#wat-is-een-uitgelichte-cursus) From 379a013a44af1cbf0d96be5aff0ac4e4368c6c8a Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 17:15:50 +0100 Subject: [PATCH 37/51] change link --- en/references/judges/index.md | 2 +- nl/references/judges/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/en/references/judges/index.md b/en/references/judges/index.md index 47a3983ed..8f00ec270 100644 --- a/en/references/judges/index.md +++ b/en/references/judges/index.md @@ -6,7 +6,7 @@ order: 6 # Judges -On [this page](https://dodona.be/en/judges/) you can find an overview of all judges that are available on Dodona. A judge is a piece of software that is responsible for testing the solutions of students and writing the results in a format that Dodona understands. +On Dodona (https://dodona.be/en/judges/) you can find an overview of all judges that are available on Dodona. A judge is a piece of software that is responsible for testing the solutions of students and writing the results in a format that Dodona understands. Most judges only support one programming language, but there are also judges like [TESTed](#TESTed) that support multiple programming languages. diff --git a/nl/references/judges/index.md b/nl/references/judges/index.md index d010f9fa2..64db1d06a 100644 --- a/nl/references/judges/index.md +++ b/nl/references/judges/index.md @@ -6,7 +6,7 @@ order: 6 # Judges -Op [deze pagina](https://dodona.be/nl/judges/) vind je een overzicht van alle judges die beschikbaar zijn op Dodona. Een judge is een stukje software dat verantwoordelijk is om de oplossingen van studenten te testen en de resultaten hiervan weg te schrijven in een formaat dat Dodona begrijpt. +Op Dodona (https://dodona.be/nl/judges/) vind je een overzicht van alle judges die beschikbaar zijn op Dodona. Een judge is een stukje software dat verantwoordelijk is om de oplossingen van studenten te testen en de resultaten hiervan weg te schrijven in een formaat dat Dodona begrijpt. De meeste judges ondersteunen maar één programmeertaal, maar er zijn ook judges zoals [TESTed](#TESTed) die meerdere programmeertalen ondersteunen. From 50390c09d4c2c24a4a0bc7d119d964373338af3e Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 17:33:35 +0100 Subject: [PATCH 38/51] whitespace --- nl/references/exercise-description/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index 2055b01a9..b85efd172 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -261,7 +261,7 @@ Als je Markdown gebruikt, plaats dan *backticks* (\`) rond je code. Je kan ook d ```markdown Gebruik de variabele `some_variable` in je oplossing. - Gebruik de verkorte notatie `result += 1`{:.language-python}. +Gebruik de verkorte notatie `result += 1`{:.language-python}. ``` ### Blokken code From d65b0b324f53f918ee6aad1227a8077a8fedcab2 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Thu, 11 Jan 2024 18:00:53 +0100 Subject: [PATCH 39/51] Adjust capitalization to current state of dodona.be --- en/guides/students/courses/index.md | 8 ++++---- en/guides/teachers/course-management/index.md | 4 ++-- en/guides/teachers/creating-a-course/index.md | 4 ++-- en/guides/teachers/exercise-series-management/index.md | 8 ++++---- en/guides/teachers/getting-started/index.md | 4 ++-- en/guides/teachers/ufora/index.md | 2 +- en/references/exercise-description/index.md | 2 +- en/references/judges/python-judge/index.md | 2 +- nl/guides/students/courses/index.md | 8 ++++---- nl/guides/teachers/course-management/index.md | 4 ++-- nl/guides/teachers/creating-a-course/index.md | 4 ++-- nl/guides/teachers/exercise-series-management/index.md | 8 ++++---- nl/guides/teachers/getting-started/index.md | 4 ++-- nl/references/exercise-description/index.md | 2 +- nl/references/judges/python-judge/index.md | 2 +- 15 files changed, 33 insertions(+), 33 deletions(-) diff --git a/en/guides/students/courses/index.md b/en/guides/students/courses/index.md index 2c4c72dbd..98948f922 100644 --- a/en/guides/students/courses/index.md +++ b/en/guides/students/courses/index.md @@ -24,7 +24,7 @@ Om oplossingen voor oefeningen in een cursus te kunnen indienen moet je in die c ### Hoe vind je een cursus? -Eerst moet je de cursus waarvoor je wil registreren vinden. Dit kan je doen door op je startpagina op `MEER CURSUSSEN...` of op `VERKEN CURSUSSEN` te klikken. +Eerst moet je de cursus waarvoor je wil registreren vinden. Dit kan je doen door op je startpagina op `Meer cursussen...` of op `Verken cursussen` te klikken. ![image](./student.explore_courses.png) @@ -36,13 +36,13 @@ Dit zal je naar een [overzicht van alle cursussen](https://dodona.be/nl/courses/ Als je navigeert naar de cursus dat je zocht, waarvoor je nog niet geregistreerd bent, dan zie je bovenaan de cursuspagina een paneel dat aangeeft of en hoe je je voor de cursus kan registreren. Hierbij zijn er drie mogelijkheden afhankelijk van hoe de cursus geconfigureerd werd: -- De cursus werkt met een **open registratieprocedure**, wat betekent dat iedereen zich voor de cursus kan registreren zonder expliciete goedkeuring van een cursusbeheerder. Klik op de knop `REGISTREREN` om je voor de cursus te registreren. +- De cursus werkt met een **open registratieprocedure**, wat betekent dat iedereen zich voor de cursus kan registreren zonder expliciete goedkeuring van een cursusbeheerder. Klik op de knop `Registreren` om je voor de cursus te registreren. ![image](./register.png)

-- De cursus werkt met een **gemodereerde registratieprocedure**, wat betekent dat je een **registratieverzoek** kunt indienen dat daarna dient goedgekeurd of afgekeurd te worden door een cursusbeheerder. Pas wanneer je registratieverzoek wordt goedgekeurd, ben je ook effectief geregistreerd voor de cursus. Klik op de knop `REGISTRATIEVERZOEK INDIENEN` om een registratieverzoek voor de cursus in te dienen. +- De cursus werkt met een **gemodereerde registratieprocedure**, wat betekent dat je een **registratieverzoek** kunt indienen dat daarna dient goedgekeurd of afgekeurd te worden door een cursusbeheerder. Pas wanneer je registratieverzoek wordt goedgekeurd, ben je ook effectief geregistreerd voor de cursus. Klik op de knop `Registratieverzoek indienen` om een registratieverzoek voor de cursus in te dienen. ![image](./moderated_register.png) @@ -126,7 +126,7 @@ Als je **na het verstrijken van de deadline** van een oefeningenreeks een oploss ## Uitschrijven uit een cursus -Als je navigeert naar een cursus waarvoor je [geregistreerd](#registreren-voor-een-cursus) bent of waarvoor je nog een registratieverzoek hebt openstaan, dan zie je onder de beschrijving van de cursus op de cursuspagina een knop `UITSCHRIJVEN` (of `REGISTRATIEVERZOEK ANNULEREN`) waarmee je je kunt uitschrijven uit de cursus. +Als je navigeert naar een cursus waarvoor je [geregistreerd](#registreren-voor-een-cursus) bent of waarvoor je nog een registratieverzoek hebt openstaan, dan zie je onder de beschrijving van de cursus op de cursuspagina een knop `Uitschrijven` (of `Registratieverzoek annuleren`) waarmee je je kunt uitschrijven uit de cursus. ![image](./student.unregister.png) diff --git a/en/guides/teachers/course-management/index.md b/en/guides/teachers/course-management/index.md index e6fbb1b91..07e9009dc 100644 --- a/en/guides/teachers/course-management/index.md +++ b/en/guides/teachers/course-management/index.md @@ -28,7 +28,7 @@ Om de eigenschappen van een bestaande cursus te bewerken, navigeer je naar de cu Je komt op een pagina terecht waar je de naam, lesgevers, beschrijving, academiejaar, zichtbaarheid en registratieprocedure kan aanpassen. Voor meer details over de specifieke eigenschappen kan je terecht op [deze pagina](../creating-a-course/#cursuseigenschappen). -Klik na het aanpassen op de afwerkknop in de rechterbovenhoek van het paneel om de nieuwe cursuseigenschappen op te slaan. Alternatief kan je ook op de `AANPASSEN` klikken onderaan het paneel. Daarna navigeer je automatisch terug naar de cursuspagina waar de nieuwe cursuseigenschappen onmiddellijk van toepassing zijn. +Klik na het aanpassen op de afwerkknop in de rechterbovenhoek van het paneel om de nieuwe cursuseigenschappen op te slaan. Alternatief kan je ook op de `Aanpassen` klikken onderaan het paneel. Daarna navigeer je automatisch terug naar de cursuspagina waar de nieuwe cursuseigenschappen onmiddellijk van toepassing zijn. ![image](./staff.course_after_edit.png) @@ -55,7 +55,7 @@ Als je klikt op het filter-icoontje voor de naam van een student of oefening, da Deze oplossingen kan je ook op andere manieren bereiken: * Een overzicht van de oplossingen voor een **specifieke oefening** vind je door op de cursuspagina op het pijltje rechts van een oefening te klikken. -* Een overzicht van de oplossingen voor **specifieke gebruiker** vind je door op `OPLOSSINGEN` te klikken op de [cursuspagina van die gebruiker](../user-management/#studenten-opvolgen). +* Een overzicht van de oplossingen voor **specifieke gebruiker** vind je door op `Oplossingen` te klikken op de [cursuspagina van die gebruiker](../user-management/#studenten-opvolgen). In het oplossingenoverzicht vindt je rechts van de filterbalk een knop met 3 puntjes. In het menu vindt je enkele acties en filter: diff --git a/en/guides/teachers/creating-a-course/index.md b/en/guides/teachers/creating-a-course/index.md index 2cda47cc4..7d0dddf4a 100644 --- a/en/guides/teachers/creating-a-course/index.md +++ b/en/guides/teachers/creating-a-course/index.md @@ -16,7 +16,7 @@ Je hebt extra rechten nodig om een cursus te kunnen aanmaken. Je kan deze rechte ::: -Als je de nodige rechten hebt op Dodona, dan kan je eenvoudig zelf een cursus aanmaken. Dit doe je door op de knop `CURSUS AANMAKEN` te klikken in de rechterbovenhoek van het [cursusoverzicht](https://dodona.be/nl/courses). Vanaf de landingspagina bereik je dit overzicht door te klikken op `MEER CURSUSSEN...`. +Als je de nodige rechten hebt op Dodona, dan kan je eenvoudig zelf een cursus aanmaken. Dit doe je door op de knop `Cursus aanmaken` te klikken in de rechterbovenhoek van het [cursusoverzicht](https://dodona.be/nl/courses). Vanaf de landingspagina bereik je dit overzicht door te klikken op `Meer cursussen...`. ![create course](./staff.courses_new_link.png) @@ -83,7 +83,7 @@ Finaal moet je nog enkele zaken over de cursus zelf, zoals de naam en lesgever, Als je de registratieprocedure aanpast, dan blijven bestaande registraties voor de cursus gelden en blijven registratieverzoeken voor de cursus openstaan. Je moet zelf de bestaande registratiestatus van cursusgebruikers aanpassen. ::: -Eenmaal alles naar wens is ingesteld klik je op de knop `CURSUS AANMAKEN` om je cursus definitief aan te maken. +Eenmaal alles naar wens is ingesteld klik je op de knop `Cursus aanmaken` om je cursus definitief aan te maken. Na het aanmaken van de nieuwe cursus navigeer je automatisch naar de cursuspagina, waar je kunt vaststellen dat je automatisch geregistreerd bent als cursusgebruiker en dat je aangeduid bent als cursusbeheerder. diff --git a/en/guides/teachers/exercise-series-management/index.md b/en/guides/teachers/exercise-series-management/index.md index 251b3f837..6216f7503 100644 --- a/en/guides/teachers/exercise-series-management/index.md +++ b/en/guides/teachers/exercise-series-management/index.md @@ -17,11 +17,11 @@ Het leerpad van een cursus bestaat uit verschillende oefeningenreeksen die elk o ## Oefeningenreeks aanmaken -Een cursusbeheerder kan onbeperkt oefeningenreeksen binnen je cursus aanmaken. Je doet dit door eerst naar de cursuspagina van de cursus te navigeren en vervolgens `REEKSEN BEHEREN` aan te klikken. +Een cursusbeheerder kan onbeperkt oefeningenreeksen binnen je cursus aanmaken. Je doet dit door eerst naar de cursuspagina van de cursus te navigeren en vervolgens `Reeksen beheren` aan te klikken. ![reeksen beheren](./staff.course_manage_series_button.png) -Op deze pagina vind je rechtsboven de knop `REEKS AANMAKEN`. +Op deze pagina vind je rechtsboven de knop `Reeks aanmaken`. ![reeks aanmaken](./staff.course_new_series_button.png) @@ -163,11 +163,11 @@ In het actiemenu van een reeks kan je als lesgever ook kiezen om de ingezonden c Dit brengt je naar een exporteerpagina waar je eerst gevraagd wordt om de oefeningen in de reeks te selecteren waarvan je de inzendingen wenst. ![oefeningen kiezen](./staff.series_export_exercise_choice.png) -Als je ze allemaal wenst te downloaden, dan kies je het selectievakje in de hoofding van de tabel. Daarna klik je op `VOLGENDE STAP` om verder te gaan. +Als je ze allemaal wenst te downloaden, dan kies je het selectievakje in de hoofding van de tabel. Daarna klik je op `Volgende stap` om verder te gaan. Vervolgens kan je verschillende opties aanvinken die de inhoud van de export beïnvloeden. Je kan een samenvattende csv verkrijgen, kiezen of je alle oplossingen of enkel de laatste wil, of er rekening gehouden moet worden met de deadline, of de bestanden per student of per reeks gegroepeerd moeten worden en welke studenten meegerekend moeten worden. ![export opties](./staff.series_export_options.png) -Klik op `START EXPORT` om de download te starten. Je komt op de exportpagina die je zal verwittigen als je export klaar is. Meestal is dit binnen enkele seconden al het geval. +Klik op `Start export` om de download te starten. Je komt op de exportpagina die je zal verwittigen als je export klaar is. Meestal is dit binnen enkele seconden al het geval. ![export gestart](./staff.series_export_started.png) diff --git a/en/guides/teachers/getting-started/index.md b/en/guides/teachers/getting-started/index.md index c78c807ad..e61fce798 100644 --- a/en/guides/teachers/getting-started/index.md +++ b/en/guides/teachers/getting-started/index.md @@ -34,7 +34,7 @@ Een standaard Dodona-account kan zich vrij inschrijven voor cursussen en onbeper ## Een cursus aanmaken -Eenmaal we je lesgeversrechten hebben geactiveerd kan zelf een cursus aanmaken door op de knop `CURSUS AANMAKEN` te klikken in het [cursusoverzicht](https://dodona.be/nl/courses/). +Eenmaal we je lesgeversrechten hebben geactiveerd kan zelf een cursus aanmaken door op de knop `Cursus aanmaken` te klikken in het [cursusoverzicht](https://dodona.be/nl/courses/). ![cursus aanmaken](./cursus-aanmaken.png) @@ -47,7 +47,7 @@ Vervolgens kan je kiezen om te starten vanaf een lege cursus, of om de inhoud va ## Een cursus opstellen -Een cursus op Dodona bestaat uit verschillende oefeningenreeksen die je kan gebruiken om oefeningen te groeperen. Om een nieuwe oefeningenreeks aan te maken, klik je op de `REEKSEN BEHEREN` knop op je cursuspagina en vervolgens op `REEKS AANMAKEN`. Je krijgt dan onderstaand formulier te zien. +Een cursus op Dodona bestaat uit verschillende oefeningenreeksen die je kan gebruiken om oefeningen te groeperen. Om een nieuwe oefeningenreeks aan te maken, klik je op de `Reeksen beheren` knop op je cursuspagina en vervolgens op `Reeks aanmaken`. Je krijgt dan onderstaand formulier te zien. ![reeks-aanmaken](./reeks-aanmaken.png) diff --git a/en/guides/teachers/ufora/index.md b/en/guides/teachers/ufora/index.md index ccf027a09..5bca47e78 100644 --- a/en/guides/teachers/ufora/index.md +++ b/en/guides/teachers/ufora/index.md @@ -39,7 +39,7 @@ Using the ctrl button (or command on a Mac) on your keyboard, you can select one ## 4. Select 'Open as external resource' -After clicking on the `confirm` button, the dialog closes and the chosen exercises should appear on Ufora. **Watch out!** You're not done yet. By default, Ufora will open links to Dodona in a small inline window. You can easily fix this: +After clicking on the `Confirm` button, the dialog closes and the chosen exercises should appear on Ufora. **Watch out!** You're not done yet. By default, Ufora will open links to Dodona in a small inline window. You can easily fix this: - Click on the arrow next to the exercise name - Click on `Edit Properties In-place` - Select the `Open as External Resource` checkbox diff --git a/en/references/exercise-description/index.md b/en/references/exercise-description/index.md index 3ab9a19e1..838830f47 100644 --- a/en/references/exercise-description/index.md +++ b/en/references/exercise-description/index.md @@ -8,7 +8,7 @@ order: 1 > Dodona supports exercise descriptions and reading activities in HTML and Markdown with several additional features such as support for mathematical formulas. -These features are available for both exercises and reading activities. They are rendered in exactly the same way. The only difference is that exercises have a text editor at the bottom of the exercise description, where a reading activity has a `MARK AS READ` button. +These features are available for both exercises and reading activities. They are rendered in exactly the same way. The only difference is that exercises have a text editor at the bottom of the exercise description, where a reading activity has a `Mark as read` button. ## Markdown diff --git a/en/references/judges/python-judge/index.md b/en/references/judges/python-judge/index.md index 2111b9ee1..ff8f04c87 100644 --- a/en/references/judges/python-judge/index.md +++ b/en/references/judges/python-judge/index.md @@ -313,7 +313,7 @@ Er zijn nog meer standaard processors, maar deze zijn nogal specifiek. Ze worden ### Outputprocessors definiëren -Om een eigen ouput processor te definiëren introduceren we de `DEFINITION` tag. Deze tag laat toe om wat dan ook te definiëren in de scope van de doctest. +Om een eigen output processor te definiëren introduceren we de `DEFINITION` tag. Deze tag laat toe om wat dan ook te definiëren in de scope van de doctest. ```python >>> my_new_function() #doctest: STDOUT diff --git a/nl/guides/students/courses/index.md b/nl/guides/students/courses/index.md index 00343f5df..c3c46cb0b 100644 --- a/nl/guides/students/courses/index.md +++ b/nl/guides/students/courses/index.md @@ -17,7 +17,7 @@ Om oplossingen voor oefeningen in een cursus te kunnen indienen moet je in die c ### Hoe vind je een cursus? -Eerst moet je de cursus waarvoor je wil registreren vinden. Dit kan je doen door op je startpagina op `MEER CURSUSSEN...` of op `VERKEN CURSUSSEN` te klikken. +Eerst moet je de cursus waarvoor je wil registreren vinden. Dit kan je doen door op je startpagina op `Meer cursussen...` of op `Verken cursussen` te klikken. ![image](./student.explore_courses.png) @@ -29,13 +29,13 @@ Dit zal je naar een [overzicht van alle cursussen](https://dodona.be/nl/courses/ Als je navigeert naar de cursus dat je zocht, waarvoor je nog niet geregistreerd bent, dan zie je bovenaan de cursuspagina een paneel dat aangeeft of en hoe je je voor de cursus kan registreren. Hierbij zijn er drie mogelijkheden afhankelijk van hoe de cursus geconfigureerd werd: -- De cursus werkt met een **open registratieprocedure**, wat betekent dat iedereen zich voor de cursus kan registreren zonder expliciete goedkeuring van een cursusbeheerder. Klik op de knop `REGISTREREN` om je voor de cursus te registreren. +- De cursus werkt met een **open registratieprocedure**, wat betekent dat iedereen zich voor de cursus kan registreren zonder expliciete goedkeuring van een cursusbeheerder. Klik op de knop `Registreren` om je voor de cursus te registreren. ![image](./register.png)

-- De cursus werkt met een **gemodereerde registratieprocedure**, wat betekent dat je een **registratieverzoek** kunt indienen dat daarna dient goedgekeurd of afgekeurd te worden door een cursusbeheerder. Pas wanneer je registratieverzoek wordt goedgekeurd, ben je ook effectief geregistreerd voor de cursus. Klik op de knop `REGISTRATIEVERZOEK INDIENEN` om een registratieverzoek voor de cursus in te dienen. +- De cursus werkt met een **gemodereerde registratieprocedure**, wat betekent dat je een **registratieverzoek** kunt indienen dat daarna dient goedgekeurd of afgekeurd te worden door een cursusbeheerder. Pas wanneer je registratieverzoek wordt goedgekeurd, ben je ook effectief geregistreerd voor de cursus. Klik op de knop `Registratieverzoek indienen` om een registratieverzoek voor de cursus in te dienen. ![image](./moderated_register.png) @@ -119,7 +119,7 @@ Als je **na het verstrijken van de deadline** van een oefeningenreeks een oploss ## Uitschrijven uit een cursus -Als je navigeert naar een cursus waarvoor je [geregistreerd](#registreren-voor-een-cursus) bent of waarvoor je nog een registratieverzoek hebt openstaan, dan zie je onder de beschrijving van de cursus op de cursuspagina een knop `UITSCHRIJVEN` (of `REGISTRATIEVERZOEK ANNULEREN`) waarmee je je kunt uitschrijven uit de cursus. +Als je navigeert naar een cursus waarvoor je [geregistreerd](#registreren-voor-een-cursus) bent of waarvoor je nog een registratieverzoek hebt openstaan, dan zie je onder de beschrijving van de cursus op de cursuspagina een knop `Uitschrijven` (of `Registratieverzoek annuleren`) waarmee je je kunt uitschrijven uit de cursus. ![image](./student.unregister.png) diff --git a/nl/guides/teachers/course-management/index.md b/nl/guides/teachers/course-management/index.md index 0ba91952b..f47657d6d 100644 --- a/nl/guides/teachers/course-management/index.md +++ b/nl/guides/teachers/course-management/index.md @@ -22,7 +22,7 @@ Om de eigenschappen van een bestaande cursus te bewerken, navigeer je naar de cu Je komt op een pagina terecht waar je de naam, lesgevers, beschrijving, academiejaar, zichtbaarheid en registratieprocedure kan aanpassen. Voor meer details over de specifieke eigenschappen kan je terecht op [deze pagina](../creating-a-course/#cursuseigenschappen). -Klik na het aanpassen op de afwerkknop in de rechterbovenhoek van het paneel om de nieuwe cursuseigenschappen op te slaan. Alternatief kan je ook op de `AANPASSEN` klikken onderaan het paneel. Daarna navigeer je automatisch terug naar de cursuspagina waar de nieuwe cursuseigenschappen onmiddellijk van toepassing zijn. +Klik na het aanpassen op de afwerkknop in de rechterbovenhoek van het paneel om de nieuwe cursuseigenschappen op te slaan. Alternatief kan je ook op de `Aanpassen` klikken onderaan het paneel. Daarna navigeer je automatisch terug naar de cursuspagina waar de nieuwe cursuseigenschappen onmiddellijk van toepassing zijn. ![image](./staff.course_after_edit.png) @@ -49,7 +49,7 @@ Als je klikt op het filter-icoontje voor de naam van een student of oefening, da Deze oplossingen kan je ook op andere manieren bereiken: * Een overzicht van de oplossingen voor een **specifieke oefening** vind je door op de cursuspagina op het pijltje rechts van een oefening te klikken. -* Een overzicht van de oplossingen voor **specifieke gebruiker** vind je door op `OPLOSSINGEN` te klikken op de [cursuspagina van die gebruiker](../user-management/#studenten-opvolgen). +* Een overzicht van de oplossingen voor **specifieke gebruiker** vind je door op `Oplossingen` te klikken op de [cursuspagina van die gebruiker](../user-management/#studenten-opvolgen). In het oplossingenoverzicht vindt je rechts van de filterbalk een knop met 3 puntjes. In het menu vindt je enkele acties en filter: diff --git a/nl/guides/teachers/creating-a-course/index.md b/nl/guides/teachers/creating-a-course/index.md index 670389999..1d4f08dd2 100644 --- a/nl/guides/teachers/creating-a-course/index.md +++ b/nl/guides/teachers/creating-a-course/index.md @@ -12,7 +12,7 @@ Je hebt extra rechten nodig om een cursus te kunnen aanmaken. Je kan deze rechte ::: -Als je de nodige rechten hebt op Dodona, dan kan je eenvoudig zelf een cursus aanmaken. Dit doe je door op de knop `CURSUS AANMAKEN` te klikken in de rechterbovenhoek van het [cursusoverzicht](https://dodona.be/nl/courses). Vanaf de landingspagina bereik je dit overzicht door te klikken op `MEER CURSUSSEN...`. +Als je de nodige rechten hebt op Dodona, dan kan je eenvoudig zelf een cursus aanmaken. Dit doe je door op de knop `Cursus aanmaken` te klikken in de rechterbovenhoek van het [cursusoverzicht](https://dodona.be/nl/courses). Vanaf de landingspagina bereik je dit overzicht door te klikken op `Meer cursussen...`. ![create course](./staff.courses_new_link.png) @@ -79,7 +79,7 @@ Finaal moet je nog enkele zaken over de cursus zelf, zoals de naam en lesgever, Als je de registratieprocedure aanpast, dan blijven bestaande registraties voor de cursus gelden en blijven registratieverzoeken voor de cursus openstaan. Je moet zelf de bestaande registratiestatus van cursusgebruikers aanpassen. ::: -Eenmaal alles naar wens is ingesteld klik je op de knop `CURSUS AANMAKEN` om je cursus definitief aan te maken. +Eenmaal alles naar wens is ingesteld klik je op de knop `Cursus aanmaken` om je cursus definitief aan te maken. Na het aanmaken van de nieuwe cursus navigeer je automatisch naar de cursuspagina, waar je kunt vaststellen dat je automatisch geregistreerd bent als cursusgebruiker en dat je aangeduid bent als cursusbeheerder. diff --git a/nl/guides/teachers/exercise-series-management/index.md b/nl/guides/teachers/exercise-series-management/index.md index 46e0dec51..68292f62a 100644 --- a/nl/guides/teachers/exercise-series-management/index.md +++ b/nl/guides/teachers/exercise-series-management/index.md @@ -10,11 +10,11 @@ Het leerpad van een cursus bestaat uit verschillende oefeningenreeksen die elk o ## Oefeningenreeks aanmaken -Een cursusbeheerder kan onbeperkt oefeningenreeksen binnen je cursus aanmaken. Je doet dit door eerst naar de cursuspagina van de cursus te navigeren en vervolgens `REEKSEN BEHEREN` aan te klikken. +Een cursusbeheerder kan onbeperkt oefeningenreeksen binnen je cursus aanmaken. Je doet dit door eerst naar de cursuspagina van de cursus te navigeren en vervolgens `Reeksen beheren` aan te klikken. ![reeksen beheren](./staff.course_manage_series_button.png) -Op deze pagina vind je rechtsboven de knop `REEKS AANMAKEN`. +Op deze pagina vind je rechtsboven de knop `Reeks aanmaken`. ![reeks aanmaken](./staff.course_new_series_button.png) @@ -156,11 +156,11 @@ In het actiemenu van een reeks kan je als lesgever ook kiezen om de ingezonden c Dit brengt je naar een exporteerpagina waar je eerst gevraagd wordt om de oefeningen in de reeks te selecteren waarvan je de inzendingen wenst. ![oefeningen kiezen](./staff.series_export_exercise_choice.png) -Als je ze allemaal wenst te downloaden, dan kies je het selectievakje in de hoofding van de tabel. Daarna klik je op `VOLGENDE STAP` om verder te gaan. +Als je ze allemaal wenst te downloaden, dan kies je het selectievakje in de hoofding van de tabel. Daarna klik je op `Volgende stap` om verder te gaan. Vervolgens kan je verschillende opties aanvinken die de inhoud van de export beïnvloeden. Je kan een samenvattende csv verkrijgen, kiezen of je alle oplossingen of enkel de laatste wil, of er rekening gehouden moet worden met de deadline, of de bestanden per student of per reeks gegroepeerd moeten worden en welke studenten meegerekend moeten worden. ![export opties](./staff.series_export_options.png) -Klik op `START EXPORT` om de download te starten. Je komt op de exportpagina die je zal verwittigen als je export klaar is. Meestal is dit binnen enkele seconden al het geval. +Klik op `Start export` om de download te starten. Je komt op de exportpagina die je zal verwittigen als je export klaar is. Meestal is dit binnen enkele seconden al het geval. ![export gestart](./staff.series_export_started.png) diff --git a/nl/guides/teachers/getting-started/index.md b/nl/guides/teachers/getting-started/index.md index 155e5b6b8..446c8c755 100644 --- a/nl/guides/teachers/getting-started/index.md +++ b/nl/guides/teachers/getting-started/index.md @@ -30,7 +30,7 @@ Een standaard Dodona-account kan zich vrij inschrijven voor cursussen en onbeper ## Een cursus aanmaken -Eenmaal we je lesgeversrechten hebben geactiveerd kan zelf een cursus aanmaken door op de knop `CURSUS AANMAKEN` te klikken in het [cursusoverzicht](https://dodona.be/nl/courses/). +Eenmaal we je lesgeversrechten hebben geactiveerd kan zelf een cursus aanmaken door op de knop `Cursus aanmaken` te klikken in het [cursusoverzicht](https://dodona.be/nl/courses/). ![cursus aanmaken](./cursus-aanmaken.png) @@ -43,7 +43,7 @@ Vervolgens kan je kiezen om te starten vanaf een lege cursus, of om de inhoud va ## Een cursus opstellen -Een cursus op Dodona bestaat uit verschillende oefeningenreeksen die je kan gebruiken om oefeningen te groeperen. Om een nieuwe oefeningenreeks aan te maken, klik je op de `REEKSEN BEHEREN` knop op je cursuspagina en vervolgens op `REEKS AANMAKEN`. Je krijgt dan onderstaand formulier te zien. +Een cursus op Dodona bestaat uit verschillende oefeningenreeksen die je kan gebruiken om oefeningen te groeperen. Om een nieuwe oefeningenreeks aan te maken, klik je op de `Reeksen beheren` knop op je cursuspagina en vervolgens op `Reeks aanmaken`. Je krijgt dan onderstaand formulier te zien. ![reeks-aanmaken](./reeks-aanmaken.png) diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index b85efd172..6b70e4296 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -8,7 +8,7 @@ order: 1 > Dodona ondersteunt oefeningbeschrijvingen en leesactiviteiten in HTML en Markdown met verschillende extra features zoals ondersteuning voor wiskundige formules. -De features die op deze pagina beschreven worden zijn beschikbaar voor zowel oefeningen als leesactiviteiten. Ze worden op exact dezelfde manier weergegeven. Het enige verschil is dat oefeningen onderaan de beschrijving een tekst editor hebben, terwijl leesactiviteiten een `MARKEER ALS GELEZEN` knop hebben. +De features die op deze pagina beschreven worden zijn beschikbaar voor zowel oefeningen als leesactiviteiten. Ze worden op exact dezelfde manier weergegeven. Het enige verschil is dat oefeningen onderaan de beschrijving een tekst editor hebben, terwijl leesactiviteiten een `Markeer als gelezen` knop hebben. ## Markdown diff --git a/nl/references/judges/python-judge/index.md b/nl/references/judges/python-judge/index.md index 1f7bef74c..d1741675c 100644 --- a/nl/references/judges/python-judge/index.md +++ b/nl/references/judges/python-judge/index.md @@ -316,7 +316,7 @@ Er zijn nog meer standaard processors, maar deze zijn nogal specifiek. Ze worden ### Outputprocessors definiëren -Om een eigen ouput processor te definiëren introduceren we de `DEFINITION` tag. Deze tag laat toe om wat dan ook te definiëren in de scope van de doctest. +Om een eigen output processor te definiëren introduceren we de `DEFINITION` tag. Deze tag laat toe om wat dan ook te definiëren in de scope van de doctest. ```python >>> my_new_function() #doctest: STDOUT From c20d13788df0115c5fba6787e5fce1db5b6d021a Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Fri, 12 Jan 2024 10:04:59 +0100 Subject: [PATCH 40/51] image size and kramdown --- en/references/exercise-description/index.md | 16 ++++++++++++++++ nl/references/exercise-description/index.md | 16 ++++++++++++++++ 2 files changed, 32 insertions(+) diff --git a/en/references/exercise-description/index.md b/en/references/exercise-description/index.md index 838830f47..7987dfb6c 100644 --- a/en/references/exercise-description/index.md +++ b/en/references/exercise-description/index.md @@ -8,6 +8,10 @@ order: 1 > Dodona supports exercise descriptions and reading activities in HTML and Markdown with several additional features such as support for mathematical formulas. +::: tip Kramdown +Dodona uses [kramdown](https://kramdown.gettalong.org) to render Markdown, which supports a lot of extensions to the standard Markdown. For more explanation on how this formatting works, you can find in [this overview](https://kramdown.gettalong.org/quickref.html). +::: + These features are available for both exercises and reading activities. They are rendered in exactly the same way. The only difference is that exercises have a text editor at the bottom of the exercise description, where a reading activity has a `Mark as read` button. ## Markdown @@ -80,6 +84,18 @@ Which results in: To use images in your description, be sure to put the images in the `description/media/` [directory](/en/references/exercise-directory-structure) of your exercise. +### Set size + +It is possible to set the size of the image using both HTML and kramdown. + +```html +Dodona logo +``` + +```markdown +![Dodona logo](https://dodona.be/icon.png){:width="25%"} +``` + ### Lightboxes Dodona automatically adds [lightbox support](https://en.wikipedia.org/wiki/Lightbox_(JavaScript)) to all images in descriptions. If you click on an image, the image will open in a lightbox. It is possible to specify a caption for an image and to set an alternative (high-resolution) version for use in the lightbox. diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index 6b70e4296..a832f01cc 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -8,6 +8,10 @@ order: 1 > Dodona ondersteunt oefeningbeschrijvingen en leesactiviteiten in HTML en Markdown met verschillende extra features zoals ondersteuning voor wiskundige formules. +::: tip Kramdown +Dodona maakt voor de weergave van Markdown gebruik van [kramdown](https://kramdown.gettalong.org) waardoor heel wat uitbreidingen van de standaard Markdown ondersteund worden. Voor meer uitleg over hoe deze formattering werkt, kan je in [dit overzicht](https://kramdown.gettalong.org/quickref.html) vinden. +::: + De features die op deze pagina beschreven worden zijn beschikbaar voor zowel oefeningen als leesactiviteiten. Ze worden op exact dezelfde manier weergegeven. Het enige verschil is dat oefeningen onderaan de beschrijving een tekst editor hebben, terwijl leesactiviteiten een `Markeer als gelezen` knop hebben. ## Markdown @@ -79,6 +83,18 @@ Opsommingen werken heel natuurlijk in Markdown. Afhankelijk of je een genummerde Om afbeeldingen te gebruiken in je opgave, dien je de afbeeldingen in de `description/media/` [map](/nl/references/exercise-directory-structure) te plaatsen. +### Grootte instellen + +Het is mogelijk om zowel met HTML als kramdown de grootte van de afbeelding in te stellen. + +```html +Dodona logo +``` + +```markdown +![Dodona logo](https://dodona.be/icon.png){:width="25%"} +``` + ### Lightboxes Dodona voegt automatisch een [lightbox](https://en.wikipedia.org/wiki/Lightbox_(JavaScript)) toe aan alle afbeeldingen in een opgave. Dat wil zeggen dat als je op een afbeelding klikt, deze zal openen in een lightbox. Het is ook mogelijk om zo een onderschrift toe te voegen en om een alternatieve (hoge-resolutie) versie van de afbeelding te tonen. From 67c7dc63c0a2cb4db6e3c65943312f783903c642 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 18 Jan 2024 10:44:05 +0100 Subject: [PATCH 41/51] Update nl/faq/activities/index.md Co-authored-by: Niko Strijbol --- nl/faq/activities/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/faq/activities/index.md b/nl/faq/activities/index.md index a9d39c7b0..cc59b2c6d 100644 --- a/nl/faq/activities/index.md +++ b/nl/faq/activities/index.md @@ -15,7 +15,7 @@ Op de startpagina van Dodona kan je al jouw concepten terugvinden onder _Ongepub Als lesgever kan je gebruikmaken van de honderden oefeningen die in Dodona aanwezig zijn, maar je kan ook zelf nieuwe oefeningen aanmaken. Je kan hiervoor [dit stappenplan](/nl/guides/exercises/creating-exercises/introduction) volgen. ## Wat is het verschil tussen een cursus en een repository? -In Dodona is een "oefeningen_repository_" een verzameling oefeningen en leesactiviteiten die beheerd worden in een gelinkte GitHub repository. +In Dodona is een "oefeningenrepository" een verzameling oefeningen en leesactiviteiten die beheerd worden in een gelinkte GitHub repository. Deze oefeningen kunnen dan gebruikt worden in meerdere "cursussen". Een "cursus" in Dodona is opnieuw een verzameling oefeningen en leesactiviteiten gestructureerd in reeksen. Hier kan je bijvoorbeeld oefeningen structureren volgens een gewenst leerpad. From 56d65303166741bd5a23a1e384fa63772d511949 Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 18 Jan 2024 10:44:17 +0100 Subject: [PATCH 42/51] Update nl/faq/index.md Co-authored-by: Niko Strijbol --- nl/faq/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/faq/index.md b/nl/faq/index.md index c86047ea0..9ef6ce452 100644 --- a/nl/faq/index.md +++ b/nl/faq/index.md @@ -28,7 +28,7 @@ In deze FAQ-sectie vind je antwoorden op de meest gestelde vragen over het gebru ## Oefeningen en leesactiviteiten - [Wat is een concept?](./activities/#wat-is-een-conceptactiviteit) - [Hoe maak ik nieuwe oefeningen aan?](./activities/#hoe-maak-ik-nieuwe-oefeningen-aan) -- [Wat is het verschil tussen een cursus en een repository?](./activities/#wat-is-het-verschil-tussen-een-cursus-en-een-repository?) +- [Wat is het verschil tussen een cursus en een repository?](./activities/#wat-is-het-verschil-tussen-een-cursus-en-een-repository) ## Uitgelichte cursussen - [Wat is een uitgelichte cursus?](./featured-courses/#wat-is-een-uitgelichte-cursus) From 1989f754308de31b39573f18e57e8657e7249b2f Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Thu, 18 Jan 2024 10:44:32 +0100 Subject: [PATCH 43/51] Update nl/references/exercise-description/index.md Co-authored-by: Niko Strijbol --- nl/references/exercise-description/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index a832f01cc..7e1567acf 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -12,7 +12,7 @@ order: 1 Dodona maakt voor de weergave van Markdown gebruik van [kramdown](https://kramdown.gettalong.org) waardoor heel wat uitbreidingen van de standaard Markdown ondersteund worden. Voor meer uitleg over hoe deze formattering werkt, kan je in [dit overzicht](https://kramdown.gettalong.org/quickref.html) vinden. ::: -De features die op deze pagina beschreven worden zijn beschikbaar voor zowel oefeningen als leesactiviteiten. Ze worden op exact dezelfde manier weergegeven. Het enige verschil is dat oefeningen onderaan de beschrijving een tekst editor hebben, terwijl leesactiviteiten een `Markeer als gelezen` knop hebben. +De features die op deze pagina beschreven worden zijn beschikbaar voor zowel oefeningen als leesactiviteiten. Ze worden op exact dezelfde manier weergegeven. Het enige verschil is dat oefeningen onderaan de beschrijving een teksteditor hebben, terwijl leesactiviteiten een knop `Markeer als gelezen` hebben. ## Markdown From 58fed523271e25c7d4acea9ee0f52c3cddd1e5cb Mon Sep 17 00:00:00 2001 From: "B. Willems" <56451049+BTWS2@users.noreply.github.com> Date: Mon, 22 Jan 2024 18:40:52 +0100 Subject: [PATCH 44/51] Update en/references/exercise-description/index.md Co-authored-by: Bart Mesuere --- en/references/exercise-description/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/references/exercise-description/index.md b/en/references/exercise-description/index.md index 7987dfb6c..c945e2291 100644 --- a/en/references/exercise-description/index.md +++ b/en/references/exercise-description/index.md @@ -317,7 +317,7 @@ Using Markdown, Dodona can automatically add syntax highlighting if you provide let a = 5; let b = 42; ``` -Syntax highlighting for the Python doctest format can be obtained this way: +Python doctests aren't properly highlighted by default. As a workaround, you can set the language to `console?lang=python&prompt=>>>`: ```console?lang=python&prompt=>>> >>> echo("Hello world!") From 904806b45b14d1389180a1ead2887a5e8c103b7d Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Mon, 22 Jan 2024 18:56:42 +0100 Subject: [PATCH 45/51] doctest and spelling pop-up ingediende oplossing --- en/faq/ide-plugins/index.md | 4 ++-- en/references/judges/python-judge/index.md | 4 ++-- nl/faq/ide-plugins/index.md | 4 ++-- nl/guides/exercises/examples/_common.md | 2 +- nl/guides/exercises/examples/class/index.md | 2 +- nl/guides/exercises/examples/command-line/index.md | 2 +- nl/guides/exercises/examples/input-output/index.md | 2 +- nl/references/exercise-description/index.md | 2 +- nl/references/judges/python-judge/index.md | 2 +- 9 files changed, 12 insertions(+), 12 deletions(-) diff --git a/en/faq/ide-plugins/index.md b/en/faq/ide-plugins/index.md index 3c4230f3a..b1e6e4c72 100644 --- a/en/faq/ide-plugins/index.md +++ b/en/faq/ide-plugins/index.md @@ -42,7 +42,7 @@ After successfully installing the Dodona plugin for PyCharm, you can follow thes 2. **Submit your solution**: After solving the exercise, you can submit your solution directly from PyCharm. Look for a blue check mark in the top right corner of the interface. ![submit to dodona](./pc-check-mark.png) - Clicking this button will submit your code to Dodona and trigger an automatic check. Shortly after submission, you should see a popup in the bottom right corner showing the result of your submission. + Clicking this button will submit your code to Dodona and trigger an automatic check. Shortly after submission, you should see a pop-up in the bottom right corner showing the result of your submission. ![correct solution](./pc-correct.png) If you want to see more details about the result, click on the 'more details' link to open the result in a new browser version. If you would like to resubmit, simply click on the blue check mark again. Remember, you can submit your solution as many times as you like. @@ -78,5 +78,5 @@ To use the Dodona VS Code extension, follow these steps: 2. **Submit your solution:** Once you've solved the exercise, you can easily submit your solution by using the 'Submit to Dodona' command. You can do this by opening the command palette with Ctrl+Shift+P, typing (part of) `Submit to Dodona` and pressing Enter. You can also create a shortcut for this command. This command will submit your code to Dodona and trigger an automatic test. ![Submit](./vs-submit.png) -3. **Check the result:** After a few seconds, a popup should appear in the bottom right corner showing the result of your submission. Clicking the 'View results' button will open the result in a new browser window. You can submit your solution as many times as you like by repeating the same command. +3. **Check the result:** After a few seconds, a pop-up should appear in the bottom right corner showing the result of your submission. Clicking the 'View results' button will open the result in a new browser window. You can submit your solution as many times as you like by repeating the same command. ![correct solution](./vs-correct.png) diff --git a/en/references/judges/python-judge/index.md b/en/references/judges/python-judge/index.md index ff8f04c87..164f075b6 100644 --- a/en/references/judges/python-judge/index.md +++ b/en/references/judges/python-judge/index.md @@ -465,7 +465,7 @@ languages)" and None ### Bestanden -Deze tag heeft drie vormen. Elke vorm zal er voor zorgen dat de naam van het bestand als link naar de inhoud van het bestand in de feedbacktabel terechtkomt. Als de optionele `href` parameter niet is ingevuld zal de inhoud van het bestand getoond worden met een popup. Dit kan voor grote bestanden tot lange wachttijden leiden, aangezien de inhoud twee keer in de feedbacktabel verwerkt zit. Voor grote bestanden kan dus de `href` parameter gebruikt worden. Dit zal er voor zorgen dat de naam van het bestand een link is naar een download van het bestand. Als de `href` parameter leeg is zal er geen link zijn naar de inhoud van het bestand. +Deze tag heeft drie vormen. Elke vorm zal er voor zorgen dat de naam van het bestand als link naar de inhoud van het bestand in de feedbacktabel terechtkomt. Als de optionele `href` parameter niet is ingevuld zal de inhoud van het bestand getoond worden met een pop-up. Dit kan voor grote bestanden tot lange wachttijden leiden, aangezien de inhoud twee keer in de feedbacktabel verwerkt zit. Voor grote bestanden kan dus de `href` parameter gebruikt worden. Dit zal er voor zorgen dat de naam van het bestand een link is naar een download van het bestand. Als de `href` parameter leeg is zal er geen link zijn naar de inhoud van het bestand. - Ingebed @@ -483,7 +483,7 @@ Deze tag heeft drie vormen. Elke vorm zal er voor zorgen dat de naam van het bes - Open bestaand bestand Deze vorm zorgt voor bestaande bestanden. Zo kan de inhoud gelinkt worden aan - de popup. + de pop-up. ``` xml diff --git a/nl/faq/ide-plugins/index.md b/nl/faq/ide-plugins/index.md index 0adc054c5..b60dbc4f3 100644 --- a/nl/faq/ide-plugins/index.md +++ b/nl/faq/ide-plugins/index.md @@ -42,7 +42,7 @@ Nadat je de Dodona-plugin voor PyCharm met succes hebt geïnstalleerd, kun je de 2. **Stuur je oplossing in**: Nadat je de oefening hebt opgelost, kun je je oplossing direct vanuit PyCharm indienen. Zoek hiervoor een blauw vinkje in de rechterbovenhoek van de interface. ![submit to dodona](./pc-check-mark.png) - Als je op deze knop klikt, wordt je code verzonden naar Dodona en automatisch gecontroleerd. Kort na het indienen zou je rechtsonder een popup moeten zien met het resultaat van je indiening. + Als je op deze knop klikt, wordt je code verzonden naar Dodona en automatisch gecontroleerd. Kort na het indienen zou je rechtsonder een pop-up moeten zien met het resultaat van je ingediende oplossing. ![juiste oplossing](./pc-correct.png) Als je meer details over het resultaat wilt zien, klik dan op de link 'more details' om het resultaat in een nieuwe browserversie te openen. Als je opnieuw wilt indienen, klik je gewoon weer op het blauwe vinkje. Onthoud dat je zo vaak kan indienen als je wil. @@ -77,5 +77,5 @@ Volg deze stappen om de Dodona VS Code extensie te gebruiken: 2. **Stuur je oplossing in:** Als je de oefening hebt opgelost, kun je je oplossing eenvoudig insturen met het 'Submit to Dodona' commando. Je kunt dit doen door het opdrachtenpalet te openen met Ctrl+Shift+P, (een deel van) `Submit to Dodona` in te typen en op Enter te drukken. Je kunt ook een snelkoppeling maken voor dit commando. Deze opdracht stuurt je code naar Dodona en activeert een automatische test. ![Submit](./vs-submit.png) -3. **Controleer het resultaat:** Na een paar seconden zou er rechtsonder een popup moeten verschijnen met het resultaat van je oplossing. Als je op de knop 'View results' klikt, wordt het resultaat in een nieuw browservenster geopend. Je kunt je oplossing zo vaak als je wilt insturen door hetzelfde commando te herhalen. +3. **Controleer het resultaat:** Na een paar seconden zou er rechtsonder een pop-up moeten verschijnen met het resultaat van je oplossing. Als je op de knop 'View results' klikt, wordt het resultaat in een nieuw browservenster geopend. Je kunt je oplossing zo vaak als je wilt insturen door hetzelfde commando te herhalen. ![juiste oplossing](./vs-correct.png) diff --git a/nl/guides/exercises/examples/_common.md b/nl/guides/exercises/examples/_common.md index 22950b733..322acb5df 100644 --- a/nl/guides/exercises/examples/_common.md +++ b/nl/guides/exercises/examples/_common.md @@ -111,7 +111,7 @@ repository/ We willen dat deze oefening automatisch getest wordt. Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. -Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. +Als alle testgevallen geslaagd zijn, is de ingediende oplossing van de student volgens Dodona correct. In dit geval houden we het testplan kort, met slechts een beperkt aantal testgevallen. In een echte oefening wil je waarschijnlijk meer testgevallen voorzien. diff --git a/nl/guides/exercises/examples/class/index.md b/nl/guides/exercises/examples/class/index.md index a0053e7e2..5bb6a7aa5 100644 --- a/nl/guides/exercises/examples/class/index.md +++ b/nl/guides/exercises/examples/class/index.md @@ -146,7 +146,7 @@ repository/ ## 4. Een testplan maken We willen dat deze oefening automatisch getest wordt. -Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. +Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. Als alle testgevallen geslaagd zijn, is de ingediende oplossing van de student volgens Dodona correct. Om dit kort te houden, beperken we ons testplan tot een aantal testen. Maak een bestand `suite.yaml` in de map `evaluation` met volgende inhoud: diff --git a/nl/guides/exercises/examples/command-line/index.md b/nl/guides/exercises/examples/command-line/index.md index abe9d64ff..6506da4df 100644 --- a/nl/guides/exercises/examples/command-line/index.md +++ b/nl/guides/exercises/examples/command-line/index.md @@ -142,7 +142,7 @@ repository/ We willen dat deze oefening automatisch getest wordt. Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. -Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. +Als alle testgevallen geslaagd zijn, is de ingediende oplossing van de student volgens Dodona correct. Om dit kort te houden, beperken we ons testplan tot een aantal testen. Maak een bestand `suite.yaml` in de map `evaluation` met volgende inhoud: diff --git a/nl/guides/exercises/examples/input-output/index.md b/nl/guides/exercises/examples/input-output/index.md index c956de91b..f6aad7711 100644 --- a/nl/guides/exercises/examples/input-output/index.md +++ b/nl/guides/exercises/examples/input-output/index.md @@ -129,7 +129,7 @@ repository/ We willen dat deze oefening automatisch getest wordt. Hiervoor moeten we een testplan schrijven, waarin we Dodona vertellen welke testen we allemaal willen uitvoeren. -Als alle testgevallen geslaagd zijn, is de indiening van de student volgens Dodona correct. +Als alle testgevallen geslaagd zijn, is de ingediende oplossing van de student volgens Dodona correct. Deze oefening heeft natuurlijk een aantal voor de hand liggende testen, waarbij verschillende namen geprobeerd worden. Ook kunnen we eens een naam met cijfers of speciale tekens invullen. diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index 7e1567acf..740119336 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -324,7 +324,7 @@ Als je Markdown gebruikt, dan kan Dodona automatisch de code opmaken als je aang let b = 42; ``` -_Syntax highlighting_ voor interactieve sessies, zoals doctests in Python, kan je op deze manier bekomen: +Python doctests worden standaard niet correct gemarkeerd. Als oplossing kan je de taal instellen met `console?lang=python&prompt=>>>`: ```console?lang=python&prompt=>>> >>> echo("Hello world!") diff --git a/nl/references/judges/python-judge/index.md b/nl/references/judges/python-judge/index.md index d1741675c..282eb5aea 100644 --- a/nl/references/judges/python-judge/index.md +++ b/nl/references/judges/python-judge/index.md @@ -468,7 +468,7 @@ languages)" and None ### Bestanden -Deze tag heeft drie vormen. Elke vorm zal er voor zorgen dat de naam van het bestand als link naar de inhoud van het bestand in de feedbacktabel terechtkomt. Als de optionele `href` parameter niet is ingevuld zal de inhoud van het bestand getoond worden met een popup. Dit kan voor grote bestanden tot lange wachttijden leiden, aangezien de inhoud twee keer in de feedbacktabel verwerkt zit. Voor grote bestanden kan dus de `href` parameter gebruikt worden. Dit zal er voor zorgen dat de naam van het bestand een link is naar een download van het bestand. Als de `href` parameter leeg is zal er geen link zijn naar de inhoud van het bestand. +Deze tag heeft drie vormen. Elke vorm zal er voor zorgen dat de naam van het bestand als link naar de inhoud van het bestand in de feedbacktabel terechtkomt. Als de optionele `href` parameter niet is ingevuld zal de inhoud van het bestand getoond worden met een pop-up. Dit kan voor grote bestanden tot lange wachttijden leiden, aangezien de inhoud twee keer in de feedbacktabel verwerkt zit. Voor grote bestanden kan dus de `href` parameter gebruikt worden. Dit zal er voor zorgen dat de naam van het bestand een link is naar een download van het bestand. Als de `href` parameter leeg is zal er geen link zijn naar de inhoud van het bestand. - Ingebed From 4b7783ed6cf6dbab9bc3766c0d75b24be2853709 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Mon, 22 Jan 2024 19:03:39 +0100 Subject: [PATCH 46/51] kramdown --- en/references/exercise-description/index.md | 2 +- nl/references/exercise-description/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/en/references/exercise-description/index.md b/en/references/exercise-description/index.md index c945e2291..6d9e5df18 100644 --- a/en/references/exercise-description/index.md +++ b/en/references/exercise-description/index.md @@ -9,7 +9,7 @@ order: 1 > Dodona supports exercise descriptions and reading activities in HTML and Markdown with several additional features such as support for mathematical formulas. ::: tip Kramdown -Dodona uses [kramdown](https://kramdown.gettalong.org) to render Markdown, which supports a lot of extensions to the standard Markdown. For more explanation on how this formatting works, you can find in [this overview](https://kramdown.gettalong.org/quickref.html). +Dodona uses [kramdown](https://kramdown.gettalong.org) to render Markdown, which supports a lot of extensions to the standard Markdown. Advanced users can find in [this overview](https://kramdown.gettalong.org/quickref.html) more explanation on how this advanced formatting works. ::: These features are available for both exercises and reading activities. They are rendered in exactly the same way. The only difference is that exercises have a text editor at the bottom of the exercise description, where a reading activity has a `Mark as read` button. diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index 740119336..f1ba75343 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -9,7 +9,7 @@ order: 1 > Dodona ondersteunt oefeningbeschrijvingen en leesactiviteiten in HTML en Markdown met verschillende extra features zoals ondersteuning voor wiskundige formules. ::: tip Kramdown -Dodona maakt voor de weergave van Markdown gebruik van [kramdown](https://kramdown.gettalong.org) waardoor heel wat uitbreidingen van de standaard Markdown ondersteund worden. Voor meer uitleg over hoe deze formattering werkt, kan je in [dit overzicht](https://kramdown.gettalong.org/quickref.html) vinden. +Dodona maakt voor de weergave van Markdown gebruik van [kramdown](https://kramdown.gettalong.org) waardoor heel wat uitbreidingen van de standaard Markdown ondersteund worden. Gevorderde gebruikers kunnen in [dit overzicht](https://kramdown.gettalong.org/quickref.html) meer uitleg vinden over hoe deze geavanceerde formattering werkt. ::: De features die op deze pagina beschreven worden zijn beschikbaar voor zowel oefeningen als leesactiviteiten. Ze worden op exact dezelfde manier weergegeven. Het enige verschil is dat oefeningen onderaan de beschrijving een teksteditor hebben, terwijl leesactiviteiten een knop `Markeer als gelezen` hebben. From 1e7306fb0ab46d98062d0fe4ca857c4f021bd8da Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Mon, 22 Jan 2024 19:08:46 +0100 Subject: [PATCH 47/51] advanced --- en/references/exercise-description/index.md | 4 ++-- nl/references/exercise-description/index.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/en/references/exercise-description/index.md b/en/references/exercise-description/index.md index 6d9e5df18..afd301930 100644 --- a/en/references/exercise-description/index.md +++ b/en/references/exercise-description/index.md @@ -8,8 +8,8 @@ order: 1 > Dodona supports exercise descriptions and reading activities in HTML and Markdown with several additional features such as support for mathematical formulas. -::: tip Kramdown -Dodona uses [kramdown](https://kramdown.gettalong.org) to render Markdown, which supports a lot of extensions to the standard Markdown. Advanced users can find in [this overview](https://kramdown.gettalong.org/quickref.html) more explanation on how this advanced formatting works. +::: tip Kramdown +Dodona uses [kramdown](https://kramdown.gettalong.org) to render Markdown, which supports a lot of extensions to the standard Markdown. Advanced users can find in [this overview](https://kramdown.gettalong.org/quickref.html) more explanation on how this formatting works. ::: These features are available for both exercises and reading activities. They are rendered in exactly the same way. The only difference is that exercises have a text editor at the bottom of the exercise description, where a reading activity has a `Mark as read` button. diff --git a/nl/references/exercise-description/index.md b/nl/references/exercise-description/index.md index f1ba75343..64a37f9ad 100644 --- a/nl/references/exercise-description/index.md +++ b/nl/references/exercise-description/index.md @@ -8,8 +8,8 @@ order: 1 > Dodona ondersteunt oefeningbeschrijvingen en leesactiviteiten in HTML en Markdown met verschillende extra features zoals ondersteuning voor wiskundige formules. -::: tip Kramdown -Dodona maakt voor de weergave van Markdown gebruik van [kramdown](https://kramdown.gettalong.org) waardoor heel wat uitbreidingen van de standaard Markdown ondersteund worden. Gevorderde gebruikers kunnen in [dit overzicht](https://kramdown.gettalong.org/quickref.html) meer uitleg vinden over hoe deze geavanceerde formattering werkt. +::: tip Kramdown +Dodona maakt voor de weergave van Markdown gebruik van [kramdown](https://kramdown.gettalong.org) waardoor heel wat uitbreidingen van de standaard Markdown ondersteund worden. Gevorderde gebruikers kunnen in [dit overzicht](https://kramdown.gettalong.org/quickref.html) meer uitleg vinden over hoe deze formattering werkt. ::: De features die op deze pagina beschreven worden zijn beschikbaar voor zowel oefeningen als leesactiviteiten. Ze worden op exact dezelfde manier weergegeven. Het enige verschil is dat oefeningen onderaan de beschrijving een teksteditor hebben, terwijl leesactiviteiten een knop `Markeer als gelezen` hebben. From baf9559141601adf8b1a0650aa5a27089a90e58a Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Mon, 22 Jan 2024 19:11:22 +0100 Subject: [PATCH 48/51] judges --- en/references/judges/index.md | 2 +- nl/references/judges/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/en/references/judges/index.md b/en/references/judges/index.md index 8f00ec270..301668b0d 100644 --- a/en/references/judges/index.md +++ b/en/references/judges/index.md @@ -6,7 +6,7 @@ order: 6 # Judges -On Dodona (https://dodona.be/en/judges/) you can find an overview of all judges that are available on Dodona. A judge is a piece of software that is responsible for testing the solutions of students and writing the results in a format that Dodona understands. +On this page you can find an overview of all judges that are available on Dodona. A judge is a piece of software that is responsible for testing the solutions of students and writing the results in a format that Dodona understands. Most judges only support one programming language, but there are also judges like [TESTed](#TESTed) that support multiple programming languages. diff --git a/nl/references/judges/index.md b/nl/references/judges/index.md index 64db1d06a..83bf85594 100644 --- a/nl/references/judges/index.md +++ b/nl/references/judges/index.md @@ -6,7 +6,7 @@ order: 6 # Judges -Op Dodona (https://dodona.be/nl/judges/) vind je een overzicht van alle judges die beschikbaar zijn op Dodona. Een judge is een stukje software dat verantwoordelijk is om de oplossingen van studenten te testen en de resultaten hiervan weg te schrijven in een formaat dat Dodona begrijpt. +Op deze pagina vind je een overzicht van alle judges die beschikbaar zijn op Dodona. Een judge is een stukje software dat verantwoordelijk is om de oplossingen van studenten te testen en de resultaten hiervan weg te schrijven in een formaat dat Dodona begrijpt. De meeste judges ondersteunen maar één programmeertaal, maar er zijn ook judges zoals [TESTed](#TESTed) die meerdere programmeertalen ondersteunen. From 736c38b65ee3eb30f1a0289a14349c926cc2e8e9 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Mon, 22 Jan 2024 19:15:55 +0100 Subject: [PATCH 49/51] remove courses vs repositories --- en/faq/activities/index.md | 10 ---------- en/faq/index.md | 1 - nl/faq/activities/index.md | 9 --------- nl/faq/index.md | 1 - 4 files changed, 21 deletions(-) diff --git a/en/faq/activities/index.md b/en/faq/activities/index.md index ad42164c8..ac6ebce73 100644 --- a/en/faq/activities/index.md +++ b/en/faq/activities/index.md @@ -14,13 +14,3 @@ On the home page of Dodona, you can find all your drafts under _Draft exercises_ ## How do I create new exercises? As a teacher, you can use the hundreds of exercises that are available in Dodona, but you can also create new exercises yourself. You can follow [this guide](/en/guides/exercises/creating-exercises/introduction) for this. -## What is the difference between a course and a repository? -In Dodona, an "exercises repository" is a collection of exercises and reading activities managed in a linked GitHub repository. -These exercises can then be used in multiple "courses". - -A "course" in Dodona is again a collection of exercises and reading activities structured in sequences. -Here you can, for example, structure exercises according to a desired learning path. -Courses are fully managed within Dodona. -A course can contain exercises from different exercise repositories. -A course also includes enrolled students. -In a course, you can monitor these students, make evaluations, answer questions, etc... diff --git a/en/faq/index.md b/en/faq/index.md index e978a7081..15db63ba4 100644 --- a/en/faq/index.md +++ b/en/faq/index.md @@ -21,7 +21,6 @@ In this FAQ section you will find answers to the most frequently asked questions ## Exercises and reading activities - [What is a draft activity?](./activities/#what-is-a-draft-activity) - [How do I create new exercises?](./activities/#how-do-i-create-new-exercises) -- [What is the difference between a course and a repository?](./activities/what-is-the-difference-between-a-course-and-a-repository) ## Featured courses - [What is a featured courses?](./featured-courses/#what-is-a-featured-course) diff --git a/nl/faq/activities/index.md b/nl/faq/activities/index.md index cc59b2c6d..59fc51c20 100644 --- a/nl/faq/activities/index.md +++ b/nl/faq/activities/index.md @@ -14,12 +14,3 @@ Op de startpagina van Dodona kan je al jouw concepten terugvinden onder _Ongepub ## Hoe maak ik nieuwe oefeningen aan? Als lesgever kan je gebruikmaken van de honderden oefeningen die in Dodona aanwezig zijn, maar je kan ook zelf nieuwe oefeningen aanmaken. Je kan hiervoor [dit stappenplan](/nl/guides/exercises/creating-exercises/introduction) volgen. -## Wat is het verschil tussen een cursus en een repository? -In Dodona is een "oefeningenrepository" een verzameling oefeningen en leesactiviteiten die beheerd worden in een gelinkte GitHub repository. -Deze oefeningen kunnen dan gebruikt worden in meerdere "cursussen". - -Een "cursus" in Dodona is opnieuw een verzameling oefeningen en leesactiviteiten gestructureerd in reeksen. Hier kan je bijvoorbeeld oefeningen structureren volgens een gewenst leerpad. -Cursussen worden volledig beheerd binnen Dodona. -Een cursus kan oefeningen van verschillende oefeningenrepository's bevatten. -Bij een cursus horen ook de ingeschreven studenten. -In een cursus kan je deze studenten opvolgen, evaluaties maken, vragen beantwoorden, etc... diff --git a/nl/faq/index.md b/nl/faq/index.md index 9ef6ce452..012d6fb81 100644 --- a/nl/faq/index.md +++ b/nl/faq/index.md @@ -28,7 +28,6 @@ In deze FAQ-sectie vind je antwoorden op de meest gestelde vragen over het gebru ## Oefeningen en leesactiviteiten - [Wat is een concept?](./activities/#wat-is-een-conceptactiviteit) - [Hoe maak ik nieuwe oefeningen aan?](./activities/#hoe-maak-ik-nieuwe-oefeningen-aan) -- [Wat is het verschil tussen een cursus en een repository?](./activities/#wat-is-het-verschil-tussen-een-cursus-en-een-repository) ## Uitgelichte cursussen - [Wat is een uitgelichte cursus?](./featured-courses/#wat-is-een-uitgelichte-cursus) From 1be24a95633e31ba582d3e9747494fb234c7012b Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Mon, 22 Jan 2024 19:34:12 +0100 Subject: [PATCH 50/51] move content --- en/guides/exercises/examples/class/index.md | 2 +- en/guides/exercises/examples/command-line/index.md | 2 +- .../content/index.md | 4 +--- en/guides/exercises/examples/function/index.md | 2 +- en/guides/exercises/examples/input-output/index.md | 2 +- .../exercises/creating-exercises/exercise/index.md | 2 +- .../creating-exercises/management/index.md | 3 ++- nl/guides/exercises/examples/class/index.md | 2 +- nl/guides/exercises/examples/command-line/index.md | 2 +- .../content/index.md | 8 +++----- .../content/logo_UGent.png | Bin nl/guides/exercises/examples/function/index.md | 2 +- nl/guides/exercises/examples/input-output/index.md | 2 +- 13 files changed, 15 insertions(+), 18 deletions(-) rename en/guides/exercises/{creating-exercises => examples}/content/index.md (80%) rename nl/guides/exercises/{creating-exercises => examples}/content/index.md (96%) rename nl/guides/exercises/{creating-exercises => examples}/content/logo_UGent.png (100%) diff --git a/en/guides/exercises/examples/class/index.md b/en/guides/exercises/examples/class/index.md index 61e515801..4e4fa701b 100644 --- a/en/guides/exercises/examples/class/index.md +++ b/en/guides/exercises/examples/class/index.md @@ -1,7 +1,7 @@ --- title: Exercises with classes sidebarTitle: Classes -order: 3 +order: 4 --- This guide is not yet available in English. diff --git a/en/guides/exercises/examples/command-line/index.md b/en/guides/exercises/examples/command-line/index.md index f8abeb986..e174a6008 100644 --- a/en/guides/exercises/examples/command-line/index.md +++ b/en/guides/exercises/examples/command-line/index.md @@ -1,7 +1,7 @@ --- title: Exercise on command line sidebarTitle: Command line -order: 4 +order: 5 --- This guide is not yet available in English. diff --git a/en/guides/exercises/creating-exercises/content/index.md b/en/guides/exercises/examples/content/index.md similarity index 80% rename from en/guides/exercises/creating-exercises/content/index.md rename to en/guides/exercises/examples/content/index.md index 423da9639..77cedb756 100644 --- a/en/guides/exercises/creating-exercises/content/index.md +++ b/en/guides/exercises/examples/content/index.md @@ -1,9 +1,7 @@ --- title: "Creating exercises: reading activity" sidebarTitle: Reading activity -order: 4 -prev: true -next: true +order: 1 --- This guide is not yet available in English. diff --git a/en/guides/exercises/examples/function/index.md b/en/guides/exercises/examples/function/index.md index 4c22f2853..3ee705b7e 100644 --- a/en/guides/exercises/examples/function/index.md +++ b/en/guides/exercises/examples/function/index.md @@ -1,7 +1,7 @@ --- title: Exercise with functions sidebarTitle: Functions -order: 2 +order: 3 --- This guide is not yet available in English. diff --git a/en/guides/exercises/examples/input-output/index.md b/en/guides/exercises/examples/input-output/index.md index 5876da22f..a7612f5d4 100644 --- a/en/guides/exercises/examples/input-output/index.md +++ b/en/guides/exercises/examples/input-output/index.md @@ -1,7 +1,7 @@ --- title: Exercise with input-output sidebarTitle: "Input-output" -order: 1 +order: 2 --- This guide is not yet available in English. diff --git a/nl/guides/exercises/creating-exercises/exercise/index.md b/nl/guides/exercises/creating-exercises/exercise/index.md index f3437a369..2013367db 100644 --- a/nl/guides/exercises/creating-exercises/exercise/index.md +++ b/nl/guides/exercises/creating-exercises/exercise/index.md @@ -1,7 +1,7 @@ --- title: "Oefeningen opstellen: opgave en testplan schrijven" sidebarTitle: Opgave en testplan -order: 3 +order: 2 prev: true next: true --- diff --git a/nl/guides/exercises/creating-exercises/management/index.md b/nl/guides/exercises/creating-exercises/management/index.md index 19d4e7dfc..83dae9446 100644 --- a/nl/guides/exercises/creating-exercises/management/index.md +++ b/nl/guides/exercises/creating-exercises/management/index.md @@ -1,7 +1,7 @@ --- title: "Oefeningen opstellen: volgende stappen" sidebarTitle: Volgende stappen -order: 5 +order: 4 prev: true next: false --- @@ -13,6 +13,7 @@ Hieronder enkele suggesties voor volgende stappen: - [Maak een cursus aan](/nl/guides/teachers/creating-a-course/). - [Gebruik je oefening in een oefeningenreeks van een cursus](/nl/guides/teachers/exercise-series-management/). +- Maak [leesactiviteiten](/nl/guides/exercises/examples/content/) met extra informatie of kleine stukken theorie. - Maak nog andere soorten oefeningen. Veel plezier met het gebruik van Dodona! diff --git a/nl/guides/exercises/examples/class/index.md b/nl/guides/exercises/examples/class/index.md index 5bb6a7aa5..111c66ceb 100644 --- a/nl/guides/exercises/examples/class/index.md +++ b/nl/guides/exercises/examples/class/index.md @@ -1,7 +1,7 @@ --- title: Oefening met klassen sidebarTitle: Klassen -order: 3 +order: 4 --- # Oefening met klassen diff --git a/nl/guides/exercises/examples/command-line/index.md b/nl/guides/exercises/examples/command-line/index.md index 6506da4df..f8d4b6766 100644 --- a/nl/guides/exercises/examples/command-line/index.md +++ b/nl/guides/exercises/examples/command-line/index.md @@ -1,7 +1,7 @@ --- title: Oefening op commandoregel sidebarTitle: Commandoregel -order: 4 +order: 5 --- # Oefening op de commandoregel diff --git a/nl/guides/exercises/creating-exercises/content/index.md b/nl/guides/exercises/examples/content/index.md similarity index 96% rename from nl/guides/exercises/creating-exercises/content/index.md rename to nl/guides/exercises/examples/content/index.md index 349498282..ecc8edf42 100644 --- a/nl/guides/exercises/creating-exercises/content/index.md +++ b/nl/guides/exercises/examples/content/index.md @@ -1,15 +1,13 @@ --- -title: "Oefeningen opstellen: leesactiviteit" +title: "Leesactiviteit" sidebarTitle: Leesactiviteit -order: 4 -prev: true -next: true +order: 1 --- # Oefeningen opstellen: leesactiviteit -Als je in de vorige stap van de handleiding de _template repository_ gebruikt hebt, bevat je repository al een oefening en leesactiviteit. +Als je in de [handleiding](/nl/guides/exercises/creating-exercises/introduction/) de _template repository_ gebruikt hebt, bevat je repository al een oefening en leesactiviteit. Hier zullen we nu zelf nog een leesactiviteit toevoegen. Dit is handig om extra informatie of kleine stukken theorie te integreren in je leerpad. De bestaande leesactiviteit kan uiteraard als voorbeeld dienen. diff --git a/nl/guides/exercises/creating-exercises/content/logo_UGent.png b/nl/guides/exercises/examples/content/logo_UGent.png similarity index 100% rename from nl/guides/exercises/creating-exercises/content/logo_UGent.png rename to nl/guides/exercises/examples/content/logo_UGent.png diff --git a/nl/guides/exercises/examples/function/index.md b/nl/guides/exercises/examples/function/index.md index 6fb674619..4d4eacffc 100644 --- a/nl/guides/exercises/examples/function/index.md +++ b/nl/guides/exercises/examples/function/index.md @@ -1,7 +1,7 @@ --- title: Oefening met functies sidebarTitle: Functies -order: 2 +order: 3 --- # Oefening met functies diff --git a/nl/guides/exercises/examples/input-output/index.md b/nl/guides/exercises/examples/input-output/index.md index f6aad7711..866f7fc3e 100644 --- a/nl/guides/exercises/examples/input-output/index.md +++ b/nl/guides/exercises/examples/input-output/index.md @@ -1,7 +1,7 @@ --- title: Oefening met invoer-uitvoer sidebarTitle: "Invoer-uitvoer" -order: 1 +order: 2 --- # Oefening met invoer en uitvoer From 4094ac9046252e297734ace6e87aa2037181a4d6 Mon Sep 17 00:00:00 2001 From: BrechtW <56451049+BTWS2@users.noreply.github.com> Date: Mon, 22 Jan 2024 19:55:08 +0100 Subject: [PATCH 51/51] spelling --- en/faq/featured-courses/index.md | 4 ++-- en/guides/teachers/exercise-series-management/index.md | 2 +- en/guides/teachers/user-management/index.md | 2 +- nl/faq/featured-courses/index.md | 4 ++-- nl/guides/teachers/exercise-series-management/index.md | 2 +- nl/guides/teachers/user-management/index.md | 2 +- 6 files changed, 8 insertions(+), 8 deletions(-) diff --git a/en/faq/featured-courses/index.md b/en/faq/featured-courses/index.md index e92a9ffa7..bb80633e8 100644 --- a/en/faq/featured-courses/index.md +++ b/en/faq/featured-courses/index.md @@ -58,8 +58,8 @@ The course is only available in [English](https://dodona.be/en/courses/345/). --- -### Python-oefeningen bij Youtube videoreeks UHasselt +### Python-oefeningen bij YouTube videoreeks UHasselt -**Python-oefeningen bij Youtube videoreeks UHasselt** is an introductory Python course that combines a series of [YouTube videos](https://www.youtube.com/playlist?list=PL2iW_rkiCt7UqxL47lGkBaTgApj_QHJ0K) with exercises on Dodona. The course was created by Dirk Peeters. +**Python-oefeningen bij YouTube videoreeks UHasselt** is an introductory Python course that combines a series of [YouTube videos](https://www.youtube.com/playlist?list=PL2iW_rkiCt7UqxL47lGkBaTgApj_QHJ0K) with exercises on Dodona. The course was created by Dirk Peeters. The course is only available in [Dutch](https://dodona.be/nl/courses/290/). diff --git a/en/guides/teachers/exercise-series-management/index.md b/en/guides/teachers/exercise-series-management/index.md index 6216f7503..1f5c683c7 100644 --- a/en/guides/teachers/exercise-series-management/index.md +++ b/en/guides/teachers/exercise-series-management/index.md @@ -129,7 +129,7 @@ Dit menu bevat een aantal handige acties die cursusbeheerders kunnen uitvoeren o ![scoresheet](./staff.scoresheet.png) - Klik op de naam van een cursusgebruiker om naar de overzichtpagina van de gebruiker te navigeren. + Klik op de naam van een cursusgebruiker om naar de overzichtspagina van de gebruiker te navigeren. Klik op het icoontje van een indienstatus om naar de oplossing te navigeren die gebruikt werd om de indienstatus te bepalen (als de cursusgebruiker effectief een oplossing heeft ingediend op basis waarvan de indienstatus kon bepaald worden). Je kan in dit overzicht ook filteren op studenten die aan minstens één activiteit begonnen zijn en zoeken op naam. diff --git a/en/guides/teachers/user-management/index.md b/en/guides/teachers/user-management/index.md index b9e654b7d..ad6846087 100644 --- a/en/guides/teachers/user-management/index.md +++ b/en/guides/teachers/user-management/index.md @@ -71,6 +71,6 @@ Afhankelijk van de ingestelde [registratieprocedure](../creating-a-course/#cursu Deze gebruiker kan je terug inschrijven voor de cursus door te klikken op ![register](../../../../images/staff_registration_icons/register.png) ## Studenten opvolgen -Om de voortgang van een individuele student op te volgen is er een overzichtpagina per student voorzien. Je kan deze pagina raadplegen door in het gebruikersoverzicht van een cursus op de naam van een student te klikken. Op deze pagina krijg je een overzicht van de vooruitgang van een gebruiker binnenin de cursus. Naast enkele statistieken kan je ook de status voor elke oefening en reeks binnen de cursus voor deze student raadplegen. +Om de voortgang van een individuele student op te volgen is er een overzichtspagina per student voorzien. Je kan deze pagina raadplegen door in het gebruikersoverzicht van een cursus op de naam van een student te klikken. Op deze pagina krijg je een overzicht van de vooruitgang van een gebruiker binnenin de cursus. Naast enkele statistieken kan je ook de status voor elke oefening en reeks binnen de cursus voor deze student raadplegen. ![cursusoverzicht](./staff.user_course_overview.png) diff --git a/nl/faq/featured-courses/index.md b/nl/faq/featured-courses/index.md index 78b27e580..29fbb7bd7 100644 --- a/nl/faq/featured-courses/index.md +++ b/nl/faq/featured-courses/index.md @@ -42,9 +42,9 @@ Dodona biedt een interactieve versie van dit boek, beschikbaar in zowel het [Ned --- -### Python-oefeningen bij Youtube-video's UHasselt +### Python-oefeningen bij YouTube-video's UHasselt -**Python-oefeningen bij Youtube videoreeks UHasselt** is een inleidende Python-cursus die een reeks [YouTube-video's](https://www.youtube.com/playlist?list=PL2iW_rkiCt7UqxL47lGkBaTgApj_QHJ0K) combineert met oefeningen op Dodona. De cursus is gemaakt door Dirk Peeters. +**Python-oefeningen bij YouTube videoreeks UHasselt** is een inleidende Python-cursus die een reeks [YouTube-video's](https://www.youtube.com/playlist?list=PL2iW_rkiCt7UqxL47lGkBaTgApj_QHJ0K) combineert met oefeningen op Dodona. De cursus is gemaakt door Dirk Peeters. De cursus is alleen beschikbaar in het [Nederlands](https://dodona.be/nl/courses/290/). diff --git a/nl/guides/teachers/exercise-series-management/index.md b/nl/guides/teachers/exercise-series-management/index.md index 68292f62a..715b38332 100644 --- a/nl/guides/teachers/exercise-series-management/index.md +++ b/nl/guides/teachers/exercise-series-management/index.md @@ -122,7 +122,7 @@ Dit menu bevat een aantal handige acties die cursusbeheerders kunnen uitvoeren o ![scoresheet](./staff.scoresheet.png) - Klik op de naam van een cursusgebruiker om naar de overzichtpagina van de gebruiker te navigeren. + Klik op de naam van een cursusgebruiker om naar de overzichtspagina van de gebruiker te navigeren. Klik op het icoontje van een indienstatus om naar de oplossing te navigeren die gebruikt werd om de indienstatus te bepalen (als de cursusgebruiker effectief een oplossing heeft ingediend op basis waarvan de indienstatus kon bepaald worden). Je kan in dit overzicht ook filteren op studenten die aan minstens één activiteit begonnen zijn en zoeken op naam. diff --git a/nl/guides/teachers/user-management/index.md b/nl/guides/teachers/user-management/index.md index e40f47e73..6040b6afd 100644 --- a/nl/guides/teachers/user-management/index.md +++ b/nl/guides/teachers/user-management/index.md @@ -65,6 +65,6 @@ Afhankelijk van de ingestelde [registratieprocedure](../creating-a-course/#cursu Deze gebruiker kan je terug inschrijven voor de cursus door te klikken op ![register](../../../../images/staff_registration_icons/register.png) ## Studenten opvolgen -Om de voortgang van een individuele student op te volgen is er een overzichtpagina per student voorzien. Je kan deze pagina raadplegen door in het gebruikersoverzicht van een cursus op de naam van een student te klikken. Op deze pagina krijg je een overzicht van de vooruitgang van een gebruiker binnenin de cursus. Naast enkele statistieken kan je ook de status voor elke oefening en reeks binnen de cursus voor deze student raadplegen. +Om de voortgang van een individuele student op te volgen is er een overzichtspagina per student voorzien. Je kan deze pagina raadplegen door in het gebruikersoverzicht van een cursus op de naam van een student te klikken. Op deze pagina krijg je een overzicht van de vooruitgang van een gebruiker binnenin de cursus. Naast enkele statistieken kan je ook de status voor elke oefening en reeks binnen de cursus voor deze student raadplegen. ![cursusoverzicht](./staff.user_course_overview.png)