< Projects | Edu | Parley Revision as of 05:42, 12 August 2008 (view source)Wotnarg (talk | contribs) (Parley Practice Themeing Guide) Revision as of 05:49, 12 August 2008 (view source) Wotnarg (talk | contribs) Newer edit → Line 48: Line 48: ===Timers=== ===Timers=== −: Implement either 0 or 1 of these:+Implement either 0 or 1 of these: −* '''timer_progress_box''' # A timer is shown as an embedded QProgressBar.+Note: As of 8/12, these are not yet supported in themes. −* '''timer_digital_clock''' # A timer is shown as a number in an embedded widget.+A timer is shown as an embedded QProgressBar. −* '''timer_bar''' / '''timer_bar_background''' # A timer is shown as a progress bar (counting down).+* '''timer_progress_box''' −* '''timer_clock''' # A timer is shown as a graphical clock of some sort.+A timer is shown as a number in an embedded widget. +* '''timer_digital_clock''' +A timer is shown as a progress bar (counting down). +* '''timer_bar''' / '''timer_bar_background''' +A timer is shown as a graphical clock of some sort. +* '''timer_clock''' Revision as of 05:49, 12 August 2008 Contents 1 Parley Practice Themeing Guide 2 Available Elements 2.1 Input 2.2 Question Prompt 2.3 Optional 2.4 Optional GUI Elements 2.5 Timers 2.6 Sound & Images 3 Elements required 3.1 Written 3.2 Example 3.3 Paraphrase 3.4 Flashcard 3.5 Multiple Choice 3.6 Article 3.7 Antonym 3.8 Synonym 3.9 Mixed Letters 3.10 Comparison 3.11 Conjugation 3.12 Main background 4 Active Area Parley Practice Themeing Guide Available Elements Any of these can be visible or invisible. Note on terminology: 'solution' is the correct response. 'answer' is anything the user inputs, and it may or may not match the solution. Input The question text will be placed here, vertically and horizontally centered question_text_box The text on the flashcard will be placed here (both the question and solution will be put here) flashcard_text_box This holds the multiple choice widget. Note: Up to 9 choices are allowed (this may be reduced), and 5 is default, so this has to be fairly large. answer_mc_box Question Prompt The text input widget will be placed here answer_text_box This box holds the mixed up letters. Note: Make this reasonably large. question_mixed_letters_box Optional this element will be scaled in proportion to bar_background to show progress. Note: if existent, it must be visible. progress_bar This element will determine how the bar in scaled. At 100% progress, bar will cover the same area as bar_background progress_bar_background A feedback sentence is placed here, telling the user if the answer is correct and giving hints if it is wrong, among other things. This is highly recommended in a theme. feedback_box Optional GUI Elements Note: If the following elements do not exist, the features are still available from the menus. A button that toggles between displaying 'check answer' and 'continue' is placed here. continue_button Note: These can be turned off in settings; if they are, the buttons won't be shown (read: make them invisible or it will look weird) Shows a button to skip to the next question while signaling you know the solution skip_known_button Shows a button to skip to the next question while signally you don't know the solution skip_unknown_button Shows a button to give a hint. hint_button Shows the solution and counts the question as incorrectly answered (See flashcards mode for an exception) show_solution_button Timers Implement either 0 or 1 of these: Note: As of 8/12, these are not yet supported in themes. A timer is shown as an embedded QProgressBar. timer_progress_box A timer is shown as a number in an embedded widget. timer_digital_clock A timer is shown as a progress bar (counting down). timer_bar / timer_bar_background A timer is shown as a graphical clock of some sort. timer_clock Sound & Images image_box and sound_box can be added to any mode, but be aware they are not necessarily common and can be disabled; don't make the existence of an image integral to your UI design. If an active_area exists with a name that is suffixed by _image (eg written_image, elements become written_image_question_text_box), that layout will be used for questions with images assosiated. If such an area does not exist, the normal area will always be used. Elements required Written Example Paraphrase answer_text_box question_text_box Flashcard flashcard_text_box On this one it shows the solution, but doesn't automatically count it as wrong. Also, it is non-optional for this mode. show_solution_button This indicates you know the solution known_button This indicates you didn't know the solution unknown_button Multiple Choice Article Antonym Synonym question_text_box answer_mc_box Mixed Letters question_mixed_letters_box question_text_box answer_text_box Comparison absolute_box comparative_box superlative_box Conjugation These are all used to prompt for various conjugation tenses make the question_text_boxes fairly long; a significant amount of text may be placed there The answer_text_boxes can be fairly short For example, infinitive_question_text_box would say "Infinitive" infinitive_answer_text_box would say "to be" (even though this is a line edit, it would be prepopulated) question_text_box_1 would say "First-person plural present" answer_text_box_1 would want "are" This is used for the infinitive label (It will display "Infinitive"). question_text_box_infinitive answer_text_box_infinitive answer_text_box_1 question_text_box_1 answer_text_box_2 question_text_box_2 answer_text_box_2 question_text_box_2 Main background main, with element active_area that active areas (below) are placed in. Active Area Active areas are the parts of the practice that change depending on the mode. For the modes with defaults listed, if you do not provide an area for that mode, it will fall back to the listed mode. To create an active area, make a rectangle the same size as the active_area element and name it modename_box. Add all the other elements on top of it, and then group them and name the group modename. Elements that are part of an active area should be prefixed with the area name and _ (eg written_answer_text_box) Elements are are NOT part of an active area (ie they are part of the main group) should be prefixed with main_ (eg main_progress_bar). Active Area Name Fallback active area written flashcard multiple_choice comparison mixed_letters conjugation article multiple_choice example written paraphrase written antonym multiple_choice synonym multiple_choice Retrieved from "https://techbase.kde.org/index.php?title=Projects/Edu/Parley/Theme_Creation&oldid=31624" Content is available under Creative Commons License SA 4.0 unless otherwise noted.