黃金俠

透過 sidekiq 實作背景工作 (background job)

Sat, 8 Jun 2013 15:08:00 +0800

sidekiq 是一套可以用來實作 background job 的 gem
舉凡長時間的執行如 email, 點數計算等等非即時性的工作, 都可以採用非同步執行
以加速前端服務的反應速度或減低主機負荷
和 resque 一樣，sidekiq 是以 redis 做為 Message Queue 來運作…

安裝

本教學所使用的版本是 2.12.1

Gemfile

gem "sidekiq", "~> 2.12.1"

設定 redis
關於 redis 安裝可參考 http://pm.5fpro.com/projects/public-wiki/wiki/Redis

Sidekiq.configure_server do |config|
  config.redis = { :url => "redis://127.0.0.1:6379/0" }
end

Sidekiq.configure_client do |config|
  config.redis = { :url => "redis://127.0.0.1:6379/0" }
end

使用 (定義 worker)

定義 worker

foo_worker.rb

class FooWorker
  include Sidekiq::Worker
  sidekiq_options :queue => :barbar_queue, :retry => false, :backtrace => true

  def perform(name, count)
  end
end

啟動 worker (-c 代表 concurrency worker 數)

bundle exec sidekiq -c 1

把工作丟到 queue 裡

FooWorker.perform_async("haha", 11)

這時若有啟動 worker 就會從 redis 把工作抓下來執行

使用 (delay methods)

直接丟到 queue 裡

Bar.delay.some_method("haha", 2)

也可以以 instance 丟

user = User.find(2)
user.delay.increase_credit(200)

延遲至某短時間後再讓 worker 執行

user.delay_for(1.day).increase_credit(200)

延遲至某個時間點再給 worker 執行

user.delay_until(3.hour.from_now).increase_credit(200)

設定 Web console

Gemfile

gem 'slim'
gem 'sinatra', '>= 1.3.0'

config/routes.rb

require 'sidekiq/web'
...
  mount Sidekiq::Web => '/sidekiq'

web console 想要綁 devise 登入 (假設 scoep 為 member 且 .is_admin 必須為 true )
(更多可參考 https://github.com/mperham/sidekiq/wiki/Monitoring)

config/routes.rb

  sidekiq_constraints = lambda{ |request|
    request.env['warden'].authenticate!({ :scope => :member }) &&
    request.env['warden'].user(:member).is_admin
  }
  constraints sidekiq_constraints do
    mount Sidekiq::Web => '/sidekiq'
  end

佈署

config/deploy.rb

set :sidekiq_cmd, "bundle exec sidekiq"
set :sidekiqctl_cmd, "bundle exec sidekiqctl"

require 'sidekiq/capistrano'

config/sidekiq.yml

---
:verbose: false
:concurrency: 1
staging:
  :concurrency: 1
production:
  :concurrency: 10
  :queues:
    - [default, 1]
    - [mailer, 9]

venus

上述設定也可透過 gem venus 完成

rails g venus:sidekiq

參考教學

RailsCast
Official Document

讓 S3 允許 cross-domain 存取

Thu, 6 Jun 2013 01:48:00 +0800

檔案放上 S3 後，可能會需要透過 cross-domain 存取 (例如 web font)
這時可以透過 S3 bucket 的 CORS 設定達成

開啟後如同以下內容設定即可開放 GET 的跨網域存取

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <CORSRule>
        <AllowedOrigin>*</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedHeader>*</AllowedHeader>
    </CORSRule>
</CORSConfiguration>

如果要開放其他 HTTP method…

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <CORSRule>
        <AllowedOrigin>*</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
        <AllowedMethod>POST</AllowedMethod>
        <AllowedMethod>PUT</AllowedMethod>
        <AllowedHeader>*</AllowedHeader>
    </CORSRule>
</CORSConfiguration>

參考資料

http://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html

安裝與設定 unicorn 實現佈署時 zero down time

Mon, 3 Jun 2013 11:27:00 +0800

本文章的 code 可參考公開的 pull request
https://github.com/5fpro/cupid/pull/11/files
這是基礎到不行的設定方式，考量到 server 效能在設定上的 best practice 將會在日後持續 update 本文。

安裝 gem

Gemfile

group :development do
  gem 'capistrano-unicorn', :require => false
end

gem 'unicorn'

本文所採用的 gem 版本

Gemfile.lock

capistrano-unicorn (0.1.9)
unicorn (4.6.2)

佈署設定

這裡的 production.rb 是針對 rails_env=production，而非 capistrano 中 multistage 的 production

config/unicorn/production.rb

worker_processes 1
preload_app true

listen '/tmp/unicorn.cupid.sock' # sock 檔名可依照 app 需求設定

stderr_path 'log/unicorn.error.log'
stdout_path 'log/unicorn.log'

pid "tmp/pids/unicorn.pid"

rails_env = ENV['RAILS_ENV'] || 'production'

# before/after fork 可自行擴充

before_fork do |server, worker|
end

after_fork do |server, worker|
end

(也可以把上述檔案放在 config/unicorn.rb)

server 上的 nginx.conf

nginx.conf

upstream my_app {  # upstream 名稱可自定
  server unix:/tmp/unicorn.cupid.sock; # 這裡要和 config/unicorn/production.rb 中 listen 的設定對應
}

server {
  listen 80;
  server_name example.com;

  # passenger_enabled on; # 原本要設定 passenger 的記得要拿掉
  # .......

  location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_pass http://my_app; # upstream 名稱
  }

  location ~ ^/(assets)/  {  # 這裡是 precompile 後的 assets file 路徑
    gzip_static on; # to serve pre-gzipped version
    expires max;
    add_header  Cache-Control public;
  }

  # .......
}

把 unicorn 重啟的 hook 掛到 deploy.rb 中

config/deploy.rb

require 'capistrano-unicorn'
after 'deploy:restart', 'unicorn:restart'

done!

如何在本機測試 unicorn

bundle exec unicorn

Go to http://localhost:8080

參考資料

更多 unicorn 可以在 cap 指令中的應用: https://github.com/sosedoff/capistrano-unicorn/blob/master/lib/capistrano-unicorn/capistrano_integration.rb
unicorn 設定檔說明: https://raw.github.com/defunkt/unicorn/master/examples/unicorn.conf.rb
Github Blog 上說明他們自己的 unicorn 如何設定: https://github.com/blog/517-unicorn
其他 unicorn 設定相關教學:

利用 Swagger 產生互動式 API 文件

Sat, 4 May 2013 20:48:00 +0800

Swagger 是一套由 HTML + Javascript 撰寫的 REST API 文件的框架。 (core 是以 scala 寫的)

從 Demo 頁可了解到 Swagger 不僅僅提供 API 的規格資訊，也提供互動介面讓開發者可以直接輸入參數進行測試。

亦支援 GET & POST 以外的 http method (PUT、DELETE)。

Demo 頁面的 source code 在 Github 上。也可以參考 wordnik 的官方正式 API 文件。

API 文件內容完全是透過 ajax 取得 JSON data 產生的，因此必須提供 server 吐出符合 Swagger 文件中所定義的 JSON 格式，讓前端網頁能夠生成 API 文件的介面。

在 Swagger 文件中所定義的物件有:

doc: 代表整份 API 文件 (規格文件)
resource: API 文件下的分類目錄 (規格文件)
api: 每一條 REST Request (規格文件)
parameter: api 下的每個參數 (規格文件)
model: 自訂的 return data type (規格文件)

鑿於定義相當繁多且複雜，Swagger 本身有提供部分語言的 API 文件生成後台 (Ruby 開發者可選擇 sinatra)，讓開發者能夠花最少的時間開始使用 Swagger。

但筆者仍覺得 Swagger 使開發者進入狀況的門檻仍高，因此花了點時間以 rails app 開發 Swagger json data 的管理後台生成 swagger API 文件，提供後台的 web 操作介面來產生 Swagger 的 API 文件。

Github: https://github.com/marsz/swagger-rails
Demo: http://swagger.5fpro.com/

功能特色:

FB 登入/註冊，單一帳號下可建立多筆 doc
自訂 API 實際測試的目標網域
可設定獨立網域 (FQDN)，若沒有設定系統也會自動產生一組給你用
resource 可排序

讓我們 step by step 來建立 API 文件吧。
範例是小弟在早期自己寫的 API，用來提供台灣縣市鄉鎮的資料庫。

建立 doc，內容如下:
建立 doc 後，系統會提供你 API 實測時的網址格式
建立 resource (圖略)， resource 可以用來當做是管理許多 API 的目錄
建立 api: 選擇 http method 和 path

若 API 參數在 path 中，可用大括號包起來，必且給予參數名稱
填寫 return data type，若為某個 model 的 array 可以以圖內的格式表示
api path 內有參數的話，底下的 parameters 也必須增加 parameter type 為 path 的參數 (如圖)，名稱和大括號內對應
有關 model 的定義，可在 doc 頁找到，這裡的定義與否不會影響文件的正常顯示，有定義的話文件也會顯示出來，內容也就更完整囉
點擊 doc information 內的連結即可看到結果(http://gaia-doc.5fpro.tw/#!/3/api_6_get_2)
當然，API 實測要有資料，必須實作 http://gaia.5fpro.tw/cities/1.json 回傳的 JSON data 才行。

目前的 swagger-rails 仍有許多待增加的功能:

多人協作
修改記錄
自訂前端 CSS
後台介面優化
100% 實作 Swagger 所有支援的格式

最後附上筆者目前正式對外開放的 API 文件給各位參考:

THEWALL 這牆音樂
台灣縣市鄉鎮資料庫, 含郵遞區號
爬蟲系統 (暫不開放申請)

筆者目前透過自己蓋的 swagger-rails 用於內部溝通居多，不論在 mobile app 開發或跨語言的資料傳遞，透過 Swagger 介面的 API 實測功能，使用者很快就可以了解每條 API 的取用方式與資料格式，大大減少了溝通的成本。

Swagger 參考資料:

server 端允許 ajax cross domain 存取

Sun, 28 Apr 2013 13:07:00 +0800

在 controller 中加入以下即可允許來自 cross domain 的 ajax request

response.headers["Access-Control-Allow-Origin"] = "*"

Redis 在 Passenger 重起後出現 'reconnect to Redis after forking' 的錯誤訊息

Sat, 13 Apr 2013 22:02:00 +0800

自 redis 升級，每次透過 capistrano 佈署後，連線 server 都會噴出 “Tried to use a connection from a child process without reconnecting. You need to reconnect to Redis after forking.” 的錯誤訊息。

原因在於 redis 的 client gem。

因此必須在每次 passenger restart 後，也讓 redis client 進行重啓。可參考以下，必須於 initializer 或 application.rb 中執行。

if defined?(PhusionPassenger)
  PhusionPassenger.on_event(:starting_worker_process) do |forked|
    if forked
      Redis.current = Redis.new(:host => "127.0.0.1", :port => 6379)
    end
  end
end

除了 redis 之外，其他透過 redis 應用的 gem 也都會有類似的問題，例如 resque、redis-store、redis-object、sidekiq 等。

新版的 git (1.7 以上) 在 merge 時預設不開編輯器的設定

Tue, 9 Apr 2013 02:02:00 +0800

打開你的 shell rc 例如 ~/.zshrc 或 ~/bashrc
插入以下

export GIT_MERGE_AUTOEDIT=no

之後 merge –no-ff 的指令就都會預設用 auto message 做 commit 啦
如果想要強制編輯時，可以用 –edit 參數

git merge branch_name --no-ff --edit

修正 IE 無法透過 cross-domain AJAX 取得 JSON 物件

Fri, 29 Mar 2013 22:52:00 +0800

controller 中的 respond_to 可用來 return 指定的 format 供 JS 取用 API 資料
但很不幸的 IE 9 以下在透過 jquery 中的 getJSON 無法取得 return 的 json 物件。

server 端的 action

def index
  response.headers["Access-Control-Allow-Origin"] = "*"
  expires_in 1.day, :public => true
  @data = SomeModel.all
  respond_to do |f|
    f.json{ render :json => @data }
    f.xml{ render :xml => @data }
  end
end

client 端的 javascript

$.getJSON("http://apihost.com/products.json","jsonp", function(products){
   console.log(products);
});

結果: IE9 以下不 work，其他瀏覽器沒問題(生氣)

解決此問題的方法必須例用 jquery jsonp callback 的方式達到目的即可
因此 server 端的 response 的 content-type 必須是 javascript (見此圖)

server 端寫法

def index
  response.headers["Access-Control-Allow-Origin"] = "*"
  expires_in 1.day, :public => true
  @data = SomeModel.all
  respond_to do |f|
    f.json{ render :json => @data }
    f.xml{ render :xml => @data }
    f.js{ :json => @data, :callback => params[:callback] }
  end
end

client 端的 javascript

$.getJSON("http://apihost.com/products.js?callback=?",function(data){
   console.log(data);
});

搞定!!!

server 端其他寫法的補充:

開啟 cross-domain 的 ajax request

response.headers["Access-Control-Allow-Origin"] = "*"

開啟 cache-control 為 public:

expires_in 1.day, :public => true

我寫的 gem - venus 簡介

Wed, 13 Mar 2013 13:12:00 +0800

因受到了 rails composor 的影響，決定也來寫一個客製化的 rails generator。
但後來又覺得只能在開新專案用的話，使用頻率也不太高…

鑿於在許多專案中，總是為了要安裝某些 gem 而必須再回去翻寫過專案中的 code 或上官網找範例 code 做 copy/paste + 修改，於是我決定寫一個 generator 來設定這些常用的 gem，僅需要如同 rails composor 一樣回答一些問題就可以把所有的設定弄到好。

因此 venus 因應而生

安裝: https://rubygems.org/gems/venus
源碼: https://github.com/marsz/venus

以下逐一介紹各個指令

rails generate venus:init

專案初始化設定，例如移除 public/index.html，安裝必要的 gem 例如分頁用的 kminari，剛 new 好的 rails 專案適合執行此指令。

rails generate venus:mysql

設定 mysql，包含從 Gemfile 安裝 mysql2，設定 database.yml 以及 database.yml.example，最後再將 config/database.yml 加到 .gitignore 中。

rails generate venus:paginate

單獨安裝分頁用的 gem - kminari，也會問你要不要產生客製化的 view 出來。

rails generate venus:simple_form

view 使用 form 必備的 simple_form，預設會產生 bootstrap wrapper 的設定檔。也會詢問是否要順便安裝 nested_form，安裝 nested_form 需要在 js 中 require gem 裡面包好的 JS，所以也會詢問 require code 和 example code 要放的檔案路徑。

rails generate venus:settingslogic

gem - settingslogic。可以將多個 yml 的設定檔放在此 gem 所讀取的 yaml 下，使其能夠容易管理。此 generator 同時也會產生 .example 檔以及加入 .yml 到 .gitignore 下。

rails generate venus:rspec

安裝並且設定 rspec，並且移除 test 目錄，在 config/application.rb 中設定 generate controller 時，不自動產生 assets files 和 helper。

rails generate venus:devise

安裝並且設定 scope 為 user 的 devise gem。

rails generate venus:omniauth

會先檢查是否有安裝 settingslogic 以及 devise，然後再安裝 omniauth，過程中會詢問 facebook / twitter / github 登入的安裝與否。

rails generate venus:redis

安裝並且設定 redis client gem redis-rb 。

rails generate venus:aws

安裝並且設定 Amazon 官方的 ruby client 。過程中會先檢查 settingslogic，並且將 api key 和 secret 存到其中。最後也會詢問否需要順便安裝 Amazon Simple Email Service (SES)，用來發 email。

rails generate venus:carrierwave

安裝並且設定 carrierwave，其中包含 rmagick 進行縮圖，以及 fog 將檔案上傳至S3。過程中會安裝 aws-sdk，所以也會順便詢問 SES 的設定 :p。最後會產生一個 venus_uploader.rb 做為範例。

rails generate venus:jqueryui

安裝 jquery ui 的 gem。其中會詢問是否要安裝 datepicker，包含產生 trigger 用的 js 範例 code。gem 的參考連結 => https://github.com/joliss/jquery-ui-rails。 (若有要安裝 datepicker 的話，也會詢問語系)

rails generate venus:chosen

安裝 chosen-rails 並且提供 trigger chosen 的範例 js code。

rails generate venus:bootstrap

安裝 twitter bootstrap ，包含 gem 設定、 assets require，最後產生範例 layout 檔於 app/views/layouts/ 下。內建提供 unicorn admin 的版型套用，蓋後台超爽 XD

TODOs

對於此 gem 未來將會逐漸加入我自己寫的 best practice :p 也望各位大大能不吝指教或回報 bug :D

sidekiq : 強大的 background job gem
unicorn : 配合 capistrano 讓佈署時可以 zero down time
paper_trail : 對 model 進行版本控制的 gem

自動化產生 ER 圖的 rubygem

Tue, 13 Nov 2012 05:39:00 +0800

參考連結:
1. 官網 : http://rails-erd.rubyforge.org/
2. 相關教學 : http://zool.me/rails/2010/12/29/Rails-generate-entity-relationship-diagram-projects/

系統需求

MAC OS 請先安裝 brew

安裝 Graphviz

MAC OS

brew install cairo pango graphviz

若無法順利安裝可至 graphviz for MAC OS download 頁面下載對應的系統，直接打開 finder 以 window 介面安裝

Ubuntu

sudo aptitude install graphviz

Rails 設定

Gemfile

group :development do
  gem "rails-erd"
end

bundle install

生成 ERD

bundle exec rake erd

生成的 ERD 會在專案目錄下的 erd.pdf

Rubygems 處理 Amazon Web Service (AWS) EC2

Fri, 9 Nov 2012 13:55:00 +0800

參考: https://github.com/grempe/amazon-ec2

安裝設定

Gemfile

gem 'amazon-ec2', :require => "AWS"

config/aws.yml

development: &default
  :access_key_id: "abcdabcd"
  :secret_access_key: "abcdabcd"
  :host: "ap-southeast-1.ec2.amazonaws.com"
test:
  <<: *default

access_key_id 和 secret_access_key 可至 AWS Security Credentials 查看
host 則是目標 region 所對應的 endpoint，對應表可至 https://github.com/garnaat/missingcloud/blob/master/aws.json#L372 查看

養成好習慣, 請勿將 yaml 檔 commit 進去…

.gitignore

config/aws.yml

config/aws.yml.example

# to see region and host mapping :
#   https://github.com/garnaat/missingcloud/blob/master/aws.json#L372
development: &default
  :access_key_id: ""
  :secret_access_key: ""
  :host: ""
test:
  <<: *default

使用方法

初始化

example.rb

config = YAML::load(File.open("#{Rails.root}/config/aws.yml"))[Rails.env]
ec2 = AWS::EC2::Base.new(:access_key_id => config[:access_key_id], :secret_access_key => config[:secret_access_key], :server => config[:host])

取得 instance 列表

exmaple.rb

instances = ec2.describe_instances
# instances["reservationSet"]["item"] 才會取得 array

取得所有 snapshots (自己 create 的)

exmaple.rb

snapshots = ec2.describe_snapshots(:owner => "self")
# snapshots["snapshotSet"]["item"] 才會取得 array

取得所有 volumes

exmaple.rb

volumes = ec2.describe_volumes
# volumes["volumeSet"]["item"] 才會取得 array

建立 snapshot, 必須先取得 volume id

example.rb

volume_id = volumes["volumeSet"]["item"].first["volumeId"]
ec2.create_snapshot(:volume_id => volume_id, :description => "my snapshot")

建立某個 instance 的 snapshot, 有 instance id 的情況下

example.rb

instance_id = "i-abcd"
volume_id = (((ec2.describe_volumes["volumeSet"] || {})["item"] || []).select { |volume|
  (volume["attachmentSet"]["item"].select{ |ins| ins["instanceId"] == instance_id }.first || {})["instanceId"] == instance_id
}.first || {})["volumeId"]
result = ec2.create_snapshot(:volume_id => volume_id, :description => "foo bar")
puts result["snapshotId"] # 新的 snapshot id

更多可參考 API: https://github.com/grempe/amazon-ec2/tree/master/lib/AWS/EC2

IE 瀏覽器讀取 css 檔案的 selector (4096)限制

Sun, 16 Sep 2012 23:24:00 +0800

IE 瀏覽器在讀取每個 css 檔案時，不能超過 4096 個 selector，超過的都會被忽略

註: .foo .bar { .... } 代表一個 selector
stackoverflow 也有相關問題: http://bit.ly/QiuvNC

由於 twitter boostrap 以及其應用外掛的流行，要破 4096 個 selector 是輕而易舉的事，要測試你所使用的瀏覽器有沒有支援超過，可以看這個網頁，若顯示的背景為紅色代表不支援，綠色表示沒問題。

解決此問題最快的辦法就是把 css 分檔案就行了，rails 的 assets precompile 的 css 中若混雜著 bootstrap 之類的套件就會很容易超過此限制，只要把這些不會被修改的套件掛上 CDN 或分不同檔案 precompile 就可以處理了。

自動隱藏 iPhone safari 的網址列

Sun, 9 Sep 2012 13:46:00 +0800

在 html 的 <head> 裡面加上

<meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0" />
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="apple-mobile-web-app-status-bar-style" content="black" />

參考來源: http://stackoverflow.com/questions/4759818/how-to-hide-the-address-bar-of-a-webpage-in-android

取得獨一無二的 session id

Sun, 9 Sep 2012 11:32:00 +0800

request.session_options[:id]

參考連結: http://stackoverflow.com/questions/4824829/finding-the-session-id-in-rails-3

rake db 的 tasks 整理

Mon, 3 Sep 2012 15:38:00 +0800

善用 rails rake 內建的 DB tasks 進行資料庫操作

rake db:migrate - 執行 db/migrate 中還沒跑過的 migrations
rake db:migrate VERSION=12341234 - 針對設定的 migrations 版本執行
rake db:migrate:redo - 重跑目前最新的 migration
rake db:migrate:redo STEP=3 - 重跑目前最新的三個 migration
rake db:rollback - 還原跑過最新的 migration
rake db:rollback STEP=3 - 還原跑過最新三個的 migration
rake db:create - 建立 database
rake db:drop - 刪除整個 database
rake db:schema:dump - 從目前 database 中實際的 schema 建立 db/schema.rb
rake db:schema:load - 從 db/schema.rb 中把 schema 建立到 databse 中
rake db:structure:dump - 從目前 database 中實際的 schema 輸出到 db/structure.sql
rake db:reset - 合體的 task ( db:drop => db:create => db:schema:load)

另外安裝了 yaml_db 後，可以透過以下兩個指令把資料庫的資料做 export/import (不包含 schema)

rake db:data:dump - 把資料輸出到 db/data.yml
rake db:data:load - 把資料從 db/data.yml 輸入到 database 中

layout 檔案的命名

Tue, 21 Aug 2012 15:16:00 +0800

今天發現 layout 檔 (views/layouts) 的命名是不能亂來的 ~XD
嘗試用 dash 命名 (例如 foo-bar.html.haml) 的結果造成 haml 無法被 parsing
所以還是乖一點用小寫英文和 underline 吧 :p

我的 Sublime Text 2 設定

Sun, 19 Aug 2012 21:46:00 +0800

最後更新: 2013/3/31
Sublime 是一套強大的文字編輯器，和我用過的 Textmate 類似，但功能更為強大 XD
以下是我的設定範例。

實用快速鍵

參考: https://gist.github.com/1207002

自定快速鍵

以下視個人喜好而定:

上方選單 -> Sublime Text 2 -> Preferences -> Key Bindings Default

  // 快速顯示目前檔案所在的目錄樹下
  { "keys": ["ctrl+super+r"], "command": "reveal_in_side_bar" },
  // 找 swap_line_up 出來改, 可以換置上下行
  { "keys": ["alt+up"], "command": "swap_line_up" },
  { "keys": ["alt+down"], "command": "swap_line_down" },
  // 找 duplicate_line 出來改, 可以快速複製一行
  { "keys": ["super+alt+down"], "command": "duplicate_line" },
  { "keys": ["super+alt+up"], "command": "duplicate_line" },
  // 找 auto_complete 出來改
  { "keys": ["super+."], "command": "auto_complete" },
  // 刪除一整列, 記得要 search "super+d" 把其他的 key binding 砍掉, 或者可以用別的 key binding
  { "keys": ["super+d"], "command": "run_macro_file", "args": {"file": "Packages/Default/Delete Line.sublime-macro"} },

安裝好後設定 link

ln -s "/Applications/Sublime Text 2.app/Contents/SharedSupport/bin/subl" ~/bin/subl

sudo ln -s "/Applications/Sublime Text 2.app/Contents/SharedSupport/bin/subl" /usr/bin/subl

ubuntu 的話可以用

sudo ln -s ~/Applications/Sublime\ Text\ 2/sublime_text /usr/bin/subl

shell link，編輯 ~/.bashrc 或 ~/.zshrc (看你用的是哪一個 shell)

export EDITOR="/usr/local/bin/subl -w"

setting 檔

command + , 出現的檔案

{
  "color_scheme": "Packages/Color Scheme - Default/Twilight.tmTheme",
  "font_size": 18.0,
  "tab_size": 2,
  "translate_tabs_to_spaces": true,  
  "highlight_line": true,
  "highlight_modified_tabs": true
}

(PS: 年紀大了所以用字體 size 用 18 XD)
(PS2: tab 設定隨個人/公司喜好)

安裝 package control

用於快速安裝其他 package 的好工具

參考 http://wbond.net/sublime_packages/package_control/installation
ctrl+` 開啟 command line 後輸入:

import urllib2,os; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); os.makedirs(ipp) if not os.path.exists(ipp) else None; urllib2.install_opener(urllib2.build_opener(urllib2.ProxyHandler())); open(os.path.join(ipp,pf),'wb').write(urllib2.urlopen('http://sublime.wbond.net/'+pf.replace(' ','%20')).read()); print 'Please restart Sublime Text to finish installation'

重啟 sublime, command+shift+p 輸入 install 看到 Package Control: Install Package 即可透過此功能安裝其他 package

安裝 sass/scss/haml 檔案支援

安裝 package control
command+shift+p 輸入 install 選 Package Control: Install Package
鍵入 sass 選第一個安裝即可
重複 2., 鍵入 haml 選第一個安裝即可

安裝 ERB 檔案的編輯強化

安裝 package control
command+shift+p 輸入 install 選 Package Control: Install Package
鍵入 erb snippets 選第一個安裝即可

參考官方文件有快速 block template 可產生。

例如在 .erb 檔中，打 er 然後再按 tab 鍵就會生成 <% %>。

omniauth 登入後的 redirect 設定

Fri, 10 Aug 2012 14:08:00 +0800

我們曾在 Devise callbacks 中，描述如何在登入後自定 redirect。這次則是在 omniauth 進行 open id 驗證時就先把 redirect 當參數先丟。

參考官方作法
利用 origin 參數即可在 open id 驗證後進行 redirect

config/routes.rb

match '/auth/facebook', :as => :facebook_login

app/views/xxx.erb

# view 或 controller 下
facebook_login_path(:origin => "/url/for/redirect")
# 即 "/auth/facebook?origin=/url/for/redirect"

若 devise 中已經透過 application_controller.rb 的 after_sign_in_path_for 處理登入後的 redirect 時，則可以透過 request.env['omniauth.origin'] 取得 origin 參數的內容。

app/controllers/application_controller.rb

def after_sign_in_path_for(user)
  return request.env['omniauth.origin'] || root_path
end

devise 的 user 登入免驗證密碼

Thu, 9 Aug 2012 17:15:00 +0800

Devise 加上 Omniauth (或其他 Open ID 登入機制) 時，資料庫的密碼欄位可能會需要為空值，因此可在 user 的 model 中覆寫 password_required? (為 public method) 即可。

app/models/user.rb

  def password_required?
    return (self.facebook_id ? false : true)
  end

該範例之邏輯為，有 facebook id 時密碼欄位可為空值。

讀書心得: 刻意練習(6)

Tue, 7 Aug 2012 13:42:00 +0800

最後一篇分享了 XD 本篇主要摘要刻意練習對創意的發展

我們對創意的誤解

一般我們認為創意之所以會有，乃是來自於 1. 靈光乍現 2. 置身領域之外的旁觀者，事實上這兩點都是不太正確的。任何突破性的創意產生之前，都是當事者下了多年的苦工後才有的。研究人員找出五百多首作曲，來自於個作曲家的第一部成名作或曠世巨作，發現其中只有三件作品是在作曲家職涯的前十年完成，而這三件作品完成的時間也是在第八年和第九年。而這樣的數據足以說明前述的 十年法則。

創意的正解

知識越多創新越多

在十年法則的漫長時間下，創作者做的活動大多是吸取專精知識，這些活動絕對是該領域密集而且深度的薰陶，即使沒有指導者，創新者本身也股強烈的動力，盡可能的學習與該領域相關的事物。

創意是孕育出來的

其實我們可以從現代科技中發現，這些創新都是既有事物的改良和延伸，透過卓越的洞見得以實現。如果不是因為了解過去的成就，這些創新肯定不可能實現。因此我們可確定靈光乍現是來自多時的思索和研究，絕非偶然、也不是無中生有。

打造創新組織四大關鍵

動機與熱情

刻意練習不是輕鬆的過程，沒有熱情支持難以持續。因此創新者本身是熱切接受自身領域的薰陶，以及其相關的深度知識。

文化變革

只要是組織 (2人以上) 都離不開文化的議題，而文化變革必須從上位者本身做起，只要公司的”長”字輩認為公司文化沒問題，它就永遠不可能改變。

傳達需求

組織想要有所創新，就得讓其中的每個人都了解哪種創新最有價值，有了方向才能夠進行深度的心智模型建立、投入大量心力，領導者在這裡扮演重要角色。

賦予自由

當組織內的每個人都被注入動機以及明確方向時，接下來需要注意的就是給予發揮空間，刻意練習強調的是自發性，組織在此要扮演推手的角色，而非造成限制。

身為網路工作者，又是工程師。在讀完本書後，小弟首先做的就是調整作息~XD 一改平日睡到十點後才醒來的習慣，想辦法在早上擠出 1~2 小時做最困難的工作 (通常都是 coding 或 debug)，我設定給自己的關鍵指標就是開發所花的時間: 每天早上這 1~2 小時能完成多少工作。

在這樣的過程中剛開始是很痛苦，其實早起感覺都沒睡飽，注意力也難以集中，但震盪期大概持續一個月左右就適應了。習慣後慢慢發現另一個重要的指標: 專注力，程式開發是很注重當下的專心度，因此開始用一些方式提高專注力，關掉手機以及電腦的各種通知等，用高度的感知以及後設認知檢視自己在這段時間內的專注力是否有提昇。

有了一定程度的專注力後，又發現了另一個指標: 英文資料理解速度。程式開發遇到問題經常要上孤狗，而資料多半是英文，因此能夠花越少的時間孤狗，相對就能夠花越多時間在開發上，效率自然會提昇。

如此循環進行，發現不斷找到新的評估指標，然後持續提昇。目前小弟正在磨練的另一項技能是養成寫 blog 的習慣，將自己曾經解決的問題以及累積的知識得以文件保存，除此之外，身為工程師仍有許多能力必須提昇，例如和別人溝通時是否能以最精簡的方式傳達，專案執行前的目標設定是否足夠嚴謹、達成率是否足夠等。刻意練習概念所帶給我的，是變得更了解這些技能學習過程的運作原理，進而更能掌握自己各方面能力的提升。