moodle-to-vikwikiquiz 1.0.23

A CLI for converting a graded Moodle quiz HTML to a vik.wiki quiz wikitext

moodle-to-vikwikiquiz

📖 About

A program for converting a graded Moodle quiz saved as an HTML file to a vik.viki quiz wikitext.

📋 Features

• Imports multiple HTML files at once
• Supports single and multiple choice questions
• Creates placeholders for illustrations
• Asks for correct answers if it can't be determined from a graded question
• Deduplicates questions with the same text

📥 Installation

1. Install Homebrew
2. Run the following command in the terminal:

brew install gy-mate/moodle-to-vikwikiquiz/moodle-to-vikwikiquiz

🧑‍💻 Usage

moodle-to-vikwikiquiz [--verbose|-v] [[--grading|-g] grading_method] [[--output|-o] destination_file] source_directory parent_article title

Parameters:

• grading_method: + or -. See https://vik.wiki/wiki/Segítség:Kvíz#Pontozás for further info.
• destination_file: The name of the file where the wikitext quiz should be exported to. Use .txt as the extension.
• source_directory: The directory where the Moodle quiz HTML files are located. The review page of the quizzes should be downloaded.
• parent_article: The article name of the course on vik.wiki.
• title: How the quiz should be named on vik.wiki. This usually is in the following form: [course name] kvíz – [exam name].

Example:

• Convert all Elektronika alapjai Moodle quizzes downloaded to ~/Downloads/downloaded_ELA_quizzes:

moodle-to-vikwikiquiz --grading - ~/Downloads/downloaded_ELA_quizzes "Elektronika alapjai" "Elektronika alapjai kvíz – vizsga"

Always check the output before uploading it to vik.wiki. Upload all images and add their filenames to the quiz manually on vik.wiki.

📜 License

This project is licensed under the GNU General Public License v3.0. See the license file (or the GPL-3.0 license tab on GitHub) for its full text.