* collaborating between org-mode and MS Word users
@ 2012-12-27 13:33 Julian Burgos
2012-12-27 15:09 ` Eric Schulte
` (2 more replies)
0 siblings, 3 replies; 4+ messages in thread
From: Julian Burgos @ 2012-12-27 13:33 UTC (permalink / raw)
To: emacs-orgmode
Dear list,
I use org-mode to draft papers and reports, using embedded R code and
LaTex snippets. It is a fantastic tool. But sometimes I have to
collaborate with less enlighted colleagues who use MS Word. For now I am
exporting my document to odt, and from there to MS word. Then, when I get
the manuscript back with comments and edits (usually using the “track
changes” option), I transcribe them to a new new node in my org-mode
document. This is usually a slow and error-prone process that involves
cutting and pasting text from the edited MS word document back into the
org-mode document, trying to avoid pasting over the LaTex and R snippets.
When I am done, I end up with a structure that looks something like this.
#+TITLE: My manuscript
* Version 1
** Introduction
** Methods .....
* Version 2
** Introduction
** Methods
..etc.
Of course, I could easily keep each version in a separate org mode file.
I would like to get some suggestions or tips on how to improve this
workflow. For example:
- Is there a better way to have a non-org mode use to edit/correct a
org-mode document and then bring back the corrections to an org-mode
document?
- What is the best way to compare org-mode nodes/branches (like in the
above example the Version 1 and Version 2 nodes?). Can I use ediff within
an org-mode file? Or should I keep separate versions on separate
documents?
All recommendations will be welcomed!
Julian
--
Julian Mariano Burgos, PhD
Hafrannsóknastofnunin/Marine Research Institute
Skúlagata 4, 121 Reykjavík, Iceland
Sími/Telephone : +354-5752037
Bréfsími/Telefax: +354-5752001
Netfang/Email: julian@hafro.is
^ permalink raw reply [flat|nested] 4+ messages in thread* Re: collaborating between org-mode and MS Word users
2012-12-27 13:33 collaborating between org-mode and MS Word users Julian Burgos
@ 2012-12-27 15:09 ` Eric Schulte
2012-12-29 18:31 ` Karl Voit
2012-12-31 0:26 ` Tony Day
2 siblings, 0 replies; 4+ messages in thread
From: Eric Schulte @ 2012-12-27 15:09 UTC (permalink / raw)
To: Julian Burgos; +Cc: emacs-orgmode
"Julian Burgos" <julian@hafro.is> writes:
> Dear list,
>
> I use org-mode to draft papers and reports, using embedded R code and
> LaTex snippets. It is a fantastic tool. But sometimes I have to
> collaborate with less enlighted colleagues who use MS Word. For now I am
> exporting my document to odt, and from there to MS word. Then, when I get
> the manuscript back with comments and edits (usually using the “track
> changes” option), I transcribe them to a new new node in my org-mode
> document. This is usually a slow and error-prone process that involves
> cutting and pasting text from the edited MS word document back into the
> org-mode document, trying to avoid pasting over the LaTex and R snippets.
> When I am done, I end up with a structure that looks something like this.
>
> #+TITLE: My manuscript
> * Version 1
> ** Introduction
> ** Methods .....
> * Version 2
> ** Introduction
> ** Methods
> ..etc.
>
> Of course, I could easily keep each version in a separate org mode file.
>
> I would like to get some suggestions or tips on how to improve this
> workflow. For example:
> - Is there a better way to have a non-org mode use to edit/correct a
> org-mode document and then bring back the corrections to an org-mode
> document?
Currently Org-mode exports to many different formats (html, latex, odt,
etc...), but I do not know of any backend which may be imported into
Org-mode. I believe that the ODT method you are currently using may be
your best option.
>
> - What is the best way to compare org-mode nodes/branches (like in the
> above example the Version 1 and Version 2 nodes?).
I would recommend either
1. If you are familiar with git, it would be an ideal way to track
different versions of your document. It would allow you to keep all
past versions without cluttering your directories, and to easily view
(checkout) older versions and view diffs between versions. Git has
the added benefit of providing the ability to tag specific versions
with semantically meaningful names. The downside of git is the
extremely slow learning curve, meaning each of the above actions will
take some possibly large amount of time to master.
2. If not git (or some comparable version control system), then I'd
suggest using separate files, as that way you can easily view diffs
between different versions. There has been a diff tool generated
specifically for Org-mode documents [1]. It is able to do things
like notice when two subtrees have been swapped.
> Can I use ediff within an org-mode file?
Not that I know of, but it may not be difficult to write elisp functions
to write seperate subtrees to different files and then run ediff on
those files.
> Or should I keep separate versions on separate documents?
>
This is what I would recommend, as most diff tools expect separate files
(either separate on the file system, or separate versions in a version
control system).
>
> All recommendations will be welcomed!
>
Hope this helps,
>
> Julian
Footnotes:
[1] http://orgmode.org/worg/org-contrib/gsoc2012/student-projects/git-merge-tool/index.html
--
Eric Schulte
http://cs.unm.edu/~eschulte
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: collaborating between org-mode and MS Word users
2012-12-27 13:33 collaborating between org-mode and MS Word users Julian Burgos
2012-12-27 15:09 ` Eric Schulte
@ 2012-12-29 18:31 ` Karl Voit
2012-12-31 0:26 ` Tony Day
2 siblings, 0 replies; 4+ messages in thread
From: Karl Voit @ 2012-12-29 18:31 UTC (permalink / raw)
To: emacs-orgmode
* Julian Burgos <julian@hafro.is> wrote:
>
> - Is there a better way to have a non-org mode use to edit/correct a
> org-mode document and then bring back the corrections to an org-mode
> document?
What about simple text files? Export your Org-file into UTF-8, keep
a copy of it and compare your copy with the file you will receive
from your colleague.
Notepad should be sufficient for your colleagues. But it also works
with an email client which does not convert to HTML emails.
> - What is the best way to compare org-mode nodes/branches (like in the
> above example the Version 1 and Version 2 nodes?). Can I use ediff within
> an org-mode file? Or should I keep separate versions on separate
> documents?
Eric already pointed you to git. I absolutely subscribe to this
idea.
Contrary to Eric I do think that somebody with no prior version
control experience is able to learn basics of git with a decent
tutorial pretty quickly.
The problem with git is that it is so different to SVN and others.
This way, people already using SVN and such are having issues when
moving to git.
--
Karl Voit
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: collaborating between org-mode and MS Word users
2012-12-27 13:33 collaborating between org-mode and MS Word users Julian Burgos
2012-12-27 15:09 ` Eric Schulte
2012-12-29 18:31 ` Karl Voit
@ 2012-12-31 0:26 ` Tony Day
2 siblings, 0 replies; 4+ messages in thread
From: Tony Day @ 2012-12-31 0:26 UTC (permalink / raw)
To: Julian Burgos; +Cc: emacs-orgmode
"Julian Burgos" <julian@hafro.is> writes:
> - Is there a better way to have a non-org mode use to edit/correct a
> org-mode document and then bring back the corrections to an org-mode
> document?
If MS Word users can't tolerate plain text org-mode files then I can't
think of many shortcuts. This works well when bringing a docx back into
emacs:
#+begin_src emacs-lisp
(add-to-list 'auto-mode-alist '("\\.docx\\'" . docx2txt))
(defun docx2txt ()
"Run docx2txt on the entire buffer."
(shell-command-on-region (point-min) (point-max) "docx2txt.pl" t t))
#+end_src
> - What is the best way to compare org-mode nodes/branches (like in the
> above example the Version 1 and Version 2 nodes?). Can I use ediff within
> an org-mode file? Or should I keep separate versions on separate
> documents?
ediff-regions-linewise might get the job done. Within
that process, org-mark-subtree and C-u C-c C-w to quickly jump to the
relevant subtrees are great speed ups.
More generally, re-builder is a godsend for working out the regular back and
forth transformations you'll be doing.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2012-12-31 0:26 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-12-27 13:33 collaborating between org-mode and MS Word users Julian Burgos
2012-12-27 15:09 ` Eric Schulte
2012-12-29 18:31 ` Karl Voit
2012-12-31 0:26 ` Tony Day
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).