Common Ways to Customize Sphinx Themes

Sphinx themes can provide a great out-of-the-box experience, but sometimes there is a need to extend its functionality in ways that are reusable across projects and more likely to survive upgrades. This article covers a variety of ways to achieve this using the following methods:

Documentation Internationalization using Sphinx and Zanata

One of the great things about Sphinx, is that it natively provides internationalization (i18n) mechanisms to facilitate translation using the common gettext method. The gettext files can be translated a number of different ways, but I have had great results using Zanata, a separate open source project that facilitates community driven translation.

Continuous deployment of a Sphinx website using Jenkins and Docker

If you have ever set up a sphinx project you have probably reached the point where you want to start automating the build and deploy part of the creation process. This can be done several ways, but I chose git hooks going into a Jenkins pipeline using Docker agents. I am also doing this as a single branch deploy using the master branch, how you get your source onto master is up to you.

Trip Planning: Coastal Kayaking

I recently went on a weekend kayaking fishing trip down in Rockport on the Texas coast and while we weren’t successful in catching any keepers, I feel like we arrived at a productive planning strategy for future trips. We chose Goose Island State Park since we were already familiar with the area and we could stay right on the water.

Trip Report: Devil's Dome Loop

Devil’s Dome Loop is located in the Pasayten Wilderness which overlaps with the North Cascades National Park. We started on our hike September 18th at the Canyon Creek Trailhead right off Highway 20, which has a large gravel lot for parking, an outhouse, and a stream flowing beside it. To park at the trailhead requires a Northwest Forest Pass, although other passes may also be valid.

Farmer of Bits

I recently tried my hand at cooperative small-scale urban “market gardening” as a hobby and thought I would document it as a comparison to writing software – because who doesn’t like analogies.

View Archive