mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 01:06:52 +00:00
Update all mentions links to MDI with the updated URL (#25789)
This commit is contained in:
parent
46ff9f5b8c
commit
d84a45d7ac
@ -103,7 +103,7 @@ content: |
|
||||
|
||||
## Icons
|
||||
|
||||
You can use [materialdesignicons.com](https://materialdesignicons.com/) icons in the `content` of the card.
|
||||
You can use [Material Design Icons](https://pictogrammers.com/library/mdi/) icons in the `content` of the card.
|
||||
|
||||
For example:
|
||||
|
||||
|
@ -32,7 +32,7 @@ entity_picture:
|
||||
required: false
|
||||
type: string
|
||||
icon:
|
||||
description: "Any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix name with `mdi:`, ie `mdi:home`. Note: Newer icons may not yet be available in the current Home Assistant release. You can check when an icon was added to MaterialDesignIcons.com at [MDI History](https://materialdesignicons.com/history)."
|
||||
description: "Any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix name with `mdi:`, ie `mdi:home`. Note: Newer icons may not yet be available in the current Home Assistant release."
|
||||
required: false
|
||||
type: string
|
||||
assumed_state:
|
||||
|
@ -18,7 +18,7 @@ The frontend is built with [Polymer](https://www.polymer-project.org/).
|
||||
|
||||
## Icons
|
||||
|
||||
Home Assistant utilizes the community-driven [Material Design Icons](https://www.materialdesignicons.com/) project for icons in the frontend. The [Icons section](/docs/frontend/icons/) has more information on how to use icons and suggest new ones.
|
||||
Home Assistant utilizes the community-driven [Material Design Icons](https://pictogrammers.com/library/mdi/) project for icons in the frontend. The [Icons section](/docs/frontend/icons/) has more information on how to use icons and suggest new ones.
|
||||
|
||||
## Examples
|
||||
|
||||
|
@ -7,7 +7,7 @@ description: "Material Design Icons in the Home Assistant frontend"
|
||||
<img src='/images/frontend/mdi.png' alt='Material Design Icons' />
|
||||
</p>
|
||||
|
||||
Home Assistant utilizes the community-driven [Material Design Icons](https://www.materialdesignicons.com/) (MDI) project for icons in the frontend. The icon library is a superset of the base icon library provided by Google and contains thousands of community-made icons for very specific applications, industries, and use-cases.
|
||||
Home Assistant utilizes the community-driven [Material Design Icons](https://pictogrammers.com/library/mdi/) (MDI) project for icons in the frontend. The icon library is a superset of the base icon library provided by Google and contains thousands of community-made icons for very specific applications, industries, and use-cases.
|
||||
|
||||
## Default Icons
|
||||
|
||||
@ -43,23 +43,23 @@ The easiest way to browse and find icons outside of Home Assistant is with the o
|
||||
|
||||
</div>
|
||||
|
||||
### MaterialDesignIcons.com
|
||||
### Material Design Icons on the Pictogrammers Website
|
||||
|
||||
The last way to browse through available icons is on the official website, [MaterialDesignIcons.com](https://materialdesignicons.com).
|
||||
The last way to browse through available icons is by viewing the library on the Pictogrammers website, [https://pictogrammers.com/library/mdi/](https://pictogrammers.com/library/mdi/). Select an icon you'd like to use, then click "Home Assistant" to see an example of its usage.
|
||||
|
||||
<div class='note info'>
|
||||
|
||||
The official MDI website is updated in real-time as new icons are added. This means an icon you find there may not yet be released or available in Home Assistant (yet!) for several releases. You can check when an icon was added by viewing the [MDI history](https://materialdesignicons.com/history).
|
||||
The Pictogrammers website will always show the latest release of the Material Design Icons library. However, you may find icons that may not yet be available in Home Assistant (yet!). Watch the Home Assistant release notes for announcements on upgrades of the Material Design Icons library.
|
||||
|
||||
</div>
|
||||
|
||||
## Suggesting or Contributing New Icons
|
||||
|
||||
Being open-source like Home Assistant, the Material Design Icons project is always accepting suggestions and contributions to expand the library.
|
||||
Being open-source like Home Assistant, the Material Design Icons library is always accepting suggestions and contributions to expand the library.
|
||||
|
||||
<div class='note info'>
|
||||
|
||||
Before suggesting or creating a new icon, it is very important that you [search the current library](https://materialdesignicons.com) and [search all issues](https://github.com/Templarian/MaterialDesign/issues?q=is%3Aissue), open and closed, on their GitHub. Try searching with different terms that might mean the same thing. (e.g. "user", "person", "account")
|
||||
Before suggesting or creating a new icon, it is very important that you [search the current library](https://pictogrammers.com/library/mdi/) and [search all issues](https://github.com/Templarian/MaterialDesign/issues?q=is%3Aissue), open and closed, on their GitHub. Try searching with different terms that might mean the same thing. (e.g. "user", "person", "account")
|
||||
|
||||
</div>
|
||||
|
||||
@ -69,16 +69,16 @@ If you have an idea for an icon that isn't currently in the library, but are not
|
||||
|
||||
### Contributing a New Icon
|
||||
|
||||
If you want to contribute a new icon to the library, familiarize yourself with the [System icons guidelines](https://material.io/design/iconography/system-icons.html#design-principles) in the Material Design system. Then create your icon and [submit it to the MDI team for review](https://github.com/Templarian/MaterialDesign/issues/new?assignees=&labels=Icon+Request%2CContribution&template=2_contribution.yml).
|
||||
If you want to contribute a new icon to the library, familiarize yourself with the [System icons guidelines](https://material.io/design/iconography/system-icons.html#design-principles) in the Material Design system. Then create your icon and [submit it to the Pictogrammers team for review](https://github.com/Templarian/MaterialDesign/issues/new?assignees=&labels=Icon+Request%2CContribution&template=2_contribution.yml).
|
||||
|
||||
#### Tips for Creating New Icons
|
||||
|
||||
- Really pay attention to [Material Design guidelines](https://material.io/design/iconography/system-icons.html#design-principles).
|
||||
- Keep in mind that icons are meant to be contextual, not literal.
|
||||
- When it comes to little details, less is more.
|
||||
- If you're unsure, open an issue with MDI. They're more than happy to help you!
|
||||
- If you're unsure, open an issue on their GitHub. They're more than happy to help you!
|
||||
- Not all icons make it into the library and that is okay!
|
||||
|
||||
### Suggesting an Icon Alias
|
||||
|
||||
Sometimes an icon exists, but you aren't able to find it with the terms you were searching for. If this has ever happened to you, please [open an issue with the MDI team to suggest new aliases](https://github.com/Templarian/MaterialDesign/issues/new?assignees=&labels=Alias&template=4_alias.yml) that can be added to existing icons.
|
||||
Sometimes an icon exists, but you aren't able to find it with the terms you were searching for. If this has ever happened to you, please [open an issue with the Pictogrammers team to suggest new aliases](https://github.com/Templarian/MaterialDesign/issues/new?assignees=&labels=Alias&template=4_alias.yml) that can be added to existing icons.
|
||||
|
@ -75,7 +75,7 @@ counter:
|
||||
type: icon
|
||||
{% endconfiguration %}
|
||||
|
||||
Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance` or `mdi:motorbike`.
|
||||
Pick an icon that from [Material Design Icons](https://pictogrammers.com/library/mdi/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance` or `mdi:motorbike`.
|
||||
|
||||
### Restore State
|
||||
|
||||
|
@ -43,7 +43,7 @@ sidebar_title:
|
||||
required: false
|
||||
type: string
|
||||
sidebar_icon:
|
||||
description: Icon for entry. Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or `mdi:motorbike`.
|
||||
description: Icon for entry. Pick an icon that from [Material Design Icons](https://pictogrammers.com/library/mdi/) to use for your input and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or `mdi:motorbike`.
|
||||
required: false
|
||||
default: "mdi:bookmark"
|
||||
type: icon
|
||||
|
@ -60,7 +60,7 @@ timer:
|
||||
default: false
|
||||
{% endconfiguration %}
|
||||
|
||||
Pick an icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) to use for your timer and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or `mdi:motorbike`.
|
||||
Pick an icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) to use for your timer and prefix the name with `mdi:`. For example `mdi:car`, `mdi:ambulance`, or `mdi:motorbike`.
|
||||
|
||||
## Possible States
|
||||
|
||||
|
@ -17,7 +17,7 @@ Home Assistant currently supports free web services some of which require regist
|
||||
|
||||
## Condition mapping
|
||||
|
||||
The `weather` platform only knows the below listed conditions. The reason for this is that for these conditions is an icon from [Material Design Icons](https://materialdesignicons.com/) available and mapped in the frontend.
|
||||
The `weather` platform only knows the below listed conditions. The reason for this is that for these conditions is an icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) available and mapped in the frontend.
|
||||
|
||||
- 'clear-night'
|
||||
- 'cloudy'
|
||||
|
@ -86,7 +86,7 @@ Devices that are in the zone **'Home'** will not appear on the map in the Home A
|
||||
|
||||
## Icons
|
||||
|
||||
It is recommended that you pick an icon to use for your zone. Pick any icon that you can find on [materialdesignicons.com](https://materialdesignicons.com/) and prefix the name with `mdi:`. For example `mdi:school`, `mdi:briefcase`, `mdi:home`, `mdi:cart`, or `mdi:castle`.
|
||||
It is recommended that you pick an icon to use for your zone. Pick any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/) and prefix the name with `mdi:`. For example `mdi:school`, `mdi:briefcase`, `mdi:home`, `mdi:cart`, or `mdi:castle`.
|
||||
|
||||
## State
|
||||
|
||||
|
@ -10,7 +10,7 @@ categories:
|
||||
- Core
|
||||
---
|
||||
|
||||
<img src='/images/screenshots/custom-icons.png' style='float: right;' />We have all been hard at work to get this latest release ready. One of the big highlights in this release is the introduction of an extended iconset to be used in the frontend (credits to [@happyleavesaoc] for idea and prototype). To get started with customizing, pick any icon from [MaterialDesignIcons.com], prefix the name with `mdi:` and stick it into your `customize` section in `configuration.yaml`:
|
||||
<img src='/images/screenshots/custom-icons.png' style='float: right;' />We have all been hard at work to get this latest release ready. One of the big highlights in this release is the introduction of an extended iconset to be used in the frontend (credits to [@happyleavesaoc] for idea and prototype). To get started with customizing, pick any icon from [Material Design Icons], prefix the name with `mdi:` and stick it into your `customize` section in `configuration.yaml`:
|
||||
|
||||
```yaml
|
||||
homeassistant:
|
||||
@ -21,7 +21,7 @@ homeassistant:
|
||||
|
||||
#### Breaking changes
|
||||
|
||||
- Any existing zone icon will have to be replaced with one from [MaterialDesignIcons.com].
|
||||
- Any existing zone icon will have to be replaced with one from [Material Design Icons].
|
||||
- LimitlessLED light services require colors to be specified in RGB instead of XY.
|
||||
|
||||
#### Changes
|
||||
@ -43,7 +43,7 @@ homeassistant:
|
||||
* Switch RGB as the color unit used in light component ([@balloob])
|
||||
* Re-install platform and component dependencies after a Home Assistant version upgrade ([@balloob])
|
||||
|
||||
[MaterialDesignIcons.com]: https://MaterialDesignIcons.com
|
||||
[Material Design Icons]: https://pictogrammers.com/library/mdi/
|
||||
[@sander76]: https://github.com/sander76
|
||||
[@happyleavesaoc]: https://github.com/happyleavesaoc
|
||||
[@ryanturner]: https://github.com/ryanturner
|
||||
|
@ -21,7 +21,7 @@ Also want to take a moment to thank Austin Andrews aka [Templarian] for his [Mat
|
||||
|
||||
[hass-fb]: https://www.facebook.com/homeassistantio
|
||||
[diyAutomate]: https://www.youtube.com/c/diyautomate
|
||||
[mli]: https://materialdesignicons.com/
|
||||
[mli]: https://pictogrammers.com/library/mdi/
|
||||
[Templarian]: https://github.com/templarian
|
||||
|
||||
## New integrations
|
||||
|
@ -23,7 +23,7 @@ This release also includes a UI to manage the entity registry. The entity regist
|
||||
|
||||
We didn't forget about the frontend in this release. In the last release we introduced Lovelace, so for this release we focused on bug squashing, performance improvements and usability. The YAML editor is now rendered using a full editor including line numbers thanks to [@bramkragten]. There is also a new system health component that will help users diagnose problems from the "info" developer tool. [See changelog for the frontend.](https://github.com/home-assistant/home-assistant-polymer/releases/tag/20190130.1)
|
||||
|
||||
In this release we have also upgraded the Material Design Icons to 3.3.92, which renames some icons. Make sure to check [their changelog](https://dev.materialdesignicons.com/upgrade).
|
||||
In this release we have also upgraded the Material Design Icons to 3.3.92, which renames some icons. Make sure to check [their changelog](https://pictogrammers.com/docs/library/mdi/releases/changelog/).
|
||||
|
||||
If you prefer a podcast over release notes, check out [the Hass Podcast](https://hasspodcast.io/ha043/) in which Phil and Rohan discuss each new Home Assistant release and keep a tap on what's happening in the home automation space.
|
||||
|
||||
|
@ -351,8 +351,8 @@ Please note: It is possible that custom integrations (also known as
|
||||
custom components) use deprecated icons. These can throw warnings that need
|
||||
to be addressed in the custom integration.
|
||||
|
||||
[mdi]: https://materialdesignicons.com
|
||||
[mdi-upgrade]: https://dev.materialdesignicons.com/upgrade#4.9.95-to-5.0.45
|
||||
[mdi]: https://pictogrammers.com/library/mdi/
|
||||
[mdi-upgrade]: https://pictogrammers.com/docs/library/mdi/releases/upgrade/#4995-to-5045
|
||||
[simple-icons]: https://simpleicons.org/
|
||||
[hass-simpleicons]: https://github.com/vigonotion/hass-simpleicons
|
||||
|
||||
|
@ -814,7 +814,7 @@ Drag and and drop the entities in the order you want.
|
||||
|
||||
- The [Met.no](/integrations/met) now supports hourly forecasts, very nice [@bruxy70]!
|
||||
|
||||
- The MDI icons are updated to version [5.5.55](https://dev.materialdesignicons.com/changelog#version-5.5.55),
|
||||
- The MDI icons are updated to version [5.5.55](https://pictogrammers.com/docs/library/mdi/releases/changelog/#version-5555),
|
||||
this adds another 100 icons you can use!
|
||||
|
||||
- The Google Assistant integration got some updates:
|
||||
@ -1309,7 +1309,7 @@ corner of the Lovelace screen.
|
||||
<summary><b>MDI Icons</b></summary>
|
||||
<p>
|
||||
|
||||
The MDI icons are updated to version [5.5.55](https://dev.materialdesignicons.com/changelog#version-5.5.55),
|
||||
The MDI icons are updated to version [5.5.55](https://pictogrammers.com/docs/library/mdi/releases/changelog/#version-5555),
|
||||
this adds another 100 icons you can use!
|
||||
|
||||
In 5.5.55 there was 1 breaking change, if you used the icon `mdi:scooter` this
|
||||
@ -1318,7 +1318,7 @@ configuration.
|
||||
|
||||
All icons that were deprecated in [0.113.0](/blog/2020/07/22/release-113/#mdi-icons-updated)
|
||||
have now been removed. Icons that were renamed or deleted in
|
||||
version [5.0.45](https://dev.materialdesignicons.com/upgrade#4.9.95-to-5.0.45)
|
||||
version [5.0.45](https://pictogrammers.com/docs/library/mdi/releases/upgrade/#4995-to-5045)
|
||||
will no longer work.
|
||||
|
||||
</p>
|
||||
|
@ -162,7 +162,7 @@ they will keep working for the upcoming two releases. Home Assistant will
|
||||
write warnings in the logs in case you are using one of the affected icons.
|
||||
The breaking changes section has more information about this.
|
||||
|
||||
[mdi]: https://materialdesignicons.com/
|
||||
[mdi]: https://pictogrammers.com/library/mdi/
|
||||
|
||||
## Encrypted communications support for ESPHome
|
||||
|
||||
|
@ -185,7 +185,7 @@ Adding nice and matching icons to your entities, makes all the difference for
|
||||
how your Home Assistant interface looks and feels.
|
||||
|
||||
Finding those icons was somewhat clumsy. You'd go to the
|
||||
[Material Design Icons](https://materialdesignicons.com/) website to find one,
|
||||
[Material Design Icons](https://pictogrammers.com/library/mdi/) website to find one,
|
||||
remember its code and add the `mdi:<code>` to your entity. Not a great
|
||||
experience, especially with the number of icons available your browser doesn't
|
||||
always like that website.
|
||||
|
@ -495,7 +495,7 @@ noteworthy changes this release:
|
||||
[Hue]: /integrations/hue
|
||||
[Linn / OpenHome]: /integrations/linn
|
||||
[Logitech Squeezebox]: /integrations/squeezebox
|
||||
[Material Design Icons]: https://materialdesignicons.com/
|
||||
[Material Design Icons]: https://pictogrammers.com/library/mdi/
|
||||
[Music Player Daemon (MPD)]: /integrations/mpd
|
||||
[Panasonic Viera]: /integrations/panasonic_viera
|
||||
[RFXCOM RFXtrx]: /integrations/rfxtrx
|
||||
|
@ -784,7 +784,7 @@ to handle the extra decimal places.
|
||||
{% details "Material Design Icons" %}
|
||||
|
||||
In the latest Material Design Icons update,
|
||||
[several icons have been renamed or removed](https://dev.materialdesignicons.com/changelog#version-7.0.96).
|
||||
[several icons have been renamed or removed](https://pictogrammers.com/docs/library/mdi/releases/changelog/#version-7096).
|
||||
Removed and renamed icons will continue to work for the next two releases.
|
||||
|
||||
Please make sure you update any use of the following MDI icons:
|
||||
|
@ -30,7 +30,7 @@ name:
|
||||
default: Name of entity
|
||||
icon:
|
||||
required: false
|
||||
description: Overwrites icon or entity picture. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`.
|
||||
description: Overwrites icon or entity picture. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`.
|
||||
type: string
|
||||
default: Entity domain icon
|
||||
image:
|
||||
@ -87,7 +87,7 @@ name:
|
||||
type: string
|
||||
icon:
|
||||
required: false
|
||||
description: Overwrites icon or entity picture. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`.
|
||||
description: Overwrites icon or entity picture. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`.
|
||||
type: string
|
||||
image:
|
||||
required: false
|
||||
|
@ -110,7 +110,7 @@ dashboards:
|
||||
type: string
|
||||
icon:
|
||||
required: false
|
||||
description: The icon to show in the sidebar. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`.
|
||||
description: The icon to show in the sidebar. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`.
|
||||
type: string
|
||||
show_in_sidebar:
|
||||
required: false
|
||||
|
@ -69,7 +69,7 @@ entities:
|
||||
type: string
|
||||
icon:
|
||||
required: false
|
||||
description: Override the entity icon. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`.
|
||||
description: Override the entity icon. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`.
|
||||
type: string
|
||||
image:
|
||||
required: false
|
||||
|
@ -29,4 +29,4 @@ To try it yourself, check out [the demo](https://demo.home-assistant.io).
|
||||
|
||||
- [Community Custom Cards](https://github.com/custom-cards)
|
||||
- [Home Assistant Cards](https://home-assistant-cards.bessarabov.com/)
|
||||
- [Material Design Icons](https://materialdesignicons.com/tag/community)
|
||||
- [Material Design Icons](https://pictogrammers.com/library/mdi/)
|
||||
|
@ -181,7 +181,7 @@ views:
|
||||
default: view index
|
||||
icon:
|
||||
required: false
|
||||
description: Icon-name from Material Design Icons. You can use any icon from [MaterialDesignIcons.com](https://materialdesignicons.com). Prefix the icon name with `mdi:`, ie `mdi:home`. Only for "View", not for "Subview".
|
||||
description: Icon-name from Material Design Icons. You can use any icon from [Material Design Icons](https://pictogrammers.com/library/mdi/). Prefix the icon name with `mdi:`, ie `mdi:home`. Only for "View", not for "Subview".
|
||||
type: string
|
||||
background:
|
||||
required: false
|
||||
|
Loading…
x
Reference in New Issue
Block a user