Refactored documentation and changed theme

This commit is contained in:
Fabio Manganiello 2021-07-17 01:32:18 +02:00
parent db8ea33b68
commit f250681a78
311 changed files with 329 additions and 357 deletions

BIN
assets/logo-128.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

BIN
assets/logo-256.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

BIN
assets/logo-64.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.1 KiB

View File

@ -32,7 +32,7 @@ class SchemaDirective(Directive):
schema_module_name = '.'.join(['platypush.schemas', *(m.group(1).split('.')[:-1])])
schema_module = importlib.import_module(schema_module_name)
schema_class = getattr(schema_module, m.group(1).split('.')[-1])
schema_args = eval(f'dict({m.group(3)})')
schema_args = eval(f'dict({m.group(3)})') if m.group(3) else {}
schema = schema_class(**schema_args)
output = {
name: self._get_field_value(field)

View File

@ -44,7 +44,7 @@ Backends
platypush/backend/music.mopidy.rst
platypush/backend/music.mpd.rst
platypush/backend/music.snapcast.rst
platypush/backend/music.spotify.connect.rst
platypush/backend/music.spotify.rst
platypush/backend/nextcloud.rst
platypush/backend/nfc.rst
platypush/backend/nodered.rst

View File

@ -89,8 +89,11 @@ pygments_style = 'sphinx'
#
# html_theme = 'haiku'
# html_theme = 'sphinx_rtd_theme'
html_theme = 'sphinx_material'
html_theme = 'sphinx_book_theme'
html_title = 'Platypush Documentation'
html_logo = '../../assets/logo-64.png'
html_favicon = '../../platypush/backend/http/webapp/public/favicon.ico'
html_domain_indices = True
# Theme options are theme-specific and customize the look and feel of a theme
@ -98,50 +101,12 @@ html_domain_indices = True
# documentation.
#
html_theme_options = {
'nav_title': 'Platypush documentation',
'repo_url': 'https://git.platypush.tech/platypush/platypush',
'repo_name': 'Source code',
'repo_type': 'gitlab',
'color_primary': 'green',
'color_accent': 'light-green',
'logo_icon': '&#128366',
'nav_links': [
{
'href': 'https://platypush.tech/',
'title': 'Homepage',
'internal': False,
},
{
'href': 'https://blog.platypush.tech/',
'title': 'Blog',
'internal': False,
},
{
'href': 'https://git.platypush.tech/platypush/platypush',
'title': 'Repository',
'internal': False,
},
{
'href': 'https://git.platypush.tech/platypush/platypush/-/wikis/home',
'title': 'Wiki',
'internal': False,
},
{
'href': 'https://chrome.google.com/webstore/detail/platypush/aphldjclndofhflbbdnmpejbjgomkbie',
'title': 'Chrome Extension',
'internal': False,
},
{
'href': 'https://addons.mozilla.org/en-US/firefox/addon/platypush/',
'title': 'Firefox Extension',
'internal': False,
},
{
'href': 'https://f-droid.org/en/packages/tech.platypush.platypush/',
'title': 'Android App',
'internal': False,
},
],
'toc_title': 'Platypush documentation',
'repository_url': 'https://git.platypush.tech/platypush/platypush',
'use_repository_button': True,
'use_issues_button': True,
'use_fullscreen_button': True,
'home_page_in_toc': True,
}
# Add any paths that contain custom static files (such as style sheets) here,
@ -157,9 +122,9 @@ html_theme_options = {
# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
# 'searchbox.html']``.
#
html_sidebars = {
'**': ['logo-text.html', 'globaltoc.html', 'localtoc.html', 'searchbox.html']
}
# html_sidebars = {
# '**': ['logo-text.html', 'globaltoc.html', 'localtoc.html', 'searchbox.html']
# }
# -- Options for HTMLHelp output ---------------------------------------------

View File

@ -3,12 +3,14 @@ Platypush
Welcome to the Platypush reference of available plugins, backends and event types.
For more information on Platypush please check out:
For more information on Platypush check out:
* The `main page`_ of the project
* The `Gitlab page`_ of the project
* The `online wiki`_ for quickstart and examples
* The `Blog articles`_ for inspiration on use-cases possible projects
.. _main page: https://platypush.tech
.. _Gitlab page: https://git.platypush.tech/platypush/platypush
.. _online wiki: https://git.platypush.tech/platypush/platypush/-/wikis/home
.. _Blog articles: https://blog.platypush.tech
@ -28,4 +30,3 @@ Indices and tables
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

View File

@ -1,4 +1,4 @@
``platypush.backend.adafruit.io``
``adafruit.io``
=================================
.. automodule:: platypush.backend.adafruit.io

View File

@ -1,4 +1,4 @@
``platypush.backend.alarm``
``alarm``
===========================
.. automodule:: platypush.backend.alarm

View File

@ -1,4 +1,4 @@
``platypush.backend.assistant.google``
``assistant.google``
======================================
.. automodule:: platypush.backend.assistant.google

View File

@ -1,4 +1,4 @@
``platypush.backend.assistant``
``assistant``
===============================
.. automodule:: platypush.backend.assistant

View File

@ -1,4 +1,4 @@
``platypush.backend.assistant.snowboy``
``assistant.snowboy``
=======================================
.. automodule:: platypush.backend.assistant.snowboy

View File

@ -1,4 +1,4 @@
``platypush.backend.bluetooth.fileserver``
``bluetooth.fileserver``
==========================================
.. automodule:: platypush.backend.bluetooth.fileserver

View File

@ -1,4 +1,4 @@
``platypush.backend.bluetooth.pushserver``
``bluetooth.pushserver``
==========================================
.. automodule:: platypush.backend.bluetooth.pushserver

View File

@ -1,4 +1,4 @@
``platypush.backend.bluetooth``
``bluetooth``
===============================
.. automodule:: platypush.backend.bluetooth

View File

@ -1,4 +1,4 @@
``platypush.backend.bluetooth.scanner.ble``
``bluetooth.scanner.ble``
===========================================
.. automodule:: platypush.backend.bluetooth.scanner.ble

View File

@ -1,4 +1,4 @@
``platypush.backend.bluetooth.scanner``
``bluetooth.scanner``
=======================================
.. automodule:: platypush.backend.bluetooth.scanner

View File

@ -1,4 +1,4 @@
``platypush.backend.button.flic``
``button.flic``
=================================
.. automodule:: platypush.backend.button.flic

View File

@ -1,4 +1,4 @@
``platypush.backend.camera.pi``
``camera.pi``
===============================
.. automodule:: platypush.backend.camera.pi

View File

@ -1,4 +1,4 @@
``platypush.backend.chat.telegram``
``chat.telegram``
===================================
.. automodule:: platypush.backend.chat.telegram

View File

@ -1,4 +1,4 @@
``platypush.backend.clipboard``
``clipboard``
===============================
.. automodule:: platypush.backend.clipboard

View File

@ -1,4 +1,4 @@
``platypush.backend.covid19``
``covid19``
=============================
.. automodule:: platypush.backend.covid19

View File

@ -1,4 +1,4 @@
``platypush.backend.dbus``
``dbus``
==========================
.. automodule:: platypush.backend.dbus

View File

@ -1,4 +1,4 @@
``platypush.backend.file.monitor``
``file.monitor``
==================================
.. automodule:: platypush.backend.file.monitor

View File

@ -1,4 +1,4 @@
``platypush.backend.foursquare``
``foursquare``
================================
.. automodule:: platypush.backend.foursquare

View File

@ -1,4 +1,4 @@
``platypush.backend.github``
``github``
============================
.. automodule:: platypush.backend.github

View File

@ -1,4 +1,4 @@
``platypush.backend.google.fit``
``google.fit``
================================
.. automodule:: platypush.backend.google.fit

View File

@ -1,4 +1,4 @@
``platypush.backend.google.pubsub``
``google.pubsub``
===================================
.. automodule:: platypush.backend.google.pubsub

View File

@ -1,4 +1,4 @@
``platypush.backend.gps``
``gps``
=========================
.. automodule:: platypush.backend.gps

View File

@ -1,4 +1,4 @@
``platypush.backend.http.poll``
``http.poll``
===============================
.. automodule:: platypush.backend.http.poll

View File

@ -1,4 +1,4 @@
``platypush.backend.http``
``http``
==========================
.. automodule:: platypush.backend.http

View File

@ -1,4 +1,4 @@
``platypush.backend.inotify``
``inotify``
=============================
.. automodule:: platypush.backend.inotify

View File

@ -1,4 +1,4 @@
``platypush.backend.joystick.jstest``
``joystick.jstest``
=====================================
.. automodule:: platypush.backend.joystick.jstest

View File

@ -1,4 +1,4 @@
``platypush.backend.joystick.linux``
``joystick.linux``
====================================
.. automodule:: platypush.backend.joystick.linux

View File

@ -1,4 +1,4 @@
``platypush.backend.joystick``
``joystick``
==============================
.. automodule:: platypush.backend.joystick

View File

@ -1,4 +1,4 @@
``platypush.backend.kafka``
``kafka``
===========================
.. automodule:: platypush.backend.kafka

View File

@ -1,4 +1,4 @@
``platypush.backend.light.hue``
``light.hue``
===============================
.. automodule:: platypush.backend.light.hue

View File

@ -1,4 +1,4 @@
``platypush.backend.linode``
``linode``
============================
.. automodule:: platypush.backend.linode

View File

@ -1,4 +1,4 @@
``platypush.backend.log.http``
``log.http``
==============================
.. automodule:: platypush.backend.log.http

View File

@ -1,4 +1,4 @@
``platypush.backend.mail``
``mail``
==========================
.. automodule:: platypush.backend.mail

View File

@ -1,4 +1,4 @@
``platypush.backend.midi``
``midi``
==========================
.. automodule:: platypush.backend.midi

View File

@ -1,4 +1,4 @@
``platypush.backend.mqtt``
``mqtt``
==========================
.. automodule:: platypush.backend.mqtt

View File

@ -1,4 +1,4 @@
``platypush.backend.music.mopidy``
``music.mopidy``
==================================
.. automodule:: platypush.backend.music.mopidy

View File

@ -1,4 +1,4 @@
``platypush.backend.music.mpd``
``music.mpd``
===============================
.. automodule:: platypush.backend.music.mpd

View File

@ -1,4 +1,4 @@
``platypush.backend.music.snapcast``
``music.snapcast``
====================================
.. automodule:: platypush.backend.music.snapcast

View File

@ -1,5 +0,0 @@
``platypush.backend.music.spotify.connect``
===========================================
.. automodule:: platypush.backend.music.spotify.connect
:members:

View File

@ -0,0 +1,5 @@
``music.spotify``
===================================
.. automodule:: platypush.backend.music.spotify
:members:

View File

@ -1,4 +1,4 @@
``platypush.backend.nextcloud``
``nextcloud``
===============================
.. automodule:: platypush.backend.nextcloud

View File

@ -1,4 +1,4 @@
``platypush.backend.nfc``
``nfc``
=========================
.. automodule:: platypush.backend.nfc

View File

@ -1,4 +1,4 @@
``platypush.backend.nodered``
``nodered``
=============================
.. automodule:: platypush.backend.nodered

View File

@ -1,4 +1,4 @@
``platypush.backend.ping``
``ping``
==========================
.. automodule:: platypush.backend.ping

View File

@ -1,4 +1,4 @@
``platypush.backend.pushbullet``
``pushbullet``
================================
.. automodule:: platypush.backend.pushbullet

View File

@ -1,4 +1,4 @@
``platypush.backend.redis``
``redis``
===========================
.. automodule:: platypush.backend.redis

View File

@ -1,4 +1,4 @@
``platypush.backend.scard``
``scard``
===========================
.. automodule:: platypush.backend.scard

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.accelerometer``
``sensor.accelerometer``
==========================================
.. automodule:: platypush.backend.sensor.accelerometer

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.arduino``
``sensor.arduino``
====================================
.. automodule:: platypush.backend.sensor.arduino

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.battery``
``sensor.battery``
====================================
.. automodule:: platypush.backend.sensor.battery

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.bme280``
``sensor.bme280``
===================================
.. automodule:: platypush.backend.sensor.bme280

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.dht``
``sensor.dht``
================================
.. automodule:: platypush.backend.sensor.dht

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.distance``
``sensor.distance``
=====================================
.. automodule:: platypush.backend.sensor.distance

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.distance.vl53l1x``
``sensor.distance.vl53l1x``
=============================================
.. automodule:: platypush.backend.sensor.distance.vl53l1x

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.envirophat``
``sensor.envirophat``
=======================================
.. automodule:: platypush.backend.sensor.envirophat

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.ir.zeroborg``
``sensor.ir.zeroborg``
========================================
.. automodule:: platypush.backend.sensor.ir.zeroborg

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.leap``
``sensor.leap``
=================================
.. automodule:: platypush.backend.sensor.leap

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.ltr559``
``sensor.ltr559``
===================================
.. automodule:: platypush.backend.sensor.ltr559

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.mcp3008``
``sensor.mcp3008``
====================================
.. automodule:: platypush.backend.sensor.mcp3008

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.motion.pwm3901``
``sensor.motion.pwm3901``
===========================================
.. automodule:: platypush.backend.sensor.motion.pwm3901

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor``
``sensor``
============================
.. automodule:: platypush.backend.sensor

View File

@ -1,4 +1,4 @@
``platypush.backend.sensor.serial``
``sensor.serial``
===================================
.. automodule:: platypush.backend.sensor.serial

View File

@ -1,4 +1,4 @@
``platypush.backend.stt.deepspeech``
``stt.deepspeech``
====================================
.. automodule:: platypush.backend.stt.deepspeech

View File

@ -1,4 +1,4 @@
``platypush.backend.stt.picovoice.hotword``
``stt.picovoice.hotword``
===========================================
.. automodule:: platypush.backend.stt.picovoice.hotword

View File

@ -1,4 +1,4 @@
``platypush.backend.stt.picovoice.speech``
``stt.picovoice.speech``
==========================================
.. automodule:: platypush.backend.stt.picovoice.speech

View File

@ -1,4 +1,4 @@
``platypush.backend.stt``
``stt``
=========================
.. automodule:: platypush.backend.stt

View File

@ -1,4 +1,4 @@
``platypush.backend.tcp``
``tcp``
=========================
.. automodule:: platypush.backend.tcp

View File

@ -1,4 +1,4 @@
``platypush.backend.todoist``
``todoist``
=============================
.. automodule:: platypush.backend.todoist

View File

@ -1,4 +1,4 @@
``platypush.backend.travisci``
``travisci``
==============================
.. automodule:: platypush.backend.travisci

View File

@ -1,4 +1,4 @@
``platypush.backend.trello``
``trello``
============================
.. automodule:: platypush.backend.trello

View File

@ -1,4 +1,4 @@
``platypush.backend.weather.buienradar``
``weather.buienradar``
========================================
.. automodule:: platypush.backend.weather.buienradar

View File

@ -1,4 +1,4 @@
``platypush.backend.weather.darksky``
``weather.darksky``
=====================================
.. automodule:: platypush.backend.weather.darksky

View File

@ -1,4 +1,4 @@
``platypush.backend.weather.openweathermap``
``weather.openweathermap``
============================================
.. automodule:: platypush.backend.weather.openweathermap

View File

@ -1,4 +1,4 @@
``platypush.backend.weather``
``weather``
=============================
.. automodule:: platypush.backend.weather

View File

@ -1,4 +1,4 @@
``platypush.backend.websocket``
``websocket``
===============================
.. automodule:: platypush.backend.websocket

View File

@ -1,4 +1,4 @@
``platypush.backend.wiimote``
``wiimote``
=============================
.. automodule:: platypush.backend.wiimote

View File

@ -1,4 +1,4 @@
``platypush.backend.zigbee.mqtt``
``zigbee.mqtt``
=================================
.. automodule:: platypush.backend.zigbee.mqtt

View File

@ -1,4 +1,4 @@
``platypush.backend.zwave.mqtt``
``zwave.mqtt``
================================
.. automodule:: platypush.backend.zwave.mqtt

View File

@ -1,4 +1,4 @@
``platypush.backend.zwave``
``zwave``
===========================
.. automodule:: platypush.backend.zwave

View File

@ -1,4 +1,4 @@
``platypush.message.event.adafruit``
``adafruit``
====================================
.. automodule:: platypush.message.event.adafruit

View File

@ -1,4 +1,4 @@
``platypush.message.event.alarm``
``alarm``
=================================
.. automodule:: platypush.message.event.alarm

View File

@ -1,4 +1,4 @@
``platypush.message.event.application``
``application``
=======================================
.. automodule:: platypush.message.event.application

View File

@ -1,4 +1,4 @@
``platypush.message.event.assistant``
``assistant``
=====================================
.. automodule:: platypush.message.event.assistant

View File

@ -1,4 +1,4 @@
``platypush.message.event.bluetooth``
``bluetooth``
=====================================
.. automodule:: platypush.message.event.bluetooth

View File

@ -1,4 +1,4 @@
``platypush.message.event.button.flic``
``button.flic``
=======================================
.. automodule:: platypush.message.event.button.flic

View File

@ -1,4 +1,4 @@
``platypush.message.event.camera``
``camera``
==================================
.. automodule:: platypush.message.event.camera

View File

@ -1,4 +1,4 @@
``platypush.message.event.chat.telegram``
``chat.telegram``
=========================================
.. automodule:: platypush.message.event.chat.telegram

View File

@ -1,4 +1,4 @@
``platypush.message.event.clipboard``
``clipboard``
=====================================
.. automodule:: platypush.message.event.clipboard

View File

@ -1,4 +1,4 @@
``platypush.message.event.covid19``
``covid19``
===================================
.. automodule:: platypush.message.event.covid19

View File

@ -1,4 +1,4 @@
``platypush.message.event.custom``
``custom``
==================================
.. automodule:: platypush.message.event.custom

View File

@ -1,4 +1,4 @@
``platypush.message.event.distance``
``distance``
====================================
.. automodule:: platypush.message.event.distance

View File

@ -1,4 +1,4 @@
``platypush.message.event.file``
``file``
================================
.. automodule:: platypush.message.event.file

View File

@ -1,4 +1,4 @@
``platypush.message.event.foursquare``
``foursquare``
======================================
.. automodule:: platypush.message.event.foursquare

Some files were not shown because too many files have changed in this diff Show More