Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: arXiv/arxiv-docs
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: 2.0
Choose a base ref
...
head repository: arXiv/arxiv-docs
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: master
Choose a head ref
Loading
Showing with 3,701 additions and 2,996 deletions.
  1. +9 −0 .vscode/settings.json
  2. +205 −0 AUTHORING.md
  3. +146 −177 README.md
  4. +12 −0 deploy/cloudbuild-develop.yaml
  5. +0 −2 deploy/setup_arxiv_docs_buckets.sh
  6. +1 −1 make_arxiv_theme/prep_for_mkdocs.sh
  7. +2 −1 mkdocs.yml
  8. BIN non-info/01-help-info-page.png
  9. BIN non-info/02-help-github-edit-page.png
  10. BIN non-info/03-help-preview-github.png
  11. BIN non-info/04-help-commit-github.png
  12. BIN non-info/05-help-newBranch.png
  13. BIN non-info/06-help-comparePR.png
  14. BIN non-info/07-help-openPR.png
  15. BIN non-info/08-help-createPR.png
  16. BIN non-info/09-help-mergePR.png
  17. BIN non-info/10-help-confirmMerge.png
  18. BIN non-info/11-help-newPR-compare.png
  19. BIN non-info/12-help-compare-master.png
  20. BIN non-info/12-help-newPR-compare.png
  21. BIN non-info/12-help-preview-page.png
  22. BIN non-info/13-help-compare-changes-createPR.png
  23. BIN non-info/14-help-PR-master-deploy.png
  24. BIN non-info/compareFiles.png
  25. BIN non-info/compareToMaster.png
  26. BIN non-info/filesChanged-createPR.png
  27. BIN non-info/help-github1.png
  28. BIN non-info/help-github2.png
  29. BIN non-info/help-info-page.png
  30. BIN non-info/help-pr1.png
  31. +10 −1 overrides/main.html
  32. +9 −9 requirements.txt
  33. +13 −8 source/SUMMARY.md
  34. +24 −0 source/about/OSTP-04-11-2023.md
  35. +20 −33 source/about/accessibility.md
  36. +4 −0 source/about/accessibility_forum.md
  37. +53 −0 source/about/accessibility_html_error_messages.md
  38. +3 −0 source/about/accessibility_research_report.md
  39. +44 −0 source/about/accessibility_terms.md
  40. +51 −0 source/about/accessible_HTML.md
  41. BIN source/about/arXiv-payment-info-2022.pdf
  42. +218 −0 source/about/arXiv_bylaws.md
  43. +8 −0 source/about/brand.html
  44. +4 −3 source/about/donate.md
  45. +4 −4 source/about/governance.md
  46. BIN source/about/images/arxiv-logo-for-support-header.png
  47. BIN source/about/images/arxiv-org-chart.png
  48. BIN source/about/images/author_submssn_error.png
  49. BIN source/about/images/html_error_submssn.png
  50. BIN source/about/images/ligatureExampleResized.png
  51. BIN source/about/images/portrait-Charles-Frankston-warmtone.jpg
  52. BIN source/about/images/portrait-Charles-Frankston.jpg
  53. BIN source/about/images/portrait-Ramin-Zabih-warmtone.jpg
  54. BIN source/about/images/portrait-Ramin-Zabih.jpg
  55. BIN source/about/images/portrait-Steinn-Sigurdsson-warmtone.jpg
  56. BIN source/about/images/portrait-Steinn-Sigurdsson.jpg
  57. BIN source/about/images/portrait-Stephanie-Orphan-warmtone.jpg
  58. BIN source/about/images/portrait-Stephanie-Orphan.jpg
  59. BIN source/about/images/portrait-Yoav-Artzi-warmtone.jpg
  60. BIN source/about/images/portrait-Yoav-Artzi.jpg
  61. BIN source/about/images/reader-error-01.png
  62. BIN source/about/images/reader-error-02.png
  63. BIN source/about/images/reader-error-03.png
  64. BIN source/about/images/yoav.jpg
  65. +16 −17 source/about/index.md
  66. +8 −0 source/about/mab_bylaws.html
  67. +0 −156 source/about/mab_bylaws.md
  68. +3 −3 source/about/membership.md
  69. +28 −14 source/about/ourmembers.md
  70. +27 −0 source/about/people/arxiv_advisory_board.md
  71. +1 −7 source/about/people/developers.md
  72. +44 −0 source/about/people/editorial_advisory_council.md
  73. +23 −15 source/about/people/index.md
  74. +61 −0 source/about/people/institutions_advisory_council.md
  75. +43 −49 source/about/people/leadership_team.md
  76. +8 −0 source/about/people/member_ad_board.html
  77. +0 −64 source/about/people/member_ad_board.md
  78. +41 −0 source/about/people/science_advisory_council.md
  79. +8 −0 source/about/people/scientific_ad_board.html
  80. +0 −117 source/about/people/scientific_ad_board.md
  81. +13 −5 source/about/people/staff.md
  82. +0 −32 source/about/people/technical_ad_group.md
  83. +30 −0 source/about/people/volunteer_moderators.md
  84. +4 −2 source/about/principles.md
  85. +0 −40 source/about/reports-financials.md
  86. BIN source/about/reports/2015_roadmap.pdf
  87. +1 −1 source/about/reports/2019_roadmap.md
  88. +2 −2 source/about/reports/2019_update.md
  89. +4 −2 source/about/reports/2020_update.md
  90. +1 −1 source/about/reports/2021_institution_submissions.md
  91. +28 −0 source/about/reports/2022_institution_submissions.md
  92. +18 −0 source/about/reports/2022_usage.md
  93. BIN source/about/reports/2023_arXiv_annual_report.pdf
  94. +125 −0 source/about/reports/2023_institution_submissions.md
  95. +15 −0 source/about/reports/2023_usage.md
  96. BIN source/about/reports/FY24_Budget_External.pdf
  97. BIN source/about/reports/FY25_Budget_Public.pdf
  98. +2 −2 source/about/reports/arxiv_busplan_Oct2011.md
  99. +22 −12 source/about/reports/index.md
  100. +8 −0 source/about/sab_bylaws.html
  101. +0 −142 source/about/sab_bylaws.md
  102. +64 −0 source/about/submission_data_faq.md
  103. +1 −2 source/about/supporters.md
  104. BIN source/assets/arxiv-lockup-forum-bgcolor.png
  105. BIN source/assets/arxiv-lockup-forum.png
  106. +14 −12 source/brand/brand-guidelines.md
  107. +2 −2 source/brand/brand-pillars.md
  108. +1 −1 source/brand/colors.md
  109. +2 −2 source/brand/logos.md
  110. +1 −1 source/brand/typography.md
  111. +12 −3 source/help/00README.md
  112. BIN source/help/Withdraw-sample-v1-2023-05-15.png
  113. BIN source/help/Withdraw-sample-v2-2023-05-15.png
  114. +9 −1 source/help/ancillary_files.md
  115. +7 −7 source/help/api/basics.md
  116. +0 −184 source/help/api/classify.md
  117. +8 −0 source/help/api/faq.html
  118. +0 −22 source/help/api/faq.md
  119. +1 −2 source/help/api/index.md
  120. +6 −12 source/help/api/tou.md
  121. +9 −5 source/help/api/user-manual.md
  122. +10 −10 source/help/arxiv_identifier_for_services.md
  123. +114 −0 source/help/atom_specifications.md
  124. +1 −1 source/help/author_identifiers.md
  125. +17 −18 source/help/authority.md
  126. +10 −10 source/help/availability.md
  127. +17 −33 source/help/bib_feed.md
  128. +17 −8 source/help/bulk_data_s3.md
  129. +8 −0 source/help/cloud.md
  130. +2 −2 source/help/contact.md
  131. +21 −21 source/help/cs/index.md
  132. +1 −1 source/help/datasets.md
  133. +27 −0 source/help/doi.md
  134. +11 −11 source/help/econ/index.md
  135. +8 −8 source/help/eess/index.md
  136. +1 −1 source/help/endorsement.md
  137. +0 −105 source/help/faq/cache.md
  138. +0 −1 source/help/faq/dvips.md
  139. +2 −4 source/help/faq/index.md
  140. +377 −373 source/help/faq/mistakes.md
  141. +2 −0 source/help/faq/references.md
  142. +2 −2 source/help/faq/revtex.md
  143. +1 −1 source/help/faq/statfaq.md
  144. +0 −63 source/help/faq/tetex3.md
  145. +0 −29 source/help/faq/texhyphenation.md
  146. +187 −34 source/help/faq/texlive.md
  147. +53 −133 source/help/faq/texprobs.md
  148. +9 −15 source/help/faq/whytex.md
  149. +1 −1 source/help/find.md
  150. +17 −0 source/help/find/index.md
  151. +1 −1 source/help/gzip.md
  152. +3 −5 source/help/index.md
  153. +1 −1 source/help/ir.md
  154. +8 −8 source/help/license/index.md
  155. +9 −10 source/help/math/index.md
  156. +6 −5 source/help/mathjax.md
  157. +3 −9 source/help/mirrors.md
  158. +7 −12 source/help/moderation/appeals.md
  159. +49 −39 source/help/moderation/index.md
  160. +2 −2 source/help/not-registered.md
  161. +0 −5 source/help/otherformats.md
  162. +19 −19 source/help/passwords.md
  163. +0 −11 source/help/pdf.md
  164. +14 −16 source/help/physics/index.md
  165. +5 −4 source/help/policies/code_of_conduct.md
  166. +2 −1 source/help/policies/code_of_conduct_enforcement.md
  167. +97 −0 source/help/policies/content-types.md
  168. +39 −0 source/help/policies/format_requirements.md
  169. +38 −0 source/help/policies/identity_and_affiliation.md
  170. +3 −4 source/help/policies/index.md
  171. +0 −35 source/help/policies/instructions_for_submission.md
  172. +125 −81 source/help/policies/privacy_policy.md
  173. +60 −32 source/help/policies/submission_agreement.md
  174. +15 −6 source/help/prep.md
  175. +4 −5 source/help/q-bio/index.md
  176. +8 −32 source/help/q-fin/index.md
  177. +28 −25 source/help/registerhelp.md
  178. +3 −2 source/help/replace.md
  179. +31 −35 source/help/rss.md
  180. +144 −0 source/help/rss_specifications.md
  181. +0 −19 source/help/sciencewise.md
  182. +5 −0 source/help/stat/index.md
  183. +7 −9 source/help/statistics/index.md
  184. +2 −3 source/help/stats/index.md
  185. +0 −142 source/help/submit.md
  186. +4 −2 source/help/submit/index.md
  187. +2 −0 source/help/submit_index.md
  188. +74 −0 source/help/submit_latex_best_practices.md
  189. 0 source/help/submit_pdf.html
  190. +21 −1 source/help/submit_pdf.md
  191. +12 −20 source/help/submit_status.md
  192. +96 −105 source/help/submit_sword.md
  193. +56 −7 source/help/submit_tex.md
  194. +3 −3 source/help/third_party_submission.md
  195. +1 −1 source/help/versions.md
  196. +12 −10 source/help/withdraw.md
  197. BIN source/help/withdrawal-examplev1.png
  198. BIN source/help/withdrawal-examplev2.png
  199. +13 −0 source/hiring/index.md
  200. +0 −129 source/labs/criteria.md
  201. BIN source/labs/images/arXivLabs-tabs.png
  202. BIN source/labs/images/arXivLabsFeatures-01.png
  203. BIN source/labs/images/dagshub-logo.png
  204. BIN source/labs/images/inffluence-flower.png
  205. +63 −13 source/labs/index.md
  206. +0 −11 source/labs/project-proposal.md
  207. +25 −4 source/labs/showcase.md
  208. +1 −1 source/new/condreorg.md
  209. +1 −1 source/new/eess_announce.md
  210. +12 −13 source/new/index.md
  211. +1 −1 source/new/math.md
  212. +1 −1 source/new/nlin.md
  213. +3 −3 source/new/q-bio_announce.md
  214. +3 −9 source/new/q-fin_announce.md
  215. +2 −2 source/new/stat_announce.md
  216. +80 −18 source/stylesheets/extra.css
9 changes: 9 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"cSpell.words": [
"funder"
],
"githubPullRequests.ignoredPullRequestBranches": [
"develop"
],
"search.useIgnoreFiles": false
}
205 changes: 205 additions & 0 deletions AUTHORING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,205 @@
# Authoring Markdown
Markdown is a document syntax that allows writing documents in plain text that
can be converted to HTML or other format. The following section contains some
help about authoring the markdown format.

Basics about markdown [markdown basics](https://daringfireball.net/projects/markdown/basics)

Sometimes you might find a guide to markdown and some formating in it won't work
with info.arxiv.org. That is becasue the tool used for info.arixv.org supports
[Gruber's markdown syntax](https://daringfireball.net/projects/markdown/syntax)
and not all the extensions that exist.

## Links
Both absolute and relative links work. You can add a link in
``foo/index.md`` to ``foo/baz.md`` with either ``[click this absolute
link](/foo/baz.md)`` or ``[click this relative
link](baz.md)``. Relative links assist in movig directories of pages
around since a whole subdirectory can be moved and if all the pages in
it have relative links then those will not break. Absolute links
assist in moving pages around since the links on a single page do not
break if a single page is moved.

You can put static files in the same directory structure. If the page
``specifics/coolstory.md`` has an image tag like
``![my alt text](impressive.png)``, this will get rendered as
``https://some.site/specifics/impressive.png``.

Only ``.md`` (markdown) files will be treated like pages. Everything
else is won't get rendered like a page (fancy headers, etc).

Inside of your ``.md`` files, you can add some front-matter. For example,
if you want the title in the browser tab and breadcrumbs to be different from
whatever is in the content of the page, you could do:

```markdown
---
title: This is the title that I like in the browser tab
---
# This is the title that gets displayed as an H1 on the page.

Bacon ipsum dolor sit amet...
```

The first H1 tag will be used as the name of the page in navigtion.


## Templates, CSS, JS

# Style options for markdown pages

Use the following css are already in the CSS used by the arxiv-docs pages.

To clear a float use a single ``#`` (an empty header) on its own line.


## Images

Note that more than one class can be applied to an image.

- make an image 100% width of content area :
```
![Alt tag here](images/image_name.jpg){.mkd-img-full}
```
- make an image 60% width of content area (100% on mobile) and center it:
```
![Alt tag here](images/image_name.jpg){.mkd-img-60}
```
- make a small thumbnail image:
```
![Alt tag here](images/image_name.jpg){.mkd-img-thumb}
```
- add a grey border:
```
![Alt tag here](images/image_name.jpg){.mkd-img-border}
```
- float an image left and make it 50% width:
```
![Alt tag here](images/image_name.jpg){.mkd-img-left}
```
- float an image right and make it 50% width:
```
![Alt tag here](images/image_name.jpg){.mkd-img-right}
```
- place two images side by side, each 50% width of content area (will stack at 100% width on mobile), with borders:
```
![Alt tag here](images/image_name.jpg){.mkd-img-left .mkd-img-border}
![Alt tag here](images/image_name.jpg){.mkd-img-left .mkd-img-border}
```

## Ordered Lists
The following styles will be automatically applied to any ordered lists, or
ordered lists within a blockquote, on your page. A normal ordered list will
produce a condensed list of items separated horizontally by some padding and a
red bullet. Enclosing the ordered list within a blockquote will produce a
2-column list of bordered items with box shadows. Stacks to a single column on
mobile.

### Syntax for Ordered List
#### plain ordered list:
```
1. item goes here
1. another item here
1. final list item
```
#### ordered list within a blockquote:
```
> 1. item goes here
> 1. another item here
> 1. final list item
```

## Unordered Lists within a Blockquote
The following styles will be automatically applied to any unordered lists within a blockquote on your page.

### Syntax for Unordered Lists within Blockquote
```
> - First item
> - This is a second item
> - Third item here
```

## Blockquotes
Use the following styles to add a subtle box-shadow around some content.


### Syntax for Blockquotes
```
> This content will appear in a blockquote.
> So will this line. Be sure to add a carrot to each line in a blockquote even...
>
> ... blank lines.
```

## CSS for a page
See [mkdocs-material additional CSS](https://squidfunk.github.io/mkdocs-material/customization/#additional-css)


## Left Nagivation Bar
Currently using custom nav bar config:
https://pypi.org/project/mkdocs-literate-nav/
Change the nav by editing /source/SUMMARY.md

# Advanced topics

`arxiv-docs` uses
[mkdocs-material](https://squidfunk.github.io/mkdocs-material) which
is theme for mkdocs. For information about customizing themes, CSS or
JS see:

https://squidfunk.github.io/mkdocs-material/customization/

## Where can I find more about mkdocs-material?
See [mkdocs-material/customization](https://squidfunk.github.io/mkdocs-material/customization/)

## Redirects

Redirect from inside mkdocs can be done with HTML pages. Mkdocs will
pass through .html files unchanged.

Say you wanted to redirect from /xyz.html to /about/donate.html, then put this
at `source/xyz.html`:

```
<!DOCTYPE HTML>
<meta charset="UTF-8">
<meta http-equiv="refresh" content="1; url=/about/donate.html">
<script>
window.location.href = "/about/donate.html"
</script>
<title>Redirect</title>
If you are not redirected automatically, follow the <a href='/about/donate.html'>link</a>
```

Note that the URL to redirect to should be relative if it is in mkdocs
but if it is not in mkdocs, it should be absolute. That is, for
https://info.arxiv.org/cheese.html ->
https://info.arxiv.org/onions.html use a relative URL of
`/onions.html`. But for a URL outside of info.arxiv.org like
https://info.arxiv.org/corr/subjectclasses ->
https://arxiv.org/archive/cs you need to use the full URL with the
hostname.

Redirects from /about to
/about/index.html are handled by GCP buckets that are served as a
static web site. See
https://cloud.google.com/storage/docs/static-website

To get a directory to redirect, ex. /corr/subjectclasses ->
https://arxiv.org/archive/cs you need to create the directory and put
an index.html that will do the redirect.

Redirects from https://info.arxiv.org/about/contact to
https://info.arxiv.org/about/contact.html are handled by javascript in
`overrides/404.html`

## How to handle 'Missing end of comment tag'?
As of 2022-09 the macro plugin for mkdocs is disabled and this should
not be a problem. It was difficult to track down so I'm leaving this in.

When using mkdocs and the macros plug in you can get a stack grace
with a Jinja error like message "Missing end of comment tag". This is
often due to LaTeX or code samples with text like `{% raw %} "{{?}}"
{% endraw %}`.

See the [mkdocs-macros docs](https://mkdocs-macros-plugin.readthedocs.io/en/latest/advanced/#code-blocks-containing-similar-languages) for several ways to work around this.
Loading