Ilya Kreymer
92343d59f7
Unfortunately, for proper package pathing, need to remove the `site/` subpath. This includes: - Moving everything back into root - Adding a `copy-site.sh` script to copy resources into `mkdocs/site/` before building the site with mkdocs. - Also update examples to ensure all are loading the local sw.js / ui.js - Consolidate examples in `docs/examples` - Consolidate assets under src/assets/ - Move `favicons` to root - Reformat and relint - Tests: update playwright tests to use mkdocs output, add test for embed in docs - bump to 2.0.0-beta.2
59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
# Loading Archived Items
|
|
|
|
ReplayWeb.page can load archived items from the local filesystem, or from remote locations. If you don't have any archived items yet, try archiving a website with [ArchiveWeb.page](https://archiveweb.page)!
|
|
|
|
---
|
|
|
|
## Loading Local Files
|
|
|
|
From [replayweb.page](https://replayweb.page), press the _Choose File..._ button, pick any local archived item file from your computer, then press _Load_ to start viewing the file's archived content.
|
|
|
|
<img alt="screenshot of replayweb.page (online)" src="../../assets/replaywebpage-online-local.png">
|
|
|
|
The archived item is loaded directly in the browser and is _not_ uploaded anywhere — your data never leaves your computer!
|
|
|
|
Once loaded, the archived item will appear in the list of Loaded Archives and will be identified by its filename with a a `file://` URL as its source. This URL is not shareable as it doesn't exist outside of your computer.
|
|
|
|
<figure>
|
|
<img alt="animated gif of replayweb.page opening an archived item" src="../../assets/replaywebpage-online.gif">
|
|
<figcaption>Loading an archived item into ReplayWeb.page and viewing a URL in the pages list</figcaption>
|
|
</figure>
|
|
|
|
To unload an archived item, click on the 'X'. Unloading an item does not delete the file from its original location.
|
|
|
|
## Loading Files from a URL
|
|
|
|
To load an archived item stored in a remote location, enter the URL of the file and press _Load_.
|
|
|
|
The archived item will be downloaded, either fully or on-demand (if possible) and presented when ready.
|
|
|
|
See the [Supported Locations](locations.md) page for details on supported external sources for serving archived items.
|
|
|
|
## Loading Files from Google Drive
|
|
|
|
In addition to loading remote content from URLs, ReplayWeb.page also supports loading WARC and WACZ files directly from Google Drive.
|
|
|
|
### Add-on Installation
|
|
|
|
First, install the [ReplayWeb.page Google Drive Addon](https://gsuite.google.com/u/2/marketplace/app/replaywebpage/160798412227).
|
|
|
|
* Press the _Install_ button, Google will walk you through the steps of installation.
|
|
* Once installed, Google will confirm the install and display where to find ReplayWeb.page in your drive.
|
|
|
|
<figure>
|
|
<img alt="animated gif of replayweb.page google drive add-on install process" src="../../assets/replaywebpage-googledrive-install.gif">
|
|
<figcaption>Installing the ReplayWeb.page Google Drive add-on</figcaption>
|
|
</figure>
|
|
|
|
### Usage
|
|
|
|
1. Navigate to any WARC or WACZ files that available on your Google Drive.
|
|
|
|
2. Under the file's _More Actions_ :bootstrap-three-dots-vertical: menu, select _Open With_ and choose _ReplayWeb.page_ from the menu.
|
|
|
|
This will redirect to ReplayWeb.page and begin loading the file. Items loaded from Google Drive will have a source URL starting with `googledrive://`.
|
|
|
|
---
|
|
|
|
Once an archived item has been successfully loaded, the app will display the archive viewer and you can begin exploring your loaded archive.
|