Simple MediaWiki extension for embedding content of files hosted in GitHub git repositories. It supports markdown rendering, syntax highlighting and caching.
Build status:
On Packagist:
Professional support and custom development is available via Professional.Wiki.
The recommended way to install the GitHub extension is with Composer using MediaWiki 1.22 built-in support for Composer.
In your MediaWiki root directory, you can execute these two commands:
COMPOSER=composer.local.json composer require --no-update jeroen/mediawiki-github "~1.4"
composer update jeroen/mediawiki-github --no-dev -o
For more details on extension installation via Composer, see the documentation on MediaWiki.org.
Go to Special:Version and see if GitHub is listed there. If it is, you successfully installed it!
The default GitHub repo can be set using the $egGitHubDefaultRepo setting. Assign to this setting
the name of the default repo in your LocalSettings file, after the inclusion of this extension e.g.
for Semantic MediaWiki as follows:
$egGitHubDefaultRepo = 'SemanticMediaWiki/SemanticMediaWiki';To restrict from which repositories files can be fetched, use the egGitHubRepositoryWhitelist
setting. If this list is empty, which it is by default, users can fetch files from whatever
wiki they specify. This means they can include potentially harmful content. The extension should
escape harmful content; this setting adds an extra layer of security.
To allow only files from a single repo:
$egGitHubRepositoryWhitelist = [
'SemanticMediaWiki/SemanticMediaWiki',
];To allow files from multiple repos:
$egGitHubRepositoryWhitelist = [
'SemanticMediaWiki/SemanticMediaWiki',
'JeroenDeDauw/GitHub',
'JeroenDeDauw/Maps',
];If you want code syntax highlighting you need to have the SyntaxHighlight extension enabled and configured.
The file contents gets cached in memory during the PHP request. The main MediaWiki cache
is used as secondary cache, with a default TTL of 600 seconds. You can use the
$egGitHubCacheTime setting to change the TTL:
$egGitHubCacheTime = 900;You can modify which caching method is used. The supported methods are
'full'- use in memory and MediaWiki caches'none'- do not do any caching
The default is 'full'. You can change this setting as follows:
$egGitHubCache = 'none';You can modify the GitHub raw content URL used to fetch the files. The default is
https://rawcdn.githack.com, due to https://raw.githubusercontent.com not working on all systems.
You can change this setting as follows:
$egGitHubUrl = 'https://raw.githubusercontent.com';You can modify which method is used to fetch the file. The supported methods are
'mediawiki'- use MediaWikis HTTP class'simple'- use PHPs file_get_contents
The default is 'mediawiki'. You can change this setting as follows:
$egGitHubFetcher = 'simple';Add {{#github:FileName}} to your wiki page, where FileName is the name of the file you want to embed.
This can include a path, for instance {{#github:docs/INSTALL.md}}.
You can also specify the repo name and the branch name: {{#github:FileName|user/repo|branchName}}.
For syntax highlighting, this extension uses the same attributes as the SyntaxHighlight extension: lang, line, start, highlight, inline. Theses can be specified in any order using the attribute names.
{{#github:FileName|user/repo|branchName|lang=bash|line=1|start=1|highlight=1,5,4|inline=0}}
The lang parameter can be specified as the fourth positional argument.
{{#github:FileName|user/repo|branchName|bash}}
The defaults are line=0, start=1, and inline=0 when this functionality is activated.
- Changed default GitHub raw content url to
https://rawcdn.githack.com(thanks to @lmn8)
- Changed minimum PHP version to 7.1
- Updated dependencies to increase compatibility
- Fixed bug in the MediaWiki file fetching code and made it the default method again
<pre>HTML tags no longer get stripped out of the content
- Changed extension installation location from vendor to the MediaWiki extensions folder
- Added
$egGitHubCachesetting, allowing for complete disabling of the cache - Added error logging of failed HTTP requests to GitHub
- Dropped support for PHP < 7.0
- Added
egGitHubRepositoryWhitelistsetting - Made code more robust in failure cases
- Added support for syntax highlighting using MediaWiki's included SyntaxHighlight extension (by Shay Harding)
- Fixed critical issue caused by failing i18n registration on recent versions of MediaWiki
- Dropped support for PHP < 5.5
- Fixed error on file not found. The parser function will now return an empty string in this case.
- Fixed version number on Special:Version
- Switched from FileFetcher ~2.0 to ~3.1
- Added
$egGitHubFetchersetting - The files are now by default fetched using
file_get_contentsrather than MediaWikisHTTPclass
- Dropped support for MediaWiki < 1.24
- Added
$egGitHubUrlsetting - Changed default GitHub raw content url from
https://raw.githubusercontent.comtohttps://cdn.rawgit.com(thanks to Mike Cariaso)
- Added support for markdown. Files ending on .md or .markdown are now rendered appropriately
- Added
$egGitHubCacheTimesetting
- The extension now needs to be installed via Composer
- The package name has changed from
jeroen-de-dauw/mediawiki-githubtojeroen/mediawiki-github
- Compatibility with the latest version of the GitHub API has been added
- PSR-4 based autoloading is now used
- The ParserHooks library is now used for the github parser hook
- Additional tests have been added
- Initial release
To use MediaWiki vagrant, see this gist which includes the steps needed to install PHP7 and run the MediaWiki test runner with PHPUnit 6+.
To run code style checks and the tests that do not rely on MediaWiki, execute this in the base directory:
composer ci
The GitHub extension was created and is maintained by Jeroen De Dauw.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent