spacemacs/layers/+readers/dash

Dash layer

• Description
  • Features:
• Install
  • Dash (OS X)
    • Sqlite3
  • Zeal (Linux & Windows)
• Word at point
• Key bindings

Description

This layer integrates offline api browsers into emacs. It provides one for OS X, Linux and Windows.

Features:

• Searching for word at point in offline api browser's UI.
• Integration of offline api browser search results in helm and ivy.
• Support for dash offline api browser for OS X.
• Support for zeal offline api browser for Linux.

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add dash to the existing dotspacemacs-configuration-layers list in this file.

Dash (OS X)

You have to install dash on your machine.

It is recommended to set the HUD mode in your Dash application preferences when using this layer.

Sqlite3

Helm Dash requires sqlite3 to be installed to function properly.

Zeal (Linux & Windows)

You have to install zeal on your machine.

Then install the docsets you use more frequently

Word at point

dash-at-point and zeal-at-point will search for the word at point in the respective offline api browser. The result will be displayed in the offline browser's UI.

However having to leave emacs to have a look at the search results may be a bit awkward. To help with this it is also possible to integrate the search results directly in helm or ivy and show the details in a browser. To do so helm-dash can be used for helm and counsel-dash for ivy.

To get them working it is necessary to set helm-dash-docset-newpath to the location of your docsets.

  (dash :variables
        helm-dash-docset-newpath "~/.local/share/Zeal/Zeal/docsets")

For more details please check dash-at-point-usage or zeal-at-point.

Key bindings

Key Binding	Description
SPC d d	Lookup thing at point in Dash or Zeal
SPC d D	Lookup thing at point in Dash or Zeal within a specified Docset
SPC d h	Lookup thing at point in helm-dash or counsel-dash
SPC d H	Lookup in helm-dash or counsel-dash within a specified Docset