Update app.py

app.py

@@ -182,21 +182,80 @@ def create_interface():
         
         # Examples section
         gr.Markdown("### Examples")
+        
+        example1 = [
+            "During World War II, many prisoners of war were held in camps across Europe. The Geneva Convention established rules for POW treatment. American soldiers and British troops were among those captured.",
+            "Prisoner of War", "POW; POWs; prisoner of war",
+            "World War II", "WWII; Second World War",
+            "United States", "USA; US; America; American",
+            "", "", "", ""
+        ]
+        
+        example2 = [
+            "The University of Oxford is located in Oxford, England. Students from around the world study at this prestigious institution.",
+            "University", "university; institution; college",
+            "Oxford", "oxford",
+            "England", "england; English",
+            "Student", "student; students; pupils",
+            "", ""
+        ]
+        
         gr.Examples(
-            examples=[
-                [
-                    "During World War II, many prisoners of war were held in camps across Europe. The Geneva Convention established rules for POW treatment. American soldiers and British troops were among those captured.",
-                    "Prisoner of War", "POW; POWs; prisoner of war",
-                    "World War II", "WWII; Second World War",
-                    "United States", "USA; US; America; American",
-                    "", "",
-                    "", ""
-                ],
-                [
-                    "The University of Oxford is located in Oxford, England. Students from around the world study at this prestigious institution. The university has many colleges including Christ Church and Magdalen College.",
-                    "University", "university; institution; college",
-                    "Oxford", "oxford",
-                    "England", "england; English",
-                    "Student", "student; students; pupils",
-                    "", ""
-                ],
+            examples=[example1, example2],
+            inputs=[text_input, primary1, synonyms1, primary2, synonyms2, primary3, synonyms3, primary4, synonyms4, primary5, synonyms5],
+            label="Click an example to try it out"
+        )
+        
+        # Button functions
+        find_btn.click(
+            fn=process_text,
+            inputs=[text_input, primary1, synonyms1, primary2, synonyms2, primary3, synonyms3, primary4, synonyms4, primary5, synonyms5],
+            outputs=[results_output, highlighted_output, copy_output]
+        )
+        
+        def clear_all():
+            return "", "", "", "", "", "", "", "", "", "", "", "", "", ""
+        
+        clear_btn.click(
+            fn=clear_all,
+            outputs=[text_input, primary1, synonyms1, primary2, synonyms2, primary3, synonyms3, primary4, synonyms4, primary5, synonyms5, results_output, highlighted_output, copy_output]
+        )
+        
+        # Instructions
+        gr.Markdown("""
+        ## Format Guide
+        
+        **How to enter keywords:**
+        - **Primary Keyword:** Enter the main/preferred term for a concept
+        - **Synonyms:** Enter alternative terms separated by semicolons `;`
+        - Leave rows blank if you don't need all 5 keyword groups
+        - The tool will find ANY of these terms and return ALL related terms
+        
+        **Example:**
+        - Primary: `Prisoner of War`
+        - Synonyms: `POW; POWs; prisoner of war`
+        
+        **Special Handling:**
+        - "US" is matched exactly to avoid confusion with the word "us"
+        - Word boundaries are respected (prevents partial matches)
+        - Results are alphabetized and deduplicated
+        
+        **How it works:**
+        When ANY variant is found in your text (primary OR synonym), the tool returns the complete standardized set of terms for that concept.
+        """)
+        
+        # Footer
+        gr.HTML("""
+        <div style="margin-top: 40px; padding: 20px; background-color: #f8f9fa; border-radius: 8px; text-align: center;">
+            <p style="margin: 0; color: #666;">
+                Created for digital humanities keyword tagging workflows. 
+                Based on controlled vocabulary matching principles.
+            </p>
+        </div>
+        """)
+    
+    return demo
+
+if __name__ == "__main__":
+    demo = create_interface()
+    demo.launch()