Whodo 维客
Whodo 论坛 问题追踪 版本控制 邮件列表 DocBook 文档 FreeMind 文档 我爱维基百科

FreeMind

来自 Whodo Wiki (混沌初开)

跳转到: navigation, search


浏览所有 FreeMind 格式文档，请参见: FreeMind 分类文档。

《Whodo FreeMind 用户指南》


目录

[编辑] 1 Whodo FreeMind 快速指南

[编辑] 1.1 在线浏览 FreeMind 文档

通过 Flash Viewer 插件，您可以在线阅读 FreeMind 文档。如果您的浏览器支持 Flash，您应该能够在下面看到本文的 FreeMind 版本。

注意:

  • Flash 插件的版本不能低于 7.0，否则可能不能正确显示;
  • 如果不能显示，看看是否由于您的浏览器禁用了 JavaScript;
  • 或者浏览器的广告过滤插件把 Flash 屏蔽掉了。

下载: http://www.worldhello.net/doc/freemind/freemind.mm

[编辑] 1.2 本地阅读 FreeMind 文档

可以将 FreeMind 文档（扩展名为 .mm）下载到本地，使用 FreeMind 软件本地浏览和编辑。

  • FreeMind 是 Java 开发的软件，需要操作系统安装 Java 虚拟机。如果没有，请到 http://java.sun.com 下载。
  • 浏览本站编写的 FreeMind 文档，需要使用具有 WorldHello 扩展的 FreeMind，而且需要 9.0 或以上版本；

参见: 为什么 Whodo 项目要用更改过的 FreeMind；


[编辑] 1.2.1 软件下载

本地阅读和编辑 .mm 文档，需要下载并安装 Java，FreeMind。


Whodo 增强版

FreeMind 官方网站

Java 下载

[编辑] 1.2.2 FreeMind代码

如果您是开发人员，可以下载代码，自行编译。

  • FreeMind 代码
    cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/freemind checkout -r FM-0-8-0 freemind
  • Whodo 增强版的代码：
    svn checkout http://svn.worldhello.net/svn/whodo/trunk/doc/freemind/debian

[编辑] 1.3 共享你的 FreeMind 文档

Whodo 项目，是一个关于中文文档的共享计划。共享，意味着您的工作，能够使更多人受益；也意味着，会有其他人一块来帮助维护文档。


[编辑] 1.3.1 FreeMind 是 Whodo 建议格式之一

Whodo 项目的宗旨是中文用户自己的开放文档计划。随着越来越多华人开发者对开源项目的参与甚至是华人主导的开源项目，华人开发者不应该沦为英译汉的配角，用我们自己的文字，书写我们署名的传世之作！

WorldHello.net 的 前身 是用 DocBook 技术进行文档管理和网站制作。Whodo 项目也将 DocBook 作为文档格式之一，但大多数人认为 DocBook 复杂，工具尚不完善，因而退避三舍。

好消息是，Whodo 项目同样接受 FreeMind 文档，甚至 FreeMind 文档将成为 Whodo 文档的主流。改进后的 FreeMind 编辑的文档，能够非常好的被版本控制系统接受和管理，也利于共享和多人维护。

参见 Whodo 建议文档格式


[编辑] 1.3.2 Whodo 文档版权

使用 GPL 版权。


[编辑] 1.3.3 什么样的文档适合提交

TODO


[编辑] 1.3.4 如何提交文档


除了网站外，您还可以到我们的论坛上看看： Whodo 论坛。

[编辑] 2 FreeMind 介绍

FreeMind 是一个 Java 开发的处理 mindmap（思维导图）的开源软件。 2006年2月份，曾被评为 当月最佳。

[编辑] 2.1 首先了解 MindMap

是先有的 MindMap ，后有的 FreeMind。

  • 思维导图又叫心智图，英国人托尼·巴赞创造；
  • 是将思路按照树状的结构进行线索梳理的一种整理思路的方法；
  • MindMap 的树状组织结构和人思维的物质基础——神经元的结构惊人的相似 8-)

[编辑] 2.2 FreeMind 的特色

有很多 MindMap 处理软件，我用过 MindManager。但是 FreeMind 是独一无二的。

  • FreeMind 是 Java 开发的开源项目，开放源代码，如果搔到了你的痒处，自己动手修改吧；
  • 可用平台广泛，因为 Write once, Run everywhere （这是 Java 的特色） 8-)
  • 开放的文件存储格式，是 XML 格式，这是我最欣赏的，因为我爱 CVS/SVN；
  • 支持 HTML 语法，因而可以任意设置节点的排版格式；

[编辑] 2.3 FreeMind 的应用范围

  • 读书笔记
  • 会议记录
  • 所有你脑子里的东西 8-)


[编辑] 3 为什么 Whodo 要使用修改过的 FreeMind？

为什么 Whodo 项目要使用修改过的 FreeMind 呢？

[编辑] 3.1 因为搔到了我的痒处

Eric Raymond 说过，好的程序源自于搔到了开发者的痒处（Scratched personal itch）。 可能正因为商业 MindMap 处理软件过于昂贵，搔到了一些开源先锋的痒处，于是 FreeMind 诞生了。

我用 FreeMind 也有很长时间了，并且我一直用版本控制系统（CVS/SVN）保存 FreeMind 的 .mm 格式文档，但是有几个问题一直困扰着我，或者说 scratched my personal itch。

  • FreeMind 中输入中文，存储在 .mm 文件中被编码为 &#xxxx; 的格式，既冗余，又不可识别，对版本间比较造成困难；
  • FreeMind 打开浏览 .mm 文件，即使没有做任何实质改动（文字修改），只是展开或者关闭某个分支，也会造成 .mm 文件的改变！因为 .mm 文件保存了节点展开状态的信息；
  • FreeMind 对 utf-8 支持不好，不利于海峡两岸文字上的三通 8-);

[编辑] 3.2 WorldHello扩展功能设置

点击FreeMind菜单：工具->首选项，进入FreeMind设置界面，选择“WorldHello扩展”。

Image:freemind_settings_wh_ext.png

  • 字符编码
    • 将中文字符以 UTF8 编码保存在 filename.mm 文件中，而不是 &#HEX; 格式的编码。
  • 附加的辅助文件
    • 将不适合版本控制的属性保存在 filename.mm 文件之外的一个辅助文件中，辅助文件名为 .filename.mmx (扩展名为.mmx，文件名前加上一个点，在Unix下是隐藏文件)。
    • 可以选择哪些属性从 filename.mm 文件移动到 .filename.mmx 文件。默认三个属性 'FOLDED', 'CREATED', 'MODIFIED' 都被移动到附加的辅助文件中。

（注：“WorldHello扩展”扩展菜单在 FreeMind 0.9.0.Beta.17+wh-13 版本之后引入）

[编辑] 3.3 Whodo 对 FreeMind 所做的修改

[编辑] 4 TODO

[编辑] 4.1 解决加载速度慢的问题 （这个问题已经解决）

这个问题已经解决。解决方案参见： wiki@freemind

我本人并非 Java 行家，临时抱佛脚所做的 Whodo Hacked FreeMind，刚刚完成，就发下如下缺陷：

  • 加载慢
    对于比较大的 .mm 文档，合并存储附加节点属性的 .mmx 文档，速度慢，我测试了一个 200KB 的合并，最长要 4 分钟！ 
    $ time xsltproc --stringparam mmx_file subject-forum.mmx freemind_join_mm_mmx.xslt subject-forum.mm > jx.mm

real    4m33.148s
user    4m30.093s
sys     0m0.015s
  • 内存耗尽
    同样是由于 .mm 和 .mmx 合并造成的

可能的修改方法

  • 优化 xslt ，问题出在 .mm 和 .mmx 合并的采用的 xslt 太过复杂，缺乏效率
  • 修改 xslt 或者采用其它算法，例如构建两个 DOM 树，合并并生成新的 xml 文件

Workaround

  • 在每次打开 .mm 文件之前，删除 .mmx 文件，可以暂时回避这个缺陷。但是上次浏览后，各个节点的打开关闭状态丢失。

[编辑] 5 Hacking FreeMind

搔到了谁的痒处？一起来 Hacking FreeMind。

[编辑] 5.1 编译 FreeMind

动手修改 FreeMind 代码之前，一定要先掌握 FreeMind 的编译。步骤：

  • FreeMind 代码下载
  • 安装软件
    • JDK
    • Eclipse
    • Ant
    • Java Web Services Developer Pack 2.0 (可选)
  • 创建 Eclipse 工程
  • 执行 Ant 编译

[编辑] 5.2 Whodo 关于 FreeMind 的补丁

下载地址: 

svn checkout http://svn.worldhello.net/svn/whodo/trunk/doc/freemind/debian/patches

[编辑] 6 疑难解答

[编辑] 6.1 FreeMind 诊断方法

如果 FreeMind 不能正常运行，通过如下方法获得诊断信息。再将诊断信息粘贴至 本页的对话页 进行讨论。

  • 请先报告一下 Java 版本:
    C:\> JAVA -version
  • 在控制台里面运行FreeMind，可以显示出诊断信息，便于找出 FreeMind 异常的原因。
    • 如果是在 Windows 平台使用，运行 freemind.bat。
      C:\path\to\FreeMind> freemind.bat
    • 如果是在 Linux 平台使用，运行 freemind.sh
      $ /path/to/freemind.sh

[编辑] 6.2 不能保存 FreeMind 文件？

查看一下 JRE 版本。尝试升级到最新的 JRE，再试试 FreeMind 能否正确运行。 

C:\> java -version

[编辑] 6.3 在 Windows 平台不能运行，提示找不到 freemind.jar

看看是不是由于目录名中包含了特殊字符（如＋号），造成查找 FreeMind 目录失败。

从 WordHello.net 下载的软件包名称中可能包含＋号，如果在Windows平台直接展开到目录，就会出现这个问题。 例如展开到： C:\Bin\FreeMind-0.9.0BETA17+wh-13\

解决办法：修改FreeMind目录名。 例如：将 C:\Bin\FreeMind-0.9.0BETA17+wh-13\ 修改为 C:\Bin\FreeMind\

取自 "http://whodo.worldhello.net/wiki/FreeMind"