From 3f5dc2886509ca97f924a21e05c6b44b7a259768 Mon Sep 17 00:00:00 2001
From: uchagani <umair.chagani@gmail.com>
Date: Sun, 23 Dec 2018 04:19:56 -0500
Subject: [PATCH] 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
---
 .../sensor.islamic_prayer_times.markdown      | 75 +++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100644 source/_components/sensor.islamic_prayer_times.markdown

diff --git a/source/_components/sensor.islamic_prayer_times.markdown b/source/_components/sensor.islamic_prayer_times.markdown
new file mode 100644
index 000000000000..0bed6f3d6364
--- /dev/null
+++ b/source/_components/sensor.islamic_prayer_times.markdown
@@ -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
+```