blog's Introduction

Blog

This blog is built with Jekyll.

The theme builds off Type Theme, and is heavily inspired by Otoro, the New York Times, and the Rosenrot. The annals-like frontpage takes cue from Paul Graham's essays and Cosma Shalizi's notebooks.

The following Jekyll plugins are used:

KaTeX, Google Fonts, Google Analytics, Normalize, Pygments (comes with TypeTheme)
Jekyll Scholar

Workflow

Here's my workflow for writing and submitting blog posts.

Dump thoughts into a markdown file, in _drafts/. Or edit the many files already inside _drafts/. Preview (and generate) the static site from a local server.

jekyll serve --drafts

When complete, rename and move the file to _posts/.
Re-build the site.

jekyll build --destination ../blog

Copy generated blog onto my virtual private server, which hosts the blog.

scp -r ../blog digitalocean:/var/www/dustintran.com

Maintenance

To keep the theme up to date, I track the theme's original repo on the type-theme branch. Add to remote the original repo,

git remote add theme [email protected]:rohanchandra/type-theme.git

Whenever you want to update, simply run

git checkout type-theme
git pull theme master

You can compare type-theme to master and possibly merge in any changes. Keeping the theme up-to-date on a separate branch avoids treating the repo as a fork: this repo does more than just style things and is thus not appropriate as a fork.

Notes

I had to do a hack for in-text citations. It copies apa, where the only difference is on lines 588-594. The file is in etc/. Also see here.

  <layout suffix=")" delimiter="; ">
    <group delimiter=" ">
      <text macro="author-short"/>
      <text prefix="(" macro="issued-year"/>
      <text macro="citation-locator"/>
    </group>
  </layout>

blog's People