Sphinx build from Action af14753

.buildinfo

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 9064eaa91d72e5b3d158ea257aad8147
+tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/configuration/calendar.rst.txt

@@ -0,0 +1,17 @@
+#####################
+Calendar Mode Options
+#####################
+
+========================= ========== ======== ============================================================================================================
+ Name                      Type       Since    Description
+========================= ========== ======== ============================================================================================================
+ enableModeChange          boolean    v0.7.0   ``false`` Set true to enable mode change (Calendar/Events) must have "name" set to toggle
+ firstDayOfWeek            integer    v0.7.0   ``1`` First day of week, default 1 for Monday
+ showLastCalendarWeek      boolean    v0.7.5   ``false`` If true it will always show 6 lines. If false, the 6th line won't be displayed if not needed.
+ calEventTime              boolean    v1.5.0   ``false`` If true the time will be shown on the event summary for the selected day
+ disableCalEventLink       boolean    v1.5.0   ``false`` If true the link will be disabled on the event summary for the selected day
+ disableCalLocationLink    boolean    v1.5.0   ``false`` If true the link will be disabled on the event location icon for the selected day
+ calShowDescription        boolean    v2.5.0   ``false`` If true this will display the description in calendar mode
+ disableCalLink            boolean    v3.0.0   ``false`` If true the link to google calendar will be removed
+ cardHeight                string     v4.3.0   ``100%`` Change to ``px`` or ``%`` to set the height of the card, this will add scroll if it is too small
+========================= ========== ======== ============================================================================================================

_sources/configuration/entity.rst.txt

@@ -0,0 +1,22 @@
+##############
+Entity Options
+##############
+
+==================== ========= ======== =============================================================================================================
+ Name                 Type      Since    Description
+==================== ========= ======== =============================================================================================================
+ icon                 string    v2.0.0   ``null`` Add an icon to a calendar
+ startTimeFilter      string    v2.0.0   Only shows events between specific times _NOTE_ must be set with ``endTimeFilter`` format: ``'10:00'``
+ endTimeFilter        string    v2.0.0   Only shows events between specific times _NOTE_ must be set with ``startTimeFilter`` format: ``'17:00'``
+ maxDaysToShow        integer   v5.2.0   ``7`` Maximum number of days to show. Overrides main configuration maxDaysToShow for this calendar
+ blocklist            string    v7.0.0   ``null`` Simple case insensitive regex to ignore events that match title
+ blocklistLocation    string    v7.0.0   ``null`` Simple case insensitive regex to ignore events that match location
+ allowlist            string    v7.0.0   ``null`` Simple case insensitive regex to ignore events that match title
+ allowlistLocation    string    v7.0.0   ``null`` Simple case insensitive regex to only add events that match location
+ showMultiDay         boolean   v7.0.0   ``false`` Split multi-day events across all days
+ name                 string    v7.0.0   ``null`` Add a calendar name to be shown with event
+ eventTitle           string    v7.3.0   Where no event title exists, add this string instead, Will only add to this entity, can also be globally set
+==================== ========= ======== =============================================================================================================
+
+.. note::
+   It is not advised to use ``allowlist`` & ``blocklist`` under the same entity.

_sources/configuration/event.rst.txt

@@ -0,0 +1,23 @@
+##################
+Event Mode Options
+##################
+
+======================= ========== ======== ===========================================================================================================
+ Name                    Type       Since    Description
+======================= ========== ======== ===========================================================================================================
+ showCurrentEventLine    boolean    v0.3.0   ``false`` Show line before next event. Don't enable when showProgressBar is true - will look bad
+ showProgressBar         boolean    v0.5.5   ``true`` Show event progress with moving icon. Don't enable when showCurrentEventLine - will look bad
+ showFullDayProgress     boolean    v1.7.0   ``false`` Enables the progress bar for full day events
+ showRelativeTime        boolean    v2.1.0   ``true`` Show relative time until the start of an event
+ showEventIcon           boolean    v2.2.3   ``false`` Show the entity icon before the event title
+ europeanDate            boolean    v2.2.3   ``false`` Show date for event days in european format
+ softLimit               integer    v2.7.0   Adds flexibility when ``maxEventCount`` is set, so if there is only e.g. 1 extra event it would be shown
+ showHiddenText          boolean    v3.3.0   ``true`` Show x hidden events when limited number of events selected
+ hiddenEventText         string     v3.3.0   ``localize('common.hiddenEventText')`` allows a user to change the text displayed for hidden events
+ showCalendarName        boolean    v7.0.0   ``false`` Show the calendar name in Event Mode
+ showWeekNumber          boolean    v7.0.0   ``false`` Show the year week number at the beginning of each week
+ showEventDate           boolean    v7.1.0   ``true`` Show the event date
+ showDatePerEvent        boolean    v7.2.0   ``false`` Show the date next to each event entry
+ showTimeRemaining       boolean    v7.3.0   ``false`` Show the amount of time remaining for an event
+ showAllDayHours         boolean    v7.5.0   ``true`` Show "All Day" text under full day events
+======================= ========== ======== ===========================================================================================================

_sources/configuration/language.rst.txt

@@ -0,0 +1,94 @@
+################
+Language Options
+################
+
+.. note:
+   Week / month names are translated automatically
+
+========================== ========= ======== ===============================================================================================================================================================================================================
+ Name                       Type      Since    Description
+========================== ========= ======== ===============================================================================================================================================================================================================
+ untilText                  string    v0.3.0   ``Until`` Custom text for ``Until`` text
+ fullDayEventText           string    v0.3.0   ``All day`` Custom text for ``All day`` text
+ noEventsForNextDaysText    string    v0.8.6   ``No events in the next days`` Custom text for ``No events in the next days`` text
+ noEventText                string    v4.1.0   ``No events`` Custom text for ``No events`` text, only if ``showNoEventsForToday`` or ``showNoEventDays`` is true
+ dateFormat                 string    v0.7.2   ``LL`` Custom date format - see `list of localized formats <https://day.js.org/docs/en/display/format#localized-formats>`_
+ hoursFormat                string    v5.0.0   This is now set via your HA profile settings, you can still set this to override if required - see `List of all available formats <https://day.js.org/docs/en/display/format#list-of-all-available-formats`_
+========================== ========= ======== ===============================================================================================================================================================================================================
+
+
+**************
+Locale Support
+**************
+
+I have limited the number of Locales to keep the size down, however if you use
+a specific locale that is not listed, please log an issue and I will look to
+get this added for you.
+
+
+The Configuration editor supports the following locales:
+
+========= ===========
+ Locale    Language
+========= ===========
+ da        Danish
+ de        German
+ en        English
+ et        Estonian
+ fi        Finnish
+ fr        French
+ nb        Norwegian
+ sl        Slovenian
+ sv        Swedish
+========= ===========
+
+
+
+The card date information supports the following locales:
+
+========= ==============================
+ Locale    Language
+========= ==============================
+ cs        Czech
+ da        Danish
+ de-at     German (Austria)
+ de-ch     German (Switzerland)
+ de        German
+ en-au     English (Australian)
+ en-ca     English (Canada)
+ en-gb     English (United Kingdom)
+ en-ie     English (Ireland)
+ en-in     English (India)
+ en-nz     English (New Zeland)
+ en-sg     English (Singapore)
+ en-tt     English (Trinidad & Tobago)
+ en        English
+ es-do     Spanish (Dominican Republic)
+ es-pr     Spanish (Puerto Rico)
+ es-us     Spanish (United States)
+ es        Spanish
+ fi        Finnish
+ fr-ca     French (Canada)
+ fr-ch     French (Switzerland)
+ fr        French
+ he        Hebrew
+ hu        Hungarian
+ it-ch     Italian (Switzerland)
+ it        Italian
+ ja        Japanese
+ nb        Norwegian
+ ne        Nepalese
+ nl-be     Dutch (Belgium)
+ nl        Dutch
+ pl        Polish
+ pt-br     Portuguese (Brazil)
+ pt        Portuguese
+ ru        Russian
+ sl        Slovenian
+ sv        Swedish
+ sk        Slovak
+========= ==============================
+
+.. note:
+   If you would like a different language to be supported, please log an issue on github
+   stating the language and language code that you would like to be added.

_sources/configuration/main.rst.txt

@@ -0,0 +1,44 @@
+.. _mainoptions:
+
+############
+Main Options
+############
+
+========================= ========= =============== ========== ==========================================================================================================================================================================================================================
+ Name                      Type      Default         Since      Description
+========================= ========= =============== ========== ==========================================================================================================================================================================================================================
+ type                      string    **required**    v0.3.0     ``custom:atomic-calendar-revive``
+ entities                  list      **required**    v0.3.0     One or more calendars, configured in HA [Google Calendar Component][googlecalcomp]
+ name                      string    optional        v0.12.0    Card name.
+ maxDaysToShow             integer   optional        v0.3.0     ``7`` Maximum number of days to show; if set to zero will only display currently running events
+ maxEventCount             integer   optional        v0.9.0     ``0`` Maximum number of events to show; zero removes any limitation
+ showLocation              boolean   optional        v0.3.0     ``true`` Show location link (right side)
+ showMonth                 boolean   optional        v0.3.0     ``false`` Show month under day (left side)
+ showWeekDay               boolean   optional        v1.3.0     ``false`` Show week day under day (left side)
+ showLoader                boolean   optional        v0.7.0     ``true`` Show animation, when events are being loaded from Google Calendar.
+ showDate                  boolean   optional        v0.7.2     ``false`` Show the date on the right side of the card name
+ startDaysAhead            integer   optional        v0.7.3     ``0`` If you set more than 0, events will be loaded starting `x` days from today. For example `1` - the component will show events starting from tomorrow, if a negative number is used, events previous will be shown.
+ showDescription           boolean   optional        v0.8.4     ``false`` Shows long description of event from Google Calendar.
+ showNoEventsForToday      boolean   optional        v0.8.6     ``false`` Shows `No events for today` if no events, instead of omit the entry.
+ sortByStartTime           boolean   optional        v0.9.0     ``false`` Sort events by start time first instead of grouping them by calendar.
+ disableEventLink          boolean   optional        v0.10.0    ``false`` disables links in event title.
+ disableLocationLink       boolean   optional        v0.10.0    ``false`` disables links in event location.
+ linkTarget                string    optional        v0.11.0    ``_blank`` Allows custom target for links, default will open new tab.
+ defaultMode               integer   optional        v2.0.0     ``Event`` Set `Event` to make Events default mode, set `Calendar` to make Calendar mode default
+ refreshInterval           integer   optional        v2.1.0     ``60`` Set how often the calendar should refresh data in seconds
+ showHours                 boolean   optional        v2.7.0     ``true`` shows when and event starts / ends
+ showRelativeTime          boolean   optional        v2.7.0     ``true`` shows amount of time until event starts
+ showPrivate               boolean   optional        v3.3.0     ``true`` show private events (only Google Calendar)
+ showNoEventDays           boolean   optional        v4.1.0     ``false`` Shows days that have no events, instead of only showing event days
+ descLength                integer   optional        v4.8.0     Sets the length of descriptions
+ hideDuplicates            boolean   optional        v5.1.0     ``false`` Removes any duplicate items based on summary, start time and end time.
+ hideDeclined              boolean   optional        v7.0.0     ``false`` show/hide events that have been declined
+ showMultiDay              boolean   optional        v7.0.0     ``false`` if set true will show multi-day events on each day
+ showMultiDayEventParts    boolean   optional        v7.0.0     ``false`` if set true will show how many days in event and which day it is
+ hideFinishedEvents        boolean   optional        v7.0.0     ``false`` if set true will hide any finished events
+ eventTitle                string    optional        v7.3.0     Where no event title exists, add this string instead, Will add globally unless entity.eventTitle is set.
+ compactMode               boolean   optional        v7.3.0     ``false`` if set true will squash text down to allow for much more compact design
+ hoursOnSameLine           boolean   optional        v7.3.0     ``false`` if set true will move hours to show on the same line as the summary. NOTE using other options can mess up this style
+ language                  string    optional        unknown    Not recommended to use, but can set the language code e.g. "gb" / "es"
+ titleLength               integer   optional        v7.4.0     Sets the maximum length of the event titles
+========================= ========= =============== ========== ==========================================================================================================================================================================================================================

_sources/contribute/bugs.rst.txt

@@ -0,0 +1,55 @@
+##############
+Reporting Bugs
+##############
+
+This section guides you through submitting a bug report for Atomic Calendar Revive.
+Following these guidelines helps maintainers and the community understand your report
+:pencil:, reproduce the behavior :computer: :computer:, and find related reports
+:mag_right:.
+
+Before creating bug reports, please check the below information as you might find out
+that you don't need to create one. When you are creating a bug report,
+please :ref:include as many details as possible:, the information it asks for helps
+us resolve issues faster.
+
+.. note:
+   If you find a **Closed** issue that seems like it is the same thing that you're
+   experiencing, open a new issue and include a link to the original issue in the
+   body of your new one.
+
+
+******************************
+Before Submitting A Bug Report
+******************************
+
+* **Check the :ref:`qucikstart`** You may have miss-configured the plugin and
+  this is resulting in the issue you see
+* **Check the :ref:`FAQs`** for a list of common questions and problems.
+* **Perform a `cursory search <https://github.com/marksie1988/atomic-calendar-revive/issues?q=is%3Aissue>`_**
+  to see if the problem has already been reported. If it has **and the issue is still open**, add a comment to
+  the existing issue instead of opening a new one.
+
+*****************************
+How do i submit a bug report?
+*****************************
+
+Bugs are tracked as `GitHub issues <https://guides.github.com/features/issues/>`_.
+After you've determined this is not a configuration issue, create an issue on github
+and provide the following information by filling in `the template <https://github.com/marksie1988/atomic-calendar-revive/issues/new?assignees=&labels=bug&template=bug_report.md&title=%5BBUG%5D+>`_.
+
+Explain the problem and include additional details to help maintainers reproduce the problem:
+
+- **Use a clear and descriptive title** for the issue to identify the problem.
+- **Describe the exact steps which reproduce the problem** in as many details as possible. For example, start by explaining how you installed the plugin. When listing steps, **don't just say what you did, but explain how you did it**. For example, did you use the Lovelace Editor or do the change in YAML directly.
+- **Provide specific examples to demonstrate the steps**. Include screenshots, or copy/pasteable configuration snippets, which you use in those examples. If you're providing snippets in the issue, use `Markdown code blocks <https://help.github.com/articles/markdown-basics/#multiple-lines>`_.
+- **Describe the behavior you observed after following the steps** and point out what exactly is the problem with that behavior.
+- **Explain which behavior you expected to see instead and why.**
+- **Include screenshots and animated GIFs** which show you following the described steps and clearly demonstrate the problem.
+- **If Chrome's developer tools pane is showing errors**, include these in your report
+- **If the problem wasn't triggered by a specific action**, describe what you were doing before the problem happened and share more information using the guidelines below.
+
+Provide more context by answering these questions:
+
+- **Did the problem start happening recently** (e.g. after updating to a new version of HA / Atomic Calendar Revive) or was this always a problem?
+- If the problem started happening recently, **can you reproduce the problem in an older version of Atomic Calendar Revive?** What's the most recent version in which the problem doesn't happen? You can install older versions of Atomic Calendar Revive via HACS or from the releases page on github
+- **Can you reliably reproduce the issue?** If not, provide details about how often the problem happens and under which conditions it normally happens.