Open Source Publishing.

Shows what can be done in a short period of time. I didn’t start building any of this till the beginning of this year.

It’s true that it’s a ton of work to do what I do, but you could use this concept for just one topic instead of 100 and build a valuable resource in a few days!

For now, I think the best way to use PDF on the web is to turn it to images. To get a high-quality image, I used, but I put performance1.csv and performance2.csv into the _data directory.

From there, jekyll throws it all up into and so I can call it with a bit of code and generate pages with it. (eventually)

pull requests welcome ;)


This blog is where I document my journey through web-publishing, along with contributions from other independent workers of the web.

WebWork Portfolio

Web Development


100's of Mostly Free SEO Tools

Google and Company

For adding ^^^ this link to my page (It seems like a decent guide.) they gave me this cool video :)

Limited Trial-Power Tools

Audit and Analytics

  • Seomator free online SEO Audit Tool. This tool crawls your website and provides an analysis. If you are just beginning to optimize, Seomator will likely highlight a number of issues you can begin to fix right away.
  • SEO Quake Chrome Extension provides on-the-fly analysis of any webpage you visit.

    “More raw data than any other SEO toolbar out there.” -moz


    “must-have for most serious SEOs.” -moz

  • - Analytics
  • - find out what websites are made of.
  • Chrome Webscraping Extension
  • Similarweb - Competitive analysis “Competitor website stats are hard to come by, but Similar Web does a good job.” -moz
  • Browseo - See your website the way the search engine sees it.
  • SEER’s SEO Toolbox
  • SEO Toolbar - information including backlinks and competitive research.
  • SEO Tools for Excel
  • SEOgadget Tools includes Excel plugins, content strategy generator….
  • URI Valet - check server headers, canonical information, analyzing redirect problems and more.
  • Virante SEO Tools
  • Xenu’s Link Sleuth - Site Crawler, find broken links, create sitemaps, etc.
  • Raven Tools Site Audit
  • Nibbler Audit for accessibility, SEO, social media, technology. (limited to 3 reports)
  • Statcounter - Free-Lightweight analytics - alternative to Google Analytics for privacy.
  • Whois Lookup registration, contact, and administrative information for any domain.
  • - Website Analysis

Rank and Visibility




Domain Authority


  • Social Crawlytics - see your competitors’ most-shared content, and many other features.
  • SharedCount - discover how content is shared socially.
  • Circle Count - Social Analytics
  • Social Mention - Enter a search term and see who’s sharing what (live)
  • - brainstorm new social media names
  • RowFeeder - track social usernames, hashtags and keywords - export to Excel.

Market Research

Content Creation

Local SEO



Track Google Algorithm

You can minimize your chances of avoiding a huge impact by always focusing on the SEO fundamentals. Avoid any shortcuts or spammy tactics that may have short-term gains but could create disaster in the long term.

You’re far better off understanding your audience and creating content that builds your authority, relevance, and trust.


Source: infominer33/WebWork

How to Sign Up and Get Started using Google Adwords Keyword Planner

I made this, because it was a little confusing for me when I first tried to use it, and I wanted to be sure that eveyone in my organization had a fundamental understanding of keyword research, so they could assist in coming up with seed-keywords, and understand the building blocks of keyword-research.

Everything builds from this. In my opinion, it will be valuable to get input from everyone in the organization for at least the first round of keyword research, since this is all about the identity of your website and your organization.

This step-by-step guide will ensure that anyone can try out keyword planner and begin learning a keyword research\SEO fundamental. It’s a valuable tool to have in your arsenal, but takes some manual effort to get the most out of.


Set up Free Google Ads Account

go to and click start now at the top right corner and choose a gmail account to use.

Click “Experienced with Google Ads” at the bottom.

Click create an account without a campaign.

Click Submit.

OK! Now you have an account w google ads.

You have to click “explore your account” to proceed.

Start Using Keyword Planner

In the top right corner, click the little wrench for tools, and then select “Keyword Planner” on the left of the screen.

Click Find New Keywords and then you’re good to go!

We’re going to enter 10 Seed Keywords, those are different ways someone might search for your business, or a business like it. If you don’t get enough keyword ideas then leave the web-site blank.

Download and Explore Data

Google comes up with keywords, based on your seed keywords. Ideally you want google to come up with a lot of them. We’ll get to that later.

Go to the top right corner and download the keywords and keyword planner will give you a csv file that we’re going to open up in a spreadsheet program.

You can see that there are a lot of ways to explore this data, I’m going to sort it by volume.

Then I can cut out all of the keywords that are really high volume or by whatever metrics I’m looking at, and use the keywords I get from keyword planner with a number of other tools.

GitHub Pages-Starter Pack

GitHub Pages-Starter Pack

Github makes it easy to get started, with the click of a button, you can have a web-page live, requiring only markdown skills (that anyone can learn on the go).

Each feature you want to enable requires a little more learning, and GitHub Pages is set up so that if you decide to, you can gradually progress from content creator to web-developer.

If you don’t want to think about web-development, and simply want your markdown files to look beautiful once published, github pages can help you do that too.

I first started playing around with GitHub to make an awesome-list, in November.

The number of technical subjects I’ve begun to learn, thanks to github, is incredible. Publishing via github-pages is really empowering.


I’m just a newb that created this resource to help myself. It does take a lot of work to create bigger projects like, however it’s really simple to create a blog, or a homepage.

Corrections, suggestions, tips, and links would be all appreciated.

Github pages runs Jekyll, which runs Kramdown, which can transform yaml, markdown, and a number of related languages into proper html.

Github pages can be used, like, 4 different ways. It’s versitile, but can be confusing.

The simplest way to use pages is to choose one of the official GitHub pages themes. Just go into your repository settings:

All you really need to do is select a branch and it will begin publishing your repository. Then choose a method to publish. Brand-newbs go with the theme chooser.

The first repository for your web-page must be named like so: For example, the repository for my personal page is called Simply create a new repository, and if your github username is @awesomesauce then you would create a new directory named

Every other repository you own can also be made into its own web-page, that will published off of your user page, with the same name following your domain. So if you have a repository called, /Dynomite and you go into settings select pages to publish from the master branch, then that page will be found at

so is published at, because I have a custom domain. But it can still be found at,


Namecheap supports BTC purchases, so I’m including their github how-to here. If you know of other crypto-friendly domain providers, lmk in the issues.

Getting Started

If you used the theme chooser, all you need to do is edit, and your page is built instantly when you save a commit to the repository.

Create an

Although pages will build an index.html from your, pages will not behave as expected if you try to do any configuration or additional optimization with only

in that you need to include front matter:

layout: default

There is a plugin that builds index files from all the files of your repository.. but it has trouble creating an index.html from your repositories primary

Besides the Theme Chooser

There are other ways that pages can work too. You should be able to run any theme that is set up to support remote themes. However, you have to pay attention to the themes and find ones that are in active development.

You can also run any Gem based theme from your page too. Basically Gem files are packages that contain all of the files necessary for building your site, and keep your repository directory un-cluttered. Then, if you want to change a file that’s in the gem, you just create the directory and pur the file where it goes, and configure as you wish.

I’m still a bit confused about that part, but gems do help you build pages locally to test features before deploying them….

Q: How can I get started with gem-packaged themes? / Do I need to package my theme into a gem?

Gem-packaged themes are just an advanced option and in addition they are in development for (real world) experiments (e.g. think v0.1 as stated by the Ben Balter - the lead designer / manager / dev at GitHub).

Thus, to conclude do NOT read too much into the official themes docs e.g. as the only or “right” way to design a theme. Just (continue to) use “classic” themes - there are hundreds to learn from and once you have mastered “classic” themes you can “graduate” to the master class, that is, using gem-packaged themes.

I understand what they’re saying, but I feel kind of the opposite. I used the theme chooser and remote\gem themes to begin learning. Then again, I didn’t really understand my options when I started.

These classic themes are just files and folders, everything where you can see it (and should be forkable to create working websites)

According to planetjekyll, these are all “classic” themes:



Github Pages

Use redirect_from: internal/url to change the location you are publishing, but keep old links. Use redirect_to: https://external.url to send visitors somewhere else (perhaps you want it to live on another site, but not lose your valuable links :)

Bug Testing

Buidling your site locally is the best way to figure out why it’s not publishing correctly via GitHub.

You must set up your gemfile specifically for each theme.

then prepare bundler for your project:

 bundle update

 bundle install

Build gives an error message if the build fails

 bundle exec jekyll build

Serve builds and “serves” a local browsable copy

 bundle exec jekyll serve

Verbose… you get the idea.

 jekyll build --verbose



coming soon….


Front Matter



I’ll say now, if you are new to web-development, best to start off trying out a few of the Github Pages official themes. Once installed, I cloned those repos locally so its easier to see how everything works. Then, if I want to configure a file that’s not in my repository, I have a copy nearby. You can grab the _layouts/default.html, put it in your repo, and get a feel for how configuring that template shapes your entire site. But then you configure individual pages, and categories, perhaphs, to display differently.

If you don’t want to think too much about web-development, try Hydejack. It’s build with everything you need to create a beatiful responsive web-page, with plenty of options and configurations supported. It’s a free version of a more robust commercial option. But it’s easy to set up, and works great.

The only problem is that it is not open source. So it’s not 100% customizable. Then again, that keeps you from getting in and screwing things up. –>

Minimal Mistakes

Minimal Mistakes is the most popular theme for Github Pages, and with good cause. It creates gorgeous web-sites right out the box, and with some fine tuning is beautiful indeed. You can find pretty much everything you need to run Minimal Mistakes in the Quickstart Guide, Sample Posts and Collections, along with their corresponding files on Github.

Other themes by @mmistakes:

I’ve just listed what repositories most fit my use cases, you might want to browse through his github portfolio, yourself.

Made Mistakes

So Simple

Basically Basic

Skinny Bones



MkDocs is not a jekyll theme. Meaning you have to install the software and build your pages locally (or set up a 3rd pary integration) before github pages can publish it. MkDocs has built in search, and in some ways simpler than publishing w jekyll.

MkDocs really caught my eye when I saw it running at EthHub

Because MkDocs builds with python, that opens up a whole universe of tools at your disposal. The python markdown extensions are a prime example.

However, basically none of the regular jekyll plugins work with mkdocs, it’s a whole universe to its own w Python.



Open Graph - Favicons and More



Other Customizations

Make a cool portfolio page like this:

I made a gist about how to do that based upon his code.

Content Creation

Here’s some tools to make content creation a little easier.


This thing has extensions for all your coding needs… It has seamless git integration, and all kind of great features for working with gh-pages repositories (search and replace, etc.).

HackMD - Collaborative Markdown Editor











API Evangelist

Not sure how much of this is useful, but I’ll save for further examination.

Data Visualization


Now Dev

I don’t even know… but it seems pretty dope.


Just sayin’… keybase has 250 gigs of free storage you can use to host a website…

you could build gem based sites locally, and keybase will automatically sync the data.