Listing GitHub projects in your blog

    Posted by Rogério Carvalho Schneider
    15 Aug 2009

    I needed to list my GitHub projects in a fancy way inside my blog, in the sidebar, all dynamically done. So, I searched a little around and found how.

    There are two major badges to do it, here I will describe them:

    Dr Nic’s github-badges

    This is my choice. drnic’s github-badges is flexible on configuration and also have some code of myself in it.

    Here is how to configure it:

    <div id="github-badge"></div>
    <script type="text/javascript" charset="utf-8">
    <script src="" type="text/javascript"></script>

    This is the complete list of options available:

    GITHUB_USERNAME = "stockrt";
    GITHUB_HEAD = "div"; // e.g. change to "h2" for wordpress sidebars
    GITHUB_THEME = "white"; // try 'black'
    GITHUB_TITLE = "My projects";
    GITHUB_SHOW_ALL = "Show all";

    subtleGradient’s mootools-github-badge:

    This is also pretty neat, subtleGradient’s mootools-github-badge has a great visual effect when it is building the project’s list, using a delayed composal. See this running example.

    Here is how to configure it:

    <div id="github-badge"></div>
    <script src="" type="text/javascript"> </script>
    <script src="" type="text/javascript"> </script>
    <script src="" type="text/javascript"> </script>
    <script type="text/javascript" charset="utf-8">
      new SubtleTemplate.GitHubBadge.Basic({ username:'stockrt' });

    Using jekyll and scribbish from stockrt’s site source

    If you are using my template to generated a scribbish styled static site with jekyll (pt-BR), all you need to do to activate the use of drnic’s github-badge is to configure this parameters in config.yml:

        enable: true
        username: stockrt
        length: 8
        head: div
        #head: h2
        theme: white
        #theme: black
        title: My Projects
        showall: Show all
        showfork: 0
        #showfork: 1

    All said, I must warn you that these two badges do not really behave well on IE 6, but who still uses it today? Better upgrade to Firefox, folks!

    Favorites View Comments