Skip to content

Commit

Permalink
Moving initial batch of files to help folder
Browse files Browse the repository at this point in the history
  • Loading branch information
jimentwood committed Sep 19, 2018
1 parent b54afd5 commit 3ed365c
Show file tree
Hide file tree
Showing 512 changed files with 38,210 additions and 0 deletions.
120 changes: 120 additions & 0 deletions site/pages/help/00README.md
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.
29 changes: 29 additions & 0 deletions site/pages/help/accessibility.md
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).
41 changes: 41 additions & 0 deletions site/pages/help/accesskeys.md
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.
46 changes: 46 additions & 0 deletions site/pages/help/ancillary_files.md
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.
Binary file added site/pages/help/api/arXiv_api_xml.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added site/pages/help/api/arXiv_smiley.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 3ed365c

Please sign in to comment.