Skip to content

ptillemans/org-jira

 
 

Repository files navigation

org-jira mode

Use Jira in Emacs org-mode.

To save the settings in your .emacs, you need only do 2 things:

  1. Set the defcustom variables defined in jiralib.el (actually only the jiralib-url is required, as the other 2 are usually computed from it correctly and is the case in the video demo):
    3 matches for "\bdefcustom\b" in buffer: jiralib.el
         55:(defcustom jiralib-host ""
        120:(defcustom jiralib-url
        
  2. Write your password in ~/.authinfo, with machine being the (computed) jiralib-host, and the port being 80 (even if you are using https for Jira):
    machine JIRALIB-HOST login USERNAME password XXXXX port 80
        

    If you do not set USERNAME here, then it will be prompted using the minibuffer; if you set the wrong username/password, then it won’t work.

Configuration

Commands supported

Here is the list of commands supported by org-jira, with a simple help (the first line of elisp doc). It is created with C-h a org-jira RET :-)

You can C-h f on each command to get more detailed help, or just read my ugly source code:-)

org-jira-browse-issue         M-x ... RET
   Open the current issue in external browser.
org-jira-copy-current-issue-key M-x ... RET
   Copy the current issue's key into clipboard
org-jira-create-issue         M-x ... RET
   Create an issue
org-jira-create-subtask       M-x ... RET
   Create an subtask issue
org-jira-get-issues       M-x ... RET
   Get list of issues. Default is get unfinished issues assigned
org-jira-get-issues-from-filter M-x ... RET
   Get issues from filter which are jql created and saved on the
org-jira-get-issues-from-filter-headonly M-x ... RET
   Get issues *head only* from saved filter. See
   `org-jira-get-issues-from-filter'
org-jira-get-issues-headonly  M-x ... RET
   Get list of issues assigned to you and unresolved, head
org-jira-get-projects         M-x ... RET
   Get list of projects.
org-jira-get-subtasks         M-x ... RET
   Get subtasks for the current issue
org-jira-mode             M-x ... RET
   Toggle org-jira mode.
org-jira-progress-issue       M-x ... RET
   Progress issue workflow
org-jira-refresh-issue        M-x ... RET
   Refresh issue from jira to org
org-jira-todo-to-jira         M-x ... RET
   Convert an ordinary todo item to a jira ticket
org-jira-update-comment       M-x ... RET
   Update or create a comment for the current issue
org-jira-update-issue         M-x ... RET
   Update an issue

Acknowledgements

This plug-in is greatly inspired by org2blog.

This readme is written using org-mode itself.

About

Bring Jira and OrgMode together

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Emacs Lisp 98.8%
  • Other 1.2%