TakeV/spacemacs
Archived
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+readers/dash
History
Jake Romer 12defb470e Add labeled prefix for dash layer 
Currently the "d" prefix in the which-key menu is displayed as "prefix". This patch replaces that with "docs".
2019-04-11 23:16:45 +02:00
..
img
config.el
funcs.el
packages.el Add labeled prefix for dash layer 2019-04-11 23:16:45 +02:00
README.org documentation formatting: Wed Dec 5 03:03:03 UTC 2018 2018-12-04 22:06:14 -05:00

README.org

Dash layer

/TakeV/spacemacs/media/commit/0ff31edcd8d9be38d4be873e0ac7d276ce74e5f8/layers/+readers/dash/img/dash.png

/TakeV/spacemacs/media/commit/0ff31edcd8d9be38d4be873e0ac7d276ce74e5f8/layers/+readers/dash/img/zeal.png

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