Merge branch 'develop' of https://github.com/RaRe-Technologies/gensim into smart_open

* 'develop' of https://github.com/RaRe-Technologies/gensim:
  Fix positional params used for `gensim.models.CoherenceModel` in `gensim.models.callbacks` (piskvorky#1823)
  Fix parameter setting for `FastText.train`. Fix piskvorky#1818 (piskvorky#1837)
  Refactor tests for `gensim.corpora.WikiCorpus`(piskvorky#1821)
  Fix formula in `gensim.summarization.bm25`. Fix piskvorky#1828 (piskvorky#1833)
  Fix docstrings for `gensim.matutils` (piskvorky#1804)
  Fix docstrings for `gensim.models.logentropy_model` (piskvorky#1803)
  Fix docstrings for `gensim.models.normmodel` (piskvorky#1805)
  Refactor API reference `gensim.topic_coherence`. Fix piskvorky#1669 (piskvorky#1714)
  Add CircleCI for build documentation. Fix piskvorky#1807 (piskvorky#1822)
  Fix docstrings for `gensim.models.translation_matrix` (piskvorky#1806)
  Fix docstrings for `gensim.models.rpmodel` (piskvorky#1802)
  Fix docstrings for `gensim.utils` (piskvorky#1797)
  Fix tox.ini/setup.cfg configuration (piskvorky#1815)
  Add wordnet mammal train file for Poincare notebook (piskvorky#1781)

Author: sharanry

.circleci/config.yml

@@ -0,0 +1,44 @@
+version: 2
+jobs:
+  build:
+    docker:
+      - image: circleci/python:2.7
+
+    working_directory: ~/gensim
+
+    steps:
+      - checkout
+
+      - restore_cache:
+          key: pip-cache
+
+      - run:
+          name: Apt install (for latex render)
+          command: |
+            sudo apt-get -yq update
+            sudo apt-get -yq remove texlive-binaries --purge
+            sudo apt-get -yq --no-install-suggests --no-install-recommends --force-yes install dvipng texlive-latex-base texlive-latex-extra texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended latexmk
+
+      - run:
+          name: Basic installation (tox)
+          command: |
+            python -m virtualenv venv
+            source venv/bin/activate
+            pip install tox
+
+      - run:
+          name: Build documentation
+          command: |
+            source venv/bin/activate
+            tox -e docs -vv
+
+      - store_artifacts:
+          path:  docs/src/_build
+          destination: documentation
+
+      - save_cache:
+          key: pip-cache
+          paths:
+            - "~/.cache/pip"
+            - "~/.ccache"
+            - "~/.pip-cache"

.gitignore

@@ -72,4 +72,5 @@ data
 *_out.txt
 *.html
 *.inv
-*.js
+*.js
+docs/_images/

.travis.yml

@@ -13,7 +13,7 @@ language: python
 matrix:
   include:
     - python: '2.7'
-      env: TOXENV="flake8, docs"
+      env: TOXENV="flake8"
 
     - python: '2.7'
       env: TOXENV="py27-linux"

docs/notebooks/Poincare Evaluation.ipynb

@@ -289,6 +289,9 @@
    "outputs": [],
    "source": [
     "# Prepare the WordNet data\n",
+    "# Can also be downloaded directly from -\n",
+    "# https://github.com/jayantj/gensim/raw/wordnet_data/docs/notebooks/poincare/data/wordnet_noun_hypernyms.tsv\n",
+    "\n",
     "wordnet_file = os.path.join(data_directory, 'wordnet_noun_hypernyms.tsv')\n",
     "if not os.path.exists(wordnet_file):\n",
     "    ! python {parent_directory}/{cpp_repo_name}/scripts/create_wordnet_noun_hierarchy.py {wordnet_file}"