[ANN] org-link-edit.el --- Slurp and barf with Org links

[ANN] org-link-edit.el --- Slurp and barf with Org links

[Kyle Meyer]

Hello,

When working with links in Org documents, I noticed that I often kill
surrounding text to bring it into the description, or vice versa.  At
some point, this made me think that it'd be nice to be able to add and
remove description words like Paredit lets you do with S-expressions.
I've put these Paredit-inspired slurping and barfing commands for Org
link descriptions in org-link-edit.el [1], in case others find them
useful.  Below is an example for each command.

- org-link-edit-forward-slurp

  The [[http://orgmode.org/][Org mode]] site
                        |
                        v
  The [[http://orgmode.org/][Org mode site]]

- org-link-edit-backward-slurp

  The [[http://orgmode.org/][Org mode]] site
                        |
                        v
  [[http://orgmode.org/][The Org mode]] site

- org-link-edit-forward-barf

  The [[http://orgmode.org/][Org mode]] site
                        |
                        v
  The [[http://orgmode.org/][Org]] mode site

- org-link-edit-backward-barf

  The [[http://orgmode.org/][Org mode]] site
                        |
                        v
  The Org [[http://orgmode.org/][mode]] site

As I mention in the package commentary, I think this works well with
Oleh Krehel's excellent Hydra [2] because it allows you to repeat any of
these commands with a single key after the initial key sequence to
invoke the popup.

    (define-key org-mode-map YOUR-KEY
      (defhydra hydra-org-link-edit ()
        "Org Link Edit"
        ("j" org-link-edit-forward-slurp "forward slurp")
        ("k" org-link-edit-forward-barf "forward barf")
        ("u" org-link-edit-backward-slurp "backward slurp")
        ("i" org-link-edit-backward-barf "backward barf")
        ("q" nil "cancel")))


[1]: https://github.com/kyleam/org-link-edit/blob/master/org-link-edit.el
[2]: https://github.com/abo-abo/hydra

--
Kyle

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Rasmus]

Kyle Meyer <kyle@kyleam.com> writes:

> remove description words like Paredit lets you do with S-expressions.
> I've put these Paredit-inspired slurping and barfing commands for Org
> link descriptions in org-link-edit.el

That's so need!

Did you/will you add it to contrib?

Thanks,
Rasmus

-- 
This space is left intentionally blank

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Kyle Meyer]

Rasmus <rasmus@gmx.us> wrote:
> Kyle Meyer <kyle@kyleam.com> writes:
>
>> remove description words like Paredit lets you do with S-expressions.
>> I've put these Paredit-inspired slurping and barfing commands for Org
>> link descriptions in org-link-edit.el
>
> That's so need!
>
> Did you/will you add it to contrib?

I'm glad you think it looks useful.  I haven't added it contrib (I don't
have push access and wasn't sure if others would be interested), but I'd
be happy for it to be in contrib.

--
Kyle

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Suvayu Ali]

On 19 February 2015 at 06:24, Kyle Meyer <kyle@kyleam.com> wrote:
> Rasmus <rasmus@gmx.us> wrote:
>> Kyle Meyer <kyle@kyleam.com> writes:
>>
>>> remove description words like Paredit lets you do with S-expressions.
>>> I've put these Paredit-inspired slurping and barfing commands for Org
>>> link descriptions in org-link-edit.el
>>
>> That's so need!
>>
>> Did you/will you add it to contrib?
>
> I'm glad you think it looks useful.  I haven't added it contrib (I don't
> have push access and wasn't sure if others would be interested), but I'd
> be happy for it to be in contrib.

I think this is a great addition to contrib/.  Great command names, btw ;).

-- 
Suvayu

Open source is the future. It sets us free.

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Thomas S. Dye]

Kyle Meyer <kyle@kyleam.com> writes:

> As I mention in the package commentary, I think this works well with
> Oleh Krehel's excellent Hydra [2] because it allows you to repeat any of
> these commands with a single key after the initial key sequence to
> invoke the popup.

Brilliant!  Hydra is a real find.

Thanks,
Tom

-- 
Thomas S. Dye
http://www.tsdye.com

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Bastien Guerry]

Rasmus <rasmus@gmx.us> writes:

> Did you/will you add it to contrib?

Yes, that would help discovering it.

Thanks!

-- 
 Bastien

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Nicolas Goaziou]

Hello,

Bastien Guerry <bzg@gnu.org> writes:

> Rasmus <rasmus@gmx.us> writes:
>
>> Did you/will you add it to contrib?
>
> Yes, that would help discovering it.

Wasn't it a goal to slowly move away from contrib/ and use either ELPA
or core instead?


Regards,

-- 
Nicolas Goaziou

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Bastien Guerry]

Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

> Wasn't it a goal to slowly move away from contrib/ and use either ELPA
> or core instead?

Yes, it is still a goal -- but we don't know when this will happen so
in the meantime, adding a package to contrib/ is okay.

-- 
 Bastien

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Thomas S. Dye]

Aloha all,

IMHO, this should be in core, along with a function (if it doesn't
exist) to remove a link from the description text.

All the best,
Tom

Bastien Guerry <bzg@gnu.org> writes:

> Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:
>
>> Wasn't it a goal to slowly move away from contrib/ and use either ELPA
>> or core instead?
>
> Yes, it is still a goal -- but we don't know when this will happen so
> in the meantime, adding a package to contrib/ is okay.

-- 
Thomas S. Dye
http://www.tsdye.com

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Bastien Guerry]

Thomas S. Dye <tsd@tsdye.com> writes:

> IMHO, this should be in core, along with a function (if it doesn't
> exist) to remove a link from the description text.

Yes, we should consider this.  Let's find some good keybinding,
we cannot rely on hydra for this.

Thanks,

-- 
 Bastien

Re: [ANN] org-link-edit.el --- Slurp and barf with Org links

[Kyle Meyer]

Bastien Guerry <bzg@gnu.org> writes:

> Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:
>
>> Wasn't it a goal to slowly move away from contrib/ and use either ELPA
>> or core instead?
>
> Yes, it is still a goal -- but we don't know when this will happen so
> in the meantime, adding a package to contrib/ is okay.

OK, I've added it to contrib for the time being.

--
Kyle