A Mac sysadmin, documenting useful code, ideas, & guides.

Site Information

Odds are if you have ended up on this site you found something interesting or helpful. The following information gives insight on the tools and technologies used on this site.

Nerd facts

This website is built using Hugo.

Hugo is the backbone of this site. It is a powerful engine that allows me to write plain text files. Hugo then handles converting all the css, code blocks, html snippets, etc. into a pretty static web site. Since this site is static it allows me to quickly modify sections. Also, it is quite fast to serve static pages so response time should always be pretty good. Prior to Hugo I was using the static generator Jekyll.

All content is written in Markdown.

If you are not familiar with markdown it allows me to write plain text in such a way that an engine will be able to transform that text into a rich format like html. All this means I can write using any text editor I want (even vim if I so please) and create content without having to write all those dirty html tags. How many times have you forgotten to add that forward slash on a end tag resulting in a malformed page?

Hosting for this website is by Github Pages.

Github pages makes hosting a website easy. If Jekyll is my bread, Github Pages is my butter. Hosting a website via Apache, Nginx, or IIS isn't rocket science however by using Github my raw code and static html are right next to each other. As you can imagine this makes things easier to troubleshoot.

Site code can be found in the follow repo clburlison.github.io.

I <3 Github. Git is such a nice version control system to work with. All content is publicly accessible for two reasons: 1) I want others to be able to see how this site was created. 2) Sharing this code means if you find something you like you are able to copy/paste working code. With that said please don't blatantly steal written work of mine without crediting me.

Content delivery network provided by CloudFlare.

Cloudflare is much more than just my Content deliver network (CDN). Cloudflare also runs my DNS for the domain clburlison.com, has the ability to directly inject code into my website, gives me a flexible SSL for free, and has some nice built in reporting features. Of those the SSL certificate is likely the coolest. Though I do not have a true SSL setup, content that you view is secure from your end to Cloudflare's servers.

Content ideas are tracked via Github Issues and Waffle.io.

Ready In Progress
At any given time I might have 20 plus ideas or topics that I wish to write about. To keep track of these various ideas I create a Github issue. This allows me to add links or any notes that might be needed for me to understand what I wanted to write about. That means some of my issues might not make sense to you. Waffle.io just gives me a visual to keep me working on one or two topics at a time. The "Ready" tag is for content I am planning on writing about soon. The "In Progress" tag is for content ideas I'm working on right now.

With that said if you ever have any questions or would like for me to write about a specific topic feel free to create an issue and I will certainly think about it.

The theme for this website was created by Steven Enten.

The theme hyde-y is an enhanced port of the Jekyll "Hyde" theme.

CircleCI builds my website Build History.

Build Status
CircleCI is a continuous integration application that pulls the contents of my Github repo on every commit I submit to the source branch. The purpose of using CircleCI to build my Hugo site is so I no longer have to manually manage any of the master branch, which is where all of the html files are stored. Other benefits to using CircleCI include the ability to have a running record of all my builds. This allows me to know at any given point in time when I broke something. In the past this site used Travis CI however CircleCI is way faster.

User tracking is enabled and provided by Google Analytics.

Google rules the world. I do enable user tracking simply for the purpose of knowing viewership. Knowing which articles are the most popular help me when deciding what content I want to write about next.

Site comments are provided by Disqus.

Disqus is a free service. It is widely used. It also allows users to login via different social media sites. What is not to like?


Why Static?

I really dislike CMS websites. When I see blogs that have code snippets that are a pain to view I cry a little. Sure Hugo and Jekyll are harder to get the way you want. Customizing it can be very time consuming and confusing. However, the payoff is full control and ultimate flexibility. Also, the extra overhead on my plate to create this website the way I have is both fun and I believe provides the best experience. But what do I know…I just fix Macs.

I have tried both Blogger and Wordpress prior to finally getting latched onto Jekyll (now Hugo). You won’t find those sites…