[[PageOutline(2-5,Contents,pullout)]]

= Embed Freemind mindmaps into wiki pages

== Description

Embeds [http://freemind.sourceforge.net/wiki/index.php/Main_Page Freemind mindmaps] into your Trac wiki pages.
This plugin makes use of the `visorFreeMind.swf` flash mindmap viewer, the GPL licensed [http://freemind.sourceforge.net/wiki/index.php/Flash_browser Flash browser for FreeMind].

See also: FreeMindEmbeddingTutorial, MindMapMacro.

== Bugs/Feature Requests

Existing bugs and feature requests for FreemindMacro are 
[report:9?COMPONENT=FreemindMacro here].

If you have any issues, create a 
[/newticket?component=FreemindMacro new ticket].

[[TicketQuery(component=FreemindMacro&group=type,format=progress)]]

== Download

Download the zipped source from [export:freemindmacro here].

== Source

You can check out FreemindMacro from [/svn/freemindmacro here] using Subversion, or [source:freemindmacro browse the source] with Trac.

== Installation

Add {{{application/x-freemind:mm}}} to the {{{mime_map}}} list in your project's {{{trac.ini}}}. This enables Trac to render mindmaps 
when previewing attachments.

Also add an entry to the components section of the `trac.ini` file:

{{{#!ini
[mimeviewer]
mime_map = application/x-freemind:mm

[components]
freemind.* = enabled
}}}

To render mindmaps when previewing them while browsing your SVN repository, you'll need an {{{svn:mime-type}}} on the file.

{{{#!sh
$ svn propset svn:mime-type application/x-freemind filename.mm
$ svn ci
}}}

== Example

It appears you cannot view mindmaps from different domains, might be a Flash issue. For an example, download the file http://evamoraga.net/efectokiwano/mm/index.mm and save it into your projects' htdocs directory.

{{{
[[Freemind(htdocs://site/index.mm)]]
}}}

Ideally you want to access mindmaps from your SVN repository:

{{{
[[Freemind(source://trunk/docs/design_meeting_2008-10-15.mm,width=1024px,height=768px)]]
}}}

You can access your mindmaps as follows:

{{{
http://example.com/filename.mm
    directly from the web, doesn't seem to work !!!

htdocs://site/filename.mm
    from your project's htdocs.

htdocs://plugin/dir/filename.mm
    from a plugin's htdocs.

ticket://123/filename.mm
    from an attachment on ticket #123.

wiki://WikiWord/filename.mm
    from an attachment on a wiki page.

source://1024/trunk/docs/filename.mm
    from your SVN repository revision [1024], you can also use HEAD as your revision.
}}}

== Possible Enhancements

 1. Give users access to the Flash variables through the keyword arguments.

== Recent Changes

[[ChangeLog(freemindmacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:lcordier] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [wiki:martin_s] (!FreemindRenderer reference implementation)