Squashed commit of the following:

readthedocs documentation build

Author: bedbad

.gitignore

@@ -7,3 +7,4 @@ dist/justpyplot-0.0.9-py3-none-any.whl
 dist/justpyplot-0.0.9.tar.gz
 dist/justpyplot-0.1-py3-none-any.whl
 dist/justpyplot-0.1.tar.gz
+docs/_*

.readthedocs.yaml

@@ -5,12 +5,9 @@ build:
   tools:
     python: "3.8"
 
+sphinx:
+  configuration: docs/conf.py
+
 python:
   install:
-    - requirements: docs/requirements.txt
-    - method: pip
-      path: .
-
-build:
-  commands:
-    - pdoc --html justpyplot -o _readthedocs/html --only-modules 
+    - requirements: docs/requirements.txt 

docs/README.md

@@ -5,89 +5,98 @@
 Install documentation dependencies:
 
 ```bash
-pip install pdoc3
+pip install -r docs/requirements.txt
 ```
 
+The requirements include:
+- sphinx
+- sphinx_rtd_theme
+- numpy
+- opencv-python
+- Pillow
+
 ## Building the Documentation
 
 From the root directory of the project, run:
 
 ```bash
-pdoc --html justpyplot -o docs/build --only-modules
+sphinx-build -b html docs docs/_build/html
 ```
 
 This will:
 1. Generate HTML documentation from docstrings
-2. Output files to docs/build directory
-3. Create searchable API documentation
+2. Create API reference automatically
+3. Output files to docs/_build/html directory
 
 ## Development
 
-When developing, you can use the live reload server:
+For live preview while writing documentation:
 
 ```bash
-pdoc --http localhost:8080 justpyplot
+sphinx-autobuild docs docs/_build/html
 ```
 
 This will:
-1. Start a local server
-2. Auto-reload when files change
-3. Show documentation updates in real-time
+1. Start a local server (usually at http://127.0.0.1:8000)
+2. Auto-rebuild when files change
+3. Auto-reload the browser
 
 ## Documentation Style Guide
 
-When writing docstrings, follow this format:
+Use NumPy style docstrings for all Python functions:
 
 ```python
 def function_name(param1: type, param2: type) -> return_type:
     """Short description of function.
     
     Detailed description of function behavior.
     
-    Args:
-        param1: Description of first parameter
-        param2: Description of second parameter
+    Parameters
+    ----------
+    param1 : type
+        Description of first parameter
+    param2 : type
+        Description of second parameter
         
-    Returns:
+    Returns
+    -------
+    return_type
         Description of return value
         
-    Example:
-        >>> result = function_name(1, 2)
-        >>> print(result)
-        3
+    Examples
+    --------
+    >>> result = function_name(1, 2)
+    >>> print(result)
+    3
     """
 ```
 
-## Building for Distribution
-
-For release builds:
+## Project Structure
 
-```bash
-pdoc --html justpyplot -o docs/build --only-modules --template-dir docs/templates
 ```
-
-Documentation will be available at `docs/build/justpyplot/index.html`
+docs/
+├── conf.py          # Sphinx configuration
+├── index.rst        # Main documentation page
+├── requirements.txt # Documentation dependencies
+├── _build/         # Generated documentation
+└── _static/        # Static files (images, etc)
+```
 
 ## Read the Docs Integration
 
-1. Go to [Read the Docs](https://readthedocs.org/) and sign up/login
-2. Connect your GitHub repository
-3. Import your project from the dashboard
-4. The configuration in `.readthedocs.yaml` will:
-   - Install required dependencies
-   - Build documentation using pdoc3
-   - Deploy to readthedocs.io
-
-The documentation will automatically build when you push to the main branch.
-
-Build Status: [![Documentation Status](https://readthedocs.org/projects/justpyplot/badge/?version=latest)](https://justpyplot.readthedocs.io/en/latest/?badge=latest)
+The documentation automatically builds on [Read the Docs](https://readthedocs.org/) when you push to the main branch. Configuration is in `.readthedocs.yaml` at the root of the project.
 
 ## Troubleshooting
 
 If builds fail:
 1. Check the build logs on Read the Docs
 2. Verify all dependencies are in docs/requirements.txt
-3. Test the build command locally:
+3. Test locally with:
+   ```bash
+   sphinx-build -b html docs docs/_build/html -a -E
+   ```
+4. Clear build directory and rebuild:
    ```bash
-   pdoc --html justpyplot -o _readthedocs/html --only-modules
+   rm -rf docs/_build
+   sphinx-build -b html docs docs/_build/html
    ``` 

docs/conf.py

@@ -0,0 +1,55 @@
+import os
+import sys
+
+# Add the project root directory to Python path
+sys.path.insert(0, os.path.abspath('..'))
+
+# Configuration file for the Sphinx documentation builder
+project = 'justpyplot'
+copyright = '2024'
+author = 'bedbad'
+
+# Basic Sphinx settings
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.napoleon',  # For NumPy style docstrings
+    'sphinx.ext.viewcode',  # To show source code
+]
+
+# Autodoc settings
+autodoc_default_options = {
+    'members': None,
+    'undoc-members': False,
+    'private-members': False,
+    'special-members': False,
+    'imported-members': False
+}
+
+def skip_non_all(app, what, name, obj, skip, options):
+    # Get the module name and member name
+    module_name = name.rsplit('.', 1)[0]
+    member_name = name.split('.')[-1]
+    
+    try:
+        # Get the module's __all__
+        module = sys.modules[module_name]
+        all_list = getattr(module, '__all__', [])
+        
+        # Skip if not in __all__
+        if member_name not in all_list:
+            return True
+    except (KeyError, AttributeError):
+        pass
+    
+    return skip
+
+def setup(app):
+    app.connect('autodoc-skip-member', skip_non_all)
+
+templates_path = ['_templates']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+html_theme = 'sphinx_rtd_theme'
+
+# Napoleon settings
+napoleon_google_docstring = False
+napoleon_numpy_docstring = True

docs/index.rst

@@ -0,0 +1,59 @@
+justpyplot documentation
+=======================
+
+A fast, lightweight plotting library for real-time visualization.
+
+Basic Usage
+----------
+
+.. code-block:: python
+
+   import numpy as np
+   from justpyplot import justpyplot as jplt
+
+   x = np.linspace(0, 10, 50)
+   y = np.sin(x)
+
+   # Create plot components
+   figure, grid, labels, title = jplt.plot(
+       np.array([x, y]),
+       title='Sine Wave'
+   )
+
+   # Blend components
+   final_image = jplt.blend(grid, figure, labels, title)
+
+Installation
+-----------
+
+.. code-block:: bash
+
+   pip install justpyplot
+
+API Reference
+------------
+
+Main Functions
+~~~~~~~~~~~~~
+
+.. automodule:: justpyplot.justpyplot
+   :members:
+   :imported-members: False
+   :special-members: False
+   :private-members: False
+   :undoc-members: False
+
+Text Rendering
+~~~~~~~~~~~~~
+
+.. automodule:: justpyplot.textrender
+   :members:
+   :imported-members: False
+   :special-members: False
+   :private-members: False
+   :undoc-members: False
+
+Indices
+=======
+
+* :ref:`genindex` 

docs/requirements.txt

@@ -1,4 +1,5 @@
-pdoc3
+sphinx
+sphinx_rtd_theme
 numpy
 opencv-python
 Pillow 

justpyplot/justpyplot.py

@@ -1201,11 +1201,6 @@ def plot1_at(
     Returns:
         img_array: Image array with overlaid adaptive plot
 
-    Examples
-    --------
-    >>> frame = cv2.imread('frame.jpg')
-    >>> values = sensor_data[-100:]
-    >>> frame = draw_adaptive_plot(frame, values)
     """
     min_val = np.min(values)
     max_val = np.max(values)