這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

WP Github Gist

外掛說明

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.

Features

Embed Gist

To embed a gist you have to use the following shortcode

[gist id = "{GIST_ID}" file = "{GIST_FILE}" width = "{WIDTH}" height = "{HEIGHT}"]

The following are the different attributes that you can use in the shortcode

  • id – Id of your gist.
  • file – File inside gist that you want to display. If there is only one file in the gist, then you can ignore this.
  • width – Width of the code wrapper. Default is 100%.
  • height – Height of the code wrapper. Default is 100%.

eg: [gist id = "12345" file = "myfile" width = "100%" height = "100%"]

Embed Github files

To embed a github file you have to use the following shortcode

[github file = "{GITHUB_FILE}" start_line = "{START_LINE}" end_line = "{END_LINE}"]
  • {GITHUB_FILE} – full path to your github file. eg: If you want to embed https://github.com/sudar/MissileLauncher/blob/master/MissileLauncher.cpp then {GITHUB_FILE} would be /sudar/MissileLauncher/blob/master/MissileLauncher.cpp
  • {START_LINE} – If you want to embed only part of the file, then you can specify the starting line number (optional)
  • {END_LINE} – If you want to embed only part of the file, then you can specify the ending line number (optional)

eg: [github file = "/sudar/MissileLauncher/blob/master/MissileLauncher.cpp"]

if you want to embed only part of the file, then you can specify the start and end line as well

[github file = "/sudar/MissileLauncher/blob/master/MissileLauncher.cpp" start_line = "10" end_line = "20"]

Changing Gist-it server

By default, this Plugin uses my own gist-it server 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 instructions to deploy your own gist-it server and then go to the settings page to change the url.

Translation

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.

Support

Support for the Plugin is available from the Plugin’s home page. If you have any questions or suggestions, do leave a comment there or contact me in twitter.

Readme Generator

This Readme file was generated using wp-readme, which generates readme files for WordPress Plugins.

安裝方式

Extract the zip file and just drop the contents in the wp-content/plugins/ directory of your WordPress installation and then activate the Plugin from Plugins page.

使用者評論

2016 年 9 月 3 日
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.
閱讀全部 1 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈WP Github Gist〉的開發相關工作。

參與者

將〈WP Github Gist〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

0.5 (2015-08-01) (Dev time: 1 hours)

  • New: Add ‘height’ parameter to specify the height of gist and github embeds

0.4 (2014-07-11) (Dev time: 3 hours)

  • Fix: Handle changes in github gist embed code

  • Tweak: Remove Legacy and PHP 4 complaint code

  • Tweak: Add support for specifying width in gist shortcode

0.3 (2012-05-31) (Dev time: 2 hours)

  • Added the ability to choose gist-it server
  • Added information to the screen help tab
  • Generated Pot file for translation

0.2 (2012-05-02)

  • Fixed issue in embedding Github files

0.1 (2011-08-23)

  • Initial Version