127
edits
Changes
Jump to navigation
Jump to search
wrote page
== Introduction What is arxiv.org == http://arxiv.org is the worldwide, open-access physics preprintserver. It is the primary means of scholarly communication in manysubfields of physics, and now includes subfields of mathematics andcomputer science. It has roughly 500,000 articles. == Why should ConTeXt users care about this page? == http://arxiv.org uses plain TeX or LaTeX as the preferred source format forsubmitting documents. When you request PDF, PS, or DVI format, thesystem, which now (April 2007) runs a modified teTeX 3 distribution,generates it automatically from the source. But the system does not run ConTeXt in the same automatic way. So youhave to generate the PS format yourself and submit that. If that werethe whole story, you'd be done. However, you would like the benefitof arxiving, sorry archiving the source code that plain TeX or LaTeXusers get. So you need a way to submit the source code along withyour PS file, in a way that the arxiv.org automatic system does notreject. You can imagine that with 500,000 or so documents, with thousandsadded every month, that the submission process has to be as automaticas possible in order to keep the costs per article low. And the lowper-paper cost, one or two orders of magnitude lower than the cost oftraditional journals, allows the system to provide the articles forfree. So this page describes how to submit your ConTeXt document along withits source. == Quickstart == For the impatient, look at http://www.arxiv.org/abs/0704.1854containing a working example. It is licensed under the GNU GPLfree-software license, so you can use it as a basis for your ownsubmission. Otherwise, here are the details. == Why PostScript? == The arxiv.org system will accept a PDF file but only unaccompanied.So for now you cannot submit a PDF file along with the source. Instead, you need to submit PS. The PS-submission subsystem doesaccept other files, ideally placed in a subdirectory. The admins say that this situation is an oddity in their system, butnot one that they can fix easily or soon (except, I suppose, by makingthe PS submission be like the PDF one!). == Prepare the PostScript == Write your document! Let's say that it's called document.tex and usestwo EPS figures generated from the MetaPost file fig.mp. Generatedocument.ps using <pre> mpost fig.mp texexec --dvi --nobackend document.tex dvips -Ppdf document.dvi -o document.ps</pre> The -o is to work around stupid dvips configurations that send theoutput to lpr by default. The arxiv.org system will automatically generate PDF from the PS usingghostscript, so test that ps2pdf (a wrapper around ghostscript) ondocument.ps produces a working PDF file. View document.ps to check that any TeX-generated labels in theMetaPost figures come out in the correct font. If they look likeCourier, then the font embedding isn't right. The -Ppdf is to makesure that the correct fonts are embedded into the PS file, but if thatdidn't work, ask for help on the mailing list! == Prepare the upload file == Make a directory src/ with document.tex and fig.mp. Then make a .tgzfile for uploading. I usually call it arxiv.tgz. It is produced fromthis file structure:<pre> document.ps src/ fig.mp document.tex</pre> The command to produce the tgz file: <pre> tar -czvf arxiv.tgz document.ps src/</pre> == Upload! == If all is well, upload arxiv.tgz as your submission using the usualarxiv.org submission or replacement procedure. Ideally you'll do step4 an hour before the 4pm (US Eastern) weekday deadline, so that youget back in time the submission date and preprint number fromarxiv.org for step 5. Then you have time for the next steps. == Incorporate the date and preprint number == Incorporate the preprint number (or URL) and submission date into yourdocument and produce an arxiv stampline along the left margin on the first page. Then remakedocument.ps and arxiv.tgz, and '''replace''' the previous submissionwith the new arxiv.tgz. This stampline is most easily placed using [[layers]], andthe http://www.arxiv.org/abs/0704.1854 document is an example. For automatically processed source formats (plain TeX and LaTeX), youcan avoid this incorporation step by using magic strings in the sourcefile, and the automatic system will translate those into the preprintnumber and date. However, we as ConTeXt users are (with thesedirections) faking the behavior of that system, so we get the infoourselves and incorporate it. == Check that all is well == Check that the PS and PDF look fine. For example, check that thefonts in the MetaPost figures look right. Then sit back and relax, knowing that you've contributed to theopen-access commons. == Makefile == Generating document.ps and arxiv.tgz from the source files is aprocess best done by a computer. And that is best done by a Makefile.See http://www.inference.phy.cam.ac.uk/sanjoy/teaching/tex/ for how touse the make program for documents. And seehttp://www.arxiv.org/abs/0704.1854 for a ConText document that uses aMakefile. Good luck!
== First section ==
