An unofficial DevDocs API Documentation viewer for macOS.
- Tabs
- Global shortcut (Option+Space)
- Automatic dark/light mode UI
- Protocol handler integration (handle
devdocs-macos://
,http://
, andhttps://
URLs)
Protocol handler integration allows you to control DevDocs through scripts. For example:
$ osascript -e 'tell application "DevDocs" to open location "devdocs-macos://search?doc=rails&term=stro"'
... will tell DevDocs to open a new window and search the Rails documentation for
the term stro
.
The app supports the following commands. When required parameters are not supplied, the command is ignored.
This is for launching a search query in a new window.
Query Parameter | Required | Description |
---|---|---|
term | Yes | The search term, eg. stro |
doc | No | Documentation scope, eg. rails |
This opens a new window.
DevDocs will open a new window only for URLs on the devdocs.io
domain. For
example:
$ osascript -e 'tell application "DevDocs" to open location "https://devdocs.io/#q=rails+stro"'
Other domains are ignored.
Pre-built binaries can be downloaded from the releases page.
Unzip, drag the app to Applications, and then run it.
If you wish to install the application from Homebrew:
$ brew tap dteoh/devdocs
$ brew cask install devdocs-macos
The application will live at /Applications/DevDocs.app
.
The app is currently developed on Mojave and only support for Mojave can be provided.
DevDocs for macOS
Copyright (C) 2019 Douglas Teoh
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.