yambar-decorations(5)

💅 yambar-decorations — bestie edition 💅

okay so this is the yambar-decorations(5) page from the File Formats Manual — section 5, file formats, the whole vibe. stick around, we're about to make your particles cute 🎀

---

✨ NAME ✨

yambar-decorations — the configuration file stuff. literally all about decorating your particles 💖

---

🌸 DESCRIPTION 🌸

bestie. decorations are these optional little additions you can slap onto particles, and they're giving main character energy. think: changing the background color of the entire particle, drawing an underline, and so on. iconic behavior 🦋

and the detail that matters: decorations are applied to the particle's margins too. no cap, the margins are included 🫶

every single decoration defines its own configuration attributes — there are no common attributes. so like, don't go looking for shared options, they do not exist 🙈

---

🌈 BACKGROUND 🌈

this decoration sets the particle's background color. that's the whole thing. simple, effective, slays 💅

🎀 CONFIGURATION 🎀

• color — type color, required (yes). the background color. see yambar(5) for the format ⭐

🍓 EXAMPLES 🍓

content:
  string:
    deco:
      background:
        color: 00ff00ff

---

💜 UNDERLINE 💜

this one renders a line of configurable size and color at the bottom of the particle. yes, we're putting a little underline moment under your content 😭🔥

🎀 CONFIGURATION 🎀

• size — type int, required (yes). the size (height/thickness) of the line, in pixels 📏
• color — type color, required (yes). the color of the line. see yambar(5) for the format ⭐

🍓 EXAMPLES 🍓

content:
  string:
    deco:
      underline:
        size: 2
        color: ff0000ff

---

🦋 OVERLINE 🦋

similar to underline — literally — except this decoration renders a line of configurable size and color at the top of the particle. it's the underline's sibling and honestly? both ate ✨

🎀 CONFIGURATION 🎀

• size — type int, required (yes). the size (height/thickness) of the line, in pixels 📏
• color — type color, required (yes). the color of the line. see yambar(5) for the format ⭐

🍓 EXAMPLES 🍓

content:
  string:
    deco:
      overline:
        size: 2
        color: ff0000ff

---

👑 BORDER 👑

this decoration renders a border of configurable size (i.e. border width) around the particle. full frame, full aesthetics, we love a contained queen 💅

🎀 CONFIGURATION 🎀

• color — type color, required (yes). the color of the line. see yambar(5) for the format ⭐
• size — type int, required (no — it's optional bestie!). border width, in pixels. defaults to 1px 📏

🍓 EXAMPLES 🍓

content:
  string:
    deco:
      border:
        size: 2
        color: ff0000ff

---

🧚 STACK 🧚

this one combines multiple decorations. yes, you can stack them. we love a layered look 🌸

🎀 CONFIGURATION 🎀

no configuration attributes available 😌 the stack is just a list of the decorations that should be combined. that's it, that's the whole rule 🫶

🍓 EXAMPLES 🍓

content:
  string:
    deco:
      stack:
        - background: ...
        - underline: ...

---

⭐ SEE ALSO ⭐

• yambar-particles(5) — go read it, iykyk 💖

---

ok that's the whole page bestie, every attribute accounted for, nothing skipped, no cap 💯

and that's a wrap cutie 🎀 this was yambar-decorations(5), dated 2024-04-22 — go decorate something iconic 🌈💜💅