Index: tags/extensions/IncludeWP/REL_0_1/IncludeWP.settings.php |
— | — | @@ -0,0 +1,40 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * File defining the settings for the Include WP extension. |
| 6 | + * More info can be found at http://www.mediawiki.org/wiki/Extension:Include_WP#Settings |
| 7 | + * |
| 8 | + * NOTICE: |
| 9 | + * Changing one of these settings can be done by copieng or cutting it, |
| 10 | + * and placing it in LocalSettings.php, AFTER the inclusion of this extension. |
| 11 | + * |
| 12 | + * @file IncludeWP.Settings.php |
| 13 | + * @ingroup IncludeWP |
| 14 | + * |
| 15 | + * @licence GNU GPL v3 |
| 16 | + * |
| 17 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 18 | + */ |
| 19 | + |
| 20 | +if ( !defined( 'MEDIAWIKI' ) ) { |
| 21 | + die( 'Not an entry point.' ); |
| 22 | +} |
| 23 | + |
| 24 | +# The needed info for the wikis that can be included. |
| 25 | +$egIncWPWikis = array(); |
| 26 | +$egIncWPWikis['wikipedia'] = array( |
| 27 | + 'name' => 'Wikipedia', |
| 28 | + 'path' => 'http://en.wikipedia.org/w', |
| 29 | + 'url' => 'http://en.wikipedia.org/wiki', |
| 30 | + 'licencename' => 'CC-BY-SA', |
| 31 | + 'licenceurl' => 'http://creativecommons.org/licenses/by-sa/3.0/' |
| 32 | +); |
| 33 | + |
| 34 | +# Default wiki. |
| 35 | +$egIncWPDefaultWiki = 'wikipedia'; |
| 36 | + |
| 37 | +# Default amount of paragraphs to initially show. |
| 38 | +$egIncWPParagraphs = 3; |
| 39 | + |
| 40 | +# Default max height of the included content div. Set to 0 for no limit. |
| 41 | +$egIncWPDivHeight = 0; |
Property changes on: tags/extensions/IncludeWP/REL_0_1/IncludeWP.settings.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 42 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/IncludeWP.php |
— | — | @@ -0,0 +1,88 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * Initialization file for the Include WP extension. |
| 6 | + * |
| 7 | + * Documentation: http://www.mediawiki.org/wiki/Extension:Include_WP |
| 8 | + * Support http://www.mediawiki.org/wiki/Extension_talk:Include_WP |
| 9 | + * Source code: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/IncludeWP |
| 10 | + * |
| 11 | + * @file IncludeWP.php |
| 12 | + * @ingroup IncludeWP |
| 13 | + * |
| 14 | + * @licence GNU GPL v3 |
| 15 | + * |
| 16 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 17 | + */ |
| 18 | + |
| 19 | +/** |
| 20 | + * This documenation group collects source code files belonging to Include WP. |
| 21 | + * |
| 22 | + * @defgroup IncludeWP Include WP |
| 23 | + */ |
| 24 | + |
| 25 | +if ( !defined( 'MEDIAWIKI' ) ) { |
| 26 | + die( 'Not an entry point.' ); |
| 27 | +} |
| 28 | + |
| 29 | +if ( version_compare( $wgVersion, '1.16', '<' ) ) { |
| 30 | + die( 'Include WP requires MediaWiki 1.16 or above.' ); |
| 31 | +} |
| 32 | + |
| 33 | +// Include the Validator extension if that hasn't been done yet, since it's required for Include WP to work. |
| 34 | +if ( !defined( 'Validator_VERSION' ) ) { |
| 35 | + @include_once( dirname( __FILE__ ) . '/../Validator/Validator.php' ); |
| 36 | +} |
| 37 | + |
| 38 | +// Only initialize the extension when all dependencies are present. |
| 39 | +if ( ! defined( 'Validator_VERSION' ) ) { |
| 40 | + die( '<b>Error:</b> You need to have <a href="http://www.mediawiki.org/wiki/Extension:Validator">Validator</a> installed in order to use <a href="http://www.mediawiki.org/wiki/Extension:SubPageList">SubPageList</a>.<br />' ); |
| 41 | +} |
| 42 | + |
| 43 | +define( 'IncludeWP_VERSION', '0.1' ); |
| 44 | + |
| 45 | +$wgExtensionCredits['other'][] = array( |
| 46 | + 'path' => __FILE__, |
| 47 | + 'name' => 'Include WP', |
| 48 | + 'version' => IncludeWP_VERSION, |
| 49 | + 'author' => array( |
| 50 | + '[http://www.mediawiki.org/wiki/User:Jeroen_De_Dauw Jeroen De Dauw]', |
| 51 | + ), |
| 52 | + 'url' => 'http://www.mediawiki.org/wiki/Extension:Include_WP', |
| 53 | + 'descriptionmsg' => 'includewp-desc' |
| 54 | +); |
| 55 | + |
| 56 | +$egIncWPScriptPath = $wgExtensionAssetsPath === false ? $wgScriptPath . '/extensions/IncludeWP' : $wgExtensionAssetsPath . '/IncludeWP'; |
| 57 | + |
| 58 | +$wgExtensionMessagesFiles['IncludeWP'] = dirname( __FILE__ ) . '/IncludeWP.i18n.php'; |
| 59 | + |
| 60 | +$wgAutoloadClasses['IncludeWP'] = dirname( __FILE__ ) . '/IncludeWP.class.php'; |
| 61 | +$wgAutoloadClasses['ApiIncludeWP'] = dirname( __FILE__ ) . '/api/ApiIncludeWP.php'; |
| 62 | + |
| 63 | +$wgHooks['ParserFirstCallInit'][] = 'IncludeWP::staticInit'; |
| 64 | +$wgHooks['LanguageGetMagic'][] = 'IncludeWP::staticMagic'; |
| 65 | + |
| 66 | +$wgAPIModules['includewp'] = 'ApiIncludeWP'; |
| 67 | + |
| 68 | +$egIncWPJSMessages = array( |
| 69 | + 'includewp-show-full-page', |
| 70 | + 'includewp-loading-failed', |
| 71 | + 'includewp-licence-notice', |
| 72 | + 'includewp-show-fragment' |
| 73 | +); |
| 74 | + |
| 75 | +// For backward compatibility with MW < 1.17. |
| 76 | +if ( is_callable( array( 'OutputPage', 'addModules' ) ) ) { |
| 77 | + $moduleTemplate = array( |
| 78 | + 'localBasePath' => dirname( __FILE__ ), |
| 79 | + 'remoteBasePath' => $egIncWPScriptPath |
| 80 | + ); |
| 81 | + |
| 82 | + $wgResourceModules['ext.incwp'] = $moduleTemplate + array( |
| 83 | + 'scripts' => 'ext.incwp.js', |
| 84 | + 'dependencies' => array(), |
| 85 | + 'messages' => $egIncWPJSMessages |
| 86 | + ); |
| 87 | +} |
| 88 | + |
| 89 | +require_once 'IncludeWP.settings.php'; |
Property changes on: tags/extensions/IncludeWP/REL_0_1/IncludeWP.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 90 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/IncludeWP.class.php |
— | — | @@ -0,0 +1,248 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * CLass to render the sub page list. |
| 6 | + * |
| 7 | + * @since 0.1 |
| 8 | + * |
| 9 | + * @file SubPageList.class.php |
| 10 | + * @ingroup IncludeWP |
| 11 | + * |
| 12 | + * @licence GNU GPL v3 or later |
| 13 | + * |
| 14 | + * @author Jeroen De Dauw |
| 15 | + * @author James McCormack (email: user "qedoc" at hotmail); preceding version Martin Schallnahs <myself@schaelle.de>, original Rob Church <robchur@gmail.com> |
| 16 | + * @copyright © 2008 James McCormack, preceding version Martin Schallnahs, original Rob Church |
| 17 | + */ |
| 18 | +final class IncludeWP extends ParserHook { |
| 19 | + |
| 20 | + /** |
| 21 | + * No LSB in pre-5.3 PHP *sigh*. |
| 22 | + * This is to be refactored as soon as php >=5.3 becomes acceptable. |
| 23 | + */ |
| 24 | + public static function staticMagic( array &$magicWords, $langCode ) { |
| 25 | + $className = __CLASS__; |
| 26 | + $instance = new $className(); |
| 27 | + return $instance->magic( $magicWords, $langCode ); |
| 28 | + } |
| 29 | + |
| 30 | + /** |
| 31 | + * No LSB in pre-5.3 PHP *sigh*. |
| 32 | + * This is to be refactored as soon as php >=5.3 becomes acceptable. |
| 33 | + */ |
| 34 | + public static function staticInit( Parser &$wgParser ) { |
| 35 | + $className = __CLASS__; |
| 36 | + $instance = new $className(); |
| 37 | + return $instance->init( $wgParser ); |
| 38 | + } |
| 39 | + |
| 40 | + /** |
| 41 | + * Gets the name of the parser hook. |
| 42 | + * @see ParserHook::getName |
| 43 | + * |
| 44 | + * @since 0.1 |
| 45 | + * |
| 46 | + * @return string |
| 47 | + */ |
| 48 | + protected function getName() { |
| 49 | + return array( 'include' ); |
| 50 | + } |
| 51 | + |
| 52 | + /** |
| 53 | + * Returns an array containing the parameter info. |
| 54 | + * @see ParserHook::getParameterInfo |
| 55 | + * |
| 56 | + * @since 0.1 |
| 57 | + * |
| 58 | + * @return array |
| 59 | + */ |
| 60 | + protected function getParameterInfo( $type ) { |
| 61 | + global $egIncWPWikis, $egIncWPDefaultWiki, $egIncWPParagraphs, $egIncWPDivHeight; |
| 62 | + |
| 63 | + $params = array(); |
| 64 | + |
| 65 | + $params['page'] = new Parameter( 'page' ); |
| 66 | + $params['page']->setDescription( wfMsg( 'includewp-include-par-page' ) ); |
| 67 | + |
| 68 | + $params['wiki'] = new Parameter( 'wiki' ); |
| 69 | + |
| 70 | + if ( !array_key_exists( $egIncWPDefaultWiki, $egIncWPWikis ) ) { |
| 71 | + $egIncWPDefaultWiki = array_shift( array_keys( $egIncWPWikis ) ); |
| 72 | + } |
| 73 | + |
| 74 | + $params['wiki']->setDefault( $egIncWPDefaultWiki ); |
| 75 | + $params['wiki']->addCriteria( new CriterionInArray( array_keys( $egIncWPWikis ) ) ); |
| 76 | + $params['wiki']->addManipulations( new ParamManipulationFunctions( 'strtolower' ) ); |
| 77 | + $params['wiki']->setDescription( wfMsg( 'includewp-include-par-wiki' ) ); |
| 78 | + |
| 79 | + $params['paragraphs'] = new Parameter( 'paragraphs', Parameter::TYPE_INTEGER ); |
| 80 | + $params['paragraphs']->setDefault( $egIncWPParagraphs ); |
| 81 | + $params['paragraphs']->setDescription( wfMsg( 'includewp-include-par-paragraphs' ) ); |
| 82 | + |
| 83 | + $params['height'] = new Parameter( 'height', Parameter::TYPE_INTEGER ); |
| 84 | + $params['height']->setDefault( $egIncWPDivHeight ); |
| 85 | + $params['height']->setDescription( wfMsg( 'includewp-include-par-height' ) ); |
| 86 | + |
| 87 | + return $params; |
| 88 | + } |
| 89 | + |
| 90 | + /** |
| 91 | + * Returns the list of default parameters. |
| 92 | + * @see ParserHook::getDefaultParameters |
| 93 | + * |
| 94 | + * @since 0.1 |
| 95 | + * |
| 96 | + * @return array |
| 97 | + */ |
| 98 | + protected function getDefaultParameters( $type ) { |
| 99 | + return array( 'page', 'wiki' ); |
| 100 | + } |
| 101 | + |
| 102 | + /** |
| 103 | + * Renders and returns the output. |
| 104 | + * @see ParserHook::render |
| 105 | + * |
| 106 | + * @since 0.1 |
| 107 | + * |
| 108 | + * @param array $parameters |
| 109 | + * |
| 110 | + * @return string |
| 111 | + */ |
| 112 | + public function render( array $parameters ) { |
| 113 | + static $nr = 0; |
| 114 | + $nr++; |
| 115 | + |
| 116 | + $this->loadJs(); |
| 117 | + |
| 118 | + $html = Html::element( |
| 119 | + 'div', |
| 120 | + array( |
| 121 | + 'id' => 'includewp-loading-' . $nr, |
| 122 | + 'pageid' => $nr, |
| 123 | + 'class' => 'includewp-loading', |
| 124 | + 'page' => $parameters['page'], |
| 125 | + 'wiki' => $parameters['wiki'], |
| 126 | + 'paragraphs' => $parameters['paragraphs'] |
| 127 | + ), |
| 128 | + wfMsgForContent( 'includewp-loading-page' ) |
| 129 | + ); |
| 130 | + |
| 131 | + $html .= Html::element( |
| 132 | + 'div', |
| 133 | + array( |
| 134 | + 'id' => 'includewp-article-' . $nr, |
| 135 | + 'class' => 'includewp-article', |
| 136 | + 'style' => $parameters['height'] > 0 ? 'width:auto; max-height: ' . $parameters['height'] . 'px; overflow: auto' : 'width:auto' |
| 137 | + ), |
| 138 | + '' |
| 139 | + ); |
| 140 | + |
| 141 | + $html .= Html::element( |
| 142 | + 'div', |
| 143 | + array( |
| 144 | + 'id' => 'includewp-copyright-' . $nr, |
| 145 | + 'class' => 'includewp-copyright', |
| 146 | + 'style' => 'color:darkgray' |
| 147 | + ), |
| 148 | + '' |
| 149 | + ); |
| 150 | + |
| 151 | + return $html; |
| 152 | + } |
| 153 | + |
| 154 | + /** |
| 155 | + * Loads the needed JavaScript. |
| 156 | + * Takes care of non-RL compatibility. |
| 157 | + * |
| 158 | + * @since 0.1 |
| 159 | + */ |
| 160 | + protected function loadJs() { |
| 161 | + static $loadedJs = false; |
| 162 | + |
| 163 | + if ( $loadedJs ) { |
| 164 | + return; |
| 165 | + } |
| 166 | + |
| 167 | + $loadedJs = true; |
| 168 | + |
| 169 | + $this->addJSWikiData(); |
| 170 | + |
| 171 | + // For backward compatibility with MW < 1.17. |
| 172 | + if ( is_callable( array( $this->parser->getOutput(), 'addModules' ) ) ) { |
| 173 | + $this->parser->getOutput()->addModules( 'ext.incwp' ); |
| 174 | + } |
| 175 | + else { |
| 176 | + global $egIncWPScriptPath, $wgStylePath, $wgStyleVersion; |
| 177 | + |
| 178 | + $this->addJSLocalisation(); |
| 179 | + |
| 180 | + $this->parser->getOutput()->addHeadItem( |
| 181 | + Html::linkedScript( "$wgStylePath/common/jquery.min.js?$wgStyleVersion" ), |
| 182 | + 'jQuery' |
| 183 | + ); |
| 184 | + |
| 185 | + $this->parser->getOutput()->addHeadItem( |
| 186 | + Html::linkedScript( $egIncWPScriptPath . '/ext.incwp.js' ), |
| 187 | + 'ext.incwp' |
| 188 | + ); |
| 189 | + } |
| 190 | + } |
| 191 | + |
| 192 | + /** |
| 193 | + * Ouput the wiki data needed to display the licence links. |
| 194 | + * |
| 195 | + * @since 0.1 |
| 196 | + */ |
| 197 | + protected function addJSWikiData() { |
| 198 | + global $egIncWPWikis; |
| 199 | + |
| 200 | + $this->parser->getOutput()->addHeadItem( |
| 201 | + Html::inlineScript( |
| 202 | + 'var wgIncWPWikis =' . json_encode( $egIncWPWikis ) . ';' |
| 203 | + ) |
| 204 | + ); |
| 205 | + } |
| 206 | + |
| 207 | + /** |
| 208 | + * Adds the needed JS messages to the page output. |
| 209 | + * This is for backward compatibility with pre-RL MediaWiki. |
| 210 | + * |
| 211 | + * @since 0.1 |
| 212 | + */ |
| 213 | + protected function addJSLocalisation() { |
| 214 | + global $egIncWPJSMessages; |
| 215 | + |
| 216 | + $data = array(); |
| 217 | + |
| 218 | + foreach ( $egIncWPJSMessages as $msg ) { |
| 219 | + $data[$msg] = wfMsgNoTrans( $msg ); |
| 220 | + } |
| 221 | + |
| 222 | + $this->parser->getOutput()->addHeadItem( Html::inlineScript( 'var wgIncWPMessages = ' . json_encode( $data ) . ';' ) ); |
| 223 | + } |
| 224 | + |
| 225 | + /** |
| 226 | + * Returns the parser function otpions. |
| 227 | + * @see ParserHook::getFunctionOptions |
| 228 | + * |
| 229 | + * @since 0.1 |
| 230 | + * |
| 231 | + * @return array |
| 232 | + */ |
| 233 | + protected function getFunctionOptions() { |
| 234 | + return array( |
| 235 | + 'noparse' => true, |
| 236 | + 'isHTML' => true |
| 237 | + ); |
| 238 | + } |
| 239 | + |
| 240 | + /** |
| 241 | + * @see ParserHook::getDescription() |
| 242 | + * |
| 243 | + * @since 0.1 |
| 244 | + */ |
| 245 | + public function getDescription() { |
| 246 | + return wfMsg( 'includewp-parserhook-desc' ); |
| 247 | + } |
| 248 | + |
| 249 | +} |
Property changes on: tags/extensions/IncludeWP/REL_0_1/IncludeWP.class.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 250 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/INSTALL |
— | — | @@ -0,0 +1,41 @@ |
| 2 | +These is the install file for the Include WP extension. |
| 3 | + |
| 4 | +Extension page on mediawiki.org: http://www.mediawiki.org/wiki/Extension:Include_WP |
| 5 | +Latest version of the install file: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/IncludeWP/INSTALL?view=co |
| 6 | + |
| 7 | + |
| 8 | +== Download == |
| 9 | + |
| 10 | +You can find the current version of Include WP on the [https://code.google.com/p/includewp/downloads/list Google Code download page], |
| 11 | +as well as a [https://code.google.com/p/includewp/downloads/list?can=1 list of legacy downloads]. |
| 12 | + |
| 13 | +You can also get the code directly from SVN. Tags can be obtained via |
| 14 | + |
| 15 | + svn checkout <nowiki>http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/IncludeWP/REL_version</nowiki> |
| 16 | + |
| 17 | +Where 'version' is the version number of the tag, such as 0_1 (see the [http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/IncludeWP/ available tags]). |
| 18 | +The latest code can be obtained from trunk: |
| 19 | + |
| 20 | + svn checkout <nowiki>http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/IncludeWP/</nowiki> |
| 21 | + |
| 22 | +IncludeWP requires [[Extension:Validator|Validator]] 0.4.2 or above in order to work. A compatible |
| 23 | +copy of Validator always comes bundled with the regular releases, and is automatically loaded by IncludeWP, |
| 24 | +so you do not need to worry about it when using one of these. If you are getting the code from SVN, make |
| 25 | +sure you also get a copy of Validator ([[Extension:Validator#Download|see here for instructions]]). |
| 26 | + |
| 27 | +== Installation == |
| 28 | + |
| 29 | +Once you have downloaded the code, place the ''IncludeWP'' and ''Validator'' directories within your |
| 30 | +MediaWiki 'extensions' directory. Then add the following code to your [[Manual:LocalSettings.php|LocalSettings.php]] file: |
| 31 | + |
| 32 | +# IncludeWP |
| 33 | +require_once( "$IP/extensions/IncludeWP/IncludeWP.php" ); |
| 34 | + |
| 35 | +== Configuration == |
| 36 | + |
| 37 | +Configuration of IncludeWP is done by adding simple PHP statements to your [[Manual:LocalSettings.php|LocalSettings.php]] |
| 38 | +file. These statements need to be placed AFTER the inclusion of IncludeWP. The options are listed below and their default |
| 39 | +is set in the [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/IncludeWP/IncludeWP.settings.php?view=markup Include WP settings file]. |
| 40 | +You should NOT modify the settings file, but can have a look at it to get an idea of how to use the settings, in case the below descriptions do not suffice. |
| 41 | + |
| 42 | +As of version 0.1, there are no settings yet. |
Property changes on: tags/extensions/IncludeWP/REL_0_1/INSTALL |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 43 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/RELEASE-NOTES |
— | — | @@ -0,0 +1,18 @@ |
| 2 | +These are the release notes for the Include WP extension. |
| 3 | + |
| 4 | +Extension page on mediawiki.org: http://www.mediawiki.org/wiki/Extension:Include_WP |
| 5 | +Latest version of the release notes: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/IncludeWP/RELEASE-NOTES?view=co |
| 6 | + |
| 7 | + |
| 8 | +=== Version 0.1 === |
| 9 | +2011-02-13 |
| 10 | + |
| 11 | +Initial release with these features: |
| 12 | + |
| 13 | +* Include articles from Wikipedia or any other MediaWiki wiki into your pages. |
| 14 | +* Show only a limited amount of paragraphs on page load, with an option to show the full article. |
| 15 | +* Partial conversion to plain-text. |
| 16 | +** Removal of templates (such as infoboxes), ref tags, comments, categories and images. |
| 17 | +** Both internal and external links are rendered as plain-text. |
| 18 | +** Tables, lists, table of content, section headers and more are retained. |
| 19 | +* Usage of the MediaWiki [[Resource Loader]] when available with backward support for MW 1.16.x. |
Property changes on: tags/extensions/IncludeWP/REL_0_1/RELEASE-NOTES |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 20 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/COPYING |
— | — | @@ -0,0 +1,682 @@ |
| 2 | +The license text below "----" applies to all files within this distribution, other |
| 3 | +than those that are in a directory which contains files named "LICENSE" or |
| 4 | +"COPYING", or a subdirectory thereof. For those files, the license text contained in |
| 5 | +said file overrides any license information contained in directories of smaller depth. |
| 6 | +Alternative licenses are typically used for software that is provided by external |
| 7 | +parties, and merely packaged with this software for convenience. |
| 8 | +---- |
| 9 | + |
| 10 | + GNU GENERAL PUBLIC LICENSE |
| 11 | + Version 3, 29 June 2007 |
| 12 | + |
| 13 | + Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
| 14 | + Everyone is permitted to copy and distribute verbatim copies |
| 15 | + of this license document, but changing it is not allowed. |
| 16 | + |
| 17 | + Preamble |
| 18 | + |
| 19 | + The GNU General Public License is a free, copyleft license for |
| 20 | +software and other kinds of works. |
| 21 | + |
| 22 | + The licenses for most software and other practical works are designed |
| 23 | +to take away your freedom to share and change the works. By contrast, |
| 24 | +the GNU General Public License is intended to guarantee your freedom to |
| 25 | +share and change all versions of a program--to make sure it remains free |
| 26 | +software for all its users. We, the Free Software Foundation, use the |
| 27 | +GNU General Public License for most of our software; it applies also to |
| 28 | +any other work released this way by its authors. You can apply it to |
| 29 | +your programs, too. |
| 30 | + |
| 31 | + When we speak of free software, we are referring to freedom, not |
| 32 | +price. Our General Public Licenses are designed to make sure that you |
| 33 | +have the freedom to distribute copies of free software (and charge for |
| 34 | +them if you wish), that you receive source code or can get it if you |
| 35 | +want it, that you can change the software or use pieces of it in new |
| 36 | +free programs, and that you know you can do these things. |
| 37 | + |
| 38 | + To protect your rights, we need to prevent others from denying you |
| 39 | +these rights or asking you to surrender the rights. Therefore, you have |
| 40 | +certain responsibilities if you distribute copies of the software, or if |
| 41 | +you modify it: responsibilities to respect the freedom of others. |
| 42 | + |
| 43 | + For example, if you distribute copies of such a program, whether |
| 44 | +gratis or for a fee, you must pass on to the recipients the same |
| 45 | +freedoms that you received. You must make sure that they, too, receive |
| 46 | +or can get the source code. And you must show them these terms so they |
| 47 | +know their rights. |
| 48 | + |
| 49 | + Developers that use the GNU GPL protect your rights with two steps: |
| 50 | +(1) assert copyright on the software, and (2) offer you this License |
| 51 | +giving you legal permission to copy, distribute and/or modify it. |
| 52 | + |
| 53 | + For the developers' and authors' protection, the GPL clearly explains |
| 54 | +that there is no warranty for this free software. For both users' and |
| 55 | +authors' sake, the GPL requires that modified versions be marked as |
| 56 | +changed, so that their problems will not be attributed erroneously to |
| 57 | +authors of previous versions. |
| 58 | + |
| 59 | + Some devices are designed to deny users access to install or run |
| 60 | +modified versions of the software inside them, although the manufacturer |
| 61 | +can do so. This is fundamentally incompatible with the aim of |
| 62 | +protecting users' freedom to change the software. The systematic |
| 63 | +pattern of such abuse occurs in the area of products for individuals to |
| 64 | +use, which is precisely where it is most unacceptable. Therefore, we |
| 65 | +have designed this version of the GPL to prohibit the practice for those |
| 66 | +products. If such problems arise substantially in other domains, we |
| 67 | +stand ready to extend this provision to those domains in future versions |
| 68 | +of the GPL, as needed to protect the freedom of users. |
| 69 | + |
| 70 | + Finally, every program is threatened constantly by software patents. |
| 71 | +States should not allow patents to restrict development and use of |
| 72 | +software on general-purpose computers, but in those that do, we wish to |
| 73 | +avoid the special danger that patents applied to a free program could |
| 74 | +make it effectively proprietary. To prevent this, the GPL assures that |
| 75 | +patents cannot be used to render the program non-free. |
| 76 | + |
| 77 | + The precise terms and conditions for copying, distribution and |
| 78 | +modification follow. |
| 79 | + |
| 80 | + TERMS AND CONDITIONS |
| 81 | + |
| 82 | + 0. Definitions. |
| 83 | + |
| 84 | + "This License" refers to version 3 of the GNU General Public License. |
| 85 | + |
| 86 | + "Copyright" also means copyright-like laws that apply to other kinds of |
| 87 | +works, such as semiconductor masks. |
| 88 | + |
| 89 | + "The Program" refers to any copyrightable work licensed under this |
| 90 | +License. Each licensee is addressed as "you". "Licensees" and |
| 91 | +"recipients" may be individuals or organizations. |
| 92 | + |
| 93 | + To "modify" a work means to copy from or adapt all or part of the work |
| 94 | +in a fashion requiring copyright permission, other than the making of an |
| 95 | +exact copy. The resulting work is called a "modified version" of the |
| 96 | +earlier work or a work "based on" the earlier work. |
| 97 | + |
| 98 | + A "covered work" means either the unmodified Program or a work based |
| 99 | +on the Program. |
| 100 | + |
| 101 | + To "propagate" a work means to do anything with it that, without |
| 102 | +permission, would make you directly or secondarily liable for |
| 103 | +infringement under applicable copyright law, except executing it on a |
| 104 | +computer or modifying a private copy. Propagation includes copying, |
| 105 | +distribution (with or without modification), making available to the |
| 106 | +public, and in some countries other activities as well. |
| 107 | + |
| 108 | + To "convey" a work means any kind of propagation that enables other |
| 109 | +parties to make or receive copies. Mere interaction with a user through |
| 110 | +a computer network, with no transfer of a copy, is not conveying. |
| 111 | + |
| 112 | + An interactive user interface displays "Appropriate Legal Notices" |
| 113 | +to the extent that it includes a convenient and prominently visible |
| 114 | +feature that (1) displays an appropriate copyright notice, and (2) |
| 115 | +tells the user that there is no warranty for the work (except to the |
| 116 | +extent that warranties are provided), that licensees may convey the |
| 117 | +work under this License, and how to view a copy of this License. If |
| 118 | +the interface presents a list of user commands or options, such as a |
| 119 | +menu, a prominent item in the list meets this criterion. |
| 120 | + |
| 121 | + 1. Source Code. |
| 122 | + |
| 123 | + The "source code" for a work means the preferred form of the work |
| 124 | +for making modifications to it. "Object code" means any non-source |
| 125 | +form of a work. |
| 126 | + |
| 127 | + A "Standard Interface" means an interface that either is an official |
| 128 | +standard defined by a recognized standards body, or, in the case of |
| 129 | +interfaces specified for a particular programming language, one that |
| 130 | +is widely used among developers working in that language. |
| 131 | + |
| 132 | + The "System Libraries" of an executable work include anything, other |
| 133 | +than the work as a whole, that (a) is included in the normal form of |
| 134 | +packaging a Major Component, but which is not part of that Major |
| 135 | +Component, and (b) serves only to enable use of the work with that |
| 136 | +Major Component, or to implement a Standard Interface for which an |
| 137 | +implementation is available to the public in source code form. A |
| 138 | +"Major Component", in this context, means a major essential component |
| 139 | +(kernel, window system, and so on) of the specific operating system |
| 140 | +(if any) on which the executable work runs, or a compiler used to |
| 141 | +produce the work, or an object code interpreter used to run it. |
| 142 | + |
| 143 | + The "Corresponding Source" for a work in object code form means all |
| 144 | +the source code needed to generate, install, and (for an executable |
| 145 | +work) run the object code and to modify the work, including scripts to |
| 146 | +control those activities. However, it does not include the work's |
| 147 | +System Libraries, or general-purpose tools or generally available free |
| 148 | +programs which are used unmodified in performing those activities but |
| 149 | +which are not part of the work. For example, Corresponding Source |
| 150 | +includes interface definition files associated with source files for |
| 151 | +the work, and the source code for shared libraries and dynamically |
| 152 | +linked subprograms that the work is specifically designed to require, |
| 153 | +such as by intimate data communication or control flow between those |
| 154 | +subprograms and other parts of the work. |
| 155 | + |
| 156 | + The Corresponding Source need not include anything that users |
| 157 | +can regenerate automatically from other parts of the Corresponding |
| 158 | +Source. |
| 159 | + |
| 160 | + The Corresponding Source for a work in source code form is that |
| 161 | +same work. |
| 162 | + |
| 163 | + 2. Basic Permissions. |
| 164 | + |
| 165 | + All rights granted under this License are granted for the term of |
| 166 | +copyright on the Program, and are irrevocable provided the stated |
| 167 | +conditions are met. This License explicitly affirms your unlimited |
| 168 | +permission to run the unmodified Program. The output from running a |
| 169 | +covered work is covered by this License only if the output, given its |
| 170 | +content, constitutes a covered work. This License acknowledges your |
| 171 | +rights of fair use or other equivalent, as provided by copyright law. |
| 172 | + |
| 173 | + You may make, run and propagate covered works that you do not |
| 174 | +convey, without conditions so long as your license otherwise remains |
| 175 | +in force. You may convey covered works to others for the sole purpose |
| 176 | +of having them make modifications exclusively for you, or provide you |
| 177 | +with facilities for running those works, provided that you comply with |
| 178 | +the terms of this License in conveying all material for which you do |
| 179 | +not control copyright. Those thus making or running the covered works |
| 180 | +for you must do so exclusively on your behalf, under your direction |
| 181 | +and control, on terms that prohibit them from making any copies of |
| 182 | +your copyrighted material outside their relationship with you. |
| 183 | + |
| 184 | + Conveying under any other circumstances is permitted solely under |
| 185 | +the conditions stated below. Sublicensing is not allowed; section 10 |
| 186 | +makes it unnecessary. |
| 187 | + |
| 188 | + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. |
| 189 | + |
| 190 | + No covered work shall be deemed part of an effective technological |
| 191 | +measure under any applicable law fulfilling obligations under article |
| 192 | +11 of the WIPO copyright treaty adopted on 20 December 1996, or |
| 193 | +similar laws prohibiting or restricting circumvention of such |
| 194 | +measures. |
| 195 | + |
| 196 | + When you convey a covered work, you waive any legal power to forbid |
| 197 | +circumvention of technological measures to the extent such circumvention |
| 198 | +is effected by exercising rights under this License with respect to |
| 199 | +the covered work, and you disclaim any intention to limit operation or |
| 200 | +modification of the work as a means of enforcing, against the work's |
| 201 | +users, your or third parties' legal rights to forbid circumvention of |
| 202 | +technological measures. |
| 203 | + |
| 204 | + 4. Conveying Verbatim Copies. |
| 205 | + |
| 206 | + You may convey verbatim copies of the Program's source code as you |
| 207 | +receive it, in any medium, provided that you conspicuously and |
| 208 | +appropriately publish on each copy an appropriate copyright notice; |
| 209 | +keep intact all notices stating that this License and any |
| 210 | +non-permissive terms added in accord with section 7 apply to the code; |
| 211 | +keep intact all notices of the absence of any warranty; and give all |
| 212 | +recipients a copy of this License along with the Program. |
| 213 | + |
| 214 | + You may charge any price or no price for each copy that you convey, |
| 215 | +and you may offer support or warranty protection for a fee. |
| 216 | + |
| 217 | + 5. Conveying Modified Source Versions. |
| 218 | + |
| 219 | + You may convey a work based on the Program, or the modifications to |
| 220 | +produce it from the Program, in the form of source code under the |
| 221 | +terms of section 4, provided that you also meet all of these conditions: |
| 222 | + |
| 223 | + a) The work must carry prominent notices stating that you modified |
| 224 | + it, and giving a relevant date. |
| 225 | + |
| 226 | + b) The work must carry prominent notices stating that it is |
| 227 | + released under this License and any conditions added under section |
| 228 | + 7. This requirement modifies the requirement in section 4 to |
| 229 | + "keep intact all notices". |
| 230 | + |
| 231 | + c) You must license the entire work, as a whole, under this |
| 232 | + License to anyone who comes into possession of a copy. This |
| 233 | + License will therefore apply, along with any applicable section 7 |
| 234 | + additional terms, to the whole of the work, and all its parts, |
| 235 | + regardless of how they are packaged. This License gives no |
| 236 | + permission to license the work in any other way, but it does not |
| 237 | + invalidate such permission if you have separately received it. |
| 238 | + |
| 239 | + d) If the work has interactive user interfaces, each must display |
| 240 | + Appropriate Legal Notices; however, if the Program has interactive |
| 241 | + interfaces that do not display Appropriate Legal Notices, your |
| 242 | + work need not make them do so. |
| 243 | + |
| 244 | + A compilation of a covered work with other separate and independent |
| 245 | +works, which are not by their nature extensions of the covered work, |
| 246 | +and which are not combined with it such as to form a larger program, |
| 247 | +in or on a volume of a storage or distribution medium, is called an |
| 248 | +"aggregate" if the compilation and its resulting copyright are not |
| 249 | +used to limit the access or legal rights of the compilation's users |
| 250 | +beyond what the individual works permit. Inclusion of a covered work |
| 251 | +in an aggregate does not cause this License to apply to the other |
| 252 | +parts of the aggregate. |
| 253 | + |
| 254 | + 6. Conveying Non-Source Forms. |
| 255 | + |
| 256 | + You may convey a covered work in object code form under the terms |
| 257 | +of sections 4 and 5, provided that you also convey the |
| 258 | +machine-readable Corresponding Source under the terms of this License, |
| 259 | +in one of these ways: |
| 260 | + |
| 261 | + a) Convey the object code in, or embodied in, a physical product |
| 262 | + (including a physical distribution medium), accompanied by the |
| 263 | + Corresponding Source fixed on a durable physical medium |
| 264 | + customarily used for software interchange. |
| 265 | + |
| 266 | + b) Convey the object code in, or embodied in, a physical product |
| 267 | + (including a physical distribution medium), accompanied by a |
| 268 | + written offer, valid for at least three years and valid for as |
| 269 | + long as you offer spare parts or customer support for that product |
| 270 | + model, to give anyone who possesses the object code either (1) a |
| 271 | + copy of the Corresponding Source for all the software in the |
| 272 | + product that is covered by this License, on a durable physical |
| 273 | + medium customarily used for software interchange, for a price no |
| 274 | + more than your reasonable cost of physically performing this |
| 275 | + conveying of source, or (2) access to copy the |
| 276 | + Corresponding Source from a network server at no charge. |
| 277 | + |
| 278 | + c) Convey individual copies of the object code with a copy of the |
| 279 | + written offer to provide the Corresponding Source. This |
| 280 | + alternative is allowed only occasionally and noncommercially, and |
| 281 | + only if you received the object code with such an offer, in accord |
| 282 | + with subsection 6b. |
| 283 | + |
| 284 | + d) Convey the object code by offering access from a designated |
| 285 | + place (gratis or for a charge), and offer equivalent access to the |
| 286 | + Corresponding Source in the same way through the same place at no |
| 287 | + further charge. You need not require recipients to copy the |
| 288 | + Corresponding Source along with the object code. If the place to |
| 289 | + copy the object code is a network server, the Corresponding Source |
| 290 | + may be on a different server (operated by you or a third party) |
| 291 | + that supports equivalent copying facilities, provided you maintain |
| 292 | + clear directions next to the object code saying where to find the |
| 293 | + Corresponding Source. Regardless of what server hosts the |
| 294 | + Corresponding Source, you remain obligated to ensure that it is |
| 295 | + available for as long as needed to satisfy these requirements. |
| 296 | + |
| 297 | + e) Convey the object code using peer-to-peer transmission, provided |
| 298 | + you inform other peers where the object code and Corresponding |
| 299 | + Source of the work are being offered to the general public at no |
| 300 | + charge under subsection 6d. |
| 301 | + |
| 302 | + A separable portion of the object code, whose source code is excluded |
| 303 | +from the Corresponding Source as a System Library, need not be |
| 304 | +included in conveying the object code work. |
| 305 | + |
| 306 | + A "User Product" is either (1) a "consumer product", which means any |
| 307 | +tangible personal property which is normally used for personal, family, |
| 308 | +or household purposes, or (2) anything designed or sold for incorporation |
| 309 | +into a dwelling. In determining whether a product is a consumer product, |
| 310 | +doubtful cases shall be resolved in favor of coverage. For a particular |
| 311 | +product received by a particular user, "normally used" refers to a |
| 312 | +typical or common use of that class of product, regardless of the status |
| 313 | +of the particular user or of the way in which the particular user |
| 314 | +actually uses, or expects or is expected to use, the product. A product |
| 315 | +is a consumer product regardless of whether the product has substantial |
| 316 | +commercial, industrial or non-consumer uses, unless such uses represent |
| 317 | +the only significant mode of use of the product. |
| 318 | + |
| 319 | + "Installation Information" for a User Product means any methods, |
| 320 | +procedures, authorization keys, or other information required to install |
| 321 | +and execute modified versions of a covered work in that User Product from |
| 322 | +a modified version of its Corresponding Source. The information must |
| 323 | +suffice to ensure that the continued functioning of the modified object |
| 324 | +code is in no case prevented or interfered with solely because |
| 325 | +modification has been made. |
| 326 | + |
| 327 | + If you convey an object code work under this section in, or with, or |
| 328 | +specifically for use in, a User Product, and the conveying occurs as |
| 329 | +part of a transaction in which the right of possession and use of the |
| 330 | +User Product is transferred to the recipient in perpetuity or for a |
| 331 | +fixed term (regardless of how the transaction is characterized), the |
| 332 | +Corresponding Source conveyed under this section must be accompanied |
| 333 | +by the Installation Information. But this requirement does not apply |
| 334 | +if neither you nor any third party retains the ability to install |
| 335 | +modified object code on the User Product (for example, the work has |
| 336 | +been installed in ROM). |
| 337 | + |
| 338 | + The requirement to provide Installation Information does not include a |
| 339 | +requirement to continue to provide support service, warranty, or updates |
| 340 | +for a work that has been modified or installed by the recipient, or for |
| 341 | +the User Product in which it has been modified or installed. Access to a |
| 342 | +network may be denied when the modification itself materially and |
| 343 | +adversely affects the operation of the network or violates the rules and |
| 344 | +protocols for communication across the network. |
| 345 | + |
| 346 | + Corresponding Source conveyed, and Installation Information provided, |
| 347 | +in accord with this section must be in a format that is publicly |
| 348 | +documented (and with an implementation available to the public in |
| 349 | +source code form), and must require no special password or key for |
| 350 | +unpacking, reading or copying. |
| 351 | + |
| 352 | + 7. Additional Terms. |
| 353 | + |
| 354 | + "Additional permissions" are terms that supplement the terms of this |
| 355 | +License by making exceptions from one or more of its conditions. |
| 356 | +Additional permissions that are applicable to the entire Program shall |
| 357 | +be treated as though they were included in this License, to the extent |
| 358 | +that they are valid under applicable law. If additional permissions |
| 359 | +apply only to part of the Program, that part may be used separately |
| 360 | +under those permissions, but the entire Program remains governed by |
| 361 | +this License without regard to the additional permissions. |
| 362 | + |
| 363 | + When you convey a copy of a covered work, you may at your option |
| 364 | +remove any additional permissions from that copy, or from any part of |
| 365 | +it. (Additional permissions may be written to require their own |
| 366 | +removal in certain cases when you modify the work.) You may place |
| 367 | +additional permissions on material, added by you to a covered work, |
| 368 | +for which you have or can give appropriate copyright permission. |
| 369 | + |
| 370 | + Notwithstanding any other provision of this License, for material you |
| 371 | +add to a covered work, you may (if authorized by the copyright holders of |
| 372 | +that material) supplement the terms of this License with terms: |
| 373 | + |
| 374 | + a) Disclaiming warranty or limiting liability differently from the |
| 375 | + terms of sections 15 and 16 of this License; or |
| 376 | + |
| 377 | + b) Requiring preservation of specified reasonable legal notices or |
| 378 | + author attributions in that material or in the Appropriate Legal |
| 379 | + Notices displayed by works containing it; or |
| 380 | + |
| 381 | + c) Prohibiting misrepresentation of the origin of that material, or |
| 382 | + requiring that modified versions of such material be marked in |
| 383 | + reasonable ways as different from the original version; or |
| 384 | + |
| 385 | + d) Limiting the use for publicity purposes of names of licensors or |
| 386 | + authors of the material; or |
| 387 | + |
| 388 | + e) Declining to grant rights under trademark law for use of some |
| 389 | + trade names, trademarks, or service marks; or |
| 390 | + |
| 391 | + f) Requiring indemnification of licensors and authors of that |
| 392 | + material by anyone who conveys the material (or modified versions of |
| 393 | + it) with contractual assumptions of liability to the recipient, for |
| 394 | + any liability that these contractual assumptions directly impose on |
| 395 | + those licensors and authors. |
| 396 | + |
| 397 | + All other non-permissive additional terms are considered "further |
| 398 | +restrictions" within the meaning of section 10. If the Program as you |
| 399 | +received it, or any part of it, contains a notice stating that it is |
| 400 | +governed by this License along with a term that is a further |
| 401 | +restriction, you may remove that term. If a license document contains |
| 402 | +a further restriction but permits relicensing or conveying under this |
| 403 | +License, you may add to a covered work material governed by the terms |
| 404 | +of that license document, provided that the further restriction does |
| 405 | +not survive such relicensing or conveying. |
| 406 | + |
| 407 | + If you add terms to a covered work in accord with this section, you |
| 408 | +must place, in the relevant source files, a statement of the |
| 409 | +additional terms that apply to those files, or a notice indicating |
| 410 | +where to find the applicable terms. |
| 411 | + |
| 412 | + Additional terms, permissive or non-permissive, may be stated in the |
| 413 | +form of a separately written license, or stated as exceptions; |
| 414 | +the above requirements apply either way. |
| 415 | + |
| 416 | + 8. Termination. |
| 417 | + |
| 418 | + You may not propagate or modify a covered work except as expressly |
| 419 | +provided under this License. Any attempt otherwise to propagate or |
| 420 | +modify it is void, and will automatically terminate your rights under |
| 421 | +this License (including any patent licenses granted under the third |
| 422 | +paragraph of section 11). |
| 423 | + |
| 424 | + However, if you cease all violation of this License, then your |
| 425 | +license from a particular copyright holder is reinstated (a) |
| 426 | +provisionally, unless and until the copyright holder explicitly and |
| 427 | +finally terminates your license, and (b) permanently, if the copyright |
| 428 | +holder fails to notify you of the violation by some reasonable means |
| 429 | +prior to 60 days after the cessation. |
| 430 | + |
| 431 | + Moreover, your license from a particular copyright holder is |
| 432 | +reinstated permanently if the copyright holder notifies you of the |
| 433 | +violation by some reasonable means, this is the first time you have |
| 434 | +received notice of violation of this License (for any work) from that |
| 435 | +copyright holder, and you cure the violation prior to 30 days after |
| 436 | +your receipt of the notice. |
| 437 | + |
| 438 | + Termination of your rights under this section does not terminate the |
| 439 | +licenses of parties who have received copies or rights from you under |
| 440 | +this License. If your rights have been terminated and not permanently |
| 441 | +reinstated, you do not qualify to receive new licenses for the same |
| 442 | +material under section 10. |
| 443 | + |
| 444 | + 9. Acceptance Not Required for Having Copies. |
| 445 | + |
| 446 | + You are not required to accept this License in order to receive or |
| 447 | +run a copy of the Program. Ancillary propagation of a covered work |
| 448 | +occurring solely as a consequence of using peer-to-peer transmission |
| 449 | +to receive a copy likewise does not require acceptance. However, |
| 450 | +nothing other than this License grants you permission to propagate or |
| 451 | +modify any covered work. These actions infringe copyright if you do |
| 452 | +not accept this License. Therefore, by modifying or propagating a |
| 453 | +covered work, you indicate your acceptance of this License to do so. |
| 454 | + |
| 455 | + 10. Automatic Licensing of Downstream Recipients. |
| 456 | + |
| 457 | + Each time you convey a covered work, the recipient automatically |
| 458 | +receives a license from the original licensors, to run, modify and |
| 459 | +propagate that work, subject to this License. You are not responsible |
| 460 | +for enforcing compliance by third parties with this License. |
| 461 | + |
| 462 | + An "entity transaction" is a transaction transferring control of an |
| 463 | +organization, or substantially all assets of one, or subdividing an |
| 464 | +organization, or merging organizations. If propagation of a covered |
| 465 | +work results from an entity transaction, each party to that |
| 466 | +transaction who receives a copy of the work also receives whatever |
| 467 | +licenses to the work the party's predecessor in interest had or could |
| 468 | +give under the previous paragraph, plus a right to possession of the |
| 469 | +Corresponding Source of the work from the predecessor in interest, if |
| 470 | +the predecessor has it or can get it with reasonable efforts. |
| 471 | + |
| 472 | + You may not impose any further restrictions on the exercise of the |
| 473 | +rights granted or affirmed under this License. For example, you may |
| 474 | +not impose a license fee, royalty, or other charge for exercise of |
| 475 | +rights granted under this License, and you may not initiate litigation |
| 476 | +(including a cross-claim or counterclaim in a lawsuit) alleging that |
| 477 | +any patent claim is infringed by making, using, selling, offering for |
| 478 | +sale, or importing the Program or any portion of it. |
| 479 | + |
| 480 | + 11. Patents. |
| 481 | + |
| 482 | + A "contributor" is a copyright holder who authorizes use under this |
| 483 | +License of the Program or a work on which the Program is based. The |
| 484 | +work thus licensed is called the contributor's "contributor version". |
| 485 | + |
| 486 | + A contributor's "essential patent claims" are all patent claims |
| 487 | +owned or controlled by the contributor, whether already acquired or |
| 488 | +hereafter acquired, that would be infringed by some manner, permitted |
| 489 | +by this License, of making, using, or selling its contributor version, |
| 490 | +but do not include claims that would be infringed only as a |
| 491 | +consequence of further modification of the contributor version. For |
| 492 | +purposes of this definition, "control" includes the right to grant |
| 493 | +patent sublicenses in a manner consistent with the requirements of |
| 494 | +this License. |
| 495 | + |
| 496 | + Each contributor grants you a non-exclusive, worldwide, royalty-free |
| 497 | +patent license under the contributor's essential patent claims, to |
| 498 | +make, use, sell, offer for sale, import and otherwise run, modify and |
| 499 | +propagate the contents of its contributor version. |
| 500 | + |
| 501 | + In the following three paragraphs, a "patent license" is any express |
| 502 | +agreement or commitment, however denominated, not to enforce a patent |
| 503 | +(such as an express permission to practice a patent or covenant not to |
| 504 | +sue for patent infringement). To "grant" such a patent license to a |
| 505 | +party means to make such an agreement or commitment not to enforce a |
| 506 | +patent against the party. |
| 507 | + |
| 508 | + If you convey a covered work, knowingly relying on a patent license, |
| 509 | +and the Corresponding Source of the work is not available for anyone |
| 510 | +to copy, free of charge and under the terms of this License, through a |
| 511 | +publicly available network server or other readily accessible means, |
| 512 | +then you must either (1) cause the Corresponding Source to be so |
| 513 | +available, or (2) arrange to deprive yourself of the benefit of the |
| 514 | +patent license for this particular work, or (3) arrange, in a manner |
| 515 | +consistent with the requirements of this License, to extend the patent |
| 516 | +license to downstream recipients. "Knowingly relying" means you have |
| 517 | +actual knowledge that, but for the patent license, your conveying the |
| 518 | +covered work in a country, or your recipient's use of the covered work |
| 519 | +in a country, would infringe one or more identifiable patents in that |
| 520 | +country that you have reason to believe are valid. |
| 521 | + |
| 522 | + If, pursuant to or in connection with a single transaction or |
| 523 | +arrangement, you convey, or propagate by procuring conveyance of, a |
| 524 | +covered work, and grant a patent license to some of the parties |
| 525 | +receiving the covered work authorizing them to use, propagate, modify |
| 526 | +or convey a specific copy of the covered work, then the patent license |
| 527 | +you grant is automatically extended to all recipients of the covered |
| 528 | +work and works based on it. |
| 529 | + |
| 530 | + A patent license is "discriminatory" if it does not include within |
| 531 | +the scope of its coverage, prohibits the exercise of, or is |
| 532 | +conditioned on the non-exercise of one or more of the rights that are |
| 533 | +specifically granted under this License. You may not convey a covered |
| 534 | +work if you are a party to an arrangement with a third party that is |
| 535 | +in the business of distributing software, under which you make payment |
| 536 | +to the third party based on the extent of your activity of conveying |
| 537 | +the work, and under which the third party grants, to any of the |
| 538 | +parties who would receive the covered work from you, a discriminatory |
| 539 | +patent license (a) in connection with copies of the covered work |
| 540 | +conveyed by you (or copies made from those copies), or (b) primarily |
| 541 | +for and in connection with specific products or compilations that |
| 542 | +contain the covered work, unless you entered into that arrangement, |
| 543 | +or that patent license was granted, prior to 28 March 2007. |
| 544 | + |
| 545 | + Nothing in this License shall be construed as excluding or limiting |
| 546 | +any implied license or other defenses to infringement that may |
| 547 | +otherwise be available to you under applicable patent law. |
| 548 | + |
| 549 | + 12. No Surrender of Others' Freedom. |
| 550 | + |
| 551 | + If conditions are imposed on you (whether by court order, agreement or |
| 552 | +otherwise) that contradict the conditions of this License, they do not |
| 553 | +excuse you from the conditions of this License. If you cannot convey a |
| 554 | +covered work so as to satisfy simultaneously your obligations under this |
| 555 | +License and any other pertinent obligations, then as a consequence you may |
| 556 | +not convey it at all. For example, if you agree to terms that obligate you |
| 557 | +to collect a royalty for further conveying from those to whom you convey |
| 558 | +the Program, the only way you could satisfy both those terms and this |
| 559 | +License would be to refrain entirely from conveying the Program. |
| 560 | + |
| 561 | + 13. Use with the GNU Affero General Public License. |
| 562 | + |
| 563 | + Notwithstanding any other provision of this License, you have |
| 564 | +permission to link or combine any covered work with a work licensed |
| 565 | +under version 3 of the GNU Affero General Public License into a single |
| 566 | +combined work, and to convey the resulting work. The terms of this |
| 567 | +License will continue to apply to the part which is the covered work, |
| 568 | +but the special requirements of the GNU Affero General Public License, |
| 569 | +section 13, concerning interaction through a network will apply to the |
| 570 | +combination as such. |
| 571 | + |
| 572 | + 14. Revised Versions of this License. |
| 573 | + |
| 574 | + The Free Software Foundation may publish revised and/or new versions of |
| 575 | +the GNU General Public License from time to time. Such new versions will |
| 576 | +be similar in spirit to the present version, but may differ in detail to |
| 577 | +address new problems or concerns. |
| 578 | + |
| 579 | + Each version is given a distinguishing version number. If the |
| 580 | +Program specifies that a certain numbered version of the GNU General |
| 581 | +Public License "or any later version" applies to it, you have the |
| 582 | +option of following the terms and conditions either of that numbered |
| 583 | +version or of any later version published by the Free Software |
| 584 | +Foundation. If the Program does not specify a version number of the |
| 585 | +GNU General Public License, you may choose any version ever published |
| 586 | +by the Free Software Foundation. |
| 587 | + |
| 588 | + If the Program specifies that a proxy can decide which future |
| 589 | +versions of the GNU General Public License can be used, that proxy's |
| 590 | +public statement of acceptance of a version permanently authorizes you |
| 591 | +to choose that version for the Program. |
| 592 | + |
| 593 | + Later license versions may give you additional or different |
| 594 | +permissions. However, no additional obligations are imposed on any |
| 595 | +author or copyright holder as a result of your choosing to follow a |
| 596 | +later version. |
| 597 | + |
| 598 | + 15. Disclaimer of Warranty. |
| 599 | + |
| 600 | + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY |
| 601 | +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT |
| 602 | +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY |
| 603 | +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, |
| 604 | +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
| 605 | +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM |
| 606 | +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF |
| 607 | +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. |
| 608 | + |
| 609 | + 16. Limitation of Liability. |
| 610 | + |
| 611 | + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING |
| 612 | +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS |
| 613 | +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY |
| 614 | +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE |
| 615 | +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF |
| 616 | +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD |
| 617 | +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), |
| 618 | +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF |
| 619 | +SUCH DAMAGES. |
| 620 | + |
| 621 | + 17. Interpretation of Sections 15 and 16. |
| 622 | + |
| 623 | + If the disclaimer of warranty and limitation of liability provided |
| 624 | +above cannot be given local legal effect according to their terms, |
| 625 | +reviewing courts shall apply local law that most closely approximates |
| 626 | +an absolute waiver of all civil liability in connection with the |
| 627 | +Program, unless a warranty or assumption of liability accompanies a |
| 628 | +copy of the Program in return for a fee. |
| 629 | + |
| 630 | + END OF TERMS AND CONDITIONS |
| 631 | + |
| 632 | + How to Apply These Terms to Your New Programs |
| 633 | + |
| 634 | + If you develop a new program, and you want it to be of the greatest |
| 635 | +possible use to the public, the best way to achieve this is to make it |
| 636 | +free software which everyone can redistribute and change under these terms. |
| 637 | + |
| 638 | + To do so, attach the following notices to the program. It is safest |
| 639 | +to attach them to the start of each source file to most effectively |
| 640 | +state the exclusion of warranty; and each file should have at least |
| 641 | +the "copyright" line and a pointer to where the full notice is found. |
| 642 | + |
| 643 | + <one line to give the program's name and a brief idea of what it does.> |
| 644 | + Copyright (C) <year> <name of author> |
| 645 | + |
| 646 | + This program is free software: you can redistribute it and/or modify |
| 647 | + it under the terms of the GNU General Public License as published by |
| 648 | + the Free Software Foundation, either version 3 of the License, or |
| 649 | + (at your option) any later version. |
| 650 | + |
| 651 | + This program is distributed in the hope that it will be useful, |
| 652 | + but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 653 | + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 654 | + GNU General Public License for more details. |
| 655 | + |
| 656 | + You should have received a copy of the GNU General Public License |
| 657 | + along with this program. If not, see <http://www.gnu.org/licenses/>. |
| 658 | + |
| 659 | +Also add information on how to contact you by electronic and paper mail. |
| 660 | + |
| 661 | + If the program does terminal interaction, make it output a short |
| 662 | +notice like this when it starts in an interactive mode: |
| 663 | + |
| 664 | + <program> Copyright (C) <year> <name of author> |
| 665 | + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. |
| 666 | + This is free software, and you are welcome to redistribute it |
| 667 | + under certain conditions; type `show c' for details. |
| 668 | + |
| 669 | +The hypothetical commands `show w' and `show c' should show the appropriate |
| 670 | +parts of the General Public License. Of course, your program's commands |
| 671 | +might be different; for a GUI interface, you would use an "about box". |
| 672 | + |
| 673 | + You should also get your employer (if you work as a programmer) or school, |
| 674 | +if any, to sign a "copyright disclaimer" for the program, if necessary. |
| 675 | +For more information on this, and how to apply and follow the GNU GPL, see |
| 676 | +<http://www.gnu.org/licenses/>. |
| 677 | + |
| 678 | + The GNU General Public License does not permit incorporating your program |
| 679 | +into proprietary programs. If your program is a subroutine library, you |
| 680 | +may consider it more useful to permit linking proprietary applications with |
| 681 | +the library. If this is what you want to do, use the GNU Lesser General |
| 682 | +Public License instead of this License. But first, please read |
| 683 | +<http://www.gnu.org/philosophy/why-not-lgpl.html>. |
\ No newline at end of file |
Property changes on: tags/extensions/IncludeWP/REL_0_1/COPYING |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 684 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/api/ApiIncludeWP.php |
— | — | @@ -0,0 +1,119 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * API module to change wikitext into plain text by removing stuff. |
| 6 | + * |
| 7 | + * @since 0.1 |
| 8 | + * |
| 9 | + * @file ApiIncludeWP.php |
| 10 | + * @ingroup IncludeWP |
| 11 | + * |
| 12 | + * @licence GNU GPL v3 or later |
| 13 | + * |
| 14 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 15 | + */ |
| 16 | +class ApiIncludeWP extends ApiBase { |
| 17 | + |
| 18 | + |
| 19 | + public function __construct( $main, $action ) { |
| 20 | + parent::__construct( $main, $action ); |
| 21 | + } |
| 22 | + |
| 23 | + public function execute() { |
| 24 | + global $egPushLoginUser, $egPushLoginPass, $egPushLoginUsers, $egPushLoginPasswords; |
| 25 | + |
| 26 | + $params = $this->extractRequestParams(); |
| 27 | + |
| 28 | + if ( !isset( $params['text'] ) ) { |
| 29 | + $this->dieUsageMsg( array( 'missingparam', 'text' ) ); |
| 30 | + } |
| 31 | + |
| 32 | + if ( !isset( $params['pagename'] ) ) { |
| 33 | + $this->dieUsageMsg( array( 'missingparam', 'pagename' ) ); |
| 34 | + } |
| 35 | + |
| 36 | + $plaintext = $params['text']; |
| 37 | + |
| 38 | + // Remove comments. |
| 39 | + $plaintext = preg_replace( '/\\<!--([^(--\\>)]*)--\\>/', '', $plaintext ); |
| 40 | + |
| 41 | + // Remove ref tags. |
| 42 | + $plaintext = preg_replace( '/<ref[^>]*\>(.*?)<\/ref>/si', '', $plaintext ); |
| 43 | + |
| 44 | + // Replace both internal and external wiki links with their plain text. |
| 45 | + $plaintext = preg_replace( '/\[http(?:s)?:\/\/\S*\s([^\]]*)]/', '$1', $plaintext ); |
| 46 | + $plaintext = preg_replace( '/http(?:s)?:\/\/\S*/', '$1', $plaintext ); |
| 47 | + $plaintext = preg_replace( '/\[\[(?!(Category|Image|File|[^\s]{2,5}:))[^\|\]]*\|([^\]]*)\]\]/', '$2', $plaintext ); |
| 48 | + $plaintext = preg_replace( '/\[\[((?!(Category|Image|File|[^\s]{2,5}:))[^\]]*)\]\]/', '$1', $plaintext ); |
| 49 | + |
| 50 | + // Remove categories and files (images). |
| 51 | + $plaintext = preg_replace( '/\[\[(Category|File|Image|):[^\]]+\]\]/', '', $plaintext ); |
| 52 | + |
| 53 | + // Remove inter language links. |
| 54 | + $plaintext = preg_replace( '/\[\[[^\s]{2,5}:[^\s][^\]]+\]\]/', '', $plaintext ); |
| 55 | + |
| 56 | + for( $i = 3 ; $i > 0; $i-- ) { |
| 57 | + $plaintext = preg_replace( "/\{\{(?:[^\}\{]*)?\}\}/", '', $plaintext ); |
| 58 | + } |
| 59 | + |
| 60 | + // Render the wikitext |
| 61 | + $parser = new Parser(); |
| 62 | + $options = new ParserOptions(); |
| 63 | + $options->setEditSection( false ); |
| 64 | + $plaintext = $parser->parse( trim( $plaintext ), Title::newFromText( $params['pagename'] ), $options )->getText(); |
| 65 | + |
| 66 | + // Remove excess whitespace |
| 67 | + $plaintext = preg_replace( '/\s\s+/', ' ', $plaintext ); |
| 68 | + $plaintext = str_replace( "<p><br />\n</p>", '', $plaintext ); |
| 69 | + |
| 70 | + $this->getResult()->addValue( |
| 71 | + null, |
| 72 | + null, |
| 73 | + $plaintext |
| 74 | + ); |
| 75 | + } |
| 76 | + |
| 77 | + public function getAllowedParams() { |
| 78 | + return array( |
| 79 | + 'text' => array( |
| 80 | + ApiBase::PARAM_TYPE => 'string', |
| 81 | + //ApiBase::PARAM_REQUIRED => true, |
| 82 | + ), |
| 83 | + 'pagename' => array( |
| 84 | + ApiBase::PARAM_TYPE => 'string', |
| 85 | + //ApiBase::PARAM_REQUIRED => true, |
| 86 | + ), |
| 87 | + ); |
| 88 | + } |
| 89 | + |
| 90 | + public function getParamDescription() { |
| 91 | + return array( |
| 92 | + 'text' => 'The wikitext', |
| 93 | + 'pagename' => 'Name of the page' |
| 94 | + ); |
| 95 | + } |
| 96 | + |
| 97 | + public function getDescription() { |
| 98 | + return array( |
| 99 | + 'Turns wikitext into plain text by removing stuff.' |
| 100 | + ); |
| 101 | + } |
| 102 | + |
| 103 | + public function getPossibleErrors() { |
| 104 | + return array_merge( parent::getPossibleErrors(), array( |
| 105 | + array( 'missingparam', 'text' ), |
| 106 | + array( 'missingparam', 'pagename' ), |
| 107 | + ) ); |
| 108 | + } |
| 109 | + |
| 110 | + protected function getExamples() { |
| 111 | + return array( |
| 112 | + 'api.php?action=includewp&text=Some [[wikitext]] be here&pagename=Foobar', |
| 113 | + ); |
| 114 | + } |
| 115 | + |
| 116 | + public function getVersion() { |
| 117 | + return __CLASS__ . ': $Id$'; |
| 118 | + } |
| 119 | + |
| 120 | +} |
Property changes on: tags/extensions/IncludeWP/REL_0_1/api/ApiIncludeWP.php |
___________________________________________________________________ |
Added: svn:keywords |
1 | 121 | + Id |
Added: svn:eol-style |
2 | 122 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/ext.incwp.js |
— | — | @@ -0,0 +1,180 @@ |
| 2 | +/** |
| 3 | + * JavasSript for the IncludeWP extension. |
| 4 | + * @see http://www.mediawiki.org/wiki/Extension:Push |
| 5 | + * |
| 6 | + * @author Jeroen De Dauw <jeroendedauw at gmail dot com> |
| 7 | + */ |
| 8 | + |
| 9 | +(function($) { $( document ).ready( function() { |
| 10 | + |
| 11 | + // Compatibility with pre-RL code. |
| 12 | + // Messages will have been loaded into wgPushMessages. |
| 13 | + if ( typeof mediaWiki === 'undefined' ) { |
| 14 | + mediaWiki = new Object(); |
| 15 | + |
| 16 | + mediaWiki.msg = function() { |
| 17 | + message = window.wgIncWPMessages[arguments[0]]; |
| 18 | + |
| 19 | + for ( var i = arguments.length - 1; i > 0; i-- ) { |
| 20 | + message = message.replace( '$' + i, arguments[i] ); |
| 21 | + } |
| 22 | + |
| 23 | + return message; |
| 24 | + } |
| 25 | + } |
| 26 | + |
| 27 | + // Variable to store the HTML of rendered pages in. |
| 28 | + var pages = {}; |
| 29 | + |
| 30 | + // Find all inclusion requests and obtain the wikitext from the remote wiki. |
| 31 | + $.each($(".includewp-loading"), function(i,v) { |
| 32 | + loadPage( $(v) ); |
| 33 | + }); |
| 34 | + |
| 35 | + /** |
| 36 | + * Make a JSONP call to the remote wiki to obtain the page wikitext. |
| 37 | + * |
| 38 | + * @param jQuery sender |
| 39 | + */ |
| 40 | + function loadPage( sender ) { |
| 41 | + $.getJSON( |
| 42 | + window.wgIncWPWikis[sender.attr( 'wiki' )].path + '/api.php?callback=?', |
| 43 | + { |
| 44 | + 'action': 'query', |
| 45 | + 'format': 'json', |
| 46 | + 'prop': 'revisions', |
| 47 | + 'rvprop':'timestamp|content', |
| 48 | + 'titles': sender.attr( 'page' ), |
| 49 | + 'redirects': 1 |
| 50 | + }, |
| 51 | + function( data ) { |
| 52 | + if ( data.query ) { |
| 53 | + for ( pageWikiID in data.query.pages ) { |
| 54 | + getPlaintext( sender, data.query.pages[pageWikiID].revisions[0]["*"] ); |
| 55 | + break; |
| 56 | + } |
| 57 | + } |
| 58 | + else { |
| 59 | + sender.html( '<b>' + mediaWiki.msg( 'includewp-loading-failed' ) + '</b>' ); |
| 60 | + } |
| 61 | + } |
| 62 | + ); |
| 63 | + } |
| 64 | + |
| 65 | + /** |
| 66 | + * Send the obtained wikitext to the local API to strip out stuff we |
| 67 | + * don't want (such as external links and infoboxes), and parse the |
| 68 | + * remainder to HTML. |
| 69 | + * |
| 70 | + * @param jQuery sender |
| 71 | + * @param string rawWikiText |
| 72 | + */ |
| 73 | + function getPlaintext( sender, rawWikiText ) { |
| 74 | + var pageId = sender.attr( 'pageid' ); |
| 75 | + var pageName = sender.attr( 'page' ); |
| 76 | + |
| 77 | + $.post( |
| 78 | + wgScriptPath + '/api.php', |
| 79 | + { |
| 80 | + 'action': 'includewp', |
| 81 | + 'format': 'json', |
| 82 | + 'text': rawWikiText, |
| 83 | + 'pagename': pageName |
| 84 | + }, |
| 85 | + function( data ) { |
| 86 | + var plainText = data.shift(); |
| 87 | + if ( plainText ) { |
| 88 | + sender.slideUp( 'slow' ); |
| 89 | + pages[pageName] = plainText; |
| 90 | + showPageFragment( pageName, pageId ); |
| 91 | + showCopyright( pageName, pageId ); |
| 92 | + } |
| 93 | + else { |
| 94 | + sender.html( '<b>' + mediaWiki.msg( 'includewp-loading-failed' ) + '</b>' ); |
| 95 | + } |
| 96 | + }, |
| 97 | + 'json' |
| 98 | + ); |
| 99 | + } |
| 100 | + |
| 101 | + /** |
| 102 | + * Show a fragment (number of paragraphes) of the text, and display a link |
| 103 | + * that will show the full page. |
| 104 | + * |
| 105 | + * @param string pageName |
| 106 | + * @param integer pageId |
| 107 | + */ |
| 108 | + function showPageFragment( pageName, pageId ) { |
| 109 | + var paragraphs = getPageParagraphs( pageName, $( '#includewp-loading-' + pageId ).attr( 'paragraphs' ) ); |
| 110 | + |
| 111 | + $( '#includewp-article-' + pageId ).html( paragraphs === false ? pages[pageName] : paragraphs ); |
| 112 | + |
| 113 | + // Remove any possible TOC, as we don't want it to show up for page fragments. |
| 114 | + $('.toc').remove(); |
| 115 | + |
| 116 | + if ( paragraphs !== false ) { |
| 117 | + $( '#includewp-article-' + pageId ).append( $( '<a />' ).text( mediaWiki.msg( 'includewp-show-full-page' ) ) |
| 118 | + .addClass( 'incwp-more' ).attr( 'href', '#' ).click( function() { showFullPage( pageName, pageId ) } ) ); |
| 119 | + } |
| 120 | + } |
| 121 | + |
| 122 | + /** |
| 123 | + * Returns the text of the first x paragraphes. |
| 124 | + * |
| 125 | + * @param string pageName |
| 126 | + * @param integer paragraphAmount |
| 127 | + * |
| 128 | + * @return string |
| 129 | + */ |
| 130 | + function getPageParagraphs( pageName, paragraphAmount ) { |
| 131 | + var textSize = 0; |
| 132 | + var pSize = 4; |
| 133 | + |
| 134 | + while ( paragraphAmount-- > 0 ) { |
| 135 | + var paragraphEnd = pages[pageName].substr( textSize ).search( '</p>' ); |
| 136 | + |
| 137 | + if ( paragraphEnd == -1 ) { |
| 138 | + return false; |
| 139 | + } |
| 140 | + |
| 141 | + textSize += paragraphEnd + pSize; |
| 142 | + } |
| 143 | + |
| 144 | + return pages[pageName].substr( 0, textSize ); |
| 145 | + } |
| 146 | + |
| 147 | + /** |
| 148 | + * Show the full page, and a link to only show the fragment. |
| 149 | + * |
| 150 | + * @param string pageName |
| 151 | + * @param integer pageId |
| 152 | + */ |
| 153 | + function showFullPage( pageName, pageId ) { |
| 154 | + $( '#includewp-article-' + pageId ).html( pages[pageName] ) |
| 155 | + .append( $( '<a />' ).text( mediaWiki.msg( 'includewp-show-fragment' ) ) |
| 156 | + .addClass( 'incwp-less' ).attr( 'href', '#' ).click( function() { showPageFragment( pageName, pageId ) } ) ); |
| 157 | + } |
| 158 | + |
| 159 | + /** |
| 160 | + * Adds a copyright disclaimer underneat the actual article. |
| 161 | + * |
| 162 | + * @param string pageName |
| 163 | + * @param integer pageId |
| 164 | + */ |
| 165 | + function showCopyright( pageName, pageId ) { |
| 166 | + var wiki = window.wgIncWPWikis[$( '#includewp-loading-' + pageId ).attr( 'wiki' )]; |
| 167 | + |
| 168 | + var licenceHtml = mediaWiki.msg( |
| 169 | + 'includewp-licence-notice', |
| 170 | + wiki.name, |
| 171 | + wiki.url + '/' + pageName, |
| 172 | + pageName, |
| 173 | + wiki.licenceurl, |
| 174 | + wiki.licencename, |
| 175 | + wiki.url + '/' + pageName + '?action=history' |
| 176 | + ); |
| 177 | + |
| 178 | + $( '#includewp-copyright-' + pageId ).html( licenceHtml ); |
| 179 | + } |
| 180 | + |
| 181 | +} ); })(jQuery); |
\ No newline at end of file |
Property changes on: tags/extensions/IncludeWP/REL_0_1/ext.incwp.js |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 182 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/README |
— | — | @@ -0,0 +1,10 @@ |
| 2 | +These is the readme file for the Include WP extension. |
| 3 | + |
| 4 | +Extension page on mediawiki.org: http://www.mediawiki.org/wiki/Extension:Include_WP |
| 5 | +Latest version of the readme file: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/IncludeWP/README?view=co |
| 6 | + |
| 7 | +== About == |
| 8 | + |
| 9 | +IncludeWP is a lightweight extension for including Wikipedia content into your wiki. |
| 10 | +It also allows for including content from other MediaWiki wikis. |
| 11 | + |
Property changes on: tags/extensions/IncludeWP/REL_0_1/README |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 12 | + native |
Index: tags/extensions/IncludeWP/REL_0_1/IncludeWP.i18n.php |
— | — | @@ -0,0 +1,193 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * Internationalization file for the Include WP extension. |
| 6 | + * |
| 7 | + * @since 0.1 |
| 8 | + * |
| 9 | + * @file IncludeWP.i18n.php |
| 10 | + * @ingroup IncludeWP |
| 11 | + * |
| 12 | + * @licence GNU GPL v3 or later |
| 13 | + * |
| 14 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 15 | + */ |
| 16 | + |
| 17 | +$messages = array(); |
| 18 | + |
| 19 | +/** English |
| 20 | + * @author Jeroen De Dauw |
| 21 | + */ |
| 22 | +$messages['en'] = array( |
| 23 | + 'includewp-desc' => 'IncludeWP is a lightweight extension for including Wikipedia content', |
| 24 | + |
| 25 | + 'includewp-loading-page' => 'Loading page...', |
| 26 | + 'includewp-show-full-page' => 'Show full page', |
| 27 | + 'includewp-show-fragment' => 'Only show the first paragraph', |
| 28 | + 'includewp-loading-failed' => 'Failed to load page.', |
| 29 | + |
| 30 | + 'includewp-licence-notice' => 'The above content comes from the $1 page <a href="$2">$3</a> licenced under the <a href="$4">$5</a>. A full list of authors can be found <a href="$6">here</a>.', |
| 31 | + |
| 32 | + 'includewp-parserhook-desc' => 'Parser hook that allows displaying content of a Wikipedia page.', |
| 33 | + 'includewp-include-par-page' => 'The name of the (remote) page you want to display.', |
| 34 | + 'includewp-include-par-wiki' => 'The name of the wiki you want to pull content from. Needs to be one of the allowed wikis, by default only wikipedia.', |
| 35 | + 'includewp-include-par-paragraphs' => 'The number of paragraphs you want to initially display.', |
| 36 | + 'includewp-include-par-height' => 'The max height (in px) of the div into which the content is loaded. Set to 0 for no limit.', |
| 37 | +); |
| 38 | + |
| 39 | +/** Message documentation (Message documentation) |
| 40 | + * @author Kghbln |
| 41 | + */ |
| 42 | +$messages['qqq'] = array( |
| 43 | + 'includewp-licence-notice' => '$1 stands for the sitename', |
| 44 | +); |
| 45 | + |
| 46 | +/** Afrikaans (Afrikaans) |
| 47 | + * @author Naudefj |
| 48 | + */ |
| 49 | +$messages['af'] = array( |
| 50 | + 'includewp-desc' => "IncludeWP is 'n liggewig uitbreiding om Wikipedia inhoud by u wiki in te sluit", |
| 51 | + 'includewp-loading-page' => 'Laai bladsy...', |
| 52 | + 'includewp-show-full-page' => 'Wys volledige bladsy', |
| 53 | + 'includewp-loading-failed' => 'Laai van bladsy het gefaal.', |
| 54 | + 'includewp-licence-notice' => 'Bostaande inhoud kom vanaf die $1-artikel <a href="$2">$3</a> gelisensieerd onder die <a href="$4">$5</a>. \'n Volledige lys van outeurs is <a href="$6">hier</a> beskikbaar.', |
| 55 | + 'includewp-parserhook-desc' => 'Ontleder-hoek wat die vertoon van inhoud vanuit Wikipedia-artikels moontlik maak.', |
| 56 | + 'includewp-include-par-page' => 'Die naam van die (afgeleë) bladsy om te vertoon.', |
| 57 | +); |
| 58 | + |
| 59 | +/** Belarusian (Taraškievica orthography) (Беларуская (тарашкевіца)) |
| 60 | + * @author EugeneZelenko |
| 61 | + * @author Jim-by |
| 62 | + */ |
| 63 | +$messages['be-tarask'] = array( |
| 64 | + 'includewp-desc' => 'IncludeWP — невялікае пашырэньне для ўключэньня зьместу Вікіпэдыі', |
| 65 | + 'includewp-loading-page' => 'Загрузка старонкі…', |
| 66 | + 'includewp-show-full-page' => 'Паказаць старонку цалкам', |
| 67 | + 'includewp-show-fragment' => 'Паказаць толькі першы параграф', |
| 68 | + 'includewp-loading-failed' => 'Немагчыма загрузіць старонку.', |
| 69 | + 'includewp-licence-notice' => 'Пададзены вышэй зьмест паходзіць са старонкі $1 <a href="$2">$3</a> на ўмовах ліцэнзіі <a href="$4">$5</a>. Поўны сьпіс аўтараў можна знайсьці <a href="$6">тут</a>.', |
| 70 | + 'includewp-parserhook-desc' => 'Працэдура-перахопнік парсэру, які дазваляе паказваць зьмест старонкі Вікіпэдыі.', |
| 71 | + 'includewp-include-par-page' => 'Назва (аддаленай) старонкі, якую Вы жадаеце паказаць.', |
| 72 | +); |
| 73 | + |
| 74 | +/** German (Deutsch) |
| 75 | + * @author Kghbln |
| 76 | + */ |
| 77 | +$messages['de'] = array( |
| 78 | + 'includewp-desc' => 'Ermöglicht das Einbeziehen von Inhalten der Wikipedia in ein Wiki', |
| 79 | + 'includewp-loading-page' => 'Lade Seite …', |
| 80 | + 'includewp-show-full-page' => 'Seite vollständig anzeigen', |
| 81 | + 'includewp-show-fragment' => 'Lediglich den ersten Absatz anzeigen', |
| 82 | + 'includewp-loading-failed' => 'Das Laden der Seite ist gescheitert.', |
| 83 | + 'includewp-licence-notice' => 'Der obige Inhalt stammt vom $1-Artikel <a href="$2">„$3“</a>, der gemäß <a href="$4">$5</a> lizenziert wurde. Eine vollständige Liste der Autoren ist <a href="$6">hier</a> verfügbar.', |
| 84 | + 'includewp-parserhook-desc' => 'Parserhook der das Anzeigen von Inhalten eines Wikipedia-Artikels ermöglicht.', |
| 85 | + 'includewp-include-par-page' => 'Der Name der Seite, die angezeigt werden soll.', |
| 86 | +); |
| 87 | + |
| 88 | +/** Hebrew (עברית) |
| 89 | + * @author Amire80 |
| 90 | + */ |
| 91 | +$messages['he'] = array( |
| 92 | + 'includewp-desc' => 'IncludeWP היא הרחבה פשוטה להכללת תוכן של ויקיפדיה', |
| 93 | + 'includewp-loading-page' => 'הדף בטעינה...', |
| 94 | + 'includewp-show-full-page' => 'להציג דף מלא', |
| 95 | + 'includewp-show-fragment' => 'להציג רק את הפסקה הראשונה', |
| 96 | + 'includewp-loading-failed' => 'טעינת הדף נכשלה.', |
| 97 | + 'includewp-licence-notice' => 'התוכן לעיל מגיע מהדף <a href="$2">$3</a> באתר $1, והוא מתפרסם ברישיון <a href="$4">$5</a>. רשימה מלאה של מחבריו נמצאת <a href="$6">כאן</a>.', |
| 98 | + 'includewp-parserhook-desc' => 'וו מפענח שמאפשר הצגת תוכן של דף ויקיפדיה.', |
| 99 | + 'includewp-include-par-page' => 'שם הדף המרוחק שאתם רוצים להציג.', |
| 100 | +); |
| 101 | + |
| 102 | +/** Upper Sorbian (Hornjoserbsce) |
| 103 | + * @author Michawiki |
| 104 | + */ |
| 105 | +$messages['hsb'] = array( |
| 106 | + 'includewp-desc' => 'IncludeWP je jednore rozšěrjenje za zapřijimowanje wobsaha Wikipedije', |
| 107 | + 'includewp-loading-page' => 'Strona so začituje...', |
| 108 | + 'includewp-show-full-page' => 'Dospołnu stronu pokazać', |
| 109 | + 'includewp-show-fragment' => 'Jenož prěni wotstawk pokazać', |
| 110 | + 'includewp-loading-failed' => 'Začitowanje strony je so njeporadźiło.', |
| 111 | + 'includewp-licence-notice' => 'Wyši wobsah pochadźa ze strony $1 <a href="$2">$3</a> steji pod licencu <a href="$4">$5</a>. Dospołna lisćina awtorow je <a href="$6">tu</a> k dispoziciji.', |
| 112 | + 'includewp-parserhook-desc' => 'Parserowa hóčka, kotraž zwobraznjenje wobsaha strony Wikipedije zmóžnja.', |
| 113 | + 'includewp-include-par-page' => 'Mjeno strony, kotraž ma so zwobraznić.', |
| 114 | +); |
| 115 | + |
| 116 | +/** Interlingua (Interlingua) |
| 117 | + * @author McDutchie |
| 118 | + */ |
| 119 | +$messages['ia'] = array( |
| 120 | + 'includewp-desc' => 'IncludeWP es un extension legier pro includer contento de Wikipedia', |
| 121 | + 'includewp-loading-page' => 'Carga pagina…', |
| 122 | + 'includewp-show-full-page' => 'Monstra pagina complete', |
| 123 | + 'includewp-show-fragment' => 'Monstrar solmente le prime paragrapho', |
| 124 | + 'includewp-loading-failed' => 'Cargamento del pagina fallite.', |
| 125 | + 'includewp-licence-notice' => 'Le contento hic supra proveni del pagina <a href="$2">$3</a> de $1, e es disponibile sub licentia <a href="$4">$5</a>. Un lista complete de autores se trova <a href="$6">hic</a>.', |
| 126 | + 'includewp-parserhook-desc' => 'Uncino del analysator syntactic que permitte presentar contento de un pagina de Wikipedia.', |
| 127 | + 'includewp-include-par-page' => 'Le nomine del pagina (remote) a presentar.', |
| 128 | +); |
| 129 | + |
| 130 | +/** Luxembourgish (Lëtzebuergesch) |
| 131 | + * @author Robby |
| 132 | + */ |
| 133 | +$messages['lb'] = array( |
| 134 | + 'includewp-desc' => 'IncludeWP ass eng einfach Erweiderung fir Wikipedia Inhalt anzebannen', |
| 135 | + 'includewp-loading-page' => "D'Säit gëtt gelueden...", |
| 136 | + 'includewp-show-full-page' => 'Säit ganz weisen', |
| 137 | + 'includewp-show-fragment' => 'Nëmmen den éischte Abschnitt weisen', |
| 138 | + 'includewp-loading-failed' => "D'Säit konnt net geluede ginn.", |
| 139 | + 'includewp-include-par-page' => 'Den Numm vun der Säit (vun der anerer Wiki), déi Dir wëllt gewise kréien.', |
| 140 | +); |
| 141 | + |
| 142 | +/** Macedonian (Македонски) |
| 143 | + * @author Bjankuloski06 |
| 144 | + */ |
| 145 | +$messages['mk'] = array( |
| 146 | + 'includewp-desc' => 'IncludeWP е едноставен додаток за вклучување на содржини од Википедија', |
| 147 | + 'includewp-loading-page' => 'Ја вчитувам страницата...', |
| 148 | + 'includewp-show-full-page' => 'Прикажи цела страница', |
| 149 | + 'includewp-show-fragment' => 'Прикажи го само првиот пасус', |
| 150 | + 'includewp-loading-failed' => 'Не успеав да ја вчитам страницата.', |
| 151 | + 'includewp-licence-notice' => 'Горенаведената содржина е преземена од страницата $1 <a href="$2">$3</a> која е под лиценцата <a href="$4">$5</a>. Целосен список на автори ќе најдете <a href="$6">тука</a>.', |
| 152 | + 'includewp-parserhook-desc' => 'Парсерската кука што овозможува секогаш да се прикажува содржина на страница од Википедија.', |
| 153 | + 'includewp-include-par-page' => 'Името на онаа (далечинска) страница што сакате да се прикаже.', |
| 154 | +); |
| 155 | + |
| 156 | +/** Portuguese (Português) |
| 157 | + * @author Hamilton Abreu |
| 158 | + */ |
| 159 | +$messages['pt'] = array( |
| 160 | + 'includewp-desc' => 'IncludeWP é uma extensão ligeira para inclusão de conteúdo da Wikipédia', |
| 161 | + 'includewp-loading-page' => 'A carregar a página...', |
| 162 | + 'includewp-show-full-page' => 'Mostrar a página inteira', |
| 163 | + 'includewp-show-fragment' => 'Mostrar só o primeiro parágrafo', |
| 164 | + 'includewp-loading-failed' => 'Não foi possível carregar a página.', |
| 165 | + 'includewp-licence-notice' => 'O conteúdo acima provém da página <a href="$2">$3</a> da $1, licenciada com a <a href="$4">$5</a>. Pode encontrar uma lista completa dos autores <a href="$6">aqui</a>.', |
| 166 | + 'includewp-parserhook-desc' => 'Hook do analisador sintáctico para apresentar o conteúdo de uma página da Wikipédia.', |
| 167 | + 'includewp-include-par-page' => 'O nome da página (remota) que pretende apresentar.', |
| 168 | +); |
| 169 | + |
| 170 | +/** Russian (Русский) |
| 171 | + * @author Александр Сигачёв |
| 172 | + */ |
| 173 | +$messages['ru'] = array( |
| 174 | + 'includewp-desc' => 'IncludeWP — это лёгкое расширение для включения содержания Википедии', |
| 175 | + 'includewp-loading-page' => 'Загрузка страницы…', |
| 176 | + 'includewp-show-full-page' => 'Показать полную страницу', |
| 177 | + 'includewp-show-fragment' => 'Показывать только первый абзац', |
| 178 | + 'includewp-loading-failed' => 'Ошибка загрузки страницы.', |
| 179 | + 'includewp-licence-notice' => 'Приведённый выше материал получен со страницы <a href="$2">$3</a> проекта $1, он доступен на условиях <a href="$4">$5</a>. Полный список авторов можно найти <a href="$6">здесь</a>.', |
| 180 | + 'includewp-parserhook-desc' => 'Обработчик парсера, позволяющий отображать содержание Википедии.', |
| 181 | + 'includewp-include-par-page' => 'Имя страницы (в другом проекте), которую вы хотите отобразить.', |
| 182 | +); |
| 183 | + |
| 184 | +/** Ukrainian (Українська) |
| 185 | + * @author Тест |
| 186 | + */ |
| 187 | +$messages['uk'] = array( |
| 188 | + 'includewp-loading-page' => 'Завантаження сторінки...', |
| 189 | + 'includewp-show-full-page' => 'Показати всю сторінку', |
| 190 | + 'includewp-show-fragment' => 'Показувати лише перший абзац', |
| 191 | + 'includewp-loading-failed' => 'Не вдалося завантажити сторінку.', |
| 192 | + 'includewp-include-par-page' => 'Назва (віддаленої) сторінки, яку ви хочете показати.', |
| 193 | +); |
| 194 | + |
Property changes on: tags/extensions/IncludeWP/REL_0_1/IncludeWP.i18n.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 195 | + native |