TMLR Beyond PDF Submission Guidelines

Contents

• Quickstart
• Creating a TMLR Beyond PDF Submission
• Testing Your Submission Locally
• Submitting to TMLR on OpenReview
• Camera-Ready Instructions

Quickstart

This section provides a summary of the workflow for creating a submission for TMLR Beyond PDF.

1. Get the TMLR Beyond PDF Author Kit: Download the TMLR Beyond PDF Author Kit. The Author Kit contains a submission_folder that you must modify when creating your submission (described in more detail below). It also contains a script called compile_submission.py that you can use to build your submission website locally for development. To run compile_submission.py, you must have Docker installed.

2. Add Content to your Submission: Create your submission as detailed in the Creating a TMLR Beyond PDF Submission section. The high-level steps are:
   • Update the submission file submission.md with your main submission content.
   • Add any static images for your submission to assets/img/submission/.
   • Add any interactive HTML figures to assets/html/submission/.
   • Update the bibtex file with your citations in assets/bibliography/submission.bib. This bibliography is formatted just like a standard LaTeX bibliography.

3. Rendering the Submission Locally: To render your website locally, you must first have Docker installed. Then, you can run python compile_submission.py, which will build your website and start a server so that you can view the resulting page locally at http://0.0.0.0:8080/tmlr-beyond-pdf-static/under_review/index.html.

4. Submitting on OpenReview: Once you are happy with your submission and have tested it locally, please zip the submission_folder using the command zip -r submission_folder.zip submission_folder. Then, create a submission as usual on OpenReview, adding submission_folder.zip as the supplementary material. Please check the box that asks “Is this a TMLR Beyond PDF submission?” to indicate the type of submission, which will allow you to omit the PDF (that is otherwise a required field). Once you submit to OpenReview, the system will automatically pull the supplementary material from your submission and add it to the TMLR Beyond PDF website. The reviewing process will take place on OpenReview as usual, with reviewers referencing your compiled page on the TMLR Beyond PDF website.

Creating a TMLR Beyond PDF Submission

The directory structure of the submission_folder in the TMLR Beyond PDF Author Kit is as follows:

submission_folder/
├── submission.md                  # <--- Update this markdown file with your submission content
└── assets
    ├── img
    │   └── submission             # <--- Add your static images here
    │       └── YOUR IMAGES
    ├── html
    │   └── submission             # <--- Add your interactive html figures here
    │       └── YOUR HTML FIGURES
    └── bibliography               # <--- Add references to this bibtex file
        └── submission.bib

To create your submission, you need to:

• Update the Markdown file submission.md with your main submission content.
• Add any static image assets will be added to assets/img/submission/.
• Add dynamic HTML content (that can include Javascript for animations, etc.) to assets/html/submission/.
• Add your bibliography to assets/bibliography/submission.bib.

The main content of your submission will be written in the Markdown file submission_folder/submission.md. The header of the file looks like this:

---
layout: distill
title: [Your Submission Title]
description: [Your Abstract]
htmlwidgets: true

# Anonymize when submitting 
authors:
  - name: Anonymous

# Do not change this name, just use "submission.bib".
bibliography: submission.bib

# Optionally, add a table of contents to your submission.
#   - make sure that TOC names match the actual section names
#     for hyperlinks within the submission to work correctly.
toc:
  - name: [Section 1]
  - name: [Section 2]
  # You can additionally add subentries like so:
    subsections:
    - name: [Subsection 2.1]
  - name: [Section 3]
---

# ... The content of your TMLR Beyond PDF submission. ...

You need to update the title, discription and optionally toc fields. Do not fill in the authors field, your submission must be anonymous for the review process.

Check out the example submission.md to see how you can add images and interactive figures, and how to write math using \(\LaTeX\).

Testing Your TMLR Beyond PDF Submission Locally

You can render your Beyond PDF submission locally to ensure that it looks good before submitting:

1. Make sure you have Docker installed.
2. Ensure that Docker is started; for example, on Mac OS, you can run open -a Docker in the terminal to start Docker.
3. To test your submission locally, run python compile_submission.py. You should then be able to see your submission locally by going to http://0.0.0.0:8080/tmlr-beyond-pdf-static/under_review/submission/.

Submitting to TMLR Beyond PDF

1. Zip the updated submission_folder containing your content, using the command zip -r submission_folder.zip submission_folder.

2. Then, create a new TMLR submission on OpenReview, and upload submission_folder.zip as the supplementary material. Within a few minutes, your submission will be automatically added to the Under Review page of the TMLR Beyond PDF website.

It will be created with the following format:

https://tmlr-beyond-pdf.org/under_review/I5jhQ7uEPP/

where I5jhQ7uEPP is the OpenReview ID for your submission.

Camera-Ready Instructions

The main change that must be made for the camera-ready version is to de-anonymize the paper by filling in the authors and affiliations in the submission.md header:

---
layout: distill
title: [Your Submission Title]
description: [Your Abstract]
htmlwidgets: true

# Fill in the authors and affiations only when creating the camera-ready version!
# authors:
#   - name: Albert Einstein
#     url: "https://en.wikipedia.org/wiki/Albert_Einstein"
#     affiliations:
#       name: IAS, Princeton
#   - name: Boris Podolsky
#     url: "https://en.wikipedia.org/wiki/Boris_Podolsky"
#     affiliations:
#       name: IAS, Princeton

# Do not change this name, just use "submission.bib".
bibliography: submission.bib

# Optionally, add a table of contents to your submission.
#   - make sure that TOC names match the actual section names
#     for hyperlinks within the submission to work correctly.
toc:
  - name: [Section 1]
  - name: [Section 2]
  # you can additionally add subentries like so
    subsections:
    - name: [Subsection 2.1]
  - name: [Section 3]
---

# ... The content of your TMLR Beyond PDF submission. ...

You can test the camera-ready version in the same way as before, using python compile_submission.py to start a local server and double-check the submission at http://0.0.0.0:8080/tmlr-beyond-pdf-static/under_review/index.html.

To submit the camera-ready version, follow the same steps as before, zipping the submission folder using zip -r submission_folder.zip submission_folder and uploading submission_folder.zip as the supplementary material on OpenReview.

Your camera-ready submission should then appear in the Accepted Papers section of the TMLR Beyond PDF website.