目录：

1. memchached简介
2. hash
   • 取模
   • 一致性hash
   • 虚拟节点
   • 源码解析
3. 参考资料

1. memchached简介

memcached是一个开源的高性能分布式内存对象缓存系统。
其实思想还是比较简单的，实现包括server端（memcached开源项目一般只单指server端）和client端两部分:

• server端本质是一个in-memory key-value store，通过在内存中维护一个大的hashmap用来存储小块的任意数据，对外通过统一的简单接口（memcached protocol）来提供操作。
• client端是一个library，负责处理memcached protocol的网络通信细节，与memcached server通信，针对各种语言的不同实现分装了易用的API实现了与不同语言平台的集成。
• web系统则通过client库来使用memcached进行对象缓存。

2. hash

memcached的分布式主要体现在client端，对于server端，仅仅是部署多个memcached server组成集群，每个server独自维护自己的数据（互相之间没有任何通信），通过daemon监听端口等待client端的请求。
而在client端，通过一致的hash算法，将要存储的数据分布到某个特定的server上进行存储，后续读取查询使用同样的hash算法即可定位。

client端可以采用各种hash算法来定位server：
取模
最简单的hash算法

targetServer = serverList[hash(key) % serverList.size]

直接用key的hash值（计算key的hash值的方法可以自由选择，比如算法CRC32、MD5,甚至本地hash系统，如java的hashcode）模上server总数来定位目标server。这种算法不仅简单，而且具有不错的随机分布特性。

但是问题也很明显，server总数不能轻易变化。因为如果增加/减少memcached server的数量，对原先存储的所有key的后续查询都将定位到别的server上，导致所有的cache都不能被命中而失效。

一致性hash
为了解决这个问题，需要采用一致性hash算法（consistent hash）
相对于取模的算法，一致性hash算法除了计算key的hash值外，还会计算每个server对应的hash值，然后将这些hash值映射到一个有限的值域上（比如0~2^32）。通过寻找hash值大于hash(key)的最小server作为存储该key数据的目标server。如果找不到，则直接把具有最小hash值的server作为目标server。

为了方便理解，可以把这个有限值域理解成一个环，值顺时针递增。

如上图所示，集群中一共有5个memcached server，已通过server的hash值分布到环中。

如果现在有一个写入cache的请求，首先计算x=hash(key)，映射到环中，然后从x顺时针查找，把找到的第一个server作为目标server来存储cache，如果超过了2^32仍然找不到，则命中第一个server。比如x的值介于A~B之间，那么命中的server节点应该是B节点

可以看到，通过这种算法，对于同一个key，存储和后续的查询都会定位到同一个memcached server上。

那么它是怎么解决增/删server导致的cache不能命中的问题呢？
假设，现在增加一个server F，如下图

此时，cache不能命中的问题仍然存在，但是只存在于B~F之间的位置（由C变成了F），其他位置（包括F~C）的cache的命中不受影响（删除server的情况类似）。尽管仍然有cache不能命中的存在，但是相对于取模的方式已经大幅减少了不能命中的cache数量。

虚拟节点
但是，这种算法相对于取模方式也有一个缺陷：当server数量很少时，很可能他们在环中的分布不是特别均匀，进而导致cache不能均匀分布到所有的server上。

如图，一共有3台server – A，B，C。命中B的几率远远高于A和C。
为解决这个问题，需要使用虚拟节点的思想：为每个物理节点（server）在环上分配100～200个点，这样环上的节点较多，就能抑制分布不均匀。
当为cache定位目标server时，如果定位到虚拟节点上，就表示cache真正的存储位置是在该虚拟节点代表的实际物理server上。

另外，如果每个实际server的负载能力不同，可以赋予不同的权重，根据权重分配不同数量的虚拟节点。

源码解析
下面结合一个java的memcached client（gwhalin / Memcached-Java-Client）的源码来看一下consistent hash的实现。
首先看server的分布：

// 采用有序map来模拟环
this.consistentBuckets = new TreeMap();

MessageDigest md5 = MD5.get();//用MD5来计算key和server的hash值

// 计算总权重
if ( this.totalWeight 	for ( int i = 0; i < this.weights.length; i++ )
		this.totalWeight += ( this.weights[i] == null ) ? 1 : this.weights[i];
} else if ( this.weights == null ) {
	this.totalWeight = this.servers.length;
}

// 为每个server分配虚拟节点
for ( int i = 0; i < servers.length; i++ ) {
	// 计算当前server的权重
	int thisWeight = 1;
	if ( this.weights != null && this.weights[i] != null )
		thisWeight = this.weights[i];

	// factor用来控制每个server分配的虚拟节点数量
	// 权重都相同时，factor=40
	// 权重不同时，factor=40*server总数*该server权重所占的百分比
	// 总的来说，权重越大，factor越大，可以分配越多的虚拟节点
	double factor = Math.floor( ((double)(40 * this.servers.length * thisWeight)) / (double)this.totalWeight );

	for ( long j = 0; j < factor; j++ ) {
		// 每个server有factor个hash值
		// 使用server的域名或IP加上编号来计算hash值
		// 比如server - "172.45.155.25:11111"就有factor个数据用来生成hash值：
		// 172.45.155.25:11111-1, 172.45.155.25:11111-2, ..., 172.45.155.25:11111-factor
		byte[] d = md5.digest( ( servers[i] + "-" + j ).getBytes() );

		// 每个hash值生成4个虚拟节点
		for ( int h = 0 ; h < 4; h++ ) {
			Long k =
				((long)(d[3+h*4]&0xFF) << 24)
			      | ((long)(d[2+h*4]&0xFF) << 16)
			      | ((long)(d[1+h*4]&0xFF) << 8 )
			      | ((long)(d[0+h*4]&0xFF));

			// 在环上保存节点
			consistentBuckets.put( k, servers[i] );
		}

	}
	// 每个server一共分配4*factor个虚拟节点
}

每个server根据权重获得一个虚拟节点数量控制因子factor，然后由services[i]+”-”+i来生成factor个hash值，生成hash值时采用MD5算法。
由于MD5长度是16个字节，正好划分成4段，每段4字节，这样每段就对应一个虚拟节点。linex-liney通过把这一段的4字节拼装成连续的32bit，作为低32位拉升为一个Long。

为key定位cache存储的server：

// 用MD5来计算key的hash值
MessageDigest md5 = MD5.get();
md5.reset();
md5.update( key.getBytes() );
byte[] bKey = md5.digest();

// 取MD5值的低32位作为key的hash值
long hv = ((long)(bKey[3]&0xFF) << 24) | ((long)(bKey[2]&0xFF) << 16) | ((long)(bKey[1]&0xFF) << 8 ) | (long)(bKey[0]&0xFF);

// hv的tailMap的第一个虚拟节点对应的即是目标server
SortedMap tmap = this.consistentBuckets.tailMap( hv );
return ( tmap.isEmpty() ) ? this.consistentBuckets.firstKey() : tmap.firstKey();

3. 参考资料

1. 首次提出consistent hash的论文 – “Consistent Hashing and Random Trees: Distributed Caching Protocols for Relieving Hot Spots on the World Wide Web”
2. Consistent hashing Wiki – http://en.wikipedia.org/wiki/Consistent_hashing
3. Ketama: Consistent Hashing
4. memcached开源项目主页
5. memcached google code主页
6. gwhalin / Memcached-Java-Client主页

这个插件会在右侧滚动条旁添加一个位置指示器，当使用/?在页面查找时，查找结果的位置会被标记在指示器上。
基本用处就是可以看到查找结果在长页面上的大致位置，点击每个位置标记可以跳转到相应的查找结果。

命令

:h findmarker-plugin

查看帮助

配置项‘findmarker’可以控制如何标记：
0（默认值）：只在高亮所有查找结果时标记，通过命令:hl可以toggle高亮状态
1：只标记当前查找结果

findMarker_v0.01

pentadactyl的issue列表里有这个enhancement request – Issue 170: Searches should start within the current viewport，但是一直没时间实现。

20110429升级到v0.02 – 添加!参数以支持反向查找，增加简化命令:fh

命令：

:find[here]
:fh
:find[here]!
:fh!

帮助：

:h findhere

可以考虑重新映射/和?键

map -silent / :findhere
map -silent ? :findhere!

问题：
当前pentadactyl版本似乎默认的?键功能不是反向搜索，跟/键功能一样也是向下查找，可能是bug

附件:
findhere_v0.01
findhere_v0.02

目前，about URL scheme还没有标准化，不过IETF正在着手标准化工作，已经有了草案。
尽管还未标准化，但是现在主流的浏览器都有自己不程度的支持，包括IE。

今天主要说说firefox的about URL scheme。
以下这些URLs都可以输入到地址栏，用标签呈现内容。（以下以firefox4为例）

• about:about

列出当前支持的所有about地址。


• about

显示当前firefox的基本信息

• about:logo

显示about页面的logo

• about:blank

显示一个空白页面，这个大家都熟悉，基本上所有浏览器都支持

• about:copyright

显示firefox采用的软件license信息 – firefox采用Mozilla Public License

• about:license

显示Mozilla Public License的具体内容

• about:credits

显示firefox项目的contributors信息

• about:home

显示firefox的默认主页

• about:buildconfig

显示当前firefox使用的build的构建信息

• about:addons

显示扩展管理页面

• about:plugins

显示安装的插件信息

• about:privatebrowsing

显示privatebrowsing模式切换页面，可以用来切换隐私浏览模式。


• about:cache

显示cache的使用信息，甚至可以查看到每条cache的存储
另外注意：磁盘cache较多的话，点击查看列表前要谨慎，以防假死。


• about:memory

显示当前内存使用状况


• about:sessionrestore

显示sessionrestore操作页面，可以用来重新恢复上次session中的标签

• about:crashes



• about:config

这个也常用，用来设置preferrences

• about:support

打开support页面，等同于点击菜单Help -> Troubleshooting Information
可以用来打开profile文件夹，查看firefox版本，查看安装的扩展和插件，查看已修改的preferrences，查看Graphics信息

• about:sync-log

查看同步的log

• about:sync-tabs

打开同步tabs管理页面，用来从其他电脑同步标签页，这个比较有用。


下面两个是彩蛋：

• about:mozilla

显示一段来自The Book of Mozilla的节选

• about:robots

这个菜单开始于March 8, 2008 trunk builds，在bugzilla里还有个bug track

还有一些没有列在about:about页面的

• about:blocked

显示恶意软件保护页面

• about:certerror

显示“SSL/TLS证书不能验证时的错误”页面

• about:feeds

显示“点击地址栏的rss订阅图标时弹出的”页面

• about:neterror

显示“地址不能访问时使用的”页面

最直接的办法是用firefox的file://方式URL来访问本地文件夹

:tabopen file://c:\\windows

================================================
如果不想输入file://，简单的办法是定义下面的ex命令

:com! folder -description “Open this folder” -nargs=1 -complete dir -js gBrowser.selectedTab = gBrowser.addTab(args);

这样使用

:folder C:\\windows

这个命令只支持绝对路径。

================================================
如果想功能完善点，可以使用下面的js代码，放在rc文件中。

javascript <<EOF
    io.openFolder = function(arg) {
        try{
        if(arg) {
            try {
                arg = arg.toString();
            }catch(e) {
                arg = null;
            }
        }

        var folderPath = arg;
        if (!folderPath) {
            folderPath = io.cwd.path;
        }

        folderPath = File.expandPath(folderPath);
        if(!File.isAbsolutePath(folderPath)) {
            let dirs = modules.options.get("cdpath").files;
            for (let dir in values(dirs)) {
                dir = dir.child(folderPath);
                if (dir.exists() && dir.isDirectory() && dir.isReadable()) {
                    folderPath = dir.path;
                    break;
                }
            }
        }
        gBrowser.selectedTab = gBrowser.addTab(folderPath);
        }catch(e) { dactyl.echerr(e); }
    };
EOF

然后再定义ex命令 – folder

:com! folder -description "Open this folder" -nargs=? -complete dir -js io.openFolder(args);

用法说明:

1. 不指定目录无参数调用时，打开当前目录
• 通过:pwd查看当前目录
• 通过:cd更改当前目录
2. 使用绝对路径指定文件夹

比如

:folder e:\\algorithm

跟前一种简单办法一样。

3. 使用相对路径指定文件夹
• 默认情况下，相对路径只从当前目录开始搜索

比如：当前在firefox的profiles目录下

:folder chrome

即可打开profiles目录下的chrome文件夹

• 如果设置了环境变量$CDPATH，$CDPATH定义的目录都作为相对路径的搜索起点。
• 设置配置项cdpath

:help cdpath

配置项cdpath下的所有路径都作为相对路径的搜索起点。

4. 支持文件夹autocompletion

1. 模式
2. 键映射命令
3. 参数详解
4. 键表示
5. 其他

=================================================

• 模式
  键映射是Pentadactyl提供的最基本的快捷键定义方式。
  在Pentadactyl中，每一个键映射定义都与一个模式相关联，比如浏览（普通）模式（normal mode），编辑（插入）模式（insert mode），命令行模式（command line mode）等等。在某个模式下定义的键，只有在该模式激活的情况下才有效。例如，我定义了一个命令行模式下的键用于复制文本，只有在我打开命令行（:）的情况下才能用来复制。而在一般的浏览模式下，按<C-c>去复制是不生效的，除非在view模式下也有映射。

  下面5个模式是我们平时最常用到的基本模式

  n	Normal Mode 普通模式，浏览模式	焦点没有定位于某个特定元素时（通常浏览网页时都处于该模式）
  v	Visual Mode 选择模式	①当在普通模式下选中文字时 ×有误：经测试这种仍然是处于普通模式 ②在Caret（浏览模式下按i进入）和TextEdit模式下按v直接进入visual模式
  i	Insert Mode 插入模式，编辑模式	当光标位于页面上的文本输入框，处于可编辑文字状态时
  t	TextEdit Mode 文本编辑模式	在插入模式下按<C-t>进入 一般在文本输入框中，对应于可输入字符的快捷键都没法使用，因为要用来输入文字。为了能够在文字输入区域使用类Vim的操作，需要进入TextEdit模式，这时候就可以定义可输入字符键为其他快捷操作。
  c	Command-line Mode 命令行模式	按键:进入命令行模式，用于输入Ex命令

  在vim中，不像一般的编辑器，打开文件后是不能直接按键输入文字的，因为vim会默认进入类似于Pentadactyl的TextEdit模式，目的是为了方便用丰富的命令定位或者操作文本，而当需要输入文字时，用i、a这类命令进入Insert模式再输入。
  而在浏览器中，定位于输入框后，一般都是没有内容的，首先要开始输入文字。所以，Pentadactyl为了与传统Firefox操作方式相一致，当光标定位于输入框时，默认也是进入Insert模式。但是，可别忘了Pentadactyl定位于提供完全的类vim的操作体验，所以当然也是可以实现vim的操作方式的。

  :set insertmode=off

  Pentadactyl通过insertmode配置项来控制进入可输入区域后首先使用何种模式，默认insertmode=on使用InsertMode，置成off后会直接进入TextEdit模式。

  除了这5个基本模式外，当前最新的Pentadactyl可以支持如下模式树中的模式：
  
  针对某个模式定义的键映射，除了会在该模式下生效外，在该模式的子孙模式下都生效。比如，在base模式下定义的键，在normal和insert模式下都生效。

• 键映射命令
  Pentadactyl提供的键映射相关命令比较多，有20+，但是理解了模式后，就一目了然了。

  :map   :noremap   :unmap   :mapclear  – both Normal and Visual modes
  :nmap  :nnoremap  :nunmap  :nmapclear – Normal mode
  :vmap  :vnoremap  :vunmap  :vmapclear – Visual mode
  :imap  :inoremap  :iunmap  :imapclear – Insert mode
  :tmap  :tnoremap  :tunmap  :tmapclear – Text Edit mode
  :cmap  :cnoremap  :cunmap  :cmapclear – Command-line mode

  最基本的命令是map

  :m[ap] {lhs} {rhs}

  {lhs}用于指定新定义的键，{rhs}用于指定实现这个新定义所用的原键。
  {lhs}和{rhs}都支持多个键组成的序列。

  :unmap {lhs}
  :unmap!
  

  取消已定义的键{lhs}
  加!号，取消所有映射

  :mapclear

  原本用于取消所有键映射，从b6开始由unmap!替代，最新版已经没有相关命令
  —————— 感谢harnack的指点

  :noremap

  在进行键映射时，由于map命令的{rhs}支持用户自定义的键，所以存在一个循环引用问题。
  比如如下映射，就会导致无限的循环映射。

  :map a b
  :map b a

  为了解决这个问题，引用了noremap命令 – no recursive map
  这个命令的{rhs}不支持用户定义命令，只能指定pentadactyl默认提供的键，并按照默认提供的逻辑来执行。
  当在进行键定义时，如果需要用到pentadactyl默认提供的键逻辑，应该使用noremap。
  map命令的-builtin参数提供同样的语意。

  这几个基本命令前都可以加5大基本模式的前缀字符（n,v,i,t,c），用于在相应模式下映射键。
  map命令的-modes（缩写-m）参数可以用于指定模式。
  比如如下映射，恢复ctrl+c复制功能。

  :map -m=v,i,c <C-c> <C-v><C-c>

• 参数详解
  映射命令提供了一系列有用的参数。
  1. -arg

  缩写-a
  使定义的映射按键后，可再接一个参数键，参数的值可以在{rhs}用<arg>取到
  比如如下映射：映射新D键，按了D以后再按一位数字i，可以直接关闭第i个标签

  :map -arg D <arg>bd

  感觉不是很有用，因为参数只能接收一个，且大多数单键都已有功能定义，不能作为参数键。
  可能在-js和-ex下能有大用，待测。

  2. -builtin

  缩写-b
  使映射命令的{rhs}部分只能指定系统内置的命令，等价于noremap

  :map d -js alert('test')
  :map t -builtin d
  

  这样映射后，即使重新定义了d键，但是按t键仍然可以关闭标签，而不是alert test字符串。

  3. -count

  缩写-c
  使映射的命令支持数字前缀。
  比如，如果重新交换d和D的逻辑（默认d是关闭当前标签并选中右侧的，D是选中左侧）

  :map d -builtin D
  :map D -builtin d
  

  这样映射的话，新的d和D就不支持数字前缀了，比如原先2d可以关闭2个标签，重新映射后就只能关闭当前。

  要支持数字前缀，应该这样映射

  :map -count d -builtin <count>D
  :map -count D -builtin <count>d

  另：经测试，不写-count参数，也可以在{rhs}部分直接使用<count>来实现数字前缀。

  4. -description

  缩写-d
  用于指定新定义键的名字，在unmap时可以看见。

  :map -description "This is a test key mapping" t -js alert("test")

  5. -ex

  缩写-e
  一般我们定义键时，都是用已有的键（序列）来定义新键，所以{rhs}表示的是按键

  :noremap d D

  这个映射的意思是以后按d的效果就是原来按D的效果。

  -ex参数可以使{rhs}部分执行ex命令。
  比如下面这个映射，映射b键打开百度

  :map b -ex tabopen www.baidu.com

  通过这个参数，我们可以把丰富的ex命令映射成快捷键，用处非常大。

  :help ex-cmd-index

  通过这个命令，查看系统内建ex命令索引

  另外，-ex部分支持条件判断语法。

  map <F2> -ex if buffer.URL == 'about:blank'
      \ open about:config
  \ else
      \ tabopen about:config
  \ fi

  定义F2打开about:config，如果当前tab是空白页就在当前页打开，否则新开标签
  条件判断语法似乎不支持写在单行（待确定？？？），所以不能在命令行定义，需要定义在rc文件里，而且多行需要用\标识。

  :help conditionals

  查看ex命令条件判断语法。

  6. -group

  缩写-g
  为了方便管理脚本、命令以及键映射，pentadactyl中提供了group的概念。

  :help group     查看group相关帮助

  在进行键映射时，如果使用-group参数，就可以把该映射关联到一个已创建的group，以后可以通过group来管理一批关联的键映射。另外，group可以指定只在特定的URLs生效，换言之，通过group就可以实现只在某些URLs下生效的键映射。

  用这个参数，可以很方便自定义针对某个站点的快捷键。
  【注意】这个键定义只是示例，不具有通用性。
  比如：我常常要在blog后台更新文章，写好内容后，需要点个按钮预览，确认没问题了后再提交发布。但是因为我的文章一般都非常长，所以更新好了内容后，还得滚屏定位到预览按钮，再点击预览。预览完了后，还得再滚屏定位到上次输入内容的地方，继续写。这样，页面上下滚来滚去的非常不方便。所以我定义了两个快捷键，一个p用来点击预览按钮，一个s提交发布。这样，我可以一直在文章编辑区域内写东西，而不再需要滚屏定位到相应的按钮了，省了很多事。

  :group myblog -description "Xiao Shan's blog" -locations=http://www.slimeden.com/wp-admin/*
  :map p -group=myblog -js var preview=content.document.getElementById('post-preview');var evt=preview.ownerDocument.createEvent("Events");evt.initEvent("click", true, true);preview.dispatchEvent(evt);
  :map s -group=myblog -js var preview=content.document.getElementById('publish');var evt=preview.ownerDocument.createEvent("Events");evt.initEvent("click", true, true);preview.dispatchEvent(evt);
  

  7. -javascript

  缩写-j
  与-ex相似，-javascript就是在{rhs}部分使用javascript代码，相当于提供了完整的keyconfig功能。
  这样，pentadactyl下的键映射基本上可以说无所不能了。

  【☆推荐】下面列几个pentadactyl中提供的比较有用的javascript函数。

  dactyl.execute(":tabopen "+ content.getSelection());

  执行字符串形式的ex命令。

  CommandExMode().open("tabopen ");

  打开ex命令行，并输入参数中提供的字符串内容。

  prefs.get("browser.tabs.insertRelatedAfterCurrent", true);
  prefs.set("browser.tabs.insertRelatedAfterCurrent", true);
  

  1. 取preference的值，没有的话返回第二个参数 – 默认值
  2. 设置preference的值

  8. -literal

  缩写-l

  9. -modes

  缩写-m或者-mode
  用于指定当前键映射使用的模式。
  使用该参数就可以用map命令表达所有的键映射命令，避免记忆不同模式下的映射命令。
  比如

  map -m=i 等价于 imap
  map -m=c {lhs} -builtin {rhs} 等价于 cnoremap

  其实，如果你在命令行用imap这种模式专用映射命令映射键后，保存到rc文件，然后再查看rc文件里的内容就会发现：最后所有的键映射都会转化成map加-modes的形式保存。

  另外，在命令行下，-m=后autocomplete会提示出目前pentadactyl支持的所有模式，

  10. -nopersist

  缩写-n
  一般的map可以通过:mkpentadactyl!保存到rc文件中，以便以后使用。而使用-nopersist的映射即使使用保存命令也不会保存到rc文件，所以可以使用该参数来临时测试键映射。

  :map x -nopersist -js alert('test')
  :mkpentadactyl!
  :rc
  

  比如，临时映射一个测试用的键x，然后使用mkp命令保存，最后使用rc命令查看，会发现rc文件中并没有该定义，而且如果重启，再按x也不会有alert字符串test的效果了。

  11. -silent

  缩写-s

• 键表示
  键映射中的键如何表示呢：
  • 键盘上对应可打印字符的一般键，直接用对应的字符表示即可。如a,9,]等
  • 功能键F1-F2表示成<F1> <F12>
  • 数字键盘上的数字表示成<K0> <K9>
  • 方向键表示成<Left> <Right> <Up> <Down>
  • 退格键表示成<BS>
  • 回车键表示成<Return>或者<CR>
  • 空格键表示成<Space>
  • 其他功能键<CapsLock> <NumLock> <Insert> <Del> <Tab> <PageUp> <PageDown> <Esc>
  • unicode表示法<Uxxxx> xxxx对应字符的unicode
  • 组合键表示成<C-␣> <A-␣> <M-␣> <S-␣>
    组合键可以互相组合，如ctrl+alt+j表示成<C-A-j>

  其他，还有一些伪键

  • <Nop>表示什么都不做
    :map <C-n> <Nop>表示按ctrl+n什么都不干，相当于disable了ctrl+n
  • <Pass>表示把映射的键直接传递给firefox，不按pentadactyl中的逻辑执行
    :map <C-c> <Pass>即可映射ctrl+c为复制，因为直接传递ctrl+c给firefox，而在firefox中ctrl+c是用于复制的键
  • <CR> TODO
  • <Leader> TODO

下面这个KeySnail插件，可以在编辑模式下支持使用“可输入字符”的键。

keysInEditMode.ks
安装后，新建一个编辑模式下的命令（比如ctrl+i)，填上如下代码

try {
var prefService = Cc['@mozilla.org/preferences-service;1'].getService(Ci.nsIPrefService).getBranch("extensions.keysnail.");
var statusPrefName = "enabeKeyInEditMode";
try {
    var status = prefService.getBoolPref(statusPrefName);
    prefService.setBoolPref(statusPrefName, !status);
} catch (e) {
    prefService.setBoolPref(statusPrefName, true);
}
if (prefService.getBoolPref(statusPrefName)) {
    ev.target.addEventListener("blur", function (e) {
        this.removeEventListener("blur", arguments.callee, false);
        prefService.setBoolPref(statusPrefName, false);
        ev.target.ksMarked = false;
    },
    false);
}
} catch (e) {}

这个就是在编辑模式下开启使用可输入字符键命令的开关。

当在编辑模式下（处于可输入区域），ctrl+i就会打开可输入字符键命令模式，这个时候按键会执行定义的快捷键逻辑，而不是输入字符，如果未定义，则输入相应字符。再次按ctrl+i切换回输入模式。

进入编辑区域后，如果未开启该命令模式按单键，也不会像KeySnail默认行为那样执行预定义快捷键命令，导致不能输入字符。

另外，该命令模式会在光标离开输入区域后自动关闭。

————————————————————————
下面是一些编辑模式下可用的代码
ESC – 关闭可输入字符键命令模式

try {
var prefService = Cc['@mozilla.org/preferences-service;1'].getService(Ci.nsIPrefService).getBranch("extensions.keysnail.");
var statusPrefName = "enabeKeyInEditMode";
prefService.setBoolPref(statusPrefName, false);
ev.target.ksMarked = false;
 } catch (e) {}

v – toggle visual mode in edit mode

ev.target.ksMarked = !ev.target.ksMarked;

j – 光标下移一行

ev.target.ksMarked?goDoCommand("cmd_selectLineNext"):goDoCommand("cmd_lineNext");

k – 光标上移一行

ev.target.ksMarked?goDoCommand("cmd_selectLinePrevious"):goDoCommand("cmd_linePrevious");

h – 光标左移一个字符

ev.target.ksMarked?goDoCommand("cmd_selectCharPrevious"):goDoCommand("cmd_charPrevious");

l – 光标右移一个字符

ev.target.ksMarked?goDoCommand("cmd_selectCharNext"):goDoCommand("cmd_charNext");

u – undo

goDoCommand("cmd_undo");

r – redo

goDoCommand("cmd_redo");

x – 删除一个字符

goDoCommand("cmd_cutOrDelete");

X – 反向删除一个字符

goDoCommand("cmd_deleteCharBackward");

dd – 删除整行

goDoCommand("cmd_beginLine");
goDoCommand("cmd_selectLineNext");
goDoCommand("cmd_cutOrDelete");

d^ – 从当前位置删除到行首

goDoCommand("cmd_deleteToBeginningOfLine");

d$ – 从当前位置删除到行尾

goDoCommand("cmd_deleteToEndOfLine");

^ – 移到行首

ev.target.ksMarked?goDoCommand("cmd_selectBeginLine"):goDoCommand("cmd_beginLine");

$ – 移到行尾

ev.target.ksMarked?goDoCommand("cmd_selectEndNext"):goDoCommand("cmd_endLine");

gg – 移到最开始

ev.target.ksMarked?goDoCommand("cmd_selectTop"):goDoCommand("cmd_moveTop");

G – 移到最后

ev.target.ksMarked?goDoCommand("cmd_selectBottom"):goDoCommand("cmd_moveBottom");

复制选中内容

goDoCommand("cmd_copy");

yy – 复制整行

goDoCommand("cmd_beginLine");
goDoCommand("cmd_selectLineNext");
goDoCommand("cmd_copy");

y^ – 从当前位置复制到行首

goDoCommand("cmd_selectBeginLine");
goDoCommand("cmd_copy");

y$ – 从当前位置复制到行尾

gDoCommand("cmd_selectEndLine");
goDoCommand("cmd_copy");

p – 黏贴

goDoCommand("cmd_paste");

——————————————————————-
最后，KeySnail最好关闭这个preference项 – false

extensions.keysnail.keyhandler.global_enabled

避免在其他的chrome窗口输入信息时出问题。

20110512更新 – 更新6. UI设置

Pentadactyl 是由 Vimperator 项目最活跃的开发者 Kris Maglione、Doug Kearns、Martin Stubenschrott维护的针对 Firefox4的一个分支。

官方介绍：

Pentadactyl is a free browser add-on for Firefox, designed to make browsing more efficient and especially more keyboard accessible. Largely inspired by the Vim text editor, the appearance and finger feel of Pentadactyl should be familiar to Vim users.

Dactyl is a fork of the Vimperator project by most of its primary developers.

————————————————————–
目录：
1. 安装

1.1 新建个profile
1.2 创建一个新的启动快捷方式
1.3 安装pentadactyl扩展

2. 配置

2.1 启动
2.2 生成rc文件
2.3 保存配置到rc文件
2.4 查看_pentadactylrc文件内容
2.5 直接编辑_pentadactylrc文件
2.6 多套配置切换
2.7 查看当前生效的配置文件路径

3. 熟悉基本键和命令

3.1 支持ctrl+c/v
3.2 标签操作

3.2.1 打开标签
3.2.2 关闭标签
3.2.3 Lock/Protect/Pin标签
3.2.4 移动标签

3.3 页面浏览
3.4 搜索

3.4.1 一般搜索
3.4.2 站内搜索
3.4.3 页面搜索

3.5 缓冲区

3.5.1 查看缓冲区信息
3.5.2 复制缓冲区对应的页面地址
3.5.3 缓冲区列表（支持filter标签）

3.6 书签

4. Hints

4.1 Hint模式

4.1.1 Quick Hint
4.1.2 Shift Quick Hint
4.1.3 Extended Hint
4.1.4 Persisted Extended Hint
4.1.5 Caret Hint

4.2 相关配置项

5. options设置
6. UI设置

6.1 guioptions
6.2 状态栏
6.3 命令行访问GUI

7. plugins插件

7.1 插件存放
7.2 插件加载
7.2 插件推荐

8. 相关资料和站点
9. to do
———————————————————————————–
使用手记：

• 安装
  1. 新建一个profile
     使用profile manager创建一个新的profile – pentadactyl

     firefox.exe -profilemanager

     与原来的profile共存一起用

  2. 创建一个新的启动快捷方式
     使用如下启动参数启动pentadactyl的profile

     -no-remote -P pentadactyl -pentadactyl "++cmd 'js services.environment.set("HOME", services.directory.get("ProfD", Ci.nsIFile).path)"'

     -P指定profile为pentadactyl
     -pentadactyl是用来配置pentadactyl扩展的参数，后面再说
     到这就可以用这个快捷方式启动pentadactyl专用的firefox了

  3. 安装pentadactyl扩展
     • mozilla的add-on站，下载页面
     • 扩展主页 – pentadactyl
     • googlecode页面 – 1.0b6，点击安装
     • 每夜版的下载目录
• 配置
  1. 启动

  pentadactyl跟vim一样有rc文件用来保存配置，在扩展启动时读取，这样我们辛苦做的配置工作就不会白费。
  由于用的firefox是绿色便携的，所以希望rc文件也能便携，并且我准备放到新建的profile目录里，便于维护。

  -pentadactyl "++cmd 'js services.environment.set(\"HOME\", services.directory.get(\"ProfD\", Ci.nsIFile).path)'"

  或者

  -pentadactyl "++cmd 'js services.environment.set(''HOME'', services.directory.get(''ProfD'', Ci.nsIFile).path)'"

  （这两种是比较通用的写法，更多的参见这贴的讨论）

  前面提到的firefox启动参数中有这么一段，这是pentadactyl用的启动参数。
  ++cmd用来在pentadactyl做初始化工作前执行Ex命令。

  'js services.environment.set("HOME", services.directory.get("ProfD", Ci.nsIFile).path)'

  这个执行的Ex命令就是设置系统的环境变量$HOME为profile目录。
  这样pentadactyl就可以在初始化时从profile目录去读取rc文件了。
  —————— 感谢tuantuan的指点

  关于更多-pentadactyl的启动参数，请查看帮助

  :help startup-options

  2. 生成rc文件

  :mkp

  这个命令会在$HOME（现在就是profile目录）下生成_pentadactylrc配置文件用于保存配置
  （mkp – make pentadactyl rc file，vimperator下是mkv[imperator]，害得我试了半天=_=|||）

  3. 保存配置到rc文件

  以后如果更改了配置，可以通过下面的命令将更新保存到刚才生成的rc文件中

  :mkpentadactylrc!

  问题？？
  mkp!似乎只能覆盖保存当前键映射和设置的options到rc文件中，所以如果原来在_pentadactylrc文件中手动添加了其他内容，比如javascript代码，mkp!后这些内容不会重新写入到新的_pentadactylrc里。

  4. 查看_pentadactylrc文件内容

  自定义一个Ex命令(:rc)，用来在firefox中直接用新tab查看rc文件内容

  :com! rc -description "Open _pentadactylrc file" -js gBrowser.selectedTab = gBrowser.addTab("file:///"+Components.classes["@mozilla.org/file/directory_service;1"].getService(Components.interfaces.nsIProperties).get("ProfD", Components.interfaces.nsIFile).path+"/_pentadactylrc");

  5. 直接编辑_pentadactylrc文件

  自定义一个Ex命令(:erc)，用来通过外部编辑器直接编辑rc文件

  :com! erc -description "Edit _pentadactylrc file" -js editor.editFileExternally(Components.classes["@mozilla.org/file/directory_service;1"].getService(Components.interfaces.nsIProperties).get("ProfD", Components.interfaces.nsIFile).path+"\\_pentadactylrc")

  【注意！！】
  直接编辑rc文件不能生效（如果这时候用:mkpentadactyl!命令保存设置会覆盖刚才直接编辑更改的内容），需要重新载入。
  可以用:rehash命令

  :rehash

  rehash命令会重新load整个扩展，或者用下面的命令只重新load rc文件

  :source $HOME/_pentadactylrc

  为此我重新定义了Ex命令 – fresh

  :com! fresh -description "Reload _pentadactyl rc file" source $HOME/_pentadactylrc

  【推荐】
  另外，如果编辑器用的是vim，可以导出pentadactyl的语法文件到vim，使vim编辑rc文件时可以语法高亮。

  :mks!

  生成pentadactyl的语法文件pentadactyl.vim。
  （mks命令可以指定生成的语法文件的保存路径。不指定的话会自动识别vim的runtime路径，如果vim安装时注册表没问题，会在syntax文件夹下生成语法文件；否则的话，可能会在pentadactyl的runtime路径下生成，需要手动拷到vim的syntax文件夹下）

  生成了语法文件后，在vim的rc文件中配置如下内容

  au BufRead,BufNewFile _pentadactylrc set filetype=pentadactyl
  au! Syntax pentadactyl source ~/syntax/pentadactyl.vim

  再用vim打开_pentadactylrc时即可开启语法高亮。

  6. 多套配置切换

  用下面的命令可以实现多套配置热切换（无须重启firefox）

  :js services.environment.set("HOME", "another home path")
  :rehash
  

  rehash用于重新加载pentadactyl扩展，包含扩展的所有初始化代码，plugins以及配置。

  7. 查看当前生效的配置文件路径

  :scriptnames

  这个命令会按顺序列出所有被source的脚本文件的绝对路径，其中第一个就是rc文件。

• 熟悉基本键和命令
  开始折腾键和命令之前，先设置如下CSS

  :style chrome://* #dactyl-commandline-command input {ime-mode: inactive;}
  :style chrome://* #dactyl-statusline-field-commandline-command input {ime-mode: inactive;}
  

  保证进入命令行时输入法是disable的，这样方便输入命令。（注意这个css在linux下不支持 – ime-mode: inactive）

  关于键命令的使用方法，参见另一篇Pentadactyl键详解

  1. 支持ctrl+c/ctrl+v

  pentadactyl为了还原vim的操作体验，几乎重新定义了firefox所有的快捷键，甚至包括终极创新之法ctrl+c/ctrl+v
  下面的命令可以找回我们熟悉的这套快捷键。

  ctrl+c复制

  :noremap <C-c> <C-v><C-c>

  noremap命令是用来映射键的，这行的意思是重新定义键ctrl+c为pentadactyl中的键序列ctrl+v，ctrl+c
  在pentadactyl中，ctrl+v是用于直接传递后续按键给firefox，所以这个按键序列就相当于在firefox按ctrl+c，这样就实现了firefox原来的ctrl+c复制功能。

  这里要用noremap而不能是普通的map命令，因为这条映射的目标定义键（ctrl+c）和使用的实现键（ctrl+v ctrl+c）里面都有ctrl+c，用一般的map的话，实现键里面的键会使用用户定义键，这样就会导致无限递归。而用noremap命令的话，实现键序列中的键只会用系统定义键。（noremap等价于使用-builtin参数的map）

  采用未加模式前缀的noremap命令，可以支持normal和visual模式。
  所以这条命令等价于

  :nnoremap <C-c> <C-v><C-c>
  :vnoremap <C-c> <C-v><C-c>
  

  这样还剩下insert和command line模式

  :inoremap <C-c> <C-v><C-c>
  :cnoremap <C-c> <C-v><C-c>
  

  或者用这一条命令，它包含了上面这几条映射。

  :map -modes=n,v,i,c <C-c> -builtin <C-v><C-c>

  到这里，ctrl+c就已经找回来，别忘了用mkp保存到rc文件。

  ctrl+v黏贴
  ctrl+v只有在insert和command line才需要

  :inoremap <C-v> <C-v><C-v>
  :cnoremap <C-v> <C-v><C-v>
  

  ctrl+x剪切

  :inoremap <C-x> <C-v><C-x>
  :cnoremap <C-x> <C-v><C-x>
  

  ctrl+z撤销jj

  :inoremap <C-z> <C-v><C-z>
  :cnoremap <C-z> <C-v><C-z>
  

  ctrl+a全选

  :noremap <C-a> <C-v><C-a>
  :inoremap <C-a> <C-v><C-a>
  :cnoremap <C-a> <C-v><C-a>
  

  ——————-
  其实，pentadactyl中给map相关命令引入了一个特殊字符 – <Pass>
  这个特殊字符可以把前面mapping的键直接传给firefox，所以上面的可以统一写成

  map -m n,v,i,c,t <C-a> <Pass>
  map -m n,v,i,c,t <C-c> <Pass>
  map -m i,c,t <C-v> <Pass>
  map -m i,c,t <C-x> <Pass>
  map -m i,c,t <C-z> <Pass>
  

  —————— 感谢harnack的指点

  2. 标签操作

  标签选择

  Ctrl+n(ext) -下一个标签
  Ctrl+p(revious) - 上一个标签
  gt - 下一个标签
  gT - 上一个标签
  g0 - 第一个标签
  g^ - 第一个标签
  g$ - 最后一个标签
  

  这一套键跟vim是一样的，可以看出来按键是按照表意来设计的，容易记，但是我一直都用不惯，按起来不舒服。
  在浏览器下，标签切换频繁，操作一定要方便，所以回头还得重新进行键绑定。

  Ctrl+^

  切换到上次选的标签，连续使用可以实现在两个标签间切换。

  [count]b - 切换到第[count]个标签

  比如：1b就跟g0是一样的效果，切换到第一个标签。
  单独按一个b可以列出所有的标签，然后通过(shift+)tab也可以在标签间切换。
  单独b后空格，跟URL或者keyword，就是swith-to-tab功能。
  其实这里的b是buffer的意思，是pentadactyl中很重要的一个概念，回头细讲。

  打开标签
  最基本的几个命令

  o - 在当前tab打开 - o(pen)
  t - 在新tab打开 - t(abopen)
  w - 在新窗口打开 - w(inopen)
  

  支持打开单个URL，多个URLs（URL之间的分隔符可以通过配置项urlseparator设置），书签（关键字），指定搜索引擎搜索，用默认搜索引擎搜索（默认引擎通过配置项defsearch设置）；
  另外打开命令还提供了非常强大的completion（细节请查阅配置项complete和autocomplete）

  p - 用剪切板的内容在当前标签打开
  P - 这个是新开标签
  

  剪切板中的内容如果是URL，就按地址打开，否则搜索（用默认的搜索引擎）。
  这里我交换两个键的定义，一般我喜欢新开标签

  noremap p P
  noremap P p
  

  复制当前标签

  :tabdu[plicate]
  T<CR>
  

  最好配上openTabNextToCurrent.uc.js脚本，要不复制的标签追加在最后，很别扭。
  关闭标签

  d - 关闭当前标签并选中右边的
  D - 关闭当前标签并选中左边的
  

  像vim一样，命令前可以加数量前缀指定关闭的标签数，比如2d – 从当前标签开始关闭2个

  :tabc(lose)

  拜completion之福这个命令可以看到所有的标签，用(shift+)tab选择关闭。（这个挺有用的，我经常会不知不觉就开了几十个标签，用这个选择关闭很方便）

  这个命令后面可以跟参数keyword，这样会关闭所有主机名包含keyword的标签。
  比如，我针对baidu开了很多标签，用这个命令:tabc baidu就可以一次性把baidu的标签都关闭。
  如果加上!，:tabc!不仅用主机名来匹配关键字，还会匹配URL和title。

  :tabo(nly)

  关闭当前标签之外的所有标签

  u - 恢复一个已关闭标签 - 可以加[count]前缀指定恢复第几个
  :undoa[ll] - 恢复closed标签列表中的所有标签
  

  Lock/Protect/Pin标签
  这个是不是pentadactyl还不支持。

  (un)pin在1.0b6中不支持，每夜版可以，感谢harnack指出

  :pin
  :unpin
  :pin! 这个是切换pin状态
  

  移动标签

  :tabm[ove][!] [+N] | [-N]
  :tabm 0                 - 移到第一位
  :tabm                    - 移到最后一位
  :tabm 4                 - 移到第4个标签后面， 就是变成第5个
  :tabm -1                - 向前移动1位
  :tabm +2               - 向后移动2位
  

  指定N的话，是移到第N个标签的后面，就是成为第N+1个
  N加+/-号的话，是相对移动。
  tabm!，命令加!，移动时到边界了会循环，默认时不循环。

  3. 页面浏览

     k
   h   l
     j
  

  最基本的上下左右，熟悉vim的都用惯了。
  但是浏览时，一行一行移有点慢，重新定义下多移几行

  :noremap j 5j
  :noremap k 5k
  

  另外h和l基本上也是用不到的，我重新映射成“切换到前/后一个标签页”

  :map -m=n h -builtin <count>gT
  :map -m=n l -builtin <count>gt

  ctrl+b 向上滚一屏
  ctrl+f 向下滚一屏
  ctrl+u 向上滚半屏
  ctrl+d 向下滚半屏
  

  如果scroll配置项设置了非0值，ctrl+u/d按scroll行来滚屏

  gg 滚屏到页面顶端
  G 滚屏到页面底部
  50% 按百分比滚屏
  0 屏幕左移到头
  ^ 屏幕左移到头
  $ 屏幕右移到头
  

  4. 搜索

  首先清理搜索引擎列表

  :dialog searchengines

  打开firefox的搜索引擎编辑窗口，删除不用的引擎，并安装需要的
  最后保留

  google - keyword: google
  google ssl - g
  baidu - b
  

  设置默认引擎为google ssl

  :set defsearch=google-ssl

  一般搜索

  t keyword1 keyword2

  用默认引擎新开tab搜索

  t b keyword1 keyword1

  用其他引擎（baidu已设搜索引擎关键字b）新开tab搜索

  p

  如果已经复制了搜索关键字，直接p用默认引擎新开tab搜索（参考“打开标签”章节相关内容）

  因为搜索挺频繁的，所以一定要简化操作
  【☆推荐】

  :map t -js content.getSelection().toString()!=""?dactyl.execute(":tabopen "+ content.getSelection()):CommandExMode().open("tabopen ")
  :map o -js content.getSelection().toString()!=""?dactyl.execute(":open "+ content.getSelection()):CommandExMode().open("open ")

  重定义t和o：
  如果有文字链接被选中，则直接打开链接；如果被选中的是一般文字，则用默认搜索引擎搜索；否则打开:tabopen或者:open命令行，手动输入关键字搜索。

  【☆推荐】
  网友x有一个搜索需求：如果选中的文字是空格分隔的多个关键字，则用默认搜索引擎开多个标签分别进行搜索
  首先rc文件中定义如下函数

  javascript <<EOF
      dactyl.mulSearch = function() {
          let selection = content.getSelection().toString();
          if(!selection || /^\s*$/.test(selection)) {
              CommandExMode().open("tabopen ");
          } else {
              let keywords = selection.replace(/^\s*/, "").replace(/\s*$/, "").split(/\s+/);
              keywords.forEach(function(keyword) {
                  dactyl.execute(":tabopen " + keyword);
              });
          }
      };
  EOF
  

  然后映射t为对应的功能键

  :map t -js dactyl.mulSearch();

  对于有很多搜索引擎的用户，可能希望搜索时能够指定一下引擎。
  这两行命令映射S键：弹出搜索引擎列表，可以指定引擎搜索选中内容。
  【☆推荐】

  :com! -nargs=? -complete=search engineSelect exe 't <args> ' + content.getSelection()
  :map S :engineSelect<Space>
  

  按了S后就能自己输入搜索引擎关键字（当然也可以在自动补全菜单里选择），如果不选直接回车就是用默认引擎（对于选中的恰好是链接的情况则是直接打开链接） ——————–by harnack

  还有一种搜索需求：当我用google搜索了一个内容后，可能还想再用baidu搜索一下，这时候我不想再重新输入一遍要搜索的内容，希望能够直接切换引擎搜索刚才的内容。
  【☆推荐】

  :com! -nargs=? -complete=search switchenginesearch exe 'o <args> ' + (buffer.lastInputField?buffer.lastInputField.value:'')
  :map s gi<ESC> :switchenginesearch<Space>
  

  映射键s：在某个搜索引擎结果页面按s键，会弹出引擎列表，选中引擎直接更换引擎用当前搜索的内容重新搜索。

  站内搜索
  定义一个Ex命令 – sitesearch，用google站内搜索API搜索当前站点

  :com! -nargs=* sitesearch exe "t http://www.google.com/search?q=" + encodeURIComponent("<args>") + "&sitesearch=" + window.content.location.hostname

  对应baidu的

  :com! -nargs=* sitesearch exe "t http://www.baidu.com/s?ie=utf-8&word=" + encodeURIComponent("<args> site:" + window.content.location.hostname);

  页面内搜索

  / 正向查找
  ? 反向查找
  

  大小写是否敏感，可以通过findcase配置项设置（ignore，match）
  也可以通过在命令中加转义序列

  \c 不敏感
  \C 敏感
  

  转义序列中还有

  \l 只查找links

  另外，pentadactyl中查找都是从当前位置开始，不像firefox总是从头开始查找

  可惜的是，目前还不支持正则表达式。

  n 查找下一个
  N 查找上一个
  

  这里好像n/N并不会根据/?而变化，我记得vim中使用?查找后，再用n也是反向查找的。目前pentadactyl中，n永远是向下查找下一个。

  * 直接向后查找当前光标下的单词
  # 反向
  

  这个命令不用选中文字，在单词上点击一下鼠标就可以开始查找了，非常方便，但中文下不太有用。

  -> 高亮
  通过下面两个配置项可以配置高亮规则

  :set hlfind    所有的匹配都会高亮
  :set nohlfind 只高亮当前匹配
  

  自定义一个命令hl用来toggle高亮
  【☆推荐】

  :command! hl set hlf!

  5. 缓冲区

  缓冲区(buffer)是vim中的一个概念，最初vim编辑器是单窗口模式，但为了方便同时操作多个文件，采用了缓冲区。每一个文件对应一个缓冲区，里面存储着被打开的文件。这样，如果没有把缓冲区里的文件存盘，那么原始文件不会被更改。同时，可以通过切换缓冲区来实现通过一个窗口编辑多个文件。

  pentadactyl也有对应的概念，pentadactyl中每个缓冲区对应一个tab，保存着对应网页的内容，包括所有的frames以及历史信息。目前缓冲区可以等价的理解成标签，但也不排除以后会有别的东西出现的可能。

  查看缓冲区信息

  <C-g> 查看buffer的基本信息 - 当前文件名，最后修改时间，feed数量，标题
  g<C-g> 查看buffer的详细信息，与:pageinfo等价
  gf 查看页面源代码/切换回原始页面
  gF 用外部编辑器查看页面源代码
  

  复制缓冲区对应的页面地址
  快捷键y可以复制当前缓冲区对应的URL地址到剪切板

  y

  我们还可以定义一个快捷键<c-y>用于复制当前打开的所有标签的URLs

  :map <c-y> -d "Yank all locations to the clipboard" -e yank :tabdo :echo buffer.uri.spec

  相应的，对应于快捷键p，再定义一个<c-p>用于打开多个URLs
  首先，rc文件中添加如下javascript函数

  javascript <<EOF
  tabs.openURLs = function() {
          let urls = dactyl.clipboardRead();
          let urlsArray = urls.split(options.get("urlseparator").value);
          for(var i in urlsArray) {
              dactyl.open(urlsArray[i], { from: "paste", where: dactyl.NEW_TAB });
          }
      };
  EOF
  

  然后，定义键<c-p>

  :map <c-p> -d "Open urls based on the current clipboard contents" -js tabs.openURLs();

  这个快捷键可以打开剪切板中的一组URLs，这些URLs之间必须用配置项urlseparator设置的分隔符分隔，默认的分隔符是竖线|
  所以，如果想支持打开通过<c-y>复制得到的URLs，还需要添加分隔符-回车换行符

  :set urlseparator='(\||\s+)'

  这样设置urlseparator就可以支持|或者任何空白字符（包括换行）作为URLs的分隔符。

  缓冲区列表

  B or :buffers

  所有的缓冲区（标签页）会以一个列表的形式呈现：
  1. app tab和一般的tab会分开显示。
  2. 带%标记的对应当前tab
  3. 带#标记的对应上一次选择的tab，可以通过<C-^>跳转过去

  Ex命令形式:buffers可以加filter参数，只显示符合filter条件的缓冲区。

  【问题??】
  （shift+)tab选中buffer后不能直接对对应的标签页进行操作，比如按d删除，按enter跳转等。

  b

  这个快捷键也是显示buffer列表，但是可以通过tab选中跳转到某个buffer
  如果加数字前缀修饰，直接跳转到对应位置的标签，比如1b = g0跳转到第一个标签， 4b跳转到第4个标签

  最后，还有一个有意思的功能

  :pagest[yle] [stylesheet]

  有些站点会提供多套CSS样式，通过pagestyle命令可以热切换
  （本站未提供=_=|||，想试的可以去firefox英文论坛）

• Hints
  脱离了鼠标，只用键盘，那么该如何与网页上的可点击元素交互呢？
  pentadactyl里采用的方案是hints。

  进入hints模式后，网页上的可点击元素都会被高亮，并用数字或者字母编号。这时候输入对应编号的字符就可以narrow down高亮元素，当能够唯一定位一个元素时，即执行点击动作。

  默认情况下，是用数字给元素进行编号的。

  • 缺点是：数字在键盘上的分布并不适合方便快速地输入编号
  • 优点是：定位元素时，不仅可以采用输入数字编号，还可以输入元素上的文字（Follow Hint）

  这个优点只对英文有效，不过针对中文有一个插件 – pinyin-hints-mod.js
  可以通过输入文字对应的拼音首字母来作为Follow Hint定位元素

  通过配置项hintkeys可以修改编号时使用的字符，我个人习惯用字母编号（尽管这样就不方便使用Follow Hint了）

  :set hintkeys='asdfjklgheriop'

  如果页面上可点击元素过多，编号显示就会比较密集，看不清楚

  :hi Hint font:bold 15px "Droid Sans Mono", monospace !important; margin:-.2ex; padding: 0 0 0 1px; outline:1px solid rgba(0, 0, 0, .5); background:rgba(255, 248, 231, .8); color:black; text-transform:uppercase;

  使用这个样式可以使编号更醒目（字体大号、加粗、大写 – 输入时用小写就行）

  • Hints有好几个子模式：
    1. Quick Hint

    按f键即可进入这个最基本的hint模式。

    2. Shift Quick Hint

    在按f进入的hint模式下，唯一定位到一个元素时会自动触发点击动作，如果元素是链接一般是在当前页面跳转。
    而在按F键进入的Shift QuickHint模式下，触发点击动作时等效于按着shift键点击，所以针对链接可以实现在新标签页打开。

    3. Extended Hint

    上面两个模式会高亮页面上所有的可点击元素，而且定位元素后直接触发点击动作。
    使用扩展hint模式，可以更灵活地控制高亮元素的范围，比如只高亮超链、只高亮图片等；可以控制定位元素后的触发动作，比如复制链接地址、另存图片等。

    ;{mode}{hint}
    按;键进入扩展Hint模式后，可以通过再输入一个模式字符进行进一步的控制。
    

    4. Persisted Extended Hint
       上面几个Hint模式，在定位元素触发动作后即自动退出Hint模式。
       而持久的扩展Hint模式，在触发动作后仍然保持在Hint模式，因而可以实现连续打开一组链接这样的需求。

       要进入持久的扩展Hint模式，只需在一般的扩展模式前多按一个g键。
       g;{mode}{hint}

    5. Caret Hint

    使用Caret Hint可以通过hint的方式来快速移动caret光标，方便caret定位以及文字选择。
    pentadactyl本身没有内置Caret Hint，但是有个plugin可以实现。
    目前我使用harnack的简化版本
    操作命令如下：

    ;m - 移动Caret到选中hint元素的文字头
    ;M - 移动Caret到选中hint元素的文字尾
    ;e - 选中hint元素文字
    

  • 相关配置项
  • hintinputs
  • hintkeys

  定义用于给hint元素编号的字符集

  • hintmatching
  • hinttags

  设置hint元素的选择规则。
  支持css selector和xpath（以xpath:打头表示）两种语法

  • extendedhinttags

  设置扩展hint模式下元素的选择规则。
  可以针对不同模式设置选择规则，优先级比hinttags的设置高

  [f]:body

  • hinttimeout

  设置hint自动触发时间（单位ms，默认值0）
  值为0时，只有选中hint元素回车确认或者能够唯一定位一个hint元素时才会触发动作。
  如果设置了正值，只要按了hintkeys中的按键，就开始计时，当hinttimeout时间过后，即使仍有多个hint元素待选，也会自动触发。

• options设置
  • passkeys

  由于Pentadactyl全面接管了快捷键，对于重度依赖快捷键操作的站点（比如google的众多服务）来说，会存在很大的问题。
  通过passkeys这个配置项，可以针对URL来设置哪些键不由pentadactyl处理，而直接传递给firefox。

  :set passkeys=www\.google\.com/reader/:jkovA

  这个示例设置是针对我常访问的google reader的，直接传递jkovA这几个常用的快捷键。
  语法是这样的：

  URL部分采用正则表达式用来指定站点（注意，由于是正则表达式，所以regex的元字符要转义），如果有冒号需要用引号括起
  冒号（:）
  需要传递的键（序列）以逗号（,）分隔。如果是单键不需要用逗号分隔，集中放在第一个逗号之前；如果是多个键组成的序列，放在第一个逗号之后，多个的话以逗号分隔。
  针对不同URL的设置用逗号（,）分隔
  

  其实，passkeys的值类型从1.0b6版本已经由regexpmap更改为sitemap，完整的定义是这样的

  {Site Filters}:{Passed Keys},{Site Filters}:{Passed Keys}

  通过查看帮助，可以看到用Site Filters表达URLs有4种方法

  :help site-filter

  1. domain

  通过域名这种方式可以匹配该域名及其子域名下的所有站点。
  比如baidu.com，twitter.com

  2. URL prefix

  一个“URL前缀”表示有两点要求，1要以协议名开头，比如http，https；2要以*号结尾。比如

  http://www.google.com/reader/*

  这样一个URL prefix可以匹配所有以此开头的URLs
  注意事项：

  • 因为协议名后的:号与{Site Filters}:{Passed Keys}中的:号冲突，所以URL prefix需要用引号括起
  • 使用命令行设置的URL prefix形式的passkeys，不能通过:mkpentadactyl!保存到rc文件中，因为保存时引号会被自动删掉（bug？），重新source rc后该passkeys就不再工作。所以使用URL prefix要么直接手写到rc文件中，要么只能临时生效。
  3. Full URL

  以协议名开始而不以*结尾的URL就是一个完整的URL，只匹配这个完整的URL

  4. Regular expression

  不是上述三种情况的时候都理解成正则表达式，正则表达式要注意转义，否则不能工作。
  另外要注意，因为解析的时候优先按照前三种来，所以有时候直接写正则表达式可能会不工作。
  比如，这个针对google reader的正则表达式

  'http://www\.google\.com/reader/.*'

  就不工作，原因是由于以协议名打头，所以它被理解成full URL。
  写成下面的就可以

  www\.google\.com/reader/.*

  所以用正则表达式来做passkeys要格外注意这种情况。

  {Passed Keys}部分前面已经说过了，是以逗号分隔的键（序列）。

  • 所有的单键写在一起，放在第一个逗号之前
  • 多个键组成的键序列，放在第一个逗号之后，并且键序列之间用逗号分隔

  针对多个站点的passkeys设置{Site Filters}:{Passed Keys}再以逗号分隔或者通过

  :set passkeys+=

  追加。

• UI设置
  • guioptions

  通过该配置项可以控制firefox的GUI显示，可以简写成go
  go的值是一个字符列表，每个字符对应一个可控GUI元素，包含在go中的会显示出来。
  通过命令操作：

  :set go+=x      让x对应的GUI元素显示出来
  :set go-=x      让x对应的GUI元素不显示
  :set go=abc    只显示a,b,c对应的GUI元素
  

  目前支持控制的所有GUI元素
  
  其中

  • T对应Toolbar，实际上就是我们熟悉的导航栏。
  • 大C只在状态栏显示（即go中包含s）的情况下有效。

  有大C时，用:呼出的命令行会单独有一行；否则的话，命令行集成在状态栏里

  • 小c控制是否始终显示命令行

  如果设置了的话，即使没有敲ex命令，也会有一行空白的命令行显示
  如果有状态栏s，小c最好和大C一起设置，否则命令行还是集成在状态栏里，ex命令不会显示在新加的单独命令行里，新加的这行只显示 — EX — 这种信息。

  • M用来控制是否用独立行显示提示信息，比如Please ENTER or type command to continue这种，一般是显示在状态栏的
  • 显示标签编号，n是在site icon后显示，N是在icon上，建议用n，N会遮盖图标
  • 状态栏

  通过命令

  :set go+=s

  可以开启状态栏显示。

  状态栏会显示如下信息：

  • 当前页面URL，另外也可以显示鼠标所悬停的页面上链接信息
  • [+-❤⋯]

  +代表当前页面有后退历史，可以用H键后退
  -代表当前页面有前进历史，可以用L键前进
  ❤代表当前页面已经存为书签
  其他字符代表有对应的QuickMark

  通过下面这个plugin可以把这组符号信息挪到URL之前，看起来更直观。
  urlFieldTweak.js

  • 标签位置索引

  [N/M] N对应当前标签的序号，M对应所有标签的总数

  • 当前位置在页面纵向scroll的百分比
  • 当前页面的水平和垂直方向的最大像素

  [x=N,y=M] N代表水平方向，M代表竖直方向，单位像素
  这个需要plugin – pageScrollInfo.js

  • 当前页面放大缩小的百分比

  100%大小时不显示

  状态栏的颜色可以用于查看站点的安全信息
  

  • 命令行访问GUI

  通过下面这些ex命令，可以直接访问firefox 的GUI

  :emenu {menu} 打开菜单
  :dia[log] [Firefox-dialog] 打开firefox的各种对话框
  :downl[oads] 显示下载相关信息
  :toolbarshow {name} 显示toolbar
  :toolbarhide {name}
  :toolbartoggle {name}
  

• plugins插件
  • 插件存放
  1. 插件应该存放在名为plugins的文件夹下
  2. pentadactyl会从配置项runtimepath定义的文件夹中查找plugins子文件夹
  3. 可以有多个plugins文件夹
  4. runtimepath默认值是$PENTADACTYL_RUNTIME，如果没设置，windows系统下则是$HOME/pentadactyl，其他系统下是（$HOME/.pentadactyl）

  所以，在windows下，默认情况插件应该放在$HOME/pentadactyl/plugins文件夹里。

  5. 我准备把plugins放到profile文件夹下，因此需要将profile加到runtimepath中，由于已在启动参数设置$HOME为profile，所以

  set runtimepath+=$HOME

  • 插件加载
  1. 根据上述查找方式找到的所有plugins文件夹里的脚本文件会被加载
  2. 脚本文件通过配置项loadplugins来控制识别，默认是以.js和.penta结尾的文件
  3. 设置配置项noloadplugins可以关闭所有脚本的加载，但是最新每夜版（hg6126）无此参数，不过可以通过设置loadplugins达到同样的目的

  set loadplugins=''

  4. 设置如下启动参数（++noplugin或者+u=NONE），同样可以关闭脚本加载。具体请查看帮助

  :help startup-options

  • 插件推荐
  1. goo.gl

  集成google短地址服务

  • 相关资料和站点
    1. 团子的小窝 – Vimperator新手教程
    2. 团子的小窝 – Vimperator[Pentadactyl]小技巧
    3. Mozest论坛讨论帖 – Dactyl[Vimperator分枝]一些使用经验,期待交流
  ]]> http://www.slimeden.com/2011/03/firefox/pentadactyl/feed 95 http://www.slimeden.com/2011/03/firefox/viewomnijar http://www.slimeden.com/2011/03/firefox/viewomnijar#comments Mon, 14 Mar 2011 10:01:30 +0000 admin http://www.slimeden.com/?p=215 代码库直接查看源代码。 firefox内核部分，包括底层平台框架、执行渲染引擎等用C++编写，然后编译链接打包后分发，这部分去其代码库可以看到C++源码，有兴趣的可以下载后修改，重新编译打包，这部分不是今天讨论的主题。 今天我们主要关注的是前端用户接口（User Interface），这部分大部分是用html、javascript、css等web技术以及mozilla自己的界面语言xul实现，基于文本的，不需要编译，所以我们很方便查看学习，甚至写些小脚本修改界面元素，定制自己喜欢的界面。 firefox 4.0之前在其安装目录下可以直接看到chrome、co[......]

  阅读全文

  ]]> firefox是开源的项目，可以在其代码库直接查看源代码。

  firefox内核部分，包括底层平台框架、执行渲染引擎等用C++编写，然后编译链接打包后分发，这部分去其代码库可以看到C++源码，有兴趣的可以下载后修改，重新编译打包，这部分不是今天讨论的主题。

  今天我们主要关注的是前端用户接口（User Interface），这部分大部分是用html、javascript、css等web技术以及mozilla自己的界面语言xul实现，基于文本的，不需要编译，所以我们很方便查看学习，甚至写些小脚本修改界面元素，定制自己喜欢的界面。

  firefox 4.0之前在其安装目录下可以直接看到chrome、components、modules等目录，里面就能找到这些用户接口的源文件（比如主Chrome界面browser.js – %installationpath%/chrome/browser/content/browser/browser.js），打开就能看。但是4.0之后，考虑到性能因素，这些文件已经打包成一个单独的omni.jar，而且由于打包压缩的优化导致一些压缩软件（比如7zip）无法正常打开omni.jar，这样造成了很大的不便。

  对于喜欢写脚本扩展或者热衷于学习firefox界面源码的人来说，这种麻烦很影响效率和心情。下面这段代码就是为了解决这个问题，通过在firefox里直接查看omni.jar。

  var dirService = Components.classes["@mozilla.org/file/directory_service;1"].getService(Components.interfaces.nsIProperties);
  
  var installationDirFile = dirService.get("CurProcD", Components.interfaces.nsIFile);
  var installationDir = installationDirFile.path;
  var omnijarURL = "jar:file:///" + installationDir + "/omni.jar!/";
  
  var browser = document.getElementById("content");
  var tab = browser.addTab(omnijarURL);
  browser.selectedTab = tab;
  

  使用快捷键（keyconfig、keysnail）或者手势（firegesture）扩展用这段代码就能用一个新tab打开omni.jar。
  

  ]]> http://www.slimeden.com/2011/03/firefox/viewomnijar/feed 11