Gists

Summary: Markup to allow easy embedding of syntax-highlighted github gists

Version: 2013.09.03

Prerequisites: pmwiki-2.2.52 (tested; some earlier versions okay, but not tested)

Status: active

License: GPL2

Maintainer: MichaelPaulukonis

Users: (view ? / edit)

Discussion: Gists-Talk

Questions answered by this recipe

How can I easily display github-hosted gists on my website, in standard github-markup?

Description

Enter your recipe's description here.

Installation

Download pmwiki-gists.zip Δ
Extract pmwiki-gists.php to your \cookbook directory.

You can also download the latest version of pmwiki-gists.php from GitHub.

Configuration

Add the following to \local\config.php

IncludeOnce("$FarmD\cookbook\pmwiki-gists.php");

Usage

(:gist <public-gist-id>:)

See http://www.xradiograph.com/PmWikiDevelopment/PmWikiGistsExamples for a complete, live list of examples.

Notes

Gists must be public
Inspired by, and uses the javascript code from https://github.com/blairvanderhoof/gist-embed
Javascript must be enabled in the browser

Change log / Release notes

2013.09.03 fixed conflict with MarkupExtensions or other markup (Keep() instead of return)
2013.09.01 other forms of markup implemented, trap for missing or non-numeric gist-id
2013.08.27 initial release, Loading a gist implemented

Contributors

MichaelPaulukonis

Comments

See discussion at Gists-Talk

Alternatives

Cookbook /
: Ape Embed videos, maps, documents, and more in wiki pages (Stable)
: Beautifier Perform syntax highlighting for source code displayed on wiki pages
: CodeMirror An enhanced page editor for PmWiki (Stable)
: PITS The PmWiki Issue Tracking System (Beta)
: PmPygment Display code highlighting using Python pygment (Stable)
: Precode General utility block markup for displaying codes with syntax highlighting (Active/Stable)
: SourceBlock Source code syntax highlighter for PmWiki 2.x using GeSHi (Stable)
: Syntaxlove Syntax highlighting with good look and cool JavaScript-effects
: ZCode Extract and highlight source code files from 7z, TAR, ZIP, or RAR archives (Experimental)

User notes ? : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.