https://freemind.sourceforge.io/wiki/api.php?action=feedcontributions&user=Ewl&feedformat=atom
FreeMind - User contributions [en]
2024-03-28T08:46:20Z
User contributions
MediaWiki 1.38.7
https://freemind.sourceforge.io/wiki/index.php?title=Asked_questions&diff=8734
Asked questions
2010-04-20T19:39:54Z
<p>Ewl: /* To move a node to the other side of root */ add more details about rearranging</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
Here we collect a list of asked questions and answers related to free mind mapping software FreeMind. Help if you can (see [[#To edit this FAQ|To edit this FAQ]]). If you're searching for an answer to your question, why don't you just press Ctrl + F in your browser?<br />
<br />
This is not a place to ask questions. If you have a question that you want to ask, see [[Support]].<br />
<br />
== Installation ==<br />
<br />
=== How do I download the Java Runtime Environment needed to run FreeMind. ===<br />
To download JRE for Windows, go to [http://java.sun.com/j2se/1.4.2/download.html Download on Sun],<br />
go to the section '''Download J2SE v 1.4. ...'''<br />
and now choose the column [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&amp;PartDetailId=j2re-1.4.2_03-oth-JPR&amp;SiteId=JSC&amp;TransactionId=noreg JRE], ''not SDK''. The installation file of JRE has approximately 15 MB.<br />
<br />
=== I start FreeMind but nothing happens ===<br />
First of all, we assume that you are working under Windows. Now, please start freemind.bat in the installation directory.<br />
You'll probably get:<br />
<br />
Exception in thread "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
<br />
at freemind.main.FreeMind.getLogger(FreeMind.java:643) <br />
at freemind.main.FreeMind.<init>(FreeMind.java:109) <br />
at freemind.main.FreeMind.main(FreeMind.java:647) <br />
<br />
The answer to this behaviour is that you've got Java1.3 or lower installed, and this version of java is found (try java -version on the commandline to verify this). <br />
Most likely, you've installed Oracle. <br />
Change JAVA_HOME and the PATH variables to point to your actual java (1.4 or 5.0). <br />
This can be done as follows: Goto Settings -> System -> search for Environment Variables and change or create the values accordingly.<br />
<br />
Another reason Freemind won't start or will give you the effect of having the icon in the Windows taskbar but nothing else is when you install Freemind in a folder that starts with a "!" (exclamation mark); just install it in a different folder. (See http://www.cogmios.nl/java-apps-like-eclipse-or-freemind-do-not-run-in-folders-starting-with-a-20070407.html)<br />
<br />
=== I start FreeMind but nothing happens <i>TRY THIS FIRST</i>===<br />
First, check that Java is installed; Then go to Program Files\Freemind\Lib and double-click on the "Freemind.jar" file (which is an executable Jar file). <br />
<br />
Alternatively, try to start Freemind from the freemind.bat file. The command.com will open along with Freemind. Just close down Freemind (command.com will close also) and then start Freemind from the Start Menu or from freemind.exe I have no idea why this works but it did for me.<br />
<br />
Another reason why Freemind won't start is if you hava JDK installed and JAVA_HOME points to JDK instead of JRE. If you point JAVA_HOME environment variable to the JRE home then Freemind.exe starts up fine.<br />
<br />
If the above doesn't work make sure you have the path to java in your PATH variable.<br />
<br />
The format is the following:<br />
<br />
JAVA_HOME=C:\Program Files\Java\jre6<br />
<br />
PATH=C:\Program Files\Java\jre6\bin; <br />
<br />
Your PATH will surely include more things.<br />
<br />
=== I start FreeMind and can create a map but can not save it ===<br />
The most obvious indication is that you click on open/save/save as and nothing happens. What is happening is that the file browser window is failing to open. There are two fixes; Either change JAVA_HOME to point to a JRE rather than a JDK or edit the Freemind.bat file to use the absolute path to the correct java and start Freemind with the bat file. It will be something like "C:\Program Files\Java\jre1.6.0_05\bin\java" instead of just java. Note the use of quote marks and that your java path may not be the same as the example. <br />
=== I start FreeMind but nothing happens on MacOS X Leopard ===<br />
I launch FreeMind 0.8.1 on MacOS X 10.5 (Leopard), the FreeMind welcome image appears and after few moments, FreeMind quit after a pop up window "Cannot lunch Java application (Uncaught exception in main method: Java.lang.OutOfMemoryError: Java heap space)".<br />
<br />
**Freemind does not seem to work if you simply drag the butterfly icon to the applications folder- you have to move the WHOLE installed folder (Mac_OS_X_Freemind-0_8_1) into the applications folder, and click on the icon within that folder (attach that icon to the dock). The program seems to need to have everything together in that folder for it to launch.<br />
<br />
Thanks SO MUCH for this! I was going NUTS trying to get this to happen! Not a tecchie by any means! Angie]<br />
<br />
This issue might be related to the problem met by OpenOffice users on Leopard. <br />
Apple seems to have replaced "Apple Computer, Inc." by "Apple, Inc." in the Java string. The JRE is thus not recognized anymore on Leopard, and Java fails. ([http://user.services.openoffice.org/en/forum/viewtopic.php?f=17&t=153 Web Reference])<br />
<br />
Hope this issue will be fixed in the next FreeMind release.<br />
<br />
'' '''Temporary Solution''' '' : ''It is possible de launch FreeMind via FreeMind.app > Content > Resources > Java > lib > freemind.jar''<br />
<br />
''I suggest to place an alias in the Dock, for a more friendly access to FreeMind''<br />
<br />
'''''I was able to get FreeMind 0.9.0 beta 20 to launch on Mac OS X 10.5.5 (Leopard) by editing the Info.plist <tt>JVMVersion</tt> string to read <tt>1.6</tt> instead of <tt>1.4+</tt>. For the record, when I run <tt>java -version</tt> it reports <tt>java version "1.5.0_16"</tt>.'''''<br />
<br />
:I got the install to work by creating a Freemind folder under Applications, copying the rest of the files in the container to it (e.g. freemind.properties, plugins\, accessories\ etc) and then moving the "installed" package to that folder. It looks like Freemind needs to find those files and folders during startup.<br />
<br />
=== FreeMind cannot detect new version of Java. What can I do? ===<br />
Let us assume that you have installed a new<br />
version of Java, and still, FreeMind complains about having old version of Java. This may occur especially<br />
if you installed ''SDK'' rather than ''JRE''. ''SDK'' stands for ''software development kit'' and contains much more<br />
than you need to run FreeMind; you only need the runtime environment. It is important that the new version of<br />
java is in your ''path''. To check it out on Microsoft Windows, run command ``cmd" using Windows-key + R,<br />
followed by ``java -version". You should get something like<br />
<br />
java version "1.4.2_03"<br />
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_03-b02)<br />
Java HotSpot(TM) Client VM (build 1.4.2_03-b02, mixed mode)<br />
<br />
where the particular version number is not important as long as it is at least 1.4.0.<br />
<br />
Additionally, it may be helpful to start '''freemind.bat''' and see what messages come.<br />
<br />
'''NOTE:''' If you have an Oracle database product installed on your computer, check the Oracle Installer to see what version of Java was installed with the database. Versions of Oracle 8, 8i, and later install JRE 1.3.1 and modify the startup path for Windows to ensure the database can start using this JRE. This installation WILL cause FreeMind to report the older version of Java, even if you install the new version (the .ini file for Oracle points Windows to the JRE 1.3.1 directory, places that in memory, and causes the fault). You can modify the .ini file to point Oracle to the newer JRE. <br />
<br />
If you don't want to change the Oracle settings: just create a batch file in the FreeMind folder with the following entry "Path-to-your-new-java-runtimes-bin/java.exe -jar lib/freemind.jar" and use that to start freemind.<br />
<br />
===Is there an IRC for freemind devs/users===<br />
<br />
===Uploading to gallery gives incorrect file ext. or file corruption message but the file is fine===<br />
What do I do? <br />
<br />
=== Which Java virtual machines does FreeMind actually work with? ===<br />
<br />
FreeMind works with the virtual machines from Sun, from the version 1.4.0 and higher. FreeMind has been reported to run on the JDK 1.4.2 from Blackdown. FreeMind also works on Linux with Sun Microsystems 64bit JDK version 1.5.0.<br />
<br />
There are known issues with official release 0.8.0 of Freemind and Java 6. <br />
* Encrypted nodes will wipe out your map when trying to save it to disk. <br />
* Preferences dialog can not be opened<br />
Stick to Java 5 (alias 1.5.x) [http://sourceforge.net/tracker/?func=detail&atid=107118&aid=1550792&group_id=7118 (see bug report)]<br />
<br />
Possible cause and work-around for problem of Preferences dialog: extended desktop (second monitor). If you extend your desktop on to a second monitor and use FreeMind on that monitor, when you close (save?) the Preferences dialog, its dialog is saved to the extended desktop location. The next time you use FreeMind without using the 2nd monitor, the Preferences dialog will not be visible. I had this problem and was able to correct it by moving the dialog back to the main monitor and saving again (note that the virtual position of the 2nd monitor relative to the main monitor is important for finding the dialog again).<br />
-RyanC, 7-Apr-08<br />
<br />
=== What is a mirror? ===<br />
A mirror is one of the SourceForge sites from which you can download FreeMind. To download FreeMind, choose ''any'' mirror; you would prefer a mirror geographically closer to the place where you live. If you experience problems with one mirror, try another.<br />
<br />
=== I run 'freemind.bat' and get an error message ===<br />
If you get <br />
Exception in thread "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
at freemind.main.FreeMind.getLogger<FreeMind.java:643>at<br />
freemind.main.FreeMind.<init<FreeMind.java:109> <br />
at freemind.main.FreeMind.main<FreeMind.java:647> <br />
then the Java Virtual Machine found on your system is of version 1.3 or below. Try <br />
java -version<br />
to verify this. This happens, when you install Oracle for instance. Please, make sure, that your latest Java Virtual Machine is found when you type "java -version" by deinstalling java1.3 for example.<br />
<br />
=== USB Portable FreeMind ===<br />
Just add the following Java option in the freemind.bat or freemind.sh and everything is contained on the USB stick:<br />
<br />
-Duser.home=.[\<subdirectory, if needed>]<br />
<br />
As an example see the new content of my BAT-file, which looks like:<br />
<br />
@echo off<br />
java -Duser.home=. -cp lib\freemind.jar;lib\commons-lang-2.0.jar;lib\forms-1.0.5.jar;lib\jibx\jibx-run.jar;lib\jibx\xpp3.jar;lib\bindings.jar freemind.main.FreeMindStarter<br />
<br />
This lets FM create and use the subfolder .freemind in the location of the freemind.bat.<br />
<br />
As we know, USB flash drives support only limited number of writes. It means that reliability of such device drops down as time advances. Freemind, by default, saves your open maps every minute to .freemind dir which is in this case on the flash drive. If you aren't too paranoid you can avoid this by setting autosave dir to tmp dir of your OS. Freemind will automatically delete autosaves on exit so your precious data won't be left on a host machine. Go to Tools->Preferences->Path to automatic saves and set it to 'default'. Freemind will understand this on Windows probably as c:\windows\temp, Linux - /tmp or /var/tmp.<br />
<br />
That's it and have fun!<br />
<br />
=== What if the command.com window opened by FreeMind.bat annoys me? ===<br />
You can force the window not to show by having the batch file not to hold the handle to the java runtime. Effectively the command prompt is displaying command line output from java application, FreeMind, while waiting for the application to terminate before it closes. You can solve this by using javaw to suppress the command line output and forcing the command prompt to start a new process for java. Try editing the FreeMind.bat to change <tt>java -cp lib\freemind.jar;...</tt> with <tt>START "" javaw</tt>. The line becomes something like <tt>START "" javaw -cp lib\freemind.jar;...</tt><br />
<br />
If that approach does not successfully hide the window, try this approach: <br />
1. Copy the following script to a text file, <br />
2. Modify the java directory ("C:\Program Files\Java\j2re1.4.2_13\bin\java") to match the location of yours, <br />
3. Save the file with a .vbs extension (i.e. FreeMind.vbs), and <br />
4. Double-click the file.<br />
<br />
<tt>Dim objShell<br />
<br/>Set objShell = CreateObject("WScript.Shell")<br />
<br/>objShell.Run Chr(34) & "C:\Program Files\Java\j2re1.4.2_13\bin\java" & Chr(34) & " -cp lib\freemind.jar;lib\ant\lib\jaxb-api.jar;lib\ant\lib\jaxb-impl.jar;lib\ant\lib\jaxb-libs.jar;lib\ant\lib\namespace.jar;lib\ant\lib\relaxngDatatype.jar;lib\ant\lib\xsdlib.jar;lib\ant\lib\jax-qname.jar;lib\ant\lib\sax.jar;lib\ant\lib\dom.jar freemind.main.FreeMind", 0, False<br />
<br/>Set objShell = Nothing<br />
</tt><br />
<br />
== Troubleshooting ==<br />
<br />
Before you start asking questions on the forum, it's a good idea to check if your problem is not already described, together with a resolution:<br />
* either on this page,<br />
* or in the Forums, there is a search function (check the SourceForge menu 'Forums &rarr; Search'),<br />
* or even in the Trackers, where you can find already reported problems.<br />
<br />
If this doesn't help, then sample the following information (under Windows, check the specific pages for other OS's) and create a Help forum topic (if you're not sure) or bug tracker item (if you're quite sure that it's a bug in FreeMind) with it:<br />
<br />
* OS version (e.g. Win XP with(out) SP2 or 3)<br />
* Java version (the output of <tt>java -version</tt> called from the command line, example as follows)<br />
C:\Users\lostuser>java -version<br />
java version "1.5.0_15"<br />
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_15-b04)<br />
Java HotSpot(TM) Client VM (build 1.5.0_15-b04, mixed mode, sharing)<br />
* FreeMind version (e.g. FreeMind 0.9.0.Beta20, installed from <tt>FreeMind-Windows-Installer-0.9.0_Beta_20-max.exe</tt>)<br />
* Content of the logfile <tt>%USERPROFILE%\.freemind\log.0</tt> after you've done the action making problems.<br />
* It's also a good idea to open a command line, go to FreeMind's base directory, in general with <tt>cd %ProgramFiles%\freemind</tt>, and start FreeMind from there, using the <tt>freemind.bat</tt> file, and check what happens in the console. Most content is generally similar to the above logfile, but not if FreeMind doesn't even start, for some reason (e.g. Java missing).<br />
* Check if your problem also appears with other Java programs, we generally recommend [http://jedit.sf.net/ JEdit] because it uses the same GUI type (called [http://en.wikipedia.org/wiki/Swing_(Java) Swing]) as FreeMind.<br />
<br />
;Note: under Windows XP/Vista, you can open a command line (also called a console) by pressing the keys <tt>Win+R</tt> (like Run), type <tt>cmd</tt> and press enter.<br />
<br />
== Using ==<br />
<br />
=== To add a new concept ===<br />
<br />
A new concept is referred to as a "node." Use the "Insert" key on PCs to add a new node. MAC users need to [[Asked Questions#To_set_a_different_key_for_new_child_node_on_Mac_computers | set a different key]]. Nodes are not limited to just concepts. They can also include sentences, paragraphs or even short articles.<br />
<br />
=== Is there an undo feature in FreeMind? ===<br />
Starting with FreeMind 0.8, there is an undo and redo feature.<br />
<br />
If you are using 0.7, then use the following tips to prevent data loss:<br />
<br />
* Use FreeMind's autosave-feature <br />
: This feature is enabled by default... auto saved files will be found in ~/.freemind/<br />
<br />
* Install a clipboard manager, which will make all elements, which you cut from FreeMind, available in its history. A freeware example of a clipboard manager for MS Windows is [http://www.yankee-clipper.net Yankee Clipper].<br />
<br />
=== How much memory do I need? === ''Keywords: RAM.''<br />
Experience shows that 64 MB is not sufficient, while 128 MB is already enough, provided that you do not run another Java application. Correct me if I'm wrong. I am using FreeMind on Windows 95 + 128 MB without any problems.<br />
<br />
Running FreeMind 0.8RC5 on Windows 95 with 64 MB and Java 1.4.0 is possible and the response time ''is'' in acceptable limits. -- [[User:Stefano|Stefano]] 02:01, 11 Jul 2005 (PDT)<br />
<br />
Running FreeMind 0.7.1 on Debian Linux and Java 1.4.2.03 (j2sdk1.4) with my Omnibook 800 laptop (78 MB RAM, P166) just fine. I haven't tried any big projects with it yet, but so far it's very responsive. --[[User:Nullman|Kyle]] 09:14, 30 Jan 2006 (PST)<br />
<br />
=== To move a node to the other side of root or re-arrange nodes ===<br />
<br />
Drag the node onto root and you see one half of root getting gray. Move the node to the other half and <br />
this half gets gray. Just drop the node on the side you want to have it.<br />
As of version 0.9.0 you can also use <tt>Ctrl + &larr;</tt> and <tt>Ctrl + &rarr;</tt> to move a node in the desired direction (not only to change the side with respect to root, try it out; <tt>Ctrl + &uarr;</tt> and <tt>Ctrl + &darr;</tt> do work as well). For Mac users, it's <tt>Command+&larr;</tt> and <tt>Command+&rarr;</tt> respectively.<br />
<br />
If you want to rearrange the nodes on your map using your mouse, you should ''not'' move the nodes around using the small "handle" appearing when your pointer hovers over the node, but you should grab the node itself, move it around and see how it throws a shadow upon the place it'll land once you release the mouse button.<br />
If you've already messed up your map, select the culprit nodes and reset their position using the menu <tt>Format &rarr; Reset Position</tt>.<br />
<br />
The "handle" will only move around the node without changing its position in relation to the other nodes.<br />
<br />
=== To create a graphical link ===<br />
<br />
# Go to the source node. <br />
# Mark it with the mouse. <br />
# Press the left mouse button. <br />
# Hold this button. <br />
# Press Ctrl+Shift buttons. <br />
# Continue to hold all these buttons. <br />
# Go to the destination node. <br />
# Release the mouse button, first. <br />
# Then release the keyboard buttons. <br />
<br />
You have your link. Alternatively, drag'n drop holding right mouse button.<br />
<br />
=== To remove a graphical link ===<br />
<br />
# Right-Click on the curved arrow of the graphical link (Mac users, press Control and click to see the options menu)<br />
# Choose "Remove Arrow Link" from the pop-up menu<br />
<br />
(Left-clicking on a graphical link does nothing)<br />
<br />
=== To remove a local link ===<br />
<br />
# Select the node with the link, and press Ctrl+K ("edit link") (Command+K in Mac).<br />
# In the "Edit hyperlink manually..." dialog that appears, clear the contents of the text field, then click OK.<br />
<br />
=== To add user icons to FreeMind ===<br />
Currently, adding user [http://www.guiicons.com Icons] is not possible.<br />
BUT you can add an inline images to any node. Use the following code example:<br />
<nowiki><html><img src="http://www.stumbleupon.com/pics/me.jpg"></nowiki><br />
in a FreeMind node. This should also work with local files using "file://" instead of "http://".<br />
<br />
However if you want to change the source code there is a way to add your own icons.<br />
You have to modify the “freemind.jar” file. (By default you can find it under “C:\Program Files\FreeMind\lib”)<br />
You can modify a .jar file easily with WinRAR. If you have WinRAR installed on your computer just right click the file you want to modify and choose Open With WinRAR.<br />
* 1. Add your own icons: Use the button Add in WinRAR GUI to add your icons to “freemind.jar\images\icons”<br />
* 2. Change file “freemind.properties”: find row that starts with “icons.list=” and add your icon names<br />
* 3. Change file “Resources_xx.properties”: where xx is your local language. Add rows icon_iconName = iconDescription, where iconName is the name of your icon and iconDescription the text you want to see on the tooltip of your icon<br />
<br />
=== To open links in only one browser window, rather than several. ===<br />
To our knowledge this is not possible at the moment.<br />
<br />
'''Firefox (old)''' allows this option. ''From the menu, select''<br />
1) Tools > '''Options''' > <br />
2) Click '''Advanced'''<br />
3) Toggle Tabbed Browsing<br />
4) Select to open links from other apps in<br />
...a new tab in the most recent window.<br />
<br />
'''Firefox (1.5.0.12)''' allows this option. ''From the menu, select''<br />
1) Edit > '''Preferences''' > <br />
2) Click '''Tabs'''<br />
3) Select to open links from other apps in<br />
...a new tab in the most recent window.<br />
<br />
<br />
'''A possible Work Around:''' There is a way to do this if you use the [http://www.mozilla.org/products/firefox/ Firefox browser] instead of Internet Explorer, provided you<br />
install the Firefox extension called ''Single Window'' (available from [http://update.mozilla.org/extensions/showlist.php?category=Tabbed%20Browsing here]). Using this extension, every time you click on an external web link on a mind map, it will open the relevant page in a new tab in an existing Firefox window, rather than a new browser window. I have found this to be a much easier way to navigate the pages opened. I have only tried this with mm files opened from the file system at the moment (i.e. not served from a web server in the browser applet).<br />
<br />
To '''open external web links in a new tabs''' in Firefox follow [http://texturizer.net/firefox/tips.html#beh_reuse this tip] (works both for Linux and Windows). You have to add a line in your user.js file and install [http://piro.sakura.ne.jp/xul/_tabextensions.html.en Tabbrowser extensions].<br />
<br />
=== Is it difficult to provide FreeMind with Java Webstart?=== Well, it's not that easy. Joerg Mueller succeeded in doing just that and has sent his source code to Daniel Polansky, who did not succeed in getting it running; he did not consider that a high priority. What is important is that Microsoft Windows users have a convenient installer, and the users of the other operating systems are already used to not so convenient methods; the installation is pretty straightforward anyway.<br />
<br />
=== To create PDF out of FreeMind's mind map ===<br />
To create pdf out of FreeMind's mind map, you've got several<br />
options.<br />
<br />
* Use File/Export/As PDF...<br />
<br />
* Create DocBook, then pdf. Use [http://krottmaier.cgv.tugraz.at/docs/seminar/sem2002_mindmaps.tar.gz XSLT transformations sheets] from Christoph Rissner to convert FreeMind's mind map to Mind Manager's mind map, then to DocBook, and create pdf from that DocBook. You can read more on that on [http://hkrott.iicm.edu/veranstaltungen/seminar/abgeschlossen.html Abgeschlossene Arbeiten] &gt; Mind Maps.<br />
<!-- Old link to http://hkrott.iicm.edu/docs/seminar/sem2002_mindmaps.tar.gz would not work any --><br />
<br />
* Print to pdf using a pdf printer driver.<br />
** Use open source [http://sector7g.wurzel6.de/pdfcreator/index_en.htm PDFCreator]. It uses Ghostscript as its backend.<br />
<br />
* Print to pdf using Acrobat's Distiller. Provided that you have full version of Adobe Acrobat installed (not just reader), you can print to a pdf using the Distiller or Writer options in your printer list. Make sure you check the "fit to one page" option under File > Page Setup. Also, make sure you set antialias to all under edit > preferences. This will make it look crisper. The only downside to this option is that it doesn't do the icons very well.<br />
<br />
* First print to postscript, then convert to pdf.<br />
** In Linux, create postscript by printing to a file using a postscript printer, and convert the postscript file to pdf afterwards, by using the shell-command ps2pdf or using [http://www.cs.wisc.edu/~ghost/ Ghostscript].<br />
** In Windows, install any postscript color printer (Like AppleColor 600) to print to a file. When printing to that printer, choose a folder and a file that ends with .ps. Then, open that *.ps with [http://www.cs.wisc.edu/~ghost/gsview/index.htm gsview] and choose ''File/Convert to PDF'' (let the program choose it all). Then save the file with the same name, but ending with .pdf. That's all. You might need to read the help files to tune it all up (only once).<br />
<br />
* Export FreeMind's mind map to HTML, paste it into Microsoft Word, format it as you see fit, and convert it to pdf using the techniques decribed above.<br />
<br />
=== To convert mind maps between FreeMind and MindManager ===<br />
See [[Import and export]]<br />
<br />
=== Who is the development team of FreeMind? ===<br />
<br />
Daniel Polansky: the director of FreeMind is Daniel Polansky, i.e. me. The<br />
label ``director" is not quite appropriate; ``parliament"<br />
would be better. I test new versions, give advice, sometimes<br />
act in the name of FreeMind, forbid versions to be released<br />
because of insufficient quality, and approve them when<br />
they're ready. Also, I set up barriers for new directions.<br />
<br />
The main actor on the scene is Christian Foltin. We use<br />
the label ``code master" to denote his role, and also<br />
``manager". He does most of the work and decides which<br />
code changes are acceptable what concerns the<br />
quality of code. He takes care of mergers. Also, he<br />
coordinates the developers.<br />
<br />
An important developer is Dimitri Polivaev.<br />
<br />
=== To have brainstorm-like mode similar to one found in MindManager.===<br />
Did you notice you can hit Enter and Shift-Enter to create sibling nodes?<br />
It is not exactly the behavior of brainstorm mode of MindManager, but still<br />
close to it.<br />
<br />
=== What operating systems does FreeMind successfully run on? ===<br />
<br />
* ''Microsoft Windows.'' Windows 95, Windows 98, Windows NT, Windows 2000, Windows XP (SP1 & SP2), Windows 2003 Server, Windows Vista.<br />
* ''Linux.'' Mandrake 9.2 and 10, RedHat Pro WS 3, RedHat Enterprise Linux WS 4, Fedora Core 2, Fedora 8 & 9, SuSE (8.2 using the RPM for 9.0, 9.0, 9.1, 9.2, 9.3, 10.0, 10.2), Ubuntu (Warty, Hardy, Intrepid Ibis), Debian (sarge, sid), Slackware 9.1, Gentoo, Mepis 3.3.1, Mepis 3.4-2.rc1.<br />
* ''BSD.'' FreeBSD (5.2.1, 5.4, 6.1), Mac OS X (10.2.8, 10.3, 10.4.4, 10.4.8, 10.4.11)<br />
* ''Other.'' OS/2, Solaris 9 and 10.<br />
''Keywords: platforms.''<br />
<br />
=== Is there a PDA-Version, e.g. for Palm or Pocket PC? ===<br />
On PDA, you can use [[FreeMindPDA]]. It uses cross-platform [http://www.superwaba.com SuperWaba] Open Source SDK. However, it does not use mind map view, but rather plain tree view; it is not a proper FreeMind version in that sense. See also [[Stuff#PDA|FreeMind and PDA]].<br />
There is also an iPhone version of FreeMind available wich (payed version) does have abillity to add icons etc, but does not fully support drag and drop facilities.<br />
<br />
=== What is the largest size mindmap I can edit with FreeMind? ===<br />
<br />
In principle, there are no built-in limits. Practically, the maximum reported size is 11 MB at a map with 22,000 nodes; after exporting to HTML and pasting to Microsoft Word, the very same content had 15.6 MB, with 1500 pages. For a better practical estimation, experimental tests are needed, as the maximum given so far is only a lower bound on practical limits.<br />
<br />
I've been appending daily notes to a single mind-map file continually for many months on a 3 GHz Pentium 4 with 2 GB RAM running windowsXP. The file has grown to about half a megabyte, 420K, and there is a noticable difference in Freemind's responsiveness dealing with it, but it still works for me.<br />
<br />
=== How can I keep FreeMind from opening the last file from the last session? ===<br />
One way is to disable the changing of the file "auto.properties" (which is in the same folder as [[user.properties]]). Be aware that the menu "Edit -> Preferences" will not change anything any more than!<br><br />
To do that go to the file auto.properties and delete everything behind "onStartIfNotSpecified=" in that line. Now set the file "auto.properties" to read-only.<br />
<br />
Another way is to change the auto.properties on the fly during startup. Copy the next lines of code into a batch-file and put this into the same directory as freemind.exe. This batchfile will add an extra line to the auto.properties file. In fact, it does the same as the above, but it still enables you to change the properties.<br />
<br />
@echo off<br />
echo onStartIfNotSpecified= >> "%USERPROFILE%\.freemind\auto.properties"<br />
call .\freemind.exe<br />
<br />
===To change the fill color on bubbles.===<br />
There's an icon for it at the main toolbar. Additionally,<br />
you can find it in the popup menu at Node > Style > Cloud color.<br />
<br />
===To remove a cloud===<br />
Press Ctrl+Shift+B to toggle clouds.<br />
<br />
=== To search in FreeMind === <br />
''Keywords: find.'' Press Ctrl + F. For finding next occurrence, press Ctrl + G. Searching is<br />
restricted to the descendants of the node selected when pressing Ctrl + F. The search is<br />
a breadth-first search, first finding occurrences in the nodes closer to the starting node.<br />
<br />
===To move nodes around=== To move them up and down, use ctrl + up and down arrows. To move them wherever you want, use drag'n drop with mouse. ''Keywords: move around, reorganize.''<br />
<br />
=== What does antialias mean in FreeMind preferences? ===<br />
<br />
To antialias means to make fonts or curves look smooth by drawing additional pixels with in-between color. See also wikipedia on [http://en.wikipedia.org/wiki/Antialiasing antialiasing].<br />
<br />
By default, FreeMind antialiases edges only. FreeMind can also antialias text, but with the current state of the technology, it does not look good enough. At least, new Java RE 1.5.0 has better antialiasing of text than Java RE 1.4.x. Also, it is possible to set the whole application to antialiasing, including the menus and editing box; by using the command line option <code>-Dswing.aatext=true</code> of Java 1.5.0. Unfortunately, this is not available if you're using FreeMind.exe to launch FreeMind.<br />
<br />
=== What kind of encryption is used? ===<br />
<br />
: ''See [[Encryption]].''<br />
<br />
=== Reminders don't work when I start a map. The PDF-Export is not present. What's happening? ===<br />
There, the plugins (not only the PDF/SVG one) appear only if you start FreeMind from the directory where it has been installed. Especially if you start FreeMind by double-clicking on a FreeMind file (.mm file), this is not the case. So, use your icon and choose open to open your file.<br />
<br />
== Customizing FreeMind ==<br />
<br />
=== How do I add a new keyboard shortcut ===<br />
To add a new keyboard shortcut, say for "Change node background color", open the file<br />
mindmap_menus.xml (in freemind.jar) and search for "background", say.<br />
<br />
You'll find<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Here, you add a new keyboard ref attribute like:<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor" key_ref="keystroke_node_background_color"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Open the file freemind.properties and add a line like<br />
<pre><br />
#<br />
keystroke_node_color = alt F<br />
keystroke_node_color_blend = alt B<br />
keystroke_edge_color = alt E<br />
keystroke_node_background_color=alt N<br />
</pre><br />
But you have to search for free keys...<br />
<br />
=== To set expert settings ===<br />
<br />
Most of expert settings are stored in the [[user.properties]] file.<br />
<br />
=== To use another browser ===<br />
<br />
If you want to use another browser, edit the [[user.properties]] file and change the following property according to your operation system: <br />
<br />
default_browser_command_windows_nt <br />
default_browser_command_windows_9x <br />
default_browser_command_mac <br />
default_browser_command_other_os <br />
<br />
You have to write something like<br />
<br />
default_browser_command_windows_nt = C:\Program Files\Internet Explorer\iexplore.exe "{0}"<br />
...<br />
<br />
=== To change language ===<br />
<br />
<br />
Lydia<br />
<br />
language= ja<br />
<br />
language = ja <br />
<br />
Don't forget to remove the # character. Restart FreeMind and you have changed the language to German. See also [[Development#To_translate_FreeMind_into_your_language|the list of available languages]].<br />
<br />
=== To set a different key for new child node on Mac computers ===<br />
<br />
NOTE: The latest version of Freemind now sets the "tab" key as the default key for inserting a new node on a mac. Unfortunately, this is not documented in an obvious place. If you right or control click on a node you see a menu that does tell you the Tab shortcut for creating a child node but this is easily missed.<br />
<br />
In a manner similar to changing the language, replace<br />
<br />
#keystroke_add_child = INSERT <br />
<br />
with<br />
<br />
keystroke_add_child = control shift ENTER<br />
<br />
in the file [[user.properties]]. Pay attention that you write the key code ENTER in capital letters. <br />
<br />
N.B. Setting the ADD CHILD MAC is not enough, ADD CHILD must also be set (at least with Beta 9 on Leopard)<br />
<br />
This can also be done via the Freemind GUI by selecting Tools/Preferences/Keystrokes instead of editing the properties file.<br />
<br />
The command ("Apple") key can be referred to as "meta" in these keystroke sequences - in case you were wondering.<br />
<br />
=== There is no shortcut to insert a note. Why? ===<br />
There is no shortcut on purpose, as this action does not come with undo. <br />
<br />
If you want to have this shortcut, you can download the sources, patch NodeNote.xml such that it contains a key_stroke="alt N" in the first lines as here: <br />
<br />
<br />
<plugin_action <br />
documentation="%accessories/plugins/NodeNote.properties_documentation" <br />
name="%accessories/plugins/NodeNote.properties_name" <br />
base="freemind.extensions.NodeHookAdapter" <br />
'''key_stroke="alt N"''' <br />
icon_path="accessories/plugins/icons/knotes.png" <br />
label="accessories/plugins/NodeNote.properties" <br />
class_name="accessories.plugins.NodeNote" instanciation="Once"> <br />
<br />
<br />
compile and you are done. BUT REMEMBER: Pressing your key on a node, that already contains a note, makes this note to remove WITHOUT UNDO. <br />
<br />
At your own risk, Chris<br />
<br />
<br />
=== Using physical styles (or patterns) ===<br />
<br />
Physical styles and patterns are the same and can be compared to "styles" in a text writer: you define a set of styling attributes, give this set a name, and can then assign the style or pattern to different nodes in the same way.<br />
<br />
The patterns are defined in the file <tt>patterns.xml</tt> placed in the FreeMind user directory. In Windows, that file is <tt>C:\Documents and Settings\YourUserName\.freemind\patterns.xml</tt>; under Linux, it's <tt>~/.freemind/patterns.xml</tt>. The generic format of this file is the following:<br />
<br />
<?xml version="1.0" encoding="UTF-8"?><br />
<patterns><br />
<pattern name="Pattern1"><br />
[...pattern properties...]<br />
</pattern><br />
<pattern name="Pattern2"><br />
[...pattern properties...]<br />
</pattern><br />
[...more patterns...]<br />
</patterns><br />
<br />
As you can see from above, you need to give each pattern a unique name, and then you need to assign pattern properties. Each pattern property is of the form <tt><'''pattern_property_name''' value="'''property_value'''"/></tt>, or <tt><'''pattern_property_name'''/></tt>, and each property stands for a different format parameter. Where the property is listed without value attribute, the corresponding format is reset to its default value. The following property names are possible:<br />
<br />
* pattern_node_background_color<br />
* pattern_node_color<br />
* pattern_node_style<br />
* pattern_node_text<br />
* pattern_node_font_name<br />
* pattern_node_font_bold<br />
* pattern_node_font_italic<br />
* pattern_node_font_size<br />
* pattern_icon<br />
* pattern_edge_color<br />
* pattern_edge_style<br />
* pattern_edge_width<br />
* pattern_child<br />
<br />
==== Allowed values ====<br />
<br />
For colors, the format of the value is "#RRGGBB", where RR, GG, BB are the hexadecimal values of the red, green, blue components of a color, e.g. "#B3B95C".<br />
<br />
<code>pattern_icon</code> can take one of the following values:<br />
<br />
* help<br />
* messagebox_warning<br />
* idea<br />
* button_ok<br />
* button_cancel<br />
* full-1<br />
* full-2<br />
* full-3<br />
* full-4<br />
* full-5<br />
* full-6<br />
* full-7<br />
* back<br />
* forward<br />
* attach<br />
* ksmiletris<br />
* smily_bad<br />
* clanbomber<br />
* desktop_new<br />
* flag<br />
* gohome<br />
* kaddressbook<br />
* knotify<br />
* korn<br />
* Mail<br />
* password<br />
* pencil<br />
* stop<br />
* wizard<br />
* xmag<br />
* bell<br />
* bookmark<br />
* penguin<br />
* licq<br />
<br />
; TODO : Add more explanations about the possible values and exact impact for each property.<br />
<br />
==== Example(s) ====<br />
<br />
An example of a pattern is therefore:<br />
<br />
<pattern name="Blue with edges and icon"><br />
<pattern_node_background_color/><br />
<pattern_node_color value="#000099"/><br />
<pattern_node_style/><br />
<pattern_icon value="flag"/><br />
<pattern_edge_color value="#009999"/><br />
<pattern_edge_style/><br />
<pattern_edge_width value="4"/><br />
</pattern><br />
<br />
This information and more can be discovered by opening any .mm file in a text or XML editor. You can usually search for the text in an element to find the example of what you want to learn how to do.<br />
<br />
; Note : the complete list of pattern properties can be found in the source code, in the file <tt>freemind/freemind_actions.xsd</tt> (search for ''pattern_''), and the list of icons in the file <tt>freemind/modes/MindIcon.java</tt> (search for ''mAllIconNames.add'').<br />
<br />
=== Can one make a script to run filters according to the attributes of selected nodes ==<br />
<br />
I'm looking for a way to run filters more intuitively by making the filter by way of clicking on the attributes and icons in nodes on the mind map. Is this possible. Or i guess more simply to make a script that will run a selected filter (However this would be time consuming to do that for many nodes) Any suggestions?<br />
<br />
== Mind maps on web pages with FreeMind's applet ==<br />
<br />
=== To get FreeMind's applet working. ===<br />
If you experience problems viewing a mind map published by someone else, the most common problem is that you have to use Java >= 1.4 in your browser. Check this using the "About plugins" section of your browser (or a similar place). If you have Java >= 1.4 installed and still experiencing problems check out Internet Explorer's settings by selecting Tools > Internet Options > Advanced > Java and make sure ``Use Java2" is enabled.<br />
<br />
=== To present your mind map on the web ===<br />
Use FreeMind's browser applet. The following [http://freemind.sourceforge.net/docs/Serving%20Freemind%20maps%20in%20a%20browser/index.html document] (thanks to Bob) explains what to do to have a complete testing environment for your applet. <br />
<br />
=== Quick Java Applet instructions if you are already a code wiz ===<br />
<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" ARCHIVE="freemindbrowser.jar" <br />
WIDTH="100%" HEIGHT="80%"><br />
<PARAM NAME="type" VALUE="application/x-java-applet;version=1.4"><br />
<PARAM NAME="scriptable" VALUE="false"><br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
<\!-- ^ this has no effect on my pc --><br />
<PARAM NAME="modes" VALUE="freemind.modes.browsemode.BrowseMode"><br />
<PARAM NAME="browsemode_initial_map" VALUE="http://www.osde.info/osde.mm"><br />
<\!-- ^ Put the FULL path to your map here --><br />
<param NAME="initial_mode" VALUE="Browse"><br />
<param NAME="selection_method" VALUE="selection_method_direct"><br />
</APPLET><br />
<br />
In some cases, it may be necessary to set the '''ARCHIVE''' property to also use the '''Full Path''' to the .jar file. In the above example, the initial '''APPLET''' element would appear as:<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" <br />
ARCHIVE="http://www.exmaple.com/freemindbrowser.jar" WIDTH="100%" HEIGHT="80%"><br />
<br />
The most recent version of above source and freemindbrowser.jar are contained in the freemindbrowser.zip-Archive, which you can get from [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=16120 the sourceforge-site].<br />
<br />
=== To view the toolbar automatically after the applet starts ===<br />
It is necessary to edit the html starter of the applet and change the corresponding property. That is, set<br />
toolbarVisible=true. More precisely, add a tag <br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
to freemindbrowser.html or whatever name you have changed the file to.<br />
<br />
=== Is there a list of names and values and functions of all params for the applet? ===<br />
No. Theoretically, all parameters found in user.properties can be used as parameters of the applet.<br />
<br />
<br />
=== Is it possible to change or edit the map through an applet? ===<br />
<br />
No. There is no applet for ''editing'' mind maps; only for viewing.<br />
<br />
=== My document isn't opened by the applet ===<br />
<br />
The URL of the document *must* end with .mm. If it doesn't the document opens in a new browser window. The trick I use is to append a dummy parameter like in this example:<br />
<br />
http://myserver/mypath/mydoc?e=.mm<br />
<br />
This trick is specially useful for dynamic documents. (this is an opinion only. Some people, like Garito, thinks in another way)<br />
<br />
===Java Applet for XHTML===<br />
<br />
The same Freemind Browser can be used but instead of using the 'applet' element, the 'object' element can be used instead. Using Shayne Steele's [http://ww2.cs.fsu.edu/~steele/XHTML/appletObject.html approach], the following code can be used for placing a file called Textbook.mm that is located in http://example.com/freemind/ (along with the freemindbrowser.jar file):<br />
<br />
&lt;!--[if !IE]--&gt;<br />
&lt;object classid="java:freemind.main.FreeMindApplet.class"<br />
type="application/x-java-applet"<br />
archive="http://example.com/freemind/freemindbrowser.jar"<br />
width="450" height="300"&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
&lt;object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"<br />
codebase="http://java.sun.com/update/1.5.0/jinstall-1_5_0-windows-i586.cab"<br />
height="300" width="450"&gt;<br />
&lt;param name="code" value="freemind.main.FreeMindApplet" /&gt;<br />
&lt;param name="archive" value="http://example.com/freemind/freemindbrowser.jar" /&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;strong&gt;<br />
This browser does not have a Java Plug-in.<br />
&lt;/strong&gt;<br />
&lt;br /&gt;<br />
&lt;a href="http://java.sun.com/products/plugin/downloads/index.html"&gt;<br />
Get the latest Java Plug-in here.<br />
&lt;/a&gt;<br />
&lt;/object&gt;<br />
&lt;!--[if !IE]&gt;--&gt;<br />
&lt;/object&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
<br />
It works and it is valid markup. If placing in an HTML file, use '&gt;' instead of ' /&gt;' for the param element ending.<br />
<br />
== Workarounds in FreeMind ==<br />
<br />
===FreeMind behaves strange or crashes. What can I do?===<br />
First try reinstalling both Java (mostly the latest version is best) and Freemind. Often this solves problems. <br />
One of the problems solved in this way was:<br />
<br />
'' ''My computer crashes, or more precisely locks, when I click on a link in FreeMind, using J2RE 1.4.2_03 on Windows 98. Reinstalling helped. In retrospect, I think what broke it was that I renamed the J2RE directory to something easier to write in the bat file path statement. Broke it. ''<br />
<br />
=== When I drag files into the FreeMind window, FreeMind slows down or I get a mind map of the file system ===<br />
This is a bug which is a least present on FreeMind 7.2 beta and lower on Windows. I only know of a workaround for this: Go to the [[user.properties]] and delete ",freemind.modes.filemode.FileMode". This disables the file mode of FreeMind.<br />
<br />
=== Changing the key bindings in user.properties does not work ===<br />
It seems that capitalization IS important in the keybindings. I wrote "enter" and it didn't work. I changed it to "ENTER" and it worked!<br />
(FreeMind 7.2 beta)<br />
<br />
=== FreeMind fails to work with or, cannot export large maps ===<br />
When FreeMind fails to work with big maps, you may do the following.<br />
<br />
Assign more memory to the Java virtual machine as a workaround by editing the launching script. Edit <code>freemind.bat</code> or <code>Freemind.sh</code> and add a <code>-Xmx''MEM''</code> parameter to the <code>java</code> command line at the end of the script, like <code>java -Xmx512m ...</code> for 512 megabytes maximum memory and <code>java -Xmx768m ...</code> for 768 megabytes maximum memory. Believing the manual of Java, the default is 64 MB and the maximum is slightly less than 2000 on an x86 processor, which should be enough.<br />
<br />
Beware that exporting may still take a while. For instance, it may take 11 minutes to export a mind map with 740 nodes to JPEG.<br />
<br />
<strong>On OS X</strong>:<br />
Edit the Info.plist file <code>/Applications/Mac_OS_X_Freemind-0_8_1/FreeMind.app/Contents/Info.plist</code> and add the following key to the <br /><code><br />
&lt;key&gt;Java&lt;/key&gt; <br /><br />
&lt;dict&gt; </code><br />section:<br /><br />
<code><br />
&lt;key&gt;VMOptions&lt;/key&gt;<br /><br />
&lt;string&gt;-Xmx1024m&lt;/string&gt;<br />
</code><br />
<br />
=== Plugins not found when FreeMind 0.8 starts by double-clicking a FreeMind mind map ===<br />
<br />
The following Microsoft Windows laucher fixes the problem that plugins were not found when FreeMind was started by double-clicking a FreeMind mind map. Download the [http://sourceforge.net/tracker/index.php?func=detail&aid=1361629&group_id=7118&atid=307118 patch with fixed Windows launcher], and replace <tt>Freemind.exe</tt> found in <tt>C:\Program Files\FreeMind</tt> with the one found in the patch, given you are in Windows. Backing up the original <tt>Freemind.exe</tt> is advisable.<br />
<br />
=== Freemind 0.9.0RC4 can't quiet without saving ===<br />
I try to quit without saving (respond "No" to question) and it just goes back to map. Ended task with Task Manager on Windows and got same prompt and goes back to map again. Ending task a second time with Task Manager finally kills the program.<br />
<br />
== Using HTML in long nodes ==<br />
<br />
=== What HTML tags does FreeMind support? ===<br />
<br />
FreeMind supports basic HTML in its nodes. For HTML to take effect, a node must start<br />
with "&lt;html>". What HTML is supported depends on the Java virtual machine.<br />
Among others, users have reported the following uses:<br />
<br />
<nowiki><html><p style="background-color:yellow">the node text</p></nowiki><br />
<br />
<nowiki><html><p align="center">the node <br> text</p></nowiki><br />
<br />
=== To embed, or more precisely link, images into FreeMind. ===<br />
You can link images into FreeMind using context menu of a node, accessed using right click (on MAC OS X Panther use Control click). Or type the following:<br />
&lt;html&gt;&lt;img src=&quot;image.jpg&quot;&gt;&lt;/html&gt;<br />
where image.jpg is the reference to an image.<br />
<br />
=== To put the contents of a Microsoft Word document into FreeMind. ===<br />
<br />
* First paste the Word document into Microsoft FrontPage.<br />
* Delete the images afterwards as FreeMind does not support them.<br />
* Remove the &lt;head> ... &lt;/head> in the source text view in FrontPage.<br />
* But leave the &lt;html>! The node needs to start with that.<br />
* Replace &lt;body&gt; with &lt;body width=600&gt; or similar width specification.<br />
* Finally, paste the HTML text as a long node into FreeMind.<br />
<br />
=== To have tables in FreeMind ===<br />
If you have Microsoft Frontpage available, it is convenient to create and<br />
edit HTML content there and paste it to and from FreeMind. Beware that the html code has to start with<br />
''&lt;html&gt;''. This way, you can conveniently create tables using the drawing tools of Frontpage.<br />
You can create formatted text this way as well; in that case, beware to set ''&lt;body width=600&gt;''<br />
or similar. However, FreeMind does not interpret all HTML; especially, it does not interpret inline<br />
CSS styling so you have to use hard formatting instead.<br />
<br />
If you want the table borders to have a '''nice two dimensional look''' rather than bevelled, start<br />
the HTML as follows.<br />
<br />
<html><br />
<head><br />
<style> td { border-style: solid } table { border-style: solid } </style><br />
</head><br />
<br />
== Generating mind maps programmatically ==<br />
<br />
=== To insert a newline into a node ===<br />
<br />
Insert <code>&amp;#xa;</code> instead of plain newline. Example of a map with three newlines:<br />
<br />
<map version="0.7.1"><br />
<node TEXT="New Mindmap"><br />
<node TEXT="A&amp;#xa;B&amp;#xa;C&amp;#xa;D" POSITION="right"/><br />
</node><br />
</map><br />
<br />
=== To use unicode characters in the node text ===<br />
<br />
FreeMind understands and uses <code>&amp;#xnn;</code>, where nn is equivalent to the '''hexadecimal''' number representing the character. It '''does not''' understand <code>&amp;#nnn;</code>, where nnn is '''decimal''' number. An example of a map containing ''AretÃÂé'' follows. <br />
<br />
<map version="0.7.1"><br />
<node TEXT="Aret&amp;#xe9;"/><br />
</map><br />
<br />
== FreeMind on Microsoft Windows ==<br />
<br />
=== How do I install a test version of FreeMind? ===<br />
Just unzip the package to the folder "C:\Program Files\FreeMind". That completes the "installation".<br />
You can start it by running freemind.exe (or freemind.bat if the exe does not exist). You can find test versions [http://freemind.sourceforge.net/testversions/ here].<br />
<br />
=== FreeMind does not seem to be affected by the things I edit in the user.properties. Why? ===<br />
See [[user.properties]].<br />
<br />
=== FreeMind starts and reacts so slow. Why? How to resolve? ===<br />
This seems to be an effect of the connection between Java and MS DirectX. You can deactivate the usage of DirectX for Freemind by editing the Freemind.bat file in your FreeMind directory.<br />
<br />
Add the parameter<br />
<br />
-Dsun.java2d.noddraw=true <br />
<br />
before the final expression <tt>freemind.main.FreeMind</tt>.<br />
<br />
Of course, now you have to use Freemind.bat to start the program instead of executing Freemind.exe. Do not forget to update file associations as well: [[Windows File Associations]]<br />
<br />
<br />
==== SlickRun ====<br />
<br />
On Windows, if the application launcher utility [http://www.bayden.com/SlickRun/ SlickRun] is running at the same time as FreeMind, it causes FreeMind to (for some reason) respond very slowly. Possible workarounds: <br />
* Move FreeMind and SlickRun onto different monitors (on a multi-monitor system).<br />
* Close SlickRun while FreeMind is running.<br />
<br />
=== File Operations are slow ===<br />
With Java6 Update2 you will probably notice this [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6578753 bug]. Sun is working on it. Perhaps, you can downgrade to Java6 Update1 or Java5 in the meantime.<br />
<br />
=== To create a screenshot of FreeMind and paste it into Microsoft Word or Microsoft Powerpoint ===<br />
To take a screenshot of your whole windows screen into clipboard, press Ctrl + Print Screen. To take a screenshot<br />
of the active window only into clipboard, press Alt + Print Screen. Select your Word or Powerpoint document<br />
and press Ctrl + V. On German keyboard, the key PrintScreen has the label "Druck". However, such a screenshot<br />
also contains FreeMind's window frame, not just the map contents. In Microsoft Word and Microsoft Powerpoint, this<br />
can be solved by cropping the screenshot; the cropping tool can be found in Picture toolbar..<br />
<br />
===To export a map to Microsoft Powerpoint===<br />
There's no elegant way to export a map to PowerPoint. One option is to take a screenshot, and paste it into Powerpoint. PowerPoint supports graphic file insertion, so another option is upgrading to a more recent version of FreeMind that supports JPEG export.<br />
<br />
One another solution is by using a Flash plugin:<br />
<br />
1. Insert a control "Shockwave Flash Object" with the Control toolbar (go to display/toolbar/customise if not available).<br />
<br />
2. Activate the propeties window by double clicking on the rectangle of the object<br />
<br />
3. Click on the custom "property"<br />
<br />
4. On the new opened window set the "movie URL" to the full path of the plugin (i.e: c:\path\visorFreemind.swf)<br />
<br />
5. Set the "base URL" to the name of your freemind file (i.e.: index.mm) <br />
<br />
6. Start your diaporama and you will see the cross inside the rectangle replaced by your freemind map<br />
<br />
<br />
In PowerPoint 2007 --[[User:HugoContreras|HugoContreras]] 17:41, 5 Dec 2009 (UTC)<br />
<br />
4. On the new opened window set the property "movie" to '''visorFreemind.swf?xml_path=index.mm'''.<br />
<br />
5. Set the property "Play" to '''true'''. Set the property "EmbedMovie" to '''true'''.<br />
<br />
Save ppt file in the same location that visorFreemind.swf and index.mm<br />
<br />
<br />
If not successfull with those explanation, you will find a more complete information at the following address: [http://www.flashgeek.com FlashGeek]<br />
<br />
Or you can export to RTF using a XSLT like this:<br />
<br />
<?xml version="1.0" encoding="UTF-8" ?><br />
<br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><br />
<br />
<xsl:template match="/">{\rtf1\ansi\ansicpg1252<br />
{\fonttbl<br />
{\f1\fswiss\fcharset0\fprq0 Arial;}<br />
}<br />
{\colortbl;<br />
\red0\green0\blue0;<br />
}<br />
{\stylesheet<br />
{\s1\qc\f1\fs44\ppscheme-3\lang1110\level1 heading 1;}<br />
{\s2\li270\fi-270\f1\fs32\ppscheme-1\lang1110\level2 heading 2;}<br />
{\s3\li585\fi-225\f1\fs28\ppscheme-1\lang1110\level3 heading 3;}<br />
{\s4\li900\fi-180\f1\fs24\ppscheme-1\lang1110\level4 heading 4;}<br />
{\s5\li1260\fi-180\f1\fs20\ppscheme-1\lang1110\level5 heading 5;}<br />
{\s6\li1620\fi-180\f1\fs20\ppscheme-1\lang1110\level6 heading 6;}<br />
}<br />
<xsl:apply-templates /><br />
}<br />
</xsl:template><br />
<br />
<xsl:template match="node"><br />
\pard\plain\ltrpar\s1\qc\f1\fs44\ppscheme-3\lang1110{\f1 <br />
<xsl:value-of select="@TEXT"/>\par}<br />
<xsl:for-each select="child::node"><br />
\pard\plain\ltrpar\s2\li270\fi-270\f1\fs32\ppscheme-1\lang1110\li0\fi0\qc{\f1 <br />
<xsl:value-of select="@TEXT"/>\par}<br />
</xsl:for-each><br />
<xsl:apply-templates select="node" /><br />
</xsl:template><br />
<br />
</xsl:stylesheet> <br />
<br />
and then open it using PowerPoint.<br />
<br />
===To export / import a map to Microsoft Project===<br />
See [[Import and export]]<br />
<br />
== FreeMind on Mac OS X ==<br />
<br />
FreeMind is written in the Java language, which is great for development and deployment of cross-platform applications.<br />
Freemind uses the Swing graphical user interface toolkit, which can use different looks and feels in order to mimic visuals and behaviours proprietary to the target execution platforms.<br />
<br />
<br />
On Microsoft Windows OS, the application fits quite nicely with the rest of the environment, but on Apple MacOS-X, things are often not quite right. MacOS-X users usually have higher expectations when it comes to usability and UI consistency, so they might become frustrated by the lack of compliance to their user interface guidelines.<br />
<br />
<br />
Here are some tips to enhance the user experience when using MacOS-X:<br />
<br />
<br />
#Keyboard shortcuts<br />
#:The "Tao Of Mac" weblog posted a tip for replacing the "CTRL" key by the "COMMAND" (Apple) key:<br />
#:http://the.taoofmac.com/space/Applications/FreeMind<br />
#Look and feel<br />
#:"Quaqua" is a look and feel for Swing that emulates the Aqua user interface:<br />
#:http://www.randelshofer.ch/quaqua/download.html<br />
#Shift-click to select multiple nodes.<br />
<br />
<br />
<br />
== Using a default Save/Open Directory for FreeMind on Mac OS X ==<br />
<br />
This is a workaround that works for me. My biggest pain was navigating to my Maps directory with FreeMind everytime I wanted to save a new, or open an existing map. My Maps directory is ~/Documents/Maps. Here's the process to do so:<br />
<br />
* Copy your existing .freemind directory from ~ to ~/Documents/Maps or wherever you want your default Map save directory to be.<br />
<br />
* Go to /Applications/FreeMind.app -- using Finder. <br />
<br />
* Use Finder to Show Contents of the FreeMind App<br />
<br />
* Navigate to Contents/MacOS<br />
<br />
* Rename the "JavaApplicationStub" to "JavaApplicationStub.real"<br />
<br />
* Create an executable shellscript with the content below:<br />
<br />
<pre>#!/bin/sh<br />
export HOME=$HOME/Documents/Maps<br />
<br />
logger "================= Running FreeMind with new home"<br />
<br />
<br />
exec /Applications/FreeMind.app/Contents/MacOS/JavaApplicationStub.real<br />
</pre><br />
<br />
* Chmod +x on the shellscript (from Terminal)<br />
<br />
<br />
<br />
<br />
Done. You've now got a default save directory and open directory. This was a huge timesaver, evertime I fire up FreeMind, it saves me a lot of navigation and time.<br />
<br />
== FreeMind on Linux and other UNIX-like systems ==<br />
<br />
Go to the specific page [[FreeMind on Linux]].<br />
<br />
== Misc ==<br />
<br />
language = ja<br />
<br />
=== Is FreeMind mind mapping software? ===<br />
<br />
The term '''mind mapping''' is related to british psychologist Tony Buzan. In Buzan's context, mind map is a tree with many colors, pictures and personal expression. '''FreeMind is not''' really '''mind mapping''' software '''in the sense of Tony Buzan''', nevertheless, one would say that FreeMind belongs to the class of so called '''mind mapping software'''.<br />
<br />
Some of members of that class come pretty close to Buzan. Have a look at the site of first class commercial mind mapping software [http://www.mindjet.com/ MindManager]. You may also want to see [http://www.mind-mapping.co.uk/mind-maps-examples.htm examples] of mind maps in Buzan's sense.<br />
<br />
=== To spell FreeMind correctly. === <br />
"FreeMind", with a capital M.<br />
<br />
=== Where can I find a quick reference list of default keyboard shortcuts for the Windows 0.7.1 version? ===<br />
Here is a list of shortcuts, grouped by function:<br />
<br />
File commands:<br />
New map - Ctrl+N<br />
Open map - Ctrl+O<br />
Save map - Ctrl+S<br />
Save as - Ctrl+A<br />
Print - Ctrl+P<br />
Close - Ctrl+W<br />
Quit - Ctrl+Q<br />
Previous map - Ctrl+LEFT<br />
Next Map - Ctrl+RIGHT<br />
Export file to HTML - Ctrl+E<br />
Export branch to HTML - Ctrl+H<br />
Export branch to new MM file - Alt+A<br />
Open first file in history - Ctrl+Shift+W<br />
<br />
Edit commands:<br />
Find - Ctrl+F<br />
Find next - Ctrl+G<br />
Cut - Ctrl+X<br />
Copy - Ctrl+C<br />
Copy single - Ctrl+Y<br />
Paste - Ctrl+V<br />
<br />
Mode commands:<br />
MindMap mode - Alt+1<br />
Browse mode - Alt+2 <br />
File mode - Alt+3<br />
<br />
Node formatting commands:<br />
Italicize - Ctrl+I<br />
Bold - Ctrl+B<br />
Cloud - Ctrl+Shift+B<br />
Change node color - Alt+C<br />
Blend node color - Alt+B<br />
Change node edge color - Alt+E<br />
Increase node font size - Ctrl+L<br />
decrease node font size - Ctrl+M<br />
Increase branch font size - Ctrl+Shift+L<br />
Decrease branch font size - Ctrl+Shift+M<br />
<br />
Node navigation commands:<br />
Go to root - ESCAPE<br />
Move up - UP<br />
Move down - DOWN<br />
Move left - LEFT<br />
Move right - RIGHT<br />
Follow link - Ctrl+ENTER<br />
Zoom out - Alt+UP<br />
Zoom in - Alt+DOWN<br />
<br />
New node commands:<br />
Add sibling node - ENTER<br />
Add child node - INSERT<br />
Add sibling before - Shift+ENTER<br />
<br />
Node editing commands:<br />
Edit selected node - F2<br />
Edit long node - Alt+ENTER<br />
Join nodes - Ctrl+J<br />
Toggle folded - SPACE<br />
Toggle children folded - Ctrl+SPACE<br />
Set link by filechooser - Ctrl+Shift+K<br />
Set link by text entry - Ctrl+K<br />
Set image by filechooser - Alt+K<br />
Move node up - Ctrl+UP<br />
Move node down - Ctrl+DOWN<br />
<br />
To find the shortcuts in FreeMind, go into MindMap Mode, then "tools"-"preferences"-"keystrokes".<br />
<br />
=== To suggest new enhancements of FreeMind ===<br />
''Keywords: additional features, additional functions.''<br />
At FreeMind's project page, you can [http://sourceforge.net/tracker/?group_id=7118&atid=357118 submit Requests for Enhancements (RFEs)].<br />
<br />
=== Is MindMaster a rip off of FreeMind? ===<br />
<br />
''Update: the site of MindMaster is no longer there, thanks to Rezzie.''<br />
<br />
There is a [http://www.gigastorm.com/mindmaster/ web site] offering a product called MindMaster. This program is a ripped off version of FreeMind. It is not just a clone of FreeMind; it ''is'' just FreeMind renamed, and slightly modified. They even use the presentation texts as found on the main page of FreeMind. As FreeMind is licenced under GNU GPL, so must be MindMaster. However, on the MindMaster site and after the installation, they claim that they hold copyright to MindMaster, and that you are prohibited to use MindMaster unless you conform to their licence. This is unlawful. We urge you not to use or recommend MindMaster, and to avoid linking to their site or giving any recommendation. Also, you can write an email to them complaining about abuse of GNU General Public Licence. --[[User:Danielpolansky|Danielpolansky]] 11:15, 14 May 2005 (PDT)<br />
<br />
: I have been in contact with the author of [http://www.gigastorm.com/mindmaster/ MindMaster] and he has since removed the website and all links to the download. He did in fact claim it was released under the GPL and included both the licence and source code in the package, but as I didn't want to shell out $30 I cannot verify this. --[[User:Rezzie|Rezzie]] 23:49, 18 Oct 2005 (PDT)<br />
<br />
:: Thanks a lot. --[[User:Danielpolansky|Danielpolansky]] 09:50, 26 Oct 2005 (PDT)<br />
<br />
=== Where can I make a monetary donation to FreeMind? ===<br />
<br />
Currently, we do not accept any monetary donations. --[[User:Danielpolansky|Danielpolansky]] 00:32, 21 Nov 2005 (PST)<br />
<br />
== This FAQ ==<br />
<br />
=== I have a question not listed here, what should I do? ===<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page. Or specifically, ask your question in FreeMind's [http://sourceforge.net/forum/forum.php?forum_id=22102 Help forum]. Unfortunately, we cannot guarantee that you will get help, still, many users get it.<br />
<br />
=== To edit this FAQ ===<br />
Edit this page like any other wiki page (click edit or press alt-E). When adding a question to the talk page, imitate the format of already existing questions.<br />
<br />
=== Where can I practice editing pages on this Wiki? ===<br />
Click on this link and just hit the edit button on the lower right: [[Sandbox]]<br />
<br />
== Questions not yet answered ==<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page.<br />
<br />
Is FreeMind also Working under SuSe Linux 9.3 or perhaps already a part of the package?<br />
Answer: Yes, please see the "[[FreeMind on Linux]]" page here in the wiki.<br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Documentation&diff=8080
Documentation
2009-06-13T08:36:17Z
<p>Ewl: /* French */</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
==Application help as mind map==<br />
<br />
FreeMind comes with the documentation in the form of mind map, available from application menu ''Help > Documentation''. The documentation is a succint description of FreeMind functions, rather than a mind mapping text book. <br />
You can also browse the documentation now <mm>[[:Freemind.mm|applet|in a Java applet browser]]</mm> (with around 700 KB that requires Java 1.4.2 or later) which gives you a proper FreeMind feeling. And you can <mm>[[:FreemindFlash.mm|flash|try a much smaller flash based FreeMind map viewer]]</mm>.<br />
<br />
==Application help as HTML help==<br />
<br />
Help similar to the one delivered as a mind map is available in a form similar to Windows help, to be found in application menu ''Help > Help''.<br />
<br />
==PDF documentation==<br />
<br />
[http://www.geocities.com/shaila_kishore/Freemind PDF documentation], nice to print and much more professional looking than the application help, has been written by ''Shailaja Kumar''. It features illustrations, hand-holding detailed instructions, and index.<br />
<br />
==Wiki==<br />
<br />
This wiki serves as documentation as well, above all with [[Asked Questions]] page. All the documentation pages for FreeMind users are listed under [[:Category:Documentation|Documentation]] category. To see the content of the category, click down below at this page into the Categories box.<br />
<br />
==Web on mind mapping==<br />
<br />
To find out about mind mapping, consider searching the web, or buying yourself a book on mind mapping. Some links follow.<br />
<br />
* [http://en.wikipedia.org/wiki/Mind_map Mind map] at Wikipedia<br />
<br />
==Tutorials==<br />
* [http://www.gurushare.com/web/main/search.aspx?key=freemind Comprehensive video tutorials for Freemind] Training tutorials from GuruShare.com<br />
* [http://toncar.cz/Tutorials/MindMaps/getting_started_with_freemind.html Getting Started with Freemind]<br />
* [http://www.vimeo.com/freemindsoftware A series of videos showing FreeMind's usage]<br />
* [http://samos29.blogspot.com A french blog about Freemind] : news, tutorials (text and videos), tests,... Blog francophone développé autour de Freemind : informations sur Freemind, nouveautés, tutoriels (textes et vidéos Flash), tests,...<br />
<br />
==Printed books==<br />
<br />
===English=== <br />
<br />
* [http://www.amazon.com/gp/product/0452273226/qid=1148920602/sr=2-1/ref=pd_bbs_b_2_1/002-2747381-4796064?s=books&v=glance&n=283155The Mind Map Book : How to Use Radiant Thinking to Maximize Your Brain's Untapped Potential (Paperback)] by Tony Buzan, Barry Buzan at Amazon.com<br />
* [http://www.amazon.com/gp/product/042512780X/qid=1148920602/sr=2-2/ref=pd_bbs_b_2_2/002-2747381-4796064?s=books&v=glance&n=283155Mindmapping: Your Personal Guide to Exploring Creativity and Problem-Solving (Paperback)] by Joyce Wycoff at Amazon.com<br />
<br />
===German===<br />
<br />
There is a German book dedicated specifically to FreeMind.<br />
{| cellpadding="20" cellspacing="0" border="0"<br />
|http://bomots.de/freemind/freemind_cover.png<br />
| [http://bomots.de/freemind Helmut F. Reibold<br>Mindmapping mit FreeMind<br>bomots-Verlag<br>ca. 220 Seiten<br>erschienen 10.09.06]<br />
|}<br />
<br />
===French===<br />
And even a French one: "Boostez votre efficacité avec FreeMind : Bien démarrer avec le Mind Mapping" de Xavier Delengaigne et Pierre Mongin (sans vouloir faire de pub: en vente dans toutes les bonnes librairies en ligne).<br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Documentation&diff=7928
Documentation
2009-06-13T08:35:48Z
<p>Ewl: /* Printed books */ add French book</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
==Application help as mind map==<br />
<br />
FreeMind comes with the documentation in the form of mind map, available from application menu ''Help > Documentation''. The documentation is a succint description of FreeMind functions, rather than a mind mapping text book. <br />
You can also browse the documentation now <mm>[[:Freemind.mm|applet|in a Java applet browser]]</mm> (with around 700 KB that requires Java 1.4.2 or later) which gives you a proper FreeMind feeling. And you can <mm>[[:FreemindFlash.mm|flash|try a much smaller flash based FreeMind map viewer]]</mm>.<br />
<br />
==Application help as HTML help==<br />
<br />
Help similar to the one delivered as a mind map is available in a form similar to Windows help, to be found in application menu ''Help > Help''.<br />
<br />
==PDF documentation==<br />
<br />
[http://www.geocities.com/shaila_kishore/Freemind PDF documentation], nice to print and much more professional looking than the application help, has been written by ''Shailaja Kumar''. It features illustrations, hand-holding detailed instructions, and index.<br />
<br />
==Wiki==<br />
<br />
This wiki serves as documentation as well, above all with [[Asked Questions]] page. All the documentation pages for FreeMind users are listed under [[:Category:Documentation|Documentation]] category. To see the content of the category, click down below at this page into the Categories box.<br />
<br />
==Web on mind mapping==<br />
<br />
To find out about mind mapping, consider searching the web, or buying yourself a book on mind mapping. Some links follow.<br />
<br />
* [http://en.wikipedia.org/wiki/Mind_map Mind map] at Wikipedia<br />
<br />
==Tutorials==<br />
* [http://www.gurushare.com/web/main/search.aspx?key=freemind Comprehensive video tutorials for Freemind] Training tutorials from GuruShare.com<br />
* [http://toncar.cz/Tutorials/MindMaps/getting_started_with_freemind.html Getting Started with Freemind]<br />
* [http://www.vimeo.com/freemindsoftware A series of videos showing FreeMind's usage]<br />
* [http://samos29.blogspot.com A french blog about Freemind] : news, tutorials (text and videos), tests,... Blog francophone développé autour de Freemind : informations sur Freemind, nouveautés, tutoriels (textes et vidéos Flash), tests,...<br />
<br />
==Printed books==<br />
<br />
===English=== <br />
<br />
* [http://www.amazon.com/gp/product/0452273226/qid=1148920602/sr=2-1/ref=pd_bbs_b_2_1/002-2747381-4796064?s=books&v=glance&n=283155The Mind Map Book : How to Use Radiant Thinking to Maximize Your Brain's Untapped Potential (Paperback)] by Tony Buzan, Barry Buzan at Amazon.com<br />
* [http://www.amazon.com/gp/product/042512780X/qid=1148920602/sr=2-2/ref=pd_bbs_b_2_2/002-2747381-4796064?s=books&v=glance&n=283155Mindmapping: Your Personal Guide to Exploring Creativity and Problem-Solving (Paperback)] by Joyce Wycoff at Amazon.com<br />
<br />
===German===<br />
<br />
There is a German book dedicated specifically to FreeMind.<br />
{| cellpadding="20" cellspacing="0" border="0"<br />
|http://bomots.de/freemind/freemind_cover.png<br />
| [http://bomots.de/freemind Helmut F. Reibold<br>Mindmapping mit FreeMind<br>bomots-Verlag<br>ca. 220 Seiten<br>erschienen 10.09.06]<br />
|}<br />
<br />
===French===<br />
And even a French one: "Boostez votre efficacité avec FreeMind : Bien démarrer avec le Mind Mapping" de Xavier Delengaigne et Pierre Mongin (sans vouloir faire de pub: en vente dans toutes les bonnes librairies on-line).<br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Asked_questions&diff=7290
Asked questions
2008-12-14T12:46:03Z
<p>Ewl: /* Troubleshooting */ Add recommendation to check with other Java program</p>
<hr />
<div><!-- spam removed --><br />
<table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
Here we collect a list of asked questions and answers related to free mind mapping software FreeMind. Help if you can (see [[#To edit this FAQ|To edit this FAQ]]). If you're searching for an answer to your question, why don't you just press Ctrl + F in your browser?<br />
<br />
== Installation ==<br />
<br />
=== How do I download the Java Runtime Environment needed to run FreeMind. ===<br />
To download JRE for Windows, go to [http://java.sun.com/j2se/1.4.2/download.html Download on Sun],<br />
go to the section '''Download J2SE v 1.4. ...'''<br />
and now choose the column [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&amp;PartDetailId=j2re-1.4.2_03-oth-JPR&amp;SiteId=JSC&amp;TransactionId=noreg JRE], ''not SDK''. The installation file of JRE has approximately 15 MB.<br />
<br />
=== I start FreeMind but nothing happens ===<br />
First of all, we assume that you are working under Windows. Now, please start freemind.bat in the installation directory.<br />
You'll probably get:<br />
<br />
Exception in thread "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
<br />
at freemind.main.FreeMind.getLogger(FreeMind.java:643) <br />
at freemind.main.FreeMind.<init>(FreeMind.java:109) <br />
at freemind.main.FreeMind.main(FreeMind.java:647) <br />
<br />
The answer to this behaviour is that you've got Java1.3 or lower installed, and this version of java is found (try java -version on the commandline to verify this). <br />
Most likely, you've installed Oracle. <br />
Change JAVA_HOME and the PATH variables to point to your actual java (1.4 or 5.0). <br />
This can be done as follows: Goto Settings -> System -> search for Environment Variables and change or create the values accordingly.<br />
<br />
Another Reason Freemind won't start or will give you the effect of having the icon in the Windows taskbar but nothing else is when you install Freemind in a folder which start with a "!" (exclamation mark), just install it in a different folder. (see http://www.cogmios.nl/java-apps-like-eclipse-or-freemind-do-not-run-in-folders-starting-with-a-20070407.html)<br />
<br />
<br />
=== I start FreeMind but nothing happens <i>TRY THIS FIRST</i>===<br />
First, check that Java is installed; Then go to Program Files\Freemind\Lib and double-click on the "Freemind.jar" file (which is an executable Jar file). <br />
<br />
Alternatively, try to start Freemind from the freemind.bat file. The command.com will open along with Freemind. Just close down Freemind (command.com will close also) and then start Freemind from the Start Menu or from freemind.exe I have no idea why this works but it did for me.<br />
<br />
Another reason why Freemind won't start is if you hava JDK installed and JAVA_HOME points to JDK instead of JRE. If you point JAVA_HOME environment variable to the JRE home then Freemind.exe starts up fine.<br />
<br />
=== I start FreeMind and can create a map but can not save it ===<br />
The most obvious indication is that you click on open/save/save as and nothing happens. What is happening is that the file browser window is failing to open. There are two fixes; Either change JAVA_HOME to point to a JRE rather than a JDK or edit the Freemind.bat file to use the absolute path to the correct java and start Freemind with the bat file. It will be something like "C:\Program Files\Java\jre1.6.0_05\bin\java" instead of just java. Note the use of quote marks and that your java path may not be the same as the example. <br />
=== I start FreeMind but nothing happens on MacOS X Leopard ===<br />
I launch FreeMind 0.8.1 on MacOS X 10.5 (Leopard), the FreeMind welcome image appears and after few moments, FreeMind quit after a pop up window "Cannot lunch Java application (Uncaught exception in main method Java.lang.OutOfMemoryError Java heap space)".<br />
<br />
This issue might be related to the problem met by OpenOffice users on Leopard. <br />
Apple seems to have replaced "Apple Computer, Inc." by "Apple, Inc." in the Java string. The JRE is thus not recognized anymore on Leopard, and Java fail. ([http://user.services.openoffice.org/en/forum/viewtopic.php?f=17&t=153 Web Reference])<br />
<br />
Hope this issue will be fixed in the next FreeMind release.<br />
<br />
'' '''Temporary Solution''' '' : ''It is possible de launch FreeMind via FreeMind.app > Content > Resources > Java > lib > freemind.jar''<br />
<br />
''I suggest to place an alias in the Dock, for a more friendly access to FreeMind''<br />
<br />
'''''I was able to get FreeMind 0.9.0 beta 20 to launch on Mac OS X 10.5.5 (Leopard) by editing the Info.plist <tt>JVMVersion</tt> string to read <tt>1.6</tt> instead of <tt>1.4+</tt>. For the record, when I run <tt>java -version</tt> it reports <tt>java version "1.5.0_16"</tt>.'''''<br />
<br />
=== FreeMind cannot detect new version of Java. What can I do? ===<br />
Let us assume that you have installed a new<br />
version of Java, and still, FreeMind complains about having old version of Java. This may occur especially<br />
if you installed ''SDK'' rather than ''JRE''. ''SDK'' stands for ''software development kit'' and contains much more<br />
than you need to run FreeMind; you only need the runtime environment. It is important that the new version of<br />
java is in your ''path''. To check it out on Microsoft Windows, run command ``cmd" using Windows-key + R,<br />
followed by ``java -version". You should get something like<br />
<br />
java version "1.4.2_03"<br />
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_03-b02)<br />
Java HotSpot(TM) Client VM (build 1.4.2_03-b02, mixed mode)<br />
<br />
where the particular version number is not important as long as it is at least 1.4.0.<br />
<br />
Additionally, it may be helpful to start '''freemind.bat''' and see what messages come.<br />
<br />
'''NOTE:''' If you have an Oracle database product installed on your computer, check the Oracle Installer to see what version of Java was installed with the database. Versions of Oracle 8, 8i, and later install JRE 1.3.1 and modify the startup path for Windows to ensure the database can start using this JRE. This installation WILL cause FreeMind to report the older version of Java, even if you install the new version (the .ini file for Oracle points Windows to the JRE 1.3.1 directory, places that in memory, and causes the fault). You can modify the .ini file to point Oracle to the newer JRE. <br />
<br />
If you don't want to change the Oracle settings: just create a batch file in the FreeMind folder with the following entry "Path-to-your-new-java-runtimes-bin/java.exe -jar lib/freemind.jar" and use that to start freemind.<br />
<br />
=== Which Java virtual machines does FreeMind actually work with? ===<br />
<br />
FreeMind works with the virtual machines from Sun, from the version 1.4.0 and higher. FreeMind has been reported to run on the JDK 1.4.2 from Blackdown. FreeMind also works on Linux with Sun Microsystems 64bit JDK version 1.5.0.<br />
<br />
There are known issues with official release 0.8.0 of Freemind and Java 6. <br />
* Encrypted nodes will wipe out your map when trying to save it to disk. <br />
* Preferences dialog can not be opened<br />
Stick to Java 5 (alias 1.5.x) [https://sourceforge.net/tracker/?func=detail&atid=107118&aid=1550792&group_id=7118 (see bug report)]<br />
<br />
Possible cause and work-around for problem of Preferences dialog: extended desktop (second monitor). If you extend your desktop on to a second monitor and use FreeMind on that monitor, when you close (save?) the Preferences dialog, its dialog is saved to the extended desktop location. The next time you use FreeMind without using the 2nd monitor, the Preferences dialog will not be visible. I had this problem and was able to correct it by moving the dialog back to the main monitor and saving again (note that the virtual position of the 2nd monitor relative to the main monitor is important for finding the dialog again).<br />
-RyanC, 7-Apr-08<br />
<br />
=== What is a mirror? ===<br />
A mirror is one of the SourceForge sites from which you can download FreeMind. To download FreeMind, choose ''any'' mirror; you would prefer a mirror geographically closer to the place where you live. If you experience problems with one mirror, try another.<br />
<br />
=== I run 'freemind.bat' and get an error message ===<br />
If you get <br />
Exception in thread "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
at freemind.main.FreeMind.getLogger<FreeMind.java:643>at<br />
freemind.main.FreeMind.<init<FreeMind.java:109> <br />
at freemind.main.FreeMind.main<FreeMind.java:647> <br />
then the Java Virtual Machine found on your system is of version 1.3 or below. Try <br />
java -version<br />
to verify this. This happens, when you install Oracle for instance. Please, make sure, that your latest Java Virtual Machine is found when you type "java -version" by deinstalling java1.3 for example.<br />
<br />
=== USB Portable FreeMind ===<br />
Just add the following Java option in the freemind.bat or freemind.sh and everything is contained on the USB stick:<br />
<br />
-Duser.home=.[\<subdirectory, if needed>]<br />
<br />
As an example see the new content of my BAT-file, which looks like:<br />
<br />
@echo off<br />
java -Duser.home=. -cp lib\freemind.jar;lib\commons-lang-2.0.jar;lib\forms-1.0.5.jar;lib\jibx\jibx-run.jar;lib\jibx\xpp3.jar;lib\bindings.jar freemind.main.FreeMindStarter<br />
<br />
This lets FM create and use the subfolder .freemind in the location of the freemind.bat.<br />
<br />
As we know, USB flash drives support only limited number of writes. It means that reliability of such device drops down as time advances. Freemind, by default, saves your open maps every minute to .freemind dir which is in this case on the flash drive. If you aren't too paranoid you can avoid this by setting autosave dir to tmp dir of your OS. Freemind will automatically delete autosaves on exit so your precious data won't be left on a host machine. Go to Tools->Preferences->Path to automatic saves and set it to 'default'. Freemind will understand this on Windows probably as c:\windows\temp, Linux - /tmp or /var/tmp.<br />
<br />
That's it and have fun!<br />
<br />
=== What if the command.com window opened by FreeMind.bat annoys me? ===<br />
You can force the window not to show by having the batch file not to hold the handle to the java runtime. Effectively the command prompt is waiting for the java application, FreeMind, to terminate before it closes. You can solve this by forcing the command prompt to start a new process for java. Try editing the FreeMind.bat to prepend the <tt>java -cp lib\freemind.jar;...</tt> line with <tt>START "" </tt>. (Becomes something like <tt>START "" java -cp lib\freemind.jar;...</tt><br />
<br />
== Troubleshooting ==<br />
<br />
Before you start asking questions on the forum, it's a good idea to check if your problem is not already described, together with a resolution:<br />
* either on this page,<br />
* or in the Forums, there is a search function (check the SourceForge menu 'Forums &rarr; Search'),<br />
* or even in the Trackers, where you can find already reported problems.<br />
<br />
If this doesn't help, then sample the following information (under Windows, check the specific pages for other OS's) and create a Help forum topic (if you're not sure) or bug tracker item (if you're quite sure that it's a bug in FreeMind) with it:<br />
<br />
* OS version (e.g. Win XP with(out) SP2 or 3)<br />
* Java version (the output of <tt>java -version</tt> called from the command line, example as follows)<br />
C:\Users\lostuser>java -version<br />
java version "1.5.0_15"<br />
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_15-b04)<br />
Java HotSpot(TM) Client VM (build 1.5.0_15-b04, mixed mode, sharing)<br />
* FreeMind version (e.g. FreeMind 0.9.0.Beta20, installed from <tt>FreeMind-Windows-Installer-0.9.0_Beta_20-max.exe</tt>)<br />
* Content of the logfile <tt>%USERPROFILE%\.freemind\log.0</tt> after you've done the action making problems.<br />
* It's also a good idea to open a command line, go to FreeMind's base directory, in general with <tt>cd %ProgramFiles%\freemind</tt>, and start FreeMind from there, using the <tt>freemind.bat</tt> file, and check what happens in the console. Most content is generally similar to the above logfile, but not if FreeMind doesn't even start, for some reason (e.g. Java missing).<br />
* Check if your problem also appears with other Java programs, we generally recommend [http://jedit.sf.net/ JEdit] because it uses the same GUI type (called [http://en.wikipedia.org/wiki/Swing_(Java) Swing]) as FreeMind.<br />
<br />
;Note: under Windows XP/Vista, you can open a command line (also called a console) by pressing the keys <tt>Win+R</tt> (like Run), type <tt>cmd</tt> and press enter.<br />
<br />
== Using ==<br />
<br />
=== To add a new concept ===<br />
<br />
A new concept is referred to as a "node." Use the "Insert" key on PCs to add a new node. MAC users need to [[Asked Questions#To_set_a_different_key_for_new_child_node_on_Mac_computers | set a different key]]. Nodes are not limited to just concepts. They can also include sentences, paragraphs or even short articles.<br />
<br />
=== Is there an undo feature in FreeMind? ===<br />
Starting with FreeMind 0.8, there is an undo and redo feature.<br />
<br />
If you are using 0.7, then use the following tips to prevent data loss:<br />
<br />
* Use FreeMind's autosave-feature <br />
: This feature is enabled by default... auto saved files will be found in ~/.freemind/<br />
<br />
* Install a clipboard manager, which will make all elements, which you cut from FreeMind, available in its history. A freeware example of a clipboard manager for MS Windows is [http://www.yankee-clipper.net Yankee Clipper].<br />
<br />
=== How much memory do I need? === ''Keywords: RAM.''<br />
Experience shows that 64 MB is not sufficient, while 128 MB is already enough, provided that you do not run another Java application. Correct me if I'm wrong. I am using FreeMind on Windows 95 + 128 MB without any problems.<br />
<br />
Running FreeMind 0.8RC5 on Windows 95 with 64 MB and Java 1.4.0 is possible and the response time ''is'' in acceptable limits. -- [[User:Stefano|Stefano]] 02:01, 11 Jul 2005 (PDT)<br />
<br />
Running FreeMind 0.7.1 on Debian Linux and Java 1.4.2.03 (j2sdk1.4) with my Omnibook 800 laptop (78 MB RAM, P166) just fine. I haven't tried any big projects with it yet, but so far it's very responsive. --[[User:Nullman|Kyle]] 09:14, 30 Jan 2006 (PST)<br />
<br />
=== To move a node to the other side of root ===<br />
Drag the node onto root and you see one half of root getting gray. Move the node to the other half and <br />
this half gets gray. Just drop the node on the side you want to have it.<br />
As of version 0.9.0 you can also use Ctrl+left and Ctrl+right to move a node in the desired direction (not only to change the side with respect to root, try it out).<br />
<br />
=== To create a graphical link ===<br />
<br />
# Go to the source node. <br />
# Mark it with the mouse. <br />
# Press the left mouse button. <br />
# Hold this button. <br />
# Press Ctrl+Shift buttons. <br />
# Continue to hold all these buttons. <br />
# Go to the destination node. <br />
# Release the mouse button, first. <br />
# Then release the keyboard buttons. <br />
<br />
You have your link. Alternatively, drag'n drop holding right mouse button.<br />
<br />
=== To remove a graphical link ===<br />
<br />
# Right-Click on the curved arrow of the graphical link (Mac users, press Control and click to see the options menu)<br />
# Choose "Remove Arrow Link" from the pop-up menu<br />
<br />
(Left-clicking on a graphical link does nothing)<br />
<br />
=== To add user icons to FreeMind ===<br />
Currently, adding user [http://www.guiicons.com Icons] is not possible.<br />
BUT you can add an inline images to any node. Use the following code example:<br />
<nowiki><html><img src="http://www.stumbleupon.com/pics/me.jpg"></nowiki><br />
in a FreeMind node. This should also work with local files using "file://" instead of "http://".<br />
<br />
=== To open links in only one browser window, rather than several. ===<br />
To our knowledge this is not possible at the moment.<br />
<br />
'''Firefox (old)''' allows this option. ''From the menu, select''<br />
1) Tools > '''Options''' > <br />
2) Click '''Advanced'''<br />
3) Toggle Tabbed Browsing<br />
4) Select to open links from other apps in<br />
...a new tab in the most recent window.<br />
<br />
'''Firefox (1.5.0.12)''' allows this option. ''From the menu, select''<br />
1) Edit > '''Prefernces''' > <br />
2) Click '''Tabs'''<br />
3) Select to open links from other apps in<br />
...a new tab in the most recent window.<br />
<br />
<br />
'''A possible Work Around:''' There is a way to do this if you use the [http://www.mozilla.org/products/firefox/ Firefox browser] instead of Internet Explorer, provided you<br />
install the Firefox extension called ''Single Window'' (available from [http://update.mozilla.org/extensions/showlist.php?category=Tabbed%20Browsing here]). Using this extension, every time you click on an external web link on a mind map, it will open the relevant page in a new tab in an existing Firefox window, rather than a new browser window. I have found this to be a much easier way to navigate the pages opened. I have only tried this with mm files opened from the file system at the moment (ie not served from a web server in the browser applet).<br />
<br />
To '''open external web links in a new tabs''' in Firefox follow [http://texturizer.net/firefox/tips.html#beh_reuse this tip] (works both for Linux and Windows). You have to add a line in your user.js file and install [http://piro.sakura.ne.jp/xul/_tabextensions.html.en Tabbrowser extensions].<br />
<br />
=== Is it difficult to provide FreeMind with Java Webstart?=== Well, it's not that easy. Joerg Mueller succeeded in doing just that and has sent his source code to Daniel Polansky, who did not succeed in getting it running; he did not consider that a high priority. What is important is that Microsoft Windows users have a convenient installer, and the users of the other operating systems are already used to not so convenient methods; the installation is pretty straightforward anyway.<br />
<br />
=== To create PDF out of FreeMind's mind map ===<br />
To create pdf out of FreeMind's mind map, you've got several<br />
options.<br />
<br />
* Use File/Export/As PDF...<br />
<br />
* Create DocBook, then pdf. Use [http://krottmaier.cgv.tugraz.at/docs/seminar/sem2002_mindmaps.tar.gz XSLT transformations sheets] from Christoph Rissner to convert FreeMind's mind map to Mind Manager's mind map, then to DocBook, and create pdf from that DocBook. You can read more on that on [http://hkrott.iicm.edu/veranstaltungen/seminar/abgeschlossen.html Abgeschlossene Arbeiten] &gt; Mind Maps.<br />
<!-- Old link to http://hkrott.iicm.edu/docs/seminar/sem2002_mindmaps.tar.gz would not work any --><br />
<br />
* Print to pdf using a pdf printer driver.<br />
** Use open source [http://sector7g.wurzel6.de/pdfcreator/index_en.htm PDFCreator]. It uses Ghostscript as its backend.<br />
<br />
* Print to pdf using Acrobat's Distiller. Provided that you have full version of Adobe Acrobat installed (not just reader), you can print to a pdf using the Distiller or Writer options in your printer list. Make sure you check the "fit to one page" option under File > Page Setup. Also, make sure you set antialias to all under edit > preferences. This will make it look crisper. The only downside to this option is that it doesn't do the icons very well.<br />
<br />
* First print to postscript, then convert to pdf.<br />
** In Linux, create postscript by printing to a file using a postscript printer, and convert the postscript file to pdf afterwards, by using the shell-command ps2pdf or using [http://www.cs.wisc.edu/~ghost/ Ghostscript].<br />
** In Windows, install any postscript color printer (Like AppleColor 600) to print to a file. When printing to that printer, choose a folder and a file that ends with .ps. Then, open that *.ps with [http://www.cs.wisc.edu/~ghost/gsview/index.htm gsview] and choose ''File/Convert to PDF'' (let the program choose it all). Then save the file with the same name, but ending with .pdf. That's all. You might need to read the help files to tune it all up (only once).<br />
<br />
* Export FreeMind's mind map to HTML, paste it into Microsoft Word, format it as you see fit, and convert it to pdf using the techniques decribed above.<br />
<br />
=== To convert mind maps between FreeMind and MindManager ===<br />
Click here: [[Import and export to other applications]]<br />
<br />
=== Who is the development team of FreeMind? ===<br />
<br />
Daniel Polansky: the director of FreeMind is Daniel Polansky, i.e. me. The<br />
label ``director" is not quite appropriate; ``parliament"<br />
would be better. I test new versions, give advice, sometimes<br />
act in the name of FreeMind, forbid versions to be released<br />
because of insufficient quality, and approve them when<br />
they're ready. Also, I set up barriers for new directions.<br />
<br />
The main actor on the scene is Christian Foltin. We use<br />
the label ``code master" to denote his role, and also<br />
``manager". He does most of the work and decides which<br />
code changes are acceptable what concerns the<br />
quality of code. He takes care of mergers. Also, he<br />
coordinates the developers.<br />
<br />
An important developer is Dimitri Polivaev.<br />
<br />
=== To have brainstorm-like mode similar to one found in MindManager.===<br />
Did you notice you can hit Enter and Shift-Enter to create sibling nodes?<br />
It is not exactly the behavior of brainstorm mode of MindManager, but still<br />
close to it.<br />
<br />
=== On what operating systems have people actually succeeded in running FreeMind?===<br />
<br />
* ''Microsoft Windows.'' Windows 95, Windows 98, Windows NT, Windows 2000, Windows XP (SP1 & SP2), Windows 2003 Server, Windows Vista.<br />
* ''Linux.'' Mandrake 9.2 and 10, RedHat Pro WS 3, Fedora Core 2, Fedora 8 & 9, SuSE (8.2 using the RPM for 9.0, 9.0, 9.1, 9.2, 9.3, 10.0, 10.2), Ubuntu (Warty, Hardy, Intrepid Ibis), Debian (sarge, sid), Slackware 9.1, Gentoo, Mepis 3.3.1, Mepis 3.4-2.rc1.<br />
* ''BSD.'' FreeBSD (5.2.1, 5.4, 6.1), Mac OS X (10.2.8, 10.3, 10.4.4, 10.4.8, 10.4.11)<br />
* ''Other.'' OS/2, Solaris 9 and 10.<br />
''Keywords: platforms.''<br />
<br />
=== Is there a PDA-Version, e.g. for Palm or Pocket PC? ===<br />
On PDA, you can use [[FreeMindPDA]]. It uses cross-platform [http://www.superwaba.com SuperWaba] Open Source SDK. However, it does not use mind map view, but rather plain tree view; it is not a proper FreeMind version in that sense. See also [[Stuff#PDA|FreeMind and PDA]].<br />
<br />
=== How large maps can I edit with FreeMind? ===<br />
<br />
In principle, there are no built-in limits. Practically, the maximum reported size is 11 MB at a map with 22,000 nodes; after exporting to HTML and pasting to Microsoft Word, the very same content had 15.6 MB, with 1500 pages. For a better practical estimation, experimental tests are needed, as the maximum given so far is only a lower bound on practical limits.<br />
<br />
I've been appending daily notes to a single mind-map file continually for many months on a 3 GHz Pentium 4 with 2 GB RAM running windowsXP. The file has grown to about half a megabyte, 420K, and there is a noticable difference in Freemind's responsiveness dealing with it, but it still works for me.<br />
<br />
=== How can I keep FreeMind from opening the last file from the last session? ===<br />
One way is to disable the changing of the file "auto.properties" (which is in the same folder as [[user.properties]]). Be aware that the menu "Edit -> Preferences" will not change anything any more than!<br><br />
To do that go to the file auto.properties and delete everything behind "onStartIfNotSpecified=" in that line. Now set the file "auto.properties" to read-only.<br />
<br />
Another way is to change the auto.properties on the fly during startup. Copy the next lines of code into a batch-file and put this into the same directory as freemind.exe. This batchfile will add an extra line to the auto.properties file. In fact, it does the same as the above, but it still enables you to change the properties.<br />
<br />
@echo off<br />
echo onStartIfNotSpecified= >> "%USERPROFILE%\.freemind\auto.properties"<br />
call .\freemind.exe<br />
<br />
===To change the fill color on bubbles.===<br />
There's an icon for it at the main toolbar. Additionally,<br />
you can find it in the popup menu at Node > Style > Cloud color.<br />
<br />
===To remove a cloud===<br />
Press Ctrl+Shift+B to toggle clouds.<br />
<br />
=== To search in FreeMind === <br />
''Keywords: find.'' Press Ctrl + F. For finding next occurrence, press Ctrl + G. Searching is<br />
restricted to the descendants of the node selected when pressing Ctrl + F. The search is<br />
a breadth-first search, first finding occurrences in the nodes closer to the starting node.<br />
<br />
===To move nodes around=== To move them up and down, use ctrl + up and down arrows. To move them wherever you want, use drag'n drop with mouse. ''Keywords: move around, reorganize.''<br />
<br />
=== What does antialias mean in FreeMind preferences? ===<br />
<br />
To antialias means to make fonts or curves look smooth by drawing additional pixels with in-between color. See also wikipedia on [http://en.wikipedia.org/wiki/Antialiasing antialiasing].<br />
<br />
By default, FreeMind antialiases edges only. FreeMind can also antialias text, but with the current state of the technology, it does not look good enough. At least, new Java RE 1.5.0 has better antialiasing of text than Java RE 1.4.x. Also, it is possible to set the whole application to antialiasing, including the menus and editing box; by using the command line option <code>-Dswing.aatext=true</code> of Java 1.5.0. Unfortunately, this is not available if you're using FreeMind.exe to launch FreeMind.<br />
<br />
=== What kind of encryption is used? ===<br />
<br />
: ''See [[Encryption]].''<br />
<br />
=== Reminders don't work when I start a map. The PDF-Export is not present. What's happening? ===<br />
There, the plugins (not only the PDF/SVG one) appear only if you start FreeMind from the directory where it has been installed. Especially if you start FreeMind by double-clicking on a FreeMind file (.mm file), this is not the case. So, use your icon and choose open to open your file.<br />
<br />
== Customizing FreeMind ==<br />
<br />
=== How do I add a new keyboard shortcut ===<br />
To add a new keyboard shortcut, say for "Change node background color", open the file<br />
mindmap_menus.xml (in freemind.jar) and search for "background", say.<br />
<br />
You'll find<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Here, you add a new keyboard ref attribute like:<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor" key_ref="keystroke_node_background_color"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Open the file freemind.properties and add a line like<br />
<pre><br />
#<br />
keystroke_node_color = alt F<br />
keystroke_node_color_blend = alt B<br />
keystroke_edge_color = alt E<br />
keystroke_node_background_color=alt N<br />
</pre><br />
But you have to search for free keys...<br />
<br />
=== To set expert settings ===<br />
<br />
Most of expert settings are stored in the [[user.properties]] file.<br />
<br />
=== To use another browser ===<br />
<br />
If you want to use another browser, edit the [[user.properties]] file and change the following property according to your operation system: <br />
<br />
default_browser_command_windows_nt <br />
default_browser_command_windows_9x <br />
default_browser_command_mac <br />
default_browser_command_other_os <br />
<br />
You have to write something like<br />
<br />
default_browser_command_windows_nt = C:\Program Files\Internet Explorer\iexplore.exe "{0}"<br />
...<br />
<br />
=== To change language ===<br />
<br />
Lydia<br />
<br />
language= ja<br />
<br />
language = ja <br />
<br />
Don't forget to remove the # character. Restart FreeMind and you have changed the language to German. See also [[Development#To_translate_FreeMind_into_your_language|the list of available languages]].<br />
<br />
=== To set a different key for new child node on Mac computers ===<br />
<br />
NOTE: The latest version of Freemind now sets the "tab" key as the default key for inserting a new node on a mac. Unfortunately, this is not documented in an obvious place. If you right or control click on a node you see a menu that does tell you the Tab shortcut for creating a child node but this is easily missed.<br />
<br />
In a manner similar to changing the language, replace<br />
<br />
#keystroke_add_child = INSERT <br />
<br />
with<br />
<br />
keystroke_add_child = control shift ENTER<br />
<br />
in the file [[user.properties]]. Pay attention that you write the key code ENTER in capital letters. <br />
<br />
N.B. Setting the ADD CHILD MAC is not enough, ADD CHILD must also be set (at least with Beta 9 on Leopard)<br />
<br />
This can also be done via the Freemind GUI by selecting Tools/Preferences/Keystrokes instead of editing the properties file.<br />
<br />
The command ("Apple") key can be referred to as "meta" in these keystroke sequences - in case you were wondering.<br />
<br />
=== There is no shortcut to insert a note. Why? ===<br />
There is no shortcut on purpose, as this action does not come with undo. <br />
<br />
If you want to have this shortcut, you can download the sources, patch NodeNote.xml such that it contains a key_stroke="alt N" in the first lines as here: <br />
<br />
<br />
<plugin_action <br />
documentation="%accessories/plugins/NodeNote.properties_documentation" <br />
name="%accessories/plugins/NodeNote.properties_name" <br />
base="freemind.extensions.NodeHookAdapter" <br />
'''key_stroke="alt N"''' <br />
icon_path="accessories/plugins/icons/knotes.png" <br />
label="accessories/plugins/NodeNote.properties" <br />
class_name="accessories.plugins.NodeNote" instanciation="Once"> <br />
<br />
<br />
compile and you are done. BUT REMEMBER: Pressing your key on a node, that already contains a note, makes this note to remove WITHOUT UNDO. <br />
<br />
At your own risk, Chris<br />
<br />
<br />
=== Using physical styles (or patterns) ===<br />
<br />
Physical styles and patterns are the same and can be compared to "styles" in a text writer: you define a set of styling attributes, give this set a name, and can then assign the style or pattern to different nodes in the same way.<br />
<br />
The patterns are defined in the file <tt>patterns.xml</tt> placed in the FreeMind user directory. In Windows, that file is <tt>C:\Documents and Settings\YourUserName\.freemind\patterns.xml</tt>; under Linux, it's <tt>~/.freemind/patterns.xml</tt>. The generic format of this file is the following:<br />
<br />
<?xml version="1.0" encoding="UTF-8"?><br />
<patterns><br />
<pattern name="Pattern1"><br />
[...pattern properties...]<br />
</pattern><br />
<pattern name="Pattern2"><br />
[...pattern properties...]<br />
</pattern><br />
[...more patterns...]<br />
</patterns><br />
<br />
As you can see from above, you need to give each pattern a unique name, and then you need to assign pattern properties. Each pattern property is of the form <tt><'''pattern_property_name''' value="'''property_value'''"/></tt>, or <tt><'''pattern_property_name'''/></tt>, and each property stands for a different format parameter. Where the property is listed without value attribute, the corresponding format is reset to its default value. The following property names are possible:<br />
<br />
* pattern_node_background_color<br />
* pattern_node_color<br />
* pattern_node_style<br />
* pattern_node_text<br />
* pattern_node_font_name<br />
* pattern_node_font_bold<br />
* pattern_node_font_italic<br />
* pattern_node_font_size<br />
* pattern_icon<br />
* pattern_edge_color<br />
* pattern_edge_style<br />
* pattern_edge_width<br />
* pattern_child<br />
<br />
==== Allowed values ====<br />
<br />
For colors, the format of the value is "#RRGGBB", where RR, GG, BB are the hexadecimal values of the red, green, blue components of a color, e.g. "#B3B95C".<br />
<br />
<code>pattern_icon</code> can take one of the following values:<br />
<br />
* help<br />
* messagebox_warning<br />
* idea<br />
* button_ok<br />
* button_cancel<br />
* full-1<br />
* full-2<br />
* full-3<br />
* full-4<br />
* full-5<br />
* full-6<br />
* full-7<br />
* back<br />
* forward<br />
* attach<br />
* ksmiletris<br />
* smily_bad<br />
* clanbomber<br />
* desktop_new<br />
* flag<br />
* gohome<br />
* kaddressbook<br />
* knotify<br />
* korn<br />
* Mail<br />
* password<br />
* pencil<br />
* stop<br />
* wizard<br />
* xmag<br />
* bell<br />
* bookmark<br />
* penguin<br />
* licq<br />
<br />
; TODO : Add more explanations about the possible values and exact impact for each property.<br />
<br />
==== Example(s) ====<br />
<br />
An example of a pattern is therefore:<br />
<br />
<pattern name="Blue with edges and icon"><br />
<pattern_node_background_color/><br />
<pattern_node_color value="#000099"/><br />
<pattern_node_style/><br />
<pattern_icon value="flag"/><br />
<pattern_edge_color value="#009999"/><br />
<pattern_edge_style/><br />
<pattern_edge_width value="4"/><br />
</pattern><br />
<br />
This information and more can be discovered by opening any .mm file in a text or XML editor. You can usually search for the text in an element to find the example of what you want to learn how to do.<br />
<br />
; Note : the complete list of pattern properties can be found in the source code, in the file <tt>freemind/freemind_actions.xsd</tt> (search for ''pattern_''), and the list of icons in the file <tt>freemind/modes/MindIcon.java</tt> (search for ''mAllIconNames.add'').<br />
<br />
== Mind maps on web pages with FreeMind's applet ==<br />
<br />
=== To get FreeMind's applet working. ===<br />
If you experience problems viewing a mind map published by someone else, the most common problem is that you have to use Java >= 1.4 in your browser. Check this using the "About plugins" section of your browser (or a similar place). If you have Java >= 1.4 installed and still experiencing problems check out Internet Explorer's settings by selecting Tools > Internet Options > Advanced > Java and make sure ``Use Java2" is enabled.<br />
<br />
=== To present your mind map on the web ===<br />
Use FreeMind's browser applet. The following [http://freemind.sourceforge.net/docs/Serving%20Freemind%20maps%20in%20a%20browser/index.html document] (thanks to Bob) explains what to do to have a complete testing environment for your applet. <br />
<br />
=== Quick Java Applet instructions if you are already a code wiz ===<br />
<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" ARCHIVE="freemindbrowser.jar" <br />
WIDTH="100%" HEIGHT="80%"><br />
<PARAM NAME="type" VALUE="application/x-java-applet;version=1.4"><br />
<PARAM NAME="scriptable" VALUE="false"><br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
<\!-- ^ this has no effect on my pc --><br />
<PARAM NAME="modes" VALUE="freemind.modes.browsemode.BrowseMode"><br />
<PARAM NAME="browsemode_initial_map" VALUE="http://www.osde.info/osde.mm"><br />
<\!-- ^ Put the FULL path to your map here --><br />
<param NAME="initial_mode" VALUE="Browse"><br />
<param NAME="selection_method" VALUE="selection_method_direct"><br />
</APPLET><br />
<br />
In some cases, it may be necessary to set the '''ARCHIVE''' property to also use the '''Full Path''' to the .jar file. In the above example, the initial '''APPLET''' element would appear as:<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" <br />
ARCHIVE="http://www.exmaple.com/freemindbrowser.jar" WIDTH="100%" HEIGHT="80%"><br />
<br />
The most recent version of above source and freemindbrowser.jar are contained in the freemindbrowser.zip-Archive, which you can get from [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=16120 the sourceforge-site].<br />
<br />
=== To view the toolbar automatically after the applet starts ===<br />
It is necessary to edit the html starter of the applet and change the corresponding property. That is, set<br />
toolbarVisible=true. More precisely, add a tag <br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
to freemindbrowser.html or whatever name you have changed the file to.<br />
<br />
=== Is there a list of names and values and functions of all params for the applet? ===<br />
No. Theoretically, all parameters found in user.properties can be used as parameters of the applet.<br />
<br />
<br />
=== Is it possible to change or edit the map through an applet? ===<br />
<br />
No. There is no applet for ''editing'' mind maps; only for viewing.<br />
<br />
=== My document isn't opened by the applet ===<br />
<br />
The URL of the document *must* end with .mm. If it doesn't the document opens in a new browser window. The trick I use is to append a dummy parameter like in this example:<br />
<br />
http://myserver/mypath/mydoc?e=.mm<br />
<br />
This trick is specially useful for dynamic documents. (this is an opinion only. Some people, like Garito, thinks in another way)<br />
<br />
===Java Applet for XHTML===<br />
<br />
The same Freemind Browser can be used but instead of using the 'applet' element, the 'object' element can be used instead. Using Shayne Steele's [http://ww2.cs.fsu.edu/~steele/XHTML/appletObject.html approach], the following code can be used for placing a file called Textbook.mm that is located in http://example.com/freemind/ (along with the freemindbrowser.jar file):<br />
<br />
&lt;!--[if !IE]--&gt;<br />
&lt;object classid="java:freemind.main.FreeMindApplet.class"<br />
type="application/x-java-applet"<br />
archive="http://example.com/freemind/freemindbrowser.jar"<br />
width="450" height="300"&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
&lt;object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"<br />
codebase="http://java.sun.com/update/1.5.0/jinstall-1_5_0-windows-i586.cab"<br />
height="300" width="450"&gt;<br />
&lt;param name="code" value="freemind.main.FreeMindApplet" /&gt;<br />
&lt;param name="archive" value="http://example.com/freemind/freemindbrowser.jar" /&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;strong&gt;<br />
This browser does not have a Java Plug-in.<br />
&lt;/strong&gt;<br />
&lt;br /&gt;<br />
&lt;a href="http://java.sun.com/products/plugin/downloads/index.html"&gt;<br />
Get the latest Java Plug-in here.<br />
&lt;/a&gt;<br />
&lt;/object&gt;<br />
&lt;!--[if !IE]&gt;--&gt;<br />
&lt;/object&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
<br />
It works and it is valid markup. If placing in an HTML file, use '&gt;' instead of ' /&gt;' for the param element ending.<br />
<br />
== Workarounds in FreeMind ==<br />
<br />
===FreeMind behaves strange or crashes. What can I do?===<br />
First try reinstalling both Java (mostly the latest version is best) and Freemind. Often this solves problems. <br />
One of the problems solved in this way was:<br />
<br />
'' ''My computer crashes, or more precisely locks, when I click on a link in FreeMind, using J2RE 1.4.2_03 on Windows 98. Reinstalling helped. In retrospect, I think what broke it was that I renamed the J2RE directory to something easier to write in the bat file path statement. Broke it. ''<br />
<br />
=== When I drag files into the FreeMind window, FreeMind just works very long or I get a mind map of the file system ===<br />
This is a bug which is a least present on FreeMind 7.2 beta and lower on Windows. I only know of a workaround for this: Go to the [[user.properties]] and delete ",freemind.modes.filemode.FileMode". This disables the file mode of FreeMind.<br />
<br />
=== Changing the key bindings in user.properties does not work ===<br />
It seems that capitalization IS important in the keybindings. I wrote "enter" and it didn't work. I changed it to "ENTER" and it worked!<br />
(FreeMind 7.2 beta)<br />
<br />
=== FreeMind fails to work with or to export big maps ===<br />
When FreeMind fails to work with big maps, you may do the following.<br />
<br />
Assign more memory to the Java virtual machine as a workaround by editing the launching script. Edit <code>freemind.bat</code> or <code>Freemind.sh</code> and add a <code>-Xmx''MEM''</code> parameter to the <code>java</code> command line at the end of the script, like <code>java -Xmx512m ...</code> for 512 megabytes maximum memory and <code>java -Xmx768m ...</code> for 768 megabytes maximum memory. Believing the manual of Java, the default is 64 MB and the maximum is slightly less than 2000 on an x86 processor, which should be enough.<br />
<br />
Beware that exporting may still take a while. For instance, it may take 11 minutes to export a mind map with 740 nodes to JPEG.<br />
<br />
=== Plugins not found when FreeMind 0.8 starts by double-clicking a FreeMind mind map ===<br />
<br />
The following Microsoft Windows laucher fixes the problem that plugins were not found when FreeMind was started by double-clicking a FreeMind mind map. Download the [http://sourceforge.net/tracker/index.php?func=detail&aid=1361629&group_id=7118&atid=307118 patch with fixed Windows launcher], and replace <tt>Freemind.exe</tt> found in <tt>C:\Program Files\FreeMind</tt> with the one found in the patch, given you are in Windows. Backing up the original <tt>Freemind.exe</tt> is advisable.<br />
<br />
== Using HTML in long nodes ==<br />
<br />
=== What HTML tags does FreeMind support? ===<br />
<br />
FreeMind supports basic HTML in its nodes. For HTML to take effect, a node must start<br />
with "&lt;html>". What HTML is supported depends on the Java virtual machine.<br />
Among others, users have reported the following uses:<br />
<br />
<nowiki><html><p style="background-color:yellow">the node text</p></nowiki><br />
<br />
<nowiki><html><p align="center">the node <br> text</p></nowiki><br />
<br />
=== To embed, or more precisely link, images into FreeMind. ===<br />
You can link images into FreeMind using context menu of a node, accesed using right click (on MAC OS X Panther use Control click). Or type the following:<br />
&lt;html&gt;&lt;img src=&quot;image.jpg&quot;&gt;&lt;/html&gt;<br />
where image.jpg is the reference to an image.<br />
<br />
=== To put the contents of a Microsoft Word document into FreeMind. ===<br />
<br />
* First paste the Word document into Microsoft FrontPage.<br />
* Delete the images afterwards as FreeMind does not support them.<br />
* Remove the &lt;head> ... &lt;/head> in the source text view in FrontPage.<br />
* But leave the &lt;html>! The node needs to start with that.<br />
* Replace &lt;body&gt; with &lt;body width=600&gt; or similar width specification.<br />
* Finally, paste the HTML text as a long node into FreeMind.<br />
<br />
=== To have tables in FreeMind ===<br />
If you have Microsoft Frontpage available, it is convenient to create and<br />
edit HTML content there and paste it to and from FreeMind. Beware that the html code has to start with<br />
''&lt;html&gt;''. This way, you can conveniently create tables using the drawing tools of Frontpage.<br />
You can create formatted text this way as well; in that case, beware to set ''&lt;body width=600&gt;''<br />
or similar. However, FreeMind does not interpret all HTML; especially, it does not interpret inline<br />
CSS styling so you have to use hard formatting instead.<br />
<br />
If you want the table borders to have a '''nice two dimensional look''' rather than bevelled, start<br />
the HTML as follows.<br />
<br />
<html><br />
<head><br />
<style> td { border-style: solid } table { border-style: solid } </style><br />
</head><br />
<br />
== Generating mind maps programmatically ==<br />
<br />
=== To insert a newline into a node ===<br />
<br />
Insert <code>&amp;#xa;</code> instead of plain newline. Example of a map with three newlines:<br />
<br />
<map version="0.7.1"><br />
<node TEXT="New Mindmap"><br />
<node TEXT="A&amp;#xa;B&amp;#xa;C&amp;#xa;D" POSITION="right"/><br />
</node><br />
</map><br />
<br />
=== To use unicode characters in the node text ===<br />
<br />
FreeMind understands and uses <code>&amp;#xnn;</code>, where nn is equivalent to the '''hexadecimal''' number representing the character. It '''does not''' understand <code>&amp;#nnn;</code>, where nnn is '''decimal''' number. An example of a map containing ''AretÃÂÃÂÃÂÃÂÃÂÃÂÃÂé'' follows.<br />
<br />
<map version="0.7.1"><br />
<node TEXT="Aret&amp;#xe9;"/><br />
</map><br />
<br />
== FreeMind on Microsoft Windows ==<br />
<br />
=== How do I install a test version of FreeMind? ===<br />
Just unzip the package to the folder "C:\Program Files\FreeMind". That completes the "installation".<br />
You can start it by running freemind.exe (or freemind.bat if the exe does not exist). You can find test versions [http://freemind.sourceforge.net/testversions/ here].<br />
<br />
=== FreeMind does not seem to be affected by the things I edit in the user.properties. Why? ===<br />
See [[user.properties]].<br />
<br />
=== FreeMind starts and reacts so slow. Why? How to resolve? ===<br />
This seems to be an effect of the connection between Java and MS DirectX. You can deactivate the usage of DirectX for Freemind by editing the Freemind.bat file in your FreeMind directory.<br />
<br />
Add the parameter<br />
<br />
-Dsun.java2d.noddraw=true <br />
<br />
before the final expression <tt>freemind.main.FreeMind</tt>.<br />
<br />
Of course, now you have to use Freemind.bat to start the program instead of executing Freemind.exe. Do not forget to update file associations as well: [[Windows File Associations]]<br />
<br />
=== File Operations are slow ===<br />
With Java6 Update2 you will probably notice this [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6578753 bug]. Sun is working on it. Perhaps, you can downgrade to Java6 Update1 or Java5 in the meantime.<br />
<br />
=== To create a screenshot of FreeMind and paste it into Microsoft Word or Microsoft Powerpoint ===<br />
To take a screenshot of your whole windows screen into clipboard, press Ctrl + Print Screen. To take a screenshot<br />
of the active window only into clipboard, press Alt + Print Screen. Select your Word or Powerpoint document<br />
and press Ctrl + V. On German keyboard, the key PrintScreen has the label "Druck". However, such a screenshot<br />
also contains FreeMind's window frame, not just the map contents. In Microsoft Word and Microsoft Powerpoint, this<br />
can be solved by cropping the screenshot; the cropping tool can be found in Picture toolbar..<br />
<br />
===To export a map to Microsoft Powerpoint===<br />
There's no elegant way to export a map to PowerPoint. One option is to take a screenshot, and paste it into Powerpoint. PowerPoint supports graphic file insertion, so another option is upgrading to a more recent version of FreeMind that supports JPEG export.<br />
<br />
One another solution is by using a Flash plugin:<br />
* Insert a control "Shockwave Flash Object" with the Control toolbar (go to display/toolbar/customise if not available).<br />
* Activate the propeties window by double clicking on the rectangle of the object<br />
* Click on the custom "property"<br />
* On the new opened window set the "movie URL" to the full path of the plugin (i.e: c:\path\visorFreemind.swf)<br />
* Set the "base URL" to the name of your freemind file (i.e.: index.mm) <br />
* Start your diaporama and you will see the cross inside the rectangle replaced by your freemind map<br />
<br />
If not successfull with those explanation, you will find a more complete information at the following address: [http://www.flashgeek.com FlashGeek]<br />
<br />
Or you can export to RTF using a XSLT like this:<br />
<br />
<?xml version="1.0" encoding="UTF-8" ?><br />
<br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><br />
<br />
<xsl:template match="/">{\rtf1\ansi\ansicpg1252<br />
{\fonttbl<br />
{\f1\fswiss\fcharset0\fprq0 Arial;}<br />
}<br />
{\colortbl;<br />
\red0\green0\blue0;<br />
}<br />
{\stylesheet<br />
{\s1\qc\f1\fs44\ppscheme-3\lang1110\level1 heading 1;}<br />
{\s2\li270\fi-270\f1\fs32\ppscheme-1\lang1110\level2 heading 2;}<br />
{\s3\li585\fi-225\f1\fs28\ppscheme-1\lang1110\level3 heading 3;}<br />
{\s4\li900\fi-180\f1\fs24\ppscheme-1\lang1110\level4 heading 4;}<br />
{\s5\li1260\fi-180\f1\fs20\ppscheme-1\lang1110\level5 heading 5;}<br />
{\s6\li1620\fi-180\f1\fs20\ppscheme-1\lang1110\level6 heading 6;}<br />
}<br />
<xsl:apply-templates /><br />
}<br />
</xsl:template><br />
<br />
<xsl:template match="node"><br />
\pard\plain\ltrpar\s1\qc\f1\fs44\ppscheme-3\lang1110{\f1 <xsl:value-of select="@TEXT"/>\par}<br />
<xsl:for-each select="child::node"><br />
\pard\plain\ltrpar\s2\li270\fi-270\f1\fs32\ppscheme-1\lang1110\li0\fi0\qc{\f1 <xsl:value-of select="@TEXT"/>\par}<br />
</xsl:for-each><br />
<xsl:apply-templates select="node" /><br />
</xsl:template><br />
<br />
</xsl:stylesheet> <br />
<br />
and then open it using PowerPoint.<br />
<br />
===To export / import a map to Microsoft Project===<br />
Look at the section [http://freemind.sourceforge.net/wiki/index.php/Import_and_export_to_other_applications Import and export to other applications]<br />
<br />
== FreeMind on Mac OS X ==<br />
<br />
FreeMind is written in the Java language, which is great for development and deployment of cross-platform applications.<br />
Freemind uses the Swing graphical user interface toolkit, which can use different looks and feels in order to mimic visuals and behaviours proprietary to the target execution platforms.<br />
<br />
<br />
On Microsoft Windows OS, the application fits quite nicely with the rest of the environment, but on Apple MacOS-X, things are often not quite right. MacOS-X users usually have higher expectations when it comes to usability and UI consistency, so they might become frustrated by the lack of compliance to their user interface guidelines.<br />
<br />
<br />
Here are some tips to enhance the user experience when using MacOS-X:<br />
<br />
<br />
#Keyboard shortcuts<br />
#:The "Tao Of Mac" weblog posted a tip for replacing the "CTRL" key by the "COMMAND" (Apple) key:<br />
#:http://the.taoofmac.com/space/Applications/FreeMind<br />
#Look and feel<br />
#:"Quaqua" is a look and feel for Swing that emulates the Aqua user interface:<br />
#:http://www.randelshofer.ch/quaqua/download.html<br />
#Shift-click to select multiple nodes.<br />
<br />
== FreeMind on Linux and other UNIX-like systems ==<br />
<br />
Go to the specific page [[FreeMind on Linux]].<br />
<br />
== Misc ==<br />
<br />
language = ja<br />
<br />
=== Is FreeMind mind mapping software? ===<br />
<br />
The term '''mind mapping''' is related to british psychologist Tony Buzan. In Buzan's context, mind map is a tree with many colors, pictures and personal expression. '''FreeMind is not''' really '''mind mapping''' software '''in the sense of Tony Buzan''', nevertheless, one would say that FreeMind belongs to the class of so called '''mind mapping software'''.<br />
<br />
Some of members of that class come pretty close to Buzan. Have a look at the site of first class commercial mind mapping software [http://www.mindjet.com/ MindManager]. You may also want to see [http://www.mind-mapping.co.uk/mind-maps-examples.htm examples] of mind maps in Buzan's sense.<br />
<br />
=== To spell FreeMind correctly. === <br />
"FreeMind", with a capital M.<br />
<br />
=== Where can I find a quick reference list of default keyboard shortcuts for the Windows 0.7.1 version? ===<br />
Here is a list of shortcuts, grouped by function:<br />
<br />
File commands:<br />
New map - Ctrl+N<br />
Open map - Ctrl+O<br />
Save map - Ctrl+S<br />
Save as - Ctrl+A<br />
Print - Ctrl+P<br />
Close - Ctrl+W<br />
Quit - Ctrl+Q<br />
Previous map - Ctrl+LEFT<br />
Next Map - Ctrl+RIGHT<br />
Export file to HTML - Ctrl+E<br />
Export branch to HTML - Ctrl+H<br />
Export branch to new MM file - Alt+A<br />
Open first file in history - Ctrl+Shift+W<br />
<br />
Edit commands:<br />
Find - Ctrl+F<br />
Find next - Ctrl+G<br />
Cut - Ctrl+X<br />
Copy - Ctrl+C<br />
Copy single - Ctrl+Y<br />
Paste - Ctrl+V<br />
<br />
Mode commands:<br />
MindMap mode - Alt+1<br />
Browse mode - Alt+2 <br />
File mode - Alt+3<br />
<br />
Node formatting commands:<br />
Italicize - Ctrl+I<br />
Bold - Ctrl+B<br />
Cloud - Ctrl+Shift+B<br />
Change node color - Alt+C<br />
Blend node color - Alt+B<br />
Change node edge color - Alt+E<br />
Increase node font size - Ctrl+L<br />
decrease node font size - Ctrl+M<br />
Increase branch font size - Ctrl+Shift+L<br />
Decrease branch font size - Ctrl+Shift+M<br />
<br />
Node navigation commands:<br />
Go to root - ESCAPE<br />
Move up - UP<br />
Move down - DOWN<br />
Move left - LEFT<br />
Move right - RIGHT<br />
Follow link - Ctrl+ENTER<br />
Zoom out - Alt+UP<br />
Zoom in - Alt+DOWN<br />
<br />
New node commands:<br />
Add sibling node - ENTER<br />
Add child node - INSERT<br />
Add sibling before - Shift+ENTER<br />
<br />
Node editing commands:<br />
Edit selected node - F2<br />
Edit long node - Alt+ENTER<br />
Join nodes - Ctrl+J<br />
Toggle folded - SPACE<br />
Toggle children folded - Ctrl+SPACE<br />
Set link by filechooser - Ctrl+Shift+K<br />
Set link by text entry - Ctrl+K<br />
Set image by filechooser - Alt+K<br />
Move node up - Ctrl+UP<br />
Move node down - Ctrl+DOWN<br />
<br />
=== To suggest new enhancements of FreeMind ===<br />
''Keywords: additional features, additional functions.''<br />
At FreeMind's project page, you can [http://sourceforge.net/tracker/?group_id=7118&atid=357118 submit Requests for Enhancements (RFEs)].<br />
<br />
=== Is MindMaster a rip off of FreeMind? ===<br />
<br />
''Update: the site of MindMaster is no longer there, thanks to Rezzie.''<br />
<br />
There is a [http://www.gigastorm.com/mindmaster/ web site] offering a product called MindMaster. This program is a ripped off version of FreeMind. It is not just a clone of FreeMind; it ''is'' just FreeMind renamed, and slightly modified. They even use the presentation texts as found on the main page of FreeMind. As FreeMind is licenced under GNU GPL, so must be MindMaster. However, on the MindMaster site and after the installation, they claim that they hold copyright to MindMaster, and that you are prohibited to use MindMaster unless you conform to their licence. This is unlawful. We urge you not to use or recommend MindMaster, and to avoid linking to their site or giving any recommendation. Also, you can write an email to them complaining about abuse of GNU General Public Licence. --[[User:Danielpolansky|Danielpolansky]] 11:15, 14 May 2005 (PDT)<br />
<br />
: I have been in contact with the author of [http://www.gigastorm.com/mindmaster/ MindMaster] and he has since removed the website and all links to the download. He did in fact claim it was released under the GPL and included both the licence and source code in the package, but as I didn't want to shell out $30 I cannot verify this. --[[User:Rezzie|Rezzie]] 23:49, 18 Oct 2005 (PDT)<br />
<br />
:: Thanks a lot. --[[User:Danielpolansky|Danielpolansky]] 09:50, 26 Oct 2005 (PDT)<br />
<br />
=== Where can I make a monetary donation to FreeMind? ===<br />
<br />
Currently, we do not accept any monetary donations. --[[User:Danielpolansky|Danielpolansky]] 00:32, 21 Nov 2005 (PST)<br />
<br />
== This FAQ ==<br />
<br />
=== I have a question not listed here, what should I do? ===<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page. Or specifically, ask your question in FreeMind's [http://sourceforge.net/forum/forum.php?forum_id=22102 Help forum]. Unfortunately, we cannot guarantee that you will get help, still, many users get it.<br />
<br />
=== To edit this FAQ ===<br />
Edit this page like any other wiki page (click edit or press alt-E). When adding a question to the talk page, imitate the format of already existing questions.<br />
<br />
=== Where can I practice editing pages on this Wiki? ===<br />
Click on this link and just hit the edit button on the lower right: [[Sandbox]]<br />
<br />
== Questions not yet answered ==<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page.<br />
<br />
Is FreeMind also Working under SuSe Linux 9.3 or perhaps already a part of the package?<br />
Answer: Yes, please see the "[[FreeMind on Linux]]" page here in the wiki.<br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Asked_questions&diff=7228
Asked questions
2008-11-18T08:37:42Z
<p>Ewl: Added Troubleshooting section</p>
<hr />
<div><!-- spam removed --><br />
<table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
Here we collect a list of asked questions and answers related to free mind mapping software FreeMind. Help if you can (see [[#To edit this FAQ|To edit this FAQ]]). If you're searching for an answer to your question, why don't you just press Ctrl + F in your browser?<br />
<br />
== Installation ==<br />
<br />
=== How do I download the Java Runtime Environment needed to run FreeMind. ===<br />
To download JRE for Windows, go to [http://java.sun.com/j2se/1.4.2/download.html Download on Sun],<br />
go to the section '''Download J2SE v 1.4. ...'''<br />
and now choose the column [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&amp;PartDetailId=j2re-1.4.2_03-oth-JPR&amp;SiteId=JSC&amp;TransactionId=noreg JRE], ''not SDK''. The installation file of JRE has approximately 15 MB.<br />
<br />
=== I start FreeMind but nothing happens ===<br />
First of all, we assume that you are working under Windows. Now, please start freemind.bat in the installation directory.<br />
You'll probably get:<br />
<br />
Exception in thread "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
<br />
at freemind.main.FreeMind.getLogger(FreeMind.java:643) <br />
at freemind.main.FreeMind.<init>(FreeMind.java:109) <br />
at freemind.main.FreeMind.main(FreeMind.java:647) <br />
<br />
The answer to this behaviour is that you've got Java1.3 or lower installed, and this version of java is found (try java -version on the commandline to verify this). <br />
Most likely, you've installed Oracle. <br />
Change JAVA_HOME and the PATH variables to point to your actual java (1.4 or 5.0). <br />
This can be done as follows: Goto Settings -> System -> search for Environment Variables and change or create the values accordingly.<br />
<br />
Another Reason Freemind won't start or will give you the effect of having the icon in the Windows taskbar but nothing else is when you install Freemind in a folder which start with a "!" (exclamation mark), just install it in a different folder. (see http://www.cogmios.nl/java-apps-like-eclipse-or-freemind-do-not-run-in-folders-starting-with-a-20070407.html)<br />
<br />
<br />
=== I start FreeMind but nothing happens <i>TRY THIS FIRST</i>===<br />
A quick thing to try first is to start Freemind from the freemind.bat file. The command.com will open along with Freemind. Just close down Freemind (command.com will close also) and then start Freemind from the Start Menu or from freemind.exe I have no idea why this works but it did for me.<br />
<br />
Alternatively, if starting it once via the batch file doesn't help, change all links to Freemind.exe to link to Freemind.bat .<br />
<br />
Another reason why Freemind won't start is if you hava JDK installed and JAVA_HOME points to JDK instead of JRE. If you point JAVA_HOME environment variable to the JRE home then Freemind.exe starts up fine.<br />
=== I start FreeMind and can create a map but can not save it ===<br />
The most obvious indication is that you click on open/save/save as and nothing happens. What is happening is that the file browser window is failing to open. There are two fixes; Either change JAVA_HOME to point to a JRE rather than a JDK or edit the Freemind.bat file to use the absolute path to the correct java and start Freemind with the bat file. It will be something like "C:\Program Files\Java\jre1.6.0_05\bin\java" instead of just java. Note the use of quote marks and that your java path may not be the same as the example. <br />
=== I start FreeMind but nothing happens on MacOS X Leopard ===<br />
I launch FreeMind 0.8.1 on MacOS X 10.5 (Leopard), the FreeMind welcome image appears and after few moments, FreeMind quit after a pop up window "Cannot lunch Java application (Uncaught exception in main method Java.lang.OutOfMemoryError Java heap space)".<br />
<br />
This issue might be related to the problem met by OpenOffice users on Leopard. <br />
Apple seems to have replaced "Apple Computer, Inc." by "Apple, Inc." in the Java string. The JRE is thus not recognized anymore on Leopard, and Java fail. ([http://user.services.openoffice.org/en/forum/viewtopic.php?f=17&t=153 Web Reference])<br />
<br />
Hope this issue will be fixed in the next FreeMind release.<br />
<br />
'' '''Temporary Solution''' '' : ''It is possible de launch FreeMind via FreeMind.app > Content > Resources > Java > lib > freemind.jar''<br />
<br />
''I suggest to place an alias in the Dock, for a more friendly access to FreeMind''<br />
<br />
'''''I was able to get FreeMind 0.9.0 beta 20 to launch on Mac OS X 10.5.5 (Leopard) by editing the Info.plist <tt>JVMVersion</tt> string to read <tt>1.6</tt> instead of <tt>1.4+</tt>. For the record, when I run <tt>java -version</tt> it reports <tt>java version "1.5.0_16"</tt>.'''''<br />
<br />
=== FreeMind cannot detect new version of Java. What can I do? ===<br />
Let us assume that you have installed a new<br />
version of Java, and still, FreeMind complains about having old version of Java. This may occur especially<br />
if you installed ''SDK'' rather than ''JRE''. ''SDK'' stands for ''software development kit'' and contains much more<br />
than you need to run FreeMind; you only need the runtime environment. It is important that the new version of<br />
java is in your ''path''. To check it out on Microsoft Windows, run command ``cmd" using Windows-key + R,<br />
followed by ``java -version". You should get something like<br />
<br />
java version "1.4.2_03"<br />
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_03-b02)<br />
Java HotSpot(TM) Client VM (build 1.4.2_03-b02, mixed mode)<br />
<br />
where the particular version number is not important as long as it is at least 1.4.0.<br />
<br />
Additionally, it may be helpful to start '''freemind.bat''' and see what messages come.<br />
<br />
'''NOTE:''' If you have an Oracle database product installed on your computer, check the Oracle Installer to see what version of Java was installed with the database. Versions of Oracle 8, 8i, and later install JRE 1.3.1 and modify the startup path for Windows to ensure the database can start using this JRE. This installation WILL cause FreeMind to report the older version of Java, even if you install the new version (the .ini file for Oracle points Windows to the JRE 1.3.1 directory, places that in memory, and causes the fault). You can modify the .ini file to point Oracle to the newer JRE. <br />
<br />
If you don't want to change the Oracle settings: just create a batch file in the FreeMind folder with the following entry "Path-to-your-new-java-runtimes-bin/java.exe -jar lib/freemind.jar" and use that to start freemind.<br />
<br />
=== Which Java virtual machines does FreeMind actually work with? ===<br />
<br />
FreeMind works with the virtual machines from Sun, from the version 1.4.0 and higher. FreeMind has been reported to run on the JDK 1.4.2 from Blackdown. FreeMind also works on Linux with Sun Microsystems 64bit JDK version 1.5.0.<br />
<br />
There are known issues with official release 0.8.0 of Freemind and Java 6. <br />
* Encrypted nodes will wipe out your map when trying to save it to disk. <br />
* Preferences dialog can not be opened<br />
Stick to Java 5 (alias 1.5.x) [https://sourceforge.net/tracker/?func=detail&atid=107118&aid=1550792&group_id=7118 (see bug report)]<br />
<br />
Possible cause and work-around for problem of Preferences dialog: extended desktop (second monitor). If you extend your desktop on to a second monitor and use FreeMind on that monitor, when you close (save?) the Preferences dialog, its dialog is saved to the extended desktop location. The next time you use FreeMind without using the 2nd monitor, the Preferences dialog will not be visible. I had this problem and was able to correct it by moving the dialog back to the main monitor and saving again (note that the virtual position of the 2nd monitor relative to the main monitor is important for finding the dialog again).<br />
-RyanC, 7-Apr-08<br />
<br />
=== What is a mirror? ===<br />
A mirror is one of the SourceForge sites from which you can download FreeMind. To download FreeMind, choose ''any'' mirror; you would prefer a mirror geographically closer to the place where you live. If you experience problems with one mirror, try another.<br />
<br />
=== I run 'freemind.bat' and get an error message ===<br />
If you get <br />
Exception in thread "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
at freemind.main.FreeMind.getLogger<FreeMind.java:643>at<br />
freemind.main.FreeMind.<init<FreeMind.java:109> <br />
at freemind.main.FreeMind.main<FreeMind.java:647> <br />
then the Java Virtual Machine found on your system is of version 1.3 or below. Try <br />
java -version<br />
to verify this. This happens, when you install Oracle for instance. Please, make sure, that your latest Java Virtual Machine is found when you type "java -version" by deinstalling java1.3 for example.<br />
<br />
=== USB Portable FreeMind ===<br />
Just add the following Java option in the freemind.bat or freemind.sh and everything is contained on the USB stick:<br />
<br />
-Duser.home=.[\<subdirectory, if needed>]<br />
<br />
As an example see the new content of my BAT-file, which looks like:<br />
<br />
@echo off<br />
java -Duser.home=. -cp lib\freemind.jar;lib\commons-lang-2.0.jar;lib\forms-1.0.5.jar;lib\jibx\jibx-run.jar;lib\jibx\xpp3.jar;lib\bindings.jar freemind.main.FreeMindStarter<br />
<br />
This lets FM create and use the subfolder .freemind in the location of the freemind.bat.<br />
<br />
As we know, USB flash drives support only limited number of writes. It means that reliability of such device drops down as time advances. Freemind, by default, saves your open maps every minute to .freemind dir which is in this case on the flash drive. If you aren't too paranoid you can avoid this by setting autosave dir to tmp dir of your OS. Freemind will automatically delete autosaves on exit so your precious data won't be left on a host machine. Go to Tools->Preferences->Path to automatic saves and set it to 'default'. Freemind will understand this on Windows probably as c:\windows\temp, Linux - /tmp or /var/tmp.<br />
<br />
That's it and have fun!<br />
<br />
== Troubleshooting ==<br />
<br />
Before you start asking questions on the forum, it's a good idea to check if your problem is not already described, together with a resolution:<br />
* either on this page,<br />
* or in the Forums, there is a search function (check the SourceForge menu 'Forums &rarr; Search'),<br />
* or even in the Trackers, where you can find already reported problems.<br />
<br />
If this doesn't help, then sample the following information (under Windows, check the specific pages for other OS's) and create a Help forum topic (if you're not sure) or bug tracker item (if you're quite sure that it's a bug in FreeMind) with it:<br />
<br />
* OS version (e.g. Win XP with(out) SP2 or 3)<br />
* Java version (the output of <tt>java -version</tt> called from the command line, example as follows)<br />
C:\Users\lostuser>java -version<br />
java version "1.5.0_15"<br />
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_15-b04)<br />
Java HotSpot(TM) Client VM (build 1.5.0_15-b04, mixed mode, sharing)<br />
* FreeMind version (e.g. FreeMind 0.9.0.Beta20, installed from <tt>FreeMind-Windows-Installer-0.9.0_Beta_20-max.exe</tt>)<br />
* Content of the logfile <tt>%USERPROFILE%\.freemind\log.0</tt> after you've done the action making problems.<br />
* It's also a good idea to open a command line, go to FreeMind's base directory, in general with <tt>cd %ProgramFiles%\freemind</tt>, and start FreeMind from there, using the <tt>freemind.bat</tt> file, and check what happens in the console. Most content is generally similar to the above logfile, but not if FreeMind doesn't even start, for some reason (e.g. Java missing).<br />
<br />
;Note: under Windows XP/Vista, you can open a command line (also called a console) by pressing the keys <tt>Win+R</tt> (like Run), type <tt>cmd</tt> and press enter.<br />
<br />
== Using ==<br />
<br />
=== To add a new concept ===<br />
<br />
A new concept is referred to as a "node." Use the "Insert" key on PCs to add a new node. MAC users need to [[Asked Questions#To_set_a_different_key_for_new_child_node_on_Mac_computers | set a different key]]. Nodes are not limited to just concepts. They can also include sentences, paragraphs or even short articles.<br />
<br />
=== Is there an undo feature in FreeMind? ===<br />
Starting with FreeMind 0.8, there is an undo and redo feature.<br />
<br />
If you are using 0.7, then use the following tips to prevent data loss:<br />
<br />
* Use FreeMind's autosave-feature <br />
: This feature is enabled by default... auto saved files will be found in ~/.freemind/<br />
<br />
* Install a clipboard manager, which will make all elements, which you cut from FreeMind, available in its history. A freeware example of a clipboard manager for MS Windows is [http://www.yankee-clipper.net Yankee Clipper].<br />
<br />
=== How much memory do I need? === ''Keywords: RAM.''<br />
Experience shows that 64 MB is not sufficient, while 128 MB is already enough, provided that you do not run another Java application. Correct me if I'm wrong. I am using FreeMind on Windows 95 + 128 MB without any problems.<br />
<br />
Running FreeMind 0.8RC5 on Windows 95 with 64 MB and Java 1.4.0 is possible and the response time ''is'' in acceptable limits. -- [[User:Stefano|Stefano]] 02:01, 11 Jul 2005 (PDT)<br />
<br />
Running FreeMind 0.7.1 on Debian Linux and Java 1.4.2.03 (j2sdk1.4) with my Omnibook 800 laptop (78 MB RAM, P166) just fine. I haven't tried any big projects with it yet, but so far it's very responsive. --[[User:Nullman|Kyle]] 09:14, 30 Jan 2006 (PST)<br />
<br />
=== To move a node to the other side of root ===<br />
Drag the node onto root and you see one half of root getting gray. Move the node to the other half and <br />
this half gets gray. Just drop the node on the side you want to have it.<br />
As of version 0.9.0 you can also use Ctrl+left and Ctrl+right to move a node in the desired direction (not only to change the side with respect to root, try it out).<br />
<br />
=== To create a graphical link ===<br />
<br />
# Go to the source node. <br />
# Mark it with the mouse. <br />
# Press the left mouse button. <br />
# Hold this button. <br />
# Press Ctrl+Shift buttons. <br />
# Continue to hold all these buttons. <br />
# Go to the destination node. <br />
# Release the mouse button, first. <br />
# Then release the keyboard buttons. <br />
<br />
You have your link. Alternatively, drag'n drop holding right mouse button.<br />
<br />
=== To remove a graphical link ===<br />
<br />
# Right-Click on the curved arrow of the graphical link (Mac users, press Control and click to see the options menu)<br />
# Choose "Remove Arrow Link" from the pop-up menu<br />
<br />
(Left-clicking on a graphical link does nothing)<br />
<br />
=== To add user icons to FreeMind ===<br />
Currently, adding user [http://www.guiicons.com Icons] is not possible.<br />
BUT you can add an inline images to any node. Use the following code example:<br />
<nowiki><html><img src="http://www.stumbleupon.com/pics/me.jpg"></nowiki><br />
in a FreeMind node. This should also work with local files using "file://" instead of "http://".<br />
<br />
=== To open links in only one browser window, rather than several. ===<br />
To our knowledge this is not possible at the moment.<br />
<br />
'''Firefox (old)''' allows this option. ''From the menu, select''<br />
1) Tools > '''Options''' > <br />
2) Click '''Advanced'''<br />
3) Toggle Tabbed Browsing<br />
4) Select to open links from other apps in<br />
...a new tab in the most recent window.<br />
<br />
'''Firefox (1.5.0.12)''' allows this option. ''From the menu, select''<br />
1) Edit > '''Prefernces''' > <br />
2) Click '''Tabs'''<br />
3) Select to open links from other apps in<br />
...a new tab in the most recent window.<br />
<br />
<br />
'''A possible Work Around:''' There is a way to do this if you use the [http://www.mozilla.org/products/firefox/ Firefox browser] instead of Internet Explorer, provided you<br />
install the Firefox extension called ''Single Window'' (available from [http://update.mozilla.org/extensions/showlist.php?category=Tabbed%20Browsing here]). Using this extension, every time you click on an external web link on a mind map, it will open the relevant page in a new tab in an existing Firefox window, rather than a new browser window. I have found this to be a much easier way to navigate the pages opened. I have only tried this with mm files opened from the file system at the moment (ie not served from a web server in the browser applet).<br />
<br />
To '''open external web links in a new tabs''' in Firefox follow [http://texturizer.net/firefox/tips.html#beh_reuse this tip] (works both for Linux and Windows). You have to add a line in your user.js file and install [http://piro.sakura.ne.jp/xul/_tabextensions.html.en Tabbrowser extensions].<br />
<br />
=== Is it difficult to provide FreeMind with Java Webstart?=== Well, it's not that easy. Joerg Mueller succeeded in doing just that and has sent his source code to Daniel Polansky, who did not succeed in getting it running; he did not consider that a high priority. What is important is that Microsoft Windows users have a convenient installer, and the users of the other operating systems are already used to not so convenient methods; the installation is pretty straightforward anyway.<br />
<br />
=== To create PDF out of FreeMind's mind map ===<br />
To create pdf out of FreeMind's mind map, you've got several<br />
options.<br />
<br />
* Use File/Export/As PDF...<br />
<br />
* Create DocBook, then pdf. Use [http://krottmaier.cgv.tugraz.at/docs/seminar/sem2002_mindmaps.tar.gz XSLT transformations sheets] from Christoph Rissner to convert FreeMind's mind map to Mind Manager's mind map, then to DocBook, and create pdf from that DocBook. You can read more on that on [http://hkrott.iicm.edu/veranstaltungen/seminar/abgeschlossen.html Abgeschlossene Arbeiten] &gt; Mind Maps.<br />
<!-- Old link to http://hkrott.iicm.edu/docs/seminar/sem2002_mindmaps.tar.gz would not work any --><br />
<br />
* Print to pdf using a pdf printer driver.<br />
** Use open source [http://sector7g.wurzel6.de/pdfcreator/index_en.htm PDFCreator]. It uses Ghostscript as its backend.<br />
<br />
* Print to pdf using Acrobat's Distiller. Provided that you have full version of Adobe Acrobat installed (not just reader), you can print to a pdf using the Distiller or Writer options in your printer list. Make sure you check the "fit to one page" option under File > Page Setup. Also, make sure you set antialias to all under edit > preferences. This will make it look crisper. The only downside to this option is that it doesn't do the icons very well.<br />
<br />
* First print to postscript, then convert to pdf.<br />
** In Linux, create postscript by printing to a file using a postscript printer, and convert the postscript file to pdf afterwards, by using the shell-command ps2pdf or using [http://www.cs.wisc.edu/~ghost/ Ghostscript].<br />
** In Windows, install any postscript color printer (Like AppleColor 600) to print to a file. When printing to that printer, choose a folder and a file that ends with .ps. Then, open that *.ps with [http://www.cs.wisc.edu/~ghost/gsview/index.htm gsview] and choose ''File/Convert to PDF'' (let the program choose it all). Then save the file with the same name, but ending with .pdf. That's all. You might need to read the help files to tune it all up (only once).<br />
<br />
* Export FreeMind's mind map to HTML, paste it into Microsoft Word, format it as you see fit, and convert it to pdf using the techniques decribed above.<br />
<br />
=== To convert mind maps between FreeMind and MindManager ===<br />
Click here: [[Import and export to other applications]]<br />
<br />
=== Who is the development team of FreeMind? ===<br />
<br />
Daniel Polansky: the director of FreeMind is Daniel Polansky, i.e. me. The<br />
label ``director" is not quite appropriate; ``parliament"<br />
would be better. I test new versions, give advice, sometimes<br />
act in the name of FreeMind, forbid versions to be released<br />
because of insufficient quality, and approve them when<br />
they're ready. Also, I set up barriers for new directions.<br />
<br />
The main actor on the scene is Christian Foltin. We use<br />
the label ``code master" to denote his role, and also<br />
``manager". He does most of the work and decides which<br />
code changes are acceptable what concerns the<br />
quality of code. He takes care of mergers. Also, he<br />
coordinates the developers.<br />
<br />
An important developer is Dimitri Polivaev.<br />
<br />
=== To have brainstorm-like mode similar to one found in MindManager.===<br />
Did you notice you can hit Enter and Shift-Enter to create sibling nodes?<br />
It is not exactly the behavior of brainstorm mode of MindManager, but still<br />
close to it.<br />
<br />
=== On what operating systems have people actually succeeded in running FreeMind?===<br />
<br />
* ''Microsoft Windows.'' Windows 95, Windows 98, Windows NT, Windows 2000, Windows XP (SP1 & SP2), Windows 2003 Server, Windows Vista.<br />
* ''Linux.'' Mandrake 9.2 and 10, RedHat Pro WS 3, Fedora Core 2, Fedora 8 & 9, SuSE (8.2 using the RPM for 9.0, 9.0, 9.1, 9.2, 9.3, 10.0, 10.2), Ubuntu (Warty, Hardy, Intrepid Ibis), Debian (sarge, sid), Slackware 9.1, Gentoo, Mepis 3.3.1, Mepis 3.4-2.rc1.<br />
* ''BSD.'' FreeBSD (5.2.1, 5.4, 6.1), Mac OS X (10.2.8, 10.3, 10.4.4, 10.4.8, 10.4.11)<br />
* ''Other.'' OS/2, Solaris 9 and 10.<br />
''Keywords: platforms.''<br />
<br />
=== Is there a PDA-Version, e.g. for Palm or Pocket PC? ===<br />
On PDA, you can use [[FreeMindPDA]]. It uses cross-platform [http://www.superwaba.com SuperWaba] Open Source SDK. However, it does not use mind map view, but rather plain tree view; it is not a proper FreeMind version in that sense. See also [[Stuff#PDA|FreeMind and PDA]].<br />
<br />
=== How large maps can I edit with FreeMind? ===<br />
<br />
In principle, there are no built-in limits. Practically, the maximum reported size is 11 MB at a map with 22,000 nodes; after exporting to HTML and pasting to Microsoft Word, the very same content had 15.6 MB, with 1500 pages. For a better practical estimation, experimental tests are needed, as the maximum given so far is only a lower bound on practical limits.<br />
<br />
I've been appending daily notes to a single mind-map file continually for many months on a 3 GHz Pentium 4 with 2 GB RAM running windowsXP. The file has grown to about half a megabyte, 420K, and there is a noticable difference in Freemind's responsiveness dealing with it, but it still works for me.<br />
<br />
=== How can I keep FreeMind from opening the last file from the last session? ===<br />
One way is to disable the changing of the file "auto.properties" (which is in the same folder as [[user.properties]]). Be aware that the menu "Edit -> Preferences" will not change anything any more than!<br><br />
To do that go to the file auto.properties and delete everything behind "onStartIfNotSpecified=" in that line. Now set the file "auto.properties" to read-only.<br />
<br />
Another way is to change the auto.properties on the fly during startup. Copy the next lines of code into a batch-file and put this into the same directory as freemind.exe. This batchfile will add an extra line to the auto.properties file. In fact, it does the same as the above, but it still enables you to change the properties.<br />
<br />
@echo off<br />
echo onStartIfNotSpecified= >> "%USERPROFILE%\.freemind\auto.properties"<br />
call .\freemind.exe<br />
<br />
===To change the fill color on bubbles.===<br />
There's an icon for it at the main toolbar. Additionally,<br />
you can find it in the popup menu at Node > Style > Cloud color.<br />
<br />
===To remove a cloud===<br />
Press Ctrl+Shift+B to toggle clouds.<br />
<br />
=== To search in FreeMind === <br />
''Keywords: find.'' Press Ctrl + F. For finding next occurrence, press Ctrl + G. Searching is<br />
restricted to the descendants of the node selected when pressing Ctrl + F. The search is<br />
a breadth-first search, first finding occurrences in the nodes closer to the starting node.<br />
<br />
===To move nodes around=== To move them up and down, use ctrl + up and down arrows. To move them wherever you want, use drag'n drop with mouse. ''Keywords: move around, reorganize.''<br />
<br />
=== What does antialias mean in FreeMind preferences? ===<br />
<br />
To antialias means to make fonts or curves look smooth by drawing additional pixels with in-between color. See also wikipedia on [http://en.wikipedia.org/wiki/Antialiasing antialiasing].<br />
<br />
By default, FreeMind antialiases edges only. FreeMind can also antialias text, but with the current state of the technology, it does not look good enough. At least, new Java RE 1.5.0 has better antialiasing of text than Java RE 1.4.x. Also, it is possible to set the whole application to antialiasing, including the menus and editing box; by using the command line option <code>-Dswing.aatext=true</code> of Java 1.5.0. Unfortunately, this is not available if you're using FreeMind.exe to launch FreeMind.<br />
<br />
=== What kind of encryption is used? ===<br />
<br />
: ''See [[Encryption]].''<br />
<br />
=== Reminders don't work when I start a map. The PDF-Export is not present. What's happening? ===<br />
There, the plugins (not only the PDF/SVG one) appear only if you start FreeMind from the directory where it has been installed. Especially if you start FreeMind by double-clicking on a FreeMind file (.mm file), this is not the case. So, use your icon and choose open to open your file.<br />
<br />
== Customizing FreeMind ==<br />
<br />
=== How do I add a new keyboard shortcut ===<br />
To add a new keyboard shortcut, say for "Change node background color", open the file<br />
mindmap_menus.xml (in freemind.jar) and search for "background", say.<br />
<br />
You'll find<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Here, you add a new keyboard ref attribute like:<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor" key_ref="keystroke_node_background_color"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Open the file freemind.properties and add a line like<br />
<pre><br />
#<br />
keystroke_node_color = alt F<br />
keystroke_node_color_blend = alt B<br />
keystroke_edge_color = alt E<br />
keystroke_node_background_color=alt N<br />
</pre><br />
But you have to search for free keys...<br />
<br />
=== To set expert settings ===<br />
<br />
Most of expert settings are stored in the [[user.properties]] file.<br />
<br />
=== To use another browser ===<br />
<br />
If you want to use another browser, edit the [[user.properties]] file and change the following property according to your operation system: <br />
<br />
default_browser_command_windows_nt <br />
default_browser_command_windows_9x <br />
default_browser_command_mac <br />
default_browser_command_other_os <br />
<br />
You have to write something like<br />
<br />
default_browser_command_windows_nt = C:\Program Files\Internet Explorer\iexplore.exe "{0}"<br />
...<br />
<br />
=== To change language ===<br />
<br />
Lydia<br />
<br />
language= ja<br />
<br />
language = ja <br />
<br />
Don't forget to remove the # character. Restart FreeMind and you have changed the language to German. See also [[Development#To_translate_FreeMind_into_your_language|the list of available languages]].<br />
<br />
=== To set a different key for new child node on Mac computers ===<br />
<br />
NOTE: The latest version of Freemind now sets the "tab" key as the default key for inserting a new node on a mac. Unfortunately, this is not documented in an obvious place. If you right or control click on a node you see a menu that does tell you the Tab shortcut for creating a child node but this is easily missed.<br />
<br />
In a manner similar to changing the language, replace<br />
<br />
#keystroke_add_child = INSERT <br />
<br />
with<br />
<br />
keystroke_add_child = control shift ENTER<br />
<br />
in the file [[user.properties]]. Pay attention that you write the key code ENTER in capital letters. <br />
<br />
N.B. Setting the ADD CHILD MAC is not enough, ADD CHILD must also be set (at least with Beta 9 on Leopard)<br />
<br />
This can also be done via the Freemind GUI by selecting Tools/Preferences/Keystrokes instead of editing the properties file.<br />
<br />
The command ("Apple") key can be referred to as "meta" in these keystroke sequences - in case you were wondering.<br />
<br />
=== There is no shortcut to insert a note. Why? ===<br />
There is no shortcut on purpose, as this action does not come with undo. <br />
<br />
If you want to have this shortcut, you can download the sources, patch NodeNote.xml such that it contains a key_stroke="alt N" in the first lines as here: <br />
<br />
<br />
<plugin_action <br />
documentation="%accessories/plugins/NodeNote.properties_documentation" <br />
name="%accessories/plugins/NodeNote.properties_name" <br />
base="freemind.extensions.NodeHookAdapter" <br />
'''key_stroke="alt N"''' <br />
icon_path="accessories/plugins/icons/knotes.png" <br />
label="accessories/plugins/NodeNote.properties" <br />
class_name="accessories.plugins.NodeNote" instanciation="Once"> <br />
<br />
<br />
compile and you are done. BUT REMEMBER: Pressing your key on a node, that already contains a note, makes this note to remove WITHOUT UNDO. <br />
<br />
At your own risk, Chris<br />
<br />
<br />
=== Using physical styles (or patterns) ===<br />
<br />
Physical styles and patterns are the same and can be compared to "styles" in a text writer: you define a set of styling attributes, give this set a name, and can then assign the style or pattern to different nodes in the same way.<br />
<br />
The patterns are defined in the file <tt>patterns.xml</tt> placed in the FreeMind user directory. In Windows, that file is <tt>C:\Documents and Settings\YourUserName\.freemind\patterns.xml</tt>; under Linux, it's <tt>~/.freemind/patterns.xml</tt>. The generic format of this file is the following:<br />
<br />
<?xml version="1.0" encoding="UTF-8"?><br />
<patterns><br />
<pattern name="Pattern1"><br />
[...pattern properties...]<br />
</pattern><br />
<pattern name="Pattern2"><br />
[...pattern properties...]<br />
</pattern><br />
[...more patterns...]<br />
</patterns><br />
<br />
As you can see from above, you need to give each pattern a unique name, and then you need to assign pattern properties. Each pattern property is of the form <tt><'''pattern_property_name''' value="'''property_value'''"/></tt>, or <tt><'''pattern_property_name'''/></tt>, and each property stands for a different format parameter. Where the property is listed without value attribute, the corresponding format is reset to its default value. The following property names are possible:<br />
<br />
* pattern_node_background_color<br />
* pattern_node_color<br />
* pattern_node_style<br />
* pattern_node_text<br />
* pattern_node_font_name<br />
* pattern_node_font_bold<br />
* pattern_node_font_italic<br />
* pattern_node_font_size<br />
* pattern_icon<br />
* pattern_edge_color<br />
* pattern_edge_style<br />
* pattern_edge_width<br />
* pattern_child<br />
<br />
==== Allowed values ====<br />
<br />
For colors, the format of the value is "#RRGGBB", where RR, GG, BB are the hexadecimal values of the red, green, blue components of a color, e.g. "#B3B95C".<br />
<br />
<code>pattern_icon</code> can take one of the following values:<br />
<br />
* help<br />
* messagebox_warning<br />
* idea<br />
* button_ok<br />
* button_cancel<br />
* full-1<br />
* full-2<br />
* full-3<br />
* full-4<br />
* full-5<br />
* full-6<br />
* full-7<br />
* back<br />
* forward<br />
* attach<br />
* ksmiletris<br />
* smily_bad<br />
* clanbomber<br />
* desktop_new<br />
* flag<br />
* gohome<br />
* kaddressbook<br />
* knotify<br />
* korn<br />
* Mail<br />
* password<br />
* pencil<br />
* stop<br />
* wizard<br />
* xmag<br />
* bell<br />
* bookmark<br />
* penguin<br />
* licq<br />
<br />
; TODO : Add more explanations about the possible values and exact impact for each property.<br />
<br />
==== Example(s) ====<br />
<br />
An example of a pattern is therefore:<br />
<br />
<pattern name="Blue with edges and icon"><br />
<pattern_node_background_color/><br />
<pattern_node_color value="#000099"/><br />
<pattern_node_style/><br />
<pattern_icon value="flag"/><br />
<pattern_edge_color value="#009999"/><br />
<pattern_edge_style/><br />
<pattern_edge_width value="4"/><br />
</pattern><br />
<br />
This information and more can be discovered by opening any .mm file in a text or XML editor. You can usually search for the text in an element to find the example of what you want to learn how to do.<br />
<br />
; Note : the complete list of pattern properties can be found in the source code, in the file <tt>freemind/freemind_actions.xsd</tt> (search for ''pattern_''), and the list of icons in the file <tt>freemind/modes/MindIcon.java</tt> (search for ''mAllIconNames.add'').<br />
<br />
== Mind maps on web pages with FreeMind's applet ==<br />
<br />
=== To get FreeMind's applet working. ===<br />
If you experience problems viewing a mind map published by someone else, the most common problem is that you have to use Java >= 1.4 in your browser. Check this using the "About plugins" section of your browser (or a similar place). If you have Java >= 1.4 installed and still experiencing problems check out Internet Explorer's settings by selecting Tools > Internet Options > Advanced > Java and make sure ``Use Java2" is enabled.<br />
<br />
=== To present your mind map on the web ===<br />
Use FreeMind's browser applet. The following [http://freemind.sourceforge.net/docs/Serving%20Freemind%20maps%20in%20a%20browser/index.html document] (thanks to Bob) explains what to do to have a complete testing environment for your applet. <br />
<br />
=== Quick Java Applet instructions if you are already a code wiz ===<br />
<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" ARCHIVE="freemindbrowser.jar" <br />
WIDTH="100%" HEIGHT="80%"><br />
<PARAM NAME="type" VALUE="application/x-java-applet;version=1.4"><br />
<PARAM NAME="scriptable" VALUE="false"><br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
<\!-- ^ this has no effect on my pc --><br />
<PARAM NAME="modes" VALUE="freemind.modes.browsemode.BrowseMode"><br />
<PARAM NAME="browsemode_initial_map" VALUE="http://www.osde.info/osde.mm"><br />
<\!-- ^ Put the FULL path to your map here --><br />
<param NAME="initial_mode" VALUE="Browse"><br />
<param NAME="selection_method" VALUE="selection_method_direct"><br />
</APPLET><br />
<br />
In some cases, it may be necessary to set the '''ARCHIVE''' property to also use the '''Full Path''' to the .jar file. In the above example, the initial '''APPLET''' element would appear as:<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" <br />
ARCHIVE="http://www.exmaple.com/freemindbrowser.jar" WIDTH="100%" HEIGHT="80%"><br />
<br />
The most recent version of above source and freemindbrowser.jar are contained in the freemindbrowser.zip-Archive, which you can get from [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=16120 the sourceforge-site].<br />
<br />
=== To view the toolbar automatically after the applet starts ===<br />
It is necessary to edit the html starter of the applet and change the corresponding property. That is, set<br />
toolbarVisible=true. More precisely, add a tag <br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
to freemindbrowser.html or whatever name you have changed the file to.<br />
<br />
=== Is there a list of names and values and functions of all params for the applet? ===<br />
No. Theoretically, all parameters found in user.properties can be used as parameters of the applet.<br />
<br />
<br />
=== Is it possible to change or edit the map through an applet? ===<br />
<br />
No. There is no applet for ''editing'' mind maps; only for viewing.<br />
<br />
=== My document isn't opened by the applet ===<br />
<br />
The URL of the document *must* end with .mm. If it doesn't the document opens in a new browser window. The trick I use is to append a dummy parameter like in this example:<br />
<br />
http://myserver/mypath/mydoc?e=.mm<br />
<br />
This trick is specially useful for dynamic documents. (this is an opinion only. Some people, like Garito, thinks in another way)<br />
<br />
===Java Applet for XHTML===<br />
<br />
The same Freemind Browser can be used but instead of using the 'applet' element, the 'object' element can be used instead. Using Shayne Steele's [http://ww2.cs.fsu.edu/~steele/XHTML/appletObject.html approach], the following code can be used for placing a file called Textbook.mm that is located in http://example.com/freemind/ (along with the freemindbrowser.jar file):<br />
<br />
&lt;!--[if !IE]--&gt;<br />
&lt;object classid="java:freemind.main.FreeMindApplet.class"<br />
type="application/x-java-applet"<br />
archive="http://example.com/freemind/freemindbrowser.jar"<br />
width="450" height="300"&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
&lt;object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"<br />
codebase="http://java.sun.com/update/1.5.0/jinstall-1_5_0-windows-i586.cab"<br />
height="300" width="450"&gt;<br />
&lt;param name="code" value="freemind.main.FreeMindApplet" /&gt;<br />
&lt;param name="archive" value="http://example.com/freemind/freemindbrowser.jar" /&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;strong&gt;<br />
This browser does not have a Java Plug-in.<br />
&lt;/strong&gt;<br />
&lt;br /&gt;<br />
&lt;a href="http://java.sun.com/products/plugin/downloads/index.html"&gt;<br />
Get the latest Java Plug-in here.<br />
&lt;/a&gt;<br />
&lt;/object&gt;<br />
&lt;!--[if !IE]&gt;--&gt;<br />
&lt;/object&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
<br />
It works and it is valid markup. If placing in an HTML file, use '&gt;' instead of ' /&gt;' for the param element ending.<br />
<br />
== Workarounds in FreeMind ==<br />
<br />
===FreeMind behaves strange or crashes. What can I do?===<br />
First try reinstalling both Java (mostly the latest version is best) and Freemind. Often this solves problems. <br />
One of the problems solved in this way was:<br />
<br />
'' ''My computer crashes, or more precisely locks, when I click on a link in FreeMind, using J2RE 1.4.2_03 on Windows 98. Reinstalling helped. In retrospect, I think what broke it was that I renamed the J2RE directory to something easier to write in the bat file path statement. Broke it. ''<br />
<br />
=== When I drag files into the FreeMind window, FreeMind just works very long or I get a mind map of the file system ===<br />
This is a bug which is a least present on FreeMind 7.2 beta and lower on Windows. I only know of a workaround for this: Go to the [[user.properties]] and delete ",freemind.modes.filemode.FileMode". This disables the file mode of FreeMind.<br />
<br />
=== Changing the key bindings in user.properties does not work ===<br />
It seems that capitalization IS important in the keybindings. I wrote "enter" and it didn't work. I changed it to "ENTER" and it worked!<br />
(FreeMind 7.2 beta)<br />
<br />
=== FreeMind fails to work with or to export big maps ===<br />
When FreeMind fails to work with big maps, you may do the following.<br />
<br />
Assign more memory to the Java virtual machine as a workaround by editing the launching script. Edit <code>freemind.bat</code> or <code>Freemind.sh</code> and add a <code>-Xmx''MEM''</code> parameter to the <code>java</code> command line at the end of the script, like <code>java -Xmx512m ...</code> for 512 megabytes maximum memory and <code>java -Xmx768m ...</code> for 768 megabytes maximum memory. Believing the manual of Java, the default is 64 MB and the maximum is slightly less than 2000 on an x86 processor, which should be enough.<br />
<br />
Beware that exporting may still take a while. For instance, it may take 11 minutes to export a mind map with 740 nodes to JPEG.<br />
<br />
=== Plugins not found when FreeMind 0.8 starts by double-clicking a FreeMind mind map ===<br />
<br />
The following Microsoft Windows laucher fixes the problem that plugins were not found when FreeMind was started by double-clicking a FreeMind mind map. Download the [http://sourceforge.net/tracker/index.php?func=detail&aid=1361629&group_id=7118&atid=307118 patch with fixed Windows launcher], and replace <tt>Freemind.exe</tt> found in <tt>C:\Program Files\FreeMind</tt> with the one found in the patch, given you are in Windows. Backing up the original <tt>Freemind.exe</tt> is advisable.<br />
<br />
== Using HTML in long nodes ==<br />
<br />
=== What HTML tags does FreeMind support? ===<br />
<br />
FreeMind supports basic HTML in its nodes. For HTML to take effect, a node must start<br />
with "&lt;html>". What HTML is supported depends on the Java virtual machine.<br />
Among others, users have reported the following uses:<br />
<br />
<nowiki><html><p style="background-color:yellow">the node text</p></nowiki><br />
<br />
<nowiki><html><p align="center">the node <br> text</p></nowiki><br />
<br />
=== To embed, or more precisely link, images into FreeMind. ===<br />
You can link images into FreeMind using context menu of a node, accesed using right click (on MAC OS X Panther use Control click). Or type the following:<br />
&lt;html&gt;&lt;img src=&quot;image.jpg&quot;&gt;&lt;/html&gt;<br />
where image.jpg is the reference to an image.<br />
<br />
=== To put the contents of a Microsoft Word document into FreeMind. ===<br />
<br />
* First paste the Word document into Microsoft FrontPage.<br />
* Delete the images afterwards as FreeMind does not support them.<br />
* Remove the &lt;head> ... &lt;/head> in the source text view in FrontPage.<br />
* But leave the &lt;html>! The node needs to start with that.<br />
* Replace &lt;body&gt; with &lt;body width=600&gt; or similar width specification.<br />
* Finally, paste the HTML text as a long node into FreeMind.<br />
<br />
=== To have tables in FreeMind ===<br />
If you have Microsoft Frontpage available, it is convenient to create and<br />
edit HTML content there and paste it to and from FreeMind. Beware that the html code has to start with<br />
''&lt;html&gt;''. This way, you can conveniently create tables using the drawing tools of Frontpage.<br />
You can create formatted text this way as well; in that case, beware to set ''&lt;body width=600&gt;''<br />
or similar. However, FreeMind does not interpret all HTML; especially, it does not interpret inline<br />
CSS styling so you have to use hard formatting instead.<br />
<br />
If you want the table borders to have a '''nice two dimensional look''' rather than bevelled, start<br />
the HTML as follows.<br />
<br />
<html><br />
<head><br />
<style> td { border-style: solid } table { border-style: solid } </style><br />
</head><br />
<br />
== Generating mind maps programmatically ==<br />
<br />
=== To insert a newline into a node ===<br />
<br />
Insert <code>&amp;#xa;</code> instead of plain newline. Example of a map with three newlines:<br />
<br />
<map version="0.7.1"><br />
<node TEXT="New Mindmap"><br />
<node TEXT="A&amp;#xa;B&amp;#xa;C&amp;#xa;D" POSITION="right"/><br />
</node><br />
</map><br />
<br />
=== To use unicode characters in the node text ===<br />
<br />
FreeMind understands and uses <code>&amp;#xnn;</code>, where nn is equivalent to the '''hexadecimal''' number representing the character. It '''does not''' understand <code>&amp;#nnn;</code>, where nnn is '''decimal''' number. An example of a map containing ''AretÃÂÃÂÃÂÃÂÃÂÃÂÃÂé'' follows.<br />
<br />
<map version="0.7.1"><br />
<node TEXT="Aret&amp;#xe9;"/><br />
</map><br />
<br />
== FreeMind on Microsoft Windows ==<br />
<br />
=== How do I install a test version of FreeMind? ===<br />
Just unzip the package to the folder "C:\Program Files\FreeMind". That completes the "installation".<br />
You can start it by running freemind.exe (or freemind.bat if the exe does not exist). You can find test versions [http://freemind.sourceforge.net/testversions/ here].<br />
<br />
=== FreeMind does not seem to be affected by the things I edit in the user.properties. Why? ===<br />
See [[user.properties]].<br />
<br />
=== FreeMind starts and reacts so slow. Why? How to resolve? ===<br />
This seems to be an effect of the connection between Java and MS DirectX. You can deactivate the usage of DirectX for Freemind by editing the Freemind.bat file in your FreeMind directory.<br />
<br />
Add the parameter<br />
<br />
-Dsun.java2d.noddraw=true <br />
<br />
before the final expression <tt>freemind.main.FreeMind</tt>.<br />
<br />
Of course, now you have to use Freemind.bat to start the program instead of executing Freemind.exe. Do not forget to update file associations as well: [[Windows File Associations]]<br />
<br />
=== File Operations are slow ===<br />
With Java6 Update2 you will probably notice this [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6578753 bug]. Sun is working on it. Perhaps, you can downgrade to Java6 Update1 or Java5 in the meantime.<br />
<br />
=== To create a screenshot of FreeMind and paste it into Microsoft Word or Microsoft Powerpoint ===<br />
To take a screenshot of your whole windows screen into clipboard, press Ctrl + Print Screen. To take a screenshot<br />
of the active window only into clipboard, press Alt + Print Screen. Select your Word or Powerpoint document<br />
and press Ctrl + V. On German keyboard, the key PrintScreen has the label "Druck". However, such a screenshot<br />
also contains FreeMind's window frame, not just the map contents. In Microsoft Word and Microsoft Powerpoint, this<br />
can be solved by cropping the screenshot; the cropping tool can be found in Picture toolbar..<br />
<br />
===To export a map to Microsoft Powerpoint===<br />
There's no elegant way to export a map to PowerPoint. One option is to take a screenshot, and paste it into Powerpoint. PowerPoint supports graphic file insertion, so another option is upgrading to a more recent version of FreeMind that supports JPEG export.<br />
<br />
One another solution is by using a Flash plugin:<br />
* Insert a control "Shockwave Flash Object" with the Control toolbar (go to display/toolbar/customise if not available).<br />
* Activate the propeties window by double clicking on the rectangle of the object<br />
* Click on the custom "property"<br />
* On the new opened window set the "movie URL" to the full path of the plugin (i.e: c:\path\visorFreemind.swf)<br />
* Set the "base URL" to the name of your freemind file (i.e.: index.mm) <br />
* Start your diaporama and you will see the cross inside the rectangle replaced by your freemind map<br />
<br />
If not successfull with those explanation, you will find a more complete information at the following address: [http://www.flashgeek.com FlashGeek]<br />
<br />
Or you can export to RTF using a XSLT like this:<br />
<br />
<?xml version="1.0" encoding="UTF-8" ?><br />
<br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><br />
<br />
<xsl:template match="/">{\rtf1\ansi\ansicpg1252<br />
{\fonttbl<br />
{\f1\fswiss\fcharset0\fprq0 Arial;}<br />
}<br />
{\colortbl;<br />
\red0\green0\blue0;<br />
}<br />
{\stylesheet<br />
{\s1\qc\f1\fs44\ppscheme-3\lang1110\level1 heading 1;}<br />
{\s2\li270\fi-270\f1\fs32\ppscheme-1\lang1110\level2 heading 2;}<br />
{\s3\li585\fi-225\f1\fs28\ppscheme-1\lang1110\level3 heading 3;}<br />
{\s4\li900\fi-180\f1\fs24\ppscheme-1\lang1110\level4 heading 4;}<br />
{\s5\li1260\fi-180\f1\fs20\ppscheme-1\lang1110\level5 heading 5;}<br />
{\s6\li1620\fi-180\f1\fs20\ppscheme-1\lang1110\level6 heading 6;}<br />
}<br />
<xsl:apply-templates /><br />
}<br />
</xsl:template><br />
<br />
<xsl:template match="node"><br />
\pard\plain\ltrpar\s1\qc\f1\fs44\ppscheme-3\lang1110{\f1 <xsl:value-of select="@TEXT"/>\par}<br />
<xsl:for-each select="child::node"><br />
\pard\plain\ltrpar\s2\li270\fi-270\f1\fs32\ppscheme-1\lang1110\li0\fi0\qc{\f1 <xsl:value-of select="@TEXT"/>\par}<br />
</xsl:for-each><br />
<xsl:apply-templates select="node" /><br />
</xsl:template><br />
<br />
</xsl:stylesheet> <br />
<br />
and then open it using PowerPoint.<br />
<br />
===To export / import a map to Microsoft Project===<br />
Look at the section [http://freemind.sourceforge.net/wiki/index.php/Import_and_export_to_other_applications Import and export to other applications]<br />
<br />
== FreeMind on Mac OS X ==<br />
<br />
FreeMind is written in the Java language, which is great for development and deployment of cross-platform applications.<br />
Freemind uses the Swing graphical user interface toolkit, which can use different looks and feels in order to mimic visuals and behaviours proprietary to the target execution platforms.<br />
<br />
<br />
On Microsoft Windows OS, the application fits quite nicely with the rest of the environment, but on Apple MacOS-X, things are often not quite right. MacOS-X users usually have higher expectations when it comes to usability and UI consistency, so they might become frustrated by the lack of compliance to their user interface guidelines.<br />
<br />
<br />
Here are some tips to enhance the user experience when using MacOS-X:<br />
<br />
<br />
#Keyboard shortcuts<br />
#:The "Tao Of Mac" weblog posted a tip for replacing the "CTRL" key by the "COMMAND" (Apple) key:<br />
#:http://the.taoofmac.com/space/Applications/FreeMind<br />
#Look and feel<br />
#:"Quaqua" is a look and feel for Swing that emulates the Aqua user interface:<br />
#:http://www.randelshofer.ch/quaqua/download.html<br />
#Shift-click to select multiple nodes.<br />
<br />
== FreeMind on Linux and other UNIX-like systems ==<br />
<br />
Go to the specific page [[FreeMind on Linux]].<br />
<br />
== Misc ==<br />
<br />
language = ja<br />
<br />
=== Is FreeMind mind mapping software? ===<br />
<br />
The term '''mind mapping''' is related to british psychologist Tony Buzan. In Buzan's context, mind map is a tree with many colors, pictures and personal expression. '''FreeMind is not''' really '''mind mapping''' software '''in the sense of Tony Buzan''', nevertheless, one would say that FreeMind belongs to the class of so called '''mind mapping software'''.<br />
<br />
Some of members of that class come pretty close to Buzan. Have a look at the site of first class commercial mind mapping software [http://www.mindjet.com/ MindManager]. You may also want to see [http://www.mind-mapping.co.uk/mind-maps-examples.htm examples] of mind maps in Buzan's sense.<br />
<br />
=== To spell FreeMind correctly. === <br />
"FreeMind", with a capital M.<br />
<br />
=== Where can I find a quick reference list of default keyboard shortcuts for the Windows 0.7.1 version? ===<br />
Here is a list of shortcuts, grouped by function:<br />
<br />
File commands:<br />
New map - Ctrl+N<br />
Open map - Ctrl+O<br />
Save map - Ctrl+S<br />
Save as - Ctrl+A<br />
Print - Ctrl+P<br />
Close - Ctrl+W<br />
Quit - Ctrl+Q<br />
Previous map - Ctrl+LEFT<br />
Next Map - Ctrl+RIGHT<br />
Export file to HTML - Ctrl+E<br />
Export branch to HTML - Ctrl+H<br />
Export branch to new MM file - Alt+A<br />
Open first file in history - Ctrl+Shift+W<br />
<br />
Edit commands:<br />
Find - Ctrl+F<br />
Find next - Ctrl+G<br />
Cut - Ctrl+X<br />
Copy - Ctrl+C<br />
Copy single - Ctrl+Y<br />
Paste - Ctrl+V<br />
<br />
Mode commands:<br />
MindMap mode - Alt+1<br />
Browse mode - Alt+2 <br />
File mode - Alt+3<br />
<br />
Node formatting commands:<br />
Italicize - Ctrl+I<br />
Bold - Ctrl+B<br />
Cloud - Ctrl+Shift+B<br />
Change node color - Alt+C<br />
Blend node color - Alt+B<br />
Change node edge color - Alt+E<br />
Increase node font size - Ctrl+L<br />
decrease node font size - Ctrl+M<br />
Increase branch font size - Ctrl+Shift+L<br />
Decrease branch font size - Ctrl+Shift+M<br />
<br />
Node navigation commands:<br />
Go to root - ESCAPE<br />
Move up - UP<br />
Move down - DOWN<br />
Move left - LEFT<br />
Move right - RIGHT<br />
Follow link - Ctrl+ENTER<br />
Zoom out - Alt+UP<br />
Zoom in - Alt+DOWN<br />
<br />
New node commands:<br />
Add sibling node - ENTER<br />
Add child node - INSERT<br />
Add sibling before - Shift+ENTER<br />
<br />
Node editing commands:<br />
Edit selected node - F2<br />
Edit long node - Alt+ENTER<br />
Join nodes - Ctrl+J<br />
Toggle folded - SPACE<br />
Toggle children folded - Ctrl+SPACE<br />
Set link by filechooser - Ctrl+Shift+K<br />
Set link by text entry - Ctrl+K<br />
Set image by filechooser - Alt+K<br />
Move node up - Ctrl+UP<br />
Move node down - Ctrl+DOWN<br />
<br />
=== To suggest new enhancements of FreeMind ===<br />
''Keywords: additional features, additional functions.''<br />
At FreeMind's project page, you can [http://sourceforge.net/tracker/?group_id=7118&atid=357118 submit Requests for Enhancements (RFEs)].<br />
<br />
=== Is MindMaster a rip off of FreeMind? ===<br />
<br />
''Update: the site of MindMaster is no longer there, thanks to Rezzie.''<br />
<br />
There is a [http://www.gigastorm.com/mindmaster/ web site] offering a product called MindMaster. This program is a ripped off version of FreeMind. It is not just a clone of FreeMind; it ''is'' just FreeMind renamed, and slightly modified. They even use the presentation texts as found on the main page of FreeMind. As FreeMind is licenced under GNU GPL, so must be MindMaster. However, on the MindMaster site and after the installation, they claim that they hold copyright to MindMaster, and that you are prohibited to use MindMaster unless you conform to their licence. This is unlawful. We urge you not to use or recommend MindMaster, and to avoid linking to their site or giving any recommendation. Also, you can write an email to them complaining about abuse of GNU General Public Licence. --[[User:Danielpolansky|Danielpolansky]] 11:15, 14 May 2005 (PDT)<br />
<br />
: I have been in contact with the author of [http://www.gigastorm.com/mindmaster/ MindMaster] and he has since removed the website and all links to the download. He did in fact claim it was released under the GPL and included both the licence and source code in the package, but as I didn't want to shell out $30 I cannot verify this. --[[User:Rezzie|Rezzie]] 23:49, 18 Oct 2005 (PDT)<br />
<br />
:: Thanks a lot. --[[User:Danielpolansky|Danielpolansky]] 09:50, 26 Oct 2005 (PDT)<br />
<br />
=== Where can I make a monetary donation to FreeMind? ===<br />
<br />
Currently, we do not accept any monetary donations. --[[User:Danielpolansky|Danielpolansky]] 00:32, 21 Nov 2005 (PST)<br />
<br />
== This FAQ ==<br />
<br />
=== I have a question not listed here, what should I do? ===<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page. Or specifically, ask your question in FreeMind's [http://sourceforge.net/forum/forum.php?forum_id=22102 Help forum]. Unfortunately, we cannot guarantee that you will get help, still, many users get it.<br />
<br />
=== To edit this FAQ ===<br />
Edit this page like any other wiki page (click edit or press alt-E). When adding a question to the talk page, imitate the format of already existing questions.<br />
<br />
=== Where can I practice editing pages on this Wiki? ===<br />
Click on this link and just hit the edit button on the lower right: [[Sandbox]]<br />
<br />
== Questions not yet answered ==<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page.<br />
<br />
Is FreeMind also Working under SuSe Linux 9.3 or perhaps already a part of the package?<br />
Answer: Yes, please see the "[[FreeMind on Linux]]" page here in the wiki.<br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Template:Languages&diff=10699
Template:Languages
2008-10-14T19:14:40Z
<p>Ewl: remove onlyinclude</p>
<hr />
<div><div class="LanguageLinks"><br />
<table width="100%"><br />
<tr valign="top" style="background: #EEF3E2"><br />
<td style="width: 25px; padding-left: 0.5em;">[[Image:Geographylogo.png|25px|Languages]]</td><br />
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #aaaaaa;">'''[[Project:Language policy|Languages]]:'''&nbsp;</td><td style="padding: 1px 1em 0; background: #F6F9ED;"><br />
'''[[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}|English]]'''<br />
{{Languages/Lang|af|{{{1|}}}}}<br />
{{Languages/Lang|ar|{{{1|}}}}}<br />
{{Languages/Lang|az|{{{1|}}}}}<br />
{{Languages/Lang|bcc|{{{1|}}}}}<br />
{{Languages/Lang|bg|{{{1|}}}}}<br />
{{Languages/Lang|br|{{{1|}}}}}<br />
{{Languages/Lang|ca|{{{1|}}}}}<br />
{{Languages/Lang|cs|{{{1|}}}}}<br />
{{Languages/Lang|da|{{{1|}}}}}<br />
{{Languages/Lang|de|{{{1|}}}}}<br />
{{Languages/Lang|el|{{{1|}}}}}<br />
{{Languages/Lang|es|{{{1|}}}}}<br />
{{Languages/Lang|fa|{{{1|}}}}}<br />
{{Languages/Lang|fi|{{{1|}}}}}<br />
{{Languages/Lang|fr|{{{1|}}}}}<br />
{{Languages/Lang|gu|{{{1|}}}}}<br />
{{Languages/Lang|he|{{{1|}}}}}<br />
{{Languages/Lang|hu|{{{1|}}}}}<br />
{{Languages/Lang|id|{{{1|}}}}}<br />
{{Languages/Lang|it|{{{1|}}}}}<br />
{{Languages/Lang|ja|{{{1|}}}}}<br />
{{Languages/Lang|ko|{{{1|}}}}}<br />
{{Languages/Lang|ksh|{{{1|}}}}}<br />
{{Languages/Lang|mr|{{{1|}}}}}<br />
{{Languages/Lang|ms|{{{1|}}}}}<br />
{{Languages/Lang|nl|{{{1|}}}}}<br />
{{Languages/Lang|no|{{{1|}}}}}<br />
{{Languages/Lang|oc|{{{1|}}}}}<br />
{{Languages/Lang|pl|{{{1|}}}}}<br />
{{Languages/Lang|pt|{{{1|}}}}}<br />
{{Languages/Lang|ro|{{{1|}}}}}<br />
{{Languages/Lang|ru|{{{1|}}}}}<br />
{{Languages/Lang|si|{{{1|}}}}}<br />
{{Languages/Lang|sq|{{{1|}}}}}<br />
{{Languages/Lang|sr|{{{1|}}}}}<br />
{{Languages/Lang|sv|{{{1|}}}}}<br />
{{Languages/Lang|th|{{{1|}}}}}<br />
{{Languages/Lang|tr|{{{1|}}}}}<br />
{{Languages/Lang|uk|{{{1|}}}}}<br />
{{Languages/Lang|vi|{{{1|}}}}}<br />
{{Languages/Lang|yue|{{{1|}}}}}<br />
{{Languages/Lang|zh|{{{1|}}}}}<br />
{{Languages/Lang|zh-hans|{{{1|}}}}}<br />
{{Languages/Lang|zh-hant|{{{1|}}}}}<br />
</td></tr></table></div></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Template:Languages/Lang&diff=11505
Template:Languages/Lang
2008-10-14T19:09:26Z
<p>Ewl: Keep purely the template</p>
<hr />
<div>{{#ifexist: {{#if: {{{2|}}} | {{{2}}} | {{#if: {{NAMESPACE}} | {{NAMESPACE}}:}}{{BASEPAGENAME}}}}/{{{1}}} | &nbsp;&bull;&nbsp;<span lang="{{{1}}}">{{#if: {{{2|}}}|[[{{{2}}}/{{{1}}}|{{#language:{{{1}}}}}]]| [[:{{NAMESPACE}}:{{BASEPAGENAME}}/{{{1}}}|{{#language:{{{1}}}}}]]}}</span>|<span></span>}}</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Template:Languages/Lang&diff=7161
Template:Languages/Lang
2008-10-14T19:07:57Z
<p>Ewl: Create template for languages/lang</p>
<hr />
<div><includeonly>{{#ifexist: {{#if: {{{2|}}} | {{{2}}} | {{#if: {{NAMESPACE}} | {{NAMESPACE}}:}}{{BASEPAGENAME}}}}/{{{1}}} | &nbsp;&bull;&nbsp;<span lang="{{{1}}}">{{#if: {{{2|}}}|[[{{{2}}}/{{{1}}}|{{#language:{{{1}}}}}]]| [[:{{NAMESPACE}}:{{BASEPAGENAME}}/{{{1}}}|{{#language:{{{1}}}}}]]}}</span>|<span></span>}}</includeonly><noinclude><br />
== Template ==<br />
''This sub-template doesn't display properly when not included. Please see [[Template:Languages]] for the complete version.''<br />
<br />
== Usage ==<br />
<br />
This template is designed to simplify [[Template:Languages]], by allowing a simpler syntax for adding new languages. Each language is included by calling this template with the following parameters:<br />
<br />
* '''Language code''' (e.g. fr)<br />
* (optional) '''Page name''' - if not supplied the page is automatically worked out based on where the language template is included.<br />
<br />
This template should not be used anywhere except in the Languages template.<br />
</noinclude></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Template:Languages&diff=7162
Template:Languages
2008-10-14T19:04:26Z
<p>Ewl: Create the Languages template</p>
<hr />
<div><onlyinclude><div class="LanguageLinks"><br />
<table width="100%"><br />
<tr valign="top" style="background: #EEF3E2"><br />
<td style="width: 25px; padding-left: 0.5em;">[[Image:Geographylogo.png|25px|Languages]]</td><br />
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #aaaaaa;">'''[[Project:Language policy|Languages]]:'''&nbsp;</td><td style="padding: 1px 1em 0; background: #F6F9ED;"><br />
'''[[{{{1|:{{NAMESPACE}}:{{BASEPAGENAME}}}}}|English]]'''<br />
{{Languages/Lang|af|{{{1|}}}}}<br />
{{Languages/Lang|ar|{{{1|}}}}}<br />
{{Languages/Lang|az|{{{1|}}}}}<br />
{{Languages/Lang|bcc|{{{1|}}}}}<br />
{{Languages/Lang|bg|{{{1|}}}}}<br />
{{Languages/Lang|br|{{{1|}}}}}<br />
{{Languages/Lang|ca|{{{1|}}}}}<br />
{{Languages/Lang|cs|{{{1|}}}}}<br />
{{Languages/Lang|da|{{{1|}}}}}<br />
{{Languages/Lang|de|{{{1|}}}}}<br />
{{Languages/Lang|el|{{{1|}}}}}<br />
{{Languages/Lang|es|{{{1|}}}}}<br />
{{Languages/Lang|fa|{{{1|}}}}}<br />
{{Languages/Lang|fi|{{{1|}}}}}<br />
{{Languages/Lang|fr|{{{1|}}}}}<br />
{{Languages/Lang|gu|{{{1|}}}}}<br />
{{Languages/Lang|he|{{{1|}}}}}<br />
{{Languages/Lang|hu|{{{1|}}}}}<br />
{{Languages/Lang|id|{{{1|}}}}}<br />
{{Languages/Lang|it|{{{1|}}}}}<br />
{{Languages/Lang|ja|{{{1|}}}}}<br />
{{Languages/Lang|ko|{{{1|}}}}}<br />
{{Languages/Lang|ksh|{{{1|}}}}}<br />
{{Languages/Lang|mr|{{{1|}}}}}<br />
{{Languages/Lang|ms|{{{1|}}}}}<br />
{{Languages/Lang|nl|{{{1|}}}}}<br />
{{Languages/Lang|no|{{{1|}}}}}<br />
{{Languages/Lang|oc|{{{1|}}}}}<br />
{{Languages/Lang|pl|{{{1|}}}}}<br />
{{Languages/Lang|pt|{{{1|}}}}}<br />
{{Languages/Lang|ro|{{{1|}}}}}<br />
{{Languages/Lang|ru|{{{1|}}}}}<br />
{{Languages/Lang|si|{{{1|}}}}}<br />
{{Languages/Lang|sq|{{{1|}}}}}<br />
{{Languages/Lang|sr|{{{1|}}}}}<br />
{{Languages/Lang|sv|{{{1|}}}}}<br />
{{Languages/Lang|th|{{{1|}}}}}<br />
{{Languages/Lang|tr|{{{1|}}}}}<br />
{{Languages/Lang|uk|{{{1|}}}}}<br />
{{Languages/Lang|vi|{{{1|}}}}}<br />
{{Languages/Lang|yue|{{{1|}}}}}<br />
{{Languages/Lang|zh|{{{1|}}}}}<br />
{{Languages/Lang|zh-hans|{{{1|}}}}}<br />
{{Languages/Lang|zh-hant|{{{1|}}}}}<br />
</td></tr></table></div></onlyinclude></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=File:FreeMind_Licenses_Situation.mm&diff=7149
File:FreeMind Licenses Situation.mm
2008-10-09T19:48:56Z
<p>Ewl: Situation of licenses and copyrights of FreeMind, presented as a Mindmap.</p>
<hr />
<div>Situation of licenses and copyrights of FreeMind, presented as a Mindmap.</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Translation&diff=7158
Translation
2008-08-07T08:32:06Z
<p>Ewl: /* State of translation */ clarify table meaning, add columns for patch and help map</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
How to contribute translations to FreeMind follows.<br />
<br />
==Step-by-step overview==<br />
<br />
# Get a SourceForge user.<br />
# Choose the editing tool if getting started.<br />
# Get the latest English translation.<br />
# Get the latest translation for your language.<br />
# Find and complete what is missing.<br />
# Set mnemonics in the translations.<br />
# Post to Translations tracker.<br />
# Register yourself as FreeMind translator if you prefer.<br />
<br />
==Getting a SourceForge user==<br />
<br />
To get a SourceForge user, visit [http://sourceforge.net/account/registration/ creation page], unless you already have a user. (You need a SourceForge user to post your translation to Translations tracker, as described below.)<br />
<br />
==Getting the latest translations==<br />
<br />
Look for a translation into your language present in the development [http://freemind.cvs.sourceforge.net/freemind/freemind/?pathrev=fm_060405_integration branch]. <br />
If such a translation is not present, take [http://freemind.cvs.sourceforge.net/freemind/freemind/Resources_en.properties?view=log the latest revision of Resources_en.properties].<br />
<br />
==Choosing the editing tool==<br />
<br />
Translation files can be edited using variety of tools.<br />
<br />
===Popeye===<br />
<br />
[http://popeye.sourceforge.net/ Popeye] <sup>[http://popeye.sourceforge.net/images/ScreenShot-0-4.jpg Screenshot] | [http://sourceforge.net/project/showfiles.php?group_id=136501 Download]</sup> can deal with several language property files at the same time, so you can contrast the original property file data with their translations. Also, the program can highlight all properties that do not have a translation set in one of the selected languages.<br />
<br />
: After a short test, I can recommend Popeye. No installation needed, works fine, looks good, and has a nice web.--[[User:Danielpolansky|Danielpolansky]] 03:26, 2 Jun 2007 (PDT)<br />
<br />
===Propedit===<br />
[http://propedit.sourceforge.jp/index_en.html Propedit]<sup>[http://propedit.sourceforge.jp/screenshot/eclipse/screenshot_eclipse_en.html Screenshot]</sup> can directly edit property files written in Unicode reference characters, thereby saving the time and effort of converting into Unicode through native2ascii. Its plugin is integrated with Eclipse and JBuilder. Files can be opened in the IDE and saved in Unicode. See also [http://sourceforge.jp/projects/propedit Propedit project page].<br />
<br />
===Plain text editor===<br />
<br />
A plain text editor is the tool of choice if you are well acquainted with them and prefer them. If so, you already probably have your favorite tool. If not, these tools include Microsoft Notepad, Notepad++, Vim, Emacs and a vast variety of other tools. <br />
<br />
Using plain text editor is more tricky in that the language translation files are using Java unicode notatiton, encoding a single non-latin character like <tt>\u4567</tt>, making the file less readable. A workaround is to convert the language file into UTF-8 encoding first, then edit it, and finally convert to Java notation again. The conversion is described in the following section. Once the text is in UTF-8 encoding, tools like Microsoft Notepad can be used, and the non-latin characters are shown as you would see them in a WYSIWYG editor. However, various plain text editors differ in their capability to show UTF-8 characters. Notepad on Windows XP is definitely able to do that.<br />
<br />
Another useful tool my be [http://www.esperanto-mv.pp.ru/UniRed/ENG/index.html UniRed].<br />
<br />
====Converting between Unicode notations====<br />
<br />
To convert a file in UTF-8 into <tt>\uXXXX</tt> Unicode escape notation, you may use [http://java.sun.com/j2se/1.3/docs/tooldocs/win32/native2ascii.html native2ascii] tool included with the Java SDK. Example of use (Resources_cs.properties.txt is before conversion):<br />
<br />
<small><!-- Better in CSS style sheet --><br />
<br />
cd C:\j2sdk1.4.2\bin><br />
native2ascii.exe -encoding UTF8 Resources_cs.properties.utf8.txt Resources_cs.properties<br />
<br />
</small><br />
<br />
Ideally, your file's name will be ''Resources_xx.properties'', where ''xx'' is the code of the language (e.g. en, de, dk etc.).<br />
<br />
To convert \uXXXX Unicode encoded file back to UTF-8, use a command similar to the following.<br />
<br />
<small><br />
<br />
cd C:\j2sdk1.4.2\bin><br />
native2ascii.exe '''-reverse''' -encoding UTF8 Resources_cs.properties Resources_cs.properties.utf8.txt<br />
<br />
</small><br />
<br />
==Setting mnemonics==<br />
<br />
For menu items, you can set mnemonics by putting "&" character before the letter of the mnemonic in the title of the menu item. For instance, "&Edit" means that the title of the menu will read "Edit" and its mnemonic will be "e". Mnemonic is a keyboard shortcut accessible in various ways; in Windows, either by pressing Alt + mnemonic, or by pressing F10, followed by the mnemonic. Mnemonics are there not only for the leading menus, but also for submenus and menu items.<br />
<br />
==Posting translations==<br />
<br />
[http://sourceforge.net/tracker/?atid=961129&group_id=7118 Send your translation to Translations tracker]. To be able to do it, you need a SourceForge user, which can be created at [http://sourceforge.net/account/registration/ Account Registration] page at SourceForge.<br />
<br />
==Registering yourself as FreeMind translator==<br />
<br />
If you are seriously planning to become a FreeMind translator, and want to receive ''Call for translations'' emails from us, please register yourself as translator by subscribing to ''TODO:the new mailing list''.<br />
<br />
==When to translate==<br />
<br />
We send a ''call for translation'' email after publishing the first release candidate of FreeMind, as at that point we can make sure that only few or possibly none new texts to translate will be added.<br />
<br />
A translator can still start creating and posting translations at any point of time, so he or she can distribute the workload in time.<br />
<br />
==Using new translation in FreeMind==<br />
<br />
# Write or [http://sourceforge.net/tracker/?atid=961129&group_id=7118 download] the <tt>Resources_xx.properties</tt> file.<br />
# Unpack the <tt>freemind.jar</tt> file with 7-Zip or similar into a temp folder.<br />
# Replace or add the <tt>Resources_xx.properties</tt> with the new one.<br />
# Repack the <tt>freemind.jar</tt> with the modified content of the temp folder.<br />
<br />
== Menu label checklist ==<br />
{| {{Table style}}<br />
! Menu Label Checklist || Poor || Good<br />
|-<br />
| In English, use capitalized labels || Move to root || Move to Root<br />
|-<br />
| Menu items leading to a dialog should end with ... . || Open <br> Close ... || Open... <br> Close<br />
|-<br />
| Do not repeat the verb already used in the menu heading || Export > Export to PNG <br> Insert > Insert Hyperlink || Export > As PNG <br> Insert > Hyperlink<br />
|}<br />
<br />
==State of translation==<br />
<br />
Currently, we have the following languages translated. The table below is out of date, mapping roughly the state at 0.8.1. It would be very helpful if the translators would update it. Up-to-date information of the state of translation can in any case be [http://freemind.cvs.sourceforge.net/freemind/freemind/?pathrev=fm_060405_integration found in CVS] and in [http://sourceforge.net/tracker/?atid=961129&group_id=7118 Translations tracker].<br />
<br />
{| {{Table style}} width="600px"<br />
! colspan="7" | Already Translated Languages<br />
|-------------------------------------------------<br />
! | Language || Language || Short || Last version patch || Last up-to-date version || Translator || Reviewer || Capitalized Titles || with help map?<br />
|-----------------------------------------------------------------<br />
| Czech || Česky || cs || || not released || Radek Švarz || Daniel Polansky ||No<br />
|-----------------------------------------------------------------<br />
| Chinese || trad.chinese || zh|| || 0.8.1? || [http://java.fromtw.com william chen] || &nbsp; || &nbsp;<br />
|-----------------------------------------------------------------<br />
| Chinese || simp.chinese || zh_CN|| || not released || [http://java.fromtw.com william chen] || &nbsp; || &nbsp;<br />
|-----------------------------------------------------------------<br />
| Danish || Dansk || dk || || 0.8.1? || || || <br />
|-----------------------------------------------------------------<br />
| Dutch || Nederlands || nl || || 0.8.1? || Koen Roggemans || ||No<br />
|-----------------------------------------------------------------<br />
| English || English || en || || 0.8.1? || N/A || || Yes || Yes<br />
|-----------------------------------------------------------------<br />
| Estonian || Eesti || et || [http://sourceforge.net/tracker/index.php?func=detail&aid=2020147&group_id=7118&atid=961129 0.9.0.beta18] || 0.8.1? || [http://sourceforge.net/users/elaugasson/ Edmund Laugasson] || || Yes<br />
|-----------------------------------------------------------------<br />
| Finnish || Suomi || fi || || not released || Matti Lassila || ||<br />
|-----------------------------------------------------------------<br />
| French || Francais || fr || || 0.8.1? || || Rickenbroc || || Yes<br />
|-----------------------------------------------------------------<br />
| German || Deutsch || de || || 0.8.1? || Christian Foltin || || || Yes<br />
|-----------------------------------------------------------------<br />
| Hungarian || || ? || || not released || [http://documan.sourceforge.net/ documan] || ||<br />
|-----------------------------------------------------------------<br />
| Italian || Italiano || it || || 0.8.1? || Bob Alexander || ||<br />
|-----------------------------------------------------------------<br />
| Japanese || Nihongo || ja || || 0.8.1? || Kohichi Aoki || [http://sourceforge.jp/projects/freemind-ja/wiki/ masataka55] ||<br />
|-----------------------------------------------------------------<br />
| Korean || Hangeul || kr || || 0.8.1? || Kim Jong Woo || ||<br />
|-----------------------------------------------------------------<br />
| Polish || Polski || pl || || not released || Rafal Kraik || || No<br />
|-----------------------------------------------------------------<br />
| Portuguese || Português || pt || || not released || Luis Ferreira || ||<br />
|-----------------------------------------------------------------<br />
| Brazilian Portuguese || Português brasileiro || pt_BR || || not released || [http://sourceforge.net/sendmessage.php?touser=1492544 Rodrigo Rizzi Starr] || ||<br />
|-----------------------------------------------------------------<br />
| Russian || Pусский || ru || || 0.8.1? || Dimitry Polivaev || ||<br />
|-----------------------------------------------------------------<br />
| Slovenian || || sl || || 0.8.1? || Martin Srebotnjak - filmsi || || No?<br />
|-----------------------------------------------------------------<br />
| Spanish || Espanol || es || || 0.8.1? || Hugo Gayosso || || Yes || Yes<br />
|-----------------------------------------------------------------<br />
| Turkish || Türkçe || tr || || not released || Uğur Çetin || || Yes<br />
|}<br />
<br />
# '''Last version patch:''' enter a link to the latest existing patch with the FreeMind version it concerns as text.<br />
# '''Last up-to-date version:''' enter the newest released version of FreeMind with up-to-date translation, consider beta versions as well.<br />
<br />
==Translating the documentation==<br />
<br />
The freemind.mm file, which is documentation in mindmap format, is a simple XML file. It can be found in your FreeMind installation (eg in Microsoft Windows XP, you'll find it in ''C:\Program Files\FreeMind\doc''). Open the file in a Unicode enabled text editor, and then simply translate everything in the TEXT attribute. For example:<br />
<br />
<node COLOR="#000000" CREATED="1124560950701" MODIFIED="1124560950701"<br />
TEXT="You can install the applet at your website so that other users can<br />
browse your mind maps."><br />
<br />
===Using Swordfish===<br />
<br />
If you want to use translation memory or a CAT tool, you can now use [http://www.maxprograms.com/products/swordfish.html Swordfish] to translate MM files. Swordfish is not free software.<br />
<br />
First, create a file named config_map.xml and put the following code in it:<br />
<br />
<?xml version="1.0" encoding="UTF-8" ?><br />
<!DOCTYPE ini-file PUBLIC "-//Maxprograms//Converters 2.0.0//EN" "configuration.dtd" ><br />
<ini-file><tag attributes="TEXT" hard-break="segment" keep-format="yes">node</tag></ini-file><br />
<br />
Then copy this file into the /ini folder of your Swordfish installation (there may be a file by that name already; if so, rename it temporarily).<br />
<br />
Run Swordfish and go File -> Convert file to XLIFF format. Remember to select the file type as "XML (Generic)" and the encoding as "UTF8". If you select "Embed skeleton", you may be able to recreate the MM file with a third-party XLIFF editor.<br />
<br />
<br />
==Feedback==<br />
<br />
Do you find this page difficult to understand? Are you missing some key information? [http://freemind.sourceforge.net/wiki/index.php?title=Talk:Translation&action=edit Tell us].<br />
<br />
[[Category:Development]]<br />
<br />
</table></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Import_and_export&diff=6909
Import and export
2008-06-16T15:55:52Z
<p>Ewl: Add Microsoft Office section</p>
<hr />
<div>: ''For conversion scripts and XSLT, see also [[Accessories]].''<br />
== Export and import in general ==<br />
<br />
* '''To and from Microsoft Excel''' Import and export with Microsoft Excel works by drag & drop or copy & paste of complete nodes. You can copy a selection of cells in Excel and drop it in FreeMind. Doing this with several columns, creates corresponding child nodes. This also works with the '''OpenOffice.org Calc''' spreadsheet application.<br />
* '''To and from OpenOffice Writer''' To export to OpenOffice Writer you first need to have all of the nodes on the right-hand side of the main/parent node in the mindmap (please make a correction if this is wrong). Then choose 'Select all' in the FreeMind mind map, go to OpenOffice Writer and select 'File > Paste'. OpenOffice Writer layouts using tab indentation can also be pasted into FreeMind which will recreate their tree structure.<br/>NB: Upcoming Freemind 0.9 supports direct export to OpenOffice Writer File (odt).<br />
* '''To Microsoft Word 2003''' To export to Microsoft Word, you need to select only the top-most node, which you want to export. Next, copy the node in Freemind and paste it into Word. this will copy the entire hierarchy starting with the selected node. This works even, when not all sub-notes were to the right of the one selected. If you would select and copy all nodes, export would end up with duplicate nodes and sub-nodes.<br />
*'''From Microsoft Word 2003''' Importing from Microsoft Word ended up with a confused hierarchy. (Please, can someone try how to do this best).<br />
* '''From KeyNote''' To prepare a file from Keynote save your tree structure by selecting 'Tree > Save Tree to File'. Open the created file as a text file and use select all to copy all content. Open FreeMind and create a new mindmap, Select a node and select 'File > Paste'.<br />
* '''From the Internet''' You can copy part of a web page in your browser and paste it to FreeMind. FreeMind analyzes the tree structure in the HTML and builds a mind map. The other formatting (bold, font sizes, etc.) is not taken into FreeMind.<br />
* '''To [http://freemind.freezope.org/FreemindWiki/MindManager MindManager]''' For this you will need the [http://krottmaier.cgv.tugraz.at/docs/seminar/sem2002_mindmaps.tar.gz XSLT transformation sheets] written by Christoph Rissner. This allows you to convert mind maps from FreeMind's XML format to a different XML format, which can then be directly imported to MindManager. For more detail you can read the text of the presentation [http://krottmaier.cgv.tugraz.at/docs/seminar/sem2002_mindmaps.pdf Seminarwork Mind Maps (PDF)] or only the [http://krottmaier.cgv.tugraz.at/veranstaltungen/seminar/abgeschlossen.html abstract].<br />
* '''To MindManager'' A perhaps easier, though slightly messy, approach is to export the FreeMind map with no folded nodes to HTML. Open the HTML file in Microsoft Word and save the map as a Word file. Then open the Word file in [[MindManager]] which supports the direct import of Word files as well as other Microsoft Office documents.<br />
* [http://freemind.freezope.org/FreemindWiki/ImportAndExportToEmacsAndWikipediaOutlines Import and export to Emacs and Wikipedia-outlines]<br />
* '''To and from Ganttproject''' To do this you will need the [http://kutsam.at/home/johannes/content/view/15/4/ XSL conversion script]. If you don't want to download the xalan package, you can use the xsl template in the zip archive on this page from within the freemind File->Export using XSLT.<br />
* Almost every outliner should be capable of exporting to a tab-indented outline. This can be pasted to FreeMind.<br />
* '''To and from GoalEnforcer''' Click the ""Software Integration"" button on GoalEnforcer Hyperfocus main window. Select ""Import from FreeMind"" or ""Export to FreeMind.""<br />
<br />
== FreeMind to FreeMind (Hoist) ==<br />
Changing the root node of a map could make it much easier to print. This hoist.xsl script needs a graphical link from the actual root node to the desired root node after the hoist operation. The former parent node become a child node of the new root and the ancestor tree turns like an umbrella in the storm. Try it:<br />
# select the root node and the desired new root and place a graphical link.<br />
# export using hoist.xsl<br />
<br />
<?xml version="1.0" encoding="UTF-8"?><br />
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"><br />
<xsl:template match="*|@*"><br />
<xsl:copy><br />
<xsl:copy-of select="@*"/><br />
<xsl:apply-templates/><br />
</xsl:copy><br />
</xsl:template><br />
<xsl:template match="/map"><br />
<xsl:copy><br />
<xsl:copy-of select="attribute_registry"/><br />
<xsl:apply-templates select="//node[@ID=/map/node/arrowlink/@DESTINATION]"/><br />
</xsl:copy><br />
</xsl:template><br />
<xsl:template match="//node[@ID=/map/node/arrowlink/@DESTINATION]"><br />
<xsl:copy><br />
<xsl:copy-of select="*|@*"/><br />
<xsl:apply-templates select="." mode="aws"/><br />
</xsl:copy><br />
</xsl:template><br />
<xsl:template match="node" mode="aws"><br />
<xsl:if test="parent::node"><br />
<xsl:element name="node"><br />
<xsl:attribute name="TEXT"><br />
<xsl:value-of select="../@TEXT"/><br />
</xsl:attribute><br />
<xsl:attribute name="ID"><br />
<xsl:value-of select="../@ID"/><br />
</xsl:attribute><br />
<xsl:if test="../@BACKGROUND_COLOR"><br />
<xsl:attribute name="BACKGROUND_COLOR"><br />
<xsl:value-of select="../@BACKGROUND_COLOR"/><br />
</xsl:attribute><br />
</xsl:if><br />
<xsl:if test="../@COLOR"><br />
<xsl:attribute name="COLOR"><br />
<xsl:value-of select="../@COLOR"/><br />
</xsl:attribute><br />
</xsl:if><br />
<xsl:if test="../@STYLE"><br />
<xsl:attribute name="STYLE"><br />
<xsl:value-of select="../@STYLE"/><br />
</xsl:attribute><br />
</xsl:if><br />
<xsl:if test="../@POSITION"><br />
<xsl:attribute name="POSITION"><br />
<xsl:value-of select="../@POSITION"/><br />
</xsl:attribute><br />
</xsl:if><br />
<xsl:apply-templates select="../edge|../arrowlink|../font|../icon"/><br />
<xsl:apply-templates select="preceding-sibling::node"/><br />
<xsl:apply-templates select="following-sibling::node"/><br />
<xsl:apply-templates select="parent::node" mode="aws"/><br />
<xsl:apply-templates select="../attribute"/><br />
</xsl:element><br />
</xsl:if><br />
</xsl:template><br />
</xsl:stylesheet><br />
<br />
# if you are missing something, you have to add it to the template match="node" mode="aws" (I only need edge, font, icon and attribute and don't know what else is possible.)<br />
# load your new map<br />
[[User:JR|JR]] 03:32, 17 Apr 2008 (PDT)<br />
<br />
== Emacs and Wikipedia outlines ← FreeMind ==<br />
<br />
There are two ways how to export FreeMind's mind map to the outline format understood by Emacs outlining mode and Wikipedia. Their descriptions follow.<br />
<br />
=== Use conversion scripts ===<br />
<br />
Our user has created two perl scripts for conversion between FreeMind and Emacs's outline.<br />
<!--<br />
<br />
* [[mm2outline]] will convert a FreeMind-mindmap to a format suitable for Emacs and Wikipedia-style-outlines (and with the option '-z' probably also for this wiki (Zwiki), not yet tested).<br />
<br />
* [[outline2mm]] will convert a Emacs-outline to a FreeMind-mindmap. This should also work with Wikipedia-style-outlines<br />
<br />
--><br />
<br />
* [http://www.clemburg.com/install/mm2outline mm2outline] for Emacs outline (Perl) (This version does not work for wikipedia!)<br />
<br />
<pre>#!/usr/bin/perl -w<br />
use strict;<br />
<br />
use Getopt::Std;<br />
use XML::Simple;<br />
use Data::Dumper qw(Dumper);<br />
<br />
# Copyright (c) 2004 Christian Lemburg.<br />
#<br />
# All rights reserved. This program is free software;<br />
# you can redistribute it and/or modify it under the<br />
# same terms as Perl itself.<br />
<br />
# usage<br />
<br />
my $usage = &lt;&lt;'EOU';<br />
<br />
Usage: $0 &lt; freemind.mm &gt; emacs-outline.txt<br />
<br />
Options:<br />
<br />
h: print help<br />
p: outline mode heading indicator pattern atom (default &quot;*&quot;)<br />
s: suppress topic of mind map as title in outline output (default off)<br />
<br />
EOU<br />
<br />
<br />
# setup<br />
<br />
my %opts;<br />
getopts('hsp:', \%opts);<br />
<br />
die $usage if $opts{h};<br />
<br />
my $heading_pattern_atom = $opts{p} || &quot;*&quot;;<br />
my $suppress_title = $opts{'s'};<br />
<br />
my $QUOTE = &quot;&amp;quot;&quot;;<br />
my $LESS_THAN = &quot;&amp;lt;&quot;;<br />
my $GREATER_THAN = &quot;&amp;gt;&quot;;<br />
my $NEWLINE = &quot;&amp;#xa;&quot;;<br />
<br />
# action<br />
<br />
my $xs = new XML::Simple();<br />
my $ref = $xs-&gt;XMLin(\*STDIN);<br />
<br />
die &quot;Could not find mind map in input&quot; unless exists $ref-&gt;{node};<br />
<br />
my $start = $ref-&gt;{node};<br />
print unquote($start-&gt;{TEXT}), &quot;\n\n&quot; unless $suppress_title;<br />
<br />
my $level = 0;<br />
process_children($start);<br />
<br />
<br />
# subs<br />
<br />
sub process_node {<br />
my ($node) = @_;<br />
process_node_text($node, $level);<br />
if (not is_leaf($node)) {<br />
process_children($node);<br />
}<br />
}<br />
<br />
sub process_children {<br />
my ($node) = @_;<br />
$level++;<br />
if (ref($node-&gt;{node}) eq &quot;ARRAY&quot;) {<br />
for my $child (@{$node-&gt;{node}}) {<br />
process_node($child);<br />
}<br />
} else {<br />
my $child = $node-&gt;{node};<br />
process_node($child);<br />
}<br />
$level--;<br />
}<br />
<br />
sub process_node_text {<br />
my ($node, $level) = @_;<br />
if (is_paragraph_leaf($node)) {<br />
print unquote($node-&gt;{TEXT}), &quot;\n\n&quot;;<br />
} else {<br />
print make_heading($level), &quot; &quot;, unquote($node-&gt;{TEXT}), &quot;\n\n&quot;;<br />
}<br />
}<br />
<br />
sub is_leaf {<br />
my ($node) = @_;<br />
return not exists $node-&gt;{node};<br />
}<br />
<br />
sub is_paragraph_leaf {<br />
my ($node) = @_;<br />
# define: paragraph leaf = leaf with text that contains newlines<br />
return is_leaf($node) &amp;&amp; $node-&gt;{TEXT} =~ /$NEWLINE/;<br />
}<br />
<br />
sub make_heading {<br />
my ($level) = @_;<br />
return $heading_pattern_atom x $level;<br />
}<br />
<br />
sub unquote {<br />
my ($s) = @_;<br />
$s =~ s/$QUOTE/&quot;/g;<br />
$s =~ s/$LESS_THAN/&lt;/g;<br />
$s =~ s/$GREATER_THAN/&gt;/g;<br />
$s =~ s/$NEWLINE/\n/g;<br />
return $s;<br />
}</pre><br />
<br />
* [http://www.clemburg.com/install/outline2mm outline2mm] for Emacs outline (Perl)<br />
<pre><br />
#!/usr/bin/perl<br />
use strict;<br />
<br />
use Getopt::Std;<br />
use POSIX;<br />
<br />
# Copyright (c) 2004 Christian Lemburg.<br />
#<br />
# All rights reserved. This program is free software;<br />
# you can redistribute it and/or modify it under the<br />
# same terms as Perl itself.<br />
<br />
# usage<br />
<br />
my $usage = &lt;&lt;'EOU';<br />
<br />
Usage: $0 &lt; emacs-outline.txt &gt; freemind.mm<br />
<br />
Options:<br />
<br />
h: print help<br />
l: pattern atom length (default 1)<br />
p: outline mode regex to recognize headings (default &quot;^(\\*+)&quot;)<br />
s: show suppressed text paragraphs (default off)<br />
t: topic (top level node text) for mind map output (default &quot;Start&quot;)<br />
<br />
EOU<br />
<br />
<br />
# setup<br />
<br />
my %opts;<br />
getopts('hsl:p:t:', \%opts);<br />
<br />
die $usage if $opts{h};<br />
<br />
my $QUOTE = &quot;&amp;quot;&quot;;<br />
my $LESS_THAN = &quot;&amp;lt;&quot;;<br />
my $GREATER_THAN = &quot;&amp;gt;&quot;;<br />
my $NEWLINE = &quot;&amp;#xa;&quot;;<br />
<br />
my $atom_length = $opts{l} || 1;<br />
my $pattern = $opts{p} || &quot;^(\\*+)&quot;;<br />
my $topic = $opts{t} || &quot;Start&quot;;<br />
my $show_suppressed_text_paragraphs = $opts{'s'};<br />
<br />
<br />
# action<br />
<br />
open_map();<br />
open_node(0, 1, $topic);<br />
<br />
my $n;<br />
my @l;<br />
my $found_heading = 0;<br />
my $text = &quot;&quot;;<br />
<br />
while (&lt;&gt;) {<br />
if (s/$pattern//) {<br />
<br />
# header number calculation<br />
# use only one global by using empty first place in @l<br />
$n = POSIX::floor(length($1) / $atom_length);<br />
$n &lt; $l[0] ? @l[$n+1..$#l] = (0)x($#l-$n) : 0;<br />
<br />
maybe_discharge_text($n);<br />
maybe_close_node($n, $l[0]);<br />
open_node($n, $l[0], $_);<br />
<br />
$l[$n]++;<br />
$l[0] = $n;<br />
} else {<br />
accumulate_text($_);<br />
}<br />
}<br />
<br />
maybe_close_node(0, $l[0]);<br />
close_map();<br />
<br />
<br />
# subs<br />
<br />
sub open_node {<br />
my ($n, $o, $s) = @_;<br />
# push, maybe multiple with empty parents<br />
for (my $i = 0; $i &lt; $n - $o - 1; $i++) {<br />
print indent($o + $i + 1), &quot;&lt;node TEXT=\&quot;\&quot;&gt;\n&quot;;<br />
}<br />
$s =~ s/^\s+//;<br />
$s =~ s/\s+$//;<br />
print indent($n), &quot;&lt;node TEXT=\&quot;&quot;, quote($s), &quot;\&quot;&gt;\n&quot;;<br />
}<br />
<br />
sub maybe_close_node {<br />
my ($n, $o) = @_;<br />
return unless $found_heading++;<br />
# pop, maybe multiple<br />
for (my $i = 0; $i &lt; $o + 1 - $n; $i++) {<br />
print indent($o - $i), &quot;&lt;/node&gt;\n&quot;;<br />
}<br />
}<br />
<br />
sub open_map {<br />
print &quot;&lt;map&gt;\n&quot;;<br />
}<br />
<br />
sub close_map {<br />
print &quot;&lt;/map&gt;\n&quot;;<br />
}<br />
<br />
sub indent {<br />
my ($l) = @_;<br />
# the map element is one above us<br />
$l++;<br />
return &quot; &quot; x $l;<br />
}<br />
<br />
sub accumulate_text {<br />
my ($s) = @_;<br />
$s =~ s/\s+$//;<br />
$s .= $NEWLINE;<br />
$text .= $s;<br />
}<br />
<br />
sub maybe_discharge_text {<br />
my ($n) = @_;<br />
return unless $show_suppressed_text_paragraphs;<br />
print indent($n + 1), &quot;&lt;node TEXT=\&quot;&quot; . quote($text) . &quot;\&quot;/&gt;\n&quot;<br />
unless is_only_whitespace($text);<br />
$text = &quot;&quot;;<br />
}<br />
<br />
sub quote {<br />
my ($s) = @_;<br />
$s =~ s/&quot;/$QUOTE/g;<br />
$s =~ s/&lt;/$LESS_THAN/g;<br />
$s =~ s/&gt;/$GREATER_THAN/g;<br />
return $s;<br />
}<br />
<br />
sub is_only_whitespace {<br />
my ($s) = @_;<br />
$s =~ s/$NEWLINE/\n/g;<br />
return $s =~ /\A\s*\Z/;<br />
}</pre><br />
<br />
<!-- Unfortunately none of those links works at the moment (2008-02-20).<br />
I am also unable to find the scripts somewhere else --><br />
<br />
=== Export from Emacs with freemind.el ===<br />
<br />
There is an Emacs library on EmacsWiki that exports to FreeMind:<br />
<br />
[[http://www.emacswiki.org/cgi-bin/emacs/FreeMind freemind.el]]<br />
<br />
=== Patch FreeMind to paste outline to clipboard ===<br />
<br />
Patching the source code is sensible, only if you are a software developer. In FreeMind's source in modes/mindmapmode/!MindMapNodeModel.java replace the lines<br />
<br />
for (int i=0; i < depth; ++i) {<br />
fileout.write(" "); }<br />
<br />
if (this.toString().matches(" *")) {<br />
<br />
with<br />
<br />
for (int i=0; i < depth; ++i) {<br />
fileout.write("*"); } //changed<br />
<br />
fileout.write(" "); // new<br />
<br />
if (this.toString().matches(" *")) {<br />
<br />
and if you copy a node in FreeMind you will find an Emacs/Wiki outline in the clipboard!<br />
<br />
See also: [[How to compile FreeMind]]<br />
<br />
Does anybody know how to patch FreeMind that it will also import these outline?<br />
(I made an [http://sourceforge.net/tracker/index.php?func=detail&aid=932531&group_id=7118&atid=357118 feature request] out of this.)<br />
<br />
==MindManager ↔ FreeMind==<br />
<br />
=== Indirect MindManager 4.0 to FreeMind conversion ===<br />
<br />
How I converted all my mindmanager-mindmaps to freemind in one go. This works for me. Perhaps not for you. <br />
Mindmanager 4.0: MMScript?-Editor has a problem with: Dim mm As MmImageType?<br />
<br />
# Download Download XSLT transformations sheets from Christoph Rissner from http://hkrott.iicm.edu/docs/seminar/sem2002_mindmaps.tar.gz and extract. You need some of those files in step 4 an step 8. <br />
# Open Mindmap in Mindmanager 2002 (With Mindmanager 4.0 I had a problem with "Dim mm As MmImageType?". You CAN use further the MMScript?-Editor after the 21-days-trial-tim)<br />
# Menu->Tools->MMScript?-Editor<br />
# MMScript?-Editor: Menu->Open File->exportXML.MMScript? (see step 1)<br />
# Menu->Makro->Ausführen (or key "F5") <br />
# (x) Export whole map, Choose destination file, (OK) <br />
# Copy all xml-Files in a new directory or make of cource a backup of all your mindmaps! Sorry windows, with linux the following conversion is very easy. Perhaps do it with windows with a batch-file or something else. <br />
# Save the following bash-script to "mmtofmconvert" and make it executable with "chmod a+x mmtofmconvert":<br />
<br />
#! /bin/sh<br />
# mmtofm-convert<br />
# Leerzeichen in Dateinamen in _ umwandeln<br />
for f in *\ *; do mv "$f" "`echo $f | tr \ _`"; done<br />
# xml-Dateien in mm umwandeln<br />
# Pfad zur Datei mm2fm.xslt muss angepasst werden! See step 1<br />
# xsltproc: http://xmlsoft.org/XSLT/<br />
for f in *.xml; do xsltproc -o `basename $f .xml`.mm /home/pete/mm2fm.xslt $f; done <br />
# ACHTUNG! Entferne alle xml und mmp-Dateien. <br />
# Attention! Delete all xml- and mmp-files!<br />
#rm *.xml *.mmp <!-- template extracting data from the current note --><br />
# Codierung von utf-8 in lokal erwünschte umwandeln. With work for me.<br />
recode utf-8 *.mm<br />
<br />
# execute script from step 8 in every directory with the xml-files you want to transform. <br />
# the exported mindmaps have exactly the same structure like the original! I am lucky. <br />
Regards, Peter<br />
<br />
NOTE: The above version of the XSLT script does not process the MindManager "notes" if they exist for each node. This is my first time working with XSLT, but the following ammendment to "mm2fm.xslt" worked for me (sections below added after line 55 in the template '<xsl:template match="data">'):<br />
<br />
<!-- adp: sub-section added to convert detailed MindManager notes --><br />
<xsl:if test="boolean(note)"><br />
<xsl:element name="node"><br />
<xsl:apply-templates select="note"/><br />
</xsl:element><br />
</xsl:if><br />
</xsl:template><br />
<br />
<!-- adp: template extracting detailed MindManager notes as a new sub-node --><br />
<xsl:template match="note"><br />
<xsl:apply-templates select="color"/><br />
<xsl:apply-templates select="text"/><br />
<xsl:element name="font"><br />
<xsl:apply-templates select="font"/><br />
</xsl:element><br />
</xsl:template><br />
--[[User:Apalmer00|Apalmer00]] 10:27, 26 Jan 2005 (PST)<br />
<br />
=== Direct MindManager X5 to FreeMind conversion ===<br />
<br />
I received a couple of MindManager mindmaps that I had to convert to FreeMind. These mmap files turned out to be zip-files containing an XML file with the mindmap data. So I've written a basic XSLT which directly transforms this XML to the FreeMind format without the need to install MindManager. I suppose a convenient Import from MindManager could thus be provided in FreeMind using this info/xslt. I also suppose that this XSLT could be extended to transform additional specifics like edge-color, edge-width, etc, but I could not immediately figure out where such data is stored in MindManager's XML, as I do not have MindManager.<br />
<br />
'''Q:''' How does one actually use the XSLT? E.g. I have an mmap, how do I open it in FreeMind?<br />
<br />
NB: I changed ''"concat(#,'' below to ''"concat('#', below to make it work. I also used jar xf file.mmap to extract the files.<br />
<br />
''<br />
<?xml version="1.0" encoding="iso-8859-1"?><br />
<!--<br />
Author: Wouter Van den Broeck - wjvdbroe [at] vub . ac . be<br />
Version: v0.1<br />
Date: June 12, 2004 This is an XSL/T to transform mindmaps from MindManager to FreeMind.<br />
MindManager files are actually zip files and can thus be opened in a <br />
standard zip-tool (e.g. by dragging-dropping the mmap file onto WinZip).<br />
The Document.xml file can then be extracted and transformed using this XSLT to<br />
e.g. Document.mm .<br />
This first version transforms:<br />
- Textual content (maintaining iso-8859-1 characters, e.g. german umlauts)<br />
- Text color<br />
- Graphic links (relations in MindManager)<br />
--><br />
<xsl:stylesheet version="1.0"<br />
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"<br />
xmlns:ap="http://schemas.mindjet.com/MindManager/Application/2003"<br />
><br />
<xsl:output<br />
method="xml"<br />
version="1.0"<br />
encoding="iso-8859-1"<br />
omit-xml-declaration="yes"<br />
indent="yes"<br />
/> <!-- root element --> <br />
<xsl:template match="/"><br />
<xsl:element name="map"><br />
<xsl:attribute name="version">0.7.1</xsl:attribute><br />
<xsl:apply-templates select="ap:Map/ap:OneTopic/ap:Topic" /><br />
</xsl:element><br />
</xsl:template><br />
<xsl:template match="ap:Topic"><br />
<xsl:element name="node"><br />
<xsl:attribute name="TEXT"><br />
<xsl:value-of select="ap:Text/@PlainText" /><br />
</xsl:attribute> <xsl:if test="ap:Text/ap:Font/@Color"><br />
<xsl:attribute name="COLOR"><br />
<xsl:value-of select="concat('#', substring(ap:Text/ap:Font/@Color, 3, 6))" /><br />
</xsl:attribute><br />
</xsl:if><br />
<xsl:variable name="OId" select="@OId" /><br />
<xsl:variable name="relation" select="/ap:Map/ap:Relationships/ap:Relationship[ap:ConnectionGroup[@Index=0]/ap:Connection/ap:ObjectReference/@OIdRef=$OId]" /><br />
<xsl:if test="$relation"><br />
<xsl:variable name="toId" select="$relation/ap:ConnectionGroup[@Index=1]/ap:Connection/ap:ObjectReference/@OIdRef" /><br />
<xsl:element name="arrowlink"><br />
<xsl:attribute name="ENDARROW">Default</xsl:attribute><br />
<xsl:attribute name="DESTINATION"><br />
<xsl:value-of select="$relation/ap:ConnectionGroup[@Index=1]/ap:Connection/ap:ObjectReference/@OIdRef" /><br />
</xsl:attribute><br />
<xsl:attribute name="STARTARROW">None</xsl:attribute><br />
</xsl:element><br />
</xsl:if><br />
<xsl:variable name="toId" select="/ap:Map/ap:Relationships/ap:Relationship/ap:ConnectionGroup[@Index=1]/ap:Connection/ap:ObjectReference[@OIdRef=$OId]/@OIdRef" /><br />
<xsl:if test="$toId"><br />
<xsl:attribute name="ID"><br />
<xsl:value-of select="$toId" /><br />
</xsl:attribute><br />
</xsl:if><br />
<xsl:apply-templates select="ap:SubTopics"/><br />
</xsl:element><br />
</xsl:template><br />
</xsl:stylesheet><br />
<br />
Here is an online conversion utility (using the above XSLT) that will convert a .mmap file to Freemind format:<br />
<br />
http://www.liberatedcomputing.org/mm2fm<br />
<br />
'''Q:''' How can I convert a mmap file with non-latin characters, such as Chinese and Japanese characters? Those words and sentenses will became several Question Marks!<br />
<br />
NB: Please check your JVM default property ''"file.encoding"''. <br />
<br />
''<br />
String defaultEncodingName = System.getProperty( "file.encoding" );<br />
System.out.println(defaultEncodingName);<br />
''<br />
<br />
Since "mmap" file's encoding is "UTF8", so that we have to use "UTF8" with ''"file.encoding"'' property. I straightly change the startup script to support it. <br />
<br />
E.g: In Windows Version, it has a ''"freemind.bat"''.<br />
<br />
''<br />
java '''-Dfile.encoding=UTF8''' -cp lib\freemind.jar;...<br />
''<br />
<br />
=== Mmap format is a jar file ===<br />
<br />
MindManager's file format of .mmap files is a zipped file:<br />
<br />
/home/dgriff> jar tvf Requirements.mmap<br />
1782 Mon Jun 14 15:00:38 BST 2004 bin/C96CF30F-3F6E-460B-8D5A-ED5F65E852D4.bin<br />
102572 Mon Jun 14 15:00:38 BST 2004 Document.xml<br />
2265 Mon Jun 14 15:00:38 BST 2004 xsd/MindManagerDelta.xsd<br />
48314 Mon Jun 14 15:00:38 BST 2004 xsd/MindManagerApplication.xsd<br />
0 Mon Jun 14 15:00:38 BST 2004 xsd/<br />
5037 Mon Jun 14 15:00:38 BST 2004 xsd/MindManagerCore.xsd<br />
0 Mon Jun 14 15:00:38 BST 2004 bin/<br />
13615 Mon Jun 14 15:00:38 BST 2004 xsd/MindManagerPrimitive.xsd<br />
13518 Mon Jun 14 15:00:38 BST 2004 Preview.png<br />
<br />
Dave Griffiths<br />
<br />
---<br />
<br />
If that is the case, it should be possible to create XSLT that converts directly between FreeMind's and MindManager's XML. Additionally, one should be also able to get the contents of .mmap by renaming a copy of it to .zip and opening in favorite zip application.<br />
<br />
An advantage of this approach should be obvious; you don't need MindManager to covent a MindManager's map to FreeMind's map. Therefore, you do it on any operating system you like.<br />
<br />
This all surely does apply only from certain version of MindManager above. That should be clarified.<br />
<br />
It is not true for files saved using MindManager 4.0 Standard Edition.<br />
<br />
=== Importing Mindmap from Mindmanager directly into Freemind 0.9b9 ===<br />
Starting with freemind 0.9 b9 (?) it became possible to import a Mmap-File directly<br />
<br />
To convert notes from Mindmanager to Freemind notes you have to replace the following lines in mindmanager2mm.xsl<br />
<xsl:template match="ap:NotesGroup"> <br />
<xsl:element name="hook"><br />
<xsl:attribute name="NAME"><br />
<xsl:text>accessories/plugins/NodeNote.properties</xsl:text><br />
</xsl:attribute><br />
<xsl:element name="text"><br />
<xsl:value-of select="ap:NotesXhtmlData/@PreviewPlainText"/><br />
</xsl:element><br />
</xsl:element><br />
</xsl:template><br />
<br />
with<br />
<xsl:template match="ap:NotesGroup"> <br />
<richcontent TYPE="NOTE"><html><br />
<head> <br />
</head><br />
<body><br />
&lt;p&gt;<br />
<xsl:value-of select="ap:NotesXhtmlData/@PreviewPlainText" disable-output-escaping="yes" /><br />
&lt;/p&gt;<br />
</body><br />
</html><br />
</richcontent><br />
</xsl:template><br />
<br />
=== To fix problems with character encoding ===<br />
<br />
Try to change the encoding="UTF-8" to encoding="iso-8859-1" in the xslt sheet posted above.<br />
<br />
==Text → FreeMind==<br />
<br />
[[WouterBolsterlee|Wouter Bolsterlee]] wrote a small tool named Text-to-Freemind. This program converts tab-indented text files into an XML format suitable for display by FreeMind. It was written out of annoyance with the FreeMind user interface, and the lack of ‘merging’ capabilities when collaborating with other people. More information, including an example and download links, is available from [http://uwstopia.nl/blog/2007/10/text-to-freemind-released Wouter Bolsterlee's blog entry on Text-to-Freemind].<br />
<br />
==CSV text ← FreeMind==<br />
This is an XSLT to output a Freemind mind map as a CSV text file with extra commas to represent the hierarchy. This is useful for importing into Excel to represent the nesting of nodes as a colum view.<br />
<br />
<?xml version="1.0"?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><br />
<xsl:output method="text"/><br />
<xsl:template match="/"><br />
<xsl:apply-templates/><br />
</xsl:template><br />
<xsl:template name="linebreak"><br />
<xsl:text>&#x20;&#xA;</xsl:text><br />
</xsl:template><br />
<xsl:template match="map"><br />
<xsl:apply-templates select="child::node"/><br />
</xsl:template><br />
<xsl:template match="node"><br />
<xsl:param name="commaCount">0</xsl:param><br />
<xsl:if test="$commaCount &gt; 0"><br />
<xsl:call-template name="writeCommas"><br />
<xsl:with-param name="commaCount" select="$commaCount"/><br />
</xsl:call-template><br />
</xsl:if><br />
<xsl:value-of select="@TEXT"/><br />
<xsl:call-template name="linebreak"/><br />
<xsl:apply-templates select="child::node"><br />
<xsl:with-param name="commaCount" select="$commaCount + 1"/><br />
</xsl:apply-templates><br />
</xsl:template><br />
<xsl:template name="writeCommas"><br />
<xsl:param name="commaCount">0</xsl:param><br />
<xsl:if test="$commaCount &gt; 0">,<xsl:call-template name="writeCommas"><br />
<xsl:with-param name="commaCount" select="$commaCount - 1"/><br />
</xsl:call-template><br />
</xsl:if><br />
</xsl:template><br />
</xsl:stylesheet><br />
<br />
Developed by [mailto:michael.bell@simulacra.com Mike Bell] at Simulacra.<br />
<br />
If you have issues with accuented characters not being transferred correctly in Excel, you can do the following:<br />
<br />
# save the exported file as ''somename''.txt (instead of ''somename''.csv)<br />
# start Excel<br />
# menu point File -> Open...<br />
# choose "Files of Type" = Text Files (...*.txt...)<br />
# then you get a dialogue where you can choose the "File Origin", which in Western Europe and USA is most probably one of Unicode (UTF-8) or Western European (ISO or Windows, I'd guess). Anyway, change the "origin" (correctly it's called charset) until the accents in the preview window are correctly shown.<br />
<br />
Something similar should work under oocalc from [http://openoffice.org OpenOffice].<br />
<br />
Alternatively, one could also try to add an "encoding" parameter to the "output" element of the XSLT sheet, like in [http://www.zvon.org/xxl/XSLTreference/OutputOverview/xslt_output_encoding_frame.html Zvon's XSLT Reference].<br />
<br />
==Tabulator separated text ← FreeMind==<br />
This is a modification of the above XSLT script to output a FreeMind map as a tabulator separated text file with the first column represent the hierarchy, the 2nd the path as 1.1.1 number, followed by the node title and the attribute value pairs (FreeMind 0.9.0 beta16) which are present in the attribute_registry. This is extremely useful if you keep the position of your attributes constant over the whole tree! Importing into Calc or Excel is straight forward.<br />
<br />
<?xml version="1.0"?><br />
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><br />
<xsl:output method="text"/><br />
<xsl:template match="/"><br />
<xsl:apply-templates/><br />
</xsl:template><br />
<xsl:template name="linebreak"><br />
<xsl:text>&#x20;&#xA;</xsl:text><br />
</xsl:template><br />
<xsl:template name="tabulator"><br />
<xsl:text> </xsl:text><br />
</xsl:template><br />
<xsl:template match="map"><br />
<xsl:apply-templates select="child::node"/><br />
</xsl:template><br />
<xsl:template match="attribute"><br />
<xsl:value-of select="@NAME"/><br />
<xsl:text> =</xsl:text><br />
<xsl:call-template name="tabulator"/><br />
<xsl:value-of select="@VALUE"/><br />
<xsl:call-template name="tabulator"/><br />
</xsl:template> <br />
<xsl:template match="node"><br />
<xsl:value-of select="count(../ancestor-or-self::node)" /><br />
<xsl:call-template name="tabulator"/><br />
<xsl:number count="node" level="multiple" format="1.1"/><br />
<xsl:call-template name="tabulator"/><br />
<xsl:value-of select="@TEXT"/><br />
<xsl:call-template name="tabulator"/><br />
<xsl:apply-templates select="child::attribute[@NAME=//attribute_registry/attribute_name/@NAME]"/><br />
<xsl:call-template name="linebreak"/><br />
<xsl:apply-templates select="child::node"><br />
</xsl:apply-templates><br />
</xsl:template><br />
</xsl:stylesheet><br />
<br />
[[User:JR|JR]] 07:38, 20 Mar 2008 (PDT)<br />
<br />
== VYM → FreeMind ==<br />
<br />
The following XSLT converts an XML export file from VYM to freemind format (only links, Icons and colors are preserved):<br />
<br />
<pre><br />
<xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><br />
<br />
<xsl:template match="/"><br />
<xsl:apply-templates select="/vymmap/mapcenter" /><br />
</xsl:template><br />
<br />
<xsl:template match="/vymmap/mapcenter"><br />
<map version="0.8.0"><br />
<node ID="_" TEXT="map imported from VYM"><br />
<xsl:apply-templates select="branch" /><br />
</node><br />
</map><br />
</xsl:template><br />
<br />
<xsl:template match="branch"><br />
<node CREATED="0" MODIFIED="0"><br />
<xsl:attribute name="TEXT"><br />
<xsl:value-of select="heading" /><br />
</xsl:attribute><br />
<xsl:attribute name="COLOR"><br />
<xsl:value-of select="heading/@textColor" /><br />
</xsl:attribute><br />
<xsl:if test="@url != ''"><br />
<xsl:attribute name="LINK"><br />
<xsl:value-of select="@url" /> <br />
</xsl:attribute><br />
</xsl:if><br />
<xsl:attribute name="ID">VYM_<xsl:value-of select="@x1" />_<xsl:value-of select="@y1" /></xsl:attribute><br />
<xsl:apply-templates select="standardflag" /> <br />
<xsl:apply-templates select="branch" /><br />
</node><br />
</xsl:template><br />
<br />
<xsl:template match="standardflag"><br />
<xsl:choose><br />
<xsl:when test=". = 'lifebelt'"><icon BUILTIN="flag"/></xsl:when><br />
<xsl:when test=". = 'flash'"><icon BUILTIN="clanbomber"/></xsl:when><br />
<xsl:when test=". = 'heart'"><icon BUILTIN="bookmark"/></xsl:when><br />
<xsl:when test=". = 'thumb-down'"><icon BUILTIN="button_cancel"/></xsl:when><br />
<xsl:when test=". = 'thumb-up'"><icon BUILTIN="button_ok"/></xsl:when><br />
<xsl:when test=". = 'arrow-down'"><icon BUILTIN="full-7"/></xsl:when><br />
<xsl:when test=". = 'arrow-up'"><icon BUILTIN="full-1"/></xsl:when><br />
<xsl:when test=". = 'lamp'"><icon BUILTIN="idea"/></xsl:when><br />
<xsl:when test=". = 'clock'"><icon BUILTIN="bell"/></xsl:when><br />
<xsl:when test=". = 'smiley-sad'"><icon BUILTIN="button_cancel"/></xsl:when><br />
<xsl:when test=". = 'smiley-good'"><icon BUILTIN="ksmiletris"/></xsl:when><br />
<xsl:when test=". = 'stopsign'"><icon BUILTIN="stop"/></xsl:when><br />
<xsl:when test=". = 'cross-red'"><icon BUILTIN="button_cancel"/></xsl:when><br />
<xsl:when test=". = 'hook-green'"><icon BUILTIN="button_ok"/></xsl:when><br />
<xsl:when test=". = 'questionmark'"><icon BUILTIN="help"/></xsl:when><br />
<xsl:when test=". = 'exclamationmark'"><icon BUILTIN="messagebox_warning"/></xsl:when><br />
</xsl:choose><br />
</xsl:template><br />
<br />
</xsl:transform><br />
</pre><br />
<br />
[[User:McRee|McRee]] 03:12, 14 Nov 2006 (PST)<br />
<br />
== Mantis bug tracker → FreeMind ==<br />
<br />
Importing issues from the Mantis bug tracker to FreeMind:<br />
<br />
There is a script to export issues from mantis to FreeMind. See http://bugs.mantisbt.org/view.php?id=7214<br />
<br />
Mantis 1.12 ships with integrated freemind support: "This is similar to the relationship diagrams are already available in Mantis. However, the Freemind features comes with a built in Flash viewer (hence, easier to get up and running), includes details about the issues, relationships, attachments, statuses, links, etc. It is also possible to export a Freemind file." [http://www.mantisbt.org/blog/?p=19]<br />
<br />
== FreeMind export to Microsoft Office 2003 and newer ==<br />
<br />
Export works only with Microsoft office versions able to read XML formats, i.e. 2003 and newer (one reason why PowerPoint isn't supported is because it doesn't know any XML format).<br />
<br />
=== Export to Excel ===<br />
<br />
Use the menu File -> Export -> using XSLT...<br />
Browse to find the XSL file under the sub-directory accessories of FreeMind's base directory called "mm2xls_utf8.xsl", call your ExportFile "something.xls" and Excel will open it by a simple double click on the resulting file.<br />
<br />
=== Export to Word ===<br />
<br />
A very similar procedure can be used for word documents with the XSLT sheet called mm2wordml_utf8.xsl (call the export file something.doc).<br />
<br />
=== Export to MS Project ===<br />
<br />
For MSProject files using mm2msp_utf8.xsl, it's a bit more tricky as you need to name the export file something.xml and open it from MS Project using "XML file, *.xml" as file type.<br />
<br />
; Note : check following chapter for alternative ways.<br />
<br />
==Microsoft Project ↔ FreeMind==<br />
<br />
===From MS Project===<br />
<br />
I've been using a perl module [[Media:MindMap.pm]] to import from Microsoft Project into Freemind. Microsoft Project is useful, but cluttered. Large projects are, in my experience, difficult to examine. On the other hand, Microsoft Project supports reading via OLE, and thus can be rendered into Freemind which can be more useful because it is less cluttered, and more flexible. (Downside: this requires an executable copy of Microsoft Project on the host on which it is executed.)<br />
<br />
Sample script [[Media:mpp2mm.pl]] -- this converts a project plan into Freemind map using the work breakdown structure field. Completed tasks get the check icon, and the notes field is a note on the task.<br />
<br />
Alternate approach [[Media:generateOrgChart.pl]] -- this was designed for a plan in which field Text7 contained organizational information. The project plan was converted into a Freemind map where the top branching encoded task status (one of: "expired but not complete", "at risk", "due in 30 days", "due in 60 days", "due in 90 days", "weird" [things like start date in the future but some work accomplished], "normal"), then branch by Text7, possibly delimited, then branch by resource, then display the task.<br />
<br />
Another approach I've implemented was to index via a concordance -- top layer tier an alphabet, then below that key words, then the tasks that contain those key words. Because the perl module makes it easy to create a new map, put nodes below other nodes, etc, other possibilities will probably suggest themselves.<br />
<br />
===To MS Project===<br />
An XSLT stylesheet to transform a FreeMind mindmap into a XML file that can be opened within MS Project as a project.<br />
<br />
'''>>> TESTED ONLY WITH "MS PROJECT 2003 e 2007"! <<<'''<br />
<br />
# Copy and paste this code using an editor such as notepad<br />
# Save the file with the XSLT extension<br />
# In pull-down menu use "File->Export->Using XSLT..." (Do not forget that you must export using the XML extension)<br />
<br />
<?xml version="1.0" encoding="iso-8859-1"?><br />
<br />
<!--<br />
Document : Freemind2MSProject.xsl<br />
Created on : 2 November 2007, 09:00PM<br />
Author : Mauro Alexandre<br />
Description: A XSLT stylesheet to transform a mindmap created with FreeMind<br />
(http://freemind.sf.net) into a XML file then can be opened within <br />
MS Project as a project.<br />
The idea is to create a WBS (Work Breakdown Structure) using FreeMind <br />
and then load this as a project.<br />
===> Tested only with MS Project 2003! <===<br />
Version : 1.0 <br />
--><br />
<br />
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"><br />
<xsl:output method="xml" version="1.0" indent="yes" /><br />
<br />
<xsl:template match="/"><br />
<Project xmlns="http://schemas.microsoft.com/project"><br />
<Name>Project1</Name><br />
<Author>Freemind2MSProject Conversor</Author><br />
<Tasks><br />
<Task><br />
<UID>0</UID><br />
<ID>0</ID><br />
<Type>1</Type><br />
<IsNull>0</IsNull><br />
<WBS>0</WBS><br />
<OutlineNumber>0</OutlineNumber><br />
<OutlineLevel>0</OutlineLevel><br />
<FixedCostAccrual>3</FixedCostAccrual><br />
<RemainingDuration>PT8H0M0S</RemainingDuration><br />
</Task><br />
<br />
<xsl:apply-templates select="map/node" /><br />
</Tasks><br />
</Project> <br />
</xsl:template><br />
<br />
<xsl:template match="node"><br />
<xsl:variable name="outlineLevel" select="(count(ancestor::node())-1)"/><br />
<br />
<Task><br />
<UID>1</UID><br />
<ID>1</ID><br />
<Name><xsl:value-of select="@TEXT"/></Name><br />
<Type>1</Type><br />
<IsNull>0</IsNull><br />
<OutlineNumber>1</OutlineNumber><br />
<OutlineLevel><xsl:value-of select="$outlineLevel"/></OutlineLevel><br />
<FixedCostAccrual>3</FixedCostAccrual><br />
<RemainingDuration>PT8H0M0S</RemainingDuration><br />
</Task><br />
<br />
<xsl:apply-templates select="node"/><br />
</xsl:template><br />
<br />
</xsl:stylesheet><br />
<br />
Regards,<br />
<br />
Mauro Alexandre<br />
<br />
PS (by lafs.info):<br />
I used the same code Mauro posted to covert .mm file into a MS Project file. I´m using MS Project 2007 in brazilian portuguese.<br />
I removed two spaces in all lines, before it the .xsl file didn´t work!<br />
<br />
<br />
PREVIOUS SOLUTION: [http://sourceforge.net/forum/message.php?msg_id=3098981 Posted from help forum]<br />
<br />
==3D Topicscape ↔ FreeMind==<br />
[http://en.wikipedia.org/wiki/3D_Topicscape 3D Topicscape] '''Pro''' and the '''Student Edition''' (SE is free as in beer) have built-in conversion to and from FreeMind ('''0.9.0''').<br />
<br />
If you make extensive use of FreeMind attributes for your own purposes, Topicscape won't know about them, and they will not be carried back again, but for a straightforward mindmap it seems to maintain integrity both ways. <br />
Topicscape can express structures that FreeMind can't (like multiple parents for one child and loose associations). The conversion translates these into color-coded curved lines with a single arrowhead and re-interprets this back to the multi-parent type of relationship on re-import.<br />
=== FreeMind to 3D Topicscape conversion ===<br />
This allows a 3D mindmap to be built from a 2D FreeMind mindmap.<br />
# File menu->Import <br />
# Radio button: Other products and select FreeMind (.mm) from the drop down<br />
# Radio button: Choose whether you want a new Topicscape to be built, or a floating topic in the currently-open Topicscape <br />
# Give the full file path to the FreeMind file, including the file's name - explicitly or by browsing to it. <br />
# Press OK <br />
# If you selected the new Topicscape radio button, you will then see the dialog that lets you choose the new Topicscape's name and where it is to be placed. Make the selections you want and press OK. After a pause, you will either see the new Topicscape as a 3D landscape, or perhaps a report about files in the FreeMind map that cannot be found at their expected locations. The report panel provides options for dealing with this and once handled, you're done. The hierarchy defined in the FreeMind mindmap will now be represented in 3D.<br />
# If you selected the floating topic radio button, you will next see the "Create New Topic" panel. Please name the topic. Use Hint if you wish to see if there is a similarly-named topic present in the Topicscape. Press Add. Drag the small red cone to its new parent, and drop it there. You're done. The 3D structure defined in the FreeMind mindmap will now be represented in 3D.<br />
<br />
NOTE: The above process will not be able to handle any user-defined attributes on the nodes.<br />
=== 3D Topicscape to FreeMind conversion ===<br />
This allows a FreeMind (0.9.0) mindmap to be built from a 3D Topicscape.<br />
# File menu->Export <br />
# Radio button: XML and select FreeMind (.mm) from the drop down (currently it's the only one).<br />
# Check boxes: Select which components to export. Topics at least must be exported (a topic will become a node). Occurrences will become attachments. Descriptions and Association details will become added attributes.<br />
# Give the full file path to where the FreeMind file is to be placed, including the file's name - explicitly or by browsing to it. The Topicscape's name is used as a default.<br />
# Press OK. A panel shows progress and completion will be announced.<br />
# If you used the color scheme in Topicscape that allows each topic to be assigned a color automatically, the colors will be transferred (approximately) to the FreeMind map.<br />
NOTE: The above process makes specific Topicscape attributes on the FreeMind nodes. To preserve the original Topicscape's integrity if you contemplate re-importing the mindmap to Topicscape, you need to avoid changing these atributes. The export may make double-headed gray lines and single-headed red lines. These are used to record multi-parent topics and loose associations. If you change them, then on any re-import to Topicscape, the structure will reflect those changes.<br />
=== 3D Topicscape ↔ FreeMind round-trip ===<br />
You can import to Topicscape and re-export to FreeMind - back and forth round trips are supported, provided you take into account the information in the NOTE paragraphs above.<br />
The Topicscape on-line manual has an entry about these conversions here:<br />
- http://www.topicscape.com/Topicscape-Pro/usersguide/help.php?page=132<br />
<br />
<br />
== Freemind to physically rearrange Folder and Files structure ==<br />
<br />
This presents a method to copy directory/files structure under windows with a structure defined as a Freemind map. It uses copy/paste from freemind to MSword then a Visual basic script.<br />
<br />
<br />
1- Import the existing directory/directories structure with freemind (File-> Import-> Folder Structure). Each final node has a link (ctrl+k) to the real file. It is preferable to set the preferences links path to absolute (Preferences -> Appearence -> Links = absolute)<br />
<br />
2- Rearrange the file structure. The node description represents the name of the file and can be modified in order to rename the file or directory. The file then will be copied under the new name. It is important NOT to update the link of nodes as the are the only information in freemind about the real file location. To delete a file or directory, just delete it from the map and it will not be copied to the new file system.<br />
<br />
3- copy the branch/map to MSWord. I obtain a outlined and tabulated text like :<br />
<br />
My Music <file:/C:/Documents and Settings/xxx/My Documents/My Temp/Music/><br />
give it to me<br />
give it to me.mp3 <file:/C:/Documents and Settings/xxx/My Documents/My Temp/Music/give it to me.mp3><br />
<br />
4- add the following macro to the word document<br />
<br />
<br />
Sub freemind_exportFolder()<br />
'<br />
' exportFolder Macro<br />
' Macro recorded 11/24/2004 by fbanag<br />
'<br />
Dim current_depth As Long<br />
Dim previous_depth As Long<br />
Dim diff_depth As Long<br />
' Define the Root directory<br />
ChDir ActiveDocument.Path<br />
Selection.GoTo what:=wdGoToLine, which:=wdGoToFirst ' start from beginning<br />
<br />
unit_indent = 17.5 'to be updated for the .dot used<br />
previous_depth = -100<br />
<br />
Do<br />
Selection.EndOf unit:=wdParagraph, Extend:=wdExtend<br />
<br />
' Depth extraction, use the outline level<br />
current_indent = Selection.Paragraphs(1).LeftIndent<br />
current_depth = current_indent / unit_indent<br />
current_outline = Selection.Paragraphs(1).OutlineLevel<br />
<br />
' Update the unit_indent when outline is < 8<br />
If current_outline < 8 And current_outline > 1 Then<br />
unit_indent = current_indent / (current_outline - 1)<br />
End If<br />
<br />
<br />
' Calculate the change in depth<br />
diff_depth = current_depth - previous_depth<br />
<br />
' Update the directory level<br />
If diff_depth = 1 Then<br />
ChDir node_name<br />
Else<br />
Do While diff_depth < 0<br />
ChDir "./.."<br />
diff_depth = diff_depth + 1<br />
Loop<br />
End If<br />
previous_depth = current_depth<br />
<br />
'remove the last character of the selection<br />
Selection.MoveRight unit:=wdCharacter, Count:=-1, Extend:=wdExtend<br />
' define if is directory or file<br />
directory_node = 0<br />
If Selection.Text Like "*<file:*" Then 'include the path<br />
'check if directory<br />
If Selection.Text Like "*/>" Then<br />
directory_node = 1<br />
End If<br />
' extract the node name<br />
Selection.MoveEndUntil Cset:="<", Count:=wdBackward<br />
Selection.MoveRight unit:=wdCharacter, Count:=-2, Extend:=wdExtend<br />
<br />
Else<br />
directory_node = 1<br />
End If<br />
node_name = Selection.Text <br />
' check now if the selection is a file<br />
If directory_node = 0 Then<br />
' selectionne the path<br />
Selection.EndOf unit:=wdParagraph, Extend:=wdExtend<br />
With Selection.Find<br />
.Text = "<file:/"<br />
.Replacement.Text = ""<br />
.Forward = True<br />
.Wrap = wdFindAsk<br />
.Format = False<br />
.MatchCase = False<br />
.MatchWholeWord = False<br />
.MatchWildcards = False<br />
.MatchSoundsLike = False<br />
.MatchAllWordForms = False<br />
End With<br />
Selection.Find.Execute<br />
Selection.Collapse Direction:=wdCollapseEnd<br />
Selection.MoveEndUntil Cset:=">", Count:=wdForward<br />
filepath = Selection.Text<br />
<br />
' using the name written in the freeemind<br />
<br />
'FileCopy<br />
FileCopy filepath, node_name<br />
<br />
Else ' if not, then it is a directory<br />
asc_code = Asc(node_name)<br />
<br />
' Check no empty name<br />
If node_name Like "o" Or node_name Like "" Then<br />
node_name = "NewFolder"<br />
End If<br />
<br />
<br />
' create a directory<br />
' doesn't handle the duplicate folder names at the same level and the end of file<br />
' I will have to add that (a day)<br />
If Asc(node_name) <> 13 Then<br />
MkDir node_name<br />
End If<br />
End If<br />
<br />
Loop While Selection.MoveDown(unit:=wdParagraph, Count:=1)<br />
End Sub<br />
<br />
5 - place the word file in the new root directory where You want files to be copied (don't forget to save the word document)<br />
<br />
6 - run the macro<br />
<br />
Known issues : <br />
- the script stops with an error message if there is special characters in the file name or path<br />
- the script stops if exists two files with the same name under the same directory<br />
<br />
This method and script has plenty of room for improvement, but it has been good enough for my task of reorganizing hundred of files (result of years of filling up several hard drives). It is a task I would not even have started without the existence of freemind.<br />
Thank You to the Freemind team.</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Documentation&diff=6907
Documentation
2008-06-10T11:32:48Z
<p>Ewl: /* Tutorials */ Added video link</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
==Application help as mind map==<br />
<br />
FreeMind comes with the documentation in the form of mind map, available from application menu ''Help > Documentation''. The documentation is a succint description of FreeMind functions, rather than a mind mapping text book. <br />
You can also browse the documentation now <mm>[[:Freemind.mm|applet|in a Java applet browser]]</mm> (with around 700 KB that requires Java 1.4.2 or later) which gives you a proper FreeMind feeling. And you can <mm>[[:FreemindFlash.mm|flash|try a much smaller flash based FreeMind map viewer]]</mm>.<br />
<br />
==Application help as HTML help==<br />
<br />
Help similar to the one delivered as a mind map is available in a form similar to Windows help, to be found in application menu ''Help > Help''.<br />
<br />
==PDF documentation==<br />
<br />
[http://www.geocities.com/shaila_kishore/Freemind PDF documentation], nice to print and much more professional looking than the application help, has been written by ''Shailaja Kumar''. It features illustrations, hand-holding detailed instructions, and index.<br />
<br />
==Wiki==<br />
<br />
This wiki serves as documentation as well, above all with [[Asked Questions]] page. All the documentation pages for FreeMind users are listed under [[:Category:Documentation|Documentation]] category. To see the content of the category, click down below at this page into the Categories box.<br />
<br />
==Web on mind mapping==<br />
<br />
To find out about mind mapping, consider searching the web, or buying yourself a book on mind mapping. Some links follow.<br />
<br />
* [http://en.wikipedia.org/wiki/Mind_map Mind map] at Wikipedia<br />
<br />
==Tutorials==<br />
* [http://toncar.cz/Tutorials/MindMaps/getting_started_with_freemind.html Getting Started with Freemind]<br />
* [http://www.vimeo.com/amss/videos/ A serie of videos showing FreeMind's usage]<br />
<br />
==Printed books==<br />
<br />
===English=== <br />
<br />
* [http://www.amazon.com/gp/product/0452273226/qid=1148920602/sr=2-1/ref=pd_bbs_b_2_1/002-2747381-4796064?s=books&v=glance&n=283155The Mind Map Book : How to Use Radiant Thinking to Maximize Your Brain's Untapped Potential (Paperback)] by Tony Buzan, Barry Buzan at Amazon.com<br />
* [http://www.amazon.com/gp/product/042512780X/qid=1148920602/sr=2-2/ref=pd_bbs_b_2_2/002-2747381-4796064?s=books&v=glance&n=283155Mindmapping: Your Personal Guide to Exploring Creativity and Problem-Solving (Paperback)] by Joyce Wycoff at Amazon.com<br />
<br />
===German===<br />
<br />
There is a German book dedicated specifically to FreeMind.<br />
{| cellpadding="20" cellspacing="0" border="0"<br />
|http://bomots.de/freemind/freemind_cover.png<br />
| [http://bomots.de/freemind Helmut F. Reibold<br>Mindmapping mit FreeMind<br>bomots-Verlag<br>ca. 220 Seiten<br>erschienen 10.09.06]<br />
|}<br />
<br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Translation&diff=6797
Translation
2008-04-28T19:14:44Z
<p>Ewl: /* Getting the latest translations */ fix integration tag</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
How to contribute translations to FreeMind follows.<br />
<br />
==Step-by-step overview==<br />
<br />
# Get a SourceForge user.<br />
# Choose the editing tool if getting started.<br />
# Get the latest English translation.<br />
# Get the latest translation for your language.<br />
# Find and complete what is missing.<br />
# Set mnemonics in the translations.<br />
# Post to Translations tracker.<br />
# Register yourself as FreeMind translator if you prefer.<br />
<br />
==Getting a SourceForge user==<br />
<br />
To get a SourceForge user, visit [http://sourceforge.net/account/newuser_emailverify.php creation page], unless you already have a user. (You need a SourceForge user to post your translation to Translations tracker, as described below.)<br />
<br />
==Getting the latest translations==<br />
<br />
Look for a translation into your language present in the development [http://freemind.cvs.sourceforge.net/freemind/freemind/?pathrev=fm_060405_integration branch]. <br />
If such a translation is not present, take [http://freemind.cvs.sourceforge.net/freemind/freemind/Resources_en.properties?view=log the latest revision of Resources_en.properties].<br />
<br />
==Choosing the editing tool==<br />
<br />
Translation files can be edited using variety of tools.<br />
<br />
===Popeye===<br />
<br />
[http://popeye.sourceforge.net/ Popeye] <sup>[http://popeye.sourceforge.net/images/ScreenShot-0-4.jpg Screenshot] | [http://sourceforge.net/project/showfiles.php?group_id=136501 Download]</sup> can deal with several language property files at the same time, so you can contrast the original property file data with their translations. Also, the program can highlight all properties that do not have a translation set in one of the selected languages.<br />
<br />
: After a short test, I can recommend Popeye. No installation needed, works fine, looks good, and has a nice web.--[[User:Danielpolansky|Danielpolansky]] 03:26, 2 Jun 2007 (PDT)<br />
<br />
===Propedit===<br />
[http://propedit.sourceforge.jp/index_en.html Propedit]<sup>[http://propedit.sourceforge.jp/screenshot/eclipse/screenshot_eclipse_en.html Screenshot]</sup> can directly edit property files written in Unicode reference characters, thereby saving the time and effort of converting into Unicode through native2ascii. Its plugin is integrated with Eclipse and JBuilder. Files can be opened in the IDE and saved in Unicode. See also [http://sourceforge.jp/projects/propedit Propedit project page].<br />
<br />
===Plain text editor===<br />
<br />
A plain text editor is the tool of choice if you are well acquainted with them and prefer them. If so, you already probably have your favorite tool. If not, these tools include Microsoft Notepad, Notepad++, Vim, Emacs and a vast variety of other tools. <br />
<br />
Using plain text editor is more tricky in that the language translation files are using Java unicode notatiton, encoding a single non-latin character like <tt>\u4567</tt>, making the file less readable. A workaround is to convert the language file into UTF-8 encoding first, then edit it, and finally convert to Java notation again. The conversion is described in the following section. Once the text is in UTF-8 encoding, tools like Microsoft Notepad can be used, and the non-latin characters are shown as you would see them in a WYSIWYG editor. However, various plain text editors differ in their capability to show UTF-8 characters. Notepad on Windows XP is definitely able to do that.<br />
<br />
====Converting between Unicode notations====<br />
<br />
To convert a file in UTF-8 into <tt>\uXXXX</tt> Unicode escape notation, you may use [http://java.sun.com/j2se/1.3/docs/tooldocs/win32/native2ascii.html native2ascii] tool included with the Java SDK. Example of use (Resources_cs.properties.txt is before conversion):<br />
<br />
<small><!-- Better in CSS style sheet --><br />
<br />
cd C:\j2sdk1.4.2\bin><br />
native2ascii.exe -encoding UTF8 Resources_cs.properties.utf8.txt Resources_cs.properties<br />
<br />
</small><br />
<br />
Ideally, your file's name will be ''Resources_xx.properties'', where ''xx'' is the code of the language (e.g. en, de, dk etc.).<br />
<br />
To convert \uXXXX Unicode encoded file back to UTF-8, use a command similar to the following.<br />
<br />
<small><br />
<br />
cd C:\j2sdk1.4.2\bin><br />
native2ascii.exe '''-reverse''' -encoding UTF8 Resources_cs.properties Resources_cs.properties.utf8.txt<br />
<br />
</small><br />
<br />
==Setting mnemonics==<br />
<br />
For menu items, you can set mnemonics by putting "&" character before the letter of the mnemonic in the title of the menu item. For instance, "&Edit" means that the title of the menu will read "Edit" and its mnemonic will be "e". Mnemonic is a keyboard shortcut accessible in various ways; in Windows, either by pressing Alt + mnemonic, or by pressing F10, followed by the mnemonic. Mnemonics are there not only for the leading menus, but also for submenus and menu items.<br />
<br />
==Posting translations==<br />
<br />
[http://sourceforge.net/tracker/?atid=961129&group_id=7118 Send your translation to Translations tracker]. To be able to do it, you need a SourceForge user, which can be created at [http://sourceforge.net/account/registration/ Account Registration] page at SourceForge.<br />
<br />
==Registering yourself as FreeMind translator==<br />
<br />
If you are seriously planning to become a FreeMind translator, and want to receive ''Call for translations'' emails from us, please register yourself as translator by subscribing to ''TODO:the new mailing list''.<br />
<br />
==When to translate==<br />
<br />
We send a ''call for translation'' email after publishing the first release candidate of FreeMind, as at that point we can make sure that only few or possibly none new texts to translate will be added.<br />
<br />
A translator can still start creating and posting translations at any point of time, so he or she can distribute the workload in time.<br />
<br />
==Using new translation in FreeMind==<br />
<br />
# Write or [http://sourceforge.net/tracker/?atid=961129&group_id=7118 download] the <tt>Resources_xx.properties</tt> file.<br />
# Unpack the <tt>freemind.jar</tt> file with 7-Zip or similar into a temp folder.<br />
# Replace or add the <tt>Resources_xx.properties</tt> with the new one.<br />
# Repack the <tt>freemind.jar</tt> with the modified content of the temp folder.<br />
<br />
== Menu label checklist ==<br />
{| {{Table style}}<br />
! Menu Label Checklist || Poor || Good<br />
|-<br />
| In English, use capitalized labels || Move to root || Move to Root<br />
|-<br />
| Menu items leading to a dialog should end with ... . || Open <br> Close ... || Open... <br> Close<br />
|-<br />
| Do not repeat the verb already used in the menu heading || Export > Export to PNG <br> Insert > Insert Hyperlink || Export > As PNG <br> Insert > Hyperlink<br />
|}<br />
<br />
==State of translation==<br />
<br />
Currently, we have the following languages translated. The table below is out of date, mapping roughly the state at 0.8.0. It would be nice if the translators would update it. Up-to-date information of the state of translation can in any case be [http://freemind.cvs.sourceforge.net/freemind/freemind/?pathrev=fm_0_9_0_beta12 found in CVS] and in [http://sourceforge.net/tracker/?atid=961129&group_id=7118 Translations tracker].<br />
<br />
{| {{Table style}} width="600px"<br />
! colspan="7" | Already Translated Languages<br />
|-------------------------------------------------<br />
! | Language || Language || Short || If released || Translator || Reviewer || Capitalized Titles<br />
|-----------------------------------------------------------------<br />
| Czech || Česky || cs || not released || Radek Švarz || Daniel Polansky ||No<br />
|-----------------------------------------------------------------<br />
| Chinese || trad.chinese || zh|| [http://sourceforge.net/tracker/index.php?func=detail&aid=1179121&group_id=7118&atid=307118 released] || [http://java.fromtw.com william chen] || &nbsp; || &nbsp;<br />
|-----------------------------------------------------------------<br />
| Chinese || simp.chinese || zh_CN|| [http://sourceforge.net/tracker/index.php?func=detail&aid=1179573&group_id=7118&atid=307118 not released] || [http://java.fromtw.com william chen] || &nbsp; || &nbsp;<br />
|-----------------------------------------------------------------<br />
| Danish || Dansk || dk || released || || || <br />
|-----------------------------------------------------------------<br />
| Dutch || Nederlands || nl || [http://sourceforge.net/tracker/index.php?func=detail&aid=1157653&group_id=7118&atid=307118 released] || Koen Roggemans || ||No<br />
|-----------------------------------------------------------------<br />
| English || English || en || released || N/A || || Yes<br />
|-----------------------------------------------------------------<br />
| Finnish || Suomi || fi || not released || Matti Lassila || ||<br />
|-----------------------------------------------------------------<br />
| French || Francais || fr || released || || Rickenbroc ||<br />
|-----------------------------------------------------------------<br />
| German || Deutsch || de || released || Christian Foltin || ||<br />
|-----------------------------------------------------------------<br />
| Hungarian || || ? || not released || [http://documan.sourceforge.net/ documan] || ||<br />
|-----------------------------------------------------------------<br />
| Italian || Italiano || it || released || Bob Alexander || ||<br />
|-----------------------------------------------------------------<br />
| Japanese || Nihongo || ja || released || Kohichi Aoki || ||<br />
|-----------------------------------------------------------------<br />
| Korean || Hangeul || kr || [http://sourceforge.net/tracker/index.php?func=detail&aid=1236421&group_id=7118&atid=307118 released(rc5)] || Kim Jong Woo || ||<br />
|-----------------------------------------------------------------<br />
| Polish || Polski || pl || not released || Rafal Kraik || || No<br />
|-----------------------------------------------------------------<br />
| Portuguese || Português || pt || not released || Luis Ferreira || ||<br />
|-----------------------------------------------------------------<br />
| Brazilian Portuguese || Português brasileiro || pt_BR || not released || [http://sourceforge.net/sendmessage.php?touser=1492544 Rodrigo Rizzi Starr] || ||<br />
|-----------------------------------------------------------------<br />
| Russian || Pусский || ru || released || Dimitry Polivaev || ||<br />
|-----------------------------------------------------------------<br />
| Slovenian || || sl || released || Martin Srebotnjak - filmsi || || No?<br />
|-----------------------------------------------------------------<br />
| Spanish || Espanol || es || released || Hugo Gayosso || || Yes<br />
|-----------------------------------------------------------------<br />
| Turkish || Türkçe || tr || [https://sourceforge.net/tracker/download.php?group_id=7118&atid=307118&file_id=186544&aid=1530176 not released] || Uğur Çetin || || Yes<br />
|}<br />
<br />
==Feedback==<br />
<br />
Do you find this page difficult to understand? Are you missing some key information? [http://freemind.sourceforge.net/wiki/index.php?title=Talk:Translation&action=edit Tell us].<br />
<br />
[[Category:Development]]<br />
<br />
</table></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Licensing&diff=6745
Licensing
2008-03-24T12:56:14Z
<p>Ewl: /* Licensing of components */ add note on GPL-incompatible libraries</p>
<hr />
<div>FreeMind is licensed under GNU GPL V2+.<br />
<br />
== Licensing of components ==<br />
<br />
The use and distribution of libraries by FreeMind raises two issues:<br />
<br />
1. distribution of open-source libraries: depending on the license used, we would need to make the source code available. This could be done IMHO ([[User:Ewl|Eric L.]]) simply by putting a copy of the sources in SF's download section (without making those an integral part of our packages).<br />
<br />
2. usage of GPL-incompatible libraries: believing [http://www.gnu.org/licenses/gpl-faq.html#GPLIncompatibleLibs this FSF note], we can make sure that FreeMind can use GPL-incompatible libraries but we need to make it explicit in our copyright. I ([[User:Ewl|Eric L.]] 05:56, 24 Mar 2008 (PDT))suggest to ask the current and former copyright holder and add a note in each source file that there is an exception on GPL-incompatible libraries, and explicit this exception in the "license" file.<br />
<br />
{| {{Table style}}<br />
! Component<br />
! License<br />
! Link<br />
! Note<br />
|-<br />
| SimplyHTML<br />
| GPL<br />
|<br />
| Version of license?<br />
|-<br />
| Batik<br />
| Apache<br />
|<br />
| Problem?<br />
|-<br />
| NanoXML<br />
| zlib/libpng<br />
| [http://nanoxml.cyberelf.be/]<br />
|<br />
|-<br />
| JiBX<br />
| BSD, Apache<br />
| [http://jibx.sourceforge.net/]<br />
| Problem?<br />
|-<br />
| JavaHelp<br />
| GNU GPL V2<br />
| [http://javahelp.dev.java.net/]<br />
|<br />
|}<br />
<br />
==Projects bundling Java==<br />
{| {{Table style}}<br />
! Project<br />
! License<br />
! Link<br />
! Note<br />
|-<br />
| StopMojo<br />
| GPL plus a special statement giving blanket permission to link with non-free software. <br />
| [http://www.mondobeyondo.com/projects/stopmojo/]<br />
|<br />
|-<br />
| TIFFANY'S<br />
| GPL; not given at the web site; only at the SourceForge project page<br />
| [http://tiffanys.sourceforge.net/]<br />
|<br />
|}<br />
<br />
==Discussion threads==<br />
{| {{Table style}}<br />
! Thread<br />
! Channel<br />
! Started on<br />
! Note<br />
|-<br />
| [http://sourceforge.net/forum/forum.php?thread_id=1915005&forum_id=320014 Licensing problems] <br />
| Complaints from users<br />
| 15.1.2008<br />
| Contains open issues.<br />
|-<br />
| [http://sourceforge.net/mailarchive/message.php?msg_id=478D2675.3050707%40gmx.de Licensing problems]<br />
| freemind-developer<br />
| 15.1.2008<br />
| Possible open issues. <br />
|}<br />
<br />
==Offending files==<br />
At least at some point, some single files had a license incompatible with GNU GPL V2+. These were:<br />
{| {{Table style}}<br />
! File<br />
! Note<br />
|-<br />
| accessories/marktree.js<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|-<br />
| accessories/mm2oowriter.xsl<br />
| fixed by Chris (he's the author, he can this)<br />
|-<br />
| accessories/tohtml.xsl<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|-<br />
| accessories/toxhtml.xsl.<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|}<br />
<br />
; Note 1 : the files implicated seem to come from [http://marktree.sourceforge.net/mmtree.html mmTree] where the original Author keeps very similar versions under MIT license, which would be compatible with GPLv2+. [[User:Ewl|Eric L.]] 10:08, 22 Mar 2008 (PDT) &rArr; Asking the author [mailto:minurmin@cc.jyu.fi Miika Nurminen] for his OK to place the files in our CVS under MIT license as well (else we'll have to derive a new version from his files). [[User:Ewl|Eric L.]] Miika answered and is OK to have all files under MIT license, once it's properly modified in the CVS, we'll be fine.<br />
<br />
==Copyright notice in code==<br />
<br />
A source file may be viewed as a sum ''b'' + ''d<sub>1</sub>'' + ''d<sub>2</sub>'' + ... + ''d<sub>k</sub>'', where ''b'' is the basis, ''d<sub>i</sub>'' are deltas (or patches), and the plus operator is the operator of applying a patch. The basis and each delta have their own copyright holder and the year of copyright.<br />
<br />
If there is only one author and one year, then the copyright notice is simple.<br />
<br />
If there is only one author and more years, then the copyright notice may look like<br />
<br />
Copyright © 2003-2005 Big Author<br />
<br />
which is to be understood as<br />
<br />
<blockquote><br />
Some parts of the sum are copyrighted in 2003, some perhaps in 2004, and some certainly in 2005.<br />
</blockquote><br />
<br />
If there are more authors, then the copyright notice consists of more lines, like<br />
<br />
Copyright © 2003-2005 Big Author,<br />
Copyright © 2005 Captain,<br />
<br />
Not all changes are eligible for copyright. If a change is small, then it does not make sense to add a line to the copyright notice for it.<br />
<br />
Copyright notice is not required for copyright to hold. It makes claiming your right at court easier.<br />
<br />
The correctness of these instructions is not granted. They are subject to improvement as we see fit.<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 11:29, 3 Jun 2005 (PDT)<br />
<br />
==Where to ask==<br />
{| {{Table style}}<br />
! Place<br />
! Note<br />
|-<br />
| [http://www.gnu.org/ gnu.org]<br />
| <br />
|-<br />
| [http://groklaw.net/ groklaw.net]<br />
| [http://www.groklaw.net/staticpages/index.php?page=20050131065655645 GPL Resources]<br />
|}<br />
<br />
==See also==<br />
* [[Logotype license]]<br />
<br />
==Links==<br />
* [http://www.gnu.org/copyleft/gpl.html GNU General Public License] - gnu.org and the [http://www.gnu.org/licenses/license-list.html License compatibility list].<br />
* [http://www.gnu.org/licenses/rms-why-gplv3.html Why GPL V3] - gnu.org<br />
* [http://www.sun.com/software/opensource/java/faq.jsp Free and Open Source Java] - sun.com<br />
* [http://fedoraproject.org/wiki/Licensing#head-489bc5bbf14ecdb808316674e9fc465243cfa4f5 the Fedora licenses list] with GPL2 compatibility list.<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Licensing&diff=6728
Licensing
2008-03-24T12:43:01Z
<p>Ewl: /* Offending files */ add note about MIT licensing</p>
<hr />
<div>FreeMind is licensed under GNU GPL V2+.<br />
<br />
==Licensing of components==<br />
{| {{Table style}}<br />
! Component<br />
! License<br />
! Link<br />
! Note<br />
|-<br />
| SimplyHTML<br />
| GPL<br />
|<br />
| Version of license?<br />
|-<br />
| Batik<br />
| Apache<br />
|<br />
| Problem?<br />
|-<br />
| NanoXML<br />
| zlib/libpng<br />
| [http://nanoxml.cyberelf.be/]<br />
|<br />
|-<br />
| JiBX<br />
| BSD, Apache<br />
| [http://jibx.sourceforge.net/]<br />
| Problem?<br />
|-<br />
| JavaHelp<br />
| GNU GPL V2<br />
| [http://javahelp.dev.java.net/]<br />
|<br />
|}<br />
<br />
==Projects bundling Java==<br />
{| {{Table style}}<br />
! Project<br />
! License<br />
! Link<br />
! Note<br />
|-<br />
| StopMojo<br />
| GPL plus a special statement giving blanket permission to link with non-free software. <br />
| [http://www.mondobeyondo.com/projects/stopmojo/]<br />
|<br />
|-<br />
| TIFFANY'S<br />
| GPL; not given at the web site; only at the SourceForge project page<br />
| [http://tiffanys.sourceforge.net/]<br />
|<br />
|}<br />
<br />
==Discussion threads==<br />
{| {{Table style}}<br />
! Thread<br />
! Channel<br />
! Started on<br />
! Note<br />
|-<br />
| [http://sourceforge.net/forum/forum.php?thread_id=1915005&forum_id=320014 Licensing problems] <br />
| Complaints from users<br />
| 15.1.2008<br />
| Contains open issues.<br />
|-<br />
| [http://sourceforge.net/mailarchive/message.php?msg_id=478D2675.3050707%40gmx.de Licensing problems]<br />
| freemind-developer<br />
| 15.1.2008<br />
| Possible open issues. <br />
|}<br />
<br />
==Offending files==<br />
At least at some point, some single files had a license incompatible with GNU GPL V2+. These were:<br />
{| {{Table style}}<br />
! File<br />
! Note<br />
|-<br />
| accessories/marktree.js<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|-<br />
| accessories/mm2oowriter.xsl<br />
| fixed by Chris (he's the author, he can this)<br />
|-<br />
| accessories/tohtml.xsl<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|-<br />
| accessories/toxhtml.xsl.<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|}<br />
<br />
; Note 1 : the files implicated seem to come from [http://marktree.sourceforge.net/mmtree.html mmTree] where the original Author keeps very similar versions under MIT license, which would be compatible with GPLv2+. [[User:Ewl|Eric L.]] 10:08, 22 Mar 2008 (PDT) &rArr; Asking the author [mailto:minurmin@cc.jyu.fi Miika Nurminen] for his OK to place the files in our CVS under MIT license as well (else we'll have to derive a new version from his files). [[User:Ewl|Eric L.]] Miika answered and is OK to have all files under MIT license, once it's properly modified in the CVS, we'll be fine.<br />
<br />
==Copyright notice in code==<br />
<br />
A source file may be viewed as a sum ''b'' + ''d<sub>1</sub>'' + ''d<sub>2</sub>'' + ... + ''d<sub>k</sub>'', where ''b'' is the basis, ''d<sub>i</sub>'' are deltas (or patches), and the plus operator is the operator of applying a patch. The basis and each delta have their own copyright holder and the year of copyright.<br />
<br />
If there is only one author and one year, then the copyright notice is simple.<br />
<br />
If there is only one author and more years, then the copyright notice may look like<br />
<br />
Copyright © 2003-2005 Big Author<br />
<br />
which is to be understood as<br />
<br />
<blockquote><br />
Some parts of the sum are copyrighted in 2003, some perhaps in 2004, and some certainly in 2005.<br />
</blockquote><br />
<br />
If there are more authors, then the copyright notice consists of more lines, like<br />
<br />
Copyright © 2003-2005 Big Author,<br />
Copyright © 2005 Captain,<br />
<br />
Not all changes are eligible for copyright. If a change is small, then it does not make sense to add a line to the copyright notice for it.<br />
<br />
Copyright notice is not required for copyright to hold. It makes claiming your right at court easier.<br />
<br />
The correctness of these instructions is not granted. They are subject to improvement as we see fit.<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 11:29, 3 Jun 2005 (PDT)<br />
<br />
==Where to ask==<br />
{| {{Table style}}<br />
! Place<br />
! Note<br />
|-<br />
| [http://www.gnu.org/ gnu.org]<br />
| <br />
|-<br />
| [http://groklaw.net/ groklaw.net]<br />
| [http://www.groklaw.net/staticpages/index.php?page=20050131065655645 GPL Resources]<br />
|}<br />
<br />
==See also==<br />
* [[Logotype license]]<br />
<br />
==Links==<br />
* [http://www.gnu.org/copyleft/gpl.html GNU General Public License] - gnu.org and the [http://www.gnu.org/licenses/license-list.html License compatibility list].<br />
* [http://www.gnu.org/licenses/rms-why-gplv3.html Why GPL V3] - gnu.org<br />
* [http://www.sun.com/software/opensource/java/faq.jsp Free and Open Source Java] - sun.com<br />
* [http://fedoraproject.org/wiki/Licensing#head-489bc5bbf14ecdb808316674e9fc465243cfa4f5 the Fedora licenses list] with GPL2 compatibility list.<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Licensing&diff=6721
Licensing
2008-03-22T17:13:28Z
<p>Ewl: /* Links */ add compatibility lists</p>
<hr />
<div>FreeMind is licensed under GNU GPL V2+.<br />
<br />
==Licensing of components==<br />
{| {{Table style}}<br />
! Component<br />
! License<br />
! Link<br />
! Note<br />
|-<br />
| SimplyHTML<br />
| GPL<br />
|<br />
| Version of license?<br />
|-<br />
| Batik<br />
| Apache<br />
|<br />
| Problem?<br />
|-<br />
| NanoXML<br />
| zlib/libpng<br />
| [http://nanoxml.cyberelf.be/]<br />
|<br />
|-<br />
| JiBX<br />
| BSD, Apache<br />
| [http://jibx.sourceforge.net/]<br />
| Problem?<br />
|-<br />
| JavaHelp<br />
| GNU GPL V2<br />
| [http://javahelp.dev.java.net/]<br />
|<br />
|}<br />
<br />
==Projects bundling Java==<br />
{| {{Table style}}<br />
! Project<br />
! License<br />
! Link<br />
! Note<br />
|-<br />
| StopMojo<br />
| GPL plus a special statement giving blanket permission to link with non-free software. <br />
| [http://www.mondobeyondo.com/projects/stopmojo/]<br />
|<br />
|-<br />
| TIFFANY'S<br />
| GPL; not given at the web site; only at the SourceForge project page<br />
| [http://tiffanys.sourceforge.net/]<br />
|<br />
|}<br />
<br />
==Discussion threads==<br />
{| {{Table style}}<br />
! Thread<br />
! Channel<br />
! Started on<br />
! Note<br />
|-<br />
| [http://sourceforge.net/forum/forum.php?thread_id=1915005&forum_id=320014 Licensing problems] <br />
| Complaints from users<br />
| 15.1.2008<br />
| Contains open issues.<br />
|-<br />
| [http://sourceforge.net/mailarchive/message.php?msg_id=478D2675.3050707%40gmx.de Licensing problems]<br />
| freemind-developer<br />
| 15.1.2008<br />
| Possible open issues. <br />
|}<br />
<br />
==Offending files==<br />
At least at some point, some single files had a license incompatible with GNU GPL V2+. These were:<br />
{| {{Table style}}<br />
! File<br />
! Note<br />
|-<br />
| freemind/main/CommonsCodecBase64.java<br />
| Apache 2.0 license, incompatible with GPLv2+<br />
|-<br />
| accessories/marktree.js<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|-<br />
| accessories/mm2oowriter.xsl<br />
| fixed by Chris (he's the author, he can this)<br />
|-<br />
| accessories/tohtml.xsl<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|-<br />
| accessories/toxhtml.xsl.<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|}<br />
<br />
; Note 1 : the files implicated seem to come from [http://marktree.sourceforge.net/mmtree.html mmTree] where the original Author keeps very similar versions under MIT license, which would be compatible with GPLv2+. [[User:Ewl|Eric L.]] 10:08, 22 Mar 2008 (PDT) &rArr; Asking the author [mailto:minurmin@cc.jyu.fi Miika Nurminen] for his OK to place the files in our CVS under MIT license as well (else we'll have to derive a new version from his files).<br />
<br />
==Copyright notice in code==<br />
<br />
A source file may be viewed as a sum ''b'' + ''d<sub>1</sub>'' + ''d<sub>2</sub>'' + ... + ''d<sub>k</sub>'', where ''b'' is the basis, ''d<sub>i</sub>'' are deltas (or patches), and the plus operator is the operator of applying a patch. The basis and each delta have their own copyright holder and the year of copyright.<br />
<br />
If there is only one author and one year, then the copyright notice is simple.<br />
<br />
If there is only one author and more years, then the copyright notice may look like<br />
<br />
Copyright © 2003-2005 Big Author<br />
<br />
which is to be understood as<br />
<br />
<blockquote><br />
Some parts of the sum are copyrighted in 2003, some perhaps in 2004, and some certainly in 2005.<br />
</blockquote><br />
<br />
If there are more authors, then the copyright notice consists of more lines, like<br />
<br />
Copyright © 2003-2005 Big Author,<br />
Copyright © 2005 Captain,<br />
<br />
Not all changes are eligible for copyright. If a change is small, then it does not make sense to add a line to the copyright notice for it.<br />
<br />
Copyright notice is not required for copyright to hold. It makes claiming your right at court easier.<br />
<br />
The correctness of these instructions is not granted. They are subject to improvement as we see fit.<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 11:29, 3 Jun 2005 (PDT)<br />
<br />
==Where to ask==<br />
{| {{Table style}}<br />
! Place<br />
! Note<br />
|-<br />
| [http://www.gnu.org/ gnu.org]<br />
| <br />
|-<br />
| [http://groklaw.net/ groklaw.net]<br />
| [http://www.groklaw.net/staticpages/index.php?page=20050131065655645 GPL Resources]<br />
|}<br />
<br />
==See also==<br />
* [[Logotype license]]<br />
<br />
==Links==<br />
* [http://www.gnu.org/copyleft/gpl.html GNU General Public License] - gnu.org and the [http://www.gnu.org/licenses/license-list.html License compatibility list].<br />
* [http://www.gnu.org/licenses/rms-why-gplv3.html Why GPL V3] - gnu.org<br />
* [http://www.sun.com/software/opensource/java/faq.jsp Free and Open Source Java] - sun.com<br />
* [http://fedoraproject.org/wiki/Licensing#head-489bc5bbf14ecdb808316674e9fc465243cfa4f5 the Fedora licenses list] with GPL2 compatibility list.<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Licensing&diff=6720
Licensing
2008-03-22T17:08:07Z
<p>Ewl: /* Offending files */ adding comments + CommonsCodecBase64.java</p>
<hr />
<div>FreeMind is licensed under GNU GPL V2+.<br />
<br />
==Licensing of components==<br />
{| {{Table style}}<br />
! Component<br />
! License<br />
! Link<br />
! Note<br />
|-<br />
| SimplyHTML<br />
| GPL<br />
|<br />
| Version of license?<br />
|-<br />
| Batik<br />
| Apache<br />
|<br />
| Problem?<br />
|-<br />
| NanoXML<br />
| zlib/libpng<br />
| [http://nanoxml.cyberelf.be/]<br />
|<br />
|-<br />
| JiBX<br />
| BSD, Apache<br />
| [http://jibx.sourceforge.net/]<br />
| Problem?<br />
|-<br />
| JavaHelp<br />
| GNU GPL V2<br />
| [http://javahelp.dev.java.net/]<br />
|<br />
|}<br />
<br />
==Projects bundling Java==<br />
{| {{Table style}}<br />
! Project<br />
! License<br />
! Link<br />
! Note<br />
|-<br />
| StopMojo<br />
| GPL plus a special statement giving blanket permission to link with non-free software. <br />
| [http://www.mondobeyondo.com/projects/stopmojo/]<br />
|<br />
|-<br />
| TIFFANY'S<br />
| GPL; not given at the web site; only at the SourceForge project page<br />
| [http://tiffanys.sourceforge.net/]<br />
|<br />
|}<br />
<br />
==Discussion threads==<br />
{| {{Table style}}<br />
! Thread<br />
! Channel<br />
! Started on<br />
! Note<br />
|-<br />
| [http://sourceforge.net/forum/forum.php?thread_id=1915005&forum_id=320014 Licensing problems] <br />
| Complaints from users<br />
| 15.1.2008<br />
| Contains open issues.<br />
|-<br />
| [http://sourceforge.net/mailarchive/message.php?msg_id=478D2675.3050707%40gmx.de Licensing problems]<br />
| freemind-developer<br />
| 15.1.2008<br />
| Possible open issues. <br />
|}<br />
<br />
==Offending files==<br />
At least at some point, some single files had a license incompatible with GNU GPL V2+. These were:<br />
{| {{Table style}}<br />
! File<br />
! Note<br />
|-<br />
| freemind/main/CommonsCodecBase64.java<br />
| Apache 2.0 license, incompatible with GPLv2+<br />
|-<br />
| accessories/marktree.js<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|-<br />
| accessories/mm2oowriter.xsl<br />
| fixed by Chris (he's the author, he can this)<br />
|-<br />
| accessories/tohtml.xsl<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|-<br />
| accessories/toxhtml.xsl.<br />
| Mozilla Public License 1.1, incompatible with GPLv2+, see note 1<br />
|}<br />
<br />
; Note 1 : the files implicated seem to come from [http://marktree.sourceforge.net/mmtree.html mmTree] where the original Author keeps very similar versions under MIT license, which would be compatible with GPLv2+. [[User:Ewl|Eric L.]] 10:08, 22 Mar 2008 (PDT) &rArr; Asking the author [mailto:minurmin@cc.jyu.fi Miika Nurminen] for his OK to place the files in our CVS under MIT license as well (else we'll have to derive a new version from his files).<br />
<br />
==Copyright notice in code==<br />
<br />
A source file may be viewed as a sum ''b'' + ''d<sub>1</sub>'' + ''d<sub>2</sub>'' + ... + ''d<sub>k</sub>'', where ''b'' is the basis, ''d<sub>i</sub>'' are deltas (or patches), and the plus operator is the operator of applying a patch. The basis and each delta have their own copyright holder and the year of copyright.<br />
<br />
If there is only one author and one year, then the copyright notice is simple.<br />
<br />
If there is only one author and more years, then the copyright notice may look like<br />
<br />
Copyright © 2003-2005 Big Author<br />
<br />
which is to be understood as<br />
<br />
<blockquote><br />
Some parts of the sum are copyrighted in 2003, some perhaps in 2004, and some certainly in 2005.<br />
</blockquote><br />
<br />
If there are more authors, then the copyright notice consists of more lines, like<br />
<br />
Copyright © 2003-2005 Big Author,<br />
Copyright © 2005 Captain,<br />
<br />
Not all changes are eligible for copyright. If a change is small, then it does not make sense to add a line to the copyright notice for it.<br />
<br />
Copyright notice is not required for copyright to hold. It makes claiming your right at court easier.<br />
<br />
The correctness of these instructions is not granted. They are subject to improvement as we see fit.<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 11:29, 3 Jun 2005 (PDT)<br />
<br />
==Where to ask==<br />
{| {{Table style}}<br />
! Place<br />
! Note<br />
|-<br />
| [http://www.gnu.org/ gnu.org]<br />
| <br />
|-<br />
| [http://groklaw.net/ groklaw.net]<br />
| [http://www.groklaw.net/staticpages/index.php?page=20050131065655645 GPL Resources]<br />
|}<br />
<br />
==See also==<br />
* [[Logotype license]]<br />
<br />
==Links==<br />
* [http://www.gnu.org/copyleft/gpl.html GNU General Public License] - gnu.org<br />
* [http://www.gnu.org/licenses/rms-why-gplv3.html Why GPL V3] - gnu.org<br />
* [http://www.sun.com/software/opensource/java/faq.jsp Free and Open Source Java] - sun.com<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Getting_started_as_a_tester&diff=8474
Getting started as a tester
2008-03-21T16:20:13Z
<p>Ewl: /* Going further ''&lt;&lt;Proposal&gt;&gt;'' */ fix link</p>
<hr />
<div>==Getting started as a tester==<br />
<br />
FreeMind is a fairly large project with a very small development team. We need all the extra testing resources we can get, so if you want to help out, this is one of the best places to start.<br />
<br />
# Let us know that you want to help! Visit the [http://sourceforge.net/forum/forum.php?forum_id=22101 Open Discussion Forum] and tell us.<br />
# Download the latest beta release of the software [http://sourceforge.net/project/showfiles.php?group_id=7118 here].<br />
# Test! Do everything you can think of to break the application, or just use it the way you plan on using it, and let us know what fails.<br />
# When there's a bug, tell us; to learn how, see [[reporting bugs]], respecting the rules on [[Handling trackers]].<br />
# You'll find things that you want the software to do that it doesn't do. Those aren't necessarily bugs. You can ask for new features, [http://sourceforge.net/tracker/?group_id=7118&atid=357118 here].<br />
# If you are interested in helping with more advanced testing, by writing test scripts, please let us know in the [http://sourceforge.net/forum/forum.php?forum_id=22101 Open Discussion Forum] and someone will contact you about it.<br />
# Reap the rewards by having better software to work with.<br />
<br />
== Going further ''&lt;&lt;Proposal&gt;&gt;'' ==<br />
<br />
Once you've gained some maturity, you can help even more by going this path:<br />
<br />
# improve the [http://sourceforge.net/tracker/?atid=107118&group_id=7118&func=browse bugs reported] by "normal" users, making sure that they comply to the [[Handling trackers|rules]] and that they contain a clear way to reproduce the bug.<br />
# debug the bug and find out where the bug happens in the code, it helps the developers to fix it quickly.<br />
# suggest yourself the required corrections and transform the bug into a [http://sourceforge.net/tracker/?group_id=7118&atid=307118 patch] for the developers to integrate into the FreeMind code.<br />
# become yourself a [[Getting started as a developer|developer]]!<br />
<br />
In order to do the above tasks, you'll need additional rights that you should request from one of the Project Admins listed on [http://sourceforge.net/projects/freemind FreeMind's SF page].<br />
<br />
==See also==<br />
* [[Handling trackers]]<br />
* [[Reporting bugs]]<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Getting_started_as_a_tester&diff=6718
Getting started as a tester
2008-03-21T16:19:04Z
<p>Ewl: add going further section</p>
<hr />
<div>==Getting started as a tester==<br />
<br />
FreeMind is a fairly large project with a very small development team. We need all the extra testing resources we can get, so if you want to help out, this is one of the best places to start.<br />
<br />
# Let us know that you want to help! Visit the [http://sourceforge.net/forum/forum.php?forum_id=22101 Open Discussion Forum] and tell us.<br />
# Download the latest beta release of the software [http://sourceforge.net/project/showfiles.php?group_id=7118 here].<br />
# Test! Do everything you can think of to break the application, or just use it the way you plan on using it, and let us know what fails.<br />
# When there's a bug, tell us; to learn how, see [[reporting bugs]], respecting the rules on [[Handling trackers]].<br />
# You'll find things that you want the software to do that it doesn't do. Those aren't necessarily bugs. You can ask for new features, [http://sourceforge.net/tracker/?group_id=7118&atid=357118 here].<br />
# If you are interested in helping with more advanced testing, by writing test scripts, please let us know in the [http://sourceforge.net/forum/forum.php?forum_id=22101 Open Discussion Forum] and someone will contact you about it.<br />
# Reap the rewards by having better software to work with.<br />
<br />
== Going further ''&lt;&lt;Proposal&gt;&gt;'' ==<br />
<br />
Once you've gained some maturity, you can help even more by going this path:<br />
<br />
# improve the [http://sourceforge.net/tracker/?atid=107118&group_id=7118&func=browse bugs reported] by "normal" users, making sure that they comply to the [[Handling trackers|rules]] and that they contain a clear way to reproduce the bug.<br />
# debug the bug and find out where the bug happens in the code, it helps the developers to fix it quickly.<br />
# suggest yourself the required corrections and transform the bug into a [[http://sourceforge.net/tracker/?group_id=7118&atid=307118 patch]] for the developers to integrate into the FreeMind code.<br />
# become yourself a [[Getting started as a developer|developer]]!<br />
<br />
In order to do the above tasks, you'll need additional rights that you should request from one of the Project Admins listed on [http://sourceforge.net/projects/freemind FreeMind's SF page].<br />
<br />
==See also==<br />
* [[Handling trackers]]<br />
* [[Reporting bugs]]<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Handling_trackers&diff=7721
Handling trackers
2008-03-21T16:00:41Z
<p>Ewl: Add priority proposal</p>
<hr />
<div>==Closing feature requests and bugs==<br />
<br />
===Stable package===<br />
<br />
When a developer solves in CVS a feature request or a bug (both an ''issue'') relating to ''stable package'',<br />
: she should assign the issue to the group ''FreeMind 0.8.0 - Fixed in CVS'' leaving the issue ''Open'', given ''0.8.0'' is the stable package.<br />
<br />
When a final release containing the solution is out,<br />
: the issue should be assigned to the groups ''FreeMind 0.8.0'' and set to ''Closed''.<br />
<br />
===Unstable package===<br />
<br />
When an issue relating to ''unstable package'' is solved in CVS, it shall be closed only after the solution has been made available in another beta or RC release in unstable package. As soon as the issue is solved in CVS, it should be assigned the group ''FreeMind 0.9.0 - Fixed in CVS'', given ''0.9.0'' is the unstable package.<br />
<br />
==Groups in Bugs tracker==<br />
{| {{Table style}}<br />
! Group<br />
! Note<br />
|-<br />
| FreeMind 0.8.0<br />
|<br />
|-<br />
| FreeMind 0.8.0 - Fixed in CVS<br />
|<br />
|-<br />
| FreeMind 0.9.0<br />
|<br />
|-<br />
| FreeMind 0.9.0 - Fixed in CVS<br />
|<br />
|-<br />
| FreeMind 0.9.0 - Out of scope<br />
|<br />
|}<br />
<br />
==Categories in Bugs tracker==<br />
<br />
Categories allow us to assign per default bugs to a certain developer, as documented in the following table.<br />
<br />
; Note : the Sourceforge Tracker allows theoretically to assign automatically bugs with a certain category to a certain developer, but the feature seems slightly broken, so it's more secure to assign category ''and'' developer to a bug.<br />
<br />
{| {{Table style}}<br />
! Category<br />
! Owner ID<br />
! Note<br />
|-<br />
| Export / Import / XSLT || christianfoltin<br />
|-<br />
| Filter and Attributes || dpolivaev<br />
|-<br />
| Flash Online Viewer || juanpedro<br />
|-<br />
| Java Applet/Viewer || christianfoltin<br />
|-<br />
| Linux || ewl<br />
|-<br />
| Mac OS (X) || christianfoltin<br />
|-<br />
| Painting and Laying out || dpolivaev<br />
|-<br />
| Plug-ins || christianfoltin<br />
|-<br />
| Printing || christianfoltin<br />
|-<br />
| Rich Text Editor / SimplyHTML || dpolivaev<br />
|-<br />
| Saving & Loading || dpolivaev<br />
|-<br />
| Windows || dpolivaev<br />
|}<br />
<br />
== Priority ''&lt;&lt;Proposal&gt;&gt;'' ==<br />
<br />
The purpose of the priority is to make decision easier if a bug can remain open for a specific release or not, according to the following rules:<br />
<br />
* priority > 5 - the bug must be closed before the next FreeMind release<br />
* priority < 5 - the bug can remain open through a release cycle<br />
* priority = 5 - 5 is the default bug value and can't have a special meaning, hence the bug must be assessed<br />
<br />
Determining the priority works as follows:<br />
# determine the priority based on the type of the bug.<br />
# correct this priority based on the presence of a workaround and the number of users impacted.<br />
# if you get 5 as priority, use your judgment to correct up or down (could you live with this bug?)<br />
# after each FreeMind release, raise the priority by 1 (skipping 5).<br />
<br />
{| {{Table style}}<br />
! width="20%"|Type of bug<br />
! width="70%"|Explanation<br />
! width="10%"|Priority<br />
|-<br />
| Data loss || user can loose data due to the bug || 7<br />
|-<br />
| Availability || FreeMind itself or certain functions can't be used || 5<br />
|-<br />
| Reliability or Performance || FreeMind crashes or certain functions do not always work, or only with limited speed || 4<br />
|-<br />
| Feature bugs || certain features of a function can't be used or only in a limited way (such bugs can be suspect to be enhancement requests) || 3<br />
|}<br />
&nbsp;<br />
{| {{Table style}}<br />
! width="20%"|Workaround Presence<br />
! width="70%"|Explanation<br />
! width="10%"|Priority Correction<br />
|-<br />
| No workaround || || +1<br />
|-<br />
| Any workaround || || 0<br />
|-<br />
| Definitive workaround || A definitive workaround is one that you apply once and then you're protected ''forever'' against data loss; avoiding to do something wouldn't be definitive, changing a configuration parameter would be so, being able to repair a corrupted FreeMind file as well || -1<br />
|}<br />
&nbsp;<br />
{| {{Table style}}<br />
! width="20%"|Users impacted<br />
! width="70%"|Explanation<br />
! width="10%"|Priority Correction<br />
|-<br />
| All || All users on one or more platforms || +2<br />
|-<br />
| Many || Many users, due to a common configuration || +1<br />
|-<br />
| Few || Few users, having a slightly uncommon but meaningful setup || 0<br />
|-<br />
| Very few || Very few users, having a rather meaningless setup, possibly not worth being supported by FreeMind || -1<br />
|}<br />
<br />
==Links==<br />
<br />
* [http://sourceforge.net/tracker/?atid=107118&group_id=7118 Bug tracker]<br />
* [http://sourceforge.net/tracker/?group_id=7118&atid=357118 Feature request tracker]<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Handling_trackers&diff=6716
Handling trackers
2008-03-21T14:35:11Z
<p>Ewl: Added owners for each category</p>
<hr />
<div>==Closing feature requests and bugs==<br />
<br />
===Stable package===<br />
<br />
When a developer solves in CVS a feature request or a bug (both an ''issue'') relating to ''stable package'',<br />
: she should assign the issue to the group ''FreeMind 0.8.0 - Fixed in CVS'' leaving the issue ''Open'', given ''0.8.0'' is the stable package.<br />
<br />
When a final release containing the solution is out,<br />
: the issue should be assigned to the groups ''FreeMind 0.8.0'' and set to ''Closed''.<br />
<br />
===Unstable package===<br />
<br />
When an issue relating to ''unstable package'' is solved in CVS, it shall be closed only after the solution has been made available in another beta or RC release in unstable package. As soon as the issue is solved in CVS, it should be assigned the group ''FreeMind 0.9.0 - Fixed in CVS'', given ''0.9.0'' is the unstable package.<br />
<br />
==Groups in Bugs tracker==<br />
{| {{Table style}}<br />
! Group<br />
! Note<br />
|-<br />
| FreeMind 0.8.0<br />
|<br />
|-<br />
| FreeMind 0.8.0 - Fixed in CVS<br />
|<br />
|-<br />
| FreeMind 0.9.0<br />
|<br />
|-<br />
| FreeMind 0.9.0 - Fixed in CVS<br />
|<br />
|-<br />
| FreeMind 0.9.0 - Out of scope<br />
|<br />
|}<br />
<br />
==Categories in Bugs tracker==<br />
{| {{Table style}}<br />
! Category<br />
! Owner ID<br />
! Note<br />
|-<br />
| Export / Import / XSLT || christianfoltin<br />
|-<br />
| Filter and Attributes || dpolivaev<br />
|-<br />
| Flash Online Viewer || juanpedro<br />
|-<br />
| Java Applet/Viewer || christianfoltin<br />
|-<br />
| Linux || ewl<br />
|-<br />
| Mac OS (X) || christianfoltin<br />
|-<br />
| Painting and Laying out || dpolivaev<br />
|-<br />
| Plug-ins || christianfoltin<br />
|-<br />
| Printing || christianfoltin<br />
|-<br />
| Rich Text Editor / SimplyHTML || dpolivaev<br />
|-<br />
| Saving & Loading || dpolivaev<br />
|-<br />
| Windows || dpolivaev<br />
|}<br />
<br />
==Links==<br />
<br />
* [http://sourceforge.net/tracker/?atid=107118&group_id=7118 Bug tracker]<br />
* [http://sourceforge.net/tracker/?group_id=7118&atid=357118 Feature request tracker]<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6514
FreeMind on Linux
2008-02-09T21:21:42Z
<p>Ewl: /* Installation of FreeMind 0.8.1 under Fedora Core 8 */ cut&paste typo</p>
<hr />
<div>----<br />
<table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time and won't happen before release of FreeMind 0.9.0.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
===== Most easiest way =====<br />
<br />
Make sure that the [http://packages.debian.org/sun-java5-jre Java 5 JRE under Debian] resp. [http://packages.ubuntu.com/sun-java5-jre Java 5 JRE under Ubuntu] (FreeMind 0.8.0 doesn't support Java 6) is installed, using e.g. <tt>aptitude install sun-java5-jre</tt> (for Sarge, you will need to add first the backport repositories).<br />
<br />
You ''can'' make Java 5 the default JRE by using the command <tt>update-java-alternatives -s java-1.5.0-sun</tt>, but you [[##How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|don't need to]].<br />
<br />
===== For Debian versions older than Sarge, or if you need Java 1.4 =====<br />
<br />
As Java isn't really free or open, there ''was'' no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it, FreeMind appears under the "Office" sub-menu!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
; Note 3 : Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.10/add-applications/C/extra-repositories-adding.html add extra repositories].<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Installation of FreeMind 0.8.1 under SuSE 10.3 ====<br />
<br />
# Add software repositories using YaST:<br />
## Add URL http://eric.lavar.de/comp/linux/rpm/noarch (repomd.xml is not signed, ignore YaST complains)<br />
## Add community repository Main non-OSS (for Sun's Java)<br />
## Add Jpackage URL free, generic and version 1.6, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.6/generic/free (repomd.xml is not signed, ignore YaST complains)<br />
# Using YaST's software management, search for 'freemind' and install what you see and like.<br />
# Also using YaST's software management, make sure that java-1_5_0-sun or java-1_6_0-sun is installed (search for '-sun').<br />
# And make sure that [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|FreeMind uses the right Java]] (not gcj as per default).<br />
<br />
==== Installation of FreeMind 0.8.1 under Fedora Core 8 ====<br />
<br />
# Add software repositories using the Package Manager (aka pirut):<br />
## Add URL http://eric.lavar.de/comp/linux/rpm/noarch<br />
## Add Jpackage URL free, generic and version 1.6, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.6/generic/free<br />
## Add Jpackage URL non-free, generic and version 1.7, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.7/generic/non-free<br />
# Using the Package Manager, search for 'freemind' and install what you see and like (at this stage, FreeMind is installed and kind of work using IcedTea 1.7, we now assume that you want FreeMind to really properly work...).<br />
# Download the '''JDK''' (not the JRE!) RPM of Java 1.5 or 6 from Sun's website, install it, then install the corresponding java-1.5.0-sun-compat or java-1.6.0-sun-compat package.<br />
# And make sure that [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|FreeMind uses the right Java]] (not IcedTea 1.7 as per default).<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
JIf you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
===== straight-forward installation method =====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
NB: If you want to use beta 0.9: There are zip-Files available for 0.9, too.<br />
<br />
===== more subtile installation method =====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if you set <code>$FREEMIND_BASE_DIR</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind/freemindrc</code> like this:<br />
<br />
# path to the installation directory of FreeMind<br />
FREEMIND_BASE_DIR="/opt/FreeMind"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
On gentoo, the following command line fixes the issue:<br />
----<br />
locate libmawt.so|grep /opt/sun-j.*/lib/i386/.*libmawt.so|xargs sed -i 's/XINERAMA/FAKEEXTN/g'<br />
<br />
For 64-bit:<br />
<br />
locate libmawt.so|grep /opt/sun-j.*/lib/amd64/.*libmawt.so|xargs sed -i 's/XINERAMA/FAKEEXTN/g'<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6507
FreeMind on Linux
2008-02-09T21:21:04Z
<p>Ewl: /* The RPM installation */ add link to Java selection</p>
<hr />
<div>----<br />
<table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time and won't happen before release of FreeMind 0.9.0.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
===== Most easiest way =====<br />
<br />
Make sure that the [http://packages.debian.org/sun-java5-jre Java 5 JRE under Debian] resp. [http://packages.ubuntu.com/sun-java5-jre Java 5 JRE under Ubuntu] (FreeMind 0.8.0 doesn't support Java 6) is installed, using e.g. <tt>aptitude install sun-java5-jre</tt> (for Sarge, you will need to add first the backport repositories).<br />
<br />
You ''can'' make Java 5 the default JRE by using the command <tt>update-java-alternatives -s java-1.5.0-sun</tt>, but you [[##How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|don't need to]].<br />
<br />
===== For Debian versions older than Sarge, or if you need Java 1.4 =====<br />
<br />
As Java isn't really free or open, there ''was'' no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it, FreeMind appears under the "Office" sub-menu!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
; Note 3 : Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.10/add-applications/C/extra-repositories-adding.html add extra repositories].<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Installation of FreeMind 0.8.1 under SuSE 10.3 ====<br />
<br />
# Add software repositories using YaST:<br />
## Add URL http://eric.lavar.de/comp/linux/rpm/noarch (repomd.xml is not signed, ignore YaST complains)<br />
## Add community repository Main non-OSS (for Sun's Java)<br />
## Add Jpackage URL free, generic and version 1.6, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.6/generic/free (repomd.xml is not signed, ignore YaST complains)<br />
# Using YaST's software management, search for 'freemind' and install what you see and like.<br />
# Also using YaST's software management, make sure that java-1_5_0-sun or java-1_6_0-sun is installed (search for '-sun').<br />
# And make sure that [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|FreeMind uses the right Java]] (not gcj as per default).<br />
<br />
==== Installation of FreeMind 0.8.1 under Fedora Core 8 ====<br />
<br />
# Add software repositories using the Package Manager (aka pirut):<br />
## Add URL http://eric.lavar.de/comp/linux/rpm/noarch<br />
## Add Jpackage URL free, generic and version 1.6, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.6/generic/free<br />
## Add Jpackage URL non-free, generic and version 1.7, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.7/generic/non-free<br />
# Using YaST's software management, search for 'freemind' and install what you see and like (at this stage, FreeMind is installed and kind of work using IcedTea 1.7, we now assume that you want FreeMind to really properly work...).<br />
# Download the '''JDK''' (not the JRE!) RPM of Java 1.5 or 6 from Sun's website, install it, then install the corresponding java-1.5.0-sun-compat or java-1.6.0-sun-compat package.<br />
# And make sure that [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|FreeMind uses the right Java]] (not IcedTea 1.7 as per default).<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
JIf you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
===== straight-forward installation method =====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
NB: If you want to use beta 0.9: There are zip-Files available for 0.9, too.<br />
<br />
===== more subtile installation method =====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if you set <code>$FREEMIND_BASE_DIR</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind/freemindrc</code> like this:<br />
<br />
# path to the installation directory of FreeMind<br />
FREEMIND_BASE_DIR="/opt/FreeMind"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
On gentoo, the following command line fixes the issue:<br />
----<br />
locate libmawt.so|grep /opt/sun-j.*/lib/i386/.*libmawt.so|xargs sed -i 's/XINERAMA/FAKEEXTN/g'<br />
<br />
For 64-bit:<br />
<br />
locate libmawt.so|grep /opt/sun-j.*/lib/amd64/.*libmawt.so|xargs sed -i 's/XINERAMA/FAKEEXTN/g'<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6506
FreeMind on Linux
2008-02-09T21:18:13Z
<p>Ewl: /* The RPM installation */ Add Fedora 8</p>
<hr />
<div>----<br />
<table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time and won't happen before release of FreeMind 0.9.0.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
===== Most easiest way =====<br />
<br />
Make sure that the [http://packages.debian.org/sun-java5-jre Java 5 JRE under Debian] resp. [http://packages.ubuntu.com/sun-java5-jre Java 5 JRE under Ubuntu] (FreeMind 0.8.0 doesn't support Java 6) is installed, using e.g. <tt>aptitude install sun-java5-jre</tt> (for Sarge, you will need to add first the backport repositories).<br />
<br />
You ''can'' make Java 5 the default JRE by using the command <tt>update-java-alternatives -s java-1.5.0-sun</tt>, but you [[##How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|don't need to]].<br />
<br />
===== For Debian versions older than Sarge, or if you need Java 1.4 =====<br />
<br />
As Java isn't really free or open, there ''was'' no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it, FreeMind appears under the "Office" sub-menu!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
; Note 3 : Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.10/add-applications/C/extra-repositories-adding.html add extra repositories].<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Installation of FreeMind 0.8.1 under SuSE 10.3 ====<br />
<br />
# Add software repositories using YaST:<br />
## Add URL http://eric.lavar.de/comp/linux/rpm/noarch (repomd.xml is not signed, ignore YaST complains)<br />
## Add community repository Main non-OSS (for Sun's Java)<br />
## Add Jpackage URL free, generic and version 1.6, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.6/generic/free (repomd.xml is not signed, ignore YaST complains)<br />
# Using YaST's software management, search for 'freemind' and install what you see and like.<br />
# Also using YaST's software management, make sure that java-1_5_0-sun or java-1_6_0-sun is installed (search for '-sun').<br />
# And make sure that FreeMind uses the right Java (not gcj as per default).<br />
<br />
==== Installation of FreeMind 0.8.1 under Fedora Core 8 ====<br />
<br />
# Add software repositories using the Package Manager (aka pirut):<br />
## Add URL http://eric.lavar.de/comp/linux/rpm/noarch<br />
## Add Jpackage URL free, generic and version 1.6, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.6/generic/free<br />
## Add Jpackage URL non-free, generic and version 1.7, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.7/generic/non-free<br />
# Using YaST's software management, search for 'freemind' and install what you see and like (at this stage, FreeMind is installed and kind of work using IcedTea 1.7, we now assume that you want FreeMind to really properly work...).<br />
# Download the '''JDK''' (not the JRE!) RPM of Java 1.5 or 6 from Sun's website, install it, then install the corresponding java-1.5.0-sun-compat or java-1.6.0-sun-compat package.<br />
# And make sure that FreeMind uses the right Java (not IcedTea 1.7 as per default).<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
JIf you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
===== straight-forward installation method =====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
NB: If you want to use beta 0.9: There are zip-Files available for 0.9, too.<br />
<br />
===== more subtile installation method =====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if you set <code>$FREEMIND_BASE_DIR</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind/freemindrc</code> like this:<br />
<br />
# path to the installation directory of FreeMind<br />
FREEMIND_BASE_DIR="/opt/FreeMind"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
On gentoo, the following command line fixes the issue:<br />
----<br />
locate libmawt.so|grep /opt/sun-j.*/lib/i386/.*libmawt.so|xargs sed -i 's/XINERAMA/FAKEEXTN/g'<br />
<br />
For 64-bit:<br />
<br />
locate libmawt.so|grep /opt/sun-j.*/lib/amd64/.*libmawt.so|xargs sed -i 's/XINERAMA/FAKEEXTN/g'<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6494
FreeMind on Linux
2008-02-03T19:47:39Z
<p>Ewl: /* The RPM installation */ add SuSE 10.3 instructions</p>
<hr />
<div>----<br />
<table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time and won't happen before release of FreeMind 0.9.0.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
===== Most easiest way =====<br />
<br />
Make sure that the [http://packages.debian.org/sun-java5-jre Java 5 JRE under Debian] resp. [http://packages.ubuntu.com/sun-java5-jre Java 5 JRE under Ubuntu] (FreeMind 0.8.0 doesn't support Java 6) is installed, using e.g. <tt>aptitude install sun-java5-jre</tt> (for Sarge, you will need to add first the backport repositories).<br />
<br />
You ''can'' make Java 5 the default JRE by using the command <tt>update-java-alternatives -s java-1.5.0-sun</tt>, but you [[##How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|don't need to]].<br />
<br />
===== For Debian versions older than Sarge, or if you need Java 1.4 =====<br />
<br />
As Java isn't really free or open, there ''was'' no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it, FreeMind appears under the "Office" sub-menu!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
; Note 3 : Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.10/add-applications/C/extra-repositories-adding.html add extra repositories].<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
JIf you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
==== Installation under SuSE 10.3 (stub) ====<br />
<br />
Those are for now only my notes, this will only work once the RPM version 0.8.1 is released:<br />
<br />
# Add software repositories using YaST:<br />
## Add URL http://eric.lavar.de/comp/linux/rpm/noarch (repomd.xml not signed)<br />
## Add community repository Main non-OSS (for Sun's Java)<br />
## Add Jpackage URL free, generic and version 1.6, using the [http://jpackage.org/mirroring.php#mirrors list of JPackage mirrors], e.g.<br />
##* http://mirrors.dotsrc.org/jpackage/1.6/generic/free (repomd.xml not signed)<br />
# Using YaST's software management, search for 'freemind' and install what you see and like.<br />
# Also using YaST's software management, make sure that java-1_5_0-sun or java-1_6_0-sun is installed (search for '-sun').<br />
# And make sure that FreeMind uses the right Java (not gcj as per default).<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
===== straight-forward installation method =====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
===== more subtile installation method =====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if you set <code>$FREEMIND_BASE_DIR</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind/freemindrc</code> like this:<br />
<br />
# path to the installation directory of FreeMind<br />
FREEMIND_BASE_DIR="/opt/FreeMind"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
On gentoo, the following command line fixes the issue:<br />
----<br />
locate libmawt.so|grep /opt/sun-j.*/lib/i386/.*libmawt.so|xargs sed -i 's/XINERAMA/FAKEEXTN/g'<br />
<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6491
FreeMind on Linux
2008-02-03T15:55:27Z
<p>Ewl: /* On any UN*X kind of system (also Linux) */ correct headers' level and avoid script edit</p>
<hr />
<div>----<br />
<table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time and won't happen before release of FreeMind 0.9.0.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
===== Most easiest way =====<br />
<br />
Make sure that the [http://packages.debian.org/sun-java5-jre Java 5 JRE under Debian] resp. [http://packages.ubuntu.com/sun-java5-jre Java 5 JRE under Ubuntu] (FreeMind 0.8.0 doesn't support Java 6) is installed, using e.g. <tt>aptitude install sun-java5-jre</tt> (for Sarge, you will need to add first the backport repositories).<br />
<br />
You ''can'' make Java 5 the default JRE by using the command <tt>update-java-alternatives -s java-1.5.0-sun</tt>, but you [[##How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|don't need to]].<br />
<br />
===== For Debian versions older than Sarge, or if you need Java 1.4 =====<br />
<br />
As Java isn't really free or open, there ''was'' no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it, FreeMind appears under the "Office" sub-menu!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
; Note 3 : Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.10/add-applications/C/extra-repositories-adding.html add extra repositories].<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
===== straight-forward installation method =====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
===== more subtile installation method =====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if you set <code>$FREEMIND_BASE_DIR</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind/freemindrc</code> like this:<br />
<br />
# path to the installation directory of FreeMind<br />
FREEMIND_BASE_DIR="/opt/FreeMind"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
On gentoo, the following command line fixes the issue:<br />
----<br />
locate libmawt.so|grep /opt/sun-j.*/lib/i386/.*libmawt.so|xargs sed -i 's/XINERAMA/FAKEEXTN/g'<br />
<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6387
FreeMind on Linux
2008-01-13T12:40:08Z
<p>Ewl: Cleaned-up the java installation under Debian</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time and won't happen before release of FreeMind 0.9.0.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
===== Most easiest way =====<br />
<br />
Make sure that the [http://packages.debian.org/sun-java5-jre Java 5 JRE under Debian] resp. [http://packages.ubuntu.com/sun-java5-jre Java 5 JRE under Ubuntu] (FreeMind 0.8.0 doesn't support Java 6) is installed, using e.g. <tt>aptitude install sun-java5-jre</tt> (for Sarge, you will need to add first the backport repositories).<br />
<br />
You ''can'' make Java 5 the default JRE by using the command <tt>update-java-alternatives -s java-1.5.0-sun</tt>, but you [[##How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F|don't need to]].<br />
<br />
===== For Debian versions older than Sarge, or if you need Java 1.4 =====<br />
<br />
As Java isn't really free or open, there ''was'' no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it, FreeMind appears under the "Office" sub-menu!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
; Note 3 : Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.10/add-applications/C/extra-repositories-adding.html add extra repositories].<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if in <code>freemind.sh</code> you replace<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
by<br />
if [ ! -n "${freepath}" ]<br />
then<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
fi<br />
and then set <code>$freepath</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind.freemindrc</code> like this:<br />
# settings for freemind<br />
#<br />
# path to the installation of freemind<br />
freepath="/opt/freemind/"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Download&diff=6353
Download
2008-01-02T17:37:19Z
<p>Ewl: /* Linux */ add link to Linux wiki page</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<!--<br />
[http://freemind.sourceforge.net/wiki/index.php/Download#Download http://freemind.sourceforge.net/wiki/images/b/b2/Download_FreeMind_Button_180x60.png]<br />
--><br />
<br />
The latest stable release of FreeMind is 0.8.0. Instructions on downloading and installing that version are given below.<br />
<br />
<!--<br />
If you'd like to help us test the new version of FreeMind, Release 0.9.0 Beta 13, click on the button below:<br />
<br />
[http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=188772 http://freemind.sourceforge.net/wiki/images/5/59/Download_FreeMind_Button_090_Beta13_180x60.png]<br />
--><br />
==Installing FreeMind==<br />
<br />
FreeMind is written in Java, so it will run on almost any system, as long as that system has a Java runtime environment.<br />
<br />
In order to make things easier for you, we've prepared installers for the most common desktop environments: Windows, Linux and Macintosh OS X. These installers come in two sizes, a minimum install that gives you only the basic FreeMind package, and a maximum install, which includes plugins for Scalable Vector Graphics (SVG), Portable Document Format (PDF), reminders, and help files.<br />
<br />
===System requirements===<br />
<br />
*Java Runtime Environment 1.4 or 1.5; not 1.6 in version FreeMind 0.8.0.<br />
* You can find the latest version of Java [http://java.com/download/ on Sun's site].<br />
**NOTE: 0.8.0 has some bugs when run with Java 1.6, You can download the older version [http://java.sun.com/javase/downloads/index_jdk5.jsp Java Runtime Environment 5.0 Update 14] (you need the JRE, not the JDK). However, this link may not work, even after LogIn to sun.com.<br />
* About 13MB of Hard Disk space for the full version, including all the plug-ins.<br />
* At least 512MB of Memory. More memory is better, especially if you will be creating large mind maps.<br />
** Version 0.7.1 runs fine on as few as 128MB of Memory.<br />
<br />
==Step-by-step overview==<br />
<br />
# Install Java Runtime if you do not have it.<br />
# Choose FreeMind installation file by operating system.<br />
# Download the chosen installation file.<br />
# Install FreeMind.<br />
<br />
==Download==<br />
<br />
Choose among the following binaries of the current '''FreeMind 0.8.0''', depending on your operating system:<br />
<br />
<br />
===Microsoft Windows===<br />
* [http://prdownloads.sourceforge.net/freemind/FreeMind-Windows-Installer-0_8_0.exe?download Windows Installer] (smaller version without export to SVG, 3 MB)<br />
* [http://prdownloads.sourceforge.net/freemind/FreeMind-Windows-Installer-0_8_0-max.exe?download Windows Installer Max] (all-including version, 8 MB)<br />
<br />
===Mac OS X===<br />
* [http://prdownloads.sourceforge.net/freemind/Mac_OS_X_Freemind-0_8_0.dmg?download MAC OS X] (all-including version, 8 MB)<br />
<br />
===Linux===<br />
The installation procedure is [[FreeMind_on_Linux|described in length]] but, in a nutshell, download and install the following files:<br />
<br />
* [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831&release_id=355162 Debian Linux] (it is '''highly''' recommended to check first the [http://sourceforge.net/project/shownotes.php?release_id=355162 release notes])<br />
* [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830&release_id=355738 SuSE 9.x Linux] (and other RPM-based distros like Fedora and Mandriva) (see also [http://sourceforge.net/project/shownotes.php?release_id=355738 release notes])<br />
<br />
===Any operating system===<br />
* [http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download binaries for any operating system] (smaller version without export to SVG, 3 MB)<br />
* [http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download binaries for any operating system - max] (all-including version, 8 MB)<br />
<br />
==Getting older versions==<br />
<br />
You can also download older versions, see [http://sourceforge.net/project/showfiles.php?group_id=7118 all files for download].<br />
<br />
==Getting latest beta version==<br />
<br />
If you'd like to help us test the new version of FreeMind, Release 0.9.0 Beta 14, [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=188772 go get it].</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Download&diff=6347
Download
2008-01-02T17:33:57Z
<p>Ewl: /* System requirements */ add JRE vs. JDK warning</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<!--<br />
[http://freemind.sourceforge.net/wiki/index.php/Download#Download http://freemind.sourceforge.net/wiki/images/b/b2/Download_FreeMind_Button_180x60.png]<br />
--><br />
<br />
The latest stable release of FreeMind is 0.8.0. Instructions on downloading and installing that version are given below.<br />
<br />
<!--<br />
If you'd like to help us test the new version of FreeMind, Release 0.9.0 Beta 13, click on the button below:<br />
<br />
[http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=188772 http://freemind.sourceforge.net/wiki/images/5/59/Download_FreeMind_Button_090_Beta13_180x60.png]<br />
--><br />
==Installing FreeMind==<br />
<br />
FreeMind is written in Java, so it will run on almost any system, as long as that system has a Java runtime environment.<br />
<br />
In order to make things easier for you, we've prepared installers for the most common desktop environments: Windows, Linux and Macintosh OS X. These installers come in two sizes, a minimum install that gives you only the basic FreeMind package, and a maximum install, which includes plugins for Scalable Vector Graphics (SVG), Portable Document Format (PDF), reminders, and help files.<br />
<br />
===System requirements===<br />
<br />
*Java Runtime Environment 1.4 or 1.5; not 1.6 in version FreeMind 0.8.0.<br />
* You can find the latest version of Java [http://java.com/download/ on Sun's site].<br />
**NOTE: 0.8.0 has some bugs when run with Java 1.6, You can download the older version [http://java.sun.com/javase/downloads/index_jdk5.jsp Java Runtime Environment 5.0 Update 14] (you need the JRE, not the JDK). However, this link may not work, even after LogIn to sun.com.<br />
* About 13MB of Hard Disk space for the full version, including all the plug-ins.<br />
* At least 512MB of Memory. More memory is better, especially if you will be creating large mind maps.<br />
** Version 0.7.1 runs fine on as few as 128MB of Memory.<br />
<br />
==Step-by-step overview==<br />
<br />
# Install Java Runtime if you do not have it.<br />
# Choose FreeMind installation file by operating system.<br />
# Download the chosen installation file.<br />
# Install FreeMind.<br />
<br />
==Download==<br />
<br />
Choose among the following binaries of the current '''FreeMind 0.8.0''', depending on your operating system:<br />
<br />
<br />
===Microsoft Windows===<br />
* [http://prdownloads.sourceforge.net/freemind/FreeMind-Windows-Installer-0_8_0.exe?download Windows Installer] (smaller version without export to SVG, 3 MB)<br />
* [http://prdownloads.sourceforge.net/freemind/FreeMind-Windows-Installer-0_8_0-max.exe?download Windows Installer Max] (all-including version, 8 MB)<br />
<br />
===Mac OS X===<br />
* [http://prdownloads.sourceforge.net/freemind/Mac_OS_X_Freemind-0_8_0.dmg?download MAC OS X] (all-including version, 8 MB)<br />
<br />
===Linux===<br />
* [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831&release_id=355162 Debian Linux] (it is '''highly''' recommended to check first the [http://sourceforge.net/project/shownotes.php?release_id=355162 release notes])<br />
* [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830&release_id=355738 SuSE 9.x Linux] (and other RPM-based) (see also [http://sourceforge.net/project/shownotes.php?release_id=355738 release notes])<br />
<!--<br />
* [http://prdownloads.sourceforge.net/freemind/freemind-0.7.1-6notsuse.noarch.rpm?download Fedora Core Linux, FreeMind 0.7.1] (package for 0.8.0 not yet available)<br />
--><br />
===Any operating system===<br />
* [http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download binaries for any operating system] (smaller version without export to SVG, 3 MB)<br />
* [http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download binaries for any operating system - max] (all-including version, 8 MB)<br />
<br />
==Getting older versions==<br />
<br />
You can also download older versions, see [http://sourceforge.net/project/showfiles.php?group_id=7118 all files for download].<br />
<br />
==Getting latest beta version==<br />
<br />
If you'd like to help us test the new version of FreeMind, Release 0.9.0 Beta 14, [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=188772 go get it].</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Download&diff=6346
Download
2008-01-02T17:27:24Z
<p>Ewl: /* System requirements */ Java link was specific to Windows</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<!--<br />
[http://freemind.sourceforge.net/wiki/index.php/Download#Download http://freemind.sourceforge.net/wiki/images/b/b2/Download_FreeMind_Button_180x60.png]<br />
--><br />
<br />
The latest stable release of FreeMind is 0.8.0. Instructions on downloading and installing that version are given below.<br />
<br />
<!--<br />
If you'd like to help us test the new version of FreeMind, Release 0.9.0 Beta 13, click on the button below:<br />
<br />
[http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=188772 http://freemind.sourceforge.net/wiki/images/5/59/Download_FreeMind_Button_090_Beta13_180x60.png]<br />
--><br />
==Installing FreeMind==<br />
<br />
FreeMind is written in Java, so it will run on almost any system, as long as that system has a Java runtime environment.<br />
<br />
In order to make things easier for you, we've prepared installers for the most common desktop environments: Windows, Linux and Macintosh OS X. These installers come in two sizes, a minimum install that gives you only the basic FreeMind package, and a maximum install, which includes plugins for Scalable Vector Graphics (SVG), Portable Document Format (PDF), reminders, and help files.<br />
<br />
===System requirements===<br />
<br />
*Java Runtime Environment 1.4 or 1.5; not 1.6 in version FreeMind 0.8.0.<br />
* You can find the latest version of Java [http://java.com/download/ on Sun's site].<br />
**NOTE: 0.8.0 has some bugs when run with Java 1.6, You can download the older version [http://java.sun.com/javase/downloads/index_jdk5.jsp Java Runtime Environment 5.0 Update 14]. However, this link may not work, even after LogIn to sun.com.<br />
* About 13MB of Hard Disk space for the full version, including all the plug-ins.<br />
* At least 512MB of Memory. More memory is better, especially if you will be creating large mind maps.<br />
** Version 0.7.1 runs fine on as few as 128MB of Memory.<br />
<br />
==Step-by-step overview==<br />
<br />
# Install Java Runtime if you do not have it.<br />
# Choose FreeMind installation file by operating system.<br />
# Download the chosen installation file.<br />
# Install FreeMind.<br />
<br />
==Download==<br />
<br />
Choose among the following binaries of the current '''FreeMind 0.8.0''', depending on your operating system:<br />
<br />
<br />
===Microsoft Windows===<br />
* [http://prdownloads.sourceforge.net/freemind/FreeMind-Windows-Installer-0_8_0.exe?download Windows Installer] (smaller version without export to SVG, 3 MB)<br />
* [http://prdownloads.sourceforge.net/freemind/FreeMind-Windows-Installer-0_8_0-max.exe?download Windows Installer Max] (all-including version, 8 MB)<br />
<br />
===Mac OS X===<br />
* [http://prdownloads.sourceforge.net/freemind/Mac_OS_X_Freemind-0_8_0.dmg?download MAC OS X] (all-including version, 8 MB)<br />
<br />
===Linux===<br />
* [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831&release_id=355162 Debian Linux] (it is '''highly''' recommended to check first the [http://sourceforge.net/project/shownotes.php?release_id=355162 release notes])<br />
* [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830&release_id=355738 SuSE 9.x Linux] (and other RPM-based) (see also [http://sourceforge.net/project/shownotes.php?release_id=355738 release notes])<br />
<!--<br />
* [http://prdownloads.sourceforge.net/freemind/freemind-0.7.1-6notsuse.noarch.rpm?download Fedora Core Linux, FreeMind 0.7.1] (package for 0.8.0 not yet available)<br />
--><br />
===Any operating system===<br />
* [http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download binaries for any operating system] (smaller version without export to SVG, 3 MB)<br />
* [http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download binaries for any operating system - max] (all-including version, 8 MB)<br />
<br />
==Getting older versions==<br />
<br />
You can also download older versions, see [http://sourceforge.net/project/showfiles.php?group_id=7118 all files for download].<br />
<br />
==Getting latest beta version==<br />
<br />
If you'd like to help us test the new version of FreeMind, Release 0.9.0 Beta 14, [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=188772 go get it].</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6336
FreeMind on Linux
2007-12-28T10:02:45Z
<p>Ewl: /* Ubuntu & Kubuntu */ removed duplicate synaptic chapter (re-used help links!)</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it, FreeMind appears under the "Office" sub-menu!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
; Note 3 : Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.10/add-applications/C/extra-repositories-adding.html add extra repositories].<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if in <code>freemind.sh</code> you replace<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
by<br />
if [ ! -n "${freepath}" ]<br />
then<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
fi<br />
and then set <code>$freepath</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind.freemindrc</code> like this:<br />
# settings for freemind<br />
#<br />
# path to the installation of freemind<br />
freepath="/opt/freemind/"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6334
FreeMind on Linux
2007-12-28T09:57:38Z
<p>Ewl: /* Easiest method (tested under Gutsy Gibbon) */ added menu point</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it, FreeMind appears under the "Office" sub-menu!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== Synaptic =====<br />
<br />
If you prefer graphical user interfaces, you can also use Ubuntu's Synaptic Package Manager to install Java and FreeMind. Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.04/add-applications/C/extra-repositories-adding.html add extra repositories]. This repository should work for most users:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ unstable/<br />
<br />
Then open Synaptic and search for "freemind". Mark "freemind" and "freemind-browser" for install. Click on "Apply". Confirm that you want to install third party software. That's it. :-)<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if in <code>freemind.sh</code> you replace<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
by<br />
if [ ! -n "${freepath}" ]<br />
then<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
fi<br />
and then set <code>$freepath</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind.freemindrc</code> like this:<br />
# settings for freemind<br />
#<br />
# path to the installation of freemind<br />
freepath="/opt/freemind/"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6333
FreeMind on Linux
2007-12-28T09:52:08Z
<p>Ewl: /* Ubuntu & Kubuntu */ Added Synaptic & Gutsy Gibbon instructions.</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
===== Easiest method (tested under Gutsy Gibbon) =====<br />
<br />
In order to install FreeMind 0.8.0 (0.9.0.betaX is not yet packaged, check therefore [[#On_any_UN.2AX_kind_of_system_.28also_Linux.29|the UN*X installation method]]), start the Synaptic Package Manager (under the System menu), and then do the following:<br />
<br />
* Add the following repositories using the Menu <tt>Settings &rArr; Repositories</tt>:<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> unstable/</tt> ("Third Party Software" tab)<br />
** <tt>deb <nowiki>http://eric.lavar.de/comp/linux/debian/</nowiki> ubuntu/</tt> ("Third Party Software" tab)<br />
** The ''multiverse'' and ''universe'' repositories ("Ubuntu Software" tab)<br />
* "Reload" the package list using the corresponding icon.<br />
* mark the following packages for installation (or make sure they are already installed):<br />
** <tt>sun-java5-jre</tt> (FreeMind 0.8.0 doesn't work properly with Java 6).<br />
** <tt>freemind</tt><br />
** And, as you need them, <tt>freemind-plugins-help</tt>, <tt>freemind-plugins-svg</tt> and <tt>freemind-plugins-time</tt> (you might search for "freemind" and install everything you find...).<br />
* Apply the changes. That's it!<br />
<br />
; Note 1 : if you want to use the 'help' plugin, you'll need to download JavaHelp (http://java.sun.com/products/javahelp/) from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>. This is due to a former license issue, it'll be fixed in the future.<br />
<br />
; Note 2 : I've added the <tt>libbatik-java</tt> package under my personal <tt>ubuntu</tt> repository, be aware that (security) updates might not happen timely. It shouldn't bother anybody much, but just in case...<br />
<br />
===== Old instructions =====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== Synaptic =====<br />
<br />
If you prefer graphical user interfaces, you can also use Ubuntu's Synaptic Package Manager to install Java and FreeMind. Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.04/add-applications/C/extra-repositories-adding.html add extra repositories]. This repository should work for most users:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ unstable/<br />
<br />
Then open Synaptic and search for "freemind". Mark "freemind" and "freemind-browser" for install. Click on "Apply". Confirm that you want to install third party software. That's it. :-)<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if in <code>freemind.sh</code> you replace<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
by<br />
if [ ! -n "${freepath}" ]<br />
then<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
fi<br />
and then set <code>$freepath</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind.freemindrc</code> like this:<br />
# settings for freemind<br />
#<br />
# path to the installation of freemind<br />
freepath="/opt/freemind/"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6332
FreeMind on Linux
2007-12-28T09:06:27Z
<p>Ewl: Go back to complete and correct version</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== Synaptic =====<br />
<br />
If you prefer graphical user interfaces, you can also use Ubuntu's Synaptic Package Manager to install Java and FreeMind. Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.04/add-applications/C/extra-repositories-adding.html add extra repositories]. This repository should work for most users:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ unstable/<br />
<br />
Then open Synaptic and search for "freemind". Mark "freemind" and "freemind-browser" for install. Click on "Apply". Confirm that you want to install third party software. That's it. :-)<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if in <code>freemind.sh</code> you replace<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
by<br />
if [ ! -n "${freepath}" ]<br />
then<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
fi<br />
and then set <code>$freepath</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind.freemindrc</code> like this:<br />
# settings for freemind<br />
#<br />
# path to the installation of freemind<br />
freepath="/opt/freemind/"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Handling_trackers&diff=6021
Handling trackers
2007-10-26T19:20:36Z
<p>Ewl: Use real list...</p>
<hr />
<div>==Closing feature requests and bugs==<br />
<br />
For each release being developed, we create two groups: one "FreeMind X.Y.Z" and one "FreeMind X.Y.Z - Fixed in CVS". We then use the groups in the following manner:<br />
<br />
; Note : for sake of simplicity, we assume X.Y.Z is the version being currently developed, and A.B.C an older version of FreeMind.<br />
<br />
# items with no or with older group like "FreeMind A.B.C" can be checked by helpers with sufficient rights, and closed if issue doesn't appear anymore in the latest beta/RC of X.Y.Z, else group is changed to the current version "FreeMind X.Y.Z".<br />
# items with current version group "FreeMind X.Y.Z" can be fixed by a developer, then moved into group "FreeMind X.Y.Z - Fixed in CVS".<br />
# testers check items with group "FreeMind X.Y.Z - Fixed in CVS", and close if OK (after next release), else setup back to group "FreeMind X.Y.Z".<br />
<br />
-- [[User:Ewl|Eric L.]] 12:19, 26 Oct 2007 (PDT)<br />
<br />
==Links==<br />
<br />
* [http://sourceforge.net/tracker/?atid=107118&group_id=7118 Bug tracker]<br />
* [http://sourceforge.net/tracker/?group_id=7118&atid=357118 Feature request tracker]<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Handling_trackers&diff=6020
Handling trackers
2007-10-26T19:19:08Z
<p>Ewl: Adapt to decision taken 2007-10-26</p>
<hr />
<div>==Closing feature requests and bugs==<br />
<br />
For each release being developed, we create two groups: one "FreeMind X.Y.Z" and one "FreeMind X.Y.Z - Fixed in CVS". We then use the groups in the following manner:<br />
<br />
; Note : for sake of simplicity, we assume X.Y.Z is the version being currently developed, and A.B.C an older version of FreeMind.<br />
<br />
1. items with no or with older group like "FreeMind A.B.C" can be checked by <br />
helpers with sufficient rights, and closed if issue doesn't appear anymore in the latest beta/RC of X.Y.Z, else group is changed to the current version "FreeMind X.Y.Z".<br />
<br />
2. items with current version group "FreeMind X.Y.Z" can be fixed by a developer, then <br />
moved into group "FreeMind X.Y.Z - Fixed in CVS".<br />
<br />
3. testers check items with group "FreeMind X.Y.Z - Fixed in CVS", and close if OK (after <br />
next release), else setup back to group "FreeMind X.Y.Z".<br />
<br />
-- [[User:Ewl|Eric L.]] 12:19, 26 Oct 2007 (PDT)<br />
<br />
==Links==<br />
<br />
* [http://sourceforge.net/tracker/?atid=107118&group_id=7118 Bug tracker]<br />
* [http://sourceforge.net/tracker/?group_id=7118&atid=357118 Feature request tracker]<br />
<br />
[[Category:Development]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Talk:Handling_trackers&diff=6003
Talk:Handling trackers
2007-10-25T18:44:24Z
<p>Ewl: /* Response: at least consistent naming */</p>
<hr />
<div>==Using "pending" status for issues solved in CVS==<br />
<br />
Dimitry suggested we could use "pending" status of an item to mark issues solved in CVS. Currently all pending issues are automatically closed after 60 days, but this setting can be changed.<br />
<br />
# ''Con:'' It violates the definition of "pending" used by SourceForge[http://sourceforge.net/docman/display_doc.php?docid=24202&group_id=1#issue_status], according to which "pending" is a synonym to "author action needed", meaning that the author of the item should provide further information so that the team can solve the problem.<br />
# ''Pro:'' It enables developers to quickly filter issues solved in CVS from those not solved at all. SourceForge does not provide any other suitable state, the other ones being "open", "closed", "deleted".<br />
# ''Con:'' New users coming to see the trackers see only open items, not those pending, as I have just verified. Those using the stable version will thus post duplicate entries; presumably many of them will use the stable version.<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 03:16, 14 Jul 2007 (PDT)<br />
<br />
: Tracker system should first help the developers to manage issues so that the product quality can be insured. Easy filtering of solved and to-be-solved issues on the status is very important. That's why already solved issues should not remain "open". --[[User:DimitriPolivaev|DimitriPolivaev]] 03:31, 14 Jul 2007 (PDT)<br />
<br />
:: I have modified my original post above to emphasize your point of view. I understand your answer as saying that you value the pro of 2 more than the con 1 and con 3. I am not sure I share this preference. Finding a solution that has fewer cons would be better. Developers are not the only users of the tracker system, so their requirements should not be per default put above the requirements of those who post the issues, IMO. --[[User:Danielpolansky|Danielpolansky]] 03:49, 14 Jul 2007 (PDT)<br />
<br />
: We could also use status "closed" with resolution "fixed" which should be changed to "accepted" after when the release is published. --[[User:DimitriPolivaev|DimitriPolivaev]] 04:06, 14 Jul 2007 (PDT)<br />
<br />
:: That solves the con 1. What about the con 3? Anyway, setting to closed issues that are in some beta version, not with the last stable version, seems fine to me. Whoever downloaded one beta is probably willing to download another beta or RC. But these issues would be set to solved only after another beta or RC is published. All right?<br />
<br />
:: So the only items now in discussion are bugs and requests in the last stable version that have been solved in CVS. What about them? Setting them to closed would still cause that people would not see them in the tracker. --[[User:Danielpolansky|Danielpolansky]] 04:20, 14 Jul 2007 (PDT)<br />
<br />
::: Why not? Everyone can select an option to see the slosed items too. I think that the expected version with the bug fix should be mentioned in the detail field. If last published version is say 0.9.0 beta 9, but the issue is closed with relution "fixed" and the details informs that the bug fix is done in 0.9.0 beta 10 (11, 12...), there is no way to misunderstanding. The tracker should always reflect the real situation, so letting the issue "open" althaugh it has been fixed is less nice for me. --[[User:DimitriPolivaev|DimitriPolivaev]] 04:46, 14 Jul 2007 (PDT)<br />
<br />
==Tagging of issues==<br />
<br />
Issues - bug reports and feature requests - can be tagged in their title, by adding the tag surrounded by brackets to their title. For instance, bugs solved in CVS can be tagged with ''(SCVS)'', and highly requested features can be tagged with ''(HRF)''. The tags used by the FreeMind team can be documented here, resulting in having well-defined set of tags instead of confusion. <br />
<br />
*Pro: Tagging is flexible, unlike the use of categories and other attributes.<br />
*Pro: SF bug tracker provides only two generic attributes: group and category. Tagging makes more logical attributes possible.<br />
*Con: There is no way to restrict the tags used. (Eric, edited by Dan)<br />
*Con: Tagging is vulnerable to typos, like "SVCS" instead of "SCVS", and 'false friends', like "FreeMind'sCVS" containing "SCVS". (Eric, edited by Dan)<br />
*Con: Tagging uses up the title length, necessitating the shortening of the title in some cases.<br />
<br />
--[[User:Danielpolansky|Dan Polansky]] 02:13, 24 Oct 2007 (PDT)<br />
<br />
== Tagging of issues (counter-proposal based on groups) ==<br />
<br />
Trying to verify certain bugs, I had to fight with the fact that some <br />
were already fixed by Dimitry in CVS, and I had no mean to filter them <br />
out, effectively or at least visually.<br />
<br />
I think, would we use "groups", we could greatly improve things:<br />
<br />
1. items without group or with group "FreeMind 0.8.0" can be checked by <br />
me (or other helpers with sufficient rights), and closed if issue <br />
doesn't appear anymore in the latest beta, else group be changed to <br />
"FreeMind 0.9.0".<br />
<br />
Ray, are you able with your current rights to change the group of an <br />
item? If yes, you could help :-)<br />
<br />
2. items with group "FreeMind 0.9.0" can be fixed by a developer, then <br />
moved into group "Fixed_In_CVS" (yet to be created).<br />
<br />
3. testers check items with group "Fixed in CVS", and close if OK (after <br />
next release), else setup back to group "FreeMind 0.9.0".<br />
<br />
'''Pros and cons:'''<br />
<br />
* Con: Users entering the bug tracking system see per default the items in the group "FreeMind 0.9.0", filtering away the issues solved in CVS. That may easily lead to the creation of duplicate bug reports. --[[User:Danielpolansky|Dan Polansky]] 11:15, 25 Oct 2007 (PDT)<br />
<br />
[[User:Ewl|Ewl]] 04:43, 25 Oct 2007 (PDT)<br />
<br />
===Response: at least consistent naming===<br />
Okay, so I accept that you do not like the flexibility of tagging. Then please, create at least a set of groups that is named consistently. For instance:<br />
<br />
# V0.8.0<br />
# V0.9.0<br />
# V0.9.0 - Fixed in CVS<br />
<br />
or<br />
<br />
# FreeMind 0.8.0<br />
# FreeMind 0.9.0<br />
# FreeMind 0.9.0 - Fixed in CVS<br />
<br />
--[[User:Danielpolansky|Dan Polansky]] 10:53, 25 Oct 2007 (PDT)<br />
<br />
OK with me, only "con" I see is that we would have 2 groups per release. [[User:Ewl|Ewl]] 11:44, 25 Oct 2007 (PDT)</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Talk:Handling_trackers&diff=5994
Talk:Handling trackers
2007-10-25T11:43:23Z
<p>Ewl: add Tagging of issues (counter-proposal based on groups)</p>
<hr />
<div>==Using "pending" status for issues solved in CVS==<br />
<br />
Dimitry suggested we could use "pending" status of an item to mark issues solved in CVS. Currently all pending issues are automatically closed after 60 days, but this setting can be changed.<br />
<br />
# ''Con:'' It violates the definition of "pending" used by SourceForge[http://sourceforge.net/docman/display_doc.php?docid=24202&group_id=1#issue_status], according to which "pending" is a synonym to "author action needed", meaning that the author of the item should provide further information so that the team can solve the problem.<br />
# ''Pro:'' It enables developers to quickly filter issues solved in CVS from those not solved at all. SourceForge does not provide any other suitable state, the other ones being "open", "closed", "deleted".<br />
# ''Con:'' New users coming to see the trackers see only open items, not those pending, as I have just verified. Those using the stable version will thus post duplicate entries; presumably many of them will use the stable version.<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 03:16, 14 Jul 2007 (PDT)<br />
<br />
: Tracker system should first help the developers to manage issues so that the product quality can be insured. Easy filtering of solved and to-be-solved issues on the status is very important. That's why already solved issues should not remain "open". --[[User:DimitriPolivaev|DimitriPolivaev]] 03:31, 14 Jul 2007 (PDT)<br />
<br />
:: I have modified my original post above to emphasize your point of view. I understand your answer as saying that you value the pro of 2 more than the con 1 and con 3. I am not sure I share this preference. Finding a solution that has fewer cons would be better. Developers are not the only users of the tracker system, so their requirements should not be per default put above the requirements of those who post the issues, IMO. --[[User:Danielpolansky|Danielpolansky]] 03:49, 14 Jul 2007 (PDT)<br />
<br />
: We could also use status "closed" with resolution "fixed" which should be changed to "accepted" after when the release is published. --[[User:DimitriPolivaev|DimitriPolivaev]] 04:06, 14 Jul 2007 (PDT)<br />
<br />
:: That solves the con 1. What about the con 3? Anyway, setting to closed issues that are in some beta version, not with the last stable version, seems fine to me. Whoever downloaded one beta is probably willing to download another beta or RC. But these issues would be set to solved only after another beta or RC is published. All right?<br />
<br />
:: So the only items now in discussion are bugs and requests in the last stable version that have been solved in CVS. What about them? Setting them to closed would still cause that people would not see them in the tracker. --[[User:Danielpolansky|Danielpolansky]] 04:20, 14 Jul 2007 (PDT)<br />
<br />
::: Why not? Everyone can select an option to see the slosed items too. I think that the expected version with the bug fix should be mentioned in the detail field. If last published version is say 0.9.0 beta 9, but the issue is closed with relution "fixed" and the details informs that the bug fix is done in 0.9.0 beta 10 (11, 12...), there is no way to misunderstanding. The tracker should always reflect the real situation, so letting the issue "open" althaugh it has been fixed is less nice for me. --[[User:DimitriPolivaev|DimitriPolivaev]] 04:46, 14 Jul 2007 (PDT)<br />
<br />
==Tagging of issues==<br />
<br />
Issues - bug reports and feature requests - can be tagged in their title, by adding the tag surrounded by brackets to their title. For instance, bugs solved in CVS can be tagged with ''(SCVS)'', and highly requested features can be tagged with ''(HRF)''. The tags used by the FreeMind team can be documented here, resulting in having well-defined set of tags instead of confusion. <br />
<br />
*Pro: Tagging is flexible, unlike the use of categories and other attributes.<br />
; Eric : I see this also as a con: you don't have a mean to restrict the tags used, i.e. typos are always possible (e.g. SVCS instead of SCVS), as well as 'false friends' (e.g. FreeMind'sCVS contains SCVS).<br />
*Con: Tagging uses up the title length, necessitating the shortening of the title in some cases.<br />
<br />
--[[User:Danielpolansky|Dan Polansky]] 02:13, 24 Oct 2007 (PDT)<br />
<br />
== Tagging of issues (counter-proposal based on groups) ==<br />
<br />
Trying to verify certain bugs, I had to fight with the fact that some <br />
were already fixed by Dimitry in CVS, and I had no mean to filter them <br />
out, effectively or at least visually.<br />
<br />
I think, would we use "groups", we could greatly improve things:<br />
<br />
1. items without group or with group "FreeMind 0.8.0" can be checked by <br />
me (or other helpers with sufficient rights), and closed if issue <br />
doesn't appear anymore in the latest beta, else group be changed to <br />
"FreeMind 0.9.0".<br />
<br />
Ray, are you able with your current rights to change the group of an <br />
item? If yes, you could help :-)<br />
<br />
2. items with group "FreeMind 0.9.0" can be fixed by a developer, then <br />
moved into group "Fixed_In_CVS" (yet to be created).<br />
<br />
3. testers check items with group "Fixed in CVS", and close if OK (after <br />
next release), else setup back to group "FreeMind 0.9.0".<br />
<br />
; TBD : list pros and cons...<br />
<br />
[[User:Ewl|Ewl]] 04:43, 25 Oct 2007 (PDT)</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=6234
FreeMind on Linux
2007-10-22T20:47:25Z
<p>Ewl: /* Frequently and less frequently Asked Questions */ add xcb error</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== Synaptic =====<br />
<br />
If you prefer graphical user interfaces, you can also use Ubuntu's Synaptic Package Manager to install Java and FreeMind. Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.04/add-applications/C/extra-repositories-adding.html add extra repositories]. This repository should work for most users:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ unstable/<br />
<br />
Then open Synaptic and search for "freemind". Mark "freemind" and "freemind-browser" for install. Click on "Apply". Confirm that you want to install third party software. That's it. :-)<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if in <code>freemind.sh</code> you replace<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
by<br />
if [ ! -n "${freepath}" ]<br />
then<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
fi<br />
and then set <code>$freepath</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind.freemindrc</code> like this:<br />
# settings for freemind<br />
#<br />
# path to the installation of freemind<br />
freepath="/opt/freemind/"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== FreeMind aborts with an 'xcb_xlib' error ===<br />
<br />
When trying to start FreeMind, it aborts with an error as follows:<br />
<br />
java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.<br />
<br />
This is a [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6532373 known Java error] and one possible solution is to set the following environment variable:<br />
<br />
export LIBXCB_ALLOW_SLOPPY_LOCK=1<br />
<br />
(helps on SuSE 10.3)<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Asked_questions&diff=6076
Asked questions
2007-10-21T20:28:50Z
<p>Ewl: /* Using physical styles (or patterns) */ fix some things</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
Here we collect a list of asked questions and answers related to free mind mapping software FreeMind. Help if you can (see [[#To edit this FAQ|To edit this FAQ]]). If you're searching for an answer to your question, why don't you just press Ctrl + F in your browser?<br />
<br />
== Installation ==<br />
<br />
=== How do I download the Java Runtime Environment needed to run FreeMind. ===<br />
To download JRE for Windows, go to [http://java.sun.com/j2se/1.4.2/download.html Download on Sun],<br />
go to the section '''Download J2SE v 1.4. ...'''<br />
and now choose the column [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&amp;PartDetailId=j2re-1.4.2_03-oth-JPR&amp;SiteId=JSC&amp;TransactionId=noreg JRE], ''not SDK''. The installation file of JRE has approximately 15 MB.<br />
<br />
=== I start FreeMind but nothing happens ===<br />
First of all, we assume that you are working under Windows. Now, please start freemind.bat in the installation directory.<br />
You'll probably get:<br />
<br />
Exception in thread "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
<br />
at freemind.main.FreeMind.getLogger(FreeMind.java:643) <br />
at freemind.main.FreeMind.<init>(FreeMind.java:109) <br />
at freemind.main.FreeMind.main(FreeMind.java:647) <br />
<br />
The answer to this behaviour is that you've got Java1.3 or lower installed, and this version of java is found (try java -version on the commandline to verify this). <br />
Most likely, you've installed Oracle. <br />
Change JAVA_HOME and the PATH variables to point to your actual java (1.4 or 5.0). <br />
This can be done as follows: Goto Settings -> System -> search for Environment Variables and change or create the values accordingly.<br />
<br />
Another Reason Freemind won't start or will give you the effect of having the icon in the Windows taskbar but nothing else is when you install Freemind in a folder which start with a "!" (exclamation mark), just install it in a different folder. (see http://www.cogmios.nl/java-apps-like-eclipse-or-freemind-do-not-run-in-folders-starting-with-a-20070407.html<br />
)<br />
<br />
=== FreeMind cannot detect new version of Java. What can I do? ===<br />
Let us assume that you have installed a new<br />
version of Java, and still, FreeMind complains about having old version of Java. This may occur especially<br />
if you installed ''SDK'' rather than ''JRE''. ''SDK'' stands for ''standard development kit'' and contains much more<br />
than you need to run FreeMind; you only need runtime environment. It is important that the new version of<br />
java is in your ''path''. To check it out on Microsoft Windows, run command ``cmd" using Windows-key + R,<br />
followed by ``java -version". You should get something like<br />
<br />
java version "1.4.2_03"<br />
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_03-b02)<br />
Java HotSpot(TM) Client VM (build 1.4.2_03-b02, mixed mode)<br />
<br />
where the particular version number is not important as long as it is at least 1.4.0.<br />
<br />
Additionally, it may be helpful to start '''freemind.bat''' and see what messages come.<br />
<br />
'''NOTE:''' If you have an Oracle database product installed on your computer, check the Oracle Installer to see what version of Java was installed with the database. Versions of Oracle 8, 8i, and later install JRE 1.3.1 and modify the startup path for Windows to ensure the database can start using this JRE. This installation WILL cause FreeMind to report the older version of Java, even if you install the new version (the .ini file for Oracle points Windows to the JRE 1.3.1 directory, places that in memory, and causes the fault). You can modify the .ini file to point Oracle to the newer JRE. <br />
<br />
If you don't want to change the Oracle settings: just create a batch file in the FreeMind folder with the following entry "Path-to-your-new-java-runtimes-bin/java.exe -jar lib/freemind.jar" and use that to start freemind.<br />
<br />
=== Which Java virtual machines does FreeMind actually work with? ===<br />
<br />
FreeMind works with the virtual machines from Sun, from the version 1.4.0 and higher. FreeMind has been reported to run on the JDK 1.4.2 from Blackdown. FreeMind also works on Linux with Sun Microsystems 64bit JDK version 1.5.0.<br />
<br />
There is a known issue with official release 0.8.0 of Freemind and Java 6. Encrypted nodes will wipe out your map when trying to save it to disk. Stick to Java 5 (alias 1.5.x) [https://sourceforge.net/tracker/?func=detail&atid=107118&aid=1550792&group_id=7118 (see bug report)]<br />
<br />
=== What is a mirror? ===<br />
A mirror is one of the SourceForge sites from which you can download FreeMind. To download FreeMind, choose ''any'' mirror; you would prefer a mirror geographically closer to the place where you live. If you experience problems with one mirror, try another.<br />
<br />
=== I run 'freemind.bat' and get an error message ===<br />
If you get <br />
Exception in thraed "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
at freemind.main.FreeMind.getLogger<FreeMind.java:643>at<br />
freemind.main.FreeMind.<init<FreeMind.java:109> <br />
at freemind.main.FreeMind.main<FreeMind.java:647> <br />
then the Java Virtual Machine found on your system is of version 1.3 or below. Try <br />
java -version<br />
to verify this. This happens, when you install Oracle for instance. Please, make sure, that your latest Java Virtual Machine is found when you type "java -version" by deinstalling java1.3 for example.<br />
<br />
=== USB Portable FreeMind ===<br />
Just add the following Java option in the freemind.bat or freemind.sh and everything is contained on the USB stick:<br />
<br />
-Duser.home=.[\<subdirectory, if needed>]<br />
<br />
As an example see the new content of my BAT-file, which looks like:<br />
<br />
@echo off<br />
java -Duser.home=. -cp lib\freemind.jar;lib\commons-lang-2.0.jar;lib\forms-1.0.5.jar;lib\jibx\jibx-run.jar;lib\jibx\xpp3.jar;lib\bindings.jar freemind.main.FreeMindStarter<br />
<br />
This lets FM create and use the subfolder .freemind in the location of the freemind.bat.<br />
<br />
As we know, USB flash drives support only limited number of writes. It means that reliability of such device drops down as time advances. Freemind, by default, saves your open maps every minute to .freemind dir which is in this case on the flash drive. If you aren't too paranoid you can avoid this by setting autosave dir to tmp dir of your OS. Freemind will automatically delete autosaves on exit so your precious data won't be left on a host machine. Go to Tools->Preferences->Path to automatic saves and set it to 'default'. Freemind will understand this on Windows probably as c:\windows\temp, Linux - /tmp or /var/tmp.<br />
<br />
That's it and enjoy!<br />
<br />
== Using ==<br />
<br />
=== To add a new concept ===<br />
<br />
A new concept is referred to as a "node." Use the "Insert" key on PCs to add a new node. MAC users need to [[Asked Questions#To_set_a_different_key_for_new_child_node_on_Mac_computers | set a different key]]. Nodes are not limited to just concepts. They can also include sentences, paragraphs or even short articles.<br />
<br />
=== Is there an undo feature in FreeMind? ===<br />
Starting with FreeMind 0.8, there is an undo and redo feature.<br />
<br />
If you are using 0.7, then use the following tips to prevent data loss:<br />
<br />
* Use FreeMind's autosave-feature <br />
: This feature is enabled by default... auto saved files will be found in ~/.freemind/<br />
<br />
* Install a clipboard manager, which will make all elements, which you cut from FreeMind, available in its history. A freeware example of a clipboard manager for MS Windows is [http://www.yankee-clipper.net Yankee Clipper].<br />
<br />
=== How much memory do I need? === ''Keywords: RAM.''<br />
Experience shows that 64 MB is not sufficient, while 128 MB is already enough, provided that you do not run another Java application. Correct me if I'm wrong. I am using FreeMind on Windows 95 + 128 MB without any problems.<br />
<br />
Running FreeMind 0.8RC5 on Windows 95 with 64 MB and Java 1.4.0 is possible and the response time ''is'' in acceptable limits. -- [[User:Stefano|Stefano]] 02:01, 11 Jul 2005 (PDT)<br />
<br />
Running FreeMind 0.7.1 on Debian Linux and Java 1.4.2.03 (j2sdk1.4) with my Omnibook 800 laptop (78 MB RAM, P166) just fine. I haven't tried any big projects with it yet, but so far it's very responsive. --[[User:Nullman|Kyle]] 09:14, 30 Jan 2006 (PST)<br />
<br />
=== To move a node to the other side of root ===<br />
Drag the node onto root and you see one half of root getting gray. Move the node to the other half and <br />
this half gets gray. Just drop the node on the side you want to have it.<br />
As of version 0.9.0 you can also use Ctrl+left and Ctrl+right to move a node in the desired direction (not only to change the side with respect to root, try it out).<br />
<br />
=== To create a graphical link ===<br />
<br />
# Go to the source node. <br />
# Mark it with the mouse. <br />
# Press the left mouse button. <br />
# Hold this button. <br />
# Press Ctrl+Shift buttons. <br />
# Continue to hold all these buttons. <br />
# Go to the destination node. <br />
# Release the mouse button, first. <br />
# Then release the keyboard buttons. <br />
<br />
You have your link. Alternatively, drag'n drop holding right mouse button.<br />
<br />
=== To remove a graphical link ===<br />
<br />
# Right-Click on the curved arrow of the graphical link (Mac users, press Control and click to see the options menu)<br />
# Choose "Remove Arrow Link" from the pop-up menu<br />
<br />
(Left-clicking on a graphical link does nothing)<br />
<br />
=== To add user icons to FreeMind ===<br />
Currently, adding user [http://www.guiicons.com Icons] is not possible.<br />
BUT you can add an inline images to any node. Use the following code example:<br />
<nowiki><html><img src="http://www.stumbleupon.com/pics/me.jpg"></nowiki><br />
in a FreeMind node. This should also work with local files using "file://" instead of "http://".<br />
<br />
=== To open links in only one browser window, rather than several. ===<br />
To our knowledge this is not possible at the moment.<br />
<br />
'''Firefox''' allows this option. ''From the menu, select''<br />
1) Tools > '''Options''' > <br />
2) Click '''Advanced'''<br />
3) Toggle Tabbed Browsing<br />
4) Select to open links from other apps in<br />
...a new tab in the most recent window.<br />
<br />
<br />
'''A possible Work Around:''' There is a way to do this if you use the [http://www.mozilla.org/products/firefox/ Firefox browser] instead of Internet Explorer, provided you<br />
install the Firefox extension called ''Single Window'' (available from [http://update.mozilla.org/extensions/showlist.php?category=Tabbed%20Browsing here]). Using this extension, every time you click on an external web link on a mind map, it will open the relevant page in a new tab in an existing Firefox window, rather than a new browser window. I have found this to be a much easier way to navigate the pages opened. I have only tried this with mm files opened from the file system at the moment (ie not served from a web server in the browser applet).<br />
<br />
To '''open external web links in a new tabs''' in Firefox follow [http://texturizer.net/firefox/tips.html#beh_reuse this tip] (works both for Linux and Windows). You have to add a line in your user.js file and install [http://piro.sakura.ne.jp/xul/_tabextensions.html.en Tabbrowser extensions].<br />
<br />
=== Is it difficult to provide FreeMind with Java Webstart?=== Well, it's not that easy. Joerg Mueller succeeded in doing just that and has sent his source code to Daniel Polansky, who did not succeed in getting it running; he did not consider that a high priority. What is important is that Microsoft Windows users have a convenient installer, and the users of the other operating systems are already used to not so convenient methods; the installation is pretty straightforward anyway.<br />
<br />
=== To create PDF out of FreeMind's mind map ===<br />
To create pdf out of FreeMind's mind map, you've got several<br />
options.<br />
<br />
* Use File/Export/As PDF...<br />
<br />
* Create DocBook, then pdf. Use [http://hkrott.iicm.edu/docs/seminar/sem2002_mindmaps.tar.gz XSLT transformations sheets] from Christoph Rissner to convert FreeMind's mind map to Mind Manager's mind map, then to DocBook, and create pdf from that DocBook. You can read more on that on [http://hkrott.iicm.edu/veranstaltungen/seminar/abgeschlossen.html Abgeschlossene Arbeiten] &gt; Mind Maps.<br />
<br />
* Print to pdf using a pdf printer driver.<br />
** Use open source [http://sector7g.wurzel6.de/pdfcreator/index_en.htm PDFCreator]. It uses Ghostscript as its backend.<br />
<br />
* Print to pdf using Acrobat's Distiller. Provided that you have full version of Adobe Acrobat installed (not just reader), you can print to a pdf using the Distiller or Writer options in your printer list. Make sure you check the "fit to one page" option under File > Page Setup. Also, make sure you set antialias to all under edit > preferences. This will make it look crisper. The only downside to this option is that it doesn't do the icons very well.<br />
<br />
* First print to postscript, then convert to pdf.<br />
** In Linux, create postscript by printing to a file using a postscript printer, and convert the postscript file to pdf afterwards, by using the shell-command ps2pdf or using [http://www.cs.wisc.edu/~ghost/ Ghostscript].<br />
** In Windows, install any postscript color printer (Like AppleColor 600) to print to a file. When printing to that printer, choose a folder and a file that ends with .ps. Then, open that *.ps with [http://www.cs.wisc.edu/~ghost/gsview/index.htm gsview] and choose ''File/Convert to PDF'' (let the program choose it all). Then save the file with the same name, but ending with .pdf. That's all. You might need to read the help files to tune it all up (only once).<br />
<br />
* Export FreeMind's mind map to HTML, paste it into Microsoft Word, format it as you see fit, and convert it to pdf using the techniques decribed above.<br />
<br />
=== To convert mind maps between FreeMind and MindManager ===<br />
Click here: [[Import and export to other applications]]<br />
<br />
=== Who is the development team of FreeMind? ===<br />
<br />
Daniel Polansky: the director of FreeMind is Daniel Polansky, i.e. me. The<br />
label ``director" is not quite appropriate; ``parliament"<br />
would be better. I test new versions, give advice, sometimes<br />
act in the name of FreeMind, forbid versions to be released<br />
because of insufficient quality, and approve them when<br />
they're ready. Also, I set up barriers for new directions.<br />
<br />
The main actor on the scene is Christian Foltin. We use<br />
the label ``code master" to denote his role, and also<br />
``manager". He does most of the work and decides which<br />
code changes are acceptable what concerns the<br />
quality of code. He takes care of mergers. Also, he<br />
coordinates the developers.<br />
<br />
An important developer is Dimitri Polivaev.<br />
<br />
=== To have brainstorm-like mode similar to one found in MindManager.===<br />
Did you notice you can hit Enter and Shift-Enter to create sibling nodes?<br />
It is not exactly the behavior of brainstorm mode of MindManager, but still<br />
close to it.<br />
<br />
=== On what operating systems have people actually succeeded in running FreeMind?===<br />
<br />
* ''Microsoft Windows.'' Windows 95, Windows 98, Windows NT, Windows 2000, Windows XP (SP1 & SP2), Windows 2003 Server<br />
* ''Linux.'' Mandrake 9.2 and 10, RedHat Pro WS 3, Fedora Core 2, SuSE (8.2 using the RPM for 9.0, 9.0, 9.1, 9.2, 9.3, 10.0, 10.2), Ubuntu (Warty), Debian sarge, Debian sid, Slackware 9.1, Gentoo, Mepis 3.3.1, Mepis 3.4-2.rc1.<br />
* ''BSD.'' FreeBSD (5.2.1, 5.4, 6.1), Mac OS X (10.2.8, 10.3, 10.4.4, 10.4.8)<br />
* ''Other.'' OS/2, Solaris 9 and 10.<br />
''Keywords: platforms.''<br />
<br />
=== Is there a PDA-Version, e.g. for Palm or Pocket PC? ===<br />
On PDA, you can use [[FreeMindPDA]]. It uses cross-platform [http://www.superwaba.com SuperWaba] Open Source SDK. However, it does not use mind map view, but rather plain tree view; it is not a proper FreeMind version in that sense. See also [[Stuff#PDA|FreeMind and PDA]].<br />
<br />
=== How large maps can I edit with FreeMind? ===<br />
<br />
In principle, there are no built-in limits. Practically, the maximum reported size is 11 MB at a map with 22,000 nodes; after exporting to HTML and pasting to Microsoft Word, the very same content had 15.6 MB, with 1500 pages. For a better practical estimation, experimental tests are needed, as the maximum given so far is only a lower bound on practical limits.<br />
<br />
I've been appending daily notes to a single mind-map file continually for many months on a 3 GHz Pentium 4 with 2 GB RAM running windowsXP. The file has grown to about half a megabyte, 420K, and there is a noticable difference in Freemind's responsiveness dealing with it, but it still works for me.<br />
<br />
=== How can I keep FreeMind from opening the last file from the last session? ===<br />
One way is to disable the changing of the file "auto.properties" (which is in the same folder as [[user.properties]]). Be aware that the menu "Edit -> Preferences" will not change anything any more than!<br><br />
To do that go to the file auto.properties and delete everything behind "onStartIfNotSpecified=" in that line. Now set the file "auto.properties" to read-only.<br />
<br />
===To change the fill color on bubbles.===<br />
There's an icon for it at the main toolbar. Additionally,<br />
you can find it in the popup menu at Node > Style > Cloud color.<br />
<br />
===To remove a cloud===<br />
Press Ctrl+Shift+B to toggle clouds.<br />
<br />
=== To search in FreeMind === <br />
''Keywords: find.'' Press Ctrl + F. For finding next occurrence, press Ctrl + G. Searching is<br />
restricted to the descendants of the node selected when pressing Ctrl + F. The search is<br />
a breadth-first search, first finding occurrences in the nodes closer to the starting node.<br />
<br />
===To move nodes around=== To move them up and down, use ctrl + up and down arrows. To move them wherever you want, use drag'n drop with mouse. ''Keywords: move around, reorganize.''<br />
<br />
=== What does antialias mean in FreeMind preferences? ===<br />
<br />
To antialias means to make fonts or curves look smooth by drawing additional pixels with in-between color. See also wikipedia on [http://en.wikipedia.org/wiki/Antialiasing antialiasing].<br />
<br />
By default, FreeMind antialiases edges only. FreeMind can also antialias text, but with the current state of the technology, it does not look good enough. At least, new Java RE 1.5.0 has better antialiasing of text than Java RE 1.4.x. Also, it is possible to set the whole application to antialiasing, including the menus and editing box; by using the command line option <code>-Dswing.aatext=true</code> of Java 1.5.0. Unfortunately, this is not available if you're using FreeMind.exe to launch FreeMind.<br />
<br />
=== What kind of encryption is used? ===<br />
<br />
: ''See [[Encryption]].''<br />
<br />
=== Reminders don't work when I start a map. The PDF-Export is not present. What's happening? ===<br />
There, the plugins (not only the PDF/SVG one) appear only if you start FreeMind from the directory where it has been installed. Especially if you start FreeMind by double-clicking on a FreeMind file (.mm file), this is not the case. So, use your icon and choose open to open your file.<br />
<br />
== Customizing FreeMind ==<br />
<br />
=== How do I add a new keyboard shortcut ===<br />
To add a new keyboard shortcut, say for "Change node background color", open the file<br />
mindmap_menus.xml (in freemind.jar) and search for "background", say.<br />
<br />
You'll find<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Here, you add a new keyboard ref attribute like:<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor" key_ref="keystroke_node_background_color"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Open the file freemind.properties and add a line like<br />
<pre><br />
#<br />
keystroke_node_color = alt F<br />
keystroke_node_color_blend = alt B<br />
keystroke_edge_color = alt E<br />
keystroke_node_background_color=alt N<br />
</pre><br />
But you have to search for free keys...<br />
<br />
=== To set expert settings ===<br />
<br />
Most of expert settings are stored in the [[user.properties]] file.<br />
<br />
=== To use another browser ===<br />
<br />
If you want to use another browser, edit the [[user.properties]] file and change the following property according to your operation system: <br />
<br />
default_browser_command_windows_nt <br />
default_browser_command_windows_9x <br />
default_browser_command_mac <br />
default_browser_command_other_os <br />
<br />
You have to write something like<br />
<br />
default_browser_command_windows_nt = C:\Program Files\Internet Explorer\iexplore.exe "{0}"<br />
...<br />
<br />
=== To change language ===<br />
<br />
Lydia<br />
<br />
language= en<br />
<br />
language = de <br />
<br />
Don't forget to remove the # character. Restart FreeMind and you have changed the language to German. See also [[Development#To_translate_FreeMind_into_your_language|the list of available languages]].<br />
<br />
=== To set a different key for new child node on Mac computers ===<br />
<br />
NOTE: The latest version of Freemind now sets the "tab" key as the default key for inserting a new node on a mac. Unfortunately, this is not documented in an obvious place. If you right or control click on a node you see a menu that does tell you the Tab shortcut for creating a child node but this is easily missed.<br />
<br />
In a manner similar to changing the language, replace<br />
<br />
#keystroke_add_child = INSERT <br />
<br />
with<br />
<br />
keystroke_add_child = control shift ENTER<br />
<br />
in the file [[user.properties]]. Pay attention that you write the key code ENTER in capital letters. <br />
<br />
The command ("Apple") key can be referred to as "meta" in these keystroke sequences - in case you were wondering.<br />
<br />
=== There is no shortcut to insert a note. Why? ===<br />
There is no shortcut on purpose, as this action does not come with undo. <br />
<br />
If you want to have this shortcut, you can download the sources, patch NodeNote.xml such that it contains a key_stroke="alt N" in the first lines as here: <br />
<br />
<br />
<plugin_action <br />
documentation="%accessories/plugins/NodeNote.properties_documentation" <br />
name="%accessories/plugins/NodeNote.properties_name" <br />
base="freemind.extensions.NodeHookAdapter" <br />
'''key_stroke="alt N"''' <br />
icon_path="accessories/plugins/icons/knotes.png" <br />
label="accessories/plugins/NodeNote.properties" <br />
class_name="accessories.plugins.NodeNote" instanciation="Once"> <br />
<br />
<br />
compile and you are done. BUT REMEMBER: Pressing your key on a node, that already contains a note, makes this note to remove WITHOUT UNDO. <br />
<br />
At your own risk, Chris<br />
<br />
<br />
=== Using physical styles (or patterns) ===<br />
<br />
Physical styles and patterns are the same and can be compared to "styles" in a text writer: you define a set of styling attributes, give this set a name, and can then assign the style or pattern to different nodes in the same way.<br />
<br />
The patterns are defined in the file <tt>patterns.xml</tt> placed in the FreeMind user directory. In Windows, that file is <tt>C:\Documents and Settings\YourUserName\.freemind\patterns.xml</tt>; under Linux, it's <tt>~/.freemind/patterns.xml</tt>. The generic format of this file is the following:<br />
<br />
<?xml version="1.0" encoding="UTF-8"?><br />
<patterns><br />
<pattern name="Pattern1"><br />
[...pattern properties...]<br />
</pattern><br />
<pattern name="Pattern2"><br />
[...pattern properties...]<br />
</pattern><br />
[...more patterns...]<br />
</patterns><br />
<br />
As you can see from above, you need to give each pattern a unique name, and then you need to assign pattern properties. Each pattern property is of the form <tt><'''pattern_property_name''' value="'''property_value'''"/></tt>, or <tt><'''pattern_property_name'''/></tt>, and each property stands for a different format parameter. Where the property is listed without value attribute, the corresponding format is reset to its default value. The following property names are possible:<br />
<br />
* pattern_node_background_color<br />
* pattern_node_color<br />
* pattern_node_style<br />
* pattern_node_text<br />
* pattern_node_font_name<br />
* pattern_node_font_bold<br />
* pattern_node_font_italic<br />
* pattern_node_font_size<br />
* pattern_icon<br />
* pattern_edge_color<br />
* pattern_edge_style<br />
* pattern_edge_width<br />
* pattern_child<br />
<br />
==== Allowed values ====<br />
<br />
For colors, the format of the value is "#RRGGBB", where RR, GG, BB are the hexadecimal values of the red, green, blue components of a color, e.g. "#B3B95C".<br />
<br />
<code>pattern_icon</code> can take one of the following values:<br />
<br />
* help<br />
* messagebox_warning<br />
* idea<br />
* button_ok<br />
* button_cancel<br />
* full-1<br />
* full-2<br />
* full-3<br />
* full-4<br />
* full-5<br />
* full-6<br />
* full-7<br />
* back<br />
* forward<br />
* attach<br />
* ksmiletris<br />
* smily_bad<br />
* clanbomber<br />
* desktop_new<br />
* flag<br />
* gohome<br />
* kaddressbook<br />
* knotify<br />
* korn<br />
* Mail<br />
* password<br />
* pencil<br />
* stop<br />
* wizard<br />
* xmag<br />
* bell<br />
* bookmark<br />
* penguin<br />
* licq<br />
<br />
; TODO : Add more explanations about the possible values and exact impact for each property.<br />
<br />
==== Example(s) ====<br />
<br />
An example of a pattern is therefore:<br />
<br />
<pattern name="Blue with edges and icon"><br />
<pattern_node_background_color/><br />
<pattern_node_color value="#000099"/><br />
<pattern_node_style/><br />
<pattern_icon value="flag"/><br />
<pattern_edge_color value="#009999"/><br />
<pattern_edge_style/><br />
<pattern_edge_width value="4"/><br />
</pattern><br />
<br />
This information and more can be discovered by opening any .mm file in a text or XML editor. You can usually search for the text in an element to find the example of what you want to learn how to do.<br />
<br />
; Note : the complete list of pattern properties can be found in the source code, in the file <tt>freemind/freemind_actions.xsd</tt> (search for ''pattern_''), and the list of icons in the file <tt>freemind/modes/MindIcon.java</tt> (search for ''mAllIconNames.add'').<br />
<br />
== Mind maps on web pages with FreeMind's applet ==<br />
<br />
=== To get FreeMind's applet working. ===<br />
If you experience problems viewing a mind map published by someone else, the most common problem is that you have to use Java >= 1.4 in your browser. Check this using the "About plugins" section of your browser (or a similar place). If you have Java >= 1.4 installed and still experiencing problems check out Internet Explorer's settings by selecting Tools > Internet Options > Advanced > Java and make sure ``Use Java2" is enabled.<br />
<br />
=== To present your mind map on the web ===<br />
Use FreeMind's browser applet. The following [http://freemind.sourceforge.net/docs/Serving%20Freemind%20maps%20in%20a%20browser/index.html document] (thanks to Bob) explains what to do to have a complete testing environment for your applet. <br />
<br />
=== Quick Java Applet instructions if you are already a code wiz ===<br />
<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" ARCHIVE="freemindbrowser.jar" <br />
WIDTH="100%" HEIGHT="80%"><br />
<PARAM NAME="type" VALUE="application/x-java-applet;version=1.4"><br />
<PARAM NAME="scriptable" VALUE="false"><br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
<\!-- ^ this has no effect on my pc --><br />
<PARAM NAME="modes" VALUE="freemind.modes.browsemode.BrowseMode"><br />
<PARAM NAME="browsemode_initial_map" VALUE="http://www.osde.info/osde.mm"><br />
<\!-- ^ Put the FULL path to your map here --><br />
<param NAME="initial_mode" VALUE="Browse"><br />
<param NAME="selection_method" VALUE="selection_method_direct"><br />
</APPLET><br />
<br />
In some cases, it may be necessary to set the '''ARCHIVE''' property to also use the '''Full Path''' to the .jar file. In the above example, the initial '''APPLET''' element would appear as:<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" <br />
ARCHIVE="http://www.exmaple.com/freemindbrowser.jar" WIDTH="100%" HEIGHT="80%"><br />
<br />
The most recent version of above source and freemindbrowser.jar are contained in the freemindbrowser.zip-Archive, which you can get from [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=16120 the sourceforge-site].<br />
<br />
=== To view the toolbar automatically after the applet starts ===<br />
It is necessary to edit the html starter of the applet and change the corresponding property. That is, set<br />
toolbarVisible=true. More precisely, add a tag <br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
to freemindbrowser.html or whatever name you have changed the file to.<br />
<br />
=== Is there a list of names and values and functions of all params for the applet? ===<br />
No. Theoretically, all parameters found in user.properties can be used as parameters of the applet.<br />
<br />
<br />
=== Is it possible to change or edit the map through an applet? ===<br />
<br />
No. There is no applet for ''editing'' mind maps; only for viewing.<br />
<br />
=== My document isn't opened by the applet ===<br />
<br />
The URL of the document *must* end with .mm. If it doesn't the document opens in a new browser window. The trick I use is to append a dummy parameter like in this example:<br />
<br />
http://myserver/mypath/mydoc?e=.mm<br />
<br />
This trick is specially useful for dynamic documents. (this is an opinion only. Some people, like Garito, thinks in another way)<br />
<br />
===Java Applet for XHTML===<br />
<br />
The same Freemind Browser can be used but instead of using the 'applet' element, the 'object' element can be used instead. Using Shayne Steele's [http://ww2.cs.fsu.edu/~steele/XHTML/appletObject.html approach], the following code can be used for placing a file called Textbook.mm that is located in http://example.com/freemind/ (along with the freemindbrowser.jar file):<br />
<br />
&lt;!--[if !IE]--&gt;<br />
&lt;object classid="java:freemind.main.FreeMindApplet.class"<br />
type="application/x-java-applet"<br />
archive="http://example.com/freemind/freemindbrowser.jar"<br />
width="450" height="300"&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
&lt;object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"<br />
codebase="http://java.sun.com/update/1.5.0/jinstall-1_5_0-windows-i586.cab"<br />
height="300" width="450"&gt;<br />
&lt;param name="code" value="freemind.main.FreeMindApplet" /&gt;<br />
&lt;param name="archive" value="http://example.com/freemind/freemindbrowser.jar" /&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;strong&gt;<br />
This browser does not have a Java Plug-in.<br />
&lt;/strong&gt;<br />
&lt;br /&gt;<br />
&lt;a href="http://java.sun.com/products/plugin/downloads/index.html"&gt;<br />
Get the latest Java Plug-in here.<br />
&lt;/a&gt;<br />
&lt;/object&gt;<br />
&lt;!--[if !IE]&gt;--&gt;<br />
&lt;/object&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
<br />
It works and it is valid markup. If placing in an HTML file, use '&gt;' instead of ' /&gt;' for the param element ending.<br />
<br />
== Workarounds in FreeMind ==<br />
<br />
===FreeMind behaves strange or crashes. What can I do?===<br />
First try reinstalling both Java (mostly the latest version is best) and Freemind. Often this solves problems. <br />
One of the problems solved in this way was:<br />
<br />
'' ''My computer crashes, or more precisely locks, when I click on a link in FreeMind, using J2RE 1.4.2_03 on Windows 98. Reinstalling helped. In retrospect, I think what broke it was that I renamed the J2RE directory to something easier to write in the bat file path statement. Broke it. ''<br />
<br />
=== When I drag files into the FreeMind window, FreeMind just works very long or I get a mind map of the file system ===<br />
This is a bug which is a least present on FreeMind 7.2 beta and lower on Windows. I only know of a workaround for this: Go to the [[user.properties]] and delete ",freemind.modes.filemode.FileMode". This disables the file mode of FreeMind.<br />
<br />
=== Changing the key bindings in user.properties does not work ===<br />
It seems that capitalization IS important in the keybindings. I wrote "enter" and it didn't work. I changed it to "ENTER" and it worked!<br />
(FreeMind 7.2 beta)<br />
<br />
=== FreeMind fails to work with or to export big maps ===<br />
When FreeMind fails to work with big maps, you may do the following.<br />
<br />
Assign more memory to the Java virtual machine as a workaround by editing the launching script. Edit <code>freemind.bat</code> or <code>Freemind.sh</code> and add a <code>-Xmx''MEM''</code> parameter to the <code>java</code> command line at the end of the script, like <code>java -Xmx512m ...</code> for 512 megabytes maximum memory and <code>java -Xmx768m ...</code> for 768 megabytes maximum memory. Believing the manual of Java, the default is 64 MB and the maximum is slightly less than 2000 on an x86 processor, which should be enough.<br />
<br />
Beware that exporting may still take a while. For instance, it may take 11 minutes to export a mind map with 740 nodes to JPEG.<br />
<br />
=== Plugins not found when FreeMind 0.8 starts by double-clicking a FreeMind mind map ===<br />
<br />
The following Microsoft Windows laucher fixes the problem that plugins were not found when FreeMind was started by double-clicking a FreeMind mind map. Download the [http://sourceforge.net/tracker/index.php?func=detail&aid=1361629&group_id=7118&atid=307118 patch with fixed Windows launcher], and replace <tt>Freemind.exe</tt> found in <tt>C:\Program Files\FreeMind</tt> with the one found in the patch, given you are in Windows. Backing up the original <tt>Freemind.exe</tt> is advisable.<br />
<br />
== Using HTML in long nodes ==<br />
<br />
=== What HTML tags does FreeMind support? ===<br />
<br />
FreeMind supports basic HTML in its nodes. For HTML to take effect, a node must start<br />
with "&lt;html>". What HTML is supported depends on the Java virtual machine.<br />
Among others, users have reported the following uses:<br />
<br />
<nowiki><html><p style="background-color:yellow">the node text</p></nowiki><br />
<br />
=== To embed, or more precisely link, images into FreeMind. ===<br />
You can link images into FreeMind using context menu of a node, accesed using right click (on MAC OS X Panther use Control click). Or type the following:<br />
&lt;html&gt;&lt;img src=&quot;image.jpg&quot;&gt;&lt;/html&gt;<br />
where image.jpg is the reference to an image.<br />
<br />
=== To put the contents of a Microsoft Word document into FreeMind. ===<br />
<br />
* First paste the Word document into Microsoft FrontPage.<br />
* Delete the images afterwards as FreeMind does not support them.<br />
* Remove the &lt;head> ... &lt;/head> in the source text view in FrontPage.<br />
* But leave the &lt;html>! The node needs to start with that.<br />
* Replace &lt;body&gt; with &lt;body width=600&gt; or similar width specification.<br />
* Finally, paste the HTML text as a long node into FreeMind.<br />
<br />
=== To have tables in FreeMind ===<br />
If you have Microsoft Frontpage available, it is convenient to create and<br />
edit HTML content there and paste it to and from FreeMind. Beware that the html code has to start with<br />
''&lt;html&gt;''. This way, you can conveniently create tables using the drawing tools of Frontpage.<br />
You can create formatted text this way as well; in that case, beware to set ''&lt;body width=600&gt;''<br />
or similar. However, FreeMind does not interpret all HTML; especially, it does not interpret inline<br />
CSS styling so you have to use hard formatting instead.<br />
<br />
If you want the table borders to have a '''nice two dimensional look''' rather than bevelled, start<br />
the HTML as follows.<br />
<br />
<html><br />
<head><br />
<style> td { border-style: solid } table { border-style: solid } </style><br />
</head><br />
<br />
== Generating mind maps programmatically ==<br />
<br />
=== To insert a newline into a node ===<br />
<br />
Insert <code>&amp;#xa;</code> instead of plain newline. Example of a map with three newlines:<br />
<br />
<map version="0.7.1"><br />
<node TEXT="New Mindmap"><br />
<node TEXT="A&amp;#xa;B&amp;#xa;C&amp;#xa;D" POSITION="right"/><br />
</node><br />
</map><br />
<br />
=== To use unicode characters in the node text ===<br />
<br />
FreeMind understands and uses <code>&amp;#xnn;</code>, where nn is equivalent to the '''hexadecimal''' number representing the character. It '''does not''' understand <code>&amp;#nnn;</code>, where nnn is '''decimal''' number. An example of a map containing ''Areté'' follows.<br />
<br />
<map version="0.7.1"><br />
<node TEXT="Aret&amp;#xe9;"/><br />
</map><br />
<br />
== FreeMind on Microsoft Windows ==<br />
<br />
=== How do I install a test version of FreeMind? ===<br />
Just unzip the package to the folder "C:\Program Files\FreeMind". That completes the "installation".<br />
You can start it by running freemind.exe (or freemind.bat if the exe does not exist). You can find test versions [http://freemind.sourceforge.net/testversions/ here].<br />
<br />
=== FreeMind does not seem to be affected by the things I edit in the user.properties. Why? ===<br />
See [[user.properties]].<br />
<br />
=== FreeMind starts and reacts so slow. Why? How to resolve? ===<br />
This seems to be an effect of the connection between Java and MS DirectX. You can deactivate the usage of DirectX for Freemind by editing the Freemind.bat file in your FreeMind directory.<br />
<br />
Add the parameter<br />
<br />
-Dsun.java2d.noddraw=true <br />
<br />
before the final expression <tt>freemind.main.FreeMind</tt>.<br />
<br />
Of course, now you have to use Freemind.bat to start the program instead of executing Freemind.exe. Do not forget to update file associations as well: [[Windows File Associations]]<br />
<br />
=== To create a screenshot of FreeMind and paste it into Microsoft Word or Microsoft Powerpoint ===<br />
To take a screenshot of your whole windows screen into clipboard, press Ctrl + Print Screen. To take a screenshot<br />
of the active window only into clipboard, press Alt + Print Screen. Select your Word or Powerpoint document<br />
and press Ctrl + V. On German keyboard, the key PrintScreen has the label "Druck". However, such a screenshot<br />
also contains FreeMind's window frame, not just the map contents. In Microsoft Word and Microsoft Powerpoint, this<br />
can be solved by cropping the screenshot; the cropping tool can be found in Picture toolbar..<br />
<br />
===To export a map to Microsoft Powerpoint===<br />
There's no elegant way to export a map to PowerPoint. One option is to take a screenshot, and paste it into Powerpoint. PowerPoint supports graphic file insertion, so another option is upgrading to a more recent version of FreeMind that supports JPEG export.<br />
<br />
One another solution is by using a Flash plugin:<br />
* Insert a control "Shockwave Flash Object" with the Control toolbar (go to display/toolbar/customise if not available).<br />
* Activate the propeties window by double clicking on the rectangle of the object<br />
* Click on the custom "property"<br />
* On the new opened window set the "movie URL" to the full path of the plugin (i.e: c:\path\visorFreemind.swf)<br />
* Set the "base URL" to the name of your freemind file (i.e.: index.mm) <br />
* Start your diaporama and you will see the cross inside the rectangle replaced by your freemind map<br />
<br />
If not successfull with those explanation, you will find a more complete information at the following address: [http://www.flashgeek.com FlashGeek]<br />
<br />
===To export / import a map to Microsoft Project===<br />
Look at the section [http://freemind.sourceforge.net/wiki/index.php/Import_and_export_to_other_applications Import and export to other applications]<br />
<br />
== FreeMind on Mac OS X ==<br />
<br />
FreeMind is written in the Java language, which is great for development and deployment of cross-platform applications.<br />
Freemind uses the Swing graphical user interface toolkit, which can use different looks and feels in order to mimic visuals and behaviours proprietary to the target execution platforms.<br />
<br />
<br />
On Microsoft Windows OS, the application fits quite nicely with the rest of the environment, but on Apple MacOS-X, things are often not quite right. MacOS-X users usually have higher expectations when it comes to usability and UI consistency, so they might become frustrated by the lack of compliance to their user interface guidelines.<br />
<br />
<br />
Here are some tips to enhance the user experience when using MacOS-X:<br />
<br />
<br />
#Keyboard shortcuts<br />
#:The "Tao Of Mac" weblog posted a tip for replacing the "CTRL" key by the "COMMAND" (Apple) key:<br />
#:http://the.taoofmac.com/space/Applications/FreeMind<br />
#Look and feel<br />
#:"Quaqua" is a look and feel for Swing that emulates the Aqua user interface:<br />
#:http://www.randelshofer.ch/quaqua/download.html<br />
#Shift-click to select multiple nodes.<br />
<br />
== FreeMind on Linux and other UNIX-like systems ==<br />
<br />
Go to the specific page [[FreeMind on Linux]].<br />
<br />
== Misc ==<br />
<br />
=== Is FreeMind mind mapping software? ===<br />
<br />
The term '''mind mapping''' is related to british psychologist Tony Buzan. In Buzan's context, mind map is a tree with many colors, pictures and personal expression. '''FreeMind is not''' really '''mind mapping''' software '''in the sense of Tony Buzan''', nevertheless, one would say that FreeMind belongs to the class of so called '''mind mapping software'''.<br />
<br />
Some of members of that class come pretty close to Buzan. Have a look at the site of first class commercial mind mapping software [http://www.mindjet.com/ MindManager]. You may also want to see [http://www.mind-mapping.co.uk/mind-maps-examples.htm examples] of mind maps in Buzan's sense.<br />
<br />
=== To spell FreeMind correctly. === <br />
"FreeMind", with a capital M.<br />
<br />
=== Where can I find a quick reference list of default keyboard shortcuts for the Windows 0.7.1 version? ===<br />
Here is a list of shortcuts, grouped by function:<br />
<br />
File commands:<br />
New map - Ctrl+N<br />
Open map - Ctrl+O<br />
Save map - Ctrl+S<br />
Save as - Ctrl+A<br />
Print - Ctrl+P<br />
Close - Ctrl+W<br />
Quit - Ctrl+Q<br />
Previous map - Ctrl+LEFT<br />
Next Map - Ctrl+RIGHT<br />
Export file to HTML - Ctrl+E<br />
Export branch to HTML - Ctrl+H<br />
Export branch to new MM file - Alt+A<br />
Open first file in history - Ctrl+Shift+W<br />
<br />
Edit commands:<br />
Find - Ctrl+F<br />
Find next - Ctrl+G<br />
Cut - Ctrl+X<br />
Copy - Ctrl+C<br />
Copy single - Ctrl+Y<br />
Paste - Ctrl+V<br />
<br />
Mode commands:<br />
MindMap mode - Alt+1<br />
Browse mode - Alt+2 <br />
File mode - Alt+3<br />
<br />
Node formatting commands:<br />
Italicize - Ctrl+I<br />
Bold - Ctrl+B<br />
Cloud - Ctrl+Shift+B<br />
Change node color - Alt+C<br />
Blend node color - Alt+B<br />
Change node edge color - Alt+E<br />
Increase node font size - Ctrl+L<br />
decrease node font size - Ctrl+M<br />
Increase branch font size - Ctrl+Shift+L<br />
Decrease branch font size - Ctrl+Shift+M<br />
<br />
Node navigation commands:<br />
Go to root - ESCAPE<br />
Move up - UP<br />
Move down - DOWN<br />
Move left - LEFT<br />
Move right - RIGHT<br />
Follow link - Ctrl+ENTER<br />
Zoom out - Alt+UP<br />
Zoom in - Alt+DOWN<br />
<br />
New node commands:<br />
Add sibling node - ENTER<br />
Add child node - INSERT<br />
Add sibling before - Shift+ENTER<br />
<br />
Node editing commands:<br />
Edit selected node - F2<br />
Edit long node - Alt+ENTER<br />
Join nodes - Ctrl+J<br />
Toggle folded - SPACE<br />
Toggle children folded - Ctrl+SPACE<br />
Set link by filechooser - Ctrl+Shift+K<br />
Set link by text entry - Ctrl+K<br />
Set image by filechooser - Alt+K<br />
Move node up - Ctrl+UP<br />
Move node down - Ctrl+DOWN<br />
<br />
=== To suggest new enhancements of FreeMind ===<br />
''Keywords: additional features, additional functions.''<br />
At FreeMind's project page, you can [http://sourceforge.net/tracker/?group_id=7118&atid=357118 submit Requests for Enhancements (RFEs)].<br />
<br />
=== Is MindMaster a rip off of FreeMind? ===<br />
<br />
''Update: the site of MindMaster is no longer there, thanks to Rezzie.''<br />
<br />
There is a [http://www.gigastorm.com/mindmaster/ web site] offering a product called MindMaster. This program is a ripped off version of FreeMind. It is not just a clone of FreeMind; it ''is'' just FreeMind renamed, and slightly modified. They even use the presentation texts as found on the main page of FreeMind. As FreeMind is licenced under GNU GPL, so must be MindMaster. However, on the MindMaster site and after the installation, they claim that they hold copyright to MindMaster, and that you are prohibited to use MindMaster unless you conform to their licence. This is unlawful. We urge you not to use or recommend MindMaster, and to avoid linking to their site or giving any recommendation. Also, you can write an email to them complaining about abuse of GNU General Public Licence. --[[User:Danielpolansky|Danielpolansky]] 11:15, 14 May 2005 (PDT)<br />
<br />
: I have been in contact with the author of [http://www.gigastorm.com/mindmaster/ MindMaster] and he has since removed the website and all links to the download. He did in fact claim it was released under the GPL and included both the licence and source code in the package, but as I didn't want to shell out $30 I cannot verify this. --[[User:Rezzie|Rezzie]] 23:49, 18 Oct 2005 (PDT)<br />
<br />
:: Thanks a lot. --[[User:Danielpolansky|Danielpolansky]] 09:50, 26 Oct 2005 (PDT)<br />
<br />
=== Where can I make a monetary donation to FreeMind? ===<br />
<br />
Currently, we do not accept any monetary donations. --[[User:Danielpolansky|Danielpolansky]] 00:32, 21 Nov 2005 (PST)<br />
<br />
== This FAQ ==<br />
<br />
=== I have a question not listed here, what should I do? ===<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page. Or specifically, ask your question in FreeMind's [http://sourceforge.net/forum/forum.php?forum_id=22102 Help forum]. Unfortunately, we cannot guarantee that you will get help, still, many users get it.<br />
<br />
=== To edit this FAQ ===<br />
Edit this page like any other wiki page (click edit or press alt-E). When adding a question to the talk page, imitate the format of already existing questions.<br />
<br />
=== Where can I practice editing pages on this Wiki? ===<br />
Click on this link and just hit the edit button on the lower right: [[Sandbox]]<br />
<br />
== Questions not yet answered ==<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page.<br />
<br />
Is FreeMind also Working under SuSe Linux 9.3 or perhaps already a part of the package?<br />
Answer: Yes, please see the "[[FreeMind on Linux]]" page here in the wiki.<br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Asked_questions&diff=5969
Asked questions
2007-10-21T20:25:14Z
<p>Ewl: /* Using physical styles */ Adapt to current pattern format</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
Here we collect a list of asked questions and answers related to free mind mapping software FreeMind. Help if you can (see [[#To edit this FAQ|To edit this FAQ]]). If you're searching for an answer to your question, why don't you just press Ctrl + F in your browser?<br />
<br />
== Installation ==<br />
<br />
=== How do I download the Java Runtime Environment needed to run FreeMind. ===<br />
To download JRE for Windows, go to [http://java.sun.com/j2se/1.4.2/download.html Download on Sun],<br />
go to the section '''Download J2SE v 1.4. ...'''<br />
and now choose the column [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&amp;PartDetailId=j2re-1.4.2_03-oth-JPR&amp;SiteId=JSC&amp;TransactionId=noreg JRE], ''not SDK''. The installation file of JRE has approximately 15 MB.<br />
<br />
=== I start FreeMind but nothing happens ===<br />
First of all, we assume that you are working under Windows. Now, please start freemind.bat in the installation directory.<br />
You'll probably get:<br />
<br />
Exception in thread "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
<br />
at freemind.main.FreeMind.getLogger(FreeMind.java:643) <br />
at freemind.main.FreeMind.<init>(FreeMind.java:109) <br />
at freemind.main.FreeMind.main(FreeMind.java:647) <br />
<br />
The answer to this behaviour is that you've got Java1.3 or lower installed, and this version of java is found (try java -version on the commandline to verify this). <br />
Most likely, you've installed Oracle. <br />
Change JAVA_HOME and the PATH variables to point to your actual java (1.4 or 5.0). <br />
This can be done as follows: Goto Settings -> System -> search for Environment Variables and change or create the values accordingly.<br />
<br />
Another Reason Freemind won't start or will give you the effect of having the icon in the Windows taskbar but nothing else is when you install Freemind in a folder which start with a "!" (exclamation mark), just install it in a different folder. (see http://www.cogmios.nl/java-apps-like-eclipse-or-freemind-do-not-run-in-folders-starting-with-a-20070407.html<br />
)<br />
<br />
=== FreeMind cannot detect new version of Java. What can I do? ===<br />
Let us assume that you have installed a new<br />
version of Java, and still, FreeMind complains about having old version of Java. This may occur especially<br />
if you installed ''SDK'' rather than ''JRE''. ''SDK'' stands for ''standard development kit'' and contains much more<br />
than you need to run FreeMind; you only need runtime environment. It is important that the new version of<br />
java is in your ''path''. To check it out on Microsoft Windows, run command ``cmd" using Windows-key + R,<br />
followed by ``java -version". You should get something like<br />
<br />
java version "1.4.2_03"<br />
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_03-b02)<br />
Java HotSpot(TM) Client VM (build 1.4.2_03-b02, mixed mode)<br />
<br />
where the particular version number is not important as long as it is at least 1.4.0.<br />
<br />
Additionally, it may be helpful to start '''freemind.bat''' and see what messages come.<br />
<br />
'''NOTE:''' If you have an Oracle database product installed on your computer, check the Oracle Installer to see what version of Java was installed with the database. Versions of Oracle 8, 8i, and later install JRE 1.3.1 and modify the startup path for Windows to ensure the database can start using this JRE. This installation WILL cause FreeMind to report the older version of Java, even if you install the new version (the .ini file for Oracle points Windows to the JRE 1.3.1 directory, places that in memory, and causes the fault). You can modify the .ini file to point Oracle to the newer JRE. <br />
<br />
If you don't want to change the Oracle settings: just create a batch file in the FreeMind folder with the following entry "Path-to-your-new-java-runtimes-bin/java.exe -jar lib/freemind.jar" and use that to start freemind.<br />
<br />
=== Which Java virtual machines does FreeMind actually work with? ===<br />
<br />
FreeMind works with the virtual machines from Sun, from the version 1.4.0 and higher. FreeMind has been reported to run on the JDK 1.4.2 from Blackdown. FreeMind also works on Linux with Sun Microsystems 64bit JDK version 1.5.0.<br />
<br />
There is a known issue with official release 0.8.0 of Freemind and Java 6. Encrypted nodes will wipe out your map when trying to save it to disk. Stick to Java 5 (alias 1.5.x) [https://sourceforge.net/tracker/?func=detail&atid=107118&aid=1550792&group_id=7118 (see bug report)]<br />
<br />
=== What is a mirror? ===<br />
A mirror is one of the SourceForge sites from which you can download FreeMind. To download FreeMind, choose ''any'' mirror; you would prefer a mirror geographically closer to the place where you live. If you experience problems with one mirror, try another.<br />
<br />
=== I run 'freemind.bat' and get an error message ===<br />
If you get <br />
Exception in thraed "main" java.lang.NoClassDefFoundError: java/util/logging/Logger <br />
at freemind.main.FreeMind.getLogger<FreeMind.java:643>at<br />
freemind.main.FreeMind.<init<FreeMind.java:109> <br />
at freemind.main.FreeMind.main<FreeMind.java:647> <br />
then the Java Virtual Machine found on your system is of version 1.3 or below. Try <br />
java -version<br />
to verify this. This happens, when you install Oracle for instance. Please, make sure, that your latest Java Virtual Machine is found when you type "java -version" by deinstalling java1.3 for example.<br />
<br />
=== USB Portable FreeMind ===<br />
Just add the following Java option in the freemind.bat or freemind.sh and everything is contained on the USB stick:<br />
<br />
-Duser.home=.[\<subdirectory, if needed>]<br />
<br />
As an example see the new content of my BAT-file, which looks like:<br />
<br />
@echo off<br />
java -Duser.home=. -cp lib\freemind.jar;lib\commons-lang-2.0.jar;lib\forms-1.0.5.jar;lib\jibx\jibx-run.jar;lib\jibx\xpp3.jar;lib\bindings.jar freemind.main.FreeMindStarter<br />
<br />
This lets FM create and use the subfolder .freemind in the location of the freemind.bat.<br />
<br />
As we know, USB flash drives support only limited number of writes. It means that reliability of such device drops down as time advances. Freemind, by default, saves your open maps every minute to .freemind dir which is in this case on the flash drive. If you aren't too paranoid you can avoid this by setting autosave dir to tmp dir of your OS. Freemind will automatically delete autosaves on exit so your precious data won't be left on a host machine. Go to Tools->Preferences->Path to automatic saves and set it to 'default'. Freemind will understand this on Windows probably as c:\windows\temp, Linux - /tmp or /var/tmp.<br />
<br />
That's it and enjoy!<br />
<br />
== Using ==<br />
<br />
=== To add a new concept ===<br />
<br />
A new concept is referred to as a "node." Use the "Insert" key on PCs to add a new node. MAC users need to [[Asked Questions#To_set_a_different_key_for_new_child_node_on_Mac_computers | set a different key]]. Nodes are not limited to just concepts. They can also include sentences, paragraphs or even short articles.<br />
<br />
=== Is there an undo feature in FreeMind? ===<br />
Starting with FreeMind 0.8, there is an undo and redo feature.<br />
<br />
If you are using 0.7, then use the following tips to prevent data loss:<br />
<br />
* Use FreeMind's autosave-feature <br />
: This feature is enabled by default... auto saved files will be found in ~/.freemind/<br />
<br />
* Install a clipboard manager, which will make all elements, which you cut from FreeMind, available in its history. A freeware example of a clipboard manager for MS Windows is [http://www.yankee-clipper.net Yankee Clipper].<br />
<br />
=== How much memory do I need? === ''Keywords: RAM.''<br />
Experience shows that 64 MB is not sufficient, while 128 MB is already enough, provided that you do not run another Java application. Correct me if I'm wrong. I am using FreeMind on Windows 95 + 128 MB without any problems.<br />
<br />
Running FreeMind 0.8RC5 on Windows 95 with 64 MB and Java 1.4.0 is possible and the response time ''is'' in acceptable limits. -- [[User:Stefano|Stefano]] 02:01, 11 Jul 2005 (PDT)<br />
<br />
Running FreeMind 0.7.1 on Debian Linux and Java 1.4.2.03 (j2sdk1.4) with my Omnibook 800 laptop (78 MB RAM, P166) just fine. I haven't tried any big projects with it yet, but so far it's very responsive. --[[User:Nullman|Kyle]] 09:14, 30 Jan 2006 (PST)<br />
<br />
=== To move a node to the other side of root ===<br />
Drag the node onto root and you see one half of root getting gray. Move the node to the other half and <br />
this half gets gray. Just drop the node on the side you want to have it.<br />
As of version 0.9.0 you can also use Ctrl+left and Ctrl+right to move a node in the desired direction (not only to change the side with respect to root, try it out).<br />
<br />
=== To create a graphical link ===<br />
<br />
# Go to the source node. <br />
# Mark it with the mouse. <br />
# Press the left mouse button. <br />
# Hold this button. <br />
# Press Ctrl+Shift buttons. <br />
# Continue to hold all these buttons. <br />
# Go to the destination node. <br />
# Release the mouse button, first. <br />
# Then release the keyboard buttons. <br />
<br />
You have your link. Alternatively, drag'n drop holding right mouse button.<br />
<br />
=== To remove a graphical link ===<br />
<br />
# Right-Click on the curved arrow of the graphical link (Mac users, press Control and click to see the options menu)<br />
# Choose "Remove Arrow Link" from the pop-up menu<br />
<br />
(Left-clicking on a graphical link does nothing)<br />
<br />
=== To add user icons to FreeMind ===<br />
Currently, adding user [http://www.guiicons.com Icons] is not possible.<br />
BUT you can add an inline images to any node. Use the following code example:<br />
<nowiki><html><img src="http://www.stumbleupon.com/pics/me.jpg"></nowiki><br />
in a FreeMind node. This should also work with local files using "file://" instead of "http://".<br />
<br />
=== To open links in only one browser window, rather than several. ===<br />
To our knowledge this is not possible at the moment.<br />
<br />
'''Firefox''' allows this option. ''From the menu, select''<br />
1) Tools > '''Options''' > <br />
2) Click '''Advanced'''<br />
3) Toggle Tabbed Browsing<br />
4) Select to open links from other apps in<br />
...a new tab in the most recent window.<br />
<br />
<br />
'''A possible Work Around:''' There is a way to do this if you use the [http://www.mozilla.org/products/firefox/ Firefox browser] instead of Internet Explorer, provided you<br />
install the Firefox extension called ''Single Window'' (available from [http://update.mozilla.org/extensions/showlist.php?category=Tabbed%20Browsing here]). Using this extension, every time you click on an external web link on a mind map, it will open the relevant page in a new tab in an existing Firefox window, rather than a new browser window. I have found this to be a much easier way to navigate the pages opened. I have only tried this with mm files opened from the file system at the moment (ie not served from a web server in the browser applet).<br />
<br />
To '''open external web links in a new tabs''' in Firefox follow [http://texturizer.net/firefox/tips.html#beh_reuse this tip] (works both for Linux and Windows). You have to add a line in your user.js file and install [http://piro.sakura.ne.jp/xul/_tabextensions.html.en Tabbrowser extensions].<br />
<br />
=== Is it difficult to provide FreeMind with Java Webstart?=== Well, it's not that easy. Joerg Mueller succeeded in doing just that and has sent his source code to Daniel Polansky, who did not succeed in getting it running; he did not consider that a high priority. What is important is that Microsoft Windows users have a convenient installer, and the users of the other operating systems are already used to not so convenient methods; the installation is pretty straightforward anyway.<br />
<br />
=== To create PDF out of FreeMind's mind map ===<br />
To create pdf out of FreeMind's mind map, you've got several<br />
options.<br />
<br />
* Use File/Export/As PDF...<br />
<br />
* Create DocBook, then pdf. Use [http://hkrott.iicm.edu/docs/seminar/sem2002_mindmaps.tar.gz XSLT transformations sheets] from Christoph Rissner to convert FreeMind's mind map to Mind Manager's mind map, then to DocBook, and create pdf from that DocBook. You can read more on that on [http://hkrott.iicm.edu/veranstaltungen/seminar/abgeschlossen.html Abgeschlossene Arbeiten] &gt; Mind Maps.<br />
<br />
* Print to pdf using a pdf printer driver.<br />
** Use open source [http://sector7g.wurzel6.de/pdfcreator/index_en.htm PDFCreator]. It uses Ghostscript as its backend.<br />
<br />
* Print to pdf using Acrobat's Distiller. Provided that you have full version of Adobe Acrobat installed (not just reader), you can print to a pdf using the Distiller or Writer options in your printer list. Make sure you check the "fit to one page" option under File > Page Setup. Also, make sure you set antialias to all under edit > preferences. This will make it look crisper. The only downside to this option is that it doesn't do the icons very well.<br />
<br />
* First print to postscript, then convert to pdf.<br />
** In Linux, create postscript by printing to a file using a postscript printer, and convert the postscript file to pdf afterwards, by using the shell-command ps2pdf or using [http://www.cs.wisc.edu/~ghost/ Ghostscript].<br />
** In Windows, install any postscript color printer (Like AppleColor 600) to print to a file. When printing to that printer, choose a folder and a file that ends with .ps. Then, open that *.ps with [http://www.cs.wisc.edu/~ghost/gsview/index.htm gsview] and choose ''File/Convert to PDF'' (let the program choose it all). Then save the file with the same name, but ending with .pdf. That's all. You might need to read the help files to tune it all up (only once).<br />
<br />
* Export FreeMind's mind map to HTML, paste it into Microsoft Word, format it as you see fit, and convert it to pdf using the techniques decribed above.<br />
<br />
=== To convert mind maps between FreeMind and MindManager ===<br />
Click here: [[Import and export to other applications]]<br />
<br />
=== Who is the development team of FreeMind? ===<br />
<br />
Daniel Polansky: the director of FreeMind is Daniel Polansky, i.e. me. The<br />
label ``director" is not quite appropriate; ``parliament"<br />
would be better. I test new versions, give advice, sometimes<br />
act in the name of FreeMind, forbid versions to be released<br />
because of insufficient quality, and approve them when<br />
they're ready. Also, I set up barriers for new directions.<br />
<br />
The main actor on the scene is Christian Foltin. We use<br />
the label ``code master" to denote his role, and also<br />
``manager". He does most of the work and decides which<br />
code changes are acceptable what concerns the<br />
quality of code. He takes care of mergers. Also, he<br />
coordinates the developers.<br />
<br />
An important developer is Dimitri Polivaev.<br />
<br />
=== To have brainstorm-like mode similar to one found in MindManager.===<br />
Did you notice you can hit Enter and Shift-Enter to create sibling nodes?<br />
It is not exactly the behavior of brainstorm mode of MindManager, but still<br />
close to it.<br />
<br />
=== On what operating systems have people actually succeeded in running FreeMind?===<br />
<br />
* ''Microsoft Windows.'' Windows 95, Windows 98, Windows NT, Windows 2000, Windows XP (SP1 & SP2), Windows 2003 Server<br />
* ''Linux.'' Mandrake 9.2 and 10, RedHat Pro WS 3, Fedora Core 2, SuSE (8.2 using the RPM for 9.0, 9.0, 9.1, 9.2, 9.3, 10.0, 10.2), Ubuntu (Warty), Debian sarge, Debian sid, Slackware 9.1, Gentoo, Mepis 3.3.1, Mepis 3.4-2.rc1.<br />
* ''BSD.'' FreeBSD (5.2.1, 5.4, 6.1), Mac OS X (10.2.8, 10.3, 10.4.4, 10.4.8)<br />
* ''Other.'' OS/2, Solaris 9 and 10.<br />
''Keywords: platforms.''<br />
<br />
=== Is there a PDA-Version, e.g. for Palm or Pocket PC? ===<br />
On PDA, you can use [[FreeMindPDA]]. It uses cross-platform [http://www.superwaba.com SuperWaba] Open Source SDK. However, it does not use mind map view, but rather plain tree view; it is not a proper FreeMind version in that sense. See also [[Stuff#PDA|FreeMind and PDA]].<br />
<br />
=== How large maps can I edit with FreeMind? ===<br />
<br />
In principle, there are no built-in limits. Practically, the maximum reported size is 11 MB at a map with 22,000 nodes; after exporting to HTML and pasting to Microsoft Word, the very same content had 15.6 MB, with 1500 pages. For a better practical estimation, experimental tests are needed, as the maximum given so far is only a lower bound on practical limits.<br />
<br />
I've been appending daily notes to a single mind-map file continually for many months on a 3 GHz Pentium 4 with 2 GB RAM running windowsXP. The file has grown to about half a megabyte, 420K, and there is a noticable difference in Freemind's responsiveness dealing with it, but it still works for me.<br />
<br />
=== How can I keep FreeMind from opening the last file from the last session? ===<br />
One way is to disable the changing of the file "auto.properties" (which is in the same folder as [[user.properties]]). Be aware that the menu "Edit -> Preferences" will not change anything any more than!<br><br />
To do that go to the file auto.properties and delete everything behind "onStartIfNotSpecified=" in that line. Now set the file "auto.properties" to read-only.<br />
<br />
===To change the fill color on bubbles.===<br />
There's an icon for it at the main toolbar. Additionally,<br />
you can find it in the popup menu at Node > Style > Cloud color.<br />
<br />
===To remove a cloud===<br />
Press Ctrl+Shift+B to toggle clouds.<br />
<br />
=== To search in FreeMind === <br />
''Keywords: find.'' Press Ctrl + F. For finding next occurrence, press Ctrl + G. Searching is<br />
restricted to the descendants of the node selected when pressing Ctrl + F. The search is<br />
a breadth-first search, first finding occurrences in the nodes closer to the starting node.<br />
<br />
===To move nodes around=== To move them up and down, use ctrl + up and down arrows. To move them wherever you want, use drag'n drop with mouse. ''Keywords: move around, reorganize.''<br />
<br />
=== What does antialias mean in FreeMind preferences? ===<br />
<br />
To antialias means to make fonts or curves look smooth by drawing additional pixels with in-between color. See also wikipedia on [http://en.wikipedia.org/wiki/Antialiasing antialiasing].<br />
<br />
By default, FreeMind antialiases edges only. FreeMind can also antialias text, but with the current state of the technology, it does not look good enough. At least, new Java RE 1.5.0 has better antialiasing of text than Java RE 1.4.x. Also, it is possible to set the whole application to antialiasing, including the menus and editing box; by using the command line option <code>-Dswing.aatext=true</code> of Java 1.5.0. Unfortunately, this is not available if you're using FreeMind.exe to launch FreeMind.<br />
<br />
=== What kind of encryption is used? ===<br />
<br />
: ''See [[Encryption]].''<br />
<br />
=== Reminders don't work when I start a map. The PDF-Export is not present. What's happening? ===<br />
There, the plugins (not only the PDF/SVG one) appear only if you start FreeMind from the directory where it has been installed. Especially if you start FreeMind by double-clicking on a FreeMind file (.mm file), this is not the case. So, use your icon and choose open to open your file.<br />
<br />
== Customizing FreeMind ==<br />
<br />
=== How do I add a new keyboard shortcut ===<br />
To add a new keyboard shortcut, say for "Change node background color", open the file<br />
mindmap_menus.xml (in freemind.jar) and search for "background", say.<br />
<br />
You'll find<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Here, you add a new keyboard ref attribute like:<br />
<pre><br />
<menu_action field="nodeColor" key_ref="keystroke_node_color"/><br />
<menu_action field="nodeColorBlend" key_ref="keystroke_node_color_blend"/><br />
<menu_action field="nodeBackgroundColor" key_ref="keystroke_node_background_color"/><br />
<menu_action field="removeNodeBackgroundColor"/><br />
</menu_category><br />
</pre><br />
Open the file freemind.properties and add a line like<br />
<pre><br />
#<br />
keystroke_node_color = alt F<br />
keystroke_node_color_blend = alt B<br />
keystroke_edge_color = alt E<br />
keystroke_node_background_color=alt N<br />
</pre><br />
But you have to search for free keys...<br />
<br />
=== To set expert settings ===<br />
<br />
Most of expert settings are stored in the [[user.properties]] file.<br />
<br />
=== To use another browser ===<br />
<br />
If you want to use another browser, edit the [[user.properties]] file and change the following property according to your operation system: <br />
<br />
default_browser_command_windows_nt <br />
default_browser_command_windows_9x <br />
default_browser_command_mac <br />
default_browser_command_other_os <br />
<br />
You have to write something like<br />
<br />
default_browser_command_windows_nt = C:\Program Files\Internet Explorer\iexplore.exe "{0}"<br />
...<br />
<br />
=== To change language ===<br />
<br />
Lydia<br />
<br />
language= en<br />
<br />
language = de <br />
<br />
Don't forget to remove the # character. Restart FreeMind and you have changed the language to German. See also [[Development#To_translate_FreeMind_into_your_language|the list of available languages]].<br />
<br />
=== To set a different key for new child node on Mac computers ===<br />
<br />
NOTE: The latest version of Freemind now sets the "tab" key as the default key for inserting a new node on a mac. Unfortunately, this is not documented in an obvious place. If you right or control click on a node you see a menu that does tell you the Tab shortcut for creating a child node but this is easily missed.<br />
<br />
In a manner similar to changing the language, replace<br />
<br />
#keystroke_add_child = INSERT <br />
<br />
with<br />
<br />
keystroke_add_child = control shift ENTER<br />
<br />
in the file [[user.properties]]. Pay attention that you write the key code ENTER in capital letters. <br />
<br />
The command ("Apple") key can be referred to as "meta" in these keystroke sequences - in case you were wondering.<br />
<br />
=== There is no shortcut to insert a note. Why? ===<br />
There is no shortcut on purpose, as this action does not come with undo. <br />
<br />
If you want to have this shortcut, you can download the sources, patch NodeNote.xml such that it contains a key_stroke="alt N" in the first lines as here: <br />
<br />
<br />
<plugin_action <br />
documentation="%accessories/plugins/NodeNote.properties_documentation" <br />
name="%accessories/plugins/NodeNote.properties_name" <br />
base="freemind.extensions.NodeHookAdapter" <br />
'''key_stroke="alt N"''' <br />
icon_path="accessories/plugins/icons/knotes.png" <br />
label="accessories/plugins/NodeNote.properties" <br />
class_name="accessories.plugins.NodeNote" instanciation="Once"> <br />
<br />
<br />
compile and you are done. BUT REMEMBER: Pressing your key on a node, that already contains a note, makes this note to remove WITHOUT UNDO. <br />
<br />
At your own risk, Chris<br />
<br />
<br />
=== Using physical styles (or patterns) ===<br />
<br />
Physical styles and patterns are the same and can be compared to "styles" in a text writer: you define a set of styling attributes, give this set a name, and can then assign the style or pattern to different nodes in the same way.<br />
<br />
The patterns are defined in the file <tt>patterns.xml</tt> placed in the FreeMind user directory. In Windows, that file is <tt>C:\Documents and Settings\YourUserName\.freemind\patterns.xml</tt>; under Linux, it's <tt>~/.freemind/patterns.xml</tt>.<br />
<br />
<?xml version="1.0" encoding="UTF-8"?><br />
<patterns><br />
<pattern name="Pattern1"><br />
[...pattern properties...]<br />
</pattern><br />
<pattern name="Pattern2"><br />
[...pattern properties...]<br />
</pattern><br />
[...more patterns...]<br />
</patterns><br />
<br />
As you can see from above, you need to give each pattern a unique name, and then you need to assign pattern properties. Each pattern property is of the form <tt><'''pattern_property_name''' value="'''property_value'''"/></tt>, or <tt><pattern_'''property_name'''/></tt>, and each property stands for a different format parameter. The following property names are possible:<br />
<br />
* pattern_node_background_color<br />
* pattern_node_color<br />
* pattern_node_style<br />
* pattern_node_text<br />
* pattern_node_font_name<br />
* pattern_node_font_bold<br />
* pattern_node_font_italic<br />
* pattern_node_font_size<br />
* pattern_icon<br />
* pattern_edge_color<br />
* pattern_edge_style<br />
* pattern_edge_width<br />
* pattern_child<br />
<br />
; TODO : Add more explanations about the possible values and exact impact for each property.<br />
<br />
Where the property is listed without value attribute, the corresponding format is reset to its default value.<br />
<br />
==== Allowed values ====<br />
<br />
For colors, the format of the value is "#RRGGBB", where RR, GG, BB are the hexadecimal values of the red, green, blue components of a color, e.g. "#B3B95C".<br />
<br />
<code>pattern_icon</code> can take one of the following values:<br />
<br />
* help<br />
* messagebox_warning<br />
* idea<br />
* button_ok<br />
* button_cancel<br />
* full-1<br />
* full-2<br />
* full-3<br />
* full-4<br />
* full-5<br />
* full-6<br />
* full-7<br />
* back<br />
* forward<br />
* attach<br />
* ksmiletris<br />
* smily_bad<br />
* clanbomber<br />
* desktop_new<br />
* flag<br />
* gohome<br />
* kaddressbook<br />
* knotify<br />
* korn<br />
* Mail<br />
* password<br />
* pencil<br />
* stop<br />
* wizard<br />
* xmag<br />
* bell<br />
* bookmark<br />
* penguin<br />
* licq<br />
<br />
==== Example(s) ====<br />
<br />
An example of a pattern is therefore:<br />
<br />
<pattern name="Blue with edges and icon"><br />
<pattern_node_background_color/><br />
<pattern_node_color value="#000099"/><br />
<pattern_node_style/><br />
<pattern_icon value="flag"/><br />
<pattern_edge_color value="#009999"/><br />
<pattern_edge_style/><br />
<pattern_edge_width value="4"/><br />
</pattern><br />
<br />
This information and more can be discovered by opening any .mm file in a text or XML editor. You can usually search for the text in an element to find the example of what you want to learn how to do.<br />
<br />
; Note : the complete list of pattern properties can be found in the source code, in the file <tt>freemind/freemind_actions.xsd</tt> (search for ''pattern_''), and the list of icons in the file <tt>freemind/modes/MindIcon.java</tt> (search for ''mAllIconNames.add'').<br />
<br />
== Mind maps on web pages with FreeMind's applet ==<br />
<br />
=== To get FreeMind's applet working. ===<br />
If you experience problems viewing a mind map published by someone else, the most common problem is that you have to use Java >= 1.4 in your browser. Check this using the "About plugins" section of your browser (or a similar place). If you have Java >= 1.4 installed and still experiencing problems check out Internet Explorer's settings by selecting Tools > Internet Options > Advanced > Java and make sure ``Use Java2" is enabled.<br />
<br />
=== To present your mind map on the web ===<br />
Use FreeMind's browser applet. The following [http://freemind.sourceforge.net/docs/Serving%20Freemind%20maps%20in%20a%20browser/index.html document] (thanks to Bob) explains what to do to have a complete testing environment for your applet. <br />
<br />
=== Quick Java Applet instructions if you are already a code wiz ===<br />
<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" ARCHIVE="freemindbrowser.jar" <br />
WIDTH="100%" HEIGHT="80%"><br />
<PARAM NAME="type" VALUE="application/x-java-applet;version=1.4"><br />
<PARAM NAME="scriptable" VALUE="false"><br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
<\!-- ^ this has no effect on my pc --><br />
<PARAM NAME="modes" VALUE="freemind.modes.browsemode.BrowseMode"><br />
<PARAM NAME="browsemode_initial_map" VALUE="http://www.osde.info/osde.mm"><br />
<\!-- ^ Put the FULL path to your map here --><br />
<param NAME="initial_mode" VALUE="Browse"><br />
<param NAME="selection_method" VALUE="selection_method_direct"><br />
</APPLET><br />
<br />
In some cases, it may be necessary to set the '''ARCHIVE''' property to also use the '''Full Path''' to the .jar file. In the above example, the initial '''APPLET''' element would appear as:<br />
<APPLET CODE="freemind.main.FreeMindApplet.class" <br />
ARCHIVE="http://www.exmaple.com/freemindbrowser.jar" WIDTH="100%" HEIGHT="80%"><br />
<br />
The most recent version of above source and freemindbrowser.jar are contained in the freemindbrowser.zip-Archive, which you can get from [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=16120 the sourceforge-site].<br />
<br />
=== To view the toolbar automatically after the applet starts ===<br />
It is necessary to edit the html starter of the applet and change the corresponding property. That is, set<br />
toolbarVisible=true. More precisely, add a tag <br />
<PARAM NAME="toolbarVisible" VALUE="true"><br />
to freemindbrowser.html or whatever name you have changed the file to.<br />
<br />
=== Is there a list of names and values and functions of all params for the applet? ===<br />
No. Theoretically, all parameters found in user.properties can be used as parameters of the applet.<br />
<br />
<br />
=== Is it possible to change or edit the map through an applet? ===<br />
<br />
No. There is no applet for ''editing'' mind maps; only for viewing.<br />
<br />
=== My document isn't opened by the applet ===<br />
<br />
The URL of the document *must* end with .mm. If it doesn't the document opens in a new browser window. The trick I use is to append a dummy parameter like in this example:<br />
<br />
http://myserver/mypath/mydoc?e=.mm<br />
<br />
This trick is specially useful for dynamic documents. (this is an opinion only. Some people, like Garito, thinks in another way)<br />
<br />
===Java Applet for XHTML===<br />
<br />
The same Freemind Browser can be used but instead of using the 'applet' element, the 'object' element can be used instead. Using Shayne Steele's [http://ww2.cs.fsu.edu/~steele/XHTML/appletObject.html approach], the following code can be used for placing a file called Textbook.mm that is located in http://example.com/freemind/ (along with the freemindbrowser.jar file):<br />
<br />
&lt;!--[if !IE]--&gt;<br />
&lt;object classid="java:freemind.main.FreeMindApplet.class"<br />
type="application/x-java-applet"<br />
archive="http://example.com/freemind/freemindbrowser.jar"<br />
width="450" height="300"&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
&lt;object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"<br />
codebase="http://java.sun.com/update/1.5.0/jinstall-1_5_0-windows-i586.cab"<br />
height="300" width="450"&gt;<br />
&lt;param name="code" value="freemind.main.FreeMindApplet" /&gt;<br />
&lt;param name="archive" value="http://example.com/freemind/freemindbrowser.jar" /&gt;<br />
&lt;param name="scriptable" value="false" /&gt;<br />
&lt;param name="modes" value="freemind.modes.browsemode.BrowseMode" /&gt;<br />
&lt;param name="browsemode_initial_map" value="http://example.com/freemind/Textbook.mm" /&gt;<br />
&lt;param name="initial_mode" value="Browse" /&gt;<br />
&lt;param name="selection_method" value="selection_method_direct" /&gt;<br />
&lt;strong&gt;<br />
This browser does not have a Java Plug-in.<br />
&lt;/strong&gt;<br />
&lt;br /&gt;<br />
&lt;a href="http://java.sun.com/products/plugin/downloads/index.html"&gt;<br />
Get the latest Java Plug-in here.<br />
&lt;/a&gt;<br />
&lt;/object&gt;<br />
&lt;!--[if !IE]&gt;--&gt;<br />
&lt;/object&gt;<br />
&lt;!-- &lt;![endif]--&gt;<br />
<br />
It works and it is valid markup. If placing in an HTML file, use '&gt;' instead of ' /&gt;' for the param element ending.<br />
<br />
== Workarounds in FreeMind ==<br />
<br />
===FreeMind behaves strange or crashes. What can I do?===<br />
First try reinstalling both Java (mostly the latest version is best) and Freemind. Often this solves problems. <br />
One of the problems solved in this way was:<br />
<br />
'' ''My computer crashes, or more precisely locks, when I click on a link in FreeMind, using J2RE 1.4.2_03 on Windows 98. Reinstalling helped. In retrospect, I think what broke it was that I renamed the J2RE directory to something easier to write in the bat file path statement. Broke it. ''<br />
<br />
=== When I drag files into the FreeMind window, FreeMind just works very long or I get a mind map of the file system ===<br />
This is a bug which is a least present on FreeMind 7.2 beta and lower on Windows. I only know of a workaround for this: Go to the [[user.properties]] and delete ",freemind.modes.filemode.FileMode". This disables the file mode of FreeMind.<br />
<br />
=== Changing the key bindings in user.properties does not work ===<br />
It seems that capitalization IS important in the keybindings. I wrote "enter" and it didn't work. I changed it to "ENTER" and it worked!<br />
(FreeMind 7.2 beta)<br />
<br />
=== FreeMind fails to work with or to export big maps ===<br />
When FreeMind fails to work with big maps, you may do the following.<br />
<br />
Assign more memory to the Java virtual machine as a workaround by editing the launching script. Edit <code>freemind.bat</code> or <code>Freemind.sh</code> and add a <code>-Xmx''MEM''</code> parameter to the <code>java</code> command line at the end of the script, like <code>java -Xmx512m ...</code> for 512 megabytes maximum memory and <code>java -Xmx768m ...</code> for 768 megabytes maximum memory. Believing the manual of Java, the default is 64 MB and the maximum is slightly less than 2000 on an x86 processor, which should be enough.<br />
<br />
Beware that exporting may still take a while. For instance, it may take 11 minutes to export a mind map with 740 nodes to JPEG.<br />
<br />
=== Plugins not found when FreeMind 0.8 starts by double-clicking a FreeMind mind map ===<br />
<br />
The following Microsoft Windows laucher fixes the problem that plugins were not found when FreeMind was started by double-clicking a FreeMind mind map. Download the [http://sourceforge.net/tracker/index.php?func=detail&aid=1361629&group_id=7118&atid=307118 patch with fixed Windows launcher], and replace <tt>Freemind.exe</tt> found in <tt>C:\Program Files\FreeMind</tt> with the one found in the patch, given you are in Windows. Backing up the original <tt>Freemind.exe</tt> is advisable.<br />
<br />
== Using HTML in long nodes ==<br />
<br />
=== What HTML tags does FreeMind support? ===<br />
<br />
FreeMind supports basic HTML in its nodes. For HTML to take effect, a node must start<br />
with "&lt;html>". What HTML is supported depends on the Java virtual machine.<br />
Among others, users have reported the following uses:<br />
<br />
<nowiki><html><p style="background-color:yellow">the node text</p></nowiki><br />
<br />
=== To embed, or more precisely link, images into FreeMind. ===<br />
You can link images into FreeMind using context menu of a node, accesed using right click (on MAC OS X Panther use Control click). Or type the following:<br />
&lt;html&gt;&lt;img src=&quot;image.jpg&quot;&gt;&lt;/html&gt;<br />
where image.jpg is the reference to an image.<br />
<br />
=== To put the contents of a Microsoft Word document into FreeMind. ===<br />
<br />
* First paste the Word document into Microsoft FrontPage.<br />
* Delete the images afterwards as FreeMind does not support them.<br />
* Remove the &lt;head> ... &lt;/head> in the source text view in FrontPage.<br />
* But leave the &lt;html>! The node needs to start with that.<br />
* Replace &lt;body&gt; with &lt;body width=600&gt; or similar width specification.<br />
* Finally, paste the HTML text as a long node into FreeMind.<br />
<br />
=== To have tables in FreeMind ===<br />
If you have Microsoft Frontpage available, it is convenient to create and<br />
edit HTML content there and paste it to and from FreeMind. Beware that the html code has to start with<br />
''&lt;html&gt;''. This way, you can conveniently create tables using the drawing tools of Frontpage.<br />
You can create formatted text this way as well; in that case, beware to set ''&lt;body width=600&gt;''<br />
or similar. However, FreeMind does not interpret all HTML; especially, it does not interpret inline<br />
CSS styling so you have to use hard formatting instead.<br />
<br />
If you want the table borders to have a '''nice two dimensional look''' rather than bevelled, start<br />
the HTML as follows.<br />
<br />
<html><br />
<head><br />
<style> td { border-style: solid } table { border-style: solid } </style><br />
</head><br />
<br />
== Generating mind maps programmatically ==<br />
<br />
=== To insert a newline into a node ===<br />
<br />
Insert <code>&amp;#xa;</code> instead of plain newline. Example of a map with three newlines:<br />
<br />
<map version="0.7.1"><br />
<node TEXT="New Mindmap"><br />
<node TEXT="A&amp;#xa;B&amp;#xa;C&amp;#xa;D" POSITION="right"/><br />
</node><br />
</map><br />
<br />
=== To use unicode characters in the node text ===<br />
<br />
FreeMind understands and uses <code>&amp;#xnn;</code>, where nn is equivalent to the '''hexadecimal''' number representing the character. It '''does not''' understand <code>&amp;#nnn;</code>, where nnn is '''decimal''' number. An example of a map containing ''Areté'' follows.<br />
<br />
<map version="0.7.1"><br />
<node TEXT="Aret&amp;#xe9;"/><br />
</map><br />
<br />
== FreeMind on Microsoft Windows ==<br />
<br />
=== How do I install a test version of FreeMind? ===<br />
Just unzip the package to the folder "C:\Program Files\FreeMind". That completes the "installation".<br />
You can start it by running freemind.exe (or freemind.bat if the exe does not exist). You can find test versions [http://freemind.sourceforge.net/testversions/ here].<br />
<br />
=== FreeMind does not seem to be affected by the things I edit in the user.properties. Why? ===<br />
See [[user.properties]].<br />
<br />
=== FreeMind starts and reacts so slow. Why? How to resolve? ===<br />
This seems to be an effect of the connection between Java and MS DirectX. You can deactivate the usage of DirectX for Freemind by editing the Freemind.bat file in your FreeMind directory.<br />
<br />
Add the parameter<br />
<br />
-Dsun.java2d.noddraw=true <br />
<br />
before the final expression <tt>freemind.main.FreeMind</tt>.<br />
<br />
Of course, now you have to use Freemind.bat to start the program instead of executing Freemind.exe. Do not forget to update file associations as well: [[Windows File Associations]]<br />
<br />
=== To create a screenshot of FreeMind and paste it into Microsoft Word or Microsoft Powerpoint ===<br />
To take a screenshot of your whole windows screen into clipboard, press Ctrl + Print Screen. To take a screenshot<br />
of the active window only into clipboard, press Alt + Print Screen. Select your Word or Powerpoint document<br />
and press Ctrl + V. On German keyboard, the key PrintScreen has the label "Druck". However, such a screenshot<br />
also contains FreeMind's window frame, not just the map contents. In Microsoft Word and Microsoft Powerpoint, this<br />
can be solved by cropping the screenshot; the cropping tool can be found in Picture toolbar..<br />
<br />
===To export a map to Microsoft Powerpoint===<br />
There's no elegant way to export a map to PowerPoint. One option is to take a screenshot, and paste it into Powerpoint. PowerPoint supports graphic file insertion, so another option is upgrading to a more recent version of FreeMind that supports JPEG export.<br />
<br />
One another solution is by using a Flash plugin:<br />
* Insert a control "Shockwave Flash Object" with the Control toolbar (go to display/toolbar/customise if not available).<br />
* Activate the propeties window by double clicking on the rectangle of the object<br />
* Click on the custom "property"<br />
* On the new opened window set the "movie URL" to the full path of the plugin (i.e: c:\path\visorFreemind.swf)<br />
* Set the "base URL" to the name of your freemind file (i.e.: index.mm) <br />
* Start your diaporama and you will see the cross inside the rectangle replaced by your freemind map<br />
<br />
If not successfull with those explanation, you will find a more complete information at the following address: [http://www.flashgeek.com FlashGeek]<br />
<br />
===To export / import a map to Microsoft Project===<br />
Look at the section [http://freemind.sourceforge.net/wiki/index.php/Import_and_export_to_other_applications Import and export to other applications]<br />
<br />
== FreeMind on Mac OS X ==<br />
<br />
FreeMind is written in the Java language, which is great for development and deployment of cross-platform applications.<br />
Freemind uses the Swing graphical user interface toolkit, which can use different looks and feels in order to mimic visuals and behaviours proprietary to the target execution platforms.<br />
<br />
<br />
On Microsoft Windows OS, the application fits quite nicely with the rest of the environment, but on Apple MacOS-X, things are often not quite right. MacOS-X users usually have higher expectations when it comes to usability and UI consistency, so they might become frustrated by the lack of compliance to their user interface guidelines.<br />
<br />
<br />
Here are some tips to enhance the user experience when using MacOS-X:<br />
<br />
<br />
#Keyboard shortcuts<br />
#:The "Tao Of Mac" weblog posted a tip for replacing the "CTRL" key by the "COMMAND" (Apple) key:<br />
#:http://the.taoofmac.com/space/Applications/FreeMind<br />
#Look and feel<br />
#:"Quaqua" is a look and feel for Swing that emulates the Aqua user interface:<br />
#:http://www.randelshofer.ch/quaqua/download.html<br />
#Shift-click to select multiple nodes.<br />
<br />
== FreeMind on Linux and other UNIX-like systems ==<br />
<br />
Go to the specific page [[FreeMind on Linux]].<br />
<br />
== Misc ==<br />
<br />
=== Is FreeMind mind mapping software? ===<br />
<br />
The term '''mind mapping''' is related to british psychologist Tony Buzan. In Buzan's context, mind map is a tree with many colors, pictures and personal expression. '''FreeMind is not''' really '''mind mapping''' software '''in the sense of Tony Buzan''', nevertheless, one would say that FreeMind belongs to the class of so called '''mind mapping software'''.<br />
<br />
Some of members of that class come pretty close to Buzan. Have a look at the site of first class commercial mind mapping software [http://www.mindjet.com/ MindManager]. You may also want to see [http://www.mind-mapping.co.uk/mind-maps-examples.htm examples] of mind maps in Buzan's sense.<br />
<br />
=== To spell FreeMind correctly. === <br />
"FreeMind", with a capital M.<br />
<br />
=== Where can I find a quick reference list of default keyboard shortcuts for the Windows 0.7.1 version? ===<br />
Here is a list of shortcuts, grouped by function:<br />
<br />
File commands:<br />
New map - Ctrl+N<br />
Open map - Ctrl+O<br />
Save map - Ctrl+S<br />
Save as - Ctrl+A<br />
Print - Ctrl+P<br />
Close - Ctrl+W<br />
Quit - Ctrl+Q<br />
Previous map - Ctrl+LEFT<br />
Next Map - Ctrl+RIGHT<br />
Export file to HTML - Ctrl+E<br />
Export branch to HTML - Ctrl+H<br />
Export branch to new MM file - Alt+A<br />
Open first file in history - Ctrl+Shift+W<br />
<br />
Edit commands:<br />
Find - Ctrl+F<br />
Find next - Ctrl+G<br />
Cut - Ctrl+X<br />
Copy - Ctrl+C<br />
Copy single - Ctrl+Y<br />
Paste - Ctrl+V<br />
<br />
Mode commands:<br />
MindMap mode - Alt+1<br />
Browse mode - Alt+2 <br />
File mode - Alt+3<br />
<br />
Node formatting commands:<br />
Italicize - Ctrl+I<br />
Bold - Ctrl+B<br />
Cloud - Ctrl+Shift+B<br />
Change node color - Alt+C<br />
Blend node color - Alt+B<br />
Change node edge color - Alt+E<br />
Increase node font size - Ctrl+L<br />
decrease node font size - Ctrl+M<br />
Increase branch font size - Ctrl+Shift+L<br />
Decrease branch font size - Ctrl+Shift+M<br />
<br />
Node navigation commands:<br />
Go to root - ESCAPE<br />
Move up - UP<br />
Move down - DOWN<br />
Move left - LEFT<br />
Move right - RIGHT<br />
Follow link - Ctrl+ENTER<br />
Zoom out - Alt+UP<br />
Zoom in - Alt+DOWN<br />
<br />
New node commands:<br />
Add sibling node - ENTER<br />
Add child node - INSERT<br />
Add sibling before - Shift+ENTER<br />
<br />
Node editing commands:<br />
Edit selected node - F2<br />
Edit long node - Alt+ENTER<br />
Join nodes - Ctrl+J<br />
Toggle folded - SPACE<br />
Toggle children folded - Ctrl+SPACE<br />
Set link by filechooser - Ctrl+Shift+K<br />
Set link by text entry - Ctrl+K<br />
Set image by filechooser - Alt+K<br />
Move node up - Ctrl+UP<br />
Move node down - Ctrl+DOWN<br />
<br />
=== To suggest new enhancements of FreeMind ===<br />
''Keywords: additional features, additional functions.''<br />
At FreeMind's project page, you can [http://sourceforge.net/tracker/?group_id=7118&atid=357118 submit Requests for Enhancements (RFEs)].<br />
<br />
=== Is MindMaster a rip off of FreeMind? ===<br />
<br />
''Update: the site of MindMaster is no longer there, thanks to Rezzie.''<br />
<br />
There is a [http://www.gigastorm.com/mindmaster/ web site] offering a product called MindMaster. This program is a ripped off version of FreeMind. It is not just a clone of FreeMind; it ''is'' just FreeMind renamed, and slightly modified. They even use the presentation texts as found on the main page of FreeMind. As FreeMind is licenced under GNU GPL, so must be MindMaster. However, on the MindMaster site and after the installation, they claim that they hold copyright to MindMaster, and that you are prohibited to use MindMaster unless you conform to their licence. This is unlawful. We urge you not to use or recommend MindMaster, and to avoid linking to their site or giving any recommendation. Also, you can write an email to them complaining about abuse of GNU General Public Licence. --[[User:Danielpolansky|Danielpolansky]] 11:15, 14 May 2005 (PDT)<br />
<br />
: I have been in contact with the author of [http://www.gigastorm.com/mindmaster/ MindMaster] and he has since removed the website and all links to the download. He did in fact claim it was released under the GPL and included both the licence and source code in the package, but as I didn't want to shell out $30 I cannot verify this. --[[User:Rezzie|Rezzie]] 23:49, 18 Oct 2005 (PDT)<br />
<br />
:: Thanks a lot. --[[User:Danielpolansky|Danielpolansky]] 09:50, 26 Oct 2005 (PDT)<br />
<br />
=== Where can I make a monetary donation to FreeMind? ===<br />
<br />
Currently, we do not accept any monetary donations. --[[User:Danielpolansky|Danielpolansky]] 00:32, 21 Nov 2005 (PST)<br />
<br />
== This FAQ ==<br />
<br />
=== I have a question not listed here, what should I do? ===<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page. Or specifically, ask your question in FreeMind's [http://sourceforge.net/forum/forum.php?forum_id=22102 Help forum]. Unfortunately, we cannot guarantee that you will get help, still, many users get it.<br />
<br />
=== To edit this FAQ ===<br />
Edit this page like any other wiki page (click edit or press alt-E). When adding a question to the talk page, imitate the format of already existing questions.<br />
<br />
=== Where can I practice editing pages on this Wiki? ===<br />
Click on this link and just hit the edit button on the lower right: [[Sandbox]]<br />
<br />
== Questions not yet answered ==<br />
<br />
Post new questions either to some of our [http://sourceforge.net/forum/?group_id=7118 forums] or to the [[Talk:Asked_Questions|discussion page]] of this page.<br />
<br />
Is FreeMind also Working under SuSe Linux 9.3 or perhaps already a part of the package?<br />
Answer: Yes, please see the "[[FreeMind on Linux]]" page here in the wiki.<br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=5976
FreeMind on Linux
2007-08-18T14:14:20Z
<p>Ewl: /* The RPM installation */ JavaHelp2 update + fix help plugin name</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
Installation on Ubuntu requires two steps. Install a Java runtime environment, then install FreeMind. Newer versions of Ubuntu (since 6.10?) install Java by default. So chances are that you can skip most of the following instructions. <br />
You might want to check, if Java is installed and what version is active. Open a Terminal and type<br />
<br />
java -version<br />
<br />
Java 1.4 or higher should be fine.<!-- Can anyone confirm this? --> See also Ubuntu's community documentation on [https://help.ubuntu.com/community/Java Java].<br />
<br />
===== Install Java Manually =====<br />
These instructions (and [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper these notes]) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
You milleage may vary but if this doesn't work, consider looking at [http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper this link].<br />
<br />
===== Install FreeMind Manually =====<br />
<br />
All the above required packages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After [https://help.ubuntu.com/community/Repositories adding the multiverse and universe repositories] add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
===== Synaptic =====<br />
<br />
If you prefer graphical user interfaces, you can also use Ubuntu's Synaptic Package Manager to install Java and FreeMind. Ubuntu's online documentation explains [https://help.ubuntu.com/community/SynapticHowto Synaptic] and how to [https://help.ubuntu.com/7.04/add-applications/C/extra-repositories-adding.html add extra repositories]. This repository should work for most users:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ unstable/<br />
<br />
Then open Synaptic and search for "freemind". Mark "freemind" and "freemind-browser" for install. Click on "Apply". Confirm that you want to install third party software. That's it. :-)<br />
<br />
===== gdebi-gtk =====<br />
<br />
This worked for me on Ubuntu Feisty Fawn and was very easy.<br />
<br />
Download the FreeMind .deb files to an empty directory. I put them in ~/Freemind.<br />
<br />
Open a terminal window and change directory to ~/Freemind.<br />
<br />
My directory contained the .deb files listed here:<br />
<br />
freemind_0.8.0-1_all.deb<br />
freemind-plugins-time_0.8.0-1_all.deb<br />
libbatik-java_1.5.1-1_all.deb<br />
freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
Since I had Sun Java installed already, I just ran these command lines:<br />
<br />
gdebi-gtk freemind_0.8.0-1_all.deb<br />
gdebi-gtk freemind-plugins-time_0.8.0-1_all.deb<br />
gdebi-gtk libbatik-java_1.5.1-1_all.deb<br />
gdebi-gtk freemind-plugins-svg_0.8.0-1_all.deb<br />
<br />
That was it. Last thing I did was to create a new launcher on my desktop that called "freemind". I dragged the launcher to the task bar where a single click launches the application. It seems to work well. I didn't bother installing the help .deb because the dependencies reported by gdebi-gtk were too complicated for me to resolve.<br />
<br />
Good luck! I hope your installation works as well as mine.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
; Note : in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a [http://mirrors.dotsrc.org/jpackage/1.7/generic/devel/repodata/repoview/J.group.html JPackage mirror]. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if in <code>freemind.sh</code> you replace<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
by<br />
if [ ! -n "${freepath}" ]<br />
then<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
fi<br />
and then set <code>$freepath</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind.freemindrc</code> like this:<br />
# settings for freemind<br />
#<br />
# path to the installation of freemind<br />
freepath="/opt/freemind/"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2 & Ubuntu Feisty:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with [http://www.nongnu.org/ratpoison/ ratpoison].)<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
This problem can be circumvented at least partially by editing the ''$HOME/.freemind/auto.properties'':<br />
<br />
#Wed Jun 13 15:58:31 EEST 2007<br />
lastOpened=<br />
standardfont=SansSerif<br />
appwindow_state=0<br />
appwindow_height='''720'''<br />
appwindow_width='''1260'''<br />
toolbarVisible=true<br />
leftToolbarVisible=true<br />
antialiasEdges=true<br />
antialiasAll=false<br />
<br />
Set the ''appwindow_height'' and ''appwindow_width'' to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).<br />
<br />
'''Another hint:''' setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6429775 here].<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table><br />
<br />
[[Category:Documentation]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=4732
FreeMind on Linux
2007-05-08T08:00:58Z
<p>Ewl: /* When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) */ format fix</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
These instructions (and the additional notes at http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
<br />
You milleage may vary but if this doesn't work, consider looking at this link<br />
http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper<br />
<br />
i may add that i couldn't install the last svg plugin due to dependencies errors<br />
<br />
===== confirmed more easy install within Kubuntu 6.10 =====<br />
<br />
All the above required pakages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After adding the multiverse and universe add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-java</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
The link to the script will only work if you unzip FreeMind in a directory for which <code>freemind.sh</code> is searching. You can however install FreeMind in any directory (e.g. in <code>/opt/FreeMind</code>) if in <code>freemind.sh</code> you replace<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
by<br />
if [ ! -n "${freepath}" ]<br />
then<br />
freepath=$(dirname "$0")<br />
freepath="${freepath%/bin}" # nothing happens if freemind is not installed<br />
# under something/bin<br />
fi<br />
and then set <code>$freepath</code> in <code>/etc/freemind/freemind.rc</code> resp. <code>~/.freemind.freemindrc</code> like this:<br />
# settings for freemind<br />
#<br />
# path to the installation of freemind<br />
freepath="/opt/freemind/"<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome.<br />
<br />
; Hint<nowiki>:</nowiki> : Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:<br />
<br />
# open FreeMind on Beryl Window Manager<br />
# set Kwin (KDE Window manager) as actual Window manager<br />
# select back Beryl Window manager - resizing works now!<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Development&diff=4599
Development
2007-05-01T12:19:11Z
<p>Ewl: /* Alpha, Beta and Release Candidate */ some more from mail to developers</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;<br />
<td width=600><br />
<br />
<b>The development</b> of FreeMind is coordinated using FreeMind's [http://sourceforge.net/projects/freemind/ project page] at SourceForge, and also using this wiki. At wiki, we have '''[[requests for enhancements]]''' page; there is also [http://sourceforge.net/tracker/?group_id=7118&atid=357118 requests for enhancements] (RFEs) page at SourceForge (not preferred). You can [http://freemind.cvs.sourceforge.net/freemind/ browse CVS repository].<br />
<br />
We also use SourceForge for [http://sourceforge.net/tracker/?group_id=7118&atid=107118 bugs], and [http://sourceforge.net/forum/forum.php?forum_id=22101 open discussion forum]. We do not use the documentation part there as we use this wiki instead.<br />
<br />
== Getting started as a developer or tester ==<br />
<br />
=== To get the latest beta version of FreeMind ===<br />
<br />
You can get the beta version from the CVS. Look under branches. Observe, that these versions are not official releases<br />
and may admit serious errors. Please, use them only if you urgently need a feature included in such a version<br />
or to give us feedback to our development which is highly appreciated.<br />
<br />
=== To compile FreeMind on your own ===<br />
<br />
If you are a developer, just download the sources, unpack them,<br />
find the folder with the file build.xml, and execute the command<br />
<code>ant</code> in that folder. For more detail description <br />
see the [http://freemind.sourceforge.net/docs/compile/windows/Quick%20guide%20to%20compiling%20Freemind%20on%20an%20XP%20system.html Quick guide to compiling Freemind on an XP system using Eclipse] prepared for you by Bob Alexander.<br />
<br />
Broken down into simple steps, a simple way for a developer of compiling FreeMind is perhaps the following.<br />
<br />
# install [http://java.sun.com/javase/downloads/index.html Java SDK] &mdash; standard development kit<br />
# install [http://ant.apache.org/ Ant] &mdash; a tool for building code using complicated make files)<br />
# download FreeMind's [http://sourceforge.net/project/showfiles.php?group_id=7118 source code] as published in the Files section<br />
# unpack the source code package with the extension <code>tar.gz</code><br />
# change directory to the one where <code>built.xml</code> file resides &mdash; the build file for Ant, similar to make files for the C language<br />
# type <code>ant</code> in the command shell<br />
<br />
=== To set up a FreeMind project under Eclipse ===<br />
<br />
You download FreeMind to ~/src/freemind say. <br />
Then, you have to compile FreeMind on command line using "ant dist". <br />
After that you open a new project with working directory ~/src you should find the following settings:<br />
<br />
* The binaries are stored into ~/src/bin/classes.<br />
* You have two source folders.<br />
* All jars you find in ~/src/freemind are added to the project.<br />
<br />
Then finish the project settings and there should be no errors in the project. You can run FreeMind starting the class <code java>freemind.main.FreeMind</code>.<br />
<br />
=== Further development wiki pages ===<br />
<br />
Further reading (still under construction):<br />
<br />
* [[FreeMind Actions]]<br />
* [[Plugins]]<br />
* [[Undoable Actions]] (first version available)<br />
<br />
=== To use concurrent version repository (CVS) with Eclipse ===<br />
<br />
See [http://freemind.sourceforge.net/docs/Using%20CVS%20via%20Eclipse/index.html Using CVS from within Eclipse] guide by Bob Alexander.<br />
<br />
When working with CVS, remember that it is difficult to change directory and file names under CVS. Moreover, it not easy to remove files completely. Therefore, pay attention when checking files in.<br />
<br />
=== Contributing to the FreeMind ===<br />
<br />
There are different possible ways of taking part in the FreeMind development: the project needs people for developing, testing and documenting of the program, and translating its interface and documentation in foreign languages. <br />
<br />
New developer starts by sending his contributions for example as patches. Later on, he may get access to CVS repository. The process is approximately as follows.<br />
<br />
* Create a user account at SourceForge. <br />
* Discuss your contribution (the change, feature, bug fix, documentation or test plan) in our [http://sourceforge.net/forum/forum.php?forum_id=22101 open discussion forum]. <br />
* If the topic is accepted, start to change the actual CVS code. Be careful to use the right CVS branch. Currently we use the branch with a strange name "fm_060405_integration". <br />
* For later merging of the code it could be better if you start from code state already labeled by a tag, e.g. "fm_0_9_0_beta9".<br />
* If you have any questions during the implementing feel free to ask them in the "Open Discussion" forum. It is read by the other developers who possible can help you.<br />
* Post your contribution in the patch section of SourceForge or send it by email to the current project manager. We do not respond immediately, as FreeMind team consists of volunteers.<br />
* After having successfully developed and integrated some items, you get access to FreeMind's CVS repository at SourceForge.<br />
<br />
=== Development resources ===<br />
<br />
* [http://freemind.sourceforge.net/javadoc/index.html API documentation] (javadoc)<br />
* [http://freemind.sourceforge.net/Freemind-development.html Obsolete development mind map]<br />
* [http://freemind.sourceforge.net/Freemind-development.mm Obsolete development mind map for download]<br />
* [http://freemind.sourceforge.net/Freemind-development-exported.html Obsolete development mind map exported to HTML with folding]<br />
<br />
=== Getting the latest CVS branch ===<br />
<br />
The latest integration branch is ''fm_060405_integration''. The last release has tag ''FM-0-8-0''.<br />
<br />
== How the FreeMind development is organized ==<br />
<br />
Initially every active developer works on his own branch. Our intermediate results are<br />
published as our "alpha versions". We use forum [http://sourceforge.net/forum/forum.php?forum_id=22101 Open Discussion] and section [[Experimental_versions]] on this wiki page to communicate them.<br />
<br />
Only after this partial developments are finished, they can me merged together.<br />
The resulting version is expected to work with all maps created by all versions,<br />
which are merged into it, but we can not assure it in any particular case.<br />
<br />
The merged versions are published as Release Candidates and are released.<br />
<br />
An alternative to this development scheme would be not to publish the<br />
intermediate versions, and I think the current method is probably a better one.<br />
<br />
=== Experimental versions ===<br />
<br />
Currently, there are the following experimental versions available. They are not meant for productive use; use at your own risk!<br />
<br />
==== FreeMind with Node Attributes and Map Filters ====<br />
Attaching of named attributes to every node, filtering of the displayed map content based on node text, node icons and node attributes<br />
* [http://sourceforge.net/forum/forum.php?thread_id=1454779&forum_id=22101 Actual discussion forum thread]<br />
* [http://sourceforge.net/forum/forum.php?thread_id=1272052&forum_id=22101 Old discussion forum thread]<br />
* [http://freemind.sourceforge.net/dimitri_testversions/0_8_FA/ Screenshots and Downloads]<br />
<br />
==== FreeMind with WYSIWYG rich text node editor ====<br />
* [http://sourceforge.net/forum/forum.php?thread_id=1425434&forum_id=22101 Discussion forum thread]<br />
* [http://freemind.sourceforge.net/dan_test_versions/ Downloads]<br />
<br />
==== FreeMind Browser Applet for FreeMind 0.8 ====<br />
* [http://sourceforge.net/forum/forum.php?thread_id=1420558&forum_id=22101 Discussion forum thread]<br />
* [http://freemind.sourceforge.net/testversions/ Downloads]<br />
<br />
=== Alpha, Beta and Release Candidate ===<br />
<br />
I propose the following definitions of labels alpha, beta, and release candidate.<br />
<br />
* ''Alpha'' is a purely test version. Absolutely no guarantee is made on how it's going to work, keep data format of FreeMind mind maps, and the like. One alpha version may have other features and file format than another one, as each developer with source access may create his/her own Alpha version. Users of alpha are people who want to help in the development process of FreeMind by reporting bugs in early unstable versions, or who want to influence in which direction the alpha will be finetuned. <br />
* ''Beta'' is a version with known old and newly introduced bugs, with many fixes pending and possibly smaller enhancements. Maps saved from betas should ideally be readable by later versions. Thus, allocating label beta requires considerable attention.<br />
* ''Release Candidate'' is a version in which there are neither errors nor changes pending that the developers would know of at the date of publishing. After RC1, packagers and translators are called to do their work for the final release. Only changes required to fix critical bugs are acceptable; those fixes should avoid changes impacting translation or packaging efforts.<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 04:49, 29 Apr 2006 (PDT) <br /><br />
-- [[User:Ewl|Ewl]] 05:19, 1 May 2007 (PDT)<br />
<br />
== Conceptual remarks ==<br />
<br />
=== Modular model - view design ===<br />
<br />
The architecture of FreeMind makes it possible that FreeMind becomes general tool for editing tree-structured data, that is mind maps, XML/HTML documents, folder trees etc. in future. <br />
<br />
All these kinds of data would be presented to the user as a mind map. Model-View-Controller design makes it possible for you only to write so called model of the data structure, without caring for the visual representation. Currently, mind map mode and file mode are implemented.<br />
<br />
=== Original vision of Joerg Mueller ===<br />
<br />
Joerg Muller is the original author of FreeMind, developing it up to the version 0.4.0. Here follows what he's got to say on his original vision:<br />
<br />
: What I had in mind when I began to write FreeMind, was creating a collaborative mind where people can intuitively share their ideas, knowledge and thoughts with each other. Of course FreeMind is only a first step into this direction, but I did this first step. Now a Mode must be implemented that makes collaboration over the Internet possible, maybe using the Topic-Map standard. I think linear text is a very poor way of representing knowledge, and by using trees and networks, visual representation, internet collaboration and open source we should be able to create some kind of a collaborative mind. <br />
<br />
: FreeMind now has evolved from a specific Mind Map Editor to a generic editor for tree structured data. I want FreeMind to become for tree structured data what emacs is for linear data (ie. text). <br />
<br />
One may think of extending FreeMind to work with networks as opposed to trees only, an example of this being Topic Maps (ISO). <br />
<br />
Daniel Polansky: Joerg's vision of FreeMind becoming Emacs for tree data is intriguing, but rather far fetched at the time. You would need to provide scripting facility and at least many basic operations, like upcase, downcase, replace and many others. It is even not evident that this goal valuable compared to other goals - there many quite obvious and still missing features.<br />
<br />
=== Why not use OPML for storage instead of FreeMind's native XML format ===<br />
<br />
The current version of [http://www.opml.org/ OPML] is not suited for our purposes. It should be easy to create conversion XSLT between FreeMind and OPML. First, if we decided to use OPML, we would have to wait until the owner of OPML changes his standard to fit our needs. Thus, we would be dependent, not being able to act dynamically. Second, already the current version of OPML is insufficient. It does not contain most of what FreeMind already uses: colors, fonts, folded tag, edges and icons. It is not a superset of FreeMind's XML format, even not in a vague sense. Even if I renamed the elements names properly, OPML would still be a subset and not superset of FreeMind's XML. As a result, we have no benefit from using OPML right now. <br />
<br />
''Summary:'' 1) we would run into dependence, and 2) OPML is insufficient, loosely speaking it is a subset.<br />
<br />
=== Why may FreeMind be more relevant than some other open source applications ===<br />
<br />
There are many efforts to create new text editors, text processor and the like. While this activity is not without value, it does not fill that big value gap as mind mapping application. <br />
<br />
Take, for instance, text editors like JEdit. There are already well estabilished text editors like Emacs or Vim, and there are many others. It's not that these editors would be perfect, far from that, but they're still pretty useful and with some training users can become very efficient with them. <br />
<br />
With text processors, the thing is that most users in companies have already Microsoft Office for free. What does that mean? That means that the individual users do not have to pay for the MS Office, and they cannot effectively decide to use other Office platform either because of the value of easy sharing. Furthermore, there are competing free Office platforms like KOffice, OpenOffice or AbiWord. <br />
<br />
In mind mapping, the situation is quite different. You do not get commercial alternative granted in companies, unlike office applications. The point here is that most of MS Windows users, the mainstream, do not have a mind mapping application yet. For them, starting to use FreeMind is not a switch from Microsoft product to alternative product. It is a switch from scattered documents in incomparable and hard-to-overview formats to one document with unprecedented order and transparency - FreeMind's mind map. <br />
<br />
Therefore, I am expecting a growth of interest of free developers in developing and using this application. <br />
<br />
Furthermore, even though Java is quite slow and memory hungry, it solves the neverending quarrel between religious die-hard fans of different computing platforms, which I have first experienced with Atari 800 XL versus Commodore 64 battle, later IBM compatible versus Commodore Amiga battle, and nowadays Windows versus Linux battles.<br />
<br />
== Misc ==<br />
<br />
=== To create a new release ===<br />
<br />
To succesfully complete a new release, do the following<br />
<br />
* upload the release files into /incoming at ftp:upload.sourceforge.net , use the user anonymous and your e-mail address as a password <br />
* create new release. The files you have uploaded with ftp will be offered to you. Releases have names like "0.6.1", "0.6.5". <br />
* update the home page so that it points to the new version of installation files <br />
* post news, listing the most important changes of the new version <br />
* repost the news to the Announce forum, with basically the same text <br />
* repost the news the mailing list freemind-users@lists.sourceforge.net <br />
<br />
Notice that the news cannot be monitored unlike forum, and forum has no RSS<br />
feed unlike news.<br />
<br />
=== To create proper copyright notice ===<br />
<br />
A source file may be viewed as a sum ''b'' + ''d<sub>1</sub>'' + ''d<sub>2</sub>'' + ... + ''d<sub>k</sub>'', where ''b'' is the basis, ''d<sub>i</sub>'' are deltas (or patches), and the plus operator is the operator of applying a patch. The basis and each delta have their own copyright holder and the year of copyright.<br />
<br />
If there is only one autor and one year, then the copyright notice is simple.<br />
<br />
If there is only one autor and more years, then the copyright notice may look like<br />
<br />
<blockquote><br />
Copyright © 2003-2005 Big Author<br />
</blockquote><br />
<br />
which is to be understood as<br />
<br />
<blockquote><br />
Some parts of the sum are copyrighted in 2003, some perhaps in 2004, and some certainly in 2005.<br />
</blockquote><br />
<br />
If there are more authors, then the copyright notice consists of more lines, like<br />
<br />
<blockquote><br />
Copyright © 2003-2005 Big Author, <br><br />
Copyright © 2005 Captain, <br />
</blockquote><br />
<br />
Not all changes are eligible for copyright. If a change is small, then it does not make sense to add a line to the copyright notice for it.<br />
<br />
Copyright notice is not required for copyright to hold. It makes claiming your right at court easier.<br />
<br />
The correctness of these instructions is not granted. They are subject to improvement as we see fit.<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 11:29, 3 Jun 2005 (PDT)<br />
<br />
=== All on keyboard mappings ===<br />
<br />
Currently, each function has at most one key assigned. But, it should be the other way around;<br />
the keys should have functions assigned, rather than functions key. For instance, it would be<br />
valuable to have both ''insert'' and ''tab'' assigned to ''new node'' function. (Actually on MS Windows it is right now not possible at all to bind anything to ''tab''.)<br />
<br />
=== To translate FreeMind into your language ===<br />
<br />
Look for a translation into your language present in the development [http://cvs.sourceforge.net/viewcvs.py/freemind/freemind/?only_with_tag=fm_041017_base_integration branch]. <br />
If such a translation isn't present, take [http://freemind.cvs.sourceforge.net/freemind/freemind/Resources_en.properties?view=log the latest revision of Resources_en.properties]. Translate the labels in the text at the right side from = to your language. <br />
<br />
You can directly create and edit any java property file in any language using [http://propedit.sourceforge.jp/index_en.html propedit].<br />
<br />
: This editor can directly edit property files written in Unicode reference characters, and saves the time and effort of converting into Unicode through native2ascii. In addition to the usual functions of an editor, the plugin is integrated with Eclipse and JBuilder. Files can be opened in the IDE and saved in Unicode. It can use by intuitive and simple operation. For details, see [http://sourceforge.jp/projects/propedit Propedit].<br />
<br />
Another interesting tool to manage language property files is [http://popeye.sourceforge.net/ popeye]. Popeye can deal with several language property files at the same time so you can contrast the original property file data with their translations. Also, the program can highlight all properties that do not have a translation set in one of the selected languages.<br />
<br />
Alternatively you can save your property file in UTF-8 encoding; this is possible e.g. using Microsoft Notepad. After that convert the file into \uXXXX Unicode escape notation, using [http://java.sun.com/j2se/1.3/docs/tooldocs/win32/native2ascii.html native2ascii] tool included with the Java SDK. Example of use (Resources_cs.properties.txt is before conversion):<br />
<br />
cd C:\j2sdk1.4.2\bin><br />
native2ascii.exe -encoding UTF8 Resources_cs.properties.utf8.txt Resources_cs.properties<br />
<br />
Ideally, your file's name will be ''Resources_xx.properties'', where ''xx'' is the code of the language (e.g. en, de, dk etc.). [http://sourceforge.net/tracker/?group_id=7118&atid=307118 Send your translation as a patch] afterwards.<br />
<br />
To convert \uXXXX Unicode encoded file back to UTF-8, use a command similar to the following.<br />
<br />
cd C:\j2sdk1.4.2\bin><br />
native2ascii.exe '''-reverse''' -encoding UTF8 Resources_cs.properties Resources_cs.properties.utf8.txt<br />
<br />
Currently, we have the following languages translated.<br />
{| border="1" cellspacing="0" cellpadding="2"<br />
! colspan="7" style="background:#fff8f0;" | Already Translated Languages<br />
|-------------------------------------------------<br />
! | Language || Language || Short || If released || Translator || Reviewer || Capitalized Titles<br />
|-----------------------------------------------------------------<br />
| Czech || Česky || cs || not released || Radek Švarz || Daniel Polansky ||No<br />
|-----------------------------------------------------------------<br />
| Chinese || trad.chinese || zh|| [http://sourceforge.net/tracker/index.php?func=detail&aid=1179121&group_id=7118&atid=307118 released] || [http://java.fromtw.com william chen] || &nbsp; || &nbsp;<br />
|-----------------------------------------------------------------<br />
| Chinese || simp.chinese || zh_CN|| [http://sourceforge.net/tracker/index.php?func=detail&aid=1179573&group_id=7118&atid=307118 not released] || [http://java.fromtw.com william chen] || &nbsp; || &nbsp;<br />
|-----------------------------------------------------------------<br />
| Danish || Dansk || dk || released || || || <br />
|-----------------------------------------------------------------<br />
| Dutch || Nederlands || nl || [http://sourceforge.net/tracker/index.php?func=detail&aid=1157653&group_id=7118&atid=307118 released] || Koen Roggemans || ||No<br />
|-----------------------------------------------------------------<br />
| English || English || en || released || N/A || || Yes<br />
|-----------------------------------------------------------------<br />
| Finnish || Suomi || fi || not released || Matti Lassila || ||<br />
|-----------------------------------------------------------------<br />
| French || Francais || fr || released || || ||<br />
|-----------------------------------------------------------------<br />
| German || Deutsch || de || released || Christian Foltin || ||<br />
|-----------------------------------------------------------------<br />
| Hungarian || || ? || not released || [http://documan.sourceforge.net/ documan] || ||<br />
|-----------------------------------------------------------------<br />
| Italian || Italiano || it || released || Bob Alexander || ||<br />
|-----------------------------------------------------------------<br />
| Japanese || Nihongo || ja || released || Kohichi Aoki || ||<br />
|-----------------------------------------------------------------<br />
| Korean || Hangeul || kr || [http://sourceforge.net/tracker/index.php?func=detail&aid=1236421&group_id=7118&atid=307118 released(rc5)] || Kim Jong Woo || ||<br />
|-----------------------------------------------------------------<br />
| Polish || Polski || pl || not released || Rafal Kraik || || No<br />
|-----------------------------------------------------------------<br />
| Portuguese || Português || pt || not released || Luis Ferreira || ||<br />
|-----------------------------------------------------------------<br />
| Russian || Pусский || ru || not released || Prokudin Alexander || ||<br />
|-----------------------------------------------------------------<br />
| Slovenian || || sl || released || Martin Srebotnjak - filmsi || || No?<br />
|-----------------------------------------------------------------<br />
| Spanish || Espanol || es || released || Hugo Gayosso || || Yes<br />
|-----------------------------------------------------------------<br />
| Turkish || Türkçe || tr || [https://sourceforge.net/tracker/download.php?group_id=7118&atid=307118&file_id=186544&aid=1530176 not released] || Uğur Çetin || || Yes<br />
|}<br />
<br />
To activate a new translation, follow the following steps:<br />
* write or download the Resources_xx.properties file;<br />
* unpack the freemind.jar file with 7-Zip or similar into a temp folder;<br />
* replace or add the Resources_xx.properties with the new one;<br />
* repack the freemind.jar with the modified content of the temp folder.<br />
<br />
=== To translate the wiki pages itself ===<br />
<br />
See [http://meta.wikimedia.org/wiki/Meta:Interlanguage_links] for a description of how to do that. We don't have such a page yet, so, please, be careful.<br />
<br />
=== FreeMind's xml data format (.mm) ===<br />
<br />
FreeMind stores his data in own XML flavor. Up to FreeMind 0.6.5, the xml format has been unchanged. The list of elements and their attributes as of FreeMind 0.7.1 follows.<br />
<br />
* '''map''' (root element)<br />
** version (0.7.1)<br />
* '''node''' (parent element: node, map)<br />
** id (0.7.1)<br />
** text<br />
** link<br />
** folded<br />
** color<br />
** position (left or right, only for children of the root) (0.7.1)<br />
* '''edge''' (parent element: node)<br />
** style<br />
** color<br />
** width<br />
* '''font''' (parent element: node)<br />
** name<br />
** size<br />
** bold<br />
** italic<br />
* '''icon''' (parent element: node) (0.6.7)<br />
** builtin<br />
* '''cloud''' (parent element: node) (0.7.1)<br />
** color<br />
* '''arrowlink''' (parent element: node) (0.7.1)<br />
** color<br />
** destination (id of the target node)<br />
** startarrow (arrow style)<br />
** endarrow (arrow style)<br />
<br />
The actual W3C schema can be found under <br />
[[http://cvs.sourceforge.net/viewcvs.py/freemind/freemind/Attic/freemind.xsd?rev=1.1.2.1&only_with_tag=fm_041017_base_integration&view=log]].<br />
<br />
=== Libraries and tools used in FreeMind ===<br />
<br />
* [http://nanoxml.cyberelf.be/ NanoXML]<br />
<br />
=== Sources of free icons ===<br />
<br />
FreeMind uses (a) tool icons used in the toolbars, and (b) icons used in nodes. Especially for the icons used in nodes, a good comprehensive source of free icons is needed. FreeMind uses PNG icons, in the size of 16 x 16. Nowadays many icons are drawn in SVG vector format first, and converted to 16 x 16 bitmap images afterwards. <br />
<br />
Ideally, it would not be the task of FreeMind team to draw icons; this task should be outsourced instead. Whether this is a realistic assumption remains to be seen.<br />
<br />
Some links on the sources of free icons follow.<br />
<br />
* [http://www.kde-look.org/index.php?xcontentmode=22x27 Icons at kde-look]<br />
* [http://www.gnome-look.org/index.php?xcontentmode=120 Icons at gnome-look]<br />
* [http://www.everaldo.com/crystal.html Crystal icons] &mdash; an icon set often used in KDE desktop environment<br />
* [http://tango-project.org/Tango_Desktop_Project Tango Desktop Project] &mdash; an icon library for KDE and Gnome, licenced under Creative Commons Attribution Sharealike<br />
* [http://www.famfamfam.com/lab/icons/silk/ Silk icons] &mdash; 1000 icons licenced under Creative Commons attribution license<br />
* [http://www.openclipart.org/ Open Clip Art Library] &mdash; a library used for some Mediawiki icons, mostly not suitable as a source of icons but rather as of clipart<br />
* [http://commons.wikimedia.org/wiki/Category:PD_OpenClipart Open Clipart at Wikimedia commons]<br />
<br />
<br />
More relevant links<br />
<br />
* [http://jimmac.musichall.cz/icons.php Icons by Jimmac]<br />
<br />
== Implementation ==<br />
<br />
=== Menu Label Checklist ===<br />
{| border="1" cellspacing="0" cellpadding="2"<br />
! colspan="1" style="background:#fff8f0;" | Menu Label Checklist || Poor || Good<br />
|------------------------------------------------------------------------------------------------------<br />
| In English, use capitalized labels || Move to root || Move to Root<br />
|------------------------------------------------------------------------------------------------------<br />
| Menu items leading to a dialog should end with ... . || Open <br> Close ... || Open... <br> Close<br />
|------------------------------------------------------------------------------------------------------<br />
| Do not repeat the verb already used in the menu heading || Export > Export to PNG <br> Insert > Insert Hyperlink || Export > As PNG <br> Insert > Hyperlink<br />
|}<br />
<br />
=== To implement embedded images ===<br />
<br />
To implement embedded images, one would store binary data in a node, like &lt;node TYPE="image" BINARY="x4543edvc...45ert"/&gt;<br />
Upon opening the node for viewing, temporary file would be created and HTML viewer would point to that file. Upon editing,<br />
external image editor would be opened to edit the temporary file, like Gimp.<br />
<br />
=== Improved HTML editing ===<br />
<br />
FreeMind's long node may contain HTML. However, it needs to be edited in its source text form. We can improve upon that by<br />
<br />
* providing WYSIWYG HTML editor embedded in FreeMind, like Java based [http://www.hexidec.com/ekit.php eKIT] ([http://sourceforge.net/projects/ekit/ project page] LGPL licence).<br />
<br />
* enabling using external WYISWYG editor for editing HTML, like Microsoft FrontPage. This editor would be automatically opened upon clicking an HTML node, displaying it in WYSIWYG way. It is not clear how to get the changed node back to FreeMind. One option is to generate a temporary file, passing it to the external editor upon calling. However, how does the external editor tell FreeMind that the editing has ended? Futhermore, should such editing be modal? How to ensure such a modality and not get locked in it when the external editor crashes?<br />
<br />
: There is already some work done on integration of the WYSIWYG HTML editor Kafenio into FreeMind. --[[User:Danielpolansky|Danielpolansky]] 10:51, 6 Mar 2005 (PST)<br />
<br />
==== Open Source WYSIWYG HTML editors in Java ====<br />
<br />
There are the following open source WYSIWYG HTML editors written in Java.<br />
<br />
* [http://www.hexidec.com/ekit.php eKit] &mdash; LGPL licenced<br />
* [http://editor.kafenio.org/ Kafenio] &mdash; LGPL licenced, developed as a fork of eKit<br />
* [http://www.lightdev.com/page/3.htm SimplyHTML] &mdash; GPL licenced<br />
<br />
=== Using HTML versus XHTML in rich text nodes ===<br />
<br />
What follows is a preliminary analysis of the issues concerning HTML versus XHTML used for rich text in FreeMind.<br />
<br />
AFAIK there are two separate questions: (1) should we store (a) HTML or (b) XHTML in nodes, and (2) should we (a) store only one thing or (b) store plain text in one attribute, and store HTML/XHTML in another attribute where HTML is available, modelling on email systems.<br />
<br />
As for the first question, using HTML has the advantage of being straightforward: it is supported by JLabel, it is supported by Java HTML editing component, and it is the format now mostly used in web pages. An advantage of XHTML is that it is a flavor of XML and thus easily amenable to XSLT processing.<br />
<br />
As for the second question, as soon as we would store also plain text, it would be automatically available to all XSLT processing, which would make the first question less decisive. However, it would considerably increase the size of mind maps stored on the disk, by my estimation by factor 1.5 as soon as a lot of rich text would be used.<br />
<br />
Performing transformations of HTML to XHTML on the fly before performing preprocessing from FreeMind would not really save the day, as XHTML would still need to be stored in mind maps on the disk; if we would use HTML internally, we would have to convert XHTML to HTML upon loading a new map for all nodes, instead of doing that only upon nodes being shown for the purpose of JLabel.<br />
<br />
If you find the other options more attractive, an important question is: is it really possible to process XHTML from within an XML attribute? Can someone demonstrate that? If yes, that would make XHTML rather attractive. But if not really, then using HTML would be as good as using XHTML.<br />
<br />
==== Converting HTML from node attribute TEXT to plain text within XSLT ====<br />
<br />
Converting HTML from node attribute TEXT to plain text within XSLT is virtually impossible. XSLT does not feature regular replaces, and it does not even feature simple text replaces (simple text replaces can be sort of [http://aspn.activestate.com/ASPN/Cookbook/XSLT/Recipe/65426 implemented within XSLT] though). My old view on this option follows.<br />
<br />
: I estimate that the most straightforward way of solving the related problems is to find out how to convert HTML into plain text within XSLT script. I currently do not have a sufficient knowledge of XSLT to judge on that; it should be possible using several regular expression replacements, modelled on what we already have in FreeMind in Java. As soon as we would be able to do that, there might even be a regular expression way to covert boldface and italics to open document format of OpenOffice. Admittedly, instead of having one conversion routine from HTML to plain text in FreeMind, it would have to be replicated in every XSLT script dealing with FreeMind mind maps.<br />
<br />
==== Storing XHTML on par with FreeMind XML ====<br />
<br />
The option of storing XHTML elements on par with FreeMind XML elements like <node> would require a considerable effort. The benefits of the effort would include<br />
<br />
* + better support for XSLT transformations<br />
* + more readable XML of FreeMind mind maps<br />
<br />
The costs would include<br />
<br />
* - switching away from [http://nanoxml.cyberelf.be/ NanoXML/Lite] to a more bloated technology for reading and saving of mind maps, meaning considerable slowing down upon loading and saving of mind maps. (That is not true; I was wrong. We would only have to adjust NanoXML so that it stops parsing XML within certain elements and reads everything within them as uninterpreted string instead. --[[User:Danielpolansky|Danielpolansky]] 06:34, 13 May 2006 (PDT))<br />
<br />
By storing on par, I mean the following.<br />
<br />
<pre><br />
<map><br />
<node><br />
<html><br />
<body>Hello </br> Dolly.</body><br />
</html><br />
</node><br />
</map><br />
</pre><br />
<br />
I recommend to avoid this option. Out current option is<br />
<br />
<pre><br />
<map><br />
<node TEXT="& lt ; HTML & gt ; Hello & lt ; br & gt ; Dolly."/><br />
</map><br />
</pre><br />
<br />
A discussion shows the following possibilities of storing on par.<br />
<br />
# Storing HTML directly like <code>< node >< html ></ html ></ node ></code><br />
# Storing HTML within '''content''' element like <code>< node >< content >< html >< /html ></ content ></ node ></code> and<br />
# Storing plain text within TEXT attribute of '''node''' element<br />
# Storing plain text as <code>< node >< text >Plain</ text ></ node ></code><br />
# Storing plain text as <code>< node >< content >Plain</ text ></ node ></code><br />
<br />
==== Converting HTML to XHTML in Java ====<br />
<br />
I find a conversion of HTML to XHTML possible with reasonable effort. I think there are not many more subtleties apart from those already addressed: closed tags < td >, < tr > and the like, closed tags < /br >, < /hr >, < img/ > and several others. We would be able to discover all the subtleties by reading XHTML standard and by empirical testing. (For reference, [http://www.shredzone.net/articles/java/html2xhtml/ html2xhtml at shredzone.net], thanks to Dimitri)<br />
<br />
However, W3C points out that converting HTML to XHTML is a tricky business.<br />
<br />
: The main problem of developing your own converter is that either you are sure your HTML is correct (and so you only need to fix cases, quotes in attributes, entitities and close the few HTML empty tags) or you will go crazy trying to cope with all the possible errors that the "official" web browsers accept but that would kill any simple parser.<br />
<br />
See also [http://www.javaworld.com/javaworld/jw-04-2006/jw-0410-html.html Convert HTML content to PDF format at JavaWorld] using [http://sourceforge.net/projects/jtidy/ JTidy].<br />
<br />
==== Converting XHTML to HTML in Java ====<br />
<br />
Searching the web using the expressions<br />
<br />
* "XHTML to HTML" java<br />
* XHTML2HTML java GPL<br />
* XHTML2HTML java<br />
<br />
I have found very little about already existing code for converting XHTML to HTML in Java, with GNU GPL licenced code. Thus, my recommendation is to create a new method for that, in the class Tools. The method would be created with the use of [1] as a checklist. The method would use regular expression replaces, unless we see that this is too slow, which I do not think will be the case. (We already use regular expression replaces in method <tt>update()</tt> of <tt>NodeView</tt>.)<br />
<br />
A preliminary code is as follows.<br />
<br />
<pre><br />
public String xhtmlToHtml(String xhtmlText) {<br />
//Remove '/' from <.../> of elements that do not have '/' there in HTML<br />
return xhtmlText.<br />
replaceAll("<(("+<br />
"br|area|base|basefont|"+<br />
"bgsound|button|col|colgroup|embed|hr"+<br />
"|img|input|isindex|keygen|link|meta"+<br />
"|object|plaintext|spacer|wbr"+<br />
")(\\s[^>]*)?)/>",<br />
"<$1>"));<br />
</pre><br />
<br />
See also<br />
<br />
# [http://www.stylusstudio.com/xsllist/200004/post10350.html Discussion on converting XHTML to HTML using XSLT] (can be checked against when developing conversion in Java)<br />
# [http://membres.lycos.fr/cvincent/xml/api/fr.bizolin.xml.XHTML2HTML.html XHTML2HTML in Java], albeit needing some Perl package which is difficult to understand. As old as of year 2000.<br />
<br />
==== Requirements on file format of FreeMind ====<br />
<br />
We have identified the following requirements on the format of FreeMind. These have different priority; people may disagree about what the priority of their requirements are.<br />
<br />
# guarantee file format integrity, i.e. XML conformance.<br />
# be flexible for new features like (x)html, svg, mathml,...<br />
# stay reasonably backwards compatible, so that all existing generators of FreeMind mind maps work with later versions of FreeMind too. Put differently, create new format only as an extension of the old format, that is by adding new elements and attributes only<br />
# new format should allow for import of all old format features (from stable versions).<br />
# limit redundancy of information.<br />
# keep it easy to do XSLT transformations.<br />
# keep the format as simple as possible.<br />
# make it easy to create and edit mm files manually in an editor like Vim, Emacs or Notepad.<br />
# make it easy to create mm files programmatically.<br />
# the solution should be fast.<br />
# the solution should be safe.<br />
# the file format of both notes and nodes should be XHTML (a further specification of the first requirement)<br />
<br />
For [[User:Danielpolansky|Danielpolansky]], the requirement on staying reasonably backwards compatible is important; the requirement on the solution to be fast too; the requirement on XSLT transformations is completely unimportant in view of the possibility of replacing XSLT transformations with small Java functions doing the same with less footprint; the requirement on keeping the format simple is important; the requirement on making it easy to create mind maps programatically is important.<br />
<br />
==== Sources of HTML coming to mind maps ====<br />
<br />
Rich text in the form of HTML will be coming into FreeMind from the following sources:<br />
<br />
* directly entered in FreeMind using WYSIWYG editor<br />
* pasted from web pages<br />
* pasted from Microsoft Word documents, and other applications exposing HTML to the clipboard<br />
<br />
To my experience, the pasting is much more usual and of higher volume than direct editing.<br />
<br />
==== See also ====<br />
<br />
* [http://en.wikipedia.org/wiki/Xhtml XHTML at Wikipedia]<br />
* [http://www.w3.org/TR/xhtml1/#diffs 4. Differences with HTML 4] of W3C XHTML 1.0 specification<br />
* [http://www.w3schools.com/xhtml/xhtml_html.asp Differences Between XHTML And HTML] at w3schools<br />
<br />
--[[User:Danielpolansky|Danielpolansky]] 03:29, 29 Apr 2006 (PDT)<br />
<br />
=== Rendering of HTML nodes is slow ===<br />
<br />
Rendering of quite long HTML nodes is slow. If you have a HTML page corresponding to ten paper pages, then the rendering of the node upon unfolding takes several seconds. The related code is in the method <code>update</code> of the class <code>NodeView</code>. What takes so long is the statement<br />
<br />
setText(nodeText);<br />
<br />
in the section<br />
<br />
if (nodeText.startsWith("<html>")) {<br />
// Make it possible to use relative img references in HTML using tag <base>.<br />
if (nodeText.indexOf("<img")>=0 && nodeText.indexOf("<base ") < 0 ) {<br />
try {<br />
nodeText = "<html><base href=\""+<br />
map.getModel().getURL()+"\">"+nodeText.substring(6); }<br />
catch (MalformedURLException e) {} }<br />
setText(nodeText);<br />
<br />
This result does not give us much hope of improving the speed easily, as the command just tells Java's JLabel to render the page. A solution would be to find a different HTML rendering Java component. We can also wait until Sun's Java virtual machine improves the speed of JLabel's HTML rendering.<br />
<br />
--<br />
What about pre-loading nodes which are likely to be expanded, using threading? Keep some relatively small cache of nodes in proximity to the last expanded node, and swap in the expanded node when the unexpanded one is clicked. No?<br />
<br />
=== To obtain focus for selected node in reliable manner ===<br />
<br />
Requesting focus for NodeView using requestFocus() method is unreliable. A reliable way of doing that has been implemented in the method <code>obtainFocusForSelected()</code> of Controller. A typical call in ControllerAdaper.java is <br />
<br />
getController().obtainFocusForSelected();<br />
<br />
Requesting focus using<br />
<br />
newSelected.requestFocus();<br />
<br />
where <code>newSelected</code> is a NodeView is unreliable, though most often works.<br />
<br />
=== To set the class load path in manifest.mf in jar ===<br />
<br />
In the source folder tree of FreeMind, there's a file MANIFEST.MF. This file tells what<br />
should happen with the freemind.jar when java tries to run the jar archive. The file<br />
may look like <br />
<br />
Manifest-Version: 1.0<br />
Main-Class: freemind.main.FreeMind<br />
Class-Path: silk.jar nanoxml.jar ekit.jar kafenio.jar<br />
kafenio-config.jar kafenio-icons.jar gnu-regexp-1.1.4.jar<br />
Created-By: Joerg Mueller<br />
<br />
A tricky thing about the file is that the length of the lines can be<br />
at most 72 characters. That creates difficulties when specifying Class-Path.<br />
In the exaple above, the first line of Class-Path is set in such a way<br />
that it has 70 chacters. That has been achieved by putting spaces before<br />
the actual list of classes. In the freemind.jar, the file can be found in the<br />
folder META-INF. Here you can check if the manifest has been created correctly.<br />
<br />
=== Deleting nodes and branches in FreeMind ===<br />
<br />
Since version 0.8.0, it is possible to delete a whole branch of nodes by pressing DELETE. When a user accidentally presses DELETE and does not notice that, they may loose considerable amount of data. For users using FreeMind as a knowledge base or a semi-structured database, being able to delete whole branch at one keystroke is problematic and unusual; in filesystem browsers, users are asked for confirmation before the file is deleted by the system.<br />
<br />
However, some users use FreeMind as a mind mapper and are glad to be able to delete nodes just by pressing DELETE.<br />
<br />
There are several solutions to this problem.<br />
<br />
* Add user option to enable or disable confirmation before deleting of nodes and branches (depending on model type)<br />
* Store all deleted nodes and branches in a kind of trashcan associated with every mind map<br />
* Ask for confirmation only for nodes with children<br />
* Ask for confirmation only for nodes with more than ''p'' children<br />
<br />
The confirmation would be requested both for keystrokes DELETE and CONTROL + X, that is the actions Delete and Cut.<br />
<br />
== More development pages ==<br />
<br />
=== Documentation efforts ===<br />
<br />
See [[documentation efforts]].<br />
Also, internals documentation at [[Under the covers]].<br />
<br />
=== Short patches ===<br />
<br />
See [[short patches]].<br />
<br />
=== Community development ===<br />
<br />
* [[XSLT Export to MSProject|XSLT export to MSProject 2003 XML format]]</div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=4534
FreeMind on Linux
2007-04-20T07:01:29Z
<p>Ewl: add 3D / GUI resize issue</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
These instructions (and the additional notes at http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
<br />
You milleage may vary but if this doesn't work, consider looking at this link<br />
http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper<br />
<br />
i may add that i couldn't install the last svg plugin due to dependencies errors<br />
<br />
===== confirmed more easy install within Kubuntu 6.10 =====<br />
<br />
All the above required pakages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After adding the multiverse and universe add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-java</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
=== When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness) ===<br />
<br />
If you're using a 3D desktop (like [http://compiz.org/ Compiz] or [http://www.beryl-project.org/ Beryl]), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome.<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=4516
FreeMind on Linux
2007-04-20T06:56:15Z
<p>Ewl: /* Troubleshooting */ add other Java application test</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
These instructions (and the additional notes at http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
<br />
You milleage may vary but if this doesn't work, consider looking at this link<br />
http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper<br />
<br />
i may add that i couldn't install the last svg plugin due to dependencies errors<br />
<br />
===== confirmed more easy install within Kubuntu 6.10 =====<br />
<br />
All the above required pakages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After adding the multiverse and universe add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-java</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* putting Linux in the subject helps spot the right messages,<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest [http://jedit.sf.net/ JEdit] because it uses the same graphical system "Swing")?<br />
* That should be all.<br />
</td></tr><br />
</table></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=4515
FreeMind on Linux
2007-04-15T13:53:30Z
<p>Ewl: /* Installing FreeMind under Debian */ correct use of unstable vs. experimental</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it could make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, <tt>unstable</tt> contains FreeMind 0.8.0 and dependencies, <tt>experimental</tt> contains betas of 0.9.0 (and dependencies).<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
These instructions (and the additional notes at http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
<br />
You milleage may vary but if this doesn't work, consider looking at this link<br />
http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper<br />
<br />
i may add that i couldn't install the last svg plugin due to dependencies errors<br />
<br />
===== confirmed more easy install within Kubuntu 6.10 =====<br />
<br />
All the above required pakages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After adding the multiverse and universe add the FreeMind-specific repositories:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ <version>/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ <version>/<br />
<br />
(where <tt>&lt;version&gt;</tt> is <tt>unstable</tt> or <tt>experimental</tt>), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-java</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* That should be all.<br />
</td></tr><br />
</table></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=FreeMind_on_Linux&diff=4399
FreeMind on Linux
2007-03-25T12:12:51Z
<p>Ewl: /* confirmed more easy install within Kubuntu 6.10 */ clarifications of installation</p>
<hr />
<div><table><tr><br />
<td valign=top><br />
{{Navigation_bar}}<br />
<td>&nbsp;</td><br />
<td><br />
<br />
== Installation (0.8.0) ==<br />
<br />
FreeMind is a Java program, hence you need Java to make it work. There is the &quot;''Java runtime engine''&quot; (<tt>JRE</tt> or <tt>J2RE</tt>) required to ''run'' (use, start) FreeMind, and there is the &quot;''Java Development Kit''&quot; (<tt>JDK</tt> or <tt>J2DK</tt>) if you want to ''compile'' FreeMind (If you don't know what ''compile'' means, then you need only the ''JRE''. In the following lines, I will concentrate on making FreeMind ''run'' and the JRE installation).<br />
<br />
Once Java has been installed, only ''then'' does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).<br />
<br />
=== The Debian installation ===<br />
<br />
This description should be valid for any Debian based distribution, in particular (K)ubuntu.<br />
<br />
; Note : FreeMind 0.8.0 is not part of the Debian repository, although FreeMind 0.7.1 is, because of a lot of additional dependencies, and some license issues. For all the gory details, have a look at [http://wiki.debian.org/Java/MoveToMain] from the Debian Wiki. We're working on it, but it will take time.<br />
<br />
==== Install Java the Debian way ====<br />
<br />
As Java isn't really free or open, there is no official Debian package for it.<br />
The procedure is hence to install <tt>java-package</tt> from the ''contrib'' section, e.g. as root with:<br />
<br />
# apt-get install java-package<br />
<br />
Read the instructions delivered with the package, and create your own little Java package(s).<br />
<br />
In a nutshell, download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file),<br />
called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_10-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin].<br />
Use the command from the java-package called <tt>make-jpkg</tt> along with fakeroot as in:<br />
<br />
$ fakeroot make-jpkg ''j2re-1_4_2_10-linux-i586.bin''<br />
<br />
noting that the filename depends on your version. When you have this, you can install the package as root:<br />
<br />
# dpkg -i ''sun-j2re1.4.deb''<br />
<br />
; Note : The package sun-j2re1.4debian is no longer needed since Sarge has been released.<br />
<br />
; Note : Sun, together with the communities (or the other way around) has released some "official" Java 1.5 packages. I didn't yet test anything, but you might want to have a try. Check the [http://packages.debian.org/unstable/source/sun-java5 Debian] and [http://packages.ubuntulinux.org/dapper/source/sun-java5 Ubuntu] package pages (don't install the source file though, but some of the binary ones). You're welcome to report your experience here...<br />
<br />
==== Installing FreeMind under Debian ====<br />
<br />
You can always download the required <tt>.deb</tt> files from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161831 Files section] and install them by hand, using <tt>dpkg</tt> or whatever, but the comfortable way is to add the following lines to your <tt>/etc/apt/sources.list</tt>:<br />
<br />
deb http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
deb-src http://eric.lavar.de/comp/linux/debian/ &lt;version&gt;/<br />
<br />
; Note : you need to replace <tt>&lt;version&gt;</tt> by either <tt>unstable</tt> or <tt>experimental</tt>: I use <tt>unstable</tt> for software for which I'm pretty sure it will make it into the official Debian repository, <tt>experimental</tt> for the rest. Currently, only <tt>experimental</tt> contains interesting things.<br />
<br />
Then call as root the two (or three) following commands:<br />
<br />
# apt-get update<br />
# apt-get install libbatik-java/testing libjcalendar-java/testing<br />
# apt-get install freemind/experimental freemind-plugins-svg/experimental \<br />
freemind-plugins-time/experimental freemind-plugins-help/experimental \<br />
libjgoodies-forms-java/testing<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .deb package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
# if you want to use the 'help' plugin, you'll need to download [http://java.sun.com/products/javahelp/ JavaHelp] from Sun's Java site and install the jar file as <tt>/usr/local/share/java/jhall.jar</tt>.<br />
# the 2nd line is only required if you're using "sarge" and want to install <tt>freemind-plugins-svg</tt> (Batik) respectively <tt>freemind-plugins-time</tt> (JCalendar). For this command to work, you need of course to make sure that the proper repositories have been entered in <tt>/etc/apt/sources.list</tt>, like in:<br />
<br />
deb http://ftp.XX.debian.org/debian testing main contrib non-free<br />
deb-src http://ftp.XX.debian.org/debian testing main contrib non-free<br />
<br />
; Note : ''XX'' has to be replaced with the nearest country code (e.g. ''de'' for Deutschland, ''fr'' for France,...; check the [http://ftp.debian.org/debian/README.mirrors.html Debian worldwide mirror sites] list).<br />
<br />
; Note : <tt>libforms-java</tt> has been recently replaced through <tt>libjgoodies-forms-java</tt> and is now part of Debian etch/testing.<br />
<br />
==== Ubuntu & Kubuntu ====<br />
<br />
These instructions (and the additional notes at http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper) are also known to work on Ubuntu 6.10 (EdgyEft). See the [[Talk:FreeMind_on_Linux|Talk Page]].<br />
<br />
I got my hand on a Kubuntu 5.10 installation, and am now able to give some hints about the specificas of the (K)Ubuntu installation:<br />
# you will first need to add the <tt>multiverse</tt> and <tt>universe</tt> repositories to your installation, there are plenty of places which explain how to do this.<br />
# then, if you're happy with Blackdown's Java 1.4, you don't need to create your own Java package and can install <tt>j2re1.4</tt> from the <tt>multiverse</tt> repository.<br />
# sadly, <tt>libbatik-java</tt> and <tt>libjgoodies-forms-java</tt> don't seem to be part of any repository; so, you should add the Debian repository as described in the above notes, but be careful to not break your installation with too many pure Debian packages. I personally added the following lines to the file <tt>/etc/apt/preferences</tt>:<br />
<br />
Package: *<br />
Pin: release o=Debian<br />
Pin-Priority: 200<br />
<br />
<br />
You milleage may vary but if this doesn't work, consider looking at this link<br />
http://blog.siliconchaos.net/articles/2006/05/22/setting-up-freemind-in-ubuntu-dapper<br />
<br />
i may add that i couldn't install the last svg plugin due to dependencies errors<br />
<br />
===== confirmed more easy install within Kubuntu 6.10 =====<br />
<br />
All the above required pakages can be installed more easily within Kubuntu 6.10, even without installing a new java RE. I used the previous installed sun java 6 jdk (Freemind 0.8 gives a error message at start, that it might not run correctly, but it does afterwards). Notice that FreeMind 0.8.0 doesn't support Java 6 (FreeMind 0.9.0 will) and issues have been reported; use <tt>apt-get install sun-java5-jre</tt> if you want to be sure.<br />
<br />
After adding the multiverse, universe and FreeMind-specific repositories (eric.lavar.de..., if not already done), <tt>apt-get install freemind</tt> (plus plugins packages if needed) seems to work without adding further Debian repositories.<br />
<br />
=== The RPM installation ===<br />
<br />
Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards [http://jpackage.org/ JPackage] compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.<br />
<br />
==== Install Java the JPackage way ====<br />
<br />
FreeMind only works with Sun's or Blackdown's Java.<br />
<br />
Taking the example of Sun's Java, there are three possibilities to install Java:<br />
<br />
# It already does come with your distribution, fine, nothing to do, but '''make sure it's really Sun's Java''' by checking the output of <tt>java -version</tt>.<br />
# Install [http://jpackage.org/rpm.php?id=2952 java-1.4.2-sun-compat] or [http://jpackage.org/rpm.php?id=3320 java-1.5.0-sun-compat] on top of Sun's JDK<br />
# Download [http://jpackage.org/rpm.php?id=3032 java-1.4.2-sun] or [http://jpackage.org/rpm.php?id=3033 java-1.5.0-sun], [http://jpackage.org/rebuilding.php build them] and install the created packages.<br />
<br />
==== Install JavaHelp2 the JPackage way ====<br />
<br />
If you want to install <tt>freemind-plugins-help</tt>, you'll need to install [http://java.sun.com/products/javahelp/ JavaHelp2]. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:<br />
<br />
# [http://jpackage.org/rpm.php?id=1476 download]<br />
# [http://jpackage.org/rebuilding.php build]<br />
# and install the created RPM file.<br />
<br />
==== Install FreeMind with RPM, the stupid and easy way ;-) ====<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-java</tt>.<br />
<br />
Download all the RPMs from the [http://sourceforge.net/project/showfiles.php?group_id=7118&package_id=161830 Files section] (don't forget <tt>jcalendar</tt> and <tt>jgoodies-forms</tt>) in a directory. Install all these RPMs using the <tt>rpm</tt> command, e.g.:<br />
<br />
# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm<br />
<br />
For each missing dependency, go to the [http://jpackage.org/ JPackage site], search and download the package(s) using the same kind of <tt>rpm</tt> command. Here is a list of dependencies:<br />
<br />
* freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec<br />
* freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis<br />
* freemind-plugins-help: javahelp2<br />
* freemind-plugins-time: jcalendar >= 1.2.2<br />
<br />
; Note : search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [http://eric.lavar.de/comp/linux/rpm/noarch/SRPMS.java/].<br />
<br />
==== Install FreeMind using <tt>apt4rpm</tt> ====<br />
<br />
''method tested with SuSE 10.1'' - work in progress<br />
<br />
* download and install the <tt>install-apt4suse</tt> package as described under http://susewiki.org/index.php?title=Install-apt4suse (for even more info check [http://linux01.gwdg.de/apt4rpm/ Apt4SuSE]). Just ignore the warnings, download and install, that's all:<br />
$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm<br />
(become root)<br />
# rpm -Uvh install-apt4suse.rpm<br />
* call as root the <tt>install-apt4suse</tt> script (wait a while). Slightly unrelated: missing key has to be loaded usng <tt>rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key</tt><br />
* add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm ''and'' gpg!)<br />
* add eric.lavar.de etc... and the rest same as below<br />
* apt-get update<br />
* download and build javahelp2: apt source javahelp2 + download from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=javahelp-2_0_02-oth-JPR&SiteId=JSC&TransactionId=noreg Sun], then install with rpm.<br />
* apt install freemind\*<br />
<br />
''method tested with SuSE 9.2''<br />
<br />
It sounds easy but actually the first step can be a bit tricky: you first need to setup <tt>apt4rpm</tt>, as described following the links given in this [https://www.jpackage.org/apt.php Jpackage Repository page]. The good news is that always more distribution are coming standard with <tt>apt</tt> on board (if you are able to call <tt>apt-get</tt> as root, you already have it).<br />
<br />
Add the JPackage repository to your <tt>/etc/apt/sources.list</tt> file as described in the same above page. Add also the two following lines (the 2<sup>nd</sup> one is optional, for sources) to the same file:<br />
<br />
rpm http://eric.lavar.de/comp/linux/rpm noarch java<br />
rpm-src http://eric.lavar.de/comp/linux/rpm noarch java<br />
<br />
Then call as root the two following commands:<br />
<br />
# apt-get update<br />
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
(it's more comfortable because, each time you call &quot;<tt>apt-get upgrade</tt>&quot;,<br />
you'll get automatically the new freemind package)<br />
<br />
Some additional notes:<br />
<br />
# with the repository method, you can get as well the sources for the .rpm package using &quot;<tt>apt-get source freemind[...]</tt>&quot;.<br />
# of course, you're not obliged to install the different plugins.<br />
<br />
==== Install FreeMind using <tt>urpmi</tt> ====<br />
<br />
''method tested with Mandriva 2006''<br />
<br />
Use [http://easyurpmi.zarb.org/ Easy Urpmi] to setup a first set of urpmi repositories. Then add the JPackage repositories. See [http://jpackage.org/repos.php JPackage Project Repositories] for details, but in a nutshell:<br />
<br />
# urpmi.addmedia jpackage-1.6-generic ''MIRROR''/1.6/generic/free with hdlist.cz<br />
# urpmi.addmedia jpackage-1.6-generic-non-free ''MIRROR''/1.6/generic/non-free with hdlist.cz<br />
<br />
[[#Install_Java_the_JPackage_way|Install Sun's or Blackdown's Java the JPackage way]].<br />
<br />
[[#Install_JavaHelp2_the_JPackage_way|Install JavaHelp2 the JPackage way]] if you need <tt>freemind-plugins-help</tt>.<br />
<br />
Add FreeMind's repository:<br />
<br />
# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/<br />
<br />
And then install FreeMind and its plugins:<br />
<br />
# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help<br />
<br />
=== The Gentoo installation ===<br />
<br />
==== Install Java the Gentoo way ====<br />
<br />
Basically, simply do the following:<br />
# emerge -av virtual/jdk<br />
See the [http://www.gentoo.org/doc/en/java.xml Gentoo Java Guide] for more information and further instructions.<br />
<br />
==== Install FreeMind the Gentoo way ====<br />
<br />
To ensure you are up-to-date in portage:<br />
<br />
# emerge sync (or emerge-websync)<br />
<br />
The [http://packages.gentoo.org/search/?sstring=freemind latest version] of FreeMind in Portage may be masked. To use this "unstable" version you may have to [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=3 unmask] the package.<br />
<br />
To make sure you know what is going to install, use the --ask flag to emerge.<br />
Answer `yes' if you want to emerge dependencies:<br />
<br />
# emerge --ask app-misc/freemind<br />
<br />
=== On any UN*X kind of system (also Linux) ===<br />
<br />
==== Install Java on UN*X ====<br />
<br />
It doesn't really matter, just install some Java from Sun or Blackdown.<br />
Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like <br />
[http://java.sun.com/j2se/1.4.2/download.html j2re-1_4_2_07-linux-i586.bin] or [http://java.sun.com/j2se/1.5.0/download.jsp jre-1_5_0_02-linux-i586.bin], or from [http://blackdown.org/ Blackdown].<br />
<br />
Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.<br />
<br />
==== Install FreeMind on UN*X ====<br />
<br />
==== straight-forward installation method ====<br />
<br />
Download the file called something like <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-max-0_8_0.zip?download freemind-bin-max-0_8_0.zip]</tt> (or <tt>[http://prdownloads.sourceforge.net/freemind/freemind-bin-0_8_0.zip?download freemind-bin-0_8_0.zip]</tt> if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):<br />
<br />
$ unzip .../freemind-bin-max-0_8_0.zip<br />
$ chmod +x freemind.sh<br />
<br />
You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.<br />
<br />
==== more subtile installation method ====<br />
<br />
Considering you're installing FreeMind locally, you should get root and do the following:<br />
<br />
# mkdir -p /usr/local/share/freemind<br />
# unzip freemind*.zip -d /usr/local/share/freemind<br />
# chmod +x /usr/local/share/freemind/freemind.sh<br />
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind<br />
<br />
This will copy the contents of the zip file to <tt>/usr/local/share/freemind</tt> and create a symbolic link to the FreeMind script in the /usr/local/bin directory.<br />
<br />
== Starting FreeMind ==<br />
<br />
=== Installed from RPM or DEB package ===<br />
<br />
Just type &quot;<tt>freemind</tt>&quot; in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under &quot;Applications&quot; in KDE and GNOME (under Debian, in any window manager).<br />
<br />
<br />
=== Installed from ZIP file ===<br />
<br />
You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:<br />
<br />
* if you've used the [[#straight-forward_installation_method]], you most probably need to type the whole path, e.g.:<br />
<br />
$ /some/directory/path/freemind.sh<br />
<br />
* if you've used the [[#more_subtile_installation_method]], and assuming <tt>/usr/local/bin</tt> is in your PATH variable, you can use a simple <tt>freemind</tt> command, as if installed from a package.<br />
<br />
== Frequently and less frequently Asked Questions ==<br />
<br />
=== I can't paste branches copied from FreeMind into other applications ===<br />
<br />
Try to use the middle mouse button to paste the content copied from FreeMind.<br />
<br />
Under KDE, you can use klipper and set the option &quot;Synchronize contents of the clipboard and the selection&quot;,<br />
so that you can also use Ctrl+V or Shift+Ins to paste.<br />
<br />
=== I want to add an icon for my Link to FreeMind on my Desktop. Is there one? ===<br />
<br />
The icon is compressed inside the <tt>freemind.jar</tt> file you can find in the FreeMind installation directory, e.g. <tt>/usr/(local/)share/freemind</tt>. Once the file located, use a command similar to:<br />
<br />
$ unzip ''$FREEMIND_BASE_DIR''/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp<br />
<br />
This will create a folder <tt>images</tt> in the tmp directory containing the <tt>FreeMindWindowIcon.png</tt> file - your icon!<br />
<br />
=== When starting FreeMind, it says &quot;<tt>java: command not found</tt>&quot;. What's wrong? ===<br />
<br />
It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the ''java'' command to the <tt>PATH</tt> nor defines properly the variable <tt>JAVA_HOME</tt>.<br />
<br />
Add the following two lines to one of the startup scripts (<tt>/etc/profile</tt> and/or <tt>/etc/bash.bashrc</tt> for all users, or <tt>$HOME/.profile</tt> and/or <tt>$HOME/.bashrc</tt> only for you):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
=== Why do I get a &quot;No print service found&quot; whenever I attempt to print? ===<br />
<br />
At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the ''lp'' commands, or ''old lp''). Most modern distributions offer the ''CUPS'' printing system, which needs a compatibility layer to work with Java:<br />
* Under SuSE 8.2, the package required is called ''cups-client''<br />
* Under Debian, it's called ''cupsys-bsd''.<br />
Install this package and you should be able to print from FreeMind.<br />
<br />
If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just ''lpr'', <tt>apt-get install lpr</tt> should be enough.<br />
<br />
Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6252456], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:<br />
<br />
# Rename printers, e.g. from "my-printer" to "myprinter".<br />
# Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.<br />
# After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.<br />
<br />
Small test code to regenerate the error fast: DummyPrinter.java<br />
import java.awt.print.PrinterJob;<br />
<br />
class DummyPrinter {<br />
public static void main(String[] args) {<br />
try {<br />
PrinterJob printJob=PrinterJob.getPrinterJob();<br />
printJob.printDialog();<br />
System.exit(0);<br />
} catch( Exception e) {<br />
e.printStackTrace();<br />
}<br />
}<br />
}<br />
<br />
<br />
'''SuSE 10.2:'''<br />
A missing file /etc/cups/client.conf might confuse java and java detects no printer.<br />
Create /etc/cups/client.conf with the content "ServerName localhost" in this case.<br />
<br />
=== I get an error <tt>java.lang.NoClassDefFoundError</tt> or <tt>java.lang.NullPointerException</tt> when starting FreeMind ===<br />
<br />
When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:<br />
<br />
./lib/freemind.jar <br />
java.lang.NoClassDefFoundError: javax/swing/JFrame <br />
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) <br />
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) <br />
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) <br />
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) <br />
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) <br />
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) <br />
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) <br />
at kaffe.jar.ExecJar.main (ExecJar.java:75)<br />
<br />
or<br />
<br />
update UI not overwritten in class: <br />
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,<br />
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension<br />
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] <br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module. <br />
Exception during event dispatch: <br />
java.lang.NullPointerException <br />
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) <br />
<br />
This is because you use <tt>kaffe</tt> (the same applies to <tt>libgcj</tt>, <tt>sablevm</tt> and a few others), which doesn't offer all features of Sun's Java. [http://blackdown.org Blackdown]'s Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.<br />
<br />
; Note : if you've installed FreeMind from a package, you can alternatively use the solution under [[#How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F]].<br />
<br />
<br />
=== While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work ===<br />
<br />
You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the<br />
FreeMind RPM resp. DEB package can't know that Java is installed.<br />
<br />
Three solutions (from better to worse):<br />
<br />
* Install Java from an RPM or DEB package and retry to install the FreeMind package.<br />
* Install FreeMind using the ZIP file.<br />
* Install the FreeMind package by ignoring the missing dependencies, e.g.:<br />
# rpm -Uvh -nodeps freemind....noarch.rpm<br />
<br />
<br />
=== While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package ===<br />
<br />
You've probably installed the ''JDK'' package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.noarch.rpm j2sdk-provides-j2re-1.4.2-2.noarch.rpm]. The [http://eric.lavar.de/comp/linux/freemind/j2sdk-provides-j2re-1.4.2-2.src.rpm source package] is available as well.<br />
<br />
<br />
=== How can I make FreeMind use a specific Java Virtual Machine? ===<br />
<br />
If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to <tt>/etc/freemind/freemindrc</tt>, for all users, or to <tt>$HOME/.freemind/freemindrc</tt>, for you, so that only FreeMind is impacted (and no other program):<br />
<br />
export PATH=$PATH:''/usr/java/j2re1.4.2_04/bin''<br />
export JAVA_HOME=''/usr/java/j2re1.4.2_04''<br />
<br />
(the part in italic depends on your installation)<br />
<br />
<br />
=== Why doesn't the rebuild of the SRPM work under Fedora Core 2 ===<br />
<br />
During rebuild of the RPM, lines similar to the following do appear and the build fails:<br />
<br />
compile:<br />
[mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:<br />
error: '{' expected.<br />
[javac] };<br />
[javac] ^<br />
[javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:<br />
error:<br />
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.<br />
[javac] public interface ID_Blank extends ID_BasicState {};<br />
[javac] ^<br />
<br />
The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the [http://jpackage.org/ JPackage Project] seems to solve the problem.<br />
<br />
=== Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6 ===<br />
<br />
The exact error message is:<br />
<br />
Exception in thread &quot;main&quot; java.lang.UnsatisfiedLinkError:<br />
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:<br />
cannot open shared object file: No such file or directory<br />
<br />
In this case install the package <tt>xorg-x11-deprecated-libs-6.8.1-12.i386.rpm</tt>, e.g.<br />
using yum, this should solve the problem.<br />
<br />
=== FreeMind seems broken and I have the Gtk Look&Feel ===<br />
<br />
We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.<br />
<br />
You can change it in the menu <tt>Tools &rarr; Preferences... &rarr; Appareance &rarr; Look and Feel</tt>.<br />
Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file <tt>~/.freemind/user.properties</tt> to uncomment and modify the <tt>lookandfeel</tt> parameter, as in:<br />
<br />
lookandfeel = metal<br />
<br />
Instead of <tt>metal</tt>, other valid values are <tt>nothing</tt> (for no Look&Feel at all), <tt>default</tt> (the... default one), <tt>windows</tt> or <tt>motif</tt>; mainly a matter of taste.<br />
<br />
; Note : if the modification of <tt>~/.freemind/user.properties</tt> doesn't seem to change anything, remove the <tt>lookandfeel</tt> parameter from the file <tt>~/.freemind/auto.properties</tt><br />
<br />
And, yes, we know, Gtk looks ''sooo'' much better! (but we don't really care)<br />
<br />
== Troubleshooting ==<br />
<br />
Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!<br />
<br />
Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him &quot;my car doesn't start&quot; or &quot;something is wrong with my car&quot;, would you expect him to tell you right away &quot;Oh, yes, that's the plugs!&quot;. Most probably, he will ask to come by.<br />
Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.<br />
<br />
It's easier than you might thought, just do the following steps, that should give us a good start:<br />
<br />
* start a console, e.g. use <tt>Alt+F2</tt>, and type <tt>xterm</tt> or <tt>konsole</tt> or <tt>rxvt</tt>.<br />
* in the console, type the following statements:<br />
<br />
On an RPM based system:<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
rpm -qa | grep -i j<br />
rpm -qa | grep freemind<br />
env | grep -i j<br />
<br />
On a Debian based system<br />
DEBUG=1 freemind<br />
(quit freemind)<br />
/usr/bin/java -version<br />
dpkg -l \*j\*<br />
dpkg -l freemind\*<br />
env | grep -i j<br />
<br />
; Note : You should see which java command is used, e.g. &quot;<tt>/usr/bin/java</tt>&quot;, from the debug output of the freemind command.<br />
<br />
The result should look somewhat like this (error messages are OK, I like error messages!):<br />
<br />
alice@wonderland:~> DEBUG=1 freemind<br />
DEBUG: Freemind parameters are ''.<br />
DEBUG: Using $PATH to find java virtual machine.<br />
DEBUG: Using '/usr/bin/java' as java virtual machine...<br />
DEBUG: Freemind Directory is '/usr/share/freemind'.<br />
<br />
Looking for user properties:<br />
/home/ericl/.freemind/user.properties<br />
<br />
User properties not found. It will be automatically created.<br />
Done.<br />
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel<br />
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:<br />
Tried to get view without being able to get map module.<br />
<br />
alice@wonderland:~> /usr/bin/java -version<br />
java version &quot;1.4.2-rc1&quot;<br />
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)<br />
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)<br />
alice@wonderland:~> rpm -qa | grep -i j<br />
eject-2.0.13-26<br />
joystick-2002.10.30-38<br />
libjpeg-6.2.0-530<br />
joe-2.9.8-179<br />
jfsutils-1.1.1-25<br />
jpilot-devel-0.99.6-0.pm.1<br />
jpeg-6b-530<br />
jhead-2.0-2<br />
taskjuggler-1.4.2-10<br />
j2sdk-provides-j2re-1.4.2-2<br />
libjasper-1.600.0-75<br />
jpilot-0.99.6-0.pm.1<br />
jakarta-ant-1.5.1-37<br />
java2-1.4.2-0.pm.0<br />
java2-jre-1.4.2-0.pm.0<br />
mjpegtools-1.6.2-1<br />
alice@wonderland:~> rpm -q freemind<br />
freemind-0.7.1-6<br />
alice@wonderland:~> env | grep -i j<br />
JRE_HOME=/usr/lib/java/jre<br />
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]<br />
JAVA_BINDIR=/usr/lib/java/bin<br />
JAVA_HOME=/usr/lib/java<br />
SDK_HOME=/usr/lib/java<br />
JDK_HOME=/usr/lib/java<br />
JAVA_ROOT=/usr/lib/java<br />
<br />
alice@wonderland:~><br />
<br />
* open a new thread in the [http://sourceforge.net/forum/forum.php?forum_id=22102 Help Forum] of the [http://sourceforge.net/projects/freemind FreeMind Project],<br />
* select the commands and what they output,<br />
* and paste the stuff using the middle button of your mouse in the message body.<br />
* Explain also your problem of course.<br />
* Add the name and version of your distribution (SuSE 8.2 or whatever).<br />
* That should be all.<br />
</td></tr><br />
</table></div>
Ewl
https://freemind.sourceforge.io/wiki/index.php?title=Talk:FreeMind_on_Linux&diff=4502
Talk:FreeMind on Linux
2007-03-25T12:03:54Z
<p>Ewl: /* (K)Ubuntu Instructions work on Ubuntu Edgy . . . I think ... confirmed */</p>
<hr />
<div>FreeMind is great! I have a great idea for a similar program only with a different feature set. What I want to know more about is how you start an open source software project. I have an idea and a beginning of a design, but how do I get more people involved? <br />
<br />
Thanks in advance for any help / inspiration / tips.<br />
<br />
David<br />
<br />
== wrong command in 'apt-get install' section? ==<br />
<br />
for me the given command for installing freemind by using apt-get didn't work:<br />
<br />
apt-get install freemind/experimental freemind-plugins-svg/experimental freemind-plugins-time/experimental freemind-plugins-time/experimental<br />
<br />
i found out i had to delete the /experimental, then:<br />
<br />
apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time<br />
<br />
worked fine<br />
<br />
guess you should leave the /experimental in the sources.list away if you want to have the originall command working?<br />
<br />
am i right or am i wrong? not sure whether i did the whole stuff an other way or the wiki put the wrong command so i didn't change it...<br />
<br />
schaffner<br />
<br />
== (K)Ubuntu Instructions work on Ubuntu Edgy . . . I think ... confirmed ==<br />
<br />
The instructions and link to the blog post (and its attendant comments) helped me manage to make FreeMind work on Ubuntu 6.10 (EdgyEft). I can't quite remember the combination of procedures, but it works for me now. Highlights:<br />
<br />
# I did install the j2re1.4 package (blackdown java)<br />
# I didn't have to edit any files (but I am configured to use the the multiverse & universe repos already).<br />
# I downloaded the .deb on the FreeMind website and installed it.<br />
# I used <tt>apt-get -f install</tt> to fix broken dependencies.<br />
<br />
Then, it Just Worked.<br />
<br />
--[[User:Tex|Tex]] 10:02, 29 Dec 2006 (PST)<br />
<br />
Thanks to the tip 'apt-get -f install' it worked for me as well - with first try. I wrote how in the article under 'confirmed more easy install within Kubuntu 6.10'. <br />
Thanks, Tex! <br />
<br />
--[[User:Patmuk|Patmuk]] 17:24, 29 Jan 2007 (PST)<br />
<br />
I'm happy that it works for you, but you're actually first breaking your system by installing FreeMind without taking care of the dependencies, and then repairing it using <tt>apt-get -f install</tt>. The correct way to do it is really to add the FreeMind repositories to your sources and then install freemind using <tt>apt-get install freemind</tt>.<br />
<br />
Furthermore your instructions might let other, not having multiverse and universe setup, think that it's easier than it actually is. For these reasons, I allow myself to update your notes. Hope this is OK.<br />
<br />
--[[User:Ewl|Ewl]] 05:03, 25 Mar 2007 (PDT)</div>
Ewl