Feedback widget for Sphinx
Here's a step-by-step guide to help you install PushFeedback in your Sphinx project.
Before you begin, you'll need to have the following:
- A PushFeedback account. If you don't have one, sign up for free.
- A project created in your PushFeedback dashboard. If you haven't created one yet, follow the steps in the Quickstart guide.
- A Sphinx project.
To integrate the PushFeedback widget into your Sphinx site:
Open your terminal or command prompt. Navigate to your project's root directory using the
path/to/your/projectwith your project's actual directory path.
With your terminal still open, run the following command to install PushFeedback via PIP:
pip install sphinx-pushfeedback
Add the extension to your Sphinx project's
Configure your project ID in the
pushfeedback_project = '<YOUR_PROJECT_ID>'
<YOUR_PROJECT_ID>with your project's ID from the PushFeedback dashboard.
Build the documentation:
Once built, open your documentation in a web browser. Verify that the feedback button appears and works correctly on your site.
You can customize the PushFeedback widget to suit your needs. For example, you can change the widget's position, color, and more.
To do so, you can add any of the following configuration options to your
conf.py file, with the following modifications:
Prefix configuration options with
pushfeedback_. For instance,
Use underscores instead of hyphens as words separator. For example,
Here's an example:
pushfeedback_button_style = "light"