{#
  SPDX-FileCopyrightText: 2025-2026 TU Wien.
  SPDX-License-Identifier: MIT
#}

{%- extends config.BASE_TEMPLATE %}
{%- set sitename = config.THEME_SITENAME %}

{%- block page_hero %}
  <section id="hero" class="policies no-shrink"></section>
{%- endblock page_hero %}

{%- block page_body %}
  <section class="ui about container rel-mt-3">
    {%- trans trimmed sitename=sitename, frontpage_link=invenio_url_for('invenio_app_rdm.index'), contact_link=invenio_url_for('invenio_theme_tuw.tuw_contact'), api_docs_link=invenio_url_for('invenio_theme_tuw.tuw_about_api'), vrc_docs_link=invenio_url_for('invenio_theme_tuw.tuw_about_vrc') -%}
    <h1>Programmatic access to {{ sitename }}</h1>
    <p>
      The web interface of <a href="{{ frontpage_link }}">{{ sitename }}</a> is designed for browsing, depositing, and managing individual records.
    </p>
    <p>
      However, many research workflows involve more than that, such as repeated queries, bulk uploads, automated pipelines, or analysis environments where switching to a browser is impractical.
    </p>
    <p>
      For those cases, <a href="{{ frontpage_link }}">{{ sitename }}</a> offers two methods for programmatically interacting with the repository:
      A REST API for scripted access from any environment, and a VRE Repository Connector for direct integration with virtual research environments.
      Without using the web interface, both provide you with reliable, authenticated access to repository data.
    </p>

    <h2>REST API</h2>
    <p>
      The REST API follows standard HTTP conventions.
      Using it, you can search and retrieve records, read and update metadata, upload or download files, and manage deposits &mdash; all without going through the web interface.
      Authentication is handled through personal access tokens, which you can generate from your account settings.
      For the full endpoint reference and usage examples, see the <a href="{{ api_docs_link }}">API documentation</a>.
    </p>

    <h2>VRE Repository Connector</h2>
    <p>
      The VRE Repository Connector allows you to access <a href="{{ frontpage_link }}">{{ sitename }}</a> from within a virtual research environment.
      Once configured, you can read and write repository data directly from your analysis environment, without manual downloads or file transfers.
      This is particularly useful for keeping workflows self-contained and reproducible.
      For setup instructions and supported environments, see the <a href="{{ vrc_docs_link }}">VRE Repository Connector page</a>.
    </p>

    <h2>Choosing between the two</h2>
    <p>
      <table class="ui fixed celled table">
        <thead>
          <tr>
            <th>If you want to...</th>
            <th>Use</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>Automate uploads, downloads, or metadata queries from a script</td>
            <td>REST API</td>
          </tr>
          <tr>
            <td>Access repository data from Jupyter, RStudio, etc.</td>
            <td>VRE Repository Connector</td>
          </tr>
          <tr>
            <td>Integrate into Snakemake/Nextflow</td>
            <td>REST API</td>
          </tr>
          <tr>
            <td>Work interactively without leaving your analysis platform</td>
            <td>VRE Repository Connector</td>
          </tr>
        </tbody>
      </table>
    </p>

    <h2>Need help?</h2>
    <p>
      If you have questions about setting up programmatic access or run into issues, contact us through the <a href="{{ contact_link }}">contact page</a>.
    </p>
    {%- endtrans -%}
  </section>
{%- endblock page_body %}