Skip to main content

Topic Cards & Reference Sheets

Topic Cards (Explore Topics)​

Location​

  • GP Element: ID 4091 — ID86 Niche Cards
  • Display: general:front_page
  • CSS: .id86-niche-grid (4-column CSS grid)

HTML​

<section class="id86-section id86-niche-cards">
<div class="id86-shell">
<div class="id86-section-heading">
<h2>Explore topics</h2>
</div>
<div class="id86-niche-grid">
<a class="id86-niche-card id86-code" href="/category/code/">
<h3>Code</h3>
<p>Languages, tools, and everyday development patterns.</p>
</a>
<!-- ... DevOps, AI, Security ... -->
</div>
</div>
</section>

Responsive Behavior​

ViewportColumns
> 960px4
601–960px2
≤ 600px1

Card Anatomy​

Each card has:

  • 4px colored top border matching the category (--id86-card).
  • White background with a 1px border.
  • Hover: translateY(-5px) lift with increased shadow.
  • Min height: clamp(164px, 18vw, 210px).

Category Colors​

Class--id86-card
.id86-code#2597d5 (sky)
.id86-devops#2273bf (blue)
.id86-ai#1f64a6 (dark blue)
.id86-security#0b2149 (navy)

Technology Cards (Explore Technologies)​

GP Element: ID 4414 — ID86 Tech Cards Shortcode: [id86_tech_cards limit="18" link="1"] Hook: generate_after_header, priority 25 — renders between Topic Cards (20) and Latest Reference Sheets (30) Display: general:front_page Full index: /technologies/ — page ID 4416

A band of small monospace name tiles directly below the topic cards. The card carries the technology name and nothing else: no description, no post count, no icon, no category label. It is the devhints.io chip (`bash` Bash scripting) promoted to a tile, which keeps the landing page dense without adding a fourth full-height section.

18 cards, three rows of six. Each row is a semantic group even though no row label is printed:

RowThemeSlugs
1Languages and markuprust php python sql css javascript
2Platform and datawordpress wp-cli woocommerce mysql postgresql sqlite
3Infrastructure and toolinglinux docker nginx cloudflare git bash

The grouping only holds at 6 columns. At 4 (tablet) and 2 (mobile) the grid reflows and the semantic rows dissolve — the arrangement is a scanning aid, not a data structure.

Why 18​

Measured against the 10,614-document corpus:

CardsRows (desktop)Docs reachable from a visible chip
12268.6%
18374.5%
24480.0%
48888.0%

18 is the last step with a strong return: +5.9 points of coverage for one extra row. Past 24 the curve flattens, and at 48 the band stops being a shortcut — 8 rows on desktop, 24 rows on mobile, where it is taller than the hero.

HTML​

<section class="id86-section id86-tech-cards">
<div class="id86-shell">
<div class="id86-section-heading">
<h2>Explore technologies</h2>
</div>
<nav class="id86-tech-nav" aria-label="Technologies">
<div class="id86-tech-grid">
<a class="id86-tech-card" href="/tag/rust/">
<span class="id86-tech-card__name">rust</span>
</a>
<!-- ... -->
</div>
</nav>
<p class="id86-tech-more">
<a class="id86-tech-more__link" href="/technologies/">
View all 69 technologies <span aria-hidden="true">→</span>
</a>
</p>
</div>
</section>

The grid is wrapped in a <nav> landmark with an aria-label, so a screen reader announces "Technologies, navigation" instead of 18 loose links. The aria-label is settable per instance with nav_label.

Where the list is controlled​

The cards are not driven by tag counts or a query loop. They come from an explicit allowlist in the FluentSnippets PHP snippet 5-id86-technology-cards.php:

function id86_tech_tags() {
return apply_filters('id86_tech_tags', [
// Row 1 — languages and markup
'rust', 'php', 'python', 'sql', 'css', 'javascript',
// Row 2 — platform and data
'wordpress', 'wp-cli', 'woocommerce', 'mysql', 'postgresql', 'sqlite',
// Row 3 — infrastructure and tooling
'linux', 'docker', 'nginx', 'cloudflare', 'git', 'bash',
// Everything below here is index-only: /technologies/ continues from this point
'rclone', 'shell', 'openlitespeed', /* … 48 more … */
]);
}

One array serves both the homepage band and the index page. The homepage takes the first 18 via limit="18"; the index takes all of it via limit="0".

Rules:

  • Array order is display order, everywhere. The index page is a superset of the homepage band in the same order, so a reader who clicks through sees the same first 18 in place.
  • Anything not listed is excluded. No separate exclude list, no automatic inclusion — junk tags (test, demo, Featured) can never reach either surface.
  • A listed slug with no published posts is skipped (hide_empty).
  • The 18-slot cut happens after that filter, so a homepage slot held by an empty tag is backfilled by the next qualifying slug. You do not need to reshuffle when a technology has no posts yet.
  • Slugs are post_tag slugs — lowercase and hyphenated.

Editing the list​

Where: wp-content/fluent-snippet-storage/5-id86-technology-cards.php, lines 39–56 — or in WP admin at FluentSnippets → Snippets → ID86 Technology Cards.

The array holds 69 slugs. Positions 1–18 are the homepage band; 19 and beyond are index-only.

GoalAction
Swap a homepage tileReplace the slug in place, then delete the old slug from the index-only block so it is not listed twice
Add to the homepageCut a slug from the index-only block and paste it into the slot you want
Remove a technologyDelete the slug from the array — it leaves both the band and the index
ReorderMove slugs; position 1 renders first, left to right then top to bottom
Try before committingUse include="" on the shortcode rather than editing the array

Keep six slugs per row if the semantic rows should hold at desktop width — a five- or seven-entry row shifts every subsequent tile by one.

After saving:

  1. FluentSnippets rewrites its own index.php. Do not edit that file.

  2. Purge both cache layers, or the front end keeps serving the old band:

    # on GC-US-M10
    curl --resolve id86.net:443:127.0.0.1 "https://id86.net/?LSCWP_CTRL=PURGESINGLE"

    Then the Cloudflare purge_cache call for https://id86.net/ and https://id86.net/technologies/.

  3. Confirm the order that will render:

    wp eval 'echo implode(", ", array_slice(id86_tech_tags(), 0, 18));'

A slug must already exist as a post_tag with at least one post; otherwise it is skipped silently rather than erroring. Check first with wp term list post_tag --slug=rclone.

Shortcode attributes​

AttributeDefaultPurpose
limit18Max cards rendered. 0 renders the whole allowlist
min1Minimum post count for a tag to render; 0 allows empty tags
min_cards0Return nothing unless at least this many cards qualify — use 6 at launch so a sparse row never ships
include—Comma-separated slugs that replace id86_tech_tags() for this instance
exclude—Comma-separated slugs to drop from the resolved list
orderbymanualmanual (array order), count, or name
link01 always appends the index link — "View all N technologies" when the band is truncated by limit, otherwise "Browse all technologies"
link_url/technologies/Target for that link
nav_labelTechnologiesaria-label on the wrapping <nav>

Companion shortcode: [id86_tech_count] returns how many allowlisted technologies currently have at least one post.

Responsive Behavior​

ViewportColumns
> 960px6
601–960px4
≤ 600px2

Two columns are kept at 600px and below rather than one: the tiles are short enough that a single column wastes a full screen of height.

Card Anatomy​

  • White background, 1px solid #dde7ef border, 10px radius.
  • min-height: 58px fixed, so the band never shifts layout (CLS = 0). Drops to 52px at 600px and below; both clear the 48px mobile hit-target rule.
  • Name in monospace, 0.9rem / 600, var(--id86-navy).
  • Hover: border-color: var(--id86-sky), translateY(-2px), 0 6px 14px rgba(20,50,108,.10).
  • Focus-visible: 2px sky outline with 2px offset.
  • Long names truncate with an ellipsis instead of wrapping, so every row stays the same height.

Empty State​

The shortcode returns an empty string when no listed tag qualifies, and the section disappears entirely. Nothing is printed, so there is no empty heading or half-row.

CSS Location​

The card styles live in the FluentSnippets CSS snippet 6-id86-technology-cards-css.php, printed inline in wp_head at priority 10. They are scoped to .id86-tech-* and .id86-section.id86-tech-cards, so no rule leaks onto other pages. The same classes render the /technologies/ grid. See CSS System.

The /technologies/ Index Page​

Page: ID 4416 — /technologies/ Title: All Technologies

Same card component, no limit. It mirrors the homepage order and continues past the first 18.

<style id="id86-tech-index-css">…</style>
<div class="id86-tech-index">
<section class="id86-tech-index__hero">
<div class="id86-tech-index__inner">
<p class="id86-kicker">Instant Documentation</p>
<h1>All technologies</h1>
<p class="id86-tech-index__lede">Every technology with at least one published reference.</p>
</div>
</section>
<section class="id86-section id86-tech-index__body">
<div class="id86-shell">
<p class="id86-tech-index__count">[id86_tech_count] technologies available</p>
[id86_tech_cards limit="0" min="1" link="0" nav_label="All technologies"]
</div>
</section>
</div>
  • Uses the recommendations-page pattern: one inline scoped <style> plus a full-bleed hero (margin-left: calc(50% - 50vw)), because page content sits in the theme's narrow entry-content column. The body section breaks out the same way so the grid can reach 1180px.
  • The hero supplies the only <h1>; the theme renders no duplicate page title (verified: 1 <h1>).
  • [id86_tech_count] prints the live number of technologies with at least one post, so the page never claims "69 technologies" while only a handful exist.
  • link="0" stops the index linking to itself.
  • At the full 69 technologies the grid is 12 rows on desktop and 35 on mobile. That is correct for an index page and wrong for the homepage — which is exactly why the homepage truncates at 18.

Latest Reference Sheets​

Location​

  • GP Element: ID 4092 — ID86 Latest Sheets
  • Content: [id86_latest_sheets limit="6"] shortcode
  • CSS: .id86-sheet-grid (3-column CSS grid)

Shortcode Output​

The id86_latest_sheets_shortcode function renders each homepage reference as a sheet card with topic + content type, no excerpt, updated date, and Read more:

<article class="id86-sheet-card">
<div class="id86-archive-meta">
<span class="id86-archive-category">Code</span>
<span class="id86-archive-type">Quick Reference</span>
</div>
<h3><a href="/code/git-cheat-sheet/">Git Quick Reference</a></h3>
<div class="id86-archive-card__footer">
<span class="id86-archive-updated">Updated Aug 13, 2026</span>
<a class="id86-sheet-link" href="/code/git-cheat-sheet/">Read more →</a>
</div>
</article>

Responsive Behavior​

ViewportColumns
> 960px3
601–960px2
≤ 600px1

Card Anatomy​

  • White background, 1px border.
  • Topic + content-type badges in the meta row.
  • Title link (whole card clickable).
  • Footer with updated date and "Read more →" link.
  • No excerpt/text preview.
  • Natural card sizing (no fixed min-height).