Ngue-Um/ewondo-language-learning

An interactive web-based platform for learning the Ewondo language through audio recordings and text # Ewondo Language Learning - Interactive Audio Resource An interactive web-based platform for learning the Ewondo language through audio recordings and text. ## Features - 🎵 **Interactive Audio Playback**: Click to hear native Ewondo speech - 📖 **Lexical Entries**: Clear display of words/phrases with example sentences - 🔍 **Search Functionality**: Search through lexical entries and examples in real-time - 📱 **Responsive Design**: Works on desktop, tablet, and mobile devices - 🌐 **Easy Deployment**: Ready for GitHub Pages hosting - 🔄 **Expandable**: Easy to add French translations later ## Data Structure Each audio clip contains: - **Lexical Entry**: The main word or phrase being taught - **Example Sentence**: A contextual usage example (when available) - Both are recorded together in a single audio file The interface displays: 1. The lexical entry prominently (in bold, colored) 2. The example sentence below it (if present) 3. French translation (when added) ## Quick Start ### 1. Repository Setup Clone or download this repository to your local machine. ### 2. File Structure Make sure your directory structure looks like this: ``` ewondo-language-learning/ ├── index.html ├── styles.css ├── app.js ├── audio_mapping.json ├── audio_files_MP3/ │ ├── c51b803969335aaf3fff78bbec968eea.mp3 │ ├── 2806d70843e4ad9766323aa190aec958.mp3 │ └── ... (all your MP3 files) └── README.md ``` **Important**: Place your `audio_files_MP3` folder (containing all the MP3 files) in the same directory as the HTML file. ### 3. Testing Locally To test the application on your computer: 1. Open the `index.html` file in a web browser 2. Note: Some browsers may block local audio files due to CORS restrictions 3. For best results, use a local web server: #### Using Python 3: ```bash python3 -m http.server 8000 ``` Then open localhost in your browser #### Using Python 2: ```bash python -m SimpleHTTPServer 8000 ``` #### Using Node.js (with http-server): ```bash npx htt …