Package: plct-sphinx-components
PLCT-Sphinx-ComponentsPLCT-Sphinx-Components is a project designed to enhance your e-learning content. These extensions are Sphinx-based and focuses on online learning content, making it an ideal choice for creating interactive and engaging online courses.About the DirectivesAll the directives provided by PLCT-Sphinx-Components are wrappers for JavaScript-based components. These components facilitate a range of interactive features, such as asking multiple choice or fill in the blank questions, python based programming in the browser, executing SQL queries, and more. This enables the creation of engaging and interactive content within your Sphinx documentation.PLCT-Sphinx-Components heavily relies on thePyodideproject for running Python-based code in the browser. Pyodide brings the Python runtime to the browser via WebAssembly. This allows for the execution of Python code, data analysis, visualization, and more, all directly within the browser.DirectivesmchoiceDirectiveThemchoicedirective enables you to embed multiple-choice questions within your documentation...mchoice:::answer1:Belgrade:answer2:Paris:answer3:Madrid:correct:2

   What is the capital of France?In this example, a multiple-choice question is created with three answer options, and the correct answer is set to "Paris".fitbDirectiveThefitbdirective allows you to insert fill-in-the-blank questions in your documentation...fitb:::answer:OpenAI

   The GPT-3 model is developed by |blank|.In this example, a fill-in-the-blank question is created where the answer is "OpenAI".Note DirectivesThe following directives are used to add different types of notes in your documentation:infonoteDirectiveTheinfonotedirective is employed to insert an informational note, offering a way to provide supplementary context or explanations about a specific topic...infonote::This is an informational note.suggestionnoteDirectiveThesuggestionnotedirective is utilized to include a suggestion note, allowing you to provide recommendations or advice related to the content...suggestionnote::This is a suggestion note with helpful recommendations.learnmorenoteDirectiveThelearnmorenotedirective serves the purpose of adding a note encouraging users to explore additional information or resources for further learning...learnmorenote::Delve deeper into this topic by exploring additional resources.technicalnoteDirectiveThetechnicalnotedirective is used to incorporate a technical note, which can include details or information of a technical nature...technicalnote::This is a technical note providing in-depth technical information.questionnoteDirectiveThequestionnotedirective enables the addition of a note specifically tailored for posing questions or prompting further consideration...questionnote::Here's a question to ponder: What are the implications of this concept?Feel free to customize the content within the directives to suit the specific information you want to convey.PyCodeDirectiveThePyCodedirective is an extension designed to execute Python code directly within web browsers. We leverage web workers and service workers to provide a seamless input/output experience. This means that students can start experimenting with Python directly in their browsers, without the need to install anything. This makes the first steps much easier.Usage..py-code::unique_identifier:packages:rich,numpy

   print('Hello, PyCode!')Optional arguments include:packages: Specify additional Python packages and the environment will install it usingmicropip, a lightweight version ofpip. This means you can use a wide range of Python packages further enhancing the learning and experimentation possibilities.Installation and UsageTo use the PLCT-Sphinx-Components in your Sphinx project, follow these steps:Install the extension using pip:pip install PLCT-Sphinx-ComponentsAdd the extension to your Sphinx project'sconf.pyfile:extensions=[# ... other extensions ...'plct-sphinx-components.extensions.multiple_choice','plct-sphinx-components.extensions.fill_in_the_blank','plct-sphinx-components.extensions.py_code,]Once the extension is enabled, you can start using the directives in your documentation files as demonstrated in the examples above.AboutThis project is maintained by Petlja and aims to enhance the educational content creation experience using Sphinx. For more information about Petlja and its initiatives, please visitPetlja's website.LicenseThis project is licensed under theMIT License.