-
Notifications
You must be signed in to change notification settings - Fork 61
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Moving initial batch of files to help folder
- Loading branch information
1 parent
b54afd5
commit 3ed365c
Showing
512 changed files
with
38,210 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,120 @@ | ||
# The 00README.XXX file | ||
|
||
A file of this name can used to specify special handling for the submission and/or for individual files. The name of the file is spelled "zero-zero-README-dot-X-X-X". | ||
|
||
The `00README.XXX` file is read line-by-line before files are processed by AutoTeX. The order of lines is unimportant. | ||
|
||
* [Ignoring files within the submission package](#ignoring) | ||
* [Including files normally ignored](#including) | ||
* [Declaring your top-level LaTeX file](#toplevel) | ||
* [Enabling Landscape mode in `dvips` submissions only](#landscape) | ||
* [Disabling HyperTeX for your submission](#nohypertex) | ||
* [Keep comments within figures during `dvips`](#keepcomments) | ||
* [Turn off the arXiv stamp on the generated PostScript and PDF files](#nostamp) | ||
* [Defining a custom fontmap file](#fontmap) | ||
|
||
<a name="ignoring" id="ignoring"></a> | ||
|
||
## Ignoring files | ||
|
||
Include lines such as: | ||
|
||
``` | ||
filename1.ext1 ignore | ||
filename2.ext2 ignore | ||
``` | ||
|
||
This is useful if you have included other files which are not necessary for processing and don't belong into a subdirectory for ancillary material either. | ||
|
||
<a name="including" id="including"></a> | ||
|
||
## Including files -- not ignoring and not reporting junk | ||
|
||
Include lines such as: | ||
|
||
``` | ||
filename1.whatever include | ||
filename2.whatever include | ||
``` | ||
|
||
This will stop detection of unknown file type and will thus stop the file being given to AutoTeX. This can be used to include extra files linked from an HTML submission. | ||
|
||
<a name="toplevel" id="toplevel"></a> | ||
|
||
## Declaring the top-level (parent) TeX file | ||
|
||
It is very rarely necessary to do this explicitly because arXiv employs a series of heuristics which can usually determine the top-level file. For example, if only one of a set of LaTeX files contains a `\documentclass` command, that file is very likely the top-level file. | ||
|
||
If it is necessary, however, include a line that says: | ||
|
||
``` | ||
myMainTexFile.tex toplevelfile | ||
``` | ||
|
||
where `myMainTexFile.tex` is the name of the parent TeX file. | ||
|
||
<a name="landscape" id="landscape"></a> | ||
|
||
## Landscape mode | ||
|
||
It is possible to tell AutoTeX to send a flag to `dvips` requesting landscape mode. This sometimes results in upside-down output, but there is currently no facility to fix this. The command is: | ||
|
||
``` | ||
filename.dvi landscape | ||
``` | ||
|
||
where `filename.dvi` is the name of the DVI file that TeX will produce when processing the submission, and `filename` is the main TeX file without the `.tex` extension. Also, we have an extensive help library on setting the [landscape environment](faq/landscape "arXiv landscape help page"). | ||
|
||
<a name="nohypertex" id="nohypertex"></a> | ||
|
||
## Disable attempt to use HyperTeX | ||
|
||
See also: [Disabling hypertex](faq/mistakes#nohypertex). | ||
|
||
``` | ||
nohypertex | ||
``` | ||
|
||
This stops any attempt by arXiv to automatically augment a paper with hyperlinks. However, it does not affect any facilities explicitly used within the paper's source. There is no filename associated with this switch. | ||
|
||
<a name="keepcomments" id="keepcomments"></a> | ||
|
||
## Keep comments when doing `dvips` | ||
|
||
This is mostly needed when receiving a [`PS BAD` warning](faq/mistakes#psbad) | ||
|
||
``` | ||
filename.dvi keepcomments | ||
``` | ||
|
||
Sends the `-K0` flag to `dvips`, telling it not to strip comments. This is needed when PS/EPS figures (included in the DVI) contain binary data having '`%`' characters at the beginning of lines (by default, our `dvips` processor interprets these lines as comments), or if the comments are required for some other reason (e.g., Adobe Illustrator output). | ||
|
||
Note that `filename.dvi` is the name of the DVI file that TeX will produce when processing the submission, and `filename` is the main TeX file without the `.tex` extension. | ||
|
||
Also note that it may be necessary to rename your `.TEX` files to `.tex` for this function to work properly. | ||
|
||
<a name="nostamp" id="nostamp"></a> | ||
|
||
## Stopping the addition of the arXiv stamp | ||
|
||
``` | ||
nostamp | ||
``` | ||
|
||
This tells AutoTeX not to add the arXiv stamp to the left-hand edge of the page. No filename is specified. | ||
|
||
<a name="fontmap" id="fontmap"></a> | ||
|
||
## Defining a custom font mapping | ||
|
||
You can bundle non-standard or custom fonts with your submission and instruct `dvips` to use an additional font map file, e.g. `myfonts.map`, so that `dvips` is executed with the fontmap option: | ||
|
||
`dvips -u+./myfonts.map` | ||
|
||
by adding a file called 00README.XXX to your submission with the directive: | ||
|
||
``` | ||
myfonts.map fontmap | ||
``` | ||
|
||
which identifies your private font map file as a `dvips` fontmap. For map file syntax consult the dvips info pages. Many font bundles from [CTAN](http://www.ctan.org/) come with their custom font map files, and you can use these as is with this directive. The file name of the font map file must have extension "`.map`" and it must consist of letters `A-Z, a-z` only. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,29 @@ | ||
# Web Accessibility | ||
|
||
**The arXiv.org web site is designed to work on the largest possible set of browsers and platforms, and to be accessible to users with disabilities.** | ||
|
||
Our web pages are valid [XHTML 1.0 Transitional](http://validator.w3.org/check?uri=http%3A%2F%2Farxiv.org%2F) and valid [CSS 2.0](http://jigsaw.w3.org/css-validator/validator?uri=http%3A%2F%2Farxiv.org%2F&usermedium=all). We are working to generate XHTML _Strict_, which will provide some usability improvements over XTHML Transitional. Note that we do not correct or validate HTML submissions, so they may contain malformed HTML expressions. | ||
|
||
[![Valid XHTML 1.0!](https://arxiv.org/icons/valid-xhtml10.png)](http://validator.w3.org/check?uri=http%3A%2F%2Farxiv.org%2F) [![Valid CSS!](https://arxiv.org/icons/valid-css.png)](http://jigsaw.w3.org/css-validator/validator?uri=http%3A%2F%2Farxiv.org%2F&usermedium=all) | ||
|
||
Valid XHTML and CSS allow arXiv.org web pages to render well on modern browsers and degrade gracefully in older and less robust browsers. Furthermore, we follow the W3C's [Web Content Accessibility Guidelines](http://www.w3.org/TR/1999/WAI-WEBCONTENT-19990505/) and comply with [Section 508](http://www.section508.gov) of the US Rehabilitation Act of 1973 to be accessible to user with disabilities. | ||
|
||
## The December 2005 Redesign | ||
|
||
As of December, 2005, almost all arXiv.org readers used browsers that support XHTML and CSS. Browser usage was as follows: | ||
|
||
|
||
|Browser |Percentage of users| | ||
|----------|-------------------| | ||
|Internet Explorer 5.0 and later|40%| | ||
|Firefox 1.0 and later|22%| | ||
|Mozilla and Netscape 5.0 and later|14%| | ||
|Safari|10%| | ||
|Other browsers and RSS readers|14%| | ||
|
||
|
||
Our goals in the redesign were to increase the usability and aesthetics of arXiv.org, and for the main site to comply with [Cornell Visual Identity guidelines](https://brand.cornell.edu/). | ||
|
||
By using XHTML and CSS, we aim for arXiv.org pages to render identically on modern, standards-compliant browsers (namely Internet Explorer, Firefox, Mozilla, and Safari). Furthermore, pages should degrade gracefully in older and non-standard browsers, so that page elements are visible and legible in all browsers. | ||
|
||
If you have trouble accessing arXiv.org, please [contact our administrators](/help/contact). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,41 @@ | ||
Access keys | ||
=========== | ||
|
||
Abstract and listings pages use [access | ||
keys](http://www.w3.org/TR/html4/interact/forms.html#h-17.11.2) for | ||
keyboard navigation. | ||
|
||
Most modern browsers support access keys, though with different modifier | ||
keys. The table below shows modifier keys for popular browsers. | ||
|
||
| Browser | Access key modifier | | ||
|-------------------------------|----------------------------| | ||
| Internet Explorer 5 or later | Alt+*key* then press ENTER | | ||
| Mozilla or Firefox on Windows | Alt+*key* | | ||
| Mozilla or Firefox on Linux | Alt+Shift+*key* | | ||
| Firefox on Mac | Ctrl+*key* | | ||
| Safari | Ctrl+*key* | | ||
|
||
Abstract (abs) and Listing pages | ||
-------------------------------- | ||
|
||
The following access keys work on both abs and listings pages: | ||
|
||
| Key | Destination | | ||
|-----|----------------------------------| | ||
| *a* | arXiv.org (or mirror) index page | | ||
| *h* | help page | | ||
|
||
Abs pages only | ||
-------------- | ||
|
||
The following access keys work on abs pages: | ||
|
||
| Key | Destination | | ||
|-----|---------------------------------------| | ||
| *f* | full-text PDF (or HTML in some cases) | | ||
| *n* | next abstract | | ||
| *p* | previous abstract | | ||
|
||
For example, when viewing an abstract page in Firefox on Windows, | ||
pressing *alt+f* will download the full text of the paper. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,46 @@ | ||
Ancillary files | ||
=============== | ||
|
||
arXiv is primarily an [archive and distribution service for research | ||
articles](primer.md). There are limited facilities for including ancillary | ||
files of modest size (up to a few MB) with articles. Such ancillary | ||
files might include: | ||
|
||
- Raw data for tables and plots in the article | ||
- Program code | ||
- Additional images or movies | ||
- Workbooks and spreadsheets | ||
|
||
arXiv accepts ancillary material only in support of research articles | ||
submitted. | ||
|
||
Submission of ancillary files | ||
----------------------------- | ||
|
||
Ancillary files are included with an arXiv submission by placing them in | ||
a directory `anc` at the root of the submission package. For example, if | ||
the submission has one TeX file, one image, and C++ program the | ||
submission package might be: | ||
``` | ||
/article.tex | ||
/figure1.pdf | ||
/anc/my_program.cpp | ||
``` | ||
Ancillary files are stored with a particular version of an article and | ||
thus cannot be changed independently from the article. Different | ||
ancillary files may appear with each version. Please note that ancillary | ||
files are not supported with [PDF submissions](submit_pdf.md) at this | ||
time. | ||
|
||
Display and download | ||
-------------------- | ||
|
||
The abstract pages for articles that include ancillary files will | ||
include additional links below the usual article download links. See, | ||
for example, [arXiv:0811.2625v2](/abs/0811.2625v2). There is also a | ||
separate page that lists all ancillary files with greater detail than | ||
there is room for on the abstract page. See, for example, [ancillary | ||
files for arXiv:0905.2326v1](/src/0905.2326v1/anc). In both cases there | ||
are links to each file for individual download. Ancillary files are also | ||
included in the complete article source that may be downloaded from the | ||
[other formats](/format/0905.2326v1) page. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.