Managing Large Assets
For assets smaller than 100MB, uploading through GitHub shouldn't be an issue in most cases. If there is an issue related to the size of the file, use the procedure below.
Some assets on the website such as publication PDFs or supplementary files may be too large to upload directly to GitHub, which has a 100MB file size upload limit. In order to provide access to these files while not including them in the project files, we add them as attachments to a project release titled Large PDF & Data Assets. This way, GitHub hosts the files, and without adding them to the project, we can provide users with a download link.
To add large assets to our site, we need to add them as attachments to the release and then link to them on our site.
Step 1: Locating the Large PDF & Data Assets release
Releases for a GitHub project are typically used to make versions of the project readily available. From the main project page (https://github.com/parklab/parklab.github.io), you can find the Releases on the right side:
Click Releases (or here) to see all Releases for the project. Then, locate and click the release titled Large PDF & Data Assets (or click here).
Step 2: Adding new attachments to the release
To edit the release, click the pencil icon:
The content of the release will become editable. Scroll down to the Assets section. Here is where you will be able to select files to add as attachments to this release.
Note: Uploading a file with the same name will replace and overwrite the one currently there. Please make sure the name is different from the others to avoid any issues.
Step 3: Linking to the new attachments Finally, once you have uploaded the necessary file(s), click the Update release button. The page should no longer be editable. Scroll down to the Assets section, and the new file(s) should appear in the list. Right click on the link and click Copy Link Address. Now the link is copied to your clipboard!
Alternatively, you can use the file name to create the link:
The file name shown can be copied to form the link:
https://github.com/parklab/parklab.github.io/releases/download/large-assets/<file name>
For example, for a file named s41588-025-02408-7.pdf, the link to download it would be:
https://github.com/parklab/parklab.github.io/releases/download/large-assets/s41586-025-09733-1.pdf
This can be used as any other download link in the website.