Standalone HTML
===============
You can use guidestar in any HTML page without Sphinx.
Just include the two asset files and set up your containers.
Include the assets
------------------
Copy (or serve) these two files from the package's ``static/`` directory:
* ``guidestar-controller.js``
* ``guidestar-controls.css``
.. code-block:: html
Declarative usage
-----------------
Add a ``data-guidestar`` attribute and a ``data-guidestar-config``
JSON attribute to any element:
.. code-block:: html
The controller auto-discovers these elements on ``DOMContentLoaded``.
Programmatic usage
------------------
.. code-block:: html
Dynamically loaded HTML
-----------------------
If your wireframe HTML is loaded after the page (e.g. via a framework
router), dispatch the ``guidestar-loaded`` event to trigger
auto-discovery of any new containers:
.. code-block:: javascript
// After injecting new guidestar containers into the DOM:
document.dispatchEvent(new CustomEvent('guidestar-loaded'));
Full standalone example
-----------------------
.. code-block:: html
Wireframe Demo — Standalone