Extension:Git2Pages

From Linux Web Expert

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
File:OOjs UI icon notice-destructive.svg <translate> Warning:</translate> All versions of Git2Pages before 1.1.1, are vulnerable to directory traversal and remote code execution attacks, which could lead into compromisation of your wiki/server. We strongly recommend you to update your copy of Git2Pages to 1.1.1. The tarballs of Special:ExtensionDistributor will be updated as soon as possible, the REL1_23, REL1_24, REL1_25 and master branches of the git repo of Git2Pages already include the security fix.
MediaWiki extensions manual
Git2Pages
Release status: unmaintained
Implementation Parser extension , Tag , Database
Description Allow wiki pages to include code from a git repository.
Author(s) Teresa Cho (original author)
Dereckson (maintenance)
Contributions by others
Latest version 1.1.1 (2015-10-08)
MediaWiki >= 1.31.0
PHP 5.3+
Database changes No
License GNU General Public License 2.0 or later
Download

  • $wgGit2PagesDataDir
Quarterly downloads Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Public wikis using Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Translate the Git2Pages extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The Git2Pages extension implements a parser tag so you can transclude snippets of files in a git repository into wiki pages. To do so it executes git commands to clone a repository locally and then reads files from disk.

Usage

{{#snippet:repository=MYREPO|filename=MYFILE|branch=MYBRANCH |startline=STARTLINE|endline=ENDLINE}}

The parameters are:

  • repository - The URL of the git repository. REQUIRED
  • filename - The filename whose data is going to be displayed. REQUIRED
  • branch - The branch to look for the file. OPTIONAL (Default = master)
  • startline - The start of where the snippet will be pulled. OPTIONAL (Default = Start of file)
  • endline - The end of where the snippet will be pulled. OPTIONAL (Default = End of file)

Requirements

This extension uses wfShellExec() to run shell commands that probably require the bash shell.

Installation

  • <translate> [[<tvar name=2>Special:ExtensionDistributor/Git2Pages</tvar>|Download]] and move the extracted <tvar name=name>Git2Pages</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
    <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Git2Pages
  • <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>
    wfLoadExtension( 'Git2Pages' );
    
  • File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

See also