What ways have you found to get edits from non-LaTeX users?Advisor likes MS Word, I like LaTeXHow can a Word writer write a manuscript with a LaTeX writer?
Dates on degrees don’t make sense – will people care?
Is "Busen" just the area between the breasts?
What is the highest voltage from the power supply a Raspberry Pi 3 B can handle without getting damaged?
Explain why a line can never intersect a plane in exactly two points.
When to remove insignificant variables?
Why does Linux list NVMe drives as /dev/nvme0 instead of /dev/sda?
How would modern naval warfare have to have developed differently for battleships to still be relevant in the 21st century?
What's currently blocking the construction of the wall between Mexico and the US?
Can a rogue use Sneak Attack in a Darkness spell cast by another player?
How to make clear to people I don't want to answer their "Where are you from?" question?
Paralleling mosfets reduce Rds On?
Designing a magic-compatible polearm
Do I have any obligations to my PhD supervisor's requests after I have graduated?
How does a blind passenger not die, if driver becomes unconscious
career in signal processing
Trainee keeps passing deadlines for independent learning
What is the origin of Scooby-Doo's name?
How do I handle a table mixing up the DM and the players' roles too often?
Why didn't the Cardassians take Terok Nor (Deep Space 9) with them when withdrawing from Bajor?
Did the CIA blow up a Siberian pipeline in 1982?
Heavily limited premature compiler translates text into excecutable python code
I don't like coffee, neither beer. How to politely work my way around that in a business situation?
Constitutionality of U.S. Democratic Presidential Candidate's Supreme Court Suggestion
Term or phrase for simply moving a problem from one area to another
What ways have you found to get edits from non-LaTeX users?
Advisor likes MS Word, I like LaTeXHow can a Word writer write a manuscript with a LaTeX writer?
.everyoneloves__top-leaderboard:empty,.everyoneloves__mid-leaderboard:empty,.everyoneloves__bot-mid-leaderboard:empty margin-bottom:0;
I sometimes need to get edits to my papers from non-LaTeX users. Do you have any clever methods of collaborating with them (or even other LaTeX users) in a productive way?
By this I mean sharing edits. So I have a document I've written in LaTeX, and they want to edit it, correct spelling and grammar, suggest additions, and so on.
big-list
|
show 1 more comment
I sometimes need to get edits to my papers from non-LaTeX users. Do you have any clever methods of collaborating with them (or even other LaTeX users) in a productive way?
By this I mean sharing edits. So I have a document I've written in LaTeX, and they want to edit it, correct spelling and grammar, suggest additions, and so on.
big-list
1
Closely related: Advisor likes MS Word, I like LaTeX and How can a Word writer write a manuscript with a LaTeX writer? (duplicate). The answer I'm about to add below is a rehash of the one at that second link
– Chris H
Jun 4 at 10:45
2
use pandoc and have them edit a markdown or word file.
– mb21
Jun 4 at 12:16
10
Working with other people! What a silly idea!
– thymaro
Jun 4 at 17:20
+1, this is the only advantage Word has over LaTeX. Accepting or refusing revisions is very easy with Word, but it's a nightmare with LaTeX.
– CarLaTeX
Jun 4 at 17:35
1
Pandoc was mentioned in the answers. But if you know about such a necessity beforehand, you might start out with pandoc. You'll get your LaTeX code easily generated, but also Word and what also not for the other persons. In case of directly editing the source pandoc is also easier to digest for non-TeX users.
– Oleg Lobachev
Jun 4 at 22:28
|
show 1 more comment
I sometimes need to get edits to my papers from non-LaTeX users. Do you have any clever methods of collaborating with them (or even other LaTeX users) in a productive way?
By this I mean sharing edits. So I have a document I've written in LaTeX, and they want to edit it, correct spelling and grammar, suggest additions, and so on.
big-list
I sometimes need to get edits to my papers from non-LaTeX users. Do you have any clever methods of collaborating with them (or even other LaTeX users) in a productive way?
By this I mean sharing edits. So I have a document I've written in LaTeX, and they want to edit it, correct spelling and grammar, suggest additions, and so on.
big-list
big-list
edited Jun 4 at 0:33
Canageek
asked Jun 3 at 21:51
CanageekCanageek
8,76984797
8,76984797
1
Closely related: Advisor likes MS Word, I like LaTeX and How can a Word writer write a manuscript with a LaTeX writer? (duplicate). The answer I'm about to add below is a rehash of the one at that second link
– Chris H
Jun 4 at 10:45
2
use pandoc and have them edit a markdown or word file.
– mb21
Jun 4 at 12:16
10
Working with other people! What a silly idea!
– thymaro
Jun 4 at 17:20
+1, this is the only advantage Word has over LaTeX. Accepting or refusing revisions is very easy with Word, but it's a nightmare with LaTeX.
– CarLaTeX
Jun 4 at 17:35
1
Pandoc was mentioned in the answers. But if you know about such a necessity beforehand, you might start out with pandoc. You'll get your LaTeX code easily generated, but also Word and what also not for the other persons. In case of directly editing the source pandoc is also easier to digest for non-TeX users.
– Oleg Lobachev
Jun 4 at 22:28
|
show 1 more comment
1
Closely related: Advisor likes MS Word, I like LaTeX and How can a Word writer write a manuscript with a LaTeX writer? (duplicate). The answer I'm about to add below is a rehash of the one at that second link
– Chris H
Jun 4 at 10:45
2
use pandoc and have them edit a markdown or word file.
– mb21
Jun 4 at 12:16
10
Working with other people! What a silly idea!
– thymaro
Jun 4 at 17:20
+1, this is the only advantage Word has over LaTeX. Accepting or refusing revisions is very easy with Word, but it's a nightmare with LaTeX.
– CarLaTeX
Jun 4 at 17:35
1
Pandoc was mentioned in the answers. But if you know about such a necessity beforehand, you might start out with pandoc. You'll get your LaTeX code easily generated, but also Word and what also not for the other persons. In case of directly editing the source pandoc is also easier to digest for non-TeX users.
– Oleg Lobachev
Jun 4 at 22:28
1
1
Closely related: Advisor likes MS Word, I like LaTeX and How can a Word writer write a manuscript with a LaTeX writer? (duplicate). The answer I'm about to add below is a rehash of the one at that second link
– Chris H
Jun 4 at 10:45
Closely related: Advisor likes MS Word, I like LaTeX and How can a Word writer write a manuscript with a LaTeX writer? (duplicate). The answer I'm about to add below is a rehash of the one at that second link
– Chris H
Jun 4 at 10:45
2
2
use pandoc and have them edit a markdown or word file.
– mb21
Jun 4 at 12:16
use pandoc and have them edit a markdown or word file.
– mb21
Jun 4 at 12:16
10
10
Working with other people! What a silly idea!
– thymaro
Jun 4 at 17:20
Working with other people! What a silly idea!
– thymaro
Jun 4 at 17:20
+1, this is the only advantage Word has over LaTeX. Accepting or refusing revisions is very easy with Word, but it's a nightmare with LaTeX.
– CarLaTeX
Jun 4 at 17:35
+1, this is the only advantage Word has over LaTeX. Accepting or refusing revisions is very easy with Word, but it's a nightmare with LaTeX.
– CarLaTeX
Jun 4 at 17:35
1
1
Pandoc was mentioned in the answers. But if you know about such a necessity beforehand, you might start out with pandoc. You'll get your LaTeX code easily generated, but also Word and what also not for the other persons. In case of directly editing the source pandoc is also easier to digest for non-TeX users.
– Oleg Lobachev
Jun 4 at 22:28
Pandoc was mentioned in the answers. But if you know about such a necessity beforehand, you might start out with pandoc. You'll get your LaTeX code easily generated, but also Word and what also not for the other persons. In case of directly editing the source pandoc is also easier to digest for non-TeX users.
– Oleg Lobachev
Jun 4 at 22:28
|
show 1 more comment
16 Answers
16
active
oldest
votes
Having been asked to provide comments on quite a few documents to which I would not have access to the original, I have adopted the following method:
Request the file in pdf form; it must have either clear page numbers or line numbers (or both).
Reading through the pdf file on screen, open a text file and enter comments in the form
p.n, col.n, para.n, l.n -- "text being commented on", <comment>
If a commented item spans more than one page, column, line, then "pp.", "cols.", "ll." is specified. An extensive text can be specified as "XX ... YY", as long as the extent of the text is unambiguous.Return the comment file by email.
The result has never been questioned, except when I've inadvertently misidentified something. The method has been used for comments on The TeXbook, articles for publication (not for TUGboat, where I do have access to the source), and several books whose sources have been in (La)TeX, Word, or gosh knows what else. It's maybe more verbose than other methods, but it has the virtue of not being able to foul up the original, which is always appreciated.
2
I loved that "gosh"! +1. By the way, I do not agree with your answer: actually there are more sofisticated ways to comment a file instead of txt files.
– manooooh
Jun 4 at 5:26
15
+1 It’s worth noting that this approach, combined with noting smaller comments (typos etc) in red ink or pencil on a printed copy, is the tried-and-tested workflow of traditional professional proofreading.
– Peter LeFanu Lumsdaine
Jun 4 at 8:14
2
@PeterLeFanuLumsdaine -- I'd like also to point out that this method works when the only resource one has available is an out-of-date and somewhat defective laptop. All that's required is the knowledge of what needs correcting; no paper, no scanner, only access (at a later time) to email.
– barbara beeton
Jun 4 at 16:29
4
@manooooh There are certainly "more sophisticated" ways to comment than text files, but sophistication in a certain area can as often be a bad thing as a good one. Text formats can easily be read in a lot of different ways, and it's very unlikely that someone can't read and write one, regardless of what system they're using. Also, simpler formats such as text may enable more sophistication in further processing; it can be easier to write simple programs to process a file in barbara's format than it would be in a more "sophisticated" format.
– Curt J. Sampson
Jun 5 at 0:41
add a comment |
(Disclaimer: I currently am part of Overleaf's support staff)
For none-LaTeX users one might try to use Overleaf's rich text mode, which should be quite easy to use for standard formattings.
Also the comment and track changes features of Overleaf can be very handy to get input from others (if it's just reviewing tasks).
2
+1 for Overleaf. ShareLaTeX was my gateway to LaTeX and made it so easy for me.
– Ian
Jun 4 at 15:20
3
But the track changes feature only works properly if one of the authors has a paid account, they disappear in free accounts.
– user000001
Jun 5 at 5:33
1
+1. I recently published a paper in a journal which uses Overleaf for coordinating the final editions with the authors, and I was surprised with how well it went.
– Jakub Konieczny
Jun 5 at 12:51
I first used Overleaf as a non-LaTeX user a few years back, and I quite liked it (enough to learn enough LaTeX to fix some formatting problems from my co-authors)
– Joe
Jun 5 at 16:21
add a comment |
When I'm working with other TeX users I tend to use git
for collaboration if they are used to working with it. If they are not used to working with git
they will be afterwards :)
5
The question is “What ways have you found to get edits from non-LaTeX users?”
– Henri Menke
Jun 3 at 23:01
9
@HenriMenke and includes the fatal statement "or even other LaTeX users".
– Skillmon
Jun 3 at 23:01
add a comment |
I'm sending occasionally the *.tex file, renamed to *.txt and ask the recipient to change the text, but not to touch anything beginning with "".
People can work with whatever software and eventually I return a decent PDF.
4
You can even let them go wild and then checked whatever they messed up with a difftool
– Vrakfall
Jun 4 at 21:12
1
"ask... not to touch [something]" yeah that will work </cynicism> . I've found it well-nigh impossible to get humans to follow directions.
– Carl Witthoft
Jun 5 at 13:48
@CarlWitthoft Well, I'm a lawyer and people pay money to me to get my directions.
– Keks Dose
Jun 5 at 14:32
You should also tell the non-LaTeX users that lines starting with%
are comments. Whatever remarks they might have, they should just start a line with%
and then start to type. Since you are fluent using LaTeX and probably are using a diff tool anyway, it's easy to see the comments and react to them.
– Roland Illig
Jun 5 at 18:41
2
@RolandIllig But unfortunately the recipients don't have a decent editor. The second line (or paragraph) of their comment won't start with a percent sign.
– Keks Dose
Jun 5 at 20:51
add a comment |
My preferred answer to the actual question is:
Produce a PDF of your document, and invite them to annotate that using PDF annotation tools (which are standard in Adobe Reader and others).
Then you go through those changes and (should you wish) incorporate them into your LaTeX code.
My answer, going slightly beyond the question, is:
If it's a "true" collaboration where all authors are writing major parts of the document, making significant changes, etc (rather than just getting a supervisor to comment on the near-final version), and some authors are not LaTeX users, then don't use LaTeX. Unless the document is very mathematical it's probably easier to just absorb the pain and annoyance and use Word.
When I'm writing a technical paper with technical co-authors, it's LaTeX all the way. When I'm writing something interdisciplinary with social scientists or policy experts, I just use Word.
1
That works, but I've found use of annotation - or even Word's "comment" features incredibly tedious when comparing with Word's "track changes" feature.
– Carl Witthoft
Jun 5 at 13:50
The following is probably my own fault: I don't think that using Word for anything is easier. Each time I try to use Word -- because it's just a small document and/or I'm part of a group with multiple TeX-illiterates -- I end up needing >30min to get something small and easy done, like moving a picture (with then correct captions, references, LoF entries...). IMHO, Word is never easier, for no purpose, again, this might be my own Word-illiteracy. I'd rather spend an hour porting their contents into TeX, than an hour yelling at my computer.
– Skillmon
Jun 6 at 8:35
@skillmon I think it's fair to say that while word is worse at many things, it's also true that not many people know how to use Word properly. It has its own learning curve, but unlike LaTeX's one it's easy to think you're at the top of it when you're actually near the bottom 😉
– Flyto
Jun 6 at 17:17
add a comment |
Convert them (the non-LaTeX users) to LaTex!
After all, LaTex vs Word is almost a question of religion and the use of the verb to convert actually works fine for both...
Any other way that I have experienced, unfortunately, has a downside: it increases the time lost doing the same job several times, and this grows with the number of active collaborators.
What follows is the evolution of sending them the tex
file and asking them to add the correction directly with an editor that is able to color the source code (so that it is immediately understandable even for newcomers what is text and what is not, like comments, reserved words ...), reserving to a holy soul the task of correcting at a later time the LaTex errors introduced (maybe with the help of latexdiff
).
The first step
I found effective the use of online collaboration sites on which I prepared in advance the empty model of the article. Then I go to fill it during an audio chat with the not-LaTex colleagues using the ready text that they will review:
with successive copy & paste actions, slowly, block by block, explaining the main details.
It is time consuming, but less then the alternatives, and with the prospect of decreasing the used time.
Thus, they can see the base operations and do the relative text corrections with few or no fear (and mess).
For the first time(s) I prepare some comment (colored) for them at the end of the document; they can copy, paste where it is needed and edit the text inside the braces. colorJoeColor This is a comment from Joe
... having care to define their colors and include the needed packages.
In each moment I, or the other LaTex users, can help/correct their comments and make them LaTex compliant.
Actually searching for a valid self hosted solution that can silence the security and privacy concerns
(probably a ShareLatex/Overleaf mounted on a virtual server with a public or traceable IP).
GLWT in a standard business environment (sad face)
– Carl Witthoft
Jun 5 at 13:50
@CarlWitthoft Any suggestion? (perplexed face). Some words more?:-)
– Hastur
Jun 5 at 18:14
"good luck with that" -- at least in the USA, lots of companies are software-paranoid, and the concept of rolling out MikTex + TexStudio, etc. to many users is outside of the IT department's reality.
– Carl Witthoft
Jun 6 at 12:26
Not sure it's legal to convert people to latex. Perhaps you may convert them to latex users though :-)
– Luc
Jun 7 at 10:09
add a comment |
Convert to Word the LaTeX documents, send them that. I use https://online2pdf.com which does a decent job, if there aren't too many figures or strange formatting. However, it involves sending my files to an unknown party that could be archiving them, selling the data, etc. It also often screws up formatting pretty hard, and can take up to an hour to fix that, and once or twice I've just given up. On the plus side, I've never encountered another Track Changes feature as good as Words, as it tracks character by character instead of just highlighting the whole line like diff. Plus changes in font size and whatnot mean you get hypenated words in the middle of paragraphs. Still the most ideal option a lot of the time. This is what I use with a lot of collaborators.
Edit: Moved the other suggestions to separate answers per suggestions in the comments.
8
“I've never encountered another Track Changes feature as good as Word's”git diff -w --word-diff
– Henri Menke
Jun 3 at 22:04
4
@Canageek Since you intend this to be a big list, it might be better to split each of your sub-answers as a separate answers. This would give a better sense of which methods people use or like best.
– Alan Munn
Jun 3 at 22:32
1
@HenriMenke I'd opt forgit diff --word-diff=color
so there aren't any plus or minus signs.
– UTF-8
Jun 4 at 12:48
You can also do this without git. Installwdiff
andcolordiff
. Then dowdiff file1 file2 | colordiff
.
– UTF-8
Jun 4 at 12:52
1
Update: My method has a flaw that I accidentally discovered in the meantime. When viewing identical files with itemized lists, I was shown lots of changes. So don't rely on this but it's a nice indication to get an overview over small changes in a long file w/o losing track of where you are cuz the entire file is printed and the colors in an otherwise monochrome text are just super easy to spot when scrolling through.
– UTF-8
Jun 6 at 0:09
|
show 1 more comment
I find the best way to get edits/comments/feedback on any document is by using track changes and comments in Word.
This raises two issues:
- how to convert your Latex document into a Word document
- how to incorporate Word edits/comments into your Latex document
Here are some solutions.
1. Copy-and-paste
Just copy-and-paste your Latex document into Word and send the Word document along with the PDF. The editor can open both side-by-side and edit/comment the Word document. Copy-and-pasting back into Latex may be problematic in which case you will need to make the changes one-by-one.
2. Convert PDF to Word document using Word
Open the PDF with Word and it will automatically convert the document, however formatting will likely change significantly. The editor can edit/comment the Word document in a WYSIWYG manner. You will have to implement these edits/comments in Latex manually one-by-one.
3. Convert Latex to Word document using Pandoc
J. Alexander Branham wrote an excellent guide to this process. To briefly summarise here: you can use a program called Pandoc to convert Latex into Word. It works very well for documents with minimal use of packages. The resulting document will be much cleaner than the one produced by Word when opening a PDF, meaning edits will not cause weird formatting issues. You can also do some clever things with Git if you have the skills and interest.
Summary
The methods are listed in order of increasing complexity but also increasing functionality. 1 is very straightforward but not very WYSIWYG in terms of the final document. 2 is still quite straightforward, but the formatting could be weird and distracting. 3 will produce the best formatting of the Word document but there are several steps involved. In any case it would be best if the editor could simultaneously refer to the PDF.
add a comment |
Frankly I do not understand the purpose of this question. If this is a collaboration on contents, one can just share the information in whatever format is convenient, e.g. emails, data files, pdf files, ascii text. Once you wrap up you need to agree on the document preparation system. From the question I infer that this will be LaTeX.
Of course, if the question is how to jointly grow a document that has cross links, references and so on, then IMHO there is no other way than recommending them to quickly look at a LaTeX intro. They will have to know how to label an equation that they want to refer to later. If you prepared the basic document well, i.e. just use some standard class, basic packages and avoid introducing too many self-written macros, they will be able to focus on the contents and add some text here and there. Just make sure that no one introduces glorious definitions as for instance defaalpha
. Also tell them that adding references by hand is not an option.
add a comment |
I've found back-and-forth conversions to be hopeless, so here's an approach that worked well for me, assuming that there isn't a huge amount of markup inline.
I also assume here that there's a decent reason for the final version to use LaTeX, and that the Word-using co-author (a) is sufficiently important that you can't say "tough luck, we're doing it my way", and (b) needs to edit and not just comment on the paper.
Maintaining a Word file with LaTeX commands (ref
and cite
are probably the most important) has worked well for me in the past. Images can be imported into Word, even equations can be compiled using standalone
and pasted in from a parallel LaTeX document. The body text can be converted using something like pandoc, which can deal with ordinary text quite happily including things like font formatting - though I suggest running it over a stripped down copy of your file. Word's "track changes" feature is useful and requires only switching on, not learning.
add a comment |
With a pen. Have them printed then edit them with a pen. Not exactly environmentally friendly, but I know a lot of people who will do this anyway, even if given a word doc with track changes on. However, my girlfriend doesn't own a printer. This is what I use with my boss.
add a comment |
Ask them to use some WYSIWYG/WYSIWYM editor, or the most similar you can find, having care to set them to be fully (La)Tex compatible: Lyx, BaKoMa, Scientific word...
add a comment |
Send the PDF output to your collaborators and have them add sticky notes using PDF annotations. Viewers supporting creation of sticky notes include Adobe Reader, Foxit Reader, and Okular. Many other viewers support showing sticky notes, like Evince.
add a comment |
Have them edit the TeX file even if they don't know LaTeX. I don't get why so many people oppose this, it isn't like the body text has much formatting in it, but they rarely will try this. Reading raw TeX is kinda a pain though, as it isn't formatted for the human eye, and I put one sentence per line, which makes it harder to read.
1
I was imagining sending a raw .tex file to my colleague, the same who has problem in reading a .zip file (on Windows)...
– CarLaTeX
Jun 5 at 5:48
add a comment |
Convert your LaTeX document to Markdown (for example with pandoc
) -- or write your original directly in Markdown --- and let them edit the Markdown text file.
add a comment |
Having been a primary latex user during my PhD with a latex and non-latex reviewers, I settled on a low-ish tech approach to begin with, which was simply to ask the reviewers to annotate rendered PDFs and send me annotated PDFs. This was a little clumsy because sometimes annotations could get lost (software problems) or the way they'd be collapsed meant it was hard to read/review particularly long comments/discussions.
Later on, seeking a way to develop a pseudo-word style review process, I found the todonotes package, and I incorporated this into my document(s) with a macro for each reviewer -- define a todobr
macro for Bob Reviewer and a todoar
for Alice Reviewer, and one for myself. Even non-latex users had no trouble being instructed to insert comments by newline todoinitialsyour comment here
and this would result in a document with minimal formatting changes (when runing with todonotes off, changes due exclusively to additional newlines in the prose which wouldn't usually be there) and conversational style todo bubbles inline when todonotes was enabled. I found this really effective for myself, a casual latex user and a complete non-latex user.
add a comment |
Your Answer
StackExchange.ready(function()
var channelOptions =
tags: "".split(" "),
id: "85"
;
initTagRenderer("".split(" "), "".split(" "), channelOptions);
StackExchange.using("externalEditor", function()
// Have to fire editor after snippets, if snippets enabled
if (StackExchange.settings.snippets.snippetsEnabled)
StackExchange.using("snippets", function()
createEditor();
);
else
createEditor();
);
function createEditor()
StackExchange.prepareEditor(
heartbeatType: 'answer',
autoActivateHeartbeat: false,
convertImagesToLinks: false,
noModals: true,
showLowRepImageUploadWarning: true,
reputationToPostImages: null,
bindNavPrevention: true,
postfix: "",
imageUploader:
brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
allowUrls: true
,
onDemand: true,
discardSelector: ".discard-answer"
,immediatelyShowMarkdownHelp:true
);
);
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2ftex.stackexchange.com%2fquestions%2f494059%2fwhat-ways-have-you-found-to-get-edits-from-non-latex-users%23new-answer', 'question_page');
);
Post as a guest
Required, but never shown
16 Answers
16
active
oldest
votes
16 Answers
16
active
oldest
votes
active
oldest
votes
active
oldest
votes
Having been asked to provide comments on quite a few documents to which I would not have access to the original, I have adopted the following method:
Request the file in pdf form; it must have either clear page numbers or line numbers (or both).
Reading through the pdf file on screen, open a text file and enter comments in the form
p.n, col.n, para.n, l.n -- "text being commented on", <comment>
If a commented item spans more than one page, column, line, then "pp.", "cols.", "ll." is specified. An extensive text can be specified as "XX ... YY", as long as the extent of the text is unambiguous.Return the comment file by email.
The result has never been questioned, except when I've inadvertently misidentified something. The method has been used for comments on The TeXbook, articles for publication (not for TUGboat, where I do have access to the source), and several books whose sources have been in (La)TeX, Word, or gosh knows what else. It's maybe more verbose than other methods, but it has the virtue of not being able to foul up the original, which is always appreciated.
2
I loved that "gosh"! +1. By the way, I do not agree with your answer: actually there are more sofisticated ways to comment a file instead of txt files.
– manooooh
Jun 4 at 5:26
15
+1 It’s worth noting that this approach, combined with noting smaller comments (typos etc) in red ink or pencil on a printed copy, is the tried-and-tested workflow of traditional professional proofreading.
– Peter LeFanu Lumsdaine
Jun 4 at 8:14
2
@PeterLeFanuLumsdaine -- I'd like also to point out that this method works when the only resource one has available is an out-of-date and somewhat defective laptop. All that's required is the knowledge of what needs correcting; no paper, no scanner, only access (at a later time) to email.
– barbara beeton
Jun 4 at 16:29
4
@manooooh There are certainly "more sophisticated" ways to comment than text files, but sophistication in a certain area can as often be a bad thing as a good one. Text formats can easily be read in a lot of different ways, and it's very unlikely that someone can't read and write one, regardless of what system they're using. Also, simpler formats such as text may enable more sophistication in further processing; it can be easier to write simple programs to process a file in barbara's format than it would be in a more "sophisticated" format.
– Curt J. Sampson
Jun 5 at 0:41
add a comment |
Having been asked to provide comments on quite a few documents to which I would not have access to the original, I have adopted the following method:
Request the file in pdf form; it must have either clear page numbers or line numbers (or both).
Reading through the pdf file on screen, open a text file and enter comments in the form
p.n, col.n, para.n, l.n -- "text being commented on", <comment>
If a commented item spans more than one page, column, line, then "pp.", "cols.", "ll." is specified. An extensive text can be specified as "XX ... YY", as long as the extent of the text is unambiguous.Return the comment file by email.
The result has never been questioned, except when I've inadvertently misidentified something. The method has been used for comments on The TeXbook, articles for publication (not for TUGboat, where I do have access to the source), and several books whose sources have been in (La)TeX, Word, or gosh knows what else. It's maybe more verbose than other methods, but it has the virtue of not being able to foul up the original, which is always appreciated.
2
I loved that "gosh"! +1. By the way, I do not agree with your answer: actually there are more sofisticated ways to comment a file instead of txt files.
– manooooh
Jun 4 at 5:26
15
+1 It’s worth noting that this approach, combined with noting smaller comments (typos etc) in red ink or pencil on a printed copy, is the tried-and-tested workflow of traditional professional proofreading.
– Peter LeFanu Lumsdaine
Jun 4 at 8:14
2
@PeterLeFanuLumsdaine -- I'd like also to point out that this method works when the only resource one has available is an out-of-date and somewhat defective laptop. All that's required is the knowledge of what needs correcting; no paper, no scanner, only access (at a later time) to email.
– barbara beeton
Jun 4 at 16:29
4
@manooooh There are certainly "more sophisticated" ways to comment than text files, but sophistication in a certain area can as often be a bad thing as a good one. Text formats can easily be read in a lot of different ways, and it's very unlikely that someone can't read and write one, regardless of what system they're using. Also, simpler formats such as text may enable more sophistication in further processing; it can be easier to write simple programs to process a file in barbara's format than it would be in a more "sophisticated" format.
– Curt J. Sampson
Jun 5 at 0:41
add a comment |
Having been asked to provide comments on quite a few documents to which I would not have access to the original, I have adopted the following method:
Request the file in pdf form; it must have either clear page numbers or line numbers (or both).
Reading through the pdf file on screen, open a text file and enter comments in the form
p.n, col.n, para.n, l.n -- "text being commented on", <comment>
If a commented item spans more than one page, column, line, then "pp.", "cols.", "ll." is specified. An extensive text can be specified as "XX ... YY", as long as the extent of the text is unambiguous.Return the comment file by email.
The result has never been questioned, except when I've inadvertently misidentified something. The method has been used for comments on The TeXbook, articles for publication (not for TUGboat, where I do have access to the source), and several books whose sources have been in (La)TeX, Word, or gosh knows what else. It's maybe more verbose than other methods, but it has the virtue of not being able to foul up the original, which is always appreciated.
Having been asked to provide comments on quite a few documents to which I would not have access to the original, I have adopted the following method:
Request the file in pdf form; it must have either clear page numbers or line numbers (or both).
Reading through the pdf file on screen, open a text file and enter comments in the form
p.n, col.n, para.n, l.n -- "text being commented on", <comment>
If a commented item spans more than one page, column, line, then "pp.", "cols.", "ll." is specified. An extensive text can be specified as "XX ... YY", as long as the extent of the text is unambiguous.Return the comment file by email.
The result has never been questioned, except when I've inadvertently misidentified something. The method has been used for comments on The TeXbook, articles for publication (not for TUGboat, where I do have access to the source), and several books whose sources have been in (La)TeX, Word, or gosh knows what else. It's maybe more verbose than other methods, but it has the virtue of not being able to foul up the original, which is always appreciated.
answered Jun 4 at 1:27
barbara beetonbarbara beeton
71.5k9165390
71.5k9165390
2
I loved that "gosh"! +1. By the way, I do not agree with your answer: actually there are more sofisticated ways to comment a file instead of txt files.
– manooooh
Jun 4 at 5:26
15
+1 It’s worth noting that this approach, combined with noting smaller comments (typos etc) in red ink or pencil on a printed copy, is the tried-and-tested workflow of traditional professional proofreading.
– Peter LeFanu Lumsdaine
Jun 4 at 8:14
2
@PeterLeFanuLumsdaine -- I'd like also to point out that this method works when the only resource one has available is an out-of-date and somewhat defective laptop. All that's required is the knowledge of what needs correcting; no paper, no scanner, only access (at a later time) to email.
– barbara beeton
Jun 4 at 16:29
4
@manooooh There are certainly "more sophisticated" ways to comment than text files, but sophistication in a certain area can as often be a bad thing as a good one. Text formats can easily be read in a lot of different ways, and it's very unlikely that someone can't read and write one, regardless of what system they're using. Also, simpler formats such as text may enable more sophistication in further processing; it can be easier to write simple programs to process a file in barbara's format than it would be in a more "sophisticated" format.
– Curt J. Sampson
Jun 5 at 0:41
add a comment |
2
I loved that "gosh"! +1. By the way, I do not agree with your answer: actually there are more sofisticated ways to comment a file instead of txt files.
– manooooh
Jun 4 at 5:26
15
+1 It’s worth noting that this approach, combined with noting smaller comments (typos etc) in red ink or pencil on a printed copy, is the tried-and-tested workflow of traditional professional proofreading.
– Peter LeFanu Lumsdaine
Jun 4 at 8:14
2
@PeterLeFanuLumsdaine -- I'd like also to point out that this method works when the only resource one has available is an out-of-date and somewhat defective laptop. All that's required is the knowledge of what needs correcting; no paper, no scanner, only access (at a later time) to email.
– barbara beeton
Jun 4 at 16:29
4
@manooooh There are certainly "more sophisticated" ways to comment than text files, but sophistication in a certain area can as often be a bad thing as a good one. Text formats can easily be read in a lot of different ways, and it's very unlikely that someone can't read and write one, regardless of what system they're using. Also, simpler formats such as text may enable more sophistication in further processing; it can be easier to write simple programs to process a file in barbara's format than it would be in a more "sophisticated" format.
– Curt J. Sampson
Jun 5 at 0:41
2
2
I loved that "gosh"! +1. By the way, I do not agree with your answer: actually there are more sofisticated ways to comment a file instead of txt files.
– manooooh
Jun 4 at 5:26
I loved that "gosh"! +1. By the way, I do not agree with your answer: actually there are more sofisticated ways to comment a file instead of txt files.
– manooooh
Jun 4 at 5:26
15
15
+1 It’s worth noting that this approach, combined with noting smaller comments (typos etc) in red ink or pencil on a printed copy, is the tried-and-tested workflow of traditional professional proofreading.
– Peter LeFanu Lumsdaine
Jun 4 at 8:14
+1 It’s worth noting that this approach, combined with noting smaller comments (typos etc) in red ink or pencil on a printed copy, is the tried-and-tested workflow of traditional professional proofreading.
– Peter LeFanu Lumsdaine
Jun 4 at 8:14
2
2
@PeterLeFanuLumsdaine -- I'd like also to point out that this method works when the only resource one has available is an out-of-date and somewhat defective laptop. All that's required is the knowledge of what needs correcting; no paper, no scanner, only access (at a later time) to email.
– barbara beeton
Jun 4 at 16:29
@PeterLeFanuLumsdaine -- I'd like also to point out that this method works when the only resource one has available is an out-of-date and somewhat defective laptop. All that's required is the knowledge of what needs correcting; no paper, no scanner, only access (at a later time) to email.
– barbara beeton
Jun 4 at 16:29
4
4
@manooooh There are certainly "more sophisticated" ways to comment than text files, but sophistication in a certain area can as often be a bad thing as a good one. Text formats can easily be read in a lot of different ways, and it's very unlikely that someone can't read and write one, regardless of what system they're using. Also, simpler formats such as text may enable more sophistication in further processing; it can be easier to write simple programs to process a file in barbara's format than it would be in a more "sophisticated" format.
– Curt J. Sampson
Jun 5 at 0:41
@manooooh There are certainly "more sophisticated" ways to comment than text files, but sophistication in a certain area can as often be a bad thing as a good one. Text formats can easily be read in a lot of different ways, and it's very unlikely that someone can't read and write one, regardless of what system they're using. Also, simpler formats such as text may enable more sophistication in further processing; it can be easier to write simple programs to process a file in barbara's format than it would be in a more "sophisticated" format.
– Curt J. Sampson
Jun 5 at 0:41
add a comment |
(Disclaimer: I currently am part of Overleaf's support staff)
For none-LaTeX users one might try to use Overleaf's rich text mode, which should be quite easy to use for standard formattings.
Also the comment and track changes features of Overleaf can be very handy to get input from others (if it's just reviewing tasks).
2
+1 for Overleaf. ShareLaTeX was my gateway to LaTeX and made it so easy for me.
– Ian
Jun 4 at 15:20
3
But the track changes feature only works properly if one of the authors has a paid account, they disappear in free accounts.
– user000001
Jun 5 at 5:33
1
+1. I recently published a paper in a journal which uses Overleaf for coordinating the final editions with the authors, and I was surprised with how well it went.
– Jakub Konieczny
Jun 5 at 12:51
I first used Overleaf as a non-LaTeX user a few years back, and I quite liked it (enough to learn enough LaTeX to fix some formatting problems from my co-authors)
– Joe
Jun 5 at 16:21
add a comment |
(Disclaimer: I currently am part of Overleaf's support staff)
For none-LaTeX users one might try to use Overleaf's rich text mode, which should be quite easy to use for standard formattings.
Also the comment and track changes features of Overleaf can be very handy to get input from others (if it's just reviewing tasks).
2
+1 for Overleaf. ShareLaTeX was my gateway to LaTeX and made it so easy for me.
– Ian
Jun 4 at 15:20
3
But the track changes feature only works properly if one of the authors has a paid account, they disappear in free accounts.
– user000001
Jun 5 at 5:33
1
+1. I recently published a paper in a journal which uses Overleaf for coordinating the final editions with the authors, and I was surprised with how well it went.
– Jakub Konieczny
Jun 5 at 12:51
I first used Overleaf as a non-LaTeX user a few years back, and I quite liked it (enough to learn enough LaTeX to fix some formatting problems from my co-authors)
– Joe
Jun 5 at 16:21
add a comment |
(Disclaimer: I currently am part of Overleaf's support staff)
For none-LaTeX users one might try to use Overleaf's rich text mode, which should be quite easy to use for standard formattings.
Also the comment and track changes features of Overleaf can be very handy to get input from others (if it's just reviewing tasks).
(Disclaimer: I currently am part of Overleaf's support staff)
For none-LaTeX users one might try to use Overleaf's rich text mode, which should be quite easy to use for standard formattings.
Also the comment and track changes features of Overleaf can be very handy to get input from others (if it's just reviewing tasks).
answered Jun 3 at 22:48
SkillmonSkillmon
26k12554
26k12554
2
+1 for Overleaf. ShareLaTeX was my gateway to LaTeX and made it so easy for me.
– Ian
Jun 4 at 15:20
3
But the track changes feature only works properly if one of the authors has a paid account, they disappear in free accounts.
– user000001
Jun 5 at 5:33
1
+1. I recently published a paper in a journal which uses Overleaf for coordinating the final editions with the authors, and I was surprised with how well it went.
– Jakub Konieczny
Jun 5 at 12:51
I first used Overleaf as a non-LaTeX user a few years back, and I quite liked it (enough to learn enough LaTeX to fix some formatting problems from my co-authors)
– Joe
Jun 5 at 16:21
add a comment |
2
+1 for Overleaf. ShareLaTeX was my gateway to LaTeX and made it so easy for me.
– Ian
Jun 4 at 15:20
3
But the track changes feature only works properly if one of the authors has a paid account, they disappear in free accounts.
– user000001
Jun 5 at 5:33
1
+1. I recently published a paper in a journal which uses Overleaf for coordinating the final editions with the authors, and I was surprised with how well it went.
– Jakub Konieczny
Jun 5 at 12:51
I first used Overleaf as a non-LaTeX user a few years back, and I quite liked it (enough to learn enough LaTeX to fix some formatting problems from my co-authors)
– Joe
Jun 5 at 16:21
2
2
+1 for Overleaf. ShareLaTeX was my gateway to LaTeX and made it so easy for me.
– Ian
Jun 4 at 15:20
+1 for Overleaf. ShareLaTeX was my gateway to LaTeX and made it so easy for me.
– Ian
Jun 4 at 15:20
3
3
But the track changes feature only works properly if one of the authors has a paid account, they disappear in free accounts.
– user000001
Jun 5 at 5:33
But the track changes feature only works properly if one of the authors has a paid account, they disappear in free accounts.
– user000001
Jun 5 at 5:33
1
1
+1. I recently published a paper in a journal which uses Overleaf for coordinating the final editions with the authors, and I was surprised with how well it went.
– Jakub Konieczny
Jun 5 at 12:51
+1. I recently published a paper in a journal which uses Overleaf for coordinating the final editions with the authors, and I was surprised with how well it went.
– Jakub Konieczny
Jun 5 at 12:51
I first used Overleaf as a non-LaTeX user a few years back, and I quite liked it (enough to learn enough LaTeX to fix some formatting problems from my co-authors)
– Joe
Jun 5 at 16:21
I first used Overleaf as a non-LaTeX user a few years back, and I quite liked it (enough to learn enough LaTeX to fix some formatting problems from my co-authors)
– Joe
Jun 5 at 16:21
add a comment |
When I'm working with other TeX users I tend to use git
for collaboration if they are used to working with it. If they are not used to working with git
they will be afterwards :)
5
The question is “What ways have you found to get edits from non-LaTeX users?”
– Henri Menke
Jun 3 at 23:01
9
@HenriMenke and includes the fatal statement "or even other LaTeX users".
– Skillmon
Jun 3 at 23:01
add a comment |
When I'm working with other TeX users I tend to use git
for collaboration if they are used to working with it. If they are not used to working with git
they will be afterwards :)
5
The question is “What ways have you found to get edits from non-LaTeX users?”
– Henri Menke
Jun 3 at 23:01
9
@HenriMenke and includes the fatal statement "or even other LaTeX users".
– Skillmon
Jun 3 at 23:01
add a comment |
When I'm working with other TeX users I tend to use git
for collaboration if they are used to working with it. If they are not used to working with git
they will be afterwards :)
When I'm working with other TeX users I tend to use git
for collaboration if they are used to working with it. If they are not used to working with git
they will be afterwards :)
answered Jun 3 at 22:52
SkillmonSkillmon
26k12554
26k12554
5
The question is “What ways have you found to get edits from non-LaTeX users?”
– Henri Menke
Jun 3 at 23:01
9
@HenriMenke and includes the fatal statement "or even other LaTeX users".
– Skillmon
Jun 3 at 23:01
add a comment |
5
The question is “What ways have you found to get edits from non-LaTeX users?”
– Henri Menke
Jun 3 at 23:01
9
@HenriMenke and includes the fatal statement "or even other LaTeX users".
– Skillmon
Jun 3 at 23:01
5
5
The question is “What ways have you found to get edits from non-LaTeX users?”
– Henri Menke
Jun 3 at 23:01
The question is “What ways have you found to get edits from non-LaTeX users?”
– Henri Menke
Jun 3 at 23:01
9
9
@HenriMenke and includes the fatal statement "or even other LaTeX users".
– Skillmon
Jun 3 at 23:01
@HenriMenke and includes the fatal statement "or even other LaTeX users".
– Skillmon
Jun 3 at 23:01
add a comment |
I'm sending occasionally the *.tex file, renamed to *.txt and ask the recipient to change the text, but not to touch anything beginning with "".
People can work with whatever software and eventually I return a decent PDF.
4
You can even let them go wild and then checked whatever they messed up with a difftool
– Vrakfall
Jun 4 at 21:12
1
"ask... not to touch [something]" yeah that will work </cynicism> . I've found it well-nigh impossible to get humans to follow directions.
– Carl Witthoft
Jun 5 at 13:48
@CarlWitthoft Well, I'm a lawyer and people pay money to me to get my directions.
– Keks Dose
Jun 5 at 14:32
You should also tell the non-LaTeX users that lines starting with%
are comments. Whatever remarks they might have, they should just start a line with%
and then start to type. Since you are fluent using LaTeX and probably are using a diff tool anyway, it's easy to see the comments and react to them.
– Roland Illig
Jun 5 at 18:41
2
@RolandIllig But unfortunately the recipients don't have a decent editor. The second line (or paragraph) of their comment won't start with a percent sign.
– Keks Dose
Jun 5 at 20:51
add a comment |
I'm sending occasionally the *.tex file, renamed to *.txt and ask the recipient to change the text, but not to touch anything beginning with "".
People can work with whatever software and eventually I return a decent PDF.
4
You can even let them go wild and then checked whatever they messed up with a difftool
– Vrakfall
Jun 4 at 21:12
1
"ask... not to touch [something]" yeah that will work </cynicism> . I've found it well-nigh impossible to get humans to follow directions.
– Carl Witthoft
Jun 5 at 13:48
@CarlWitthoft Well, I'm a lawyer and people pay money to me to get my directions.
– Keks Dose
Jun 5 at 14:32
You should also tell the non-LaTeX users that lines starting with%
are comments. Whatever remarks they might have, they should just start a line with%
and then start to type. Since you are fluent using LaTeX and probably are using a diff tool anyway, it's easy to see the comments and react to them.
– Roland Illig
Jun 5 at 18:41
2
@RolandIllig But unfortunately the recipients don't have a decent editor. The second line (or paragraph) of their comment won't start with a percent sign.
– Keks Dose
Jun 5 at 20:51
add a comment |
I'm sending occasionally the *.tex file, renamed to *.txt and ask the recipient to change the text, but not to touch anything beginning with "".
People can work with whatever software and eventually I return a decent PDF.
I'm sending occasionally the *.tex file, renamed to *.txt and ask the recipient to change the text, but not to touch anything beginning with "".
People can work with whatever software and eventually I return a decent PDF.
answered Jun 4 at 9:11
Keks DoseKeks Dose
21.9k35797
21.9k35797
4
You can even let them go wild and then checked whatever they messed up with a difftool
– Vrakfall
Jun 4 at 21:12
1
"ask... not to touch [something]" yeah that will work </cynicism> . I've found it well-nigh impossible to get humans to follow directions.
– Carl Witthoft
Jun 5 at 13:48
@CarlWitthoft Well, I'm a lawyer and people pay money to me to get my directions.
– Keks Dose
Jun 5 at 14:32
You should also tell the non-LaTeX users that lines starting with%
are comments. Whatever remarks they might have, they should just start a line with%
and then start to type. Since you are fluent using LaTeX and probably are using a diff tool anyway, it's easy to see the comments and react to them.
– Roland Illig
Jun 5 at 18:41
2
@RolandIllig But unfortunately the recipients don't have a decent editor. The second line (or paragraph) of their comment won't start with a percent sign.
– Keks Dose
Jun 5 at 20:51
add a comment |
4
You can even let them go wild and then checked whatever they messed up with a difftool
– Vrakfall
Jun 4 at 21:12
1
"ask... not to touch [something]" yeah that will work </cynicism> . I've found it well-nigh impossible to get humans to follow directions.
– Carl Witthoft
Jun 5 at 13:48
@CarlWitthoft Well, I'm a lawyer and people pay money to me to get my directions.
– Keks Dose
Jun 5 at 14:32
You should also tell the non-LaTeX users that lines starting with%
are comments. Whatever remarks they might have, they should just start a line with%
and then start to type. Since you are fluent using LaTeX and probably are using a diff tool anyway, it's easy to see the comments and react to them.
– Roland Illig
Jun 5 at 18:41
2
@RolandIllig But unfortunately the recipients don't have a decent editor. The second line (or paragraph) of their comment won't start with a percent sign.
– Keks Dose
Jun 5 at 20:51
4
4
You can even let them go wild and then checked whatever they messed up with a difftool
– Vrakfall
Jun 4 at 21:12
You can even let them go wild and then checked whatever they messed up with a difftool
– Vrakfall
Jun 4 at 21:12
1
1
"ask... not to touch [something]" yeah that will work </cynicism> . I've found it well-nigh impossible to get humans to follow directions.
– Carl Witthoft
Jun 5 at 13:48
"ask... not to touch [something]" yeah that will work </cynicism> . I've found it well-nigh impossible to get humans to follow directions.
– Carl Witthoft
Jun 5 at 13:48
@CarlWitthoft Well, I'm a lawyer and people pay money to me to get my directions.
– Keks Dose
Jun 5 at 14:32
@CarlWitthoft Well, I'm a lawyer and people pay money to me to get my directions.
– Keks Dose
Jun 5 at 14:32
You should also tell the non-LaTeX users that lines starting with
%
are comments. Whatever remarks they might have, they should just start a line with %
and then start to type. Since you are fluent using LaTeX and probably are using a diff tool anyway, it's easy to see the comments and react to them.– Roland Illig
Jun 5 at 18:41
You should also tell the non-LaTeX users that lines starting with
%
are comments. Whatever remarks they might have, they should just start a line with %
and then start to type. Since you are fluent using LaTeX and probably are using a diff tool anyway, it's easy to see the comments and react to them.– Roland Illig
Jun 5 at 18:41
2
2
@RolandIllig But unfortunately the recipients don't have a decent editor. The second line (or paragraph) of their comment won't start with a percent sign.
– Keks Dose
Jun 5 at 20:51
@RolandIllig But unfortunately the recipients don't have a decent editor. The second line (or paragraph) of their comment won't start with a percent sign.
– Keks Dose
Jun 5 at 20:51
add a comment |
My preferred answer to the actual question is:
Produce a PDF of your document, and invite them to annotate that using PDF annotation tools (which are standard in Adobe Reader and others).
Then you go through those changes and (should you wish) incorporate them into your LaTeX code.
My answer, going slightly beyond the question, is:
If it's a "true" collaboration where all authors are writing major parts of the document, making significant changes, etc (rather than just getting a supervisor to comment on the near-final version), and some authors are not LaTeX users, then don't use LaTeX. Unless the document is very mathematical it's probably easier to just absorb the pain and annoyance and use Word.
When I'm writing a technical paper with technical co-authors, it's LaTeX all the way. When I'm writing something interdisciplinary with social scientists or policy experts, I just use Word.
1
That works, but I've found use of annotation - or even Word's "comment" features incredibly tedious when comparing with Word's "track changes" feature.
– Carl Witthoft
Jun 5 at 13:50
The following is probably my own fault: I don't think that using Word for anything is easier. Each time I try to use Word -- because it's just a small document and/or I'm part of a group with multiple TeX-illiterates -- I end up needing >30min to get something small and easy done, like moving a picture (with then correct captions, references, LoF entries...). IMHO, Word is never easier, for no purpose, again, this might be my own Word-illiteracy. I'd rather spend an hour porting their contents into TeX, than an hour yelling at my computer.
– Skillmon
Jun 6 at 8:35
@skillmon I think it's fair to say that while word is worse at many things, it's also true that not many people know how to use Word properly. It has its own learning curve, but unlike LaTeX's one it's easy to think you're at the top of it when you're actually near the bottom 😉
– Flyto
Jun 6 at 17:17
add a comment |
My preferred answer to the actual question is:
Produce a PDF of your document, and invite them to annotate that using PDF annotation tools (which are standard in Adobe Reader and others).
Then you go through those changes and (should you wish) incorporate them into your LaTeX code.
My answer, going slightly beyond the question, is:
If it's a "true" collaboration where all authors are writing major parts of the document, making significant changes, etc (rather than just getting a supervisor to comment on the near-final version), and some authors are not LaTeX users, then don't use LaTeX. Unless the document is very mathematical it's probably easier to just absorb the pain and annoyance and use Word.
When I'm writing a technical paper with technical co-authors, it's LaTeX all the way. When I'm writing something interdisciplinary with social scientists or policy experts, I just use Word.
1
That works, but I've found use of annotation - or even Word's "comment" features incredibly tedious when comparing with Word's "track changes" feature.
– Carl Witthoft
Jun 5 at 13:50
The following is probably my own fault: I don't think that using Word for anything is easier. Each time I try to use Word -- because it's just a small document and/or I'm part of a group with multiple TeX-illiterates -- I end up needing >30min to get something small and easy done, like moving a picture (with then correct captions, references, LoF entries...). IMHO, Word is never easier, for no purpose, again, this might be my own Word-illiteracy. I'd rather spend an hour porting their contents into TeX, than an hour yelling at my computer.
– Skillmon
Jun 6 at 8:35
@skillmon I think it's fair to say that while word is worse at many things, it's also true that not many people know how to use Word properly. It has its own learning curve, but unlike LaTeX's one it's easy to think you're at the top of it when you're actually near the bottom 😉
– Flyto
Jun 6 at 17:17
add a comment |
My preferred answer to the actual question is:
Produce a PDF of your document, and invite them to annotate that using PDF annotation tools (which are standard in Adobe Reader and others).
Then you go through those changes and (should you wish) incorporate them into your LaTeX code.
My answer, going slightly beyond the question, is:
If it's a "true" collaboration where all authors are writing major parts of the document, making significant changes, etc (rather than just getting a supervisor to comment on the near-final version), and some authors are not LaTeX users, then don't use LaTeX. Unless the document is very mathematical it's probably easier to just absorb the pain and annoyance and use Word.
When I'm writing a technical paper with technical co-authors, it's LaTeX all the way. When I'm writing something interdisciplinary with social scientists or policy experts, I just use Word.
My preferred answer to the actual question is:
Produce a PDF of your document, and invite them to annotate that using PDF annotation tools (which are standard in Adobe Reader and others).
Then you go through those changes and (should you wish) incorporate them into your LaTeX code.
My answer, going slightly beyond the question, is:
If it's a "true" collaboration where all authors are writing major parts of the document, making significant changes, etc (rather than just getting a supervisor to comment on the near-final version), and some authors are not LaTeX users, then don't use LaTeX. Unless the document is very mathematical it's probably easier to just absorb the pain and annoyance and use Word.
When I'm writing a technical paper with technical co-authors, it's LaTeX all the way. When I'm writing something interdisciplinary with social scientists or policy experts, I just use Word.
answered Jun 4 at 17:14
FlytoFlyto
24827
24827
1
That works, but I've found use of annotation - or even Word's "comment" features incredibly tedious when comparing with Word's "track changes" feature.
– Carl Witthoft
Jun 5 at 13:50
The following is probably my own fault: I don't think that using Word for anything is easier. Each time I try to use Word -- because it's just a small document and/or I'm part of a group with multiple TeX-illiterates -- I end up needing >30min to get something small and easy done, like moving a picture (with then correct captions, references, LoF entries...). IMHO, Word is never easier, for no purpose, again, this might be my own Word-illiteracy. I'd rather spend an hour porting their contents into TeX, than an hour yelling at my computer.
– Skillmon
Jun 6 at 8:35
@skillmon I think it's fair to say that while word is worse at many things, it's also true that not many people know how to use Word properly. It has its own learning curve, but unlike LaTeX's one it's easy to think you're at the top of it when you're actually near the bottom 😉
– Flyto
Jun 6 at 17:17
add a comment |
1
That works, but I've found use of annotation - or even Word's "comment" features incredibly tedious when comparing with Word's "track changes" feature.
– Carl Witthoft
Jun 5 at 13:50
The following is probably my own fault: I don't think that using Word for anything is easier. Each time I try to use Word -- because it's just a small document and/or I'm part of a group with multiple TeX-illiterates -- I end up needing >30min to get something small and easy done, like moving a picture (with then correct captions, references, LoF entries...). IMHO, Word is never easier, for no purpose, again, this might be my own Word-illiteracy. I'd rather spend an hour porting their contents into TeX, than an hour yelling at my computer.
– Skillmon
Jun 6 at 8:35
@skillmon I think it's fair to say that while word is worse at many things, it's also true that not many people know how to use Word properly. It has its own learning curve, but unlike LaTeX's one it's easy to think you're at the top of it when you're actually near the bottom 😉
– Flyto
Jun 6 at 17:17
1
1
That works, but I've found use of annotation - or even Word's "comment" features incredibly tedious when comparing with Word's "track changes" feature.
– Carl Witthoft
Jun 5 at 13:50
That works, but I've found use of annotation - or even Word's "comment" features incredibly tedious when comparing with Word's "track changes" feature.
– Carl Witthoft
Jun 5 at 13:50
The following is probably my own fault: I don't think that using Word for anything is easier. Each time I try to use Word -- because it's just a small document and/or I'm part of a group with multiple TeX-illiterates -- I end up needing >30min to get something small and easy done, like moving a picture (with then correct captions, references, LoF entries...). IMHO, Word is never easier, for no purpose, again, this might be my own Word-illiteracy. I'd rather spend an hour porting their contents into TeX, than an hour yelling at my computer.
– Skillmon
Jun 6 at 8:35
The following is probably my own fault: I don't think that using Word for anything is easier. Each time I try to use Word -- because it's just a small document and/or I'm part of a group with multiple TeX-illiterates -- I end up needing >30min to get something small and easy done, like moving a picture (with then correct captions, references, LoF entries...). IMHO, Word is never easier, for no purpose, again, this might be my own Word-illiteracy. I'd rather spend an hour porting their contents into TeX, than an hour yelling at my computer.
– Skillmon
Jun 6 at 8:35
@skillmon I think it's fair to say that while word is worse at many things, it's also true that not many people know how to use Word properly. It has its own learning curve, but unlike LaTeX's one it's easy to think you're at the top of it when you're actually near the bottom 😉
– Flyto
Jun 6 at 17:17
@skillmon I think it's fair to say that while word is worse at many things, it's also true that not many people know how to use Word properly. It has its own learning curve, but unlike LaTeX's one it's easy to think you're at the top of it when you're actually near the bottom 😉
– Flyto
Jun 6 at 17:17
add a comment |
Convert them (the non-LaTeX users) to LaTex!
After all, LaTex vs Word is almost a question of religion and the use of the verb to convert actually works fine for both...
Any other way that I have experienced, unfortunately, has a downside: it increases the time lost doing the same job several times, and this grows with the number of active collaborators.
What follows is the evolution of sending them the tex
file and asking them to add the correction directly with an editor that is able to color the source code (so that it is immediately understandable even for newcomers what is text and what is not, like comments, reserved words ...), reserving to a holy soul the task of correcting at a later time the LaTex errors introduced (maybe with the help of latexdiff
).
The first step
I found effective the use of online collaboration sites on which I prepared in advance the empty model of the article. Then I go to fill it during an audio chat with the not-LaTex colleagues using the ready text that they will review:
with successive copy & paste actions, slowly, block by block, explaining the main details.
It is time consuming, but less then the alternatives, and with the prospect of decreasing the used time.
Thus, they can see the base operations and do the relative text corrections with few or no fear (and mess).
For the first time(s) I prepare some comment (colored) for them at the end of the document; they can copy, paste where it is needed and edit the text inside the braces. colorJoeColor This is a comment from Joe
... having care to define their colors and include the needed packages.
In each moment I, or the other LaTex users, can help/correct their comments and make them LaTex compliant.
Actually searching for a valid self hosted solution that can silence the security and privacy concerns
(probably a ShareLatex/Overleaf mounted on a virtual server with a public or traceable IP).
GLWT in a standard business environment (sad face)
– Carl Witthoft
Jun 5 at 13:50
@CarlWitthoft Any suggestion? (perplexed face). Some words more?:-)
– Hastur
Jun 5 at 18:14
"good luck with that" -- at least in the USA, lots of companies are software-paranoid, and the concept of rolling out MikTex + TexStudio, etc. to many users is outside of the IT department's reality.
– Carl Witthoft
Jun 6 at 12:26
Not sure it's legal to convert people to latex. Perhaps you may convert them to latex users though :-)
– Luc
Jun 7 at 10:09
add a comment |
Convert them (the non-LaTeX users) to LaTex!
After all, LaTex vs Word is almost a question of religion and the use of the verb to convert actually works fine for both...
Any other way that I have experienced, unfortunately, has a downside: it increases the time lost doing the same job several times, and this grows with the number of active collaborators.
What follows is the evolution of sending them the tex
file and asking them to add the correction directly with an editor that is able to color the source code (so that it is immediately understandable even for newcomers what is text and what is not, like comments, reserved words ...), reserving to a holy soul the task of correcting at a later time the LaTex errors introduced (maybe with the help of latexdiff
).
The first step
I found effective the use of online collaboration sites on which I prepared in advance the empty model of the article. Then I go to fill it during an audio chat with the not-LaTex colleagues using the ready text that they will review:
with successive copy & paste actions, slowly, block by block, explaining the main details.
It is time consuming, but less then the alternatives, and with the prospect of decreasing the used time.
Thus, they can see the base operations and do the relative text corrections with few or no fear (and mess).
For the first time(s) I prepare some comment (colored) for them at the end of the document; they can copy, paste where it is needed and edit the text inside the braces. colorJoeColor This is a comment from Joe
... having care to define their colors and include the needed packages.
In each moment I, or the other LaTex users, can help/correct their comments and make them LaTex compliant.
Actually searching for a valid self hosted solution that can silence the security and privacy concerns
(probably a ShareLatex/Overleaf mounted on a virtual server with a public or traceable IP).
GLWT in a standard business environment (sad face)
– Carl Witthoft
Jun 5 at 13:50
@CarlWitthoft Any suggestion? (perplexed face). Some words more?:-)
– Hastur
Jun 5 at 18:14
"good luck with that" -- at least in the USA, lots of companies are software-paranoid, and the concept of rolling out MikTex + TexStudio, etc. to many users is outside of the IT department's reality.
– Carl Witthoft
Jun 6 at 12:26
Not sure it's legal to convert people to latex. Perhaps you may convert them to latex users though :-)
– Luc
Jun 7 at 10:09
add a comment |
Convert them (the non-LaTeX users) to LaTex!
After all, LaTex vs Word is almost a question of religion and the use of the verb to convert actually works fine for both...
Any other way that I have experienced, unfortunately, has a downside: it increases the time lost doing the same job several times, and this grows with the number of active collaborators.
What follows is the evolution of sending them the tex
file and asking them to add the correction directly with an editor that is able to color the source code (so that it is immediately understandable even for newcomers what is text and what is not, like comments, reserved words ...), reserving to a holy soul the task of correcting at a later time the LaTex errors introduced (maybe with the help of latexdiff
).
The first step
I found effective the use of online collaboration sites on which I prepared in advance the empty model of the article. Then I go to fill it during an audio chat with the not-LaTex colleagues using the ready text that they will review:
with successive copy & paste actions, slowly, block by block, explaining the main details.
It is time consuming, but less then the alternatives, and with the prospect of decreasing the used time.
Thus, they can see the base operations and do the relative text corrections with few or no fear (and mess).
For the first time(s) I prepare some comment (colored) for them at the end of the document; they can copy, paste where it is needed and edit the text inside the braces. colorJoeColor This is a comment from Joe
... having care to define their colors and include the needed packages.
In each moment I, or the other LaTex users, can help/correct their comments and make them LaTex compliant.
Actually searching for a valid self hosted solution that can silence the security and privacy concerns
(probably a ShareLatex/Overleaf mounted on a virtual server with a public or traceable IP).
Convert them (the non-LaTeX users) to LaTex!
After all, LaTex vs Word is almost a question of religion and the use of the verb to convert actually works fine for both...
Any other way that I have experienced, unfortunately, has a downside: it increases the time lost doing the same job several times, and this grows with the number of active collaborators.
What follows is the evolution of sending them the tex
file and asking them to add the correction directly with an editor that is able to color the source code (so that it is immediately understandable even for newcomers what is text and what is not, like comments, reserved words ...), reserving to a holy soul the task of correcting at a later time the LaTex errors introduced (maybe with the help of latexdiff
).
The first step
I found effective the use of online collaboration sites on which I prepared in advance the empty model of the article. Then I go to fill it during an audio chat with the not-LaTex colleagues using the ready text that they will review:
with successive copy & paste actions, slowly, block by block, explaining the main details.
It is time consuming, but less then the alternatives, and with the prospect of decreasing the used time.
Thus, they can see the base operations and do the relative text corrections with few or no fear (and mess).
For the first time(s) I prepare some comment (colored) for them at the end of the document; they can copy, paste where it is needed and edit the text inside the braces. colorJoeColor This is a comment from Joe
... having care to define their colors and include the needed packages.
In each moment I, or the other LaTex users, can help/correct their comments and make them LaTex compliant.
Actually searching for a valid self hosted solution that can silence the security and privacy concerns
(probably a ShareLatex/Overleaf mounted on a virtual server with a public or traceable IP).
answered Jun 4 at 16:10
HasturHastur
23127
23127
GLWT in a standard business environment (sad face)
– Carl Witthoft
Jun 5 at 13:50
@CarlWitthoft Any suggestion? (perplexed face). Some words more?:-)
– Hastur
Jun 5 at 18:14
"good luck with that" -- at least in the USA, lots of companies are software-paranoid, and the concept of rolling out MikTex + TexStudio, etc. to many users is outside of the IT department's reality.
– Carl Witthoft
Jun 6 at 12:26
Not sure it's legal to convert people to latex. Perhaps you may convert them to latex users though :-)
– Luc
Jun 7 at 10:09
add a comment |
GLWT in a standard business environment (sad face)
– Carl Witthoft
Jun 5 at 13:50
@CarlWitthoft Any suggestion? (perplexed face). Some words more?:-)
– Hastur
Jun 5 at 18:14
"good luck with that" -- at least in the USA, lots of companies are software-paranoid, and the concept of rolling out MikTex + TexStudio, etc. to many users is outside of the IT department's reality.
– Carl Witthoft
Jun 6 at 12:26
Not sure it's legal to convert people to latex. Perhaps you may convert them to latex users though :-)
– Luc
Jun 7 at 10:09
GLWT in a standard business environment (sad face)
– Carl Witthoft
Jun 5 at 13:50
GLWT in a standard business environment (sad face)
– Carl Witthoft
Jun 5 at 13:50
@CarlWitthoft Any suggestion? (perplexed face). Some words more?
:-)
– Hastur
Jun 5 at 18:14
@CarlWitthoft Any suggestion? (perplexed face). Some words more?
:-)
– Hastur
Jun 5 at 18:14
"good luck with that" -- at least in the USA, lots of companies are software-paranoid, and the concept of rolling out MikTex + TexStudio, etc. to many users is outside of the IT department's reality.
– Carl Witthoft
Jun 6 at 12:26
"good luck with that" -- at least in the USA, lots of companies are software-paranoid, and the concept of rolling out MikTex + TexStudio, etc. to many users is outside of the IT department's reality.
– Carl Witthoft
Jun 6 at 12:26
Not sure it's legal to convert people to latex. Perhaps you may convert them to latex users though :-)
– Luc
Jun 7 at 10:09
Not sure it's legal to convert people to latex. Perhaps you may convert them to latex users though :-)
– Luc
Jun 7 at 10:09
add a comment |
Convert to Word the LaTeX documents, send them that. I use https://online2pdf.com which does a decent job, if there aren't too many figures or strange formatting. However, it involves sending my files to an unknown party that could be archiving them, selling the data, etc. It also often screws up formatting pretty hard, and can take up to an hour to fix that, and once or twice I've just given up. On the plus side, I've never encountered another Track Changes feature as good as Words, as it tracks character by character instead of just highlighting the whole line like diff. Plus changes in font size and whatnot mean you get hypenated words in the middle of paragraphs. Still the most ideal option a lot of the time. This is what I use with a lot of collaborators.
Edit: Moved the other suggestions to separate answers per suggestions in the comments.
8
“I've never encountered another Track Changes feature as good as Word's”git diff -w --word-diff
– Henri Menke
Jun 3 at 22:04
4
@Canageek Since you intend this to be a big list, it might be better to split each of your sub-answers as a separate answers. This would give a better sense of which methods people use or like best.
– Alan Munn
Jun 3 at 22:32
1
@HenriMenke I'd opt forgit diff --word-diff=color
so there aren't any plus or minus signs.
– UTF-8
Jun 4 at 12:48
You can also do this without git. Installwdiff
andcolordiff
. Then dowdiff file1 file2 | colordiff
.
– UTF-8
Jun 4 at 12:52
1
Update: My method has a flaw that I accidentally discovered in the meantime. When viewing identical files with itemized lists, I was shown lots of changes. So don't rely on this but it's a nice indication to get an overview over small changes in a long file w/o losing track of where you are cuz the entire file is printed and the colors in an otherwise monochrome text are just super easy to spot when scrolling through.
– UTF-8
Jun 6 at 0:09
|
show 1 more comment
Convert to Word the LaTeX documents, send them that. I use https://online2pdf.com which does a decent job, if there aren't too many figures or strange formatting. However, it involves sending my files to an unknown party that could be archiving them, selling the data, etc. It also often screws up formatting pretty hard, and can take up to an hour to fix that, and once or twice I've just given up. On the plus side, I've never encountered another Track Changes feature as good as Words, as it tracks character by character instead of just highlighting the whole line like diff. Plus changes in font size and whatnot mean you get hypenated words in the middle of paragraphs. Still the most ideal option a lot of the time. This is what I use with a lot of collaborators.
Edit: Moved the other suggestions to separate answers per suggestions in the comments.
8
“I've never encountered another Track Changes feature as good as Word's”git diff -w --word-diff
– Henri Menke
Jun 3 at 22:04
4
@Canageek Since you intend this to be a big list, it might be better to split each of your sub-answers as a separate answers. This would give a better sense of which methods people use or like best.
– Alan Munn
Jun 3 at 22:32
1
@HenriMenke I'd opt forgit diff --word-diff=color
so there aren't any plus or minus signs.
– UTF-8
Jun 4 at 12:48
You can also do this without git. Installwdiff
andcolordiff
. Then dowdiff file1 file2 | colordiff
.
– UTF-8
Jun 4 at 12:52
1
Update: My method has a flaw that I accidentally discovered in the meantime. When viewing identical files with itemized lists, I was shown lots of changes. So don't rely on this but it's a nice indication to get an overview over small changes in a long file w/o losing track of where you are cuz the entire file is printed and the colors in an otherwise monochrome text are just super easy to spot when scrolling through.
– UTF-8
Jun 6 at 0:09
|
show 1 more comment
Convert to Word the LaTeX documents, send them that. I use https://online2pdf.com which does a decent job, if there aren't too many figures or strange formatting. However, it involves sending my files to an unknown party that could be archiving them, selling the data, etc. It also often screws up formatting pretty hard, and can take up to an hour to fix that, and once or twice I've just given up. On the plus side, I've never encountered another Track Changes feature as good as Words, as it tracks character by character instead of just highlighting the whole line like diff. Plus changes in font size and whatnot mean you get hypenated words in the middle of paragraphs. Still the most ideal option a lot of the time. This is what I use with a lot of collaborators.
Edit: Moved the other suggestions to separate answers per suggestions in the comments.
Convert to Word the LaTeX documents, send them that. I use https://online2pdf.com which does a decent job, if there aren't too many figures or strange formatting. However, it involves sending my files to an unknown party that could be archiving them, selling the data, etc. It also often screws up formatting pretty hard, and can take up to an hour to fix that, and once or twice I've just given up. On the plus side, I've never encountered another Track Changes feature as good as Words, as it tracks character by character instead of just highlighting the whole line like diff. Plus changes in font size and whatnot mean you get hypenated words in the middle of paragraphs. Still the most ideal option a lot of the time. This is what I use with a lot of collaborators.
Edit: Moved the other suggestions to separate answers per suggestions in the comments.
edited Jun 4 at 17:51
community wiki
5 revs, 3 users 57%
Canageek
8
“I've never encountered another Track Changes feature as good as Word's”git diff -w --word-diff
– Henri Menke
Jun 3 at 22:04
4
@Canageek Since you intend this to be a big list, it might be better to split each of your sub-answers as a separate answers. This would give a better sense of which methods people use or like best.
– Alan Munn
Jun 3 at 22:32
1
@HenriMenke I'd opt forgit diff --word-diff=color
so there aren't any plus or minus signs.
– UTF-8
Jun 4 at 12:48
You can also do this without git. Installwdiff
andcolordiff
. Then dowdiff file1 file2 | colordiff
.
– UTF-8
Jun 4 at 12:52
1
Update: My method has a flaw that I accidentally discovered in the meantime. When viewing identical files with itemized lists, I was shown lots of changes. So don't rely on this but it's a nice indication to get an overview over small changes in a long file w/o losing track of where you are cuz the entire file is printed and the colors in an otherwise monochrome text are just super easy to spot when scrolling through.
– UTF-8
Jun 6 at 0:09
|
show 1 more comment
8
“I've never encountered another Track Changes feature as good as Word's”git diff -w --word-diff
– Henri Menke
Jun 3 at 22:04
4
@Canageek Since you intend this to be a big list, it might be better to split each of your sub-answers as a separate answers. This would give a better sense of which methods people use or like best.
– Alan Munn
Jun 3 at 22:32
1
@HenriMenke I'd opt forgit diff --word-diff=color
so there aren't any plus or minus signs.
– UTF-8
Jun 4 at 12:48
You can also do this without git. Installwdiff
andcolordiff
. Then dowdiff file1 file2 | colordiff
.
– UTF-8
Jun 4 at 12:52
1
Update: My method has a flaw that I accidentally discovered in the meantime. When viewing identical files with itemized lists, I was shown lots of changes. So don't rely on this but it's a nice indication to get an overview over small changes in a long file w/o losing track of where you are cuz the entire file is printed and the colors in an otherwise monochrome text are just super easy to spot when scrolling through.
– UTF-8
Jun 6 at 0:09
8
8
“I've never encountered another Track Changes feature as good as Word's”
git diff -w --word-diff
– Henri Menke
Jun 3 at 22:04
“I've never encountered another Track Changes feature as good as Word's”
git diff -w --word-diff
– Henri Menke
Jun 3 at 22:04
4
4
@Canageek Since you intend this to be a big list, it might be better to split each of your sub-answers as a separate answers. This would give a better sense of which methods people use or like best.
– Alan Munn
Jun 3 at 22:32
@Canageek Since you intend this to be a big list, it might be better to split each of your sub-answers as a separate answers. This would give a better sense of which methods people use or like best.
– Alan Munn
Jun 3 at 22:32
1
1
@HenriMenke I'd opt for
git diff --word-diff=color
so there aren't any plus or minus signs.– UTF-8
Jun 4 at 12:48
@HenriMenke I'd opt for
git diff --word-diff=color
so there aren't any plus or minus signs.– UTF-8
Jun 4 at 12:48
You can also do this without git. Install
wdiff
and colordiff
. Then do wdiff file1 file2 | colordiff
.– UTF-8
Jun 4 at 12:52
You can also do this without git. Install
wdiff
and colordiff
. Then do wdiff file1 file2 | colordiff
.– UTF-8
Jun 4 at 12:52
1
1
Update: My method has a flaw that I accidentally discovered in the meantime. When viewing identical files with itemized lists, I was shown lots of changes. So don't rely on this but it's a nice indication to get an overview over small changes in a long file w/o losing track of where you are cuz the entire file is printed and the colors in an otherwise monochrome text are just super easy to spot when scrolling through.
– UTF-8
Jun 6 at 0:09
Update: My method has a flaw that I accidentally discovered in the meantime. When viewing identical files with itemized lists, I was shown lots of changes. So don't rely on this but it's a nice indication to get an overview over small changes in a long file w/o losing track of where you are cuz the entire file is printed and the colors in an otherwise monochrome text are just super easy to spot when scrolling through.
– UTF-8
Jun 6 at 0:09
|
show 1 more comment
I find the best way to get edits/comments/feedback on any document is by using track changes and comments in Word.
This raises two issues:
- how to convert your Latex document into a Word document
- how to incorporate Word edits/comments into your Latex document
Here are some solutions.
1. Copy-and-paste
Just copy-and-paste your Latex document into Word and send the Word document along with the PDF. The editor can open both side-by-side and edit/comment the Word document. Copy-and-pasting back into Latex may be problematic in which case you will need to make the changes one-by-one.
2. Convert PDF to Word document using Word
Open the PDF with Word and it will automatically convert the document, however formatting will likely change significantly. The editor can edit/comment the Word document in a WYSIWYG manner. You will have to implement these edits/comments in Latex manually one-by-one.
3. Convert Latex to Word document using Pandoc
J. Alexander Branham wrote an excellent guide to this process. To briefly summarise here: you can use a program called Pandoc to convert Latex into Word. It works very well for documents with minimal use of packages. The resulting document will be much cleaner than the one produced by Word when opening a PDF, meaning edits will not cause weird formatting issues. You can also do some clever things with Git if you have the skills and interest.
Summary
The methods are listed in order of increasing complexity but also increasing functionality. 1 is very straightforward but not very WYSIWYG in terms of the final document. 2 is still quite straightforward, but the formatting could be weird and distracting. 3 will produce the best formatting of the Word document but there are several steps involved. In any case it would be best if the editor could simultaneously refer to the PDF.
add a comment |
I find the best way to get edits/comments/feedback on any document is by using track changes and comments in Word.
This raises two issues:
- how to convert your Latex document into a Word document
- how to incorporate Word edits/comments into your Latex document
Here are some solutions.
1. Copy-and-paste
Just copy-and-paste your Latex document into Word and send the Word document along with the PDF. The editor can open both side-by-side and edit/comment the Word document. Copy-and-pasting back into Latex may be problematic in which case you will need to make the changes one-by-one.
2. Convert PDF to Word document using Word
Open the PDF with Word and it will automatically convert the document, however formatting will likely change significantly. The editor can edit/comment the Word document in a WYSIWYG manner. You will have to implement these edits/comments in Latex manually one-by-one.
3. Convert Latex to Word document using Pandoc
J. Alexander Branham wrote an excellent guide to this process. To briefly summarise here: you can use a program called Pandoc to convert Latex into Word. It works very well for documents with minimal use of packages. The resulting document will be much cleaner than the one produced by Word when opening a PDF, meaning edits will not cause weird formatting issues. You can also do some clever things with Git if you have the skills and interest.
Summary
The methods are listed in order of increasing complexity but also increasing functionality. 1 is very straightforward but not very WYSIWYG in terms of the final document. 2 is still quite straightforward, but the formatting could be weird and distracting. 3 will produce the best formatting of the Word document but there are several steps involved. In any case it would be best if the editor could simultaneously refer to the PDF.
add a comment |
I find the best way to get edits/comments/feedback on any document is by using track changes and comments in Word.
This raises two issues:
- how to convert your Latex document into a Word document
- how to incorporate Word edits/comments into your Latex document
Here are some solutions.
1. Copy-and-paste
Just copy-and-paste your Latex document into Word and send the Word document along with the PDF. The editor can open both side-by-side and edit/comment the Word document. Copy-and-pasting back into Latex may be problematic in which case you will need to make the changes one-by-one.
2. Convert PDF to Word document using Word
Open the PDF with Word and it will automatically convert the document, however formatting will likely change significantly. The editor can edit/comment the Word document in a WYSIWYG manner. You will have to implement these edits/comments in Latex manually one-by-one.
3. Convert Latex to Word document using Pandoc
J. Alexander Branham wrote an excellent guide to this process. To briefly summarise here: you can use a program called Pandoc to convert Latex into Word. It works very well for documents with minimal use of packages. The resulting document will be much cleaner than the one produced by Word when opening a PDF, meaning edits will not cause weird formatting issues. You can also do some clever things with Git if you have the skills and interest.
Summary
The methods are listed in order of increasing complexity but also increasing functionality. 1 is very straightforward but not very WYSIWYG in terms of the final document. 2 is still quite straightforward, but the formatting could be weird and distracting. 3 will produce the best formatting of the Word document but there are several steps involved. In any case it would be best if the editor could simultaneously refer to the PDF.
I find the best way to get edits/comments/feedback on any document is by using track changes and comments in Word.
This raises two issues:
- how to convert your Latex document into a Word document
- how to incorporate Word edits/comments into your Latex document
Here are some solutions.
1. Copy-and-paste
Just copy-and-paste your Latex document into Word and send the Word document along with the PDF. The editor can open both side-by-side and edit/comment the Word document. Copy-and-pasting back into Latex may be problematic in which case you will need to make the changes one-by-one.
2. Convert PDF to Word document using Word
Open the PDF with Word and it will automatically convert the document, however formatting will likely change significantly. The editor can edit/comment the Word document in a WYSIWYG manner. You will have to implement these edits/comments in Latex manually one-by-one.
3. Convert Latex to Word document using Pandoc
J. Alexander Branham wrote an excellent guide to this process. To briefly summarise here: you can use a program called Pandoc to convert Latex into Word. It works very well for documents with minimal use of packages. The resulting document will be much cleaner than the one produced by Word when opening a PDF, meaning edits will not cause weird formatting issues. You can also do some clever things with Git if you have the skills and interest.
Summary
The methods are listed in order of increasing complexity but also increasing functionality. 1 is very straightforward but not very WYSIWYG in terms of the final document. 2 is still quite straightforward, but the formatting could be weird and distracting. 3 will produce the best formatting of the Word document but there are several steps involved. In any case it would be best if the editor could simultaneously refer to the PDF.
answered Jun 4 at 6:57
Robin GeorgRobin Georg
1462
1462
add a comment |
add a comment |
Frankly I do not understand the purpose of this question. If this is a collaboration on contents, one can just share the information in whatever format is convenient, e.g. emails, data files, pdf files, ascii text. Once you wrap up you need to agree on the document preparation system. From the question I infer that this will be LaTeX.
Of course, if the question is how to jointly grow a document that has cross links, references and so on, then IMHO there is no other way than recommending them to quickly look at a LaTeX intro. They will have to know how to label an equation that they want to refer to later. If you prepared the basic document well, i.e. just use some standard class, basic packages and avoid introducing too many self-written macros, they will be able to focus on the contents and add some text here and there. Just make sure that no one introduces glorious definitions as for instance defaalpha
. Also tell them that adding references by hand is not an option.
add a comment |
Frankly I do not understand the purpose of this question. If this is a collaboration on contents, one can just share the information in whatever format is convenient, e.g. emails, data files, pdf files, ascii text. Once you wrap up you need to agree on the document preparation system. From the question I infer that this will be LaTeX.
Of course, if the question is how to jointly grow a document that has cross links, references and so on, then IMHO there is no other way than recommending them to quickly look at a LaTeX intro. They will have to know how to label an equation that they want to refer to later. If you prepared the basic document well, i.e. just use some standard class, basic packages and avoid introducing too many self-written macros, they will be able to focus on the contents and add some text here and there. Just make sure that no one introduces glorious definitions as for instance defaalpha
. Also tell them that adding references by hand is not an option.
add a comment |
Frankly I do not understand the purpose of this question. If this is a collaboration on contents, one can just share the information in whatever format is convenient, e.g. emails, data files, pdf files, ascii text. Once you wrap up you need to agree on the document preparation system. From the question I infer that this will be LaTeX.
Of course, if the question is how to jointly grow a document that has cross links, references and so on, then IMHO there is no other way than recommending them to quickly look at a LaTeX intro. They will have to know how to label an equation that they want to refer to later. If you prepared the basic document well, i.e. just use some standard class, basic packages and avoid introducing too many self-written macros, they will be able to focus on the contents and add some text here and there. Just make sure that no one introduces glorious definitions as for instance defaalpha
. Also tell them that adding references by hand is not an option.
Frankly I do not understand the purpose of this question. If this is a collaboration on contents, one can just share the information in whatever format is convenient, e.g. emails, data files, pdf files, ascii text. Once you wrap up you need to agree on the document preparation system. From the question I infer that this will be LaTeX.
Of course, if the question is how to jointly grow a document that has cross links, references and so on, then IMHO there is no other way than recommending them to quickly look at a LaTeX intro. They will have to know how to label an equation that they want to refer to later. If you prepared the basic document well, i.e. just use some standard class, basic packages and avoid introducing too many self-written macros, they will be able to focus on the contents and add some text here and there. Just make sure that no one introduces glorious definitions as for instance defaalpha
. Also tell them that adding references by hand is not an option.
answered Jun 3 at 23:04
community wiki
marmot
add a comment |
add a comment |
I've found back-and-forth conversions to be hopeless, so here's an approach that worked well for me, assuming that there isn't a huge amount of markup inline.
I also assume here that there's a decent reason for the final version to use LaTeX, and that the Word-using co-author (a) is sufficiently important that you can't say "tough luck, we're doing it my way", and (b) needs to edit and not just comment on the paper.
Maintaining a Word file with LaTeX commands (ref
and cite
are probably the most important) has worked well for me in the past. Images can be imported into Word, even equations can be compiled using standalone
and pasted in from a parallel LaTeX document. The body text can be converted using something like pandoc, which can deal with ordinary text quite happily including things like font formatting - though I suggest running it over a stripped down copy of your file. Word's "track changes" feature is useful and requires only switching on, not learning.
add a comment |
I've found back-and-forth conversions to be hopeless, so here's an approach that worked well for me, assuming that there isn't a huge amount of markup inline.
I also assume here that there's a decent reason for the final version to use LaTeX, and that the Word-using co-author (a) is sufficiently important that you can't say "tough luck, we're doing it my way", and (b) needs to edit and not just comment on the paper.
Maintaining a Word file with LaTeX commands (ref
and cite
are probably the most important) has worked well for me in the past. Images can be imported into Word, even equations can be compiled using standalone
and pasted in from a parallel LaTeX document. The body text can be converted using something like pandoc, which can deal with ordinary text quite happily including things like font formatting - though I suggest running it over a stripped down copy of your file. Word's "track changes" feature is useful and requires only switching on, not learning.
add a comment |
I've found back-and-forth conversions to be hopeless, so here's an approach that worked well for me, assuming that there isn't a huge amount of markup inline.
I also assume here that there's a decent reason for the final version to use LaTeX, and that the Word-using co-author (a) is sufficiently important that you can't say "tough luck, we're doing it my way", and (b) needs to edit and not just comment on the paper.
Maintaining a Word file with LaTeX commands (ref
and cite
are probably the most important) has worked well for me in the past. Images can be imported into Word, even equations can be compiled using standalone
and pasted in from a parallel LaTeX document. The body text can be converted using something like pandoc, which can deal with ordinary text quite happily including things like font formatting - though I suggest running it over a stripped down copy of your file. Word's "track changes" feature is useful and requires only switching on, not learning.
I've found back-and-forth conversions to be hopeless, so here's an approach that worked well for me, assuming that there isn't a huge amount of markup inline.
I also assume here that there's a decent reason for the final version to use LaTeX, and that the Word-using co-author (a) is sufficiently important that you can't say "tough luck, we're doing it my way", and (b) needs to edit and not just comment on the paper.
Maintaining a Word file with LaTeX commands (ref
and cite
are probably the most important) has worked well for me in the past. Images can be imported into Word, even equations can be compiled using standalone
and pasted in from a parallel LaTeX document. The body text can be converted using something like pandoc, which can deal with ordinary text quite happily including things like font formatting - though I suggest running it over a stripped down copy of your file. Word's "track changes" feature is useful and requires only switching on, not learning.
answered Jun 4 at 10:47
Chris HChris H
6,64122259
6,64122259
add a comment |
add a comment |
With a pen. Have them printed then edit them with a pen. Not exactly environmentally friendly, but I know a lot of people who will do this anyway, even if given a word doc with track changes on. However, my girlfriend doesn't own a printer. This is what I use with my boss.
add a comment |
With a pen. Have them printed then edit them with a pen. Not exactly environmentally friendly, but I know a lot of people who will do this anyway, even if given a word doc with track changes on. However, my girlfriend doesn't own a printer. This is what I use with my boss.
add a comment |
With a pen. Have them printed then edit them with a pen. Not exactly environmentally friendly, but I know a lot of people who will do this anyway, even if given a word doc with track changes on. However, my girlfriend doesn't own a printer. This is what I use with my boss.
With a pen. Have them printed then edit them with a pen. Not exactly environmentally friendly, but I know a lot of people who will do this anyway, even if given a word doc with track changes on. However, my girlfriend doesn't own a printer. This is what I use with my boss.
answered Jun 4 at 17:46
CanageekCanageek
8,76984797
8,76984797
add a comment |
add a comment |
Ask them to use some WYSIWYG/WYSIWYM editor, or the most similar you can find, having care to set them to be fully (La)Tex compatible: Lyx, BaKoMa, Scientific word...
add a comment |
Ask them to use some WYSIWYG/WYSIWYM editor, or the most similar you can find, having care to set them to be fully (La)Tex compatible: Lyx, BaKoMa, Scientific word...
add a comment |
Ask them to use some WYSIWYG/WYSIWYM editor, or the most similar you can find, having care to set them to be fully (La)Tex compatible: Lyx, BaKoMa, Scientific word...
Ask them to use some WYSIWYG/WYSIWYM editor, or the most similar you can find, having care to set them to be fully (La)Tex compatible: Lyx, BaKoMa, Scientific word...
answered Jun 4 at 17:50
CanageekCanageek
8,76984797
8,76984797
add a comment |
add a comment |
Send the PDF output to your collaborators and have them add sticky notes using PDF annotations. Viewers supporting creation of sticky notes include Adobe Reader, Foxit Reader, and Okular. Many other viewers support showing sticky notes, like Evince.
add a comment |
Send the PDF output to your collaborators and have them add sticky notes using PDF annotations. Viewers supporting creation of sticky notes include Adobe Reader, Foxit Reader, and Okular. Many other viewers support showing sticky notes, like Evince.
add a comment |
Send the PDF output to your collaborators and have them add sticky notes using PDF annotations. Viewers supporting creation of sticky notes include Adobe Reader, Foxit Reader, and Okular. Many other viewers support showing sticky notes, like Evince.
Send the PDF output to your collaborators and have them add sticky notes using PDF annotations. Viewers supporting creation of sticky notes include Adobe Reader, Foxit Reader, and Okular. Many other viewers support showing sticky notes, like Evince.
edited Jun 4 at 21:22
Vrakfall
1032
1032
answered Jun 4 at 17:48
CanageekCanageek
8,76984797
8,76984797
add a comment |
add a comment |
Have them edit the TeX file even if they don't know LaTeX. I don't get why so many people oppose this, it isn't like the body text has much formatting in it, but they rarely will try this. Reading raw TeX is kinda a pain though, as it isn't formatted for the human eye, and I put one sentence per line, which makes it harder to read.
1
I was imagining sending a raw .tex file to my colleague, the same who has problem in reading a .zip file (on Windows)...
– CarLaTeX
Jun 5 at 5:48
add a comment |
Have them edit the TeX file even if they don't know LaTeX. I don't get why so many people oppose this, it isn't like the body text has much formatting in it, but they rarely will try this. Reading raw TeX is kinda a pain though, as it isn't formatted for the human eye, and I put one sentence per line, which makes it harder to read.
1
I was imagining sending a raw .tex file to my colleague, the same who has problem in reading a .zip file (on Windows)...
– CarLaTeX
Jun 5 at 5:48
add a comment |
Have them edit the TeX file even if they don't know LaTeX. I don't get why so many people oppose this, it isn't like the body text has much formatting in it, but they rarely will try this. Reading raw TeX is kinda a pain though, as it isn't formatted for the human eye, and I put one sentence per line, which makes it harder to read.
Have them edit the TeX file even if they don't know LaTeX. I don't get why so many people oppose this, it isn't like the body text has much formatting in it, but they rarely will try this. Reading raw TeX is kinda a pain though, as it isn't formatted for the human eye, and I put one sentence per line, which makes it harder to read.
answered Jun 4 at 17:47
CanageekCanageek
8,76984797
8,76984797
1
I was imagining sending a raw .tex file to my colleague, the same who has problem in reading a .zip file (on Windows)...
– CarLaTeX
Jun 5 at 5:48
add a comment |
1
I was imagining sending a raw .tex file to my colleague, the same who has problem in reading a .zip file (on Windows)...
– CarLaTeX
Jun 5 at 5:48
1
1
I was imagining sending a raw .tex file to my colleague, the same who has problem in reading a .zip file (on Windows)...
– CarLaTeX
Jun 5 at 5:48
I was imagining sending a raw .tex file to my colleague, the same who has problem in reading a .zip file (on Windows)...
– CarLaTeX
Jun 5 at 5:48
add a comment |
Convert your LaTeX document to Markdown (for example with pandoc
) -- or write your original directly in Markdown --- and let them edit the Markdown text file.
add a comment |
Convert your LaTeX document to Markdown (for example with pandoc
) -- or write your original directly in Markdown --- and let them edit the Markdown text file.
add a comment |
Convert your LaTeX document to Markdown (for example with pandoc
) -- or write your original directly in Markdown --- and let them edit the Markdown text file.
Convert your LaTeX document to Markdown (for example with pandoc
) -- or write your original directly in Markdown --- and let them edit the Markdown text file.
answered Jun 5 at 12:44
halloleohalloleo
406214
406214
add a comment |
add a comment |
Having been a primary latex user during my PhD with a latex and non-latex reviewers, I settled on a low-ish tech approach to begin with, which was simply to ask the reviewers to annotate rendered PDFs and send me annotated PDFs. This was a little clumsy because sometimes annotations could get lost (software problems) or the way they'd be collapsed meant it was hard to read/review particularly long comments/discussions.
Later on, seeking a way to develop a pseudo-word style review process, I found the todonotes package, and I incorporated this into my document(s) with a macro for each reviewer -- define a todobr
macro for Bob Reviewer and a todoar
for Alice Reviewer, and one for myself. Even non-latex users had no trouble being instructed to insert comments by newline todoinitialsyour comment here
and this would result in a document with minimal formatting changes (when runing with todonotes off, changes due exclusively to additional newlines in the prose which wouldn't usually be there) and conversational style todo bubbles inline when todonotes was enabled. I found this really effective for myself, a casual latex user and a complete non-latex user.
add a comment |
Having been a primary latex user during my PhD with a latex and non-latex reviewers, I settled on a low-ish tech approach to begin with, which was simply to ask the reviewers to annotate rendered PDFs and send me annotated PDFs. This was a little clumsy because sometimes annotations could get lost (software problems) or the way they'd be collapsed meant it was hard to read/review particularly long comments/discussions.
Later on, seeking a way to develop a pseudo-word style review process, I found the todonotes package, and I incorporated this into my document(s) with a macro for each reviewer -- define a todobr
macro for Bob Reviewer and a todoar
for Alice Reviewer, and one for myself. Even non-latex users had no trouble being instructed to insert comments by newline todoinitialsyour comment here
and this would result in a document with minimal formatting changes (when runing with todonotes off, changes due exclusively to additional newlines in the prose which wouldn't usually be there) and conversational style todo bubbles inline when todonotes was enabled. I found this really effective for myself, a casual latex user and a complete non-latex user.
add a comment |
Having been a primary latex user during my PhD with a latex and non-latex reviewers, I settled on a low-ish tech approach to begin with, which was simply to ask the reviewers to annotate rendered PDFs and send me annotated PDFs. This was a little clumsy because sometimes annotations could get lost (software problems) or the way they'd be collapsed meant it was hard to read/review particularly long comments/discussions.
Later on, seeking a way to develop a pseudo-word style review process, I found the todonotes package, and I incorporated this into my document(s) with a macro for each reviewer -- define a todobr
macro for Bob Reviewer and a todoar
for Alice Reviewer, and one for myself. Even non-latex users had no trouble being instructed to insert comments by newline todoinitialsyour comment here
and this would result in a document with minimal formatting changes (when runing with todonotes off, changes due exclusively to additional newlines in the prose which wouldn't usually be there) and conversational style todo bubbles inline when todonotes was enabled. I found this really effective for myself, a casual latex user and a complete non-latex user.
Having been a primary latex user during my PhD with a latex and non-latex reviewers, I settled on a low-ish tech approach to begin with, which was simply to ask the reviewers to annotate rendered PDFs and send me annotated PDFs. This was a little clumsy because sometimes annotations could get lost (software problems) or the way they'd be collapsed meant it was hard to read/review particularly long comments/discussions.
Later on, seeking a way to develop a pseudo-word style review process, I found the todonotes package, and I incorporated this into my document(s) with a macro for each reviewer -- define a todobr
macro for Bob Reviewer and a todoar
for Alice Reviewer, and one for myself. Even non-latex users had no trouble being instructed to insert comments by newline todoinitialsyour comment here
and this would result in a document with minimal formatting changes (when runing with todonotes off, changes due exclusively to additional newlines in the prose which wouldn't usually be there) and conversational style todo bubbles inline when todonotes was enabled. I found this really effective for myself, a casual latex user and a complete non-latex user.
answered Jun 6 at 10:49
user1207217user1207217
311515
311515
add a comment |
add a comment |
Thanks for contributing an answer to TeX - LaTeX Stack Exchange!
- Please be sure to answer the question. Provide details and share your research!
But avoid …
- Asking for help, clarification, or responding to other answers.
- Making statements based on opinion; back them up with references or personal experience.
To learn more, see our tips on writing great answers.
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2ftex.stackexchange.com%2fquestions%2f494059%2fwhat-ways-have-you-found-to-get-edits-from-non-latex-users%23new-answer', 'question_page');
);
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
1
Closely related: Advisor likes MS Word, I like LaTeX and How can a Word writer write a manuscript with a LaTeX writer? (duplicate). The answer I'm about to add below is a rehash of the one at that second link
– Chris H
Jun 4 at 10:45
2
use pandoc and have them edit a markdown or word file.
– mb21
Jun 4 at 12:16
10
Working with other people! What a silly idea!
– thymaro
Jun 4 at 17:20
+1, this is the only advantage Word has over LaTeX. Accepting or refusing revisions is very easy with Word, but it's a nightmare with LaTeX.
– CarLaTeX
Jun 4 at 17:35
1
Pandoc was mentioned in the answers. But if you know about such a necessity beforehand, you might start out with pandoc. You'll get your LaTeX code easily generated, but also Word and what also not for the other persons. In case of directly editing the source pandoc is also easier to digest for non-TeX users.
– Oleg Lobachev
Jun 4 at 22:28