Set the default link description

Question

I am tryping out org-wiki.el to create a personal wiki in org-mode. The package offers a custom link type wiki:<page> which creates a link like wiki:myPage that matches up with myPage.org.

I'm wondering if there is any way to set the default description for this link type to hide the wiki: prefix, so that on completing the link, it converts to [[wiki:myPage][myPage]]?

Or better yet, typing [[wiki:My page]] which automatically displays as [[wiki:My page][My page]] so we can ditch the camelCase!

Any ideas?

thanks,

Answer 1

The function org-wiki-insert inserts a wiki: link of the form [[wiki:MyHeading][MyHeading]].

But, it's more convenient to use the built-in org-insert-link. For that we need two things: completions for the link target and a default description. For the first, we just need to define a function called org-wiki-complete-link and org-mode will pick it up for completing wiki: links:

(defun org-wiki-complete-link (&optional arg)
  (org-wiki--helm-selection
   (lambda (page)
     (format "wiki:%s" page))))

The only way to set default descriptions seems to be to set org-make-link-description-function. There isn't a per-type function like there is with the targets. We just have to make sure that we only complete wiki: type links:

(defun org-make-wiki-link-description (link desc)
  (when (string-prefix-p "wiki:" link)
    (string-remove-prefix "wiki:" link)
    )
  )
(setq org-make-link-description-function #'org-make-wiki-link-description)

Now, hit C-c C-l and type wiki:[return]. You will be prompted for the wiki heading and then a default description will be added.