{{define "usageMaven"}}
<details class="usage">
  <summary>How to use this repository</summary>
  <p>Point your build tool at <code>{{.Base}}</code> — artifacts are fetched
    from upstream and cached on first request.</p>
  <h3>Gradle (Kotlin DSL)</h3>
  <pre>repositories {
    maven {
        url = uri(&quot;{{.Base}}&quot;){{if .Auth}}
        credentials {
            username = &quot;user&quot;
            password = &quot;password&quot;
        }{{end}}
    }
}</pre>
  <h3>Gradle (Groovy DSL)</h3>
  <pre>repositories {
    maven {
        url '{{.Base}}'{{if .Auth}}
        credentials {
            username 'user'
            password 'password'
        }{{end}}
    }
}</pre>
  <h3>Maven — settings.xml mirror</h3>
  <pre>&lt;mirrors&gt;
  &lt;mirror&gt;
    &lt;id&gt;tiny-proxy&lt;/id&gt;
    &lt;mirrorOf&gt;*&lt;/mirrorOf&gt;
    &lt;url&gt;{{.Base}}&lt;/url&gt;
  &lt;/mirror&gt;
&lt;/mirrors&gt;</pre>
  {{if .Auth}}<h3>Maven — credentials (settings.xml, same file)</h3>
  <pre>&lt;servers&gt;
  &lt;server&gt;
    &lt;id&gt;tiny-proxy&lt;/id&gt;
    &lt;username&gt;user&lt;/username&gt;
    &lt;password&gt;password&lt;/password&gt;
  &lt;/server&gt;
&lt;/servers&gt;</pre>
  {{end}}<h3>curl</h3>
  <pre>curl {{if .Auth}}-u user:password {{end}}-O \
  {{.Base}}&lt;group/path&gt;/&lt;artifact&gt;/&lt;version&gt;/&lt;file&gt;</pre>
</details>
{{end}}

{{define "usageGithub"}}
<details class="usage">
  <summary>How to use this repository</summary>
  <p>Fetch cached GitHub release assets and metadata. Path shape:
    <code>{{.Base}}&lt;owner&gt;/&lt;repo&gt;/&lt;selector&gt;[/&lt;asset&gt;]</code></p>
  <h3>Selectors</h3>
  <p><code>latest</code> — latest stable release · <code>snapshot</code> — most
    recent release, incl. pre-releases · <code>&lt;tag&gt;</code> — pinned tag</p>
  <h3>Download a release asset</h3>
  <pre>curl {{if .Auth}}-u user:password {{end}}-LO \
  {{.Base}}&lt;owner&gt;/&lt;repo&gt;/latest/&lt;asset&gt;</pre>
  <h3>Release metadata (JSON)</h3>
  <pre>curl {{if .Auth}}-u user:password {{end}}{{.Base}}&lt;owner&gt;/&lt;repo&gt;/latest.json
curl {{if .Auth}}-u user:password {{end}}{{.Base}}&lt;owner&gt;/&lt;repo&gt;/&lt;tag&gt;.json</pre>
</details>
{{end}}

{{define "usageDocker"}}
<details class="usage">
  <summary>How to use this repository</summary>
  <p>Pull images through this proxy by prefixing the reference with
    <code>{{.Host}}/{{.Repo}}/</code>.</p>
  <h3>docker pull</h3>
  <pre>{{if .Auth}}docker login {{.Host}}

{{end}}docker pull {{.Host}}/{{.Repo}}/&lt;image&gt;:&lt;tag&gt;</pre>
  <h3>Fetch a manifest directly</h3>
  <pre>curl {{if .Auth}}-u user:password {{end}}-H &quot;Accept: application/vnd.oci.image.manifest.v1+json&quot; \
  {{.Base}}&lt;image&gt;/manifests/&lt;tag&gt;</pre>
</details>
{{end}}

{{define "usageGitea"}}
<details class="usage">
  <summary>How to use this repository</summary>
  <p>Fetch cached Gitea release assets and metadata. Path shape:
    <code>{{.Base}}&lt;owner&gt;/&lt;repo&gt;/&lt;selector&gt;[/&lt;asset&gt;]</code></p>
  <h3>Selectors</h3>
  <p><code>latest</code> — latest stable release · <code>snapshot</code> — most
    recent release, incl. pre-releases · <code>&lt;tag&gt;</code> — pinned tag</p>
  <h3>Download a release asset</h3>
  <pre>curl {{if .Auth}}-u user:password {{end}}-LO \
  {{.Base}}&lt;owner&gt;/&lt;repo&gt;/latest/&lt;asset&gt;</pre>
  <h3>Release metadata (JSON)</h3>
  <pre>curl {{if .Auth}}-u user:password {{end}}{{.Base}}&lt;owner&gt;/&lt;repo&gt;/latest.json
curl {{if .Auth}}-u user:password {{end}}{{.Base}}&lt;owner&gt;/&lt;repo&gt;/&lt;tag&gt;.json</pre>
</details>
{{end}}

{{define "usageDebian"}}
<details class="usage">
  <summary>How to use this repository</summary>
  <p>Point apt at <code>{{.Base}}</code> — metadata is refreshed per the
    configured TTL, packages are cached on first request. The proxy passes
    <code>InRelease</code>/<code>Release.gpg</code> through byte-identical,
    so apt verifies signatures with the distro's regular keyring — no key
    changes are needed.</p>
  <h3>sources.list</h3>
  {{if .Dists}}<pre>{{range .Dists}}deb {{$.Root}} {{.Name}} {{.Components}}
{{end}}</pre>
  <p>One line per distro version this mirror serves — copy the one matching
    your system. Each line works for every architecture the dist carries; add
    <code>[ arch=amd64 ]</code> after <code>deb</code> to pin a subset.</p>
  <h3>Architectures per version</h3>
  <pre>{{range .Dists}}{{.Name}}: {{if .Architectures}}{{.Architectures}}{{else}}unknown{{end}}
{{end}}</pre>
  {{else}}<pre>deb {{.Root}} &lt;dist&gt; &lt;component&gt;
# e.g. deb {{.Root}} bookworm main</pre>
  <p>The full list of supported versions appears here once the upstream
    mirror has been probed successfully.</p>
  {{end}}{{if .Auth}}<h3>apt credentials — /etc/apt/auth.conf.d/tiny-proxy.conf</h3>
  <pre>machine {{.Host}}
login user
password password</pre>
  {{end}}<h3>curl</h3>
  <pre>curl {{if .Auth}}-u user:password {{end}}-O \
  {{.Base}}dists/&lt;dist&gt;/&lt;component&gt;/binary-amd64/Packages.gz</pre>
</details>
{{end}}

{{define "usagePacman"}}
<details class="usage">
  <summary>How to use this repository</summary>
  <p>Use this proxy as a pacman mirror: databases (<code>&lt;repo&gt;.db</code>,
    <code>&lt;repo&gt;.files</code>) refresh per the configured TTL, packages are
    cached forever on first request.</p>
  <h3>pacman.conf</h3>
  <pre>[&lt;repo&gt;]
Server = {{.Base}}$repo/os/$arch</pre>
  {{if .Auth}}<p>Serving pacman over Basic auth requires a small wrapper
    (pacman has no native credentials support) — e.g. an auth-injecting
    local mirror, or run this vrepo in <code>public</code> mode on a trusted
    network.</p>
  {{end}}<h3>curl</h3>
  <pre>curl {{if .Auth}}-u user:password {{end}}-O \
  {{.Base}}core/os/x86_64/core.db</pre>
</details>
{{end}}