MandarinPinyin-for-Safari

Mandarin Pinyin - Safari Extension

Overview

Mandarin Pinyin - 汉字拼音标注 is a Safari extension that adds pinyin annotations to Chinese characters on any webpage, making it easier for learners and readers of Chinese to understand and pronounce Chinese text.

Features

One-Click Annotation: Add pinyin to any Chinese text with a single click
Live Annotation: Works on any webpage containing Chinese characters
Clean Display: Pinyin annotations appear directly above each character without disrupting the page layout
Fast Processing: Efficiently processes text using a local dictionary, no internet connection required
Non-Intrusive: Only annotates text when requested, preserving the original webpage appearance

Installation

Download the extension from the Safari Extension Gallery or the App Store
Enable the extension in Safari Preferences > Extensions
Grant the necessary permissions when prompted

Usage

Navigate to any webpage containing Chinese text
Click the Mandarin Pinyin extension icon in the Safari toolbar
Click the “Add Pinyin” button
Wait a moment while the extension processes the text
Chinese characters on the page will now display pinyin annotations above them

Technical Details

This extension uses:

Ruby annotation (<ruby> HTML tags) to display pinyin above characters
A comprehensive dictionary for accurate pinyin conversion
Content script injection to modify page content safely
Efficient text processing to handle large amounts of text

Troubleshooting

If the extension doesn’t work as expected:

Ensure the page has fully loaded before adding annotations
Refresh the page and try again
For complex pages, try annotating smaller sections at a time

Privacy

This extension processes all text locally within your browser. No data is sent to external servers. See our Privacy Policy for more details.

Support

For support or feature requests, please contact: wf_21cn@163.com