Initial commit.

Signed-off-by: Cliff Hill <xlorep@darkhelm.org>

docs/codeofconduct.md

@@ -0,0 +1,3 @@
+```{include} ../CODE_OF_CONDUCT.md
+
+```

docs/codeofconduct.rst

@@ -1 +0,0 @@
-.. include:: ../CODE_OF_CONDUCT.rst

docs/conf.py

@@ -1,15 +1,13 @@
 """Sphinx configuration."""
-from datetime import datetime
 
-
-project = "Automated Daily Playlist Generator for Plex Music"
+project = "Plex Playlist"
 author = "Cliff Hill"
-copyright = f"{datetime.now().year}, {author}"
+copyright = "2024, Cliff Hill"
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.napoleon",
     "sphinx_click",
-    "sphinx_rtd_theme",
+    "myst_parser",
 ]
 autodoc_typehints = "description"
-html_theme = "sphinx_rtd_theme"
+html_theme = "furo"

docs/contributing.md

@@ -0,0 +1,7 @@
+```{include} ../CONTRIBUTING.md
+---
+end-before: <!-- github-only -->
+---
+```
+
+[code of conduct]: codeofconduct

docs/contributing.rst

@@ -1,4 +0,0 @@
-.. include:: ../CONTRIBUTING.rst
-   :end-before: github-only
-
-.. _Code of Conduct: codeofconduct.html

docs/index.md

@@ -0,0 +1,23 @@
+```{include} ../README.md
+---
+end-before: <!-- github-only -->
+---
+```
+
+[license]: license
+[contributor guide]: contributing
+[command-line reference]: usage
+
+```{toctree}
+---
+hidden:
+maxdepth: 1
+---
+
+usage
+reference
+contributing
+Code of Conduct <codeofconduct>
+License <license>
+Changelog <https://github.com/xlorepdarkhelm/plex-playlist/releases>
+```

docs/index.rst

@@ -1,16 +0,0 @@
-.. include:: ../README.rst
-   :end-before: github-only
-
-.. _Contributor Guide: contributing.html
-.. _Usage: usage.html
-
-.. toctree::
-   :hidden:
-   :maxdepth: 1
-
-   usage
-   reference
-   contributing
-   Code of Conduct <codeofconduct>
-   License <license>
-   Changelog <https://github.com/xlorepdarkhelm/plex-playlist/releases>

docs/license.md

@@ -0,0 +1,7 @@
+# License
+
+```{literalinclude} ../LICENSE
+---
+language: none
+---
+```

docs/license.rst

@@ -1 +0,0 @@
-.. include:: ../LICENSE.rst

docs/reference.md

@@ -0,0 +1,8 @@
+# Reference
+
+## xdh.playlist
+
+```{eval-rst}
+.. automodule:: xdh.playlist
+   :members:
+```

docs/reference.rst

@@ -1,13 +0,0 @@
-Reference
-=========
-
-.. contents::
-    :local:
-    :backlinks: none
-
-
-playlist.__main__
------------------
-
-.. automodule:: playlist.__main__
-   :members:

docs/requirements.txt

@@ -1,3 +1,4 @@
-sphinx==3.5.2
-sphinx-click==2.6.0
-sphinx-rtd-theme==0.5.1
+furo==2022.4.7
+sphinx==4.5.0
+sphinx-click==4.1.0
+myst_parser==0.17.2

docs/usage.md

@@ -0,0 +1,7 @@
+# Usage
+
+```{eval-rst}
+.. click:: xdh.playlist.__main__:main
+    :prog: plex-playlist
+    :nested: full
+```

docs/usage.rst

@@ -1,6 +0,0 @@
-Usage
-=====
-
-.. click:: playlist.__main__:main
-   :prog: plex-playlist
-   :nested: full