name: hps-academic-paper description: "Academic Paper deck theme: LaTeX-paper feel on paper-white #fdfcf8 — all-serif type (Latin Modern Roman → Playfair Display fallback), ink-black body, link-blue #1a3a7a underlined anchors, italic kickers, zero radius, near-zero shadow, hairline booktabs rules. Single-file HTML deck for conference talks, thesis defenses, research reviews and journal-club presentations." triggers:
- "academic paper"
- "conference talk"
- "paper presentation"
- "thesis defense"
- "research slides"
- "学术论文"
- "论文答辩"
- "学术汇报"
- "组会分享" od: mode: deck surface: web scenario: product upstream: "https://github.com/lewislulu/html-ppt-skill" preview: type: html entry: example.html design_system: requires: false speaker_notes: true animations: true example_prompt: "Use the Academic Paper theme to turn my research content into a single-file HTML conference-talk deck: paper-white background, all-serif type, link-blue citation anchors, italic kickers, double-rule title page, numbered Figure/Table captions and booktabs tables. Start from example.html — keep its token sheet, slide scaffold and keyboard runtime exactly as-is, replace slide content only, real content with no lorem ipsum." example_prompt_i18n: zh-CN: "用「学术论文风」主题把我的研究内容做成单文件 HTML 学术报告:纸白底全衬线排印、链接蓝引用锚点、斜体 kicker、双规则线扉页、带编号的 Figure/Table 图注和 booktabs 三线表。从 example.html 出发——完整保留 token 表、slide 骨架和键盘运行时,只替换幻灯片内容,使用真实内容,不要 lorem ipsum。"
Academic Paper(学术论文风)
A locked, single-theme deck plugin in the html-ppt-studio family, ported from
the MIT-licensed lewislulu/html-ppt-skill
academic-paper theme (assets/themes/academic-paper.css on the upstream
templates/deck.html scaffold). The register is a LaTeX article walking on
stage: paper-white ground, ink-black serif text, link-blue underlined
citations, italic kickers, hairline rules everywhere, zero rounded corners,
no shadows. It reads like Computer Modern even when Computer Modern is not
installed.
Start from example.html in this plugin folder. It is the proven seed: keep
its :root token sheet, base/slide-system CSS, academic device classes, deck
chrome and the entire navigation script verbatim, then replace only the slide
content. Do not rewrite the design system, and do not introduce any color or
font outside this spec.
Design tokens (locked — reproduce verbatim in :root)
:root{
--bg:#fdfcf8; --bg-soft:#f7f5ed; --surface:#ffffff; --surface-2:#f5f3ea;
--border:rgba(20,20,20,.14); --border-strong:rgba(20,20,20,.35);
--text-1:#0a0a0a; --text-2:#333333; --text-3:#707070;
--accent:#1a3a7a; /* link blue — citations, "ours" data, best numbers */
--accent-2:#0a0a0a; /* ink — rules, heavy structure */
--accent-3:#8a1a1a; /* sparing dark red — errata/negative only */
--good:#1a5a2a; --warn:#8a6a1a; --bad:#8a1a1a;
--grad:linear-gradient(135deg,#1a3a7a,#0a0a0a);
--grad-soft:linear-gradient(135deg,#e8edf8,#f5f3ea);
--radius:0px; --radius-sm:0px; --radius-lg:0px;
--shadow:none;
--shadow-lg:0 1px 2px rgba(0,0,0,.1);
--font-sans:'Latin Modern Roman','Playfair Display','Noto Serif SC',Georgia,serif;
--font-serif:'Latin Modern Roman','Playfair Display','Noto Serif SC',Georgia,serif;
--font-mono:'JetBrains Mono',SFMono-Regular,Menlo,monospace;
--font-display:'Latin Modern Roman','Playfair Display','Noto Serif SC',Georgia,serif;
--letter-tight:-.01em; --letter-normal:0;
--ease:cubic-bezier(.4,0,.2,1);
}
Hard color discipline: paper white, ink black, link blue, and the three
semantic statuses are the entire palette. --accent-3 dark red appears
only for errata, negative deltas or "withdrawn/deprecated" marks. Never add
gradients beyond the two declared tokens, never round a corner, never cast a
shadow stronger than --shadow-lg.
Typography
- All three display slots are serif.
Latin Modern Romanis named first so machines with LaTeX fonts get the real thing;Playfair Display(+Noto Serif SCfor CJK, then Georgia) is the webfont fallback. Google Fonts@importfor Playfair Display (incl. italics), Noto Serif SC and JetBrains Mono are the only permitted external references. - Headings weight 700, body 400, line-height 1.6. No uppercase headings, no
negative tracking beyond
--letter-tight:-.01em. .kickeris the theme signature: italic, link blue, sentence case,letter-spacing:0, weight 400 — never uppercase, never bold.- Numbers in stats/tables use
font-variant-numeric:tabular-nums.
Academic devices (theme-signature components — use them)
| class | device |
|---|---|
.rule / .rule-double |
hairline rule / LaTeX titlepage double rule (2px over 1px) |
.abstract |
italic abstract environment between two hairline rules, bold lead word |
.cite |
[n] citation anchor — mono, link blue, underlined |
.figure + .figcaption |
ruled figure box with numbered italic caption (<b>Figure 1:</b> …) |
.booktabs |
three-line table: 2px top/bottom rules, 1px header rule, no vertical rules; .best bolds winners in link blue |
.footnote |
dagger small print under a hairline rule |
.references |
hanging [n] bibliography list, titles in <i> |
.toc-list |
numbered outline with hairline separators and italic timing column |
.section-num |
oversized ghost numeral (in --surface-2) for section dividers |
Every figure and table must carry a numbered caption — that is what makes
the deck feel like a paper. Diagrams are ink-line inline SVG (1.5px ink
strokes, serif labels, the "ours" box tinted #e8edf8/link blue); charts are
pure CSS bars on a heavy ink axis with baselines in muted --surface-2 and
exactly one link-blue "ours" bar. No chart libraries, no remote images.
Layout masters (all demonstrated in example.html, 11 pages)
- cover — italic venue kicker, double rule, serif title, author line with superscript affiliations, hairline rule, affiliation small print
- toc/outline —
.toc-listnumbered contents - section-divider — ghost numeral + ink rule
- abstract + contributions —
.abstractbeside a.checklist - stat-highlight — one giant tabular number in link blue +
.footnoteCI - method figure — inline SVG pipeline in
.figurewith Figure caption - chart-bar — CSS bar chart, muted baselines vs blue "ours", Figure caption
- booktabs table — Table caption,
.bestwinners - big-quote — italic serif epigraph with precise attribution
- conclusions — two ruled cards (shown / open problems) + artifact link
- thanks/references —
.referencesbibliography + contact line
Compose decks from these masters; sequence
cover → outline → (divider → 2–4 content pages) × N → conclusions → references.
Slide system & runtime (keep verbatim)
- One self-contained HTML file; inline
<style>+<script>; zero build, zero external JS. Each page is<section class="slide" data-title="…">inside<div class="deck" id="deck">— a horizontal scroll-snap strip, one100vw × 100vhscreen per slide (16:9 / 1280×720 baseline, fluid viaclamp()), padding72px 96px, no internal scrolling. - Fixed chrome:
.deck-header(running head: short title · venue, italic),.deck-footer(attribution +N / totalcounter), 2px.progress-barin link blue. - Keyboard:
←/→/Space/PageUp/PageDown/Home/End;#/Nhash deep links viahistory.replaceStatein try/catch (srcdoc-safe). The script's dual capture-phase listeners with Event-identity dedupe,.deckscroll sync and body auto-focus fix real iframe-host bugs — do not simplify them away. This variant is theme-locked: there is noTtheme cycling. - Speaker notes: one hidden
<div class="notes">…</div>per slide. - Animations are restrained: at most one
anim-rise-in/anim-fade-uphero plus oneanim-stagger-listper slide. No 3D, no glitch, no confetti — this is a lecture hall, not a launch party.
Authoring checklist
- Copy
example.html; keep all<style>blocks and the<script>verbatim. - Replace the 11 demo slides with your content using the masters above.
- Real content, real numbers, real (or plausibly fictional) citations — no lorem ipsum; number every Figure/Table caption consecutively.
- Keep the running head and footer attribution updated; the script computes
the
N / totalcounter automatically. - Write 1–3 sentence speaker notes per slide in
.notes. - Verify: arrows + Space navigate,
#/5deep-links, no slide overflows vertically, no color or font outside the token sheet.
Attribution
Theme tokens and the deck scaffold come from the upstream MIT-licensed
lewislulu/html-ppt-skill
(© lewis <sudolewis@gmail.com>) — theme academic-paper. The LICENSE
file ships alongside this skill; keep it in place when redistributing.