<?xml version="1.0"?>
<info xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="https://apps.nextcloud.com/schema/apps/info.xsd">
    <id>memento</id>
    <name>Memento</name>
    <summary>Turn your Nextcloud into a web archive</summary>
    <description>
If you host snapshots of web pages on your Nextcloud, this app enables any client that speaks the
Memento protocol to access these snapshots.

The Memento protocol ([RFC7089][]) is widely used to ask archives (such as the Internet Archive's
[Wayback Machine][]) for their copies of web pages. For example, a client (e.g. a browser extension)
may ask an archive whether it has a copy of `https://nextcloud.com` from around July last year, and
—if successful— will be redirected to the closest match.

Currently this app only supports snapshots that are stored as plain html files. It recognises a file
as being a snapshot if the file contains a &lt;link&gt; to the location of the original page; such
snapshots can be created using [Freeze-dry][].

This app requires the app [Raw][] to also be installed, in order to host the snapshots.

## Usage

The app presents a Memento TimeGate at the `/timegate/{url}` route.

For example, assume you have an html file `example.html` in the folder `Documents/snapshots`. If
this file contains a `&lt;link rel="origin" href="https://example.org"&gt;` in its `&lt;head&gt;`,
it will be recognised as a snapshot of `https://example.org`. Visiting
`/apps/memento/timegate/https://example.org` would then redirect you to
`/apps/raw/files/Documents/snapshots/example.html` (hence you need the [Raw] app as well).

In a Memento client (e.g. the [Memento Time Travel][] browser extension), you add your personal
archive as `https://my-nextcloud/apps/memento/timegate/` (of course first replace
`my-nextcloud` appropriately).

A TimeMap is also exposed, at the `/timemap/{url}` route, to list all available snapshots of a URL.
For details, look at the documentation of the Memento protocol ([RFC7089][]).

[Memento Time Travel]: https://addons.mozilla.org/en-US/firefox/addon/memento-timetravel/
[RFC7089]: https://tools.ietf.org/html/rfc7089
[Wayback Machine]: https://web.archive.org/
[Freeze-dry]: https://github.com/WebMemex/freeze-dry
[Raw]: https://code.treora.com/gerben/nextcloud-raw
</description>
    <version>0.0.1</version>
    <licence>agpl</licence>
    <author mail="gerben@treora.com">Gerben</author>
    <namespace>Memento</namespace>
    <category>files</category>
    <repository type="git">https://code.treora.com/gerben/nextcloud-memento</repository>
    <bugs>https://code.treora.com/gerben/nextcloud-memento/issues</bugs>
    <dependencies>
        <nextcloud min-version="14" max-version="14"/>
    </dependencies>
</info>