<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en"><generator uri="https://jekyllrb.com/" version="3.10.0">Jekyll</generator><link href="https://csswitch.github.io/jekyll-manuscript-theme/feed.xml" rel="self" type="application/atom+xml" /><link href="https://csswitch.github.io/jekyll-manuscript-theme/" rel="alternate" type="text/html" hreflang="en" /><updated>2026-05-12T20:28:01+00:00</updated><id>https://csswitch.github.io/jekyll-manuscript-theme/feed.xml</id><title type="html">Manuscript Theme Demo</title><subtitle>An editorial magazine-style Jekyll theme — serif typography, literary layout, for writers and independent publishers</subtitle><author><name>csswitch</name></author><entry><title type="html">Editorial Typography with CSS: The Principles Behind Print-Quality Web Type</title><link href="https://csswitch.github.io/jekyll-manuscript-theme/2024/01/22/editorial-typography-with-css/" rel="alternate" type="text/html" title="Editorial Typography with CSS: The Principles Behind Print-Quality Web Type" /><published>2024-01-22T00:00:00+00:00</published><updated>2024-01-22T00:00:00+00:00</updated><id>https://csswitch.github.io/jekyll-manuscript-theme/2024/01/22/editorial-typography-with-css</id><content type="html" xml:base="https://csswitch.github.io/jekyll-manuscript-theme/2024/01/22/editorial-typography-with-css/"><![CDATA[<p>Typography is the invisible architecture of a page. When it works, readers don’t notice it. When it fails, they feel it — restless, tired, unable to finish the sentence they started.</p>

<p>This essay is about making type work. Specifically, about borrowing from print — from centuries of editorial refinement — and applying those lessons to CSS. We’ll cover the exact techniques used in Manuscript Theme.</p>

<h2 id="the-drop-cap">The Drop Cap</h2>

<p>Nothing announces “this is an essay” quite like a drop cap. The first letter of a paragraph, enlarged, dropped down to sit alongside two or three lines of body text.</p>

<p>In CSS, this is a single rule:</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">p</span><span class="nd">:first-of-type::first-letter</span> <span class="p">{</span>
  <span class="nl">font-family</span><span class="p">:</span> <span class="s2">'Cormorant Garamond'</span><span class="p">,</span> <span class="nb">serif</span><span class="p">;</span>
  <span class="nl">font-size</span><span class="p">:</span> <span class="m">4.5rem</span><span class="p">;</span>
  <span class="nl">font-weight</span><span class="p">:</span> <span class="m">700</span><span class="p">;</span>
  <span class="nl">float</span><span class="p">:</span> <span class="nb">left</span><span class="p">;</span>
  <span class="nl">line-height</span><span class="p">:</span> <span class="m">0.75</span><span class="p">;</span>
  <span class="nl">margin</span><span class="p">:</span> <span class="m">0.05em</span> <span class="m">0.1em</span> <span class="m">0</span> <span class="m">0</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>

<p>The trick is <code class="language-plaintext highlighter-rouge">line-height: 0.75</code> — lower than 1 — combined with careful <code class="language-plaintext highlighter-rouge">margin</code> adjustment. Too high and the letter floats above the line. Too low and it sinks below it.</p>

<h2 id="the-oxford-double-rule">The Oxford Double Rule</h2>

<p>Print magazines use rules — horizontal lines — as structural elements. The Oxford style uses a double rule: a thin line stacked above a thick one, or vice versa, creating visual weight without a full header.</p>

<p>In CSS:</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">border-top</span><span class="o">:</span> <span class="err">3</span><span class="nt">px</span> <span class="nt">double</span> <span class="err">#1</span><span class="nt">a1410</span><span class="o">;</span>
</code></pre></div></div>

<p>The <code class="language-plaintext highlighter-rouge">double</code> value in <code class="language-plaintext highlighter-rouge">border-style</code> renders as two parallel lines with a gap between them. It’s a small thing. It signals craft.</p>

<h2 id="pull-quotes">Pull Quotes</h2>

<p>A pull quote is a line lifted from the body text and displayed larger, in the margin or across a column. It signals to the skimming reader: <em>here is the important part</em>.</p>

<p>In Manuscript Theme, pull quotes use standard Markdown blockquote syntax — <code class="language-plaintext highlighter-rouge">&gt;</code> — and are styled as oversized callouts:</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">blockquote</span> <span class="p">{</span>
  <span class="nl">border-left</span><span class="p">:</span> <span class="m">4px</span> <span class="nb">solid</span> <span class="m">#8b1a1a</span><span class="p">;</span>
  <span class="nl">font-family</span><span class="p">:</span> <span class="s2">'Cormorant Garamond'</span><span class="p">,</span> <span class="nb">serif</span><span class="p">;</span>
  <span class="nl">font-size</span><span class="p">:</span> <span class="m">1.4rem</span><span class="p">;</span>
  <span class="nl">font-style</span><span class="p">:</span> <span class="nb">italic</span><span class="p">;</span>
  <span class="nl">padding</span><span class="p">:</span> <span class="m">0.5rem</span> <span class="m">0</span> <span class="m">0.5rem</span> <span class="m">1.5rem</span><span class="p">;</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">relative</span><span class="p">;</span>
<span class="p">}</span>

<span class="nt">blockquote</span><span class="nd">::before</span> <span class="p">{</span>
  <span class="nl">content</span><span class="p">:</span> <span class="s2">'\201C'</span><span class="p">;</span>
  <span class="nl">font-size</span><span class="p">:</span> <span class="m">5rem</span><span class="p">;</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">absolute</span><span class="p">;</span>
  <span class="nl">left</span><span class="p">:</span> <span class="m">-0.5rem</span><span class="p">;</span>
  <span class="nl">top</span><span class="p">:</span> <span class="m">-1rem</span><span class="p">;</span>
  <span class="nl">opacity</span><span class="p">:</span> <span class="m">0.15</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>

<p>The <code class="language-plaintext highlighter-rouge">\201C</code> is the Unicode left double quotation mark — <code class="language-plaintext highlighter-rouge">"</code>. At 5rem, scaled down in opacity, it sits as a decorative watermark behind the blockquote.</p>

<h2 id="paragraph-indentation">Paragraph Indentation</h2>

<p>Books and magazines use indentation to separate paragraphs, not blank lines. It’s more space-efficient and feels more typographically controlled.</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">p</span> <span class="o">+</span> <span class="nt">p</span> <span class="p">{</span>
  <span class="nl">text-indent</span><span class="p">:</span> <span class="m">1.5em</span><span class="p">;</span>
  <span class="nl">margin-top</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>

<p>The <code class="language-plaintext highlighter-rouge">p + p</code> selector only applies indentation to paragraphs that follow another paragraph — so the first paragraph in a section doesn’t get indented.</p>

<h2 id="warm-white-vs-pure-white">Warm White vs. Pure White</h2>

<p>The cream background (<code class="language-plaintext highlighter-rouge">#faf7f2</code>) in Manuscript Theme isn’t an accident. Pure white (<code class="language-plaintext highlighter-rouge">#ffffff</code>) creates high contrast against dark text — technically readable, but tiring over long reading sessions.</p>

<p>Warm off-white reduces that contrast slightly, making longer pieces more comfortable to read. It also gives the page a paper-like quality that reinforces the editorial aesthetic.</p>

<hr />

<p>These are small decisions. Typography is full of small decisions. But accumulated, they determine whether your blog feels like it was put together carefully, or assembled from a template.</p>

<p>Manuscript Theme is the careful version.</p>

<blockquote>
  <p><em>The best typography is invisible. The reader should think only about the ideas, never about the letters carrying them.</em></p>
</blockquote>]]></content><author><name>The Editor</name></author><category term="Craft" /><category term="css" /><category term="typography" /><category term="design" /><category term="web-development" /><summary type="html"><![CDATA[Typography is the invisible architecture of a page. When it works, readers don’t notice it. When it fails, they feel it — restless, tired, unable to finish the sentence they started.]]></summary></entry><entry><title type="html">Welcome to Manuscript Theme</title><link href="https://csswitch.github.io/jekyll-manuscript-theme/2024/01/15/welcome-to-manuscript-theme/" rel="alternate" type="text/html" title="Welcome to Manuscript Theme" /><published>2024-01-15T00:00:00+00:00</published><updated>2024-01-15T00:00:00+00:00</updated><id>https://csswitch.github.io/jekyll-manuscript-theme/2024/01/15/welcome-to-manuscript-theme</id><content type="html" xml:base="https://csswitch.github.io/jekyll-manuscript-theme/2024/01/15/welcome-to-manuscript-theme/"><![CDATA[<p>This is Manuscript — a Jekyll theme for writers who care about typography as much as they care about words.</p>

<p>Most blog themes are designed around the dashboard, the admin panel, the statistics. Manuscript is designed around the page. The paragraph. The sentence.</p>

<h2 id="what-sets-manuscript-apart">What Sets Manuscript Apart</h2>

<p>Open any issue of <em>The New Yorker</em>, <em>The Atlantic</em>, or <em>Granta</em> and you’ll notice something immediately: the type is doing the heavy lifting. There’s no hero image. No gradient button. No animated scroll reveal. Just text, beautifully set.</p>

<p>That’s the ambition here.</p>

<ul>
  <li><strong>Cormorant Garamond</strong> for headlines — a free display serif that rivals expensive foundry fonts</li>
  <li><strong>Lora</strong> for body text — purpose-built for screens, warm and readable at length</li>
  <li><strong>Drop caps</strong> mark the beginning of essays like magazine features</li>
  <li><strong>Pull quotes</strong> let you lift the most important lines into margin-width callouts</li>
  <li><strong>Warm cream background</strong> because pure white is a mistake for long-form reading</li>
</ul>

<h2 id="getting-started">Getting Started</h2>

<p>Edit <code class="language-plaintext highlighter-rouge">_config.yml</code> to set your publication name, description, and the <code class="language-plaintext highlighter-rouge">manuscript:</code> config block:</p>

<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">manuscript</span><span class="pi">:</span>
  <span class="na">drop_cap</span><span class="pi">:</span> <span class="no">true</span>
  <span class="na">pullquote</span><span class="pi">:</span> <span class="no">true</span>
  <span class="na">reading_time</span><span class="pi">:</span> <span class="no">true</span>
  <span class="na">issue_number</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Vol.</span><span class="nv"> </span><span class="s">1,</span><span class="nv"> </span><span class="s">No.</span><span class="nv"> </span><span class="s">1"</span>
</code></pre></div></div>

<p>Then create posts in <code class="language-plaintext highlighter-rouge">_posts/</code> using the standard Jekyll naming convention: <code class="language-plaintext highlighter-rouge">YYYY-MM-DD-title.md</code>.</p>

<blockquote>
  <p>This is a pull quote. Use <code class="language-plaintext highlighter-rouge">&gt;</code> blockquote syntax in your Markdown to render the editorial pull-quote style.</p>
</blockquote>

<h2 id="sample-post-structure">Sample Post Structure</h2>

<p>Every post supports these front matter fields:</p>

<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
<span class="na">layout</span><span class="pi">:</span> <span class="s">post</span>
<span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Your</span><span class="nv"> </span><span class="s">Essay</span><span class="nv"> </span><span class="s">Title"</span>
<span class="na">date</span><span class="pi">:</span> <span class="s">2024-01-15</span>
<span class="na">author</span><span class="pi">:</span> <span class="s">Your Name</span>
<span class="na">category</span><span class="pi">:</span> <span class="s">Essays</span>          <span class="c1"># shown as kicker above the title</span>
<span class="na">tags</span><span class="pi">:</span> <span class="pi">[</span><span class="nv">writing</span><span class="pi">,</span> <span class="nv">culture</span><span class="pi">]</span>
<span class="nn">---</span>
</code></pre></div></div>

<p>The first paragraph of every post automatically receives the drop cap treatment. Write your opening line as if it’s the beginning of a magazine feature — because it is.</p>

<hr />

<p><em>Manuscript Theme is part of the csswitch premium Jekyll template pack. Browse all themes at <a href="https://csswitch.github.io">csswitch.github.io</a>.</em></p>]]></content><author><name>The Editor</name></author><category term="Editorial" /><category term="jekyll" /><category term="typography" /><category term="blogging" /><summary type="html"><![CDATA[This is Manuscript — a Jekyll theme for writers who care about typography as much as they care about words.]]></summary></entry></feed>