Use helper to generate documentation URL

src/components/media-player/ha-media-player-browse.ts

@@ -22,6 +22,7 @@ import { styleMap } from "lit-html/directives/style-map";
 import { fireEvent } from "../../common/dom/fire_event";
 import { computeRTLDirection } from "../../common/util/compute_rtl";
 import { debounce } from "../../common/util/debounce";
+import type { MediaPlayerItem } from "../../data/media-player";
 import {
   browseLocalMediaPlayer,
   browseMediaPlayer,
@@ -30,11 +31,11 @@ import {
   MediaPickedEvent,
   MediaPlayerBrowseAction,
 } from "../../data/media-player";
-import type { MediaPlayerItem } from "../../data/media-player";
 import { showAlertDialog } from "../../dialogs/generic/show-dialog-box";
 import { installResizeObserver } from "../../panels/lovelace/common/install-resize-observer";
 import { haStyle } from "../../resources/styles";
 import type { HomeAssistant } from "../../types";
+import { documentationUrl } from "../../util/documentation-url";
 import "../entity/ha-entity-picker";
 import "../ha-button-menu";
 import "../ha-card";
@@ -511,7 +512,10 @@ export class HaMediaPlayerBrowse extends LitElement {
         <p>
           Check the
           <a
-            href="https://www.home-assistant.io/integrations/media_source/#local-media"
+            href="${documentationUrl(
+              this.hass,
+              "/integrations/media_source/#local-media"
+            )}"
             target="_blank"
             rel="noreferrer"
             >documentation</a

src/dialogs/config-flow/step-flow-pick-handler.ts

@@ -20,6 +20,7 @@ import { LocalizeFunc } from "../../common/translations/localize";
 import "../../components/ha-icon-next";
 import { domainToName } from "../../data/integration";
 import { HomeAssistant } from "../../types";
+import { documentationUrl } from "../../util/documentation-url";
 import { FlowConfig } from "./show-dialog-data-entry-flow";
 import { configFlowContentStyles } from "./styles";
 
@@ -122,7 +123,7 @@ class StepFlowPickHandler extends LitElement {
               ${this.hass.localize(
                 "ui.panel.config.integrations.note_about_website_reference"
               )}<a
-                href="https://www.home-assistant.io/integrations/"
+                href="${documentationUrl(this.hass, "/integrations/")}"
                 target="_blank"
                 rel="noreferrer"
                 >${this.hass.localize(

src/panels/config/automation/ha-automation-editor.ts

@@ -39,6 +39,7 @@ import "../../../layouts/ha-app-layout";
 import "../../../layouts/hass-tabs-subpage";
 import { haStyle } from "../../../resources/styles";
 import { HomeAssistant, Route } from "../../../types";
+import { documentationUrl } from "../../../util/documentation-url";
 import "../ha-config-section";
 import { configSections } from "../ha-panel-config";
 import "./action/ha-automation-action";
@@ -159,7 +160,10 @@ export class HaAutomationEditor extends LitElement {
                           "ui.panel.config.automation.editor.modes.description",
                           "documentation_link",
                           html`<a
-                            href="https://www.home-assistant.io/integrations/automation/#automation-modes"
+                            href="${documentationUrl(
+                              this.hass,
+                              "/integrations/automation/#automation-modes"
+                            )}"
                             target="_blank"
                             rel="noreferrer"
                             >${this.hass.localize(
@@ -247,7 +251,10 @@ export class HaAutomationEditor extends LitElement {
                       )}
                     </p>
                     <a
-                      href="https://home-assistant.io/docs/automation/trigger/"
+                      href="${documentationUrl(
+                        this.hass,
+                        "/docs/automation/trigger/"
+                      )}"
                       target="_blank"
                       rel="noreferrer"
                     >
@@ -276,7 +283,10 @@ export class HaAutomationEditor extends LitElement {
                       )}
                     </p>
                     <a
-                      href="https://home-assistant.io/docs/scripts/conditions/"
+                      href="${documentationUrl(
+                        this.hass,
+                        "/docs/scripts/conditions/"
+                      )}"
                       target="_blank"
                       rel="noreferrer"
                     >
@@ -305,7 +315,10 @@ export class HaAutomationEditor extends LitElement {
                       )}
                     </p>
                     <a
-                      href="https://home-assistant.io/docs/automation/action/"
+                      href="${documentationUrl(
+                        this.hass,
+                        "/docs/automation/action/"
+                      )}"
                       target="_blank"
                       rel="noreferrer"
                     >

src/panels/config/cloud/dialog-manage-cloudhook/dialog-manage-cloudhook.ts

@@ -14,6 +14,7 @@ import type { HaPaperDialog } from "../../../../components/dialog/ha-paper-dialo
 import { showConfirmationDialog } from "../../../../dialogs/generic/show-dialog-box";
 import { haStyle } from "../../../../resources/styles";
 import { HomeAssistant } from "../../../../types";
+import { documentationUrl } from "../../../../util/documentation-url";
 import { WebhookDialogParams } from "./show-dialog-manage-cloudhook";
 
 const inputLabel = "Public URL – Click to copy to clipboard";
@@ -37,8 +38,11 @@ export class DialogManageCloudhook extends LitElement {
     const { webhook, cloudhook } = this._params;
     const docsUrl =
       webhook.domain === "automation"
-        ? "https://www.home-assistant.io/docs/automation/trigger/#webhook-trigger"
-        : `https://www.home-assistant.io/integrations/${webhook.domain}/`;
+        ? documentationUrl(
+            this.hass!,
+            "/docs/automation/trigger/#webhook-trigger"
+          )
+        : documentationUrl(this.hass!, `/integrations/${webhook.domain}/`);
     return html`
       <ha-paper-dialog with-backdrop>
         <h2>

src/panels/config/cloud/register/cloud-register.js

@@ -8,6 +8,7 @@ import "../../../../layouts/hass-subpage";
 import { EventsMixin } from "../../../../mixins/events-mixin";
 import LocalizeMixin from "../../../../mixins/localize-mixin";
 import "../../../../styles/polymer-ha-style";
+import { documentationUrl } from "../../../../util/documentation-url";
 import "../../ha-config-section";
 
 /*
@@ -70,8 +71,8 @@ class CloudRegister extends LocalizeMixin(EventsMixin(PolymerElement)) {
             <p>
               [[localize('ui.panel.config.cloud.register.information4')]]
               </p><ul>
-                <li><a href="https://home-assistant.io/tos/" target="_blank" rel="noreferrer">[[localize('ui.panel.config.cloud.register.link_terms_conditions')]]</a></li>
-                <li><a href="https://home-assistant.io/privacy/" target="_blank" rel="noreferrer">[[localize('ui.panel.config.cloud.register.link_privacy_policy')]]</a></li>
+                <li><a href="[[_computeDocumentationUrlTos(hass)]]" target="_blank" rel="noreferrer">[[localize('ui.panel.config.cloud.register.link_terms_conditions')]]</a></li>
+                <li><a href="[[_computeDocumentationUrlPrivacy(hass)]]" target="_blank" rel="noreferrer">[[localize('ui.panel.config.cloud.register.link_privacy_policy')]]</a></li>
               </ul>
             </p>
           </div>
@@ -137,6 +138,14 @@ class CloudRegister extends LocalizeMixin(EventsMixin(PolymerElement)) {
     }
   }
 
+  _computeDocumentationUrlTos(hass) {
+    return documentationUrl(hass, "/tos/");
+  }
+
+  _computeDocumentationUrlPrivacy(hass) {
+    return documentationUrl(hass, "/privacy/");
+  }
+
   _handleRegister() {
     let invalid = false;
 

src/panels/config/customize/ha-form-customize.js

@@ -6,10 +6,11 @@ import { html } from "@polymer/polymer/lib/utils/html-tag";
 import { PolymerElement } from "@polymer/polymer/polymer-element";
 import { computeStateDomain } from "../../../common/entity/compute_state_domain";
 import LocalizeMixin from "../../../mixins/localize-mixin";
+import "../../../styles/polymer-ha-style";
+import { documentationUrl } from "../../../util/documentation-url";
 import hassAttributeUtil from "../../../util/hass-attributes-util";
-import "./ha-form-customize-attributes";
 import "../ha-form-style";
-import "../../../styles/polymer-ha-style";
+import "./ha-form-customize-attributes";
 
 class HaFormCustomize extends LocalizeMixin(PolymerElement) {
   static get template() {
@@ -30,7 +31,7 @@ class HaFormCustomize extends LocalizeMixin(PolymerElement) {
         <div class="warning">
           [[localize('ui.panel.config.customize.warning.include_sentence')]]
           <a
-            href="https://www.home-assistant.io/docs/configuration/customizing-devices/#customization-using-the-ui"
+            href="[[_computeDocumentationUrl(hass)]]"
             target="_blank"
             rel="noreferrer"
             >[[localize('ui.panel.config.customize.warning.include_link')]]</a
@@ -210,6 +211,13 @@ class HaFormCustomize extends LocalizeMixin(PolymerElement) {
     );
   }
 
+  _computeDocumentationUrl(hass) {
+    return documentationUrl(
+      hass,
+      "/docs/configuration/customizing-devices/#customization-using-the-ui"
+    );
+  }
+
   computeLocalAttributes(localConfig) {
     if (!localConfig) return [];
     const localKeys = Object.keys(localConfig);

src/panels/config/info/ha-config-info.ts

@@ -12,6 +12,7 @@ import "./integrations-card";
 import "./system-health-card";
 import { configSections } from "../ha-panel-config";
 import "../../../layouts/hass-tabs-subpage";
+import { documentationUrl } from "../../../util/documentation-url";
 
 const JS_TYPE = __BUILD__;
 const JS_VERSION = __VERSION__;
@@ -42,7 +43,7 @@ class HaConfigInfo extends LitElement {
       >
         <div class="about">
           <a
-            href="https://www.home-assistant.io"
+            href="${documentationUrl(this.hass, "")}"
             target="_blank"
             rel="noreferrer"
             ><img
@@ -63,7 +64,7 @@ class HaConfigInfo extends LitElement {
           </p>
           <p class="develop">
             <a
-              href="https://www.home-assistant.io/developers/credits/"
+              href="${documentationUrl(this.hass, "/developers/credits/")}"
               target="_blank"
               rel="noreferrer"
             >

src/panels/config/integrations/integration-panels/zwave/zwave-network.ts

@@ -1,20 +1,20 @@
-import "../../../../../components/ha-icon-button";
-import "../../../../../components/ha-circular-progress";
 import { UnsubscribeFunc } from "home-assistant-js-websocket";
 import {
   css,
   CSSResult,
   customElement,
   html,
+  internalProperty,
   LitElement,
   property,
-  internalProperty,
   TemplateResult,
 } from "lit-element";
 import "../../../../../components/buttons/ha-call-api-button";
 import "../../../../../components/buttons/ha-call-service-button";
 import "../../../../../components/ha-card";
+import "../../../../../components/ha-circular-progress";
 import "../../../../../components/ha-icon";
+import "../../../../../components/ha-icon-button";
 import "../../../../../components/ha-service-description";
 import {
   fetchNetworkStatus,
@@ -26,6 +26,7 @@ import {
 } from "../../../../../data/zwave";
 import { haStyle } from "../../../../../resources/styles";
 import { HomeAssistant } from "../../../../../types";
+import { documentationUrl } from "../../../../../util/documentation-url";
 import "../../../ha-config-section";
 
 @customElement("zwave-network")
@@ -71,7 +72,10 @@ export class ZwaveNetwork extends LitElement {
           )}
           <p>
             <a
-              href="https://www.home-assistant.io/docs/z-wave/control-panel/"
+              href="${documentationUrl(
+                this.hass,
+                "/docs/z-wave/control-panel/"
+              )}"
               target="_blank"
               rel="noreferrer"
             >

src/panels/config/person/dialog-person-detail.ts

@@ -4,23 +4,24 @@ import {
   css,
   CSSResult,
   html,
+  internalProperty,
   LitElement,
   property,
-  internalProperty,
   TemplateResult,
 } from "lit-element";
 import memoizeOne from "memoize-one";
-import "../../../components/ha-picture-upload";
-import type { HaPictureUpload } from "../../../components/ha-picture-upload";
 import "../../../components/entity/ha-entities-picker";
 import { createCloseHeading } from "../../../components/ha-dialog";
+import "../../../components/ha-picture-upload";
+import type { HaPictureUpload } from "../../../components/ha-picture-upload";
 import "../../../components/user/ha-user-picker";
 import { PersonMutableParams } from "../../../data/person";
+import { CropOptions } from "../../../dialogs/image-cropper-dialog/show-image-cropper-dialog";
 import { PolymerChangedEvent } from "../../../polymer-types";
 import { haStyleDialog } from "../../../resources/styles";
 import { HomeAssistant } from "../../../types";
+import { documentationUrl } from "../../../util/documentation-url";
 import { PersonDetailDialogParams } from "./show-dialog-person-detail";
-import { CropOptions } from "../../../dialogs/image-cropper-dialog/show-image-cropper-dialog";
 
 const includeDomains = ["device_tracker"];
 
@@ -153,7 +154,10 @@ class DialogPersonDetail extends LitElement {
                   <ul>
                     <li>
                       <a
-                        href="https://www.home-assistant.io/integrations/#presence-detection"
+                        href="${documentationUrl(
+                          this.hass,
+                          "/integrations/#presence-detection"
+                        )}"
                         target="_blank"
                         rel="noreferrer"
                         >${this.hass!.localize(

src/panels/config/scene/ha-scene-dashboard.ts

@@ -25,6 +25,7 @@ import { showAlertDialog } from "../../../dialogs/generic/show-dialog-box";
 import "../../../layouts/hass-tabs-subpage-data-table";
 import { haStyle } from "../../../resources/styles";
 import { HomeAssistant, Route } from "../../../types";
+import { documentationUrl } from "../../../util/documentation-url";
 import { showToast } from "../../../util/toast";
 import { configSections } from "../ha-panel-config";
 
@@ -191,7 +192,7 @@ class HaSceneDashboard extends LitElement {
         ${this.hass.localize("ui.panel.config.scene.picker.introduction")}
         <p>
           <a
-            href="https://home-assistant.io/docs/scene/editor/"
+            href="${documentationUrl(this.hass, "/docs/scene/editor/")}"
             target="_blank"
             rel="noreferrer"
           >