save

app.py

@@ -5,6 +5,7 @@ import gradio as gr
 from custom_theme import CustomMinimalTheme
 from service.oral.oral_service import oral_exercise
 from service.written.written_service import written_exercise
+from utils.instructions import ORAL_QUIZ, TRANSCRIPTION_EXERCISE, QA_DRILL
 
 if os.getenv("HF_SPACE_ID") is None:
     from dotenv import load_dotenv
@@ -22,18 +23,19 @@ auth_credentials = [(username, password)]
 with gr.Blocks(theme=CustomMinimalTheme()) as demo:
     with gr.Tabs():
         with gr.TabItem("🗣️ Oral Quiz"):
-            oral_exercise("data/oral_quiz/audio", "data/oral_quiz/expected_result")
+            oral_exercise(
+                "data/oral_quiz/audio", "data/oral_quiz/expected_result", ORAL_QUIZ)
 
         with gr.TabItem("✍️ Transcription Exercise"):
             written_exercise("data/transcription_exercise/audio",
-                             "data/transcription_exercise/expected_result")
+                             "data/transcription_exercise/expected_result", TRANSCRIPTION_EXERCISE)
 
         # with gr.TabItem("🗣️ Oral Gap-fill Exercise"):
         #     oral_exercise("data/oral_gap_fill_exercise/audio",
         #                   "data/oral_gap_fill_exercise/expected_result")
 
         with gr.TabItem("🗣️ Q&A Drill"):
-            oral_exercise("data/q&a_drill/audio", "data/q&a_drill/expected_result")
+            oral_exercise("data/q&a_drill/audio", "data/q&a_drill/expected_result", QA_DRILL)
 
 if __name__ == "__main__":
     demo.launch(show_api=False)

service/oral/oral_service.py

@@ -7,7 +7,7 @@ from utils.comparator import highlight_fuzzy_diff, get_feedback
 from utils.dialogue_loader import load_dialogue_lines
 
 
-def oral_exercise(audio_dir: str, expected_result_dir: str):
+def oral_exercise(audio_dir: str, expected_result_dir: str, instruction: str):
     audio_structure = get_audio_structure(audio_dir)
     week_options = list(audio_structure.keys())
     default_week = week_options[0]
@@ -19,22 +19,7 @@ def oral_exercise(audio_dir: str, expected_result_dir: str):
     with gr.Row():
         with gr.Column(scale=1):
             with gr.Accordion("📘 Instructions", open=False):
-                gr.Markdown("""
-                ## 🗣️ Oral Gap-fill Exercise Instructions
-
-                **1.** ▶️ Start the recording and listen to the **first sentence**.  
-                **2.** ⏸️ Stop and anser the sentence **out loud**.  
-                **3.** 🎤 Record your version.  
-                **4.** 🧠 The system will transcribe your speech and compare it to the original.  
-                **5.** 🔁 Repeat steps for each sentence.
-
-                ---
-
-                ### 🔎 Scoring Guide
-
-                🟩 **Correct words**  
-                🟥 **Missing / incorrect words**
-                """)
+                gr.Markdown(instruction)
             week_dropdown = gr.Dropdown(label="Select a week", choices=week_options, value=default_week)
 
         with gr.Column(scale=2):

service/written/written_service.py

@@ -5,7 +5,7 @@ from utils.comparator import highlight_fuzzy_diff, get_feedback
 from utils.dialogue_loader import load_dialogue_lines
 
 
-def written_exercise(audio_dir: str, expected_result_dir: str):
+def written_exercise(audio_dir: str, expected_result_dir: str, instruction: str):
     audio_structure = get_audio_structure(audio_dir)
     week_options = list(audio_structure.keys())
     default_week = week_options[0]
@@ -17,22 +17,7 @@ def written_exercise(audio_dir: str, expected_result_dir: str):
     with gr.Row():
         with gr.Column(scale=1):
             with gr.Accordion("📘 Instructions", open=False):
-                gr.Markdown("""
-                ## 🗣️ Transcription Practice Instructions
-
-                **1.** 🎧 Listen to the whole conversation once.  
-                **2.** ▶️ Start the recording again and listen to the **first sentence**.  
-                **3.** ⏸️ Stop the recording.  
-                **4.** ✍️ Write down what you remember.  
-                **5.** 🔁 Go back and listen again to the **same sentence** and add the missing details. 
-                **6.** ⏭️ Move on to the next sentence and repeat steps 3 - 5.
-                **7.** Be careful with spelling and punctuation.
-
-                ---
-                ### 🔎 Scoring Guide  
-                🟩 **Correct words**  
-                🟥 **Missing / incorrect words**
-                """)
+                gr.Markdown(instruction)
             week_dropdown = gr.Dropdown(label="Select a week", choices=week_options, value=default_week)
 
         with gr.Column(scale=2):

utils/instructions.py

@@ -0,0 +1,60 @@
+ORAL_QUIZ = """
+**1.** ▶️ Start the recording and listen to the **instructions** for the exercise.  
+**2.** 🎧 Listen to **sentence Number 1**.  
+**3.** 💬 Formulate your answer **out loud** without stopping the recording.  
+**4.** 🔊 Listen to the **recorded correct answer**.  
+**5.** ⏹️ Stop the recording.  
+**6.** 🎙️ Click **RECORD** and repeat the correct answer.  
+**7.** ⏹️ Click **STOP** when finished.  
+**8.** 🧠 Click **TRANSCRIBE** to see what the system heard.  
+**9.** 🔁 Repeat steps 6–8 until you are satisfied with your recording.  
+**10.** ✅ Click **CHECK** to compare your answer with the correct one.  
+**11.** 📖 Click **VIEW ALL CORRECT OPTIONS** to see all valid answers.  
+**12.** 🔜 Click **NEXT** and repeat the above steps for sentences **2 to 15**.
+
+---
+
+### 🔎 Scoring Guide
+
+🟩 **Correct words**  
+🟥 **Missing / incorrect words**
+"""
+
+TRANSCRIPTION_EXERCISE = """
+**1.** ▶️ Start the recording and **listen to the full conversation once**.  
+**2.** ⏪ Go back to the **start of the conversation**.  
+**3.** 🎧 Listen to the **first line**.  
+**4.** ✍️ Stop the recording and **type what you heard**.  
+**5.** 🔁 Repeat steps 3 and 4 until you're **satisfied with your transcription** of the first line.  
+**6.** ✅ Click **CHECK** to compare your transcription with the **correct sentence**.  
+**7.** 🔜 Click **NEXT** and repeat the above steps for **all remaining lines**.
+
+---
+
+### 🔎 Scoring Guide
+
+🟩 **Correct words**  
+🟥 **Missing / incorrect words**
+"""
+
+QA_DRILL = """
+**1.** ▶️ Start the recording and **listen to the instructions** for the exercise.  
+**2.** 🎧 Listen to **Question 1**.  
+**3.** 💬 Formulate your **answer out loud** without stopping the recording.  
+**4.** 🎯 Listen to the **recorded correct answer**.  
+**5.** ⏹️ Stop the recording.  
+**6.** 🔴 Click the **RECORD** button and **repeat** the recorded correct answer.  
+**7.** ⏹️ Click **STOP**.  
+**8.** 🧠 Click **TRANSCRIBE** to see what the system understood.  
+**9.** 🔁 Repeat steps 5 to 7 until you're **satisfied** with your recording.  
+**10.** ✅ Click **CHECK** to compare your answer with the correct one.  
+**11.** 📖 Click **VIEW ALL CORRECT OPTIONS**.  
+**12.** 🔜 Click **NEXT** and repeat the steps for **Questions 2 to 10**.
+
+---
+
+### 🔎 Scoring Guide
+
+🟩 **Correct words**  
+🟥 **Missing / incorrect words**
+"""