Difference between revisions of "Macintosh"

From Freeplane - free mind mapping and knowledge management software
m (Added categories)
(Update for 1.0.34 to invoke freeplaneeditor.jar instead of startup.sh)
Line 5: Line 5:
 
=== Download  ===
 
=== Download  ===
  
Visit the [http://sourceforge.net/projects/freeplane/ Freeplane Project page] at SourceForge, and click on the green "Download Now" button to get the latest version. As of this writing the current version is freeplane_bin-1.0.30.zip <br>  
+
Visit the [http://sourceforge.net/projects/freeplane/ Freeplane Project page] at SourceForge, and click on the green "Download Now" button to get the latest version. As of this writing the current version is freeplane_bin-1.0.34.zip . <br>  
  
 
Freeplane is currently available as a .zip file rather than a Mac-style .dmg file. Download the .zip file to your Desktop or Download folder, or wherever you normally store downloaded files.  
 
Freeplane is currently available as a .zip file rather than a Mac-style .dmg file. Download the .zip file to your Desktop or Download folder, or wherever you normally store downloaded files.  
Line 13: Line 13:
 
=== Install  ===
 
=== Install  ===
  
When the download is complete, find the downloaded .zip file and double-click its icon to "unzip" it. This will create a new folder with a name such as "freeplane-1.0.30" (depending on the version number). Move this folder into your Applications folder. You may now delete the downloaded .zip file.  
+
When the download is complete, find the downloaded .zip file and double-click its icon to "unzip" it. This will create a new folder with a name such as "freeplane-1.0.34" (depending on the version number). Move this folder into your Applications folder. You may now delete the downloaded .zip file.  
  
 
=== Run  ===
 
=== Run  ===
  
Start the Freeplane application from a Terminal window. To open Terminal, start from Finder, pull down the Go menu, choose Utilities, find the Terminal icon and double-click it.  
+
Open a Finder window and navigate to the Applications &gt;&nbsp;freeplane-1.0.34 &gt;&nbsp;plugins &gt;&nbsp;org.freeplane.core &gt;&nbsp;lib folder. Double-click on the icon there named freeplaneeditor.jar to start Freeplane.  
  
Enter the following three lines into the Terminal window, one line at a time, pressing the Return key at the end of each line (you may Copy these lines from this web page and Paste them into the Terminal window):
+
After a short delay you should see Freeplane's logo appear on a "splash screen." Otherwise, if you've downloaded a Freeplane version other than 1.0.34, you'll need to substitute the appropriate version number.&nbsp;
  
&nbsp; cd /Applications/freeplane-1.0.30/<br> &nbsp; chmod a+x freeplane.sh<br> &nbsp; ./freeplane.sh<br>  
+
Later versions of Freeplane may include a Mac OS X-style Application and installer. Meanwhile, you may create an OS X "alias" for use in the Dock or on your Desktop. <br>  
  
The second line (starting with chmod) only needs to be entered once, when starting freeplane for the first time.
+
If you're an advanced user and want to run Freeplane from Terminal (or iTerm), consider using the "open" command for the&nbsp;freeplaneeditor.jar file, because there are issues with the Linux startup.sh file as detailed in this [http://sourceforge.net/projects/freeplane/forums/forum/758437/topic/3318596 Forum thread].  
 
 
After a short delay you should see Freeplane's logo appear on a "splash screen." Otherwise, if you've downloaded a Freeplane version other than 1.0.30, you'll need to substitute the appropriate version number on the first line entered into Terminal.
 
 
 
This start-up process can be simplified using methods such as a "bash script," AppleScript, or Platypus. More details soon...
 
 
 
If you're an advanced user and want to use symbolic links or an OS X alias, there's a related issue detailed in this [http://sourceforge.net/projects/freeplane/forums/forum/758437/topic/3318596 Forum thread].  
 
  
 
=== Usage  ===
 
=== Usage  ===
Line 41: Line 35:
 
=== Quit  ===
 
=== Quit  ===
  
To exit Freeplane, pull down its File menu and choose Exit. This should return you to the Terminal window, which you can quit in the normal way.  
+
To exit Freeplane, pull down its File menu and choose Exit. This will Quit the Freeplane program.  
  
[[Category:User_Documentation]][[Category:Needs_Updating]]
+
[[Category:User_Documentation]]

Revision as of 06:57, 29 November 2009

Freeplane on Mac OS X

Here are some tips for Macintosh users who'd like to test Freeplane. At first this information will be more useful for advanced users. As this page develops, it should be ready for "the rest of us." The steps below have been tested under Mac OS X 10.4 "Tiger," and should also work with 10.5 "Leopard" and 10.6 "Snow Leopard."

Download

Visit the Freeplane Project page at SourceForge, and click on the green "Download Now" button to get the latest version. As of this writing the current version is freeplane_bin-1.0.34.zip .

Freeplane is currently available as a .zip file rather than a Mac-style .dmg file. Download the .zip file to your Desktop or Download folder, or wherever you normally store downloaded files.

If it takes more than 30 seconds for the download to begin, you may need to click on the link which says "Please use this direct link".

Install

When the download is complete, find the downloaded .zip file and double-click its icon to "unzip" it. This will create a new folder with a name such as "freeplane-1.0.34" (depending on the version number). Move this folder into your Applications folder. You may now delete the downloaded .zip file.

Run

Open a Finder window and navigate to the Applications > freeplane-1.0.34 > plugins > org.freeplane.core > lib folder. Double-click on the icon there named freeplaneeditor.jar to start Freeplane.

After a short delay you should see Freeplane's logo appear on a "splash screen." Otherwise, if you've downloaded a Freeplane version other than 1.0.34, you'll need to substitute the appropriate version number. 

Later versions of Freeplane may include a Mac OS X-style Application and installer. Meanwhile, you may create an OS X "alias" for use in the Dock or on your Desktop.

If you're an advanced user and want to run Freeplane from Terminal (or iTerm), consider using the "open" command for the freeplaneeditor.jar file, because there are issues with the Linux startup.sh file as detailed in this Forum thread.

Usage

Freeplane menus appear at the top of its own window, rather than at the top of the Desktop like normal Mac programs. This makes Freeplane usage identical under Windows, Linux, and Mac OS X.

Keyboard shortcuts also default to Windows and Linux conventions, generally using the "control" key instead of the Apple (Command or cloverleaf) key. It's easy to change most keyboard shortcuts, though, by holding down the "control" key while clicking the corresponding menu item. This brings up a dialog in which you can enter whatever key combination you like.

Most Mac users will need to change the shortcut for inserting a child node. Mac keyboards generally lack an "Insert" key, so you'll want to assign another key (such as "tab") for this, under the Insert menu.

Quit

To exit Freeplane, pull down its File menu and choose Exit. This will Quit the Freeplane program.