pynlg 0.1.1

pynlg
=====

.. image:: https://travis-ci.org/mapado/pynlg.svg
:target: https://travis-ci.org/mapado/pynlg

``pynlg``是`SimpleNLG-EnFr <https://github.com/rali-udem/SimpleNLG-EnFr>`_的纯Python重实现，一个Java库，它允许法语和英语的`text surface realisation <https://en.wikipedia.org/wiki/Realization_%28linguistics%29>`_，基于`SimpleNLG <https://github.com/simplenlg/simplenlg>`_。

有关SimpleNLG和SimpleNLG-EnFr的更多信息，请参阅其文档

- `SimpleNLG-EnFr <https://github.com/rali-udem/SimpleNLG-EnFr/blob/master/docs/SimpleNLG-EnFr_doc_francais.pdf>`_（法语版）
- `SimpleNLG <https://github.com/simplenlg/simplenlg/wiki/Section-0-%E2%80%93-SimpleNLG-Tutorial>`_

``pynlg``支持Python2.7和3.5。Python 3.3和3.4应该可以工作，但未经过测试。

示例
--------

定义一个名词句子，带女性名词
******************************************************

.. code-block:: python

from pynlg.lexicon.fr import FrenchLexicon
from pynlg.lexicon.feature.category import NOUN, ADJECTIVE, DETERMINER
from pynlg.lexicon.feature.gender import FEMININE
from pynlg import make_noun_phrase

lex = FrenchLexicon()
un = lex.first(u'un', category=DETERMINER)
maison = lex.first(u'maison', category=NOUN)
maison = maison.inflex(gender=FEMININE)
beau = lex.first(u'beau', category=ADJECTIVE)
perdu = lex.first(u'perdu', category=ADJECTIVE)
phrase = make_noun_phrase(lexicon=lex, specifier=un, noun=maison, modifiers=[beau, perdu])
syntaxically_realised_phrase = phrase.realise()
形态实现短语 = 语法实现短语.realise_morphology()
形态实现短语.component
[<StringElement {实现=une, 分类=限定词}>,
<StringElement {实现=belle, 分类=形容词}>,
<StringElement {实现=maison, 分类=固定文本}>,
<StringElement {实现=perdue, 分类=形容词}>]

支持的语言
--------------------

目前支持以下语言

- 法语（进行中）
- 英语（进行中）

如何贡献？
---------------------

首先，克隆仓库，并创建一个新的本地分支。一旦新功能实现（或错误修复）并且一切都已经**测试**正确，推送到远程仓库并创建一个pull request。

注意：您应该先运行测试，并确保它们通过

.. code-block:: bash

$ tox


如何添加对新语言的支持？
----------------------------------------

待办事项


许可证
-------

MIT许可证（MIT）

版权所有（c）2015 Mapado

任何获得此软件及其相关文档文件（“软件”）副本的人，免费授予在此软件上不受限制的处理权限，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许向软件提供的人这样做，但受以下条件的约束
的软件。
上述版权声明和本许可声明应包含在软件的所有副本或实质性部分中。
软件按“原样”提供，不提供任何形式的保证，明示或暗示，包括但不限于适销性、针对特定目的的适用性和非侵权性。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论这些责任是根据合同、侵权或其他行为引起的，与软件或其使用或任何其他关联有关。
软件。
软件。

软件。
软件。

软件。
软件。
软件。
软件。
软件。
软件。
软件。