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
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
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 git@github.com: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.
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>
Install Ruby and Jekyll. I recently did this for my Windows machine.
Go to the blog directory. Run
bundle update
Add the above hack for in-text citations by including a custom APA
in-text style CSL file. Test your setup now works with jekyll serve --drafts
.