Overview
Quick Start
Bash
git clone https://github.com/nxxxsooo/mdx2apple.git
cd mdx2apple
pip install pyglossary lxml beautifulsoup4 html5lib
# One-command convert and install
python mdx2apple.py /path/to/dictionary.mdx --install
Features
- Automated Pipeline - One command to convert, compile, and install
- HTML Cleanup - Removes complex MDict-specific markup
- CSS Fixes - Ensures proper rendering in Apple Dictionary
- Resource Handling - Copies audio/image assets correctly
Challenges Solved
- CSS display:block - Fixed missing entry visibility
- Complex HTML - Simplified nested structures for Apple Dictionary
- plist Configuration - Streamlined metadata for reliable compilation
Limitations
- No audio playback (Apple Dictionary doesn't support JavaScript audio)
- Complex styling may be simplified
- Large dictionaries (60k+ entries) need HTML optimization
