A sophisticated web application for learning Chinese through comprehensible input using the diglot weave method. This tool gradually introduces Chinese words into English text, maintaining approximately 98% comprehension while building vocabulary through context.
- Gradual Introduction: Chinese words are strategically inserted into English text
- Comprehensible Input: Maintains ~98% comprehension rate for effective learning
- Contextual Learning: New words appear in meaningful contexts
- Adaptive Difficulty: Three difficulty levels (98%, 95%, 90% comprehension)
- Personal Vocabulary: Uses your uploaded vocabulary list with known/unknown word tracking
- 2,497 Chinese Words: Based on SUBTLEX 2500 frequency list
- 397 Known Words: Pre-marked vocabulary you're familiar with
- 2,100 Learning Words: Available for gradual introduction
- English Narration: Natural English reading of the story
- Chinese Pronunciation: Click any Chinese word to hear native pronunciation
- Adjustable Speed: Control reading pace for optimal learning
- Progress Tracking: Monitor words learned and reading progress
- Comprehension Metrics: Real-time comprehension percentage
- Vocabulary Review: See recently introduced words with definitions
- Daily Goals: Track words learned per session
- Clean Design: Modern, distraction-free reading environment
- Interactive Text: Hover over Chinese words for pinyin and definitions
- Visual Feedback: Learned words highlighted in green
- Responsive Layout: Works on desktop and mobile devices
- Text Analysis: The system analyzes English text and identifies replaceable words
- Strategic Replacement: English words are replaced with Chinese equivalents
- Frequency Control: Replacement rate adjusts based on difficulty level:
- Beginner: ~2% Chinese words (98% comprehension)
- Intermediate: ~5% Chinese words (95% comprehension)
- Advanced: ~10% Chinese words (90% comprehension)
- Initial State: You know 397 basic Chinese words
- Word Introduction: New words are introduced in context
- Repetition: Words repeat across different contexts
- Mastery: Click words to mark them as learned
- Progress: System tracks learning and adjusts difficulty
index.html- Basic diglot weave readeradvanced.html- Advanced version with enhanced featuresstyles.css- Shared styling for both versionsscript.js- Basic application logicadvanced.js- Advanced features and interactions
vocab_cleaned.csv- Cleaned vocabulary list (CSV format)vocabulary.json- Vocabulary data (JSON format for web app)story.txt- Complete story textstory_sample.txt- Sample text for testing
- Open
index.htmloradvanced.htmlin a web browser - The application will load your vocabulary and story data
- Select your preferred difficulty level
- Click "Generate Text" to create your first diglot weave
- Generate Text: Creates a new section with Chinese words woven in
- Read Aloud: Use the play button to hear the English narration
- Interact with Chinese Words:
- Hover to see pinyin and definition
- Click to hear Chinese pronunciation
- Click "Mark as Learned" when you know a word
- Next Section: Move to the next chunk of text
- Review Progress: Check your learning statistics
- Difficulty Level: Adjust Chinese word density
- Text Chunk Size: Control how much text appears at once
- Audio Speed: Adjust narration speed for comfort
- Parses CSV vocabulary list with pinyin and definitions
- Separates known words (marked TRUE) from learning words
- Creates frequency-based mapping for word replacement
- Preserves original text structure and punctuation
- Replaces English words with Chinese equivalents
- Maintains readability and flow
- Uses Web Speech API for text-to-speech
- English narration with natural voices
- Chinese pronunciation for individual words
- Sentence-by-sentence playback control
- Tracks introduced words across sessions
- Maintains learned word database
- Calculates comprehension metrics in real-time
- Chrome 66+ (recommended)
- Firefox 60+
- Safari 14+
- Edge 79+
- Web Speech API support
- ES6 JavaScript features
- CSS Grid and Flexbox
- Local file access (for offline use)
- Beginner: 15-20 minutes per session
- Intermediate: 20-30 minutes per session
- Advanced: 30-45 minutes per session
- Start with 98% comprehension to build confidence
- Don't look up every word - use context to guess meanings
- Focus on high-frequency words first
- Review recently learned words regularly
- Gradually increase difficulty as comfort improves
- Consistent daily practice is more effective than long sessions
- Review learned words from previous sessions
- Try different text chunks to see words in new contexts
- Use audio features to improve pronunciation recognition
Text not loading: Check that all files are in the same directory Audio not working: Ensure browser supports Web Speech API Chinese words not appearing: Verify vocabulary files are loaded Slow performance: Try smaller text chunk sizes
- Enable JavaScript
- Allow audio playback
- Check microphone permissions (for speech features)
- Spaced Repetition: Review words at optimal intervals
- Reading Comprehension: Quiz questions about text content
- Progress Export: Save learning progress across devices
- More Stories: Additional text content for variety
- Mobile App: Native iOS/Android applications
- Custom Vocabulary: Upload your own word lists
- Text Import: Use any text content for weaving
- Learning Goals: Set daily/weekly targets
- Theme Selection: Different visual themes
- Title: Beneath the Dragoneye Moons
- Author: Selkie Myth
- Source: Royal Road (royalroad.com)
- Source: SUBTLEX 2500 Chinese Word Frequency List
- Processing: Custom cleaning and categorization
- Known Words: Based on common learning progression
- Methodology: Comprehensible Input (Stephen Krashen)
- Implementation: Modern web technologies
- Design: User-centered learning interface
This educational tool is provided for personal learning use. The story content remains under its original copyright. The vocabulary data is based on publicly available frequency lists.
For questions or issues, please check the troubleshooting section or contact the development team. This tool is designed to make Chinese learning more effective and enjoyable through the power of comprehensible input and diglot weaving.