更新文档

ref #26

Author: mozillazg

.gitignore

@@ -39,3 +39,4 @@ htmlcov
 
 tools/words.txt
 *~
+tools/phrases_dict.txt

CHANGELOG.rst

@@ -2,6 +2,12 @@ Changelog
 ---------
 
 
+0.9.4 (2015-11-27)
+++++++++++++++++++++
+
+* 细微调整，主要是更新文档
+
+
 0.9.3 (2015-11-15)
 ++++++++++++++++++++
 
@@ -21,7 +27,11 @@ Changelog
 0.9.1 (2015-10-17)
 ++++++++++++++++++++
 
-* 修复 ju, qu, xu, yu, yi 和 wu 的韵母( `#26`_ ). Thanks `@MingStar`_ :
+* 修复 ``ju``, ``qu``, ``xu``, ``yu``, ``yi`` 和 ``wu`` 的韵母( `#26`_ ). Thanks `@MingStar`_ :
+  * ``ju``, ``qu``, ``xu`` 的韵母应该是 v
+  * ``yi`` 的韵母是 ``i``
+  * ``wu`` 的韵母是 ``u``
+  * **从现在开始 ``y`` 既不是声母也不是韵母** 详见 `汉语拼音方案`_
 
 
 0.9.0 (2015-09-20)
@@ -41,7 +51,8 @@ Changelog
 0.8.4 (2015-08-23)
 ++++++++++++++++++++
 
-* ``y``, ``w`` 也不是声母. (`hotoo/pinyin#57 <https://github.com/hotoo/pinyin/issues/57>`__)
+* ``y``, ``w`` 也不是声母. (`hotoo/pinyin#57 <https://github.com/hotoo/pinyin/issues/57>`__):
+  * 以 ``y``, ``w`` 开头的拼音在声母(``INITIALS``)模式下将返回 ``['']``
 
 
 0.8.3 (2015-08-20)
@@ -244,3 +255,4 @@ __ https://github.com/mozillazg/python-pinyin/issues/8
 .. _#22: https://github.com/mozillazg/python-pinyin/pull/22
 .. _#26: https://github.com/mozillazg/python-pinyin/pull/26
 .. _@MingStar: https://github.com/MingStar
+.. _汉语拼音方案: http://www.edu.cn/20011114/3009777.shtml

README.rst

@@ -49,8 +49,8 @@
     [[u'zh\u014dng'], [u'x\u012bn']]
     >>> pinyin(u'中心', heteronym=True)  # 启用多音字模式
     [[u'zh\u014dng', u'zh\xf2ng'], [u'x\u012bn']]
-    >>> pinyin(u'中心', style=pypinyin.INITIALS)  # 设置拼音风格
-    [['zh'], ['x']]
+    >>> pinyin(u'中心', style=pypinyin.FIRST_LETTER)  # 设置拼音风格
+    [['z'], ['x']]
     >>> pinyin('中心', style=pypinyin.TONE2, heteronym=True)
     [['zho1ng', 'zho4ng'], ['xi1n']]
     >>> lazy_pinyin(u'中心')  # 不考虑多音字的情况

docs/usage.rst

@@ -13,8 +13,8 @@
     [[u'zh\u014dng'], [u'x\u012bn']]
     >>> pinyin(u'中心', heteronym=True)  # 启用多音字模式
     [[u'zh\u014dng', u'zh\xf2ng'], [u'x\u012bn']]
-    >>> pinyin(u'中心', style=pypinyin.INITIALS)  # 设置拼音风格
-    [['zh'], ['x']]
+    >>> pinyin(u'中心', style=pypinyin.FIRST_LETTER)  # 设置拼音风格
+    [['z'], ['x']]
     >>> pinyin('中心', style=pypinyin.TONE2, heteronym=True)
     [['zho1ng', 'zho4ng'], ['xi1n']]
     >>> lazy_pinyin(u'中心')  # 不考虑多音字的情况

pypinyin/__init__.py

@@ -242,10 +242,10 @@ def final(pinyin):
     if not initial_:
         return no_initial_final(pinyin)
     # 特例 j/q/x
-    m = re.match(u'^(j|q|x)(ū|ú|ǔ|ù)$', pinyin)
+    m = re.match(r'^(j|q|x)(ū|ú|ǔ|ù)$', pinyin)
     if m:
         return (U_FINALS_EXCEPTIONS_MAP[m.group(2)])
-    pinyin = re.sub('^(j|q|x)u(\d?)$', r'\1v\2', pinyin)
+    pinyin = re.sub(r'^(j|q|x)u(\d?)$', r'\1v\2', pinyin)
     return ''.join(pinyin.split(initial_, 1))