Merge pull request #121 from ocefpaf/docs

Docs

Author: ocefpaf

.github/workflows/deploy-docs.yml

@@ -0,0 +1,50 @@
+name: Build and Deploy docs
+
+on:
+  pull_request:
+
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: checkout
+      uses: actions/checkout@v3
+      with:
+        fetch-depth: 0
+
+    - name: Setup Mamba
+      uses: mamba-org/provision-with-micromamba@v14
+      with:
+        environment-file: false
+
+    - name: Build environment
+      shell: bash -l {0}
+      run: |
+        micromamba create --name TEST python=3 --file requirements.txt --file requirements-dev.txt --channel conda-forge
+        micromamba activate TEST
+        python -m pip install -e . --no-deps --force-reinstall
+
+    - name: Get the version
+      id: get_version
+      run: echo ::set-output name=VERSION::$(python setup.py --version)
+
+    - name: Build documentation
+      shell: bash -l {0}
+      run: |
+        set -e
+        micromamba activate TEST
+        pushd docs
+        make clean html linkcheck
+        popd
+
+    - name: Deploy
+      if: github.event_name == 'push' && startsWith(github.event.ref, 'refs/tags/v')
+      uses: peaceiris/actions-gh-pages@v3
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: docs/build/html

.travis.yml

@@ -23,10 +23,9 @@
 copyright = '2018, Filipe Fernandes'
 author = 'Filipe Fernandes'
 
-from branca._version import get_versions
+import branca
 
-version = release = get_versions()['version']
-del get_versions
+version = release = branca.__version__
 
 
 # -- General configuration ---------------------------------------------------
@@ -64,7 +63,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.