Add docs for islamic_prayer_times sensor platform (#7783)

* adding docs for islamic_prayer_times sensor platform

* update docs

* clean up docs some more

* change iot class to cloud polling

* Update source/_components/sensor.islamic_prayer_times.markdown

Co-Authored-By: uchagani <umair.chagani@gmail.com>

* attempting to fix errors

* fix build errors

* change component to platform
This commit is contained in:
uchagani 2018-12-23 04:19:56 -05:00 committed by Martin Hjelmare
parent 3cde8b2729
commit 3f5dc28865

View File

@ -0,0 +1,75 @@
---
layout: page
title: "Islamic Prayer Times"
description: "Instructions on how to integrate the Islamic Prayer Times sensor within Home Assistant."
date: 2018-12-09 00:00
sidebar: true
comments: false
sharing: true
footer: true
ha_category: Sensor
ha_iot_class: "Cloud Polling"
ha_release: "0.85"
---
The Islamic Prayer Times (`islamic_prayer_times`) sensor platform displays the various prayer times for Muslims as sensors.
This platform calculates prayer times using the following calculation methods:
- University of Islamic Sciences in Karachi
- Islamic Society of North America
- Muslim World League
- Umm Al-Qura University in Makkah
## {% linkable_title Configuration %}
To enable this sensor in your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
sensor:
- platform: islamic_prayer_times
```
{% configuration %}
sensors:
required: false
default: "['fajr', 'dhuhr', 'asr', 'maghrib', 'isha']"
type: list
description: List of available sensors.
keys:
fajr:
description: Show the fajr prayer time for today.
sunrise:
description: Show the sunrise for today which is the end of fajr prayer. This is a calculated field and may not necessarily be the same as the astronomical sunrise.
dhuhr:
description: Show the dhuhr prayer time for today.
asr:
description: Show the asr prayer time for today.
maghrib:
description: Show the maghrib prayer time for today.
isha:
description: Show the isha prayer time for today.
midnight:
description: Show the midnight for today which is the end of isha prayer. This is a calculated field and is not the same as 12AM.
calculation_method:
required: false
default: 'isna'
type: string
description: "The calculation method used for prayer times. Must be one of: `karachi`, `isna`, `mwl`, `makkah`."
{% endconfiguration %}
```yaml
# Example configuration.yaml entry for all available sensors using a non-default calculation method
sensor:
- platform: islamic_prayer_times
calculation_method: makkah
sensors:
- fajr
- sunrise
- dhuhr
- asr
- maghrib
- isha
- midnight
```