Move to namespace specific svg annotations #1

Merged
jgeorgi merged 5 commits from nsannot into main 2026-05-19 22:28:12 +00:00
6 changed files with 189 additions and 193 deletions

View File

@@ -1,21 +1,38 @@
{ {
"name": "AnatImageViewer", "name": "AnnotatedImages",
"author": "Justin Georgi", "author": "Justin Georgi",
"url": "https://gitea.azgeorgis.net/jgeorgi/AnatImageViewer", "url": "https://gitea.azgeorgis.net/jgeorgi/AnatImageViewer",
"description": "This extension allows the creation of .an pages in the Files namespace which will be annotated images.", "description": "This extension allows the creation of pages in the Annotation namespace which will create annotated images.",
"version": "0.0.1", "version": "0.0.1",
"license-name": "MIT", "license-name": "MIT",
"type": "media", "type": "media",
"manifest_version": 1, "manifest_version": 1,
"requires": {
"MediaWiki": ">= 1.39.0"
},
"namespaces": [
{
"id": 2218,
"constant": "NS_AV_ANNOT",
"name": "Annotation",
"protection": "annotations-edit",
"subpages": false,
"content": false,
"defaultcontentmodel": "annotation"
},
{
"id": 2219,
"constant": "NS_AV_ANNOT_TALK",
"name": "Annotation_talk",
"subpages": true,
"content": false,
"defaultcontentmodel": "wikitext"
}
],
"AutoloadNamespaces": { "AutoloadNamespaces": {
"MediaWiki\\Extension\\AnatImageViewer\\": "includes/" "MediaWiki\\Extension\\AnatImageViewer\\": "includes/"
}, },
"MediaHandlers": { "ContentHandlers": {
"image/annotation": "MediaWiki\\Extension\\AnatImageViewer\\AnatImageHandler" "annotation": "MediaWiki\\Extension\\AnatImageViewer\\AnnotationHandler"
},
"Hooks": {
"MimeMagicInit": "MediaWiki\\Extension\\AnatImageViewer\\AnatImageHooks::onMimeMagicInit",
"MimeMagicImproveFromExtension": "MediaWiki\\Extension\\AnatImageViewer\\AnatImageHooks::onMimeMagicImproveFromExtension",
"ParserFirstCallInit": "MediaWiki\\Extension\\AnatImageViewer\\AnatImageHooks::onParserFirstCallInit"
} }
} }

View File

@@ -1,63 +0,0 @@
<?php
namespace MediaWiki\Extension\AnatImageViewer;
use ImageHandler;
use BitmapMetadataHandler;
use Html;
class AnatImageHandler extends ImageHandler {
private const ANNOT_VERSION = '0.1';
/**
* Model cannot be displayed directly in a browser but can be rendered.
*
* @param File $file
* @return bool
*/
public function mustRender( $file ) {
return true;
}
/**
* Model can be rendered.
*
* @param File $file
* @return bool
*/
public function canRender( $file ) {
return true;
}
/**
* Get a MediaTransformOutput object representing the transformed output.
*
* @param File $image
* @param string $dstPath Filesystem destination path
* @param string $dstUrl Destination URL to use in output HTML
* @param array $params Arbitrary set of parameters validated by $this->validateParam()
* @param int $flags A bitfield, may contain self::TRANSFORM_LATER
* @return MediaTransformOutput
*/
public function doTransform($image, $dstPath, $dstUrl, $params, $flags = 0) {
return new AnatImageTransformOutput($image, $params);
}
/**
* Small helper function to display information on the browser console
*
* Usage:
* echo '<script>';
* self::console_log('logged string');
* echo '</script>';
*
* @param $data information to display
* @param bool $add_script_tags true to put information is inside complete script tag
*/
public static function console_log($data, $add_script_tags = false) {
$command = 'console.log('. json_encode($data, JSON_HEX_TAG).');';
if ($add_script_tags) {
$command = '<script>'. $command . '</script>';
}
echo $command;
}
}

View File

@@ -1,77 +0,0 @@
<?php
namespace MediaWiki\Extension\AnatImageViewer;
use MediaWiki\MediaWikiServices;
use RequestContext;
use Html;
use ParserOutput;
class AnatImageHooks {
/**
* MWHook: Add an (fake) mime types to MimeMagic
*
* @see https://www.mediawiki.org/wiki/Manual:Hooks/MimeMagicInit
*
* @param MimeAnalyzer $mime Instance of MW MimeAnalyzer object
*/
public static function onMimeMagicInit($mime) {
$mime->addExtraTypes('image/annotation an');
$mime->addExtraInfo('image/annotation [METAIMAGE]');
}
/**
* MWHook: Make sure that an files (fake) get the proper mime assignement on upload
*
* @see https://www.mediawiki.org/wiki/Manual:Hooks/MimeMagicImproveFromExtension
*
* @param MimeAnalyzer $mimeAnalyzer Instance of MW MimeAnalyzer object
* @param string $ext extention of upload file
* @param string &$mime current assigned mime type
*/
public static function onMimeMagicImproveFromExtension( $mimeAnalyzer, $ext, &$mime ) {
if ( $mime !== 'image/annotation' && in_array( $ext, ['an'] ) ) {
$mime = 'image/annotation';
}
}
/**
* MWHook: Called when the parser initializes for the first time
*
* @param Parser $parser: Parser object being initialized
*/
static function onParserFirstCallInit( $parser ) {
$parser->setHook('anconfig', array( __CLASS__, 'renderConfigTag'));
}
/**
* Render the config toml in a <pre> tag
*
* @param $input The text inside the custom tag
* @param array $args Any attributes given in the tag
* @param Parser $parser The parser object
* @param PPFrame $frame The parent frame calling the parser
* @return string HTML string of output
*/
static function renderConfigTag( $input, array $args, $parser, $frame ) {
return '<pre anconfig>' . $input . '</pre>';
}
/**
* Small helper function to display information on the browser console
*
* Usage:
* echo '<script>';
* self::console_log('logged string');
* echo '</script>';
*
* @param $data information to display
* @param bool $add_script_tags true to put information is inside complete script tag
*/
public static function console_log($data, $add_script_tags = false) {
$command = 'console.log('. json_encode($data, JSON_HEX_TAG).');';
if ($add_script_tags) {
$command = '<script>'. $command . '</script>';
}
echo $command;
}
}

View File

@@ -0,0 +1,60 @@
<?php
namespace MediaWiki\Extension\AnatImageViewer;
use Content;
use TextContent;
class AnnotationContent extends TextContent {
public const MODEL = 'annotation';
/** @inheritDoc */
public function __construct( $text, $model_id = self::MODEL ) {
parent::__construct( $text, $model_id );
}
/**
* Determines whether this content can be considered empty.
*
* @return bool
*/
public function isEmpty() {
$text = trim( strip_tags( $this->getText() ) );
return $text === '';
}
/**
* Determines whether this content should be counted as a "page" for the wiki's statistics.
*
* @param bool|null $hasLinks
*
* @return bool
*/
public function isCountable( $hasLinks = null ) {
return false;
}
public function isValid() {
return parent::isValid();
}
/**
* Should return text relevant to the wiki's search index.
*
* @return string
*/
public function getTextForSearchIndex() {
return strip_tags( $this->getText() );
}
public function convert( $toModel, $lossy = '' ) {
return parent::convert( $toModel, $lossy );
}
public function getSection( $sectionId ) {
return parent::getSection( $sectionId );
}
public function replaceSection( $sectionId, Content $with, $sectionTitle = '' ) {
return parent::replaceSection( $sectionId, $with, $sectionTitle );
}
}

View File

@@ -5,56 +5,77 @@ require_once __DIR__ . '/../vendor/autoload.php';
use Devium\Toml\Toml; use Devium\Toml\Toml;
use MediaWiki\MediaWikiServices; use MediaWiki\MediaWikiServices;
use MediaTransformOutput; use Content;
use ConfigFactory; use Title;
use RequestContext; use CodeContentHandler;
use MediaWiki\Content\Renderer\ContentParseParams;
use ParserOutput;
use Html; use Html;
use IContextSource;
use MediaWiki\Content\ValidationParams;
use Status;
class AnatImageTransformOutput extends MediaTransformOutput {
/** class AnnotationHandler extends CodeContentHandler {
* Main Constructor private const ANNOT_VERSION = '0.1';
*
* @access public public function __construct(
* @param File $file $modelId = AnnotationContent::MODEL,
* @param array $parameters Parameters for constructing HTML. $formats = [ CONTENT_FORMAT_TEXT ]
* @return void ) {
*/ parent::__construct( $modelId, $formats );
public function __construct($file, $parameters) { }
$this->file = $file;
$this->parameters = $parameters; protected function getContentClass() {
self::console_log($parameters, true); return AnnotationContent::class;
} }
/** /**
* Fetch HTML for this transform output * Only allow this content handler to be used in the Module namespace
* * @param Title $title
* @access public * @return bool
* @param array $options Associative array of options. Boolean options
* should be indicated with a value of true for true, and false or
* absent for false.
* alt Alternate text or caption
* desc-link Boolean, show a description link
* file-link Boolean, show a file download link
* custom-url-link Custom URL to link to
* custom-title-link Custom Title object to link to
* valign vertical-align property, if the output is an inline element
* img-class Class applied to the "<img>" tag, if there is such a tag
* preview Boolean, render is being called from a preview page
*
* @return string HTML
*/ */
public function toHtml($options = []) { public function canBeUsedOn( Title $title ) {
$descriptText = $this->file->getDescriptionText(); if ( $title->getNamespace() !== NS_AV_ANNOT ) {
preg_match('/<pre anconfig.*?>([\S\s]*?)<\/pre>/',$descriptText,$annotDescript); return false;
$metadata = toml_decode($annotDescript[1], true); }
return parent::canBeUsedOn( $title );
}
/** @inheritDoc */
public function supportsPreloadContent(): bool {
return true;
}
public function serializeContent( Content $content, $format = null ) {
return parent::serializeContent( $content, $format );
}
public function unserializeContent( $text, $format = null ) {
return new AnnotationContent( $text );
}
public function makeEmptyContent() {
return new AnnotationContent( '' );
}
protected function fillParserOutput( Content $content, ContentParseParams $cpoParams, ParserOutput &$output ) {
parent::fillParserOutput( $content, $cpoParams, $output );
self::console_log('Parsing the fucking thing', true);
$metadata = toml_decode($content->getText(), true);
self::console_log(print_r($metadata, true), true);
if (isset($metadata['baseImage'])) { if (isset($metadata['baseImage'])) {
$baseImage = MediaWikiServices::getInstance()->getRepoGroup()->findFile(`File:` . $metadata['baseImage']); $imageTitle = Title::makeTitleSafe( NS_FILE, $metadata['baseImage'] );
$baseImage = MediaWikiServices::getInstance()->getRepoGroup()->findFile($imageTitle);
self::console_log($baseImage->getFullUrl(), true);
} else { } else {
$baseImage = false; $baseImage = false;
} }
return self::buildSvg($metadata,$baseImage); $output->setText( self::buildSvg($metadata,$baseImage) );
} }
/** /**
@@ -64,9 +85,8 @@ class AnatImageTransformOutput extends MediaTransformOutput {
* and produces the html string for the svg with base image and annotations. * and produces the html string for the svg with base image and annotations.
* *
* @param string $metadata The metadata object parsed from the text * @param string $metadata The metadata object parsed from the text
* @param string $baseImageUrl The full url pointing to the base image to annotate * @param File $baseImage The full url pointing to the base image to annotate
* @param array $frameParams The additional user defined parameters for the viewer such as hotspot and view classes * @return string Html string of the complete svg
* @return string Html string of the complete model-viewer element inside a div container
*/ */
private function buildSvg($metadata, $baseImage) { private function buildSvg($metadata, $baseImage) {
//Gather basic data //Gather basic data
@@ -89,8 +109,6 @@ class AnatImageTransformOutput extends MediaTransformOutput {
); );
$elBaseImg = Html::rawElement('image', $attrBase); $elBaseImg = Html::rawElement('image', $attrBase);
} }
$mainConfig = ConfigFactory::getDefaultInstance()->makeConfig( 'main' );
$context = RequestContext::getMain();
//Render and return svg //Render and return svg
$attrSvg = array( $attrSvg = array(

View File

@@ -0,0 +1,41 @@
<?php
namespace MediaWiki\Extension\AnatImageViewer;
class AnnotationHooks {
public static function registrationCallback() {
define( 'CONTENT_MODEL_ANNOTATION', 'annotation' );
}
/**
* Set the content handler for annotations
*
* @param Title $title
* @param string &$model
* @return void
*/
public static function onContentHandlerDefaultModelFor( $title, &$model ) {
if ( $title->getNamespace() === NS_AV_ANNOT ) {
self::console_log('Found fucking thing!',true);
$model = CONTENT_MODEL_ANNOTATION;
}
}
/**
* Small helper function to display information on the browser console
*
* Usage:
* echo '<script>';
* self::console_log('logged string');
* echo '</script>';
*
* @param $data information to display
* @param bool $add_script_tags true to put information is inside complete script tag
*/
public static function console_log($data, $add_script_tags = false) {
$command = 'console.log('. json_encode($data, JSON_HEX_TAG).');';
if ($add_script_tags) {
$command = '<script>'. $command . '</script>';
}
echo $command;
}
}