Extension:FreeMind

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual - list
Crystal Clear action run.png
FreeMind

Release status: beta

Implementation Tag
Description Displays FreeMind MindMaps as flash or java applet with full navigation.
Latest version unknown (Sep. 2007,2012)
MediaWiki 1.4-1.18
License No license specified
Download MediawikiExtension.zip
Example FreeMind wiki

Translate the FreeMind extension if possible

Check usage and version matrix; code metrics

Information[edit | edit source]

This extension is for FreeMind-Users. It displays the FreeMind-MindMap (user does not have to install FreeMind).

How to download the Freemind Extension for MediaWiki[edit | edit source]

Try this [2] for FreemindFlashBrowser.zip

(for more details on flash see here) both are required by the extension.

  • You can find the extension in the CVS here [3]
  • See README for installation instructions.

For Mediawiki 1.2+ You must edit MimeMagic.php and add "application/xml mm".


Now you can use the extension with different forms of <mm>[[Hello.mm]]</mm> in the wiki as per the article tab.

Installation[edit | edit source]

  1. Copy file FreeMind.php and directory freemind into <mediawiki>/extensions
  2. Copy file freemindbrowser.jar into <mediawiki>/extensions/freemind
  3. Copy files bola.jpg bola4.gif estrella.png flashobject.js visorFreemind.swf from flash viewer distribution into <mediawiki>/extensions/freemind
  4. Add the line include('extensions/FreeMind.php'); to the end of your LocalSettings.php file (The name of your file is case sensitive!)
  5. Add 'mm' to the list of allowed file extensions, e.g.
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'wmz', 'mm' );
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'mm' ); // типы файлов которые разрешены для загрузки
$wgEnableUploads = true; 
$wgStrictFileExtensions = false; // IF false, don't check  $wgFileExtensions
$wgVerifyMimeType = false; // off controll MIME - type

6. Edited the mediawiki/includes/MimeMagic.php file to include:

 application/xml mm

7. I had to add the following to mediawiki/includes/mime.types [in Ubuntu] to get it to work:

application/xml mm

Now you can use the extension. If You Use MediaWiki18.1 you nide use new file FreeMind.php from Guntera

Known problems and their solutions[edit | edit source]

Apparently the freeMindFlashBrowser.zip download is broken, the zip file is corrupt and cannot be unzipped. 
Try getting the included files directly from the CVS.
To fix an error where the flash version doesn't work 
check the discussion and solution here.
FreeMind returns "File Not Found" error in mw v.1.18+
Edit FreeMind.php The Image class is deprecated and has been removed. Also, makeTitleSafe is performed automatically in object instantiation. Change this code:
    $imageTitle = Title::makeTitleSafe("Image", $url);
    if($imageTitle == NULL){
    	return MindmapNotFoundError($url);
	}
    $img = Image::newFromTitle($imageTitle);
    if($img->exists() != true){
    	return MindmapNotFoundError($url);
	}
    $url = $img->getViewURL(false);

to this:

$img = wfFindFile($url);
if($img == false){
  return MindmapNotFoundError($url);
}
$url = $img->getViewURL(false);

Note that there may well be other incompatibilities between the FreeMind extension and MW 1.18+ but at least the above fix allowed me to view my current mindmaps in mw 1.20.3. GregRundlett (talk)

Embedding FreeMind Maps[edit | edit source]

1. To embed a freemind mind map file which has been uploaded to this wiki, use:

<mm>Hello.mm</mm>. Do not upload .mm files with spaces as the plugin apparently can't parse for spaces in file names.

2. You can specify if you want to display the map in the flash browser or in the java applet

<mm>flash</mm>
<mm>applet</mm>

The flash viewer is smaller and starts much faster than the applet viewer. For this reason do not use both flash and applet on the same wiki page, but choose the one you find the best.

3. You can display the map in a separate page by adding a colon in front of the file name:

<mm>Hello.mm</mm>
<mm>description</mm>
<mm>applet</mm>

4. Embed map in flash (with height)

 <mm>flash|80pt</mm>

5. Embed map in flash without title (with height and collapsed to level 1)

 <mm>flash|notitle|80pt|parameters startCollapsedToLevel=1</mm>


6. Embed map in applet (with height and title)

 <mm>applet|150px|title example map</mm>

7. Link to special page with the map in flash

 <mm>flash</mm>
 <mm>flash|title the map in flash|map in flash</mm>
 <mm>flash|notitle|map in flash without title</mm>

8. Link to special page with the map in applet

 <mm>applet</mm>
 <mm>applet|title the map in applet|map in applet</mm>
 <mm>applet|notitle|map in applet without title</mm>


9. Link to description page

 Image:Hello.mm
 Example map


10. Link directly to file

Media:Hello.mm Example map


Advanced options[edit | edit source]

1. The full syntax for embedding an map in the wiki page is:

 <mm>[[{name}|{options}|parameters {parameters}]]</mm>

2. The full syntax for displaying the map in the separate page is:

 <mm>[[:{name}|{options}|parameters {parameters}|different text]]</mm>

3. The options can be zero or more of the following, separated by pipes:

 applet, flash: Controls how the image is displayed,
 {height}px: Sets the given height in pixels,
 {height}pt: Sets the given height in points,
 title {title text}:Displayed map caption also used as a reference to the map file.
 notitle: Display no title and no reference.

The options can be given in any order.

The parameters can be zero or more of the {key}={value} pairs separated by spaces. They are transferred to the browser showing the map. Consult flash browser documentation as a mind map (http://freemind.sourceforge.net/wiki/extensions/freemind/flashBrowserDocu.html) for more info.

If a given option does not match any of the other possibilities, it is assumed to be the link text.

4. Embedding images in uploaded mind maps

If you want to include pictures in your map, they should be referenced by absolute paths to the images previoulsy iploaded to this site

  1. Upload the pictures first
  2. Every image in the FreeMind wiki becomes it own path. You can obtain it e.g. using wiki special page Special:Imagelist. All images listed there are linked to the image position e.g. http://freemind.sourceforge.net/wiki/images/0/00/Dothiepinscheme.gif
  3. Copy the links and insert them in your local mind map files.
  4. Check that the images are shown properly.
  5. Upload the mind map.

5. External images and map files

You can neither link to nor embed an external map. You can not embed a map including images located on external server.


See also[edit | edit source]

Language: English  • русский