ensure docs build locally (and beautifully)

Author: jGaboardi

docs/_static/images/pysal_favicon.ico

@@ -0,0 +1,95 @@
+/* Make thumbnails with equal heights */
+@media only screen and (min-width : 500px) {
+    .row.equal-height {
+        display: flex;
+        flex-wrap: wrap;
+    }
+    .row.equal-height > [class*='col-'] {
+        display: flex;
+        flex-direction: row, column;
+    }
+    .row.equal-height.row:after,
+    .row.equal-height.row:before {
+        display: flex;
+    }
+
+    .row.equal-height > [class*='col-'] > .thumbnail,
+    .row.equal-height > [class*='col-'] > .thumbnail > .caption {
+        display: flex;
+        flex: .9 .1 auto;
+        flex-direction: column;
+    }
+    .row.equal-height > [class*='col-'] > .thumbnail > .caption > .flex-text {
+        flex-grow: 1;
+    }
+    .row.equal-height > [class*='col-'] > .thumbnail > img {
+        width: 400px;
+        height: 100%; /* force image's height */
+
+        /* force image fit inside it's "box" */
+        -webkit-object-fit: cover;
+           -moz-object-fit: cover;
+            -ms-object-fit: cover;
+             -o-object-fit: cover;
+                object-fit: cover;
+    }
+}
+
+.row.extra-bottom-padding{
+    margin-bottom: 20px;
+}
+
+
+.topnavicons {
+    margin-left: 10% !important;
+}
+
+.topnavicons li {
+    margin-left: 0px !important;
+    min-width: 100px;
+    text-align: center;
+}
+
+.topnavicons .thumbnail {
+    margin-right: 10px;
+    border: none;
+    box-shadow: none;
+    text-align: center;
+    font-size: 85%;
+    font-weight: bold;
+    line-height: 10px;
+    height: 100px;
+}
+
+.topnavicons .thumbnail img {
+    display: block;
+    margin-left: auto;
+    margin-right: auto;
+}
+
+
+/* Table with a scrollbar */
+.bodycontainer { max-height: 800px; width: 100%; margin: 0; padding: 0; overflow-y: auto; }
+.table-scrollable { margin: 0; padding: 0; }
+  
+   .label {
+      color: #E74C3C;
+      font-size: 100%;
+      font-weight: bold;
+      width: 100%;
+      height: 100%;
+      text-align: left;
+      vertical-align: middle;
+      padding: 6px;
+      margin: 2px;
+      overflow-x: auto;
+      overflow-y: auto;
+}
+
+  div.body {
+     max-width: 1080px;
+ }
+
+table.longtable.align-default{
+    text-align: left;
+}

docs/_static/images/pysal_logo.png

@@ -40,7 +40,9 @@
     "sphinx.ext.intersphinx",
     "numpydoc",
     "matplotlib.sphinxext.plot_directive",
+    "nbsphinx",
 ]
+bibtex_bibfiles = ["_static/references.bib"]
 
 
 # Add any paths that contain templates here, relative to this directory.
@@ -151,6 +153,7 @@
     # Navigation bar menu
     "navbar_links": [
         ("Installation", "installation"),
+        ("Tutorials", "tutorials"),
         ("API", "api"),
         ("References", "references"),
     ],

docs/_static/images/pysal_logo.svg

@@ -1,6 +1,35 @@
 .. documentation master file
 
-Sparse generalize linear models (spglm)
+
+`spglm`
+=======
+
+**SP**\ arse **G**\ eneralized **L**\ inear **M**\ odels
+--------------------------------------------------------
+
+This module is an adaptation of a portion of GLM functionality from the `Statsmodels`_ package, this it has been simplified and customized for the purposes of serving as the base for several other PySAL modules, namely SpInt and GWR. Currently, it supports the estimation of Gaussian, Poisson, and Logistic regression using only iteratively weighted least squares estimation (IWLS). One of the large differences this module and the functions avaialble in the Statsmodels package is that the custom IWLS routine is fully sparse compatible, which was necesary for the very sparse design matrices that arise in constrained spatial interaction models. The somewhat limited functionality and computation of only a subset of GLM diagnostics also decreases the computational overhead. Another difference is that this module also supports the estimation of QuasiPoisson models. One caveat is that this custom IWLS routine currently generates estimates by directly solves the least squares normal equations rather than using a more robust method like the pseudo inverse. For more robust estimation of ill conditioned data and a fuller GLM framework we suggest using the original GLM functionality from Statsmodels.
+
+
+Features
+--------
+
+* Gaussian GLM
+* Poisson GLM
+* QuasiPoisson GLM
+* Logistic GLM
+* Selection of most common GLM diagnostics
+* Supports sparse design matrices
+
+
+.. raw:: html
+
+    <img 
+        src="_static/images/pysal_logo.svg" 
+        class="img-responsive center-block" 
+        alt="PySAL Logo" 
+        width="400" 
+        height="400"
+    >
 
 
 .. toctree::
@@ -9,8 +38,10 @@ Sparse generalize linear models (spglm)
    :caption: Contents:
 
    Installation <installation>
+   Tutorials <tutorials>
    API <api>
    References <references>
 
 
 .. _PySAL: https://github.com/pysal/pysal
+.. _Statsmodels: https://github.com/statsmodels/statsmodels/blob/main/statsmodels/genmod/generalized_linear_model.py

docs/_static/images/pysal_nav_logo_2line.svg

@@ -0,0 +1,13 @@
+.. tutorials
+
+
+Tutorials
+=========
+
+.. toctree::
+    :maxdepth: 1
+    :caption: Contents:
+
+    notebooks/Binomial_GLM.ipynb
+    notebooks/Poisson_GLM.ipynb
+    notebooks/Gaussian_GLM.ipynb

docs/_static/pysal-styles.css

@@ -1,5 +1,12 @@
 {
  "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Binomial GLM"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 1,