Mac 有人成功开启过 Dash 里面的 Ruby Gems 吗?

hpyhacking · 2014年01月09日 · 最后由 luikore 回复于 2014年01月09日 · 3307 次阅读

我已经把项目下 bundle exec gem env gempath 手工加入进去了(按照 rdoc 的方式生成了已经),Index 以后还是未能出现相关的文档。

共收到 12 条回复

连最基本的 bundler 的都出不来

我的 bundler 是有的,但也不是所有的 gems 都能查到

貌似 gem 目录下的 README 是不能被收录的

#3楼 @hpyhacking 感觉Dash用来查Ruby和Rails的文档很不错,其他gems还是直接看 github 比较靠谱,或者用 pry 看代码也是个不错的选择

刚刚试了下, 可以的耶

#4楼 @lululau 确实,但没网的情况下想看 Gem 的 Doc 很苦逼。

一直都是用 bundle show gem_name 得方式拿到 gem 安装路径,然后把 gem 得源码当文档看。

我觉得关键是很多 gem 写得好得人,很大一部分人注释文档写的不好,所以也不指望生产高质量得 RDoc 文档。

#7楼 @lgn21st 这个方法好,本地配合一个 MD 阅读器就非常好用了。

Dash不能识别Rdoc 4.1.0生成的html rdoc文件。 刚打开Dash能识别几个Gem的Doc,看了下Rdoc 4.1.0和Rdoc 3.x.x生成的html文件开头标签有些不一样,可能Dash就识别不了。必须生成的是HTML格式的doc, .ri格式Dash肯定也不能识别。 试了试换了rdoc 3.9.5就能识别。 gem uninstall rdoc gem install rdoc -v '3.9.5'

gem rdoc --rdoc --all --overwrite 重新生成文档 要是旧版本的rdoc生成doc过程中有encoding error问题的话

export LANGUAGE=en_US.UTF-8
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

写到.bashrc或.zshrc中,让rdoc默认使用utf-8就没问题了。

再打开Dash重新导入下Ruby Installed Gems Docset,设置好要index的gempath

不如直接用编辑器插件查 ri (rbenv shell system; rvm use system; sudo gem ins bcat)

#!/usr/bin/env ruby

require "shellwords"
word = ENV['TM_SELECTED_TEXT'] || ''
if word.empty?
  word = ENV['TM_CURRENT_WORD']
end

puts "<pre>"
system "ri -f ansi #{word.shellescape} | a2h"
puts "</pre>"

需要 登录 后方可回复, 如果你还没有账号请点击这里 注册