Reformat docs and move to PyData sphinx theme

CHANGELOG.md

@@ -12,6 +12,8 @@
 
 ### Changed
 
+- Reorganize docs and switch to PyData theme ([#687](https://github.com/stac-utils/pystac/pull/687))
+
 ### Fixed
 
 - Quickstart tutorial is now up-to-date with all package changes ([#674](https://github.com/stac-utils/pystac/pull/674))

docs/_static/custom.css

@@ -0,0 +1,21 @@
+.no-sidebar {
+    display: none;
+}
+
+.card-text a {
+    font-weight: 600;
+    color: rgb(255, 26, 26);
+}
+
+.card-header p {
+    font-size: large;
+    font-weight: 600;
+}
+
+.navbar-brand img {
+    height: 50px;
+}
+
+.navbar-brand {
+    height: 75px;
+}

docs/_templates/layout.html

@@ -0,0 +1,20 @@
+{% extends "pydata_sphinx_theme/layout.html" %}
+
+{% block docs_main %}
+{% if sidebars %}
+  {% set content_col_class = "col-md-9 col-xl-7" %}
+{% else %}
+  {# This customization to the no-sidebars case is why we override docs_main #}
+  {% set content_col_class = "col-md-12" %}
+{% endif %}
+<main class="col-12 {{ content_col_class }} py-md-5 pl-md-5 pr-md-4 bd-content" role="main">
+    {% block docs_body %}
+    <div>
+      {% block body %} {% endblock %}
+    </div>
+    {% endblock %}
+    {% if theme_show_prev_next %}
+    {% include "prev-next.html" %}
+    {% endif %}
+</main>
+{% endblock %}