Skip to content

dustinvtran/blog-build

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

  1. 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
  1. When complete, rename and move the file to _posts/.
  2. Re-build the site.
jekyll build --destination ../blog
  1. 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 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.

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>

Setting up Jekyll

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.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages