Extension:Dia

What does this extension do?
The Dia extension allows Dia diagrams to be embedded/rendered inside MediaWiki pages. It can be used to have thumbnails of specified size to be automatically generated from the uploaded .dia files. (If no size is given, then the nominal size will be used.)

In the future, when SVG gets better support in all the major browsers, this extension may also produce .svg from the .dia files.

Dependencies

 * dia - This extension relies on an external conversion program to perform the conversion. By default, dia itself is used to perform this conversion, which means that you will need to have it installed on the server.

Installing
Copy the Dia directory into the extensions folder of your MediaWiki installation. Then add the following lines to your LocalSettings.php file (near the end):

To finish the installation, you must make sure the dia mime types are known to WikiMedia. This can be done by applying the supplied patch mimetypes.patch.

To do so, type the following in a commandline shell:

Or by manually adding the following line to includes/mime.types:

And by adding the following line to includes/mime.info:

Configuration

 * $wgDIANominalSize: The nominal width of a Dia file when rendered to png (default: 300px).


 * $wgDIAMaxSize: Don't scale a Dia file larger than this (default: 1024px).

Advanced Configuration
Dia diagrams may be uploaded as drawings. these diagrams are converted to png before they can be rendered on a page. An external program is required to perform this conversion. By default 'dia' itself is used to perform this conversion, but if you have a different tool to perform the conversion you can set it up here.


 * $wgDIAConverters: An associative array linking your conversion tool (as key) with the commandline to be used for your tool. In this commandline you can use the following variables:
 * $input: The input filename
 * $output: The output filename
 * $width: The output width
 * $wgDIAConverter: The currently selected converter (default: 'dia').
 * $wgDIAConverterPath: If the currently selected converter is not in the default PATH environment variable, you can set the path here.

Note: Future versions of the extension may also output SVG.

Client side
This extension works great when using an external editor.

In addition to this, a patch has been posted on bugzilla that updates the ee (external editor) "extension" to allow a connection to a wiki page that is protected with HTTP authentication (i.e. logins that give a popup username/password requester).

FAQ
Please also see Extension_talk:Dia for further assistence and questions regarding this extension.


 * Q:Which shapes does this extension support?
 * A:This extension uses 'dia' itself to perform the conversion, so it will supported whatever the 'dia' that is installed on the server will support. If someone uploads a .dia file that uses shapes (from a third-party plugin) that the installed 'dia' does not have, then these shapes will not get rendered in the thumbnail until the 'dia' on the server-side is also extended with the used plugin.

History

 * 20071031 Initial version.