DOC improve rendering of the documentation (#1076)

Author: glemaitre

.circleci/config.yml

@@ -24,6 +24,7 @@ jobs:
       - NUMPYDOC_VERSION: 'latest'
       - SPHINXCONTRIB_BIBTEX_VERSION: 'latest'
       - PYDATA_SPHINX_THEME_VERSION: 'latest'
+      - SPHINX_DESIGN_VERSION: 'latest'
     steps:
       - add_ssh_keys:
           fingerprints:

build_tools/circle/build_doc.sh

@@ -114,6 +114,7 @@ mamba create -n $CONDA_ENV_NAME --yes --quiet \
     "$(get_dep sphinxcontrib-bibtex $SPHINXCONTRIB_BIBTEX_VERSION)" \
     "$(get_dep sphinx-copybutton $SPHINXCONTRIB_BIBTEX_VERSION)" \
     "$(get_dep pydata-sphinx-theme $PYDATA_SPHINX_THEME_VERSION)" \
+    "$(get_dep sphinx-design $SPHINX_DESIGN_VERSION)" \
     memory_profiler packaging seaborn pytest coverage compilers tensorflow
 
 source activate $CONDA_ENV_NAME

doc/_static/css/imbalanced-learn.css

@@ -21,39 +21,44 @@
 
 /* Override some aspects of the pydata-sphinx-theme */
 
-/* Getting started index page */
+/* Main index page overview cards */
 
 .intro-card {
-  background: #fff;
-  border-radius: 0;
-  padding: 30px 10px 10px 10px;
-  margin: 10px 0px;
-}
-
-.intro-card .card-text {
-  margin: 20px 0px;
-  /*min-height: 150px; */
-}
-
-.custom-button {
-  background-color: #dcdcdc;
-  border: none;
-  color: #484848;
-  text-align: center;
-  text-decoration: none;
-  display: inline-block;
-  font-size: 0.9rem;
-  border-radius: 0.5rem;
+  padding: 30px 10px 20px 10px;
+}
+
+.intro-card .sd-card-img-top {
+  margin: 10px;
+  height: 52px;
+  background: none !important;
+}
+
+.intro-card .sd-card-title {
+  color: var(--pst-color-primary);
+  font-size: var(--pst-font-size-h5);
+  padding: 1rem 0rem 0.5rem 0rem;
+}
+
+.intro-card .sd-card-footer {
+  border: none !important;
+}
+
+.intro-card .sd-card-footer p.sd-card-text {
   max-width: 220px;
-  padding: 0.5rem 0rem;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.intro-card .sd-btn-secondary {
+  background-color: #6c757d !important;
+  border-color: #6c757d !important;
 }
 
-.custom-button a {
-  color: #484848;
+.intro-card .sd-btn-secondary:hover {
+  background-color: #5a6268 !important;
+  border-color: #545b62 !important;
 }
 
-.custom-button p {
-  margin-top: 0;
-  margin-bottom: 0rem;
-  color: #484848;
+.card, .card img {
+  background-color: var(--pst-color-background);
 }