Minor fix setup and docs

docs/Quickstart.ipynb

@@ -9,19 +9,23 @@
 * Annotating text with sentiment and emotion using interoperable services
 * Switching to different services (service interoperability)
 * Getting results in different formats (Turtle, XML, text...)
 * Asking for specific emotion models (automatic model conversion)
 
+The tutorial is originally published as an interactive [jupyter notebook](https://jupyter.org/) (`ipynb` file) that you can download and run locally.
+The on-line documentation contains a **static** version of the notebook.
+
 %% Cell type:markdown id: tags:
 
 ## Requirements
 
 %% Cell type:markdown id: tags:
 
-We will use the demo server at http://senpy.gsi.upm.es abd the requests library.
+We will use the demo server at http://senpy.gsi.upm.es and the requests library.
 
-We will use a variable for our endpoint so you can try these examples on other instances:
+We will use a variable for our endpoint.
+To try these examples on other instances simply change the value of this variable and re-run the query:
 
 %% Cell type:code id: tags:
 
 ``` python
 endpoint = 'http://senpy.gsi.upm.es/api'

docs/conf.py

@@ -293,11 +293,10 @@ texinfo_documents = [
 #texinfo_no_detailmenu = False
 
 nbsphinx_prolog = """
-.. note:: This page has been auto-generated from a Jupyter notebook using nbsphinx_.
+.. note:: This is an `auto-generated <https://nbsphinx.readthedocs.io>`_ static view of a Jupyter notebook.
 
-    The original source is available at: https://github.com/gsi-upm/senpy/tree/master/docs//{{ env.doc2path(env.docname, base=None) }}
+    To run the code examples in your computer, you may download the original notebook from the repository: https://github.com/gsi-upm/senpy/tree/master/docs/{{ env.doc2path(env.docname, base=None) }}
 
-    .. _nbsphinx: https://nbsphinx.readthedocs.io/
 
 ----
 """

setup.py

@@ -16,9 +16,10 @@ limitations under the License.
 
 from setuptools import setup
 from os import path
+import io
 
 try:
-    with open('senpy/VERSION') as f:
+    with io.open('senpy/VERSION') as f:
         __version__ = f.read().strip()
         assert __version__
 except IOError:  # pragma: no cover
@@ -28,13 +29,13 @@ except IOError:  # pragma: no cover
 
 def parse_requirements(filename):
     """ load requirements from a pip requirements file """
-    with open(filename, 'r') as f:
+    with io.open(filename, 'r') as f:
         lineiter = list(line.strip() for line in f)
     return [line for line in lineiter if line and not line.startswith("#")]
 
 
 this_directory = path.abspath(path.dirname(__file__))
-with open(path.join(this_directory, 'README.rst'), encoding='utf-8') as f:
+with io.open(path.join(this_directory, 'README.rst'), encoding='utf-8') as f:
     long_description = f.read()