Skip to content

Commit f91f9d1

Browse files
committed
Fix formatting
1 parent fe12548 commit f91f9d1

20 files changed

Lines changed: 421 additions & 268 deletions

File tree

.design/ruby-community-guides/DESIGN_TOKENS.md

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -20,21 +20,26 @@
2020

2121
## Colors
2222

23-
| Token | Light | Dark | Use |
24-
| ------------------------- | -------------------------- | ------------------------ | ------------------------------------------------------ |
25-
| `--color-bg` | warm-50 (linen near-white) | warm-900 (warm charcoal) | Page background |
26-
| `--color-text` | warm-900 | warm-50 | Body text |
27-
| `--color-text-secondary` | warm-600 | warm-300 | Captions, secondary prose |
28-
| `--color-link` | warm-850 | warm-200 | Default link — near-black |
29-
| `--color-link-hover` | ruby-500 (#DC143C) | ruby-300 | Hover — crimson appears |
30-
| `--color-accent` | ruby-500 | ruby-300 | Nav title, strong emphasis |
31-
| `--color-quote-border` | ruby-500 | ruby-400 | Interview quote left border |
32-
| `--color-quote-bg` | warm-100 | warm-850 | Interview quote background |
33-
| `--color-toc-text` | warm-500 | warm-400 | TOC chapter links |
34-
| `--color-toc-text-active` | warm-900 | warm-50 | Active/current chapter |
35-
| `--color-toc-marker` | ruby-500 | ruby-400 | Active chapter indicator |
36-
| `--color-tip-ideas-*` | sky family | sky family | Idea callouts; RubyEvents accent, open and exploratory |
37-
| `--color-tip-tools-*` | steel family | steel family | Tool callouts; pragmatic utility |
23+
| Token | Light | Dark | Use |
24+
| ------------------------- | -------------------------- | ------------------------ | --------------------------- |
25+
| `--color-bg` | warm-50 (linen near-white) | warm-900 (warm charcoal) | Page background |
26+
| `--color-text` | warm-900 | warm-50 | Body text |
27+
| `--color-text-secondary` | warm-600 | warm-300 | Captions, secondary prose |
28+
| `--color-link` | warm-850 | warm-200 | Default link — near-black |
29+
| `--color-link-hover` | ruby-500 (#DC143C) | ruby-300 | Hover — crimson appears |
30+
| `--color-accent` | ruby-500 | ruby-300 | Nav title, strong emphasis |
31+
| `--color-quote-border` | ruby-500 | ruby-400 | Interview quote left border |
32+
| `--color-quote-bg` | warm-100 | warm-850 | Interview quote background |
33+
| `--color-toc-text` | warm-500 | warm-400 | TOC chapter links |
34+
| `--color-toc-text-active` | warm-900 | warm-50 | Active/current chapter |
35+
| `--color-toc-marker` | ruby-500 | ruby-400 | Active chapter indicator |
36+
37+
Tip callouts ("field notes") carry no dedicated colour tokens. They are
38+
unfilled, ruled asides led by an uppercase rubric, reusing the warm + ruby
39+
system: the `Ideas` rubric uses `--color-accent` (ruby); the `Tools` rubric
40+
uses `--color-text-secondary` (neutral). Body copy is `--color-text`. This
41+
keeps them in the page's two-temperature palette instead of introducing a cold
42+
admonition box.
3843

3944
## Spacing
4045

.github/workflows/jekyll.yml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ jobs:
2323
- name: Setup Ruby
2424
uses: ruby/setup-ruby@v1
2525
with:
26-
ruby-version: "4.0.4"
2726
bundler-cache: true
2827
- name: Setup Pages
2928
id: pages

.mise.toml

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
[tools]
2-
# Picked up from .ruby-version
2+
# Picked up from .ruby-version and .node-version
33

44
[settings]
55
experimental = true
6+
7+
[hooks]
8+
# Installs the pnpm version specified in package.json's packageManager field
9+
postinstall = "npx corepack enable"

.node-version

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
24.16.0

.prettierrc

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"plugins": ["@shopify/prettier-plugin-liquid"],
3+
"overrides": [
4+
{
5+
"files": "*.html",
6+
"options": { "parser": "liquid-html" }
7+
}
8+
]
9+
}

_includes/contribute-aside.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@
1313
<div class="contribute__body">
1414
<p class="contribute__title">Work in progress</p>
1515
<p class="contribute__text">
16-
Still being written and refined. If you have organizing experience to
17-
share — or a question you wish they answered — help shape what comes next.
16+
Still being written and refined. If you have organizing experience to share — or a question you wish they answered
17+
— help shape what comes next.
1818
</p>
1919
<a class="contribute__cta" href="https://github.com/{{ site.github_repo }}">
2020
<svg

_includes/disclosure.html

Lines changed: 19 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,23 @@
11
{%- comment -%}
2-
Renders a native disclosure widget with Markdown-formatted content.
3-
4-
Parameters:
5-
summary – summary text shown as the disclosure trigger (optional, default: "Show details")
6-
content – Markdown-formatted body copy (required; supports captured multi-line strings)
7-
open – render expanded by default when true (optional)
2+
Renders a native disclosure widget with Markdown-formatted
3+
content. Parameters: summary – summary text shown as the disclosure trigger
4+
(optional, default: "Show details") content – Markdown-formatted body copy
5+
(required; supports captured multi-line strings) open – render expanded by
6+
default when true (optional)
87
{%- endcomment -%}
9-
{%- assign disclosure_summary = include.summary | default: "Show details" -%}
10-
{%- assign disclosure_content = include.content | default: "" -%}
8+
{%- assign disclosure_summary = include.summary | default: 'Show details' -%}
9+
{%- assign disclosure_content = include.content | default: '' -%}
1110

12-
<details{% if include.open %} open{% endif %}>
13-
<summary>{{ disclosure_summary | markdownify | remove: "<p>" | remove: "</p>" | strip }}</summary>
14-
<div>
15-
{{ disclosure_content | markdownify }}
16-
</div>
11+
<details
12+
class="disclosure"
13+
{% if include.open %}
14+
open
15+
{% endif %}
16+
>
17+
<summary class="disclosure__summary">
18+
{{ disclosure_summary | markdownify | remove: '
19+
<p>' | remove: '</p>
20+
' | strip }}
21+
</summary>
22+
<div class="disclosure__body">{{ disclosure_content | markdownify }}</div>
1723
</details>

_includes/testimonial.html

Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,14 @@
1-
{%- comment -%} Renders an organizer testimonial. Parameters: name – voice name
2-
from _data/voices.yml (required) content – testimonial text (required) {%-
3-
endcomment -%} {%- assign matching_voices = site.data.voices | where: "name",
4-
include.name -%} {%- assign voice = matching_voices | first -%} {%- assign
5-
quote_content = include.content | default: include.quote -%} {%- assign
6-
conference = voice.conference | default: include.conference -%} {%- assign
7-
avatar = voice.image | default: include.avatar -%} {%- assign initials =
8-
voice.initials | default: include.initials -%}
1+
{%- comment -%}
2+
Renders an organizer testimonial. Parameters: name – voice name
3+
from _data/voices.yml
4+
(required) content – testimonial text (required)
5+
{%- endcomment -%}
6+
{%- assign matching_voices = site.data.voices | where: 'name', include.name -%}
7+
{%- assign voice = matching_voices | first -%}
8+
{%- assign quote_content = include.content | default: include.quote -%}
9+
{%- assign conference = voice.conference | default: include.conference -%}
10+
{%- assign avatar = voice.image | default: include.avatar -%}
11+
{%- assign initials = voice.initials | default: include.initials -%}
912

1013
<figure
1114
class="testimonial{% if include.class %} {{ include.class }}{% endif %}"
@@ -16,26 +19,27 @@
1619

1720
<figcaption class="testimonial__person">
1821
{% if avatar %}
19-
<img
20-
class="testimonial__avatar"
21-
src="{{ avatar | relative_url }}"
22-
alt=""
23-
width="32"
24-
height="32"
25-
loading="lazy"
26-
/>
22+
<img
23+
class="testimonial__avatar"
24+
src="{{ avatar | relative_url }}"
25+
alt=""
26+
width="32"
27+
height="32"
28+
loading="lazy"
29+
>
2730
{% elsif initials %}
28-
<span
29-
class="testimonial__avatar testimonial__avatar--initials"
30-
aria-hidden="true"
31-
>{{ initials }}</span
32-
>
31+
<span
32+
class="testimonial__avatar testimonial__avatar--initials"
33+
aria-hidden="true"
34+
>
35+
{{- initials -}}
36+
</span>
3337
{% endif %}
3438

3539
<span class="testimonial__byline">
3640
<span class="testimonial__name">{{ include.name }}</span>
3741
{% if conference %}
38-
<span class="testimonial__conference">{{ conference }}</span>
42+
<span class="testimonial__conference">{{ conference }}</span>
3943
{% endif %}
4044
</span>
4145
</figcaption>

_includes/tip.html

Lines changed: 32 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,39 @@
11
{%- comment -%}
2-
Renders an inline tip callout.
3-
4-
Parameters:
5-
type – visual style: "tool(s)" or "idea(s)" (optional, default: "ideas")
6-
description – Markdown-formatted body copy (required; supports captured multi-line strings)
2+
Renders an inline "field note" tip callout: an unfilled, ruled
3+
aside led by an uppercase rubric, in the warm editorial system (no boxed
4+
admonition). Parameters: type – rubric: "tools" or "ideas" (optional, default:
5+
"ideas") label – override the rubric label text (optional) description –
6+
Markdown body copy (required; supports captured multi-line strings)
77
{%- endcomment -%}
8-
{%- assign tip_type = include.type | default: "ideas" -%}
9-
{%- assign tip_description = include.description | default: "" -%}
8+
{%- assign tip_type = include.type | default: 'ideas' -%}
9+
{%- assign tip_description = include.description | default: '' -%}
10+
{%- case tip_type -%}
11+
{%- when 'tools', 'tool' -%}
12+
{%- assign tip_label = 'Tools' -%}
13+
{%- else -%}
14+
{%- assign tip_label = 'Ideas' -%}
15+
{%- endcase -%}
16+
{%- assign tip_label = include.label | default: tip_label -%}
1017

1118
<div class="tip tip--{{ tip_type | slugify }}">
12-
<div class="tip__icon" aria-hidden="true">
13-
<svg viewBox="0 0 24 24" focusable="false">
14-
{%- case tip_type -%}
15-
{%- when "tools", "tool" -%}
16-
<path d="M20.5 6.5 17 10l-3-3 3.5-3.5a5.5 5.5 0 0 0-6.9 6.9l-7.2 7.2a2.1 2.1 0 1 0 3 3l7.2-7.2a5.5 5.5 0 0 0 6.9-6.9Z" />
17-
{%- when "ideas", "idea" -%}
18-
<path d="M9 18h6" />
19-
<path d="M10 22h4" />
20-
<path d="M8.6 14.7a6 6 0 1 1 6.8 0c-.8.5-1.4 1.4-1.4 2.3h-4c0-.9-.6-1.8-1.4-2.3Z" />
19+
<p class="tip__head">
20+
<span class="tip__icon" aria-hidden="true">
21+
<svg viewBox="0 0 24 24" focusable="false">
22+
{%- case tip_type -%} {%- when "tools", "tool" -%}
23+
<path
24+
d="M20.5 6.5 17 10l-3-3 3.5-3.5a5.5 5.5 0 0 0-6.9 6.9l-7.2 7.2a2.1 2.1 0 1 0 3 3l7.2-7.2a5.5 5.5 0 0 0 6.9-6.9Z"
25+
/>
2126
{%- else -%}
22-
<path d="M9 18h6" />
23-
<path d="M10 22h4" />
24-
<path d="M8.6 14.7a6 6 0 1 1 6.8 0c-.8.5-1.4 1.4-1.4 2.3h-4c0-.9-.6-1.8-1.4-2.3Z" />
25-
{%- endcase -%}
26-
</svg>
27-
</div>
27+
<path d="M9 18h6" />
28+
<path d="M10 22h4" />
29+
<path
30+
d="M8.6 14.7a6 6 0 1 1 6.8 0c-.8.5-1.4 1.4-1.4 2.3h-4c0-.9-.6-1.8-1.4-2.3Z"
31+
/>
32+
{%- endcase -%}
33+
</svg>
34+
</span>
35+
<span class="tip__label">{{ tip_label }}</span>
36+
</p>
2837

29-
<div class="tip__description">
30-
{{ tip_description | markdownify }}
31-
</div>
38+
<div class="tip__description">{{ tip_description | markdownify }}</div>
3239
</div>

_includes/toc.html

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,13 @@
55
variant - additional toc modifier class, e.g. "toc--mobile" (optional)
66
heading - visible heading text (optional)
77
{%- endcomment -%}
8-
{%- assign toc_class = "toc" -%}
8+
{%- assign toc_class = 'toc' -%}
99
{%- if include.variant -%}
10-
{%- assign toc_class = toc_class | append: " " | append: include.variant -%}
10+
{%- assign toc_class = toc_class | append: ' ' | append: include.variant -%}
1111
{%- endif -%}
1212
<nav class="{{ toc_class }}" aria-label="Guide contents">
1313
{%- if include.heading -%}
14-
<p class="toc__heading">{{ include.heading }}</p>
15-
{%- endif -%}<!--toc-->
14+
<p class="toc__heading">{{ include.heading }}</p>
15+
{%- endif -%}
16+
<!-- toc -->
1617
</nav>

0 commit comments

Comments
 (0)