diff --git a/docs/assets/apollo-dog-annotation-color.png b/docs/assets/apollo-dog-annotation-color.png new file mode 100644 index 0000000000..3ccee941de Binary files /dev/null and b/docs/assets/apollo-dog-annotation-color.png differ diff --git a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md index 3d18be4454..c8a2964e47 100755 --- a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md +++ b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md @@ -10,15 +10,15 @@ By the end you'll have your ESPHome Starter Kit flashed with a working configura [:material-cart: Buy the ESPHome Starter Kit](https://apolloautomation.com/products/esk-1-esphome-starter-kit){ .md-button .md-button--primary } -!!! tip "Click the (+) for extra context" +!!! tip "Click the Apollo dog for extra context"
- When you see a small **(+)** icon next to a step or word, give it a click (1). It opens a side note with tips, gotchas, or examples you don't need on first read. + When you see a small Apollo dog peeking over a step or word, give it a click (1). It opens a side note with tips, gotchas, or examples you don't need on first read.
- 1. Like this, you just opened your first annotation. Click outside the box to close it. + 1. Like this, you just opened your first annotation. Click outside the box to close it. Good dog. --- diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css index 4f21a799b7..9378a8ab16 100755 --- a/docs/stylesheets/extra.css +++ b/docs/stylesheets/extra.css @@ -234,3 +234,42 @@ article.md-typeset .md-button img { font-weight: 600; margin-bottom: 7px; } + +/* ===== Code annotation marker: full-color Apollo dog instead of the default (+) ===== */ +/* The theme draws the marker as a single-color CSS mask; drop the mask and + draw the colored image directly. Anchored to the bottom of the line so the + dog peeks over the text like the logo. */ +.md-annotation__index { + width: 3ch; + overflow: visible; +} +.md-annotation__index::before { + display: none; /* the theme's page-color backdrop circle behind the (+) */ +} +.md-annotation__index::after { + -webkit-mask-image: none; + mask-image: none; + background: url("/assets/apollo-dog-annotation-color.png") center bottom / contain no-repeat; + width: 3ch; + height: 3.2ch; + top: auto; + bottom: -0.15ch; + transform-origin: bottom center; +} +/* Code lines are tighter than prose; cap the dog a bit shorter there so the + ears don't cover characters on the line above. */ +code .md-annotation__index { + width: 2.6ch; +} +code .md-annotation__index::after { + height: 2.6ch; + bottom: -0.2ch; +} +/* The theme tints the marker on hover/open and rotates it 45deg while open; + keep the image untinted and upright, and grow it a little instead so it + still reacts to the pointer. */ +:hover > .md-annotation__index::after, +.md-tooltip--active + .md-annotation__index::after { + background-color: transparent; + transform: scale(1.2); +}