The first submission of a research paper for peer review can be in a generic format as a PDF. It is silly to submit the manuscript as if it were a galley proof at this stage. The advantage of a plain generic template is that it can be submitted to many different journals.
This is an org-mode variant of the main.tex file in the MooersLab/manuscriptInLaTeX repo. This template is for people who prefer to write research papers in org. The support for writing in LaTeX in Emacs is also excellent.
You can edit LaTeX documents stored on Overleaf inside Emacs or a half dozen other text editors via GhostText. See slides here here and video here. Note that I configured the Emacs Atomic package to open files from Overleaf in the LaTeX mode. This brings the full power of Emacs to Overleaf. Compiling tex files in Overleaf is faster.
An alternative approach to collaborative editing is to do the editing on a private Github repo. GhostText enables text editing in the text area when in the edit mode on Github. Configure Atomic to cause Emacs to open org files from Github in org mode. This approach assumes that all of the collaborators are using Emacs to do their editing. Non-Emacs users could just use the editing tools in GitHub to edit the file directly, or you might be able to configure their editors to open org files via GhostText.
- Git clone the repo
git clone https://github.com/MooersLab/manuscriptInOrg.git. - Copy main.org to a your project folder.
- Load main.org file in Emacs via the File pulldown menu or
C-x C-f. - Edit the file to customize to your manuscript.
- Edit the paths to your global.bib file and your image files.
- Enter
C-c C-e l oto compile and open the resulting PDF in your default PDF viewer.
Compiling takes several seconds on a 2018 MacBook Pro with 32 GB of RAM. There is a better way. The corresponding LaTeX compiles faster in Overleaf, providing superior support for collaborative editing by non-LaTeX using colleagues. The latter is a deficiency in Emacs that some of working hard to address. Sadly, Overleaf does not read org files.
- LaTeX is installed with all of the required style files. However, my installation was missing the break cities.sty file. I installed this with the
sudo port install texlive-bibtex-extracommand. - Emacs is using used to edit the org file.
My approach was developed independently of another solution found here.
I had upgraded my operating system to Ventura, but I had not properly migrated my MacPorts. I found that I was missing the breakcities.sty file.
- Writing log template in Org-mode
- Writing log template in LaTeX
- LaTeX manuscript template
- Org-mode manuscript template
- Workbook for 2022 for tracking time spent and words written by project
- Slideshow template in LaTeX
- Annotated bibliography Template in LaTeX
- Diary for 2022 in LaTeX
- Diary for 2023 in LaTeX
- latex-emacs profile
- default Emacs profile
- snippets for latex-mode in Emacs
- Quizzes about Emacs to improve recall of keybindings
- Slides from talk about GhostText, Data Science Workshop, July 2022
- Video link to talk about GhostText, Data Science Workshop, July 2022
- The writer's law
Note that latex-emacs profile has functions for converting LaTex lists into org-markdown lists.
| Version | Changes | Date |
|---|---|---|
| Version 0.2 | Added badges, funding, and update table. | 2024 May 21 |
- NIH: R01 CA242845
- NIH: R01 AI088011
- NIH: P30 CA225520 (PI: R. Mannel)
- NIH: P20 GM103640 and P30 GM145423 (PI: A. West)