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/+chat/slack
History
syl20bnr ebe4c60264 Revert "Defer packages by default using use-package-always-defer" 
This reverts commit 29c78ce841 and all other fixes
that have been made afterwards.

The motivation is that use-package is seen by many as a replacement for
`require`. Is use-package always defer the loading of packages then is breaks
this use case, this does not respect POLA so even if it was making Spacemacs
loading faster (up to 3s faster on some startup on my machine) we just cannot
use it, it would be irresponsible. Spacemacs should be easy to use, loading
performance will come with time but it is not a priority.
2018-03-03 23:40:10 -05:00
..
img Move slack layer to +chat directory 2016-06-04 00:20:36 -04:00
config.el Happy New Year 2018! 2018-01-04 02:00:25 -05:00
funcs.el Fix errors in rcirc and slack layers 2018-01-10 22:09:47 -05:00
layers.el Happy New Year 2018! 2018-01-04 02:00:25 -05:00
packages.el Revert "Defer packages by default using use-package-always-defer" 2018-03-03 23:40:10 -05:00
README.org Fix documentation issues with slack and emoji layers 2017-08-04 21:37:59 +03:00

README.org

Slack layer

/TakeV/spacemacs/media/commit/a64417b3c1d57254d7b33ead1025a32d6175760d/layers/+chat/slack/img/slack.png

Description

This layer provides an interface to the Slack chat service via the emacs-slack package. Where possible, this layer aims to reuse keybindings from the IRC packages in Spacemacs.

Features:

Install

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

Configuration

Follow the instructions in the emacs-slack package for obtaining your client ID, client secret, and token.

To test that everything is alright put the following snippet in your dotspacemacs/user-config() replacing client-id, client-secret and token with your info.

Important Do not keep private data in your dotfile. You can put your private stuff elsewhere (like Dropbox for instance) and load the file in your dotfile.

(slack-register-team
  :name "emacs-slack"
  :default t
  :client-id "my@email.address"
  :client-secret "mypassword"
  :token "token"
  :subscribed-channels '(general slackbot))

Spacemacs layout integration

A Spacemacs custom layout is defined by the layer. The name and the key binding for it can be customized with the following layer variables:

  • slack-spacemacs-layout-name for the layout name,
  • slack-spacemacs-layout-binding for the key binding.

By default the values are:

(setq-default dotspacemacs-configuration-layers '(
  (slack :variables slack-spacemacs-layout-name "@Slack"
                    slack-spacemacs-layout-binding "s")))

Key bindings

Key Binding Description
SPC a C d Direct message someone
SPC a C g Join a group (private channel)
SPC a C j Join a channel
SPC a C q Close connection
SPC a C r Join a channel, group, or direct messge
SPC a C s (Re)connects to Slack
SPC m c Embed mention of channel
SPC m e Edit message at point
SPC m j Join a channel
SPC m d Direct message someone
SPC m m Embed mention of user
SPC m p Load previous messages
SPC m ) Add reaction (emoji) to a message
SPC m ( Remove reaction (emoji) to a message
SPC m t Show or create thread
SPC m q Quit Slack

The following bindings are provided to mimic bindings in the official Slack client.

Key Binding Description
SPC m @ Embed mention of user
SPC m # Embed mention of channel
SPC m ) Add a rection
SPC m k Join a channel

In insert state, one can also use @ and # directly without the leader key prefix.