Improved documentation

diff --git a/README.rst b/README.rst
index a243c88f210972ec50afc93a6d3b2e6b72262422..05d8184abe477cdd294a8ee33bb6a45240938938 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -5,6 +5,7 @@ An asynchronous MPD (Music Player Daemon) client library written in Python.
 
 ----
 
+:Documentation: https://musicplayerdaemon.codeberg.page/python-musicpdaio/
 :MPD Protocol:  https://www.musicpd.org/doc/html/protocol.html
 :Code:          https://codeberg.org/MusicPlayerDaemon/python-musicpdaio.git
 :Dependencies:  None

diff --git a/doc/source/changelog.rst b/doc/source/changelog.rst
index c39c502ab88df90852e3d2e52555bd125e5f04d3..b3b0d9e233bb49eabe496791eb530384df683d34 100644 (file)
--- a/doc/source/changelog.rst
+++ b/doc/source/changelog.rst
@@ -3,8 +3,5 @@ Changelog
 
 `Semantic Versioning`_. is used.
 
-Unreleased
-----------
-
-
-.. _Semantic Versioning: https://semver.org/spec/v2.0.0.html
+|version| Unreleased
+--------------------

diff --git a/doc/source/conf.py b/doc/source/conf.py
index 6377b0398a6e9dc7f647bc16363488cf16428aba..c0f2a053d6f7b571ca0b14df5f919b60e60e0b0e 100644 (file)
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -5,11 +5,18 @@
 
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+import os
+import sys
+
+sys.path.insert(0, os.path.abspath('../../'))
+from mpdaio.const import VERSION
 
 project = 'musicpdaio'
 copyright = '2024, kaliko'
 author = 'kaliko'
-release = '0.0.1'
+
+version = VERSION
+release = VERSION
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -29,11 +36,24 @@ exclude_patterns = []
 
 html_theme = 'alabaster'
 html_static_path = ['_static']
+html_baseurl= 'https://musicplayerdaemon.codeberg.page/python-musicpdaio/'
 html_theme_options = {
     'page_width' : '1024px',
     'fixed_sidebar': 'true',
+    'base_bg': '#eee',
+    'pre_bg': '#fff',
     }
 
+rst_epilog = """
+.. _asyncio: https://docs.python.org/3/library/asyncio.html
+.. _Diátaxis: https://diataxis.fr/
+.. _MPD protocol documentation: http://www.musicpd.org/doc/protocol/
+.. _python-musicpd: https://kaliko.gitlab.io/python-musicpd
+.. _Semantic Versioning: https://semver.org/spec/v2.0.0.html
+.. _snake case: https://en.wikipedia.org/wiki/Snake_case
+
+"""
+
 # -- Options for intersphinx extension ---------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#configuration
 

diff --git a/doc/source/explanations.rst b/doc/source/explanations.rst
index 15155a0df07dd35d6ac35a541ecaa3cace63394e..b3d4fbbc78d183c94083842c084c9d07efbaa605 100644 (file)
--- a/doc/source/explanations.rst
+++ b/doc/source/explanations.rst
@@ -90,10 +90,4 @@ connection is still in use a new connection is made and kept in the pool.
    await client.ping()   # A connection is made and kept open
    client.connections    # Returns a list; [Connection<example.org:6600>]
 
-
-.. _snake case: https://en.wikipedia.org/wiki/Snake_case
-.. _MPD protocol documentation: http://www.musicpd.org/doc/protocol/
-.. _asyncio: https://docs.python.org/3/library/asyncio.html
-.. _python-musicpd: https://kaliko.gitlab.io/python-musicpd
-
 .. vim: spell spelllang=en

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 5b5a51bee77123d05f4b8b838f6495a83bccbc41..1ae27649fa1808a8055af05e18bed0820a472aaa 100644 (file)
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -1,5 +1,5 @@
-Welcome to musicpdaio's documentation!
-======================================
+musicpdaio's documentation
+==========================
 
 The documentation is structured by following the `Diátaxis`_ principles:
 tutorials and explanation are mainly useful to discover and learn, howtos and
@@ -18,12 +18,9 @@ have some specific action to perform or goal to achieve.
    changelog
 
 
-
 Indices and tables
 ==================
 
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-
-.. _Diátaxis: https://diataxis.fr/

diff --git a/doc/source/tutorial.rst b/doc/source/tutorial.rst
index 95e69488c895c9bbe913ff3d1ab99ca36920abbe..b0280d7037ac95c73eb23b9f883c195f785d129a 100644 (file)
--- a/doc/source/tutorial.rst
+++ b/doc/source/tutorial.rst
@@ -91,6 +91,4 @@ Concurrency
 
 .. literalinclude:: tutorial/tutorial-01.py
 
-
-.. _MPD protocol documentation: http://www.musicpd.org/doc/protocol/
 .. vim: spell spelllang=en

diff --git a/mpdaio/const.py b/mpdaio/const.py
index 67811847086c01686b04028e2f60f4ecf7bb7589..35d86c6f7faad141a398db3b746d145c8ba6bf15 100644 (file)
--- a/mpdaio/const.py
+++ b/mpdaio/const.py
@@ -7,7 +7,7 @@ ERROR_PREFIX = 'ACK '
 SUCCESS = 'OK'
 NEXT = 'list_OK'
 #: Module version
-VERSION = '0.1.b0'
+VERSION = '0.1.0b0'
 #: Seconds before a connection attempt times out
 #: (overriden by :envvar:`MPD_TIMEOUT` env. var.)
 CONNECTION_TIMEOUT = 30