Skip to content

danieleavitabile/arxiv-submission-walkthrough

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 

Repository files navigation

A walk-through to submit papers on arXiv

This is a quick guide to submit papers on arXiv.

Prerequisites and preliminary information

  • The walk-through is meant to help you prepare a paper for submission on arXiv. Starting from a template manuscript, it walks you through several steps on the arXiv website. IMPORTANT: please do not not finalise the submission of this template, as this action is irreversible. As you will see, a submission can not be triggered accidentally, so you are safe to experiment with the steps below. You should just avoid completing the submission, after the last step of the walk-through.

  • The walk-through assumes you have prior basic knowledge of how LaTeX works. It is also assumed you have created an account on arXiv.

Preparing a folder for submission

  1. From the right-hand side panel of our GitHub webpage, download the latest release of this repository, v1.0.1 at the time of writing. The Manuscript folder contains an example of LaTeX manuscript, including all the compilation files.

  2. Create an empty arxiv/ folder, at the same level as Manuscript. You will now start transferring files to this new folder: the main idea is to prepare a standalone folder that arXiv will compile, and recreate a pdf of your manuscript. There are some specific steps for arXiv submissions, though.

  3. Copy the manuscript source file (.tex) to the arxiv/ folder. The main file must be at the top level of this folder (you can not put it in a subfolder).

  4. Copy your figures. In our example, this means copying Manuscript/Figures into arxiv/Figures, because our manuscript searches for figure files in this folder. ArXiv uses pdflatex for compilation, so we recommend using use a format compatbile with this compiler (.pdf/.png/.jpg/).

  5. Copy style and macro files to arxiv/. In the example, we are using the SIAM class and style files (.cls and .bst files), as well a file with personal macros (.sty file).

  6. Copy your bibliographic data. If you use bibtex, as in this example, this step is a bit more delicate. On our computer, we would compile a .bib file, and use bibtex in between several pdflatex compilations, to generate the bibliography. On our computer, the bibliographic data after compilation is stored in a .bbl file. ArXiv, does not run bibtex for the compilation. Rather, arXiv expects to find a fully compiled .bbl file in the main directory. Hence, you must copy the .bbl file resulting from your compilation to the arxiv/ folder.

  7. Optionally, create and write a new arxiv/00README.XXX file. In this file, you can specify options to be passed to arXiv. In most of my submissions, this file contains just one word, namely nostamp. I use this to avoid that arXiv stamps the left-edge of the manuscript. More infos about the 00README.XXX file can be found here

  8. It is possible that your manuscript has a more complex structure than the one outlined above, and you may have to include additional files for your compilation. This page may be useful. If you use Overleaf, refer to their help documentation regarding how to prepare your document for submission to arXiv.

  9. When you are done, compress the arxiv/ folder, for instance by creating the file arxiv.zip

Upload your manuscript on arXiv

  1. Log in to Arxiv and click START NEW SUBMISSION

  2. Tick the appropriate boxes in the sections Verify your Contact information, Submission Agreement, and Authorship.

  3. Select a License for your document. As of the time of writing NWO recommends (but does not strictly require) to use any Creative Commons (CC) licence for your publication. As a simple rule of thumb, uploading the accepted version of your manuscript on arXiv under the CC BY: Creative Commons Attibution license makes it fuly compliant with NWO Open Science policy. Any variant of the CC BY licence is also compliant with the NWO Open Science policy. Clicking on the info i button on the Arxiv website will give a quick description of the license variant.

  4. Specify a Subject class for the manuscript, and click continue.

  5. Upload the arxiv.zip file prepared in the last section. ArXiv will unpack the file, and provide you with a list of files. Click Continue: Process Files

  6. If the compilation has been successful, you can now preview your manuscript and click Continue. There is also a logfile that can help if something goes wrong in the compilation. Here are common mistakes that cause the compilation to fail.

  7. Write Title, Author, and Abstract of the paper. The journal reference of your article, as well as its DOI, can be added at a later stage, if you don't have them yet. Press Save and Continue

  8. You are now at the final page of your submission. This is where this tutorial ends. In an ordinary publication, you can now preview the article and then submit, following the instruction under View PDF. Please do not submit this template as this action is not reversible.

TODO address the following comments:

  • What happens if I have a paper with one main.tex file, and several included dependencies in .tex files?
  • Are comments in the LaTeX file visible to the outside world?
  • Can I change files one at a time?
  • What happens to the file after submission?

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages