Ruby 공식 문서의 검색 기능은 RDoc 6.15.0 이상으로 빌드된 문서에 대해 ?q= 쿼리 파라미터를 사용하여 특정 키워드를 검색할 수 있도록 확장되었습니다. 예를 들어, https://docs.ruby-lang.org/en/master/?q=String%23gsub와 같이 `String
gsub` 메서드를 직접 검색할 수 있습니다.
이러한 검색 기능은 다양한 방식으로 활용될 수 있습니다.
Kagi Search를 이용한 빠른 검색
Kagi Search 사용자는 ‘!rb’ 뱅(bang) 기능을 통해 ‘`!rb String
gsub`‘과 같이 입력하여 Ruby 공식 문서의 검색 결과로 바로 이동할 수 있습니다. Kagi의 뱅 기능은 오픈 소스로 기여를 받고 있습니다.
브라우저 내 검색 단축키 설정
별도의 서비스 가입 없이 브라우저 자체 설정을 통해 더욱 효율적인 검색 단축키를 구성할 수 있습니다. 이는 HTTP 리다이렉션을 한 번 더 거치는 대신, 브라우저에서 직접 검색 요청을 보내는 방식입니다.
- Firefox 설정:
- ‘설정(Settings) > 검색(Search) > 검색 단축키(Search Shortcuts)’로 이동합니다.
- ‘추가(Add)’ 버튼을 클릭합니다.
- URL 필드에
https://docs.ruby-lang.org/en/master/?q=%s를 입력합니다. - 키워드(Keyword) 필드에 원하는 단축키(예:
!rb)를 입력합니다.
- Chrome 설정:
- ‘설정(Settings) > 검색 엔진(Search Engine) > 검색 엔진 및 사이트 검색 관리(Manage search engines and site search)’로 이동합니다.
- ‘사이트 검색(Site search)’ 섹션에서 ‘추가(Add)’ 버튼을 클릭합니다.
- Firefox와 동일하게 URL 필드에
https://docs.ruby-lang.org/en/master/?q=%s를, 키워드 필드에 원하는 단축키를 입력합니다.
Stan Lo는 현재 검색 결과의 품질을 더욱 향상시키기 위한 작업을 진행 중이므로, 현재 검색 결과가 다소 미흡하게 느껴지더라도 향후 개선될 예정입니다.