kennethrapp

<p>GitSwag displays data from a Github account using Github’s public API. In order to avoid<br />
rate-limiting, it caches the JSON from the API locally, and refers to that whenever<br />
available. You can display a user profile, list of repositories, header for a single<br />
repository, preview files or gists.</p>
<h3>Administration</h3>
<p>In “GitSwag” under the settings tab, enter your github username, select the<br />
“update cache” checkbox and submit to change your username. Files under that<br />
username can be deleted by checking the box next to the file and submitting.</p>
<p>Any changes you make to your github repo won’t be reflected immediately by<br />
the plugin, you’ll have to manually delete the cache first.</p>
<h3>Composer Updating</h3>
<p>This plugin includes <a href="Composer" rel="nofollow ugc">http://getcomposer.org</a> and an autoloader to implement<br />
the <a href="Parsedown" rel="nofollow ugc">http://parsedown.org/</a> library.</p>
<p>To save a bit of space, composer.phar isn’t included with this plugin.</p>
<p>Parsedown is [https://github.com/erusev/parsedown/blob/master/LICENSE.txt](MIT licensed)</p>
<h3>Shortcode</h3>
<p>Display the profile of a single user<br />
[gitswag_user_view github_username=”username”]</p>
<p>Display a list of repos for a user<br />
[gitswag_repo_list github_username=”username”]</p>
<p>View data for a repository<br />
[gitswag_repo_view github_username=”username” github_repo=”reponame”]</p>
<p>Preview a file<br />
[gitswag_file_view github_username=”username” github_repo=”reponame” path=”path/to/” filename=”file.txt”]</p>
<p>List gists by a user<br />
[gitswag_gist_list github_username=”username”]</p>
<p>Preview a gist<br />
[gitswag_gist_view gist_id=”id”]</p>
<p>display the readme for a repo<br />
[gitswag_readme github_username=”username” github_repo=”reponame”]</p>
<h3>Administration</h3>
<p>Because the public github API is rate limited, this plugin will download and keep a cached<br />
version of the .json files and readme markdown from API calls locally, and will need to be deleted<br />
in the admin panel when a change needs to be reflected. You can select a file and submit to delete them.</p>


GitSwag

Integrate various Github API-driven shortcodes into your pages.

Sudar Muthu

<p>WP Github Gist WordPress Plugin, provides the ability to embed gist and files from Github in your blog posts or pages. Even though Github doesn’t provide a way to embed files, this Plugin still works by using the gist-it service.</p>
<h3>Features</h3>
<h4>Embed Gist</h4>
<p>To embed a gist you have to use the following shortcode</p>
<pre><code>[gist id = "{GIST_ID}" file = "{GIST_FILE}" width = "{WIDTH}" height = "{HEIGHT}"]
</code></pre>
<p>The following are the different attributes that you can use in the shortcode</p>
<ul>
<li><code>id</code> – Id of your gist.</li>
<li><code>file</code> – File inside gist that you want to display. If there is only one file in the gist, then you can ignore this.</li>
<li><code>width</code> – Width of the code wrapper. Default is <code>100%</code>.</li>
<li><code>height</code> – Height of the code wrapper. Default is <code>100%</code>.</li>
</ul>
<p>eg: <code>[gist id = "12345" file = "myfile" width = "100%" height = "100%"]</code></p>
<h4>Embed Github files</h4>
<p>To embed a github file you have to use the following shortcode</p>
<pre><code>[github file = "{GITHUB_FILE}" start_line = "{START_LINE}" end_line = "{END_LINE}"]
</code></pre>
<ul>
<li><code>{GITHUB_FILE}</code> – full path to your github file. eg: If you want to embed https://github.com/sudar/MissileLauncher/blob/master/MissileLauncher.cpp then <code>{GITHUB_FILE}</code> would be /sudar/MissileLauncher/blob/master/MissileLauncher.cpp</li>
<li><code>{START_LINE}</code> – If you want to embed only part of the file, then you can specify the starting line number (optional)</li>
<li><code>{END_LINE}</code> – If you want to embed only part of the file, then you can specify the ending line number (optional)</li>
</ul>
<p>eg: <code>[github file = "/sudar/MissileLauncher/blob/master/MissileLauncher.cpp"]</code></p>
<p>if you want to embed only part of the file, then you can specify the start and end line as well</p>
<pre><code>[github file = "/sudar/MissileLauncher/blob/master/MissileLauncher.cpp" start_line = "10" end_line = "20"]
</code></pre>
<h3>Changing Gist-it server</h3>
<p>By default, this Plugin uses my own <a href="http://gist-it.sudarmuthu.com" rel="nofollow ugc">gist-it server</a> which is hosted on a free Google App Engine account. If you expect significant amount of traffic to your blog, then do consider using your own gist-it server. You can follow the <a href="http://sudarmuthu.com/wordpress/wp-github-gist/changing-gist-it-server" rel="nofollow ugc">instructions to deploy your own gist-it server</a> and then go to the settings page to change the url.</p>
<h3>Translation</h3>
<p>The pot file is available with the Plugin. If you are willing to do translation for the Plugin, use the pot file to create the .po files for your language and let me know. I will add it to the Plugin after giving credit to you.</p>
<h3>Support</h3>
<p>Support for the Plugin is available from the <a href="http://sudarmuthu.com/wordpress/wp-github-gist" rel="nofollow ugc">Plugin’s home page</a>. If you have any questions or suggestions, do leave a comment there or contact me in <a href="http://twitter.com/sudarmuthu" rel="nofollow ugc">twitter</a>.</p>
<h3>Readme Generator</h3>
<p>This Readme file was generated using <a href='http://sudarmuthu.com/wordpress/wp-readme' rel="nofollow ugc">wp-readme</a>, which generates readme files for WordPress Plugins.</p>


WP Github Gist

Unfortunately, this plugin does not seem to be working. If a solution is found, I'll bump my rating up to where it should be, as the basic idea is great.



Not working

Embed files and gist from Github in your blog posts or pages.

GitSwag vs WP Github Gist