From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jambunathan K Subject: Re: [ANN] ELPA package for ODT and JabRef exporters Date: Mon, 27 Jan 2014 19:02:31 +0530 Message-ID: <87ob2x7dow.fsf@gmail.com> References: <878uu6aj86.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:54480) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W7mIX-0000rY-AU for emacs-orgmode@gnu.org; Mon, 27 Jan 2014 08:32:26 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1W7mIQ-0008Nk-QG for emacs-orgmode@gnu.org; Mon, 27 Jan 2014 08:32:21 -0500 Received: from plane.gmane.org ([80.91.229.3]:41883) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1W7mIQ-0008Nd-FD for emacs-orgmode@gnu.org; Mon, 27 Jan 2014 08:32:14 -0500 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1W7mIO-0002Gl-S2 for emacs-orgmode@gnu.org; Mon, 27 Jan 2014 14:32:12 +0100 Received: from 101.63.138.200 ([101.63.138.200]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 27 Jan 2014 14:32:12 +0100 Received: from kjambunathan by 101.63.138.200 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 27 Jan 2014 14:32:12 +0100 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Cc: Benjamin Slade , Aric Gregson This message SUPERSEDES instructions in the parent post (at http://lists.gnu.org/archive/html/emacs-orgmode/2014-01/msg01134.html) Elevator Pitch ============== I fixed few bugs in ELPA tarball (Thanks Benjamin). Adding the following URL to http://repo.or.cz/w/org-mode/org-kjn.git/blob_plain/master:/ to C-h v package-archives should work now. WARNING: Don't forget the trailing "/" in the above URL. ELPA tar for ODT + JabRef ========================= I have prepared an ELPA package org-odt-*.tar for easy distribution of bug fixes from private git repository [fn:1]. The package contains both ODT exporter and JabRef exporter. It also contains a standalone documentation (in both info and pdf format) for the ODT exporter. Pre-Requisites ============== Before installing the ODT tarball please ensure that you are using 1. org > 8.0 2. Emacs > 24.3.50 A good way to find out if you are running org > 8.0 is to do this: M-x locate-library ox If you get a hit, then you are using org > 8.0. If you don't find ox.el, you need to upgrade to org > 8.0. The best way to upgrade to the most recent org is via package manager (i.e., M-x list-packages) ---------------------------------------------------------------- Steps for installing ODT + JabRef ELPA package ============================================= 1. Clear out your .emacs. (Not needed, if you know what you are doing) 2. Ensure that you are using org > 8.0 (See previous instructions) 3. Update your package archives to include the "org-odt" repo. (custom-set-variables '(package-archives (quote (("gnu" . "http://elpa.gnu.org/packages/") ("org-odt" . "http://repo.or.cz/w/org-mode/org-kjn.git/blob_plain/master:/"))))) 4. Now do M-x list-packages Look out for "org-odt" package. Install it. 5. Goto start of .emacs and add the following line. (This should be the FIRST LINE in your .emacs) (setq org-odt-data-dir nil) 6. Check ON the ODT option under M-x customize-variable RET org-export-backends RET 7. Restart Emacs 8. Make sure that the following commands point to the ELPA directory M-x locate-library RET ox-odt RET M-x locate-library RET ox-jabref RET C-h v org-odt-styles-dir C-h v org-odt-schema-dir 9. Visit test.org and export it. Enjoy. ---------------------------------------------------------------- Some existing gotchas and bugs wrt `org-odt-data-dir' ===================================================== (5) above is needed to work around a bug in Emacs snapshot and Org build system. ---------------------------------------------------------------- How to host the above files on your own ELPA server ================================================== If someone wants to distribute the above files, please put the following files in your web-server. 1. Copy org-odt-YYYYMMDD.tar 2. Copy archive-contents Hint for ELPA Hosting ====================== See directory structure of http://orgmode.org/elpa/ 1. Various tar files are under that directory. 2. archive-contents points to the very LATEST tar file. http://orgmode.org/elpa/archive-contents ---------------------------------------------------------------- ODT exporter and Copyright Issues and a Note to the Users ========================================================= [fn:1] http://repo.or.cz/w/org-mode/org-kjn.git The above repo. contains many bug-fixes and enhancements that are NOT available with Emacs-24.4 or Orgmode git repo. For some reasons, emacs-devel, Org developers and I don't meet eye to eye. See http://lists.gnu.org/archive/html/emacs-devel/2013-12/msg00509.html. So the enhancements that are distributed with the above archive are unlikely to be avaible with Emacs or Org git repo. To the people who rely on ODT exporter for their day to day use and want it as part of Emacs 1. Find someone with Copyright Assignment to fix the critical issue(s). 2. Write to Gnu/Linux distributors - Debian, Gentoo etc - and persuade them to apply patches from my private repo before building the org-mode or Emacs deb packages. Note to Org developers ====================== If anyone comes this far, let me note that Bastien's latest change to ox-odt.el resembles very much fix on my Org private repo. I would argue that this fix borrows "very liberally" from my un-assigned changes. So .