Commit

Author:

Hash:

Timestamp:

+1050 -0 +/-24 browse

Kevin Schoon [me@kevinschoon.com]

3ed61e4dda3fe0a559cd96dcf82a1d23690a9cd7

Mon, 06 Oct 2025 14:24:49 +0000 (3 weeks ago)

automated www update
1diff --git a/public/404.html b/public/404.html
2new file mode 100644
3index 0000000..f8414f0
4--- /dev/null
5+++ b/public/404.html
6 @@ -0,0 +1,3 @@
7+ <!doctype html>
8+ <title>404 Not Found</title>
9+ <h1>404 Not Found</h1>
10 diff --git a/public/LICENSE.txt b/public/LICENSE.txt
11new file mode 100644
12index 0000000..0e259d4
13--- /dev/null
14+++ b/public/LICENSE.txt
15 @@ -0,0 +1,121 @@
16+ Creative Commons Legal Code
17+
18+ CC0 1.0 Universal
19+
20+ CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
21+ LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
22+ ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
23+ INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
24+ REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
25+ PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
26+ THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
27+ HEREUNDER.
28+
29+ Statement of Purpose
30+
31+ The laws of most jurisdictions throughout the world automatically confer
32+ exclusive Copyright and Related Rights (defined below) upon the creator
33+ and subsequent owner(s) (each and all, an "owner") of an original work of
34+ authorship and/or a database (each, a "Work").
35+
36+ Certain owners wish to permanently relinquish those rights to a Work for
37+ the purpose of contributing to a commons of creative, cultural and
38+ scientific works ("Commons") that the public can reliably and without fear
39+ of later claims of infringement build upon, modify, incorporate in other
40+ works, reuse and redistribute as freely as possible in any form whatsoever
41+ and for any purposes, including without limitation commercial purposes.
42+ These owners may contribute to the Commons to promote the ideal of a free
43+ culture and the further production of creative, cultural and scientific
44+ works, or to gain reputation or greater distribution for their Work in
45+ part through the use and efforts of others.
46+
47+ For these and/or other purposes and motivations, and without any
48+ expectation of additional consideration or compensation, the person
49+ associating CC0 with a Work (the "Affirmer"), to the extent that he or she
50+ is an owner of Copyright and Related Rights in the Work, voluntarily
51+ elects to apply CC0 to the Work and publicly distribute the Work under its
52+ terms, with knowledge of his or her Copyright and Related Rights in the
53+ Work and the meaning and intended legal effect of CC0 on those rights.
54+
55+ 1. Copyright and Related Rights. A Work made available under CC0 may be
56+ protected by copyright and related or neighboring rights ("Copyright and
57+ Related Rights"). Copyright and Related Rights include, but are not
58+ limited to, the following:
59+
60+ i. the right to reproduce, adapt, distribute, perform, display,
61+ communicate, and translate a Work;
62+ ii. moral rights retained by the original author(s) and/or performer(s);
63+ iii. publicity and privacy rights pertaining to a person's image or
64+ likeness depicted in a Work;
65+ iv. rights protecting against unfair competition in regards to a Work,
66+ subject to the limitations in paragraph 4(a), below;
67+ v. rights protecting the extraction, dissemination, use and reuse of data
68+ in a Work;
69+ vi. database rights (such as those arising under Directive 96/9/EC of the
70+ European Parliament and of the Council of 11 March 1996 on the legal
71+ protection of databases, and under any national implementation
72+ thereof, including any amended or successor version of such
73+ directive); and
74+ vii. other similar, equivalent or corresponding rights throughout the
75+ world based on applicable law or treaty, and any national
76+ implementations thereof.
77+
78+ 2. Waiver. To the greatest extent permitted by, but not in contravention
79+ of, applicable law, Affirmer hereby overtly, fully, permanently,
80+ irrevocably and unconditionally waives, abandons, and surrenders all of
81+ Affirmer's Copyright and Related Rights and associated claims and causes
82+ of action, whether now known or unknown (including existing as well as
83+ future claims and causes of action), in the Work (i) in all territories
84+ worldwide, (ii) for the maximum duration provided by applicable law or
85+ treaty (including future time extensions), (iii) in any current or future
86+ medium and for any number of copies, and (iv) for any purpose whatsoever,
87+ including without limitation commercial, advertising or promotional
88+ purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
89+ member of the public at large and to the detriment of Affirmer's heirs and
90+ successors, fully intending that such Waiver shall not be subject to
91+ revocation, rescission, cancellation, termination, or any other legal or
92+ equitable action to disrupt the quiet enjoyment of the Work by the public
93+ as contemplated by Affirmer's express Statement of Purpose.
94+
95+ 3. Public License Fallback. Should any part of the Waiver for any reason
96+ be judged legally invalid or ineffective under applicable law, then the
97+ Waiver shall be preserved to the maximum extent permitted taking into
98+ account Affirmer's express Statement of Purpose. In addition, to the
99+ extent the Waiver is so judged Affirmer hereby grants to each affected
100+ person a royalty-free, non transferable, non sublicensable, non exclusive,
101+ irrevocable and unconditional license to exercise Affirmer's Copyright and
102+ Related Rights in the Work (i) in all territories worldwide, (ii) for the
103+ maximum duration provided by applicable law or treaty (including future
104+ time extensions), (iii) in any current or future medium and for any number
105+ of copies, and (iv) for any purpose whatsoever, including without
106+ limitation commercial, advertising or promotional purposes (the
107+ "License"). The License shall be deemed effective as of the date CC0 was
108+ applied by Affirmer to the Work. Should any part of the License for any
109+ reason be judged legally invalid or ineffective under applicable law, such
110+ partial invalidity or ineffectiveness shall not invalidate the remainder
111+ of the License, and in such case Affirmer hereby affirms that he or she
112+ will not (i) exercise any of his or her remaining Copyright and Related
113+ Rights in the Work or (ii) assert any associated claims and causes of
114+ action with respect to the Work, in either case contrary to Affirmer's
115+ express Statement of Purpose.
116+
117+ 4. Limitations and Disclaimers.
118+
119+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
120+ surrendered, licensed or otherwise affected by this document.
121+ b. Affirmer offers the Work as-is and makes no representations or
122+ warranties of any kind concerning the Work, express, implied,
123+ statutory or otherwise, including without limitation warranties of
124+ title, merchantability, fitness for a particular purpose, non
125+ infringement, or the absence of latent or other defects, accuracy, or
126+ the present or absence of errors, whether or not discoverable, all to
127+ the greatest extent permissible under applicable law.
128+ c. Affirmer disclaims responsibility for clearing rights of other persons
129+ that may apply to the Work or any use thereof, including without
130+ limitation any person's Copyright and Related Rights in the Work.
131+ Further, Affirmer disclaims responsibility for obtaining any necessary
132+ consents, permissions or other rights required for any use of the
133+ Work.
134+ d. Affirmer understands and acknowledges that Creative Commons is not a
135+ party to this document and has no duty or obligation with respect to
136+ this CC0 or use of the Work.
137 diff --git a/public/android-chrome-192x192.png b/public/android-chrome-192x192.png
138new file mode 100644
139index 0000000..f6137eb
140 Binary files /dev/null and b/public/android-chrome-192x192.png differ
141 diff --git a/public/android-chrome-512x512.png b/public/android-chrome-512x512.png
142new file mode 100644
143index 0000000..c77c2af
144 Binary files /dev/null and b/public/android-chrome-512x512.png differ
145 diff --git a/public/apple-touch-icon.png b/public/apple-touch-icon.png
146new file mode 100644
147index 0000000..aaeaa8d
148 Binary files /dev/null and b/public/apple-touch-icon.png differ
149 diff --git a/public/favicon-16x16.png b/public/favicon-16x16.png
150new file mode 100644
151index 0000000..29dd09f
152 Binary files /dev/null and b/public/favicon-16x16.png differ
153 diff --git a/public/favicon-32x32.png b/public/favicon-32x32.png
154new file mode 100644
155index 0000000..811ba56
156 Binary files /dev/null and b/public/favicon-32x32.png differ
157 diff --git a/public/favicon.ico b/public/favicon.ico
158new file mode 100644
159index 0000000..de83549
160 Binary files /dev/null and b/public/favicon.ico differ
161 diff --git a/public/img/cc0.png b/public/img/cc0.png
162new file mode 100644
163index 0000000..df2c82f
164 Binary files /dev/null and b/public/img/cc0.png differ
165 diff --git a/public/img/codeberg.svg b/public/img/codeberg.svg
166new file mode 100644
167index 0000000..068702a
168--- /dev/null
169+++ b/public/img/codeberg.svg
170 @@ -0,0 +1,19 @@
171+ <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" id="svg-badge" height="168" width="564" viewBox="0 0 564 168">
172+ <defs>
173+ <linearGradient xlink:href="#a" id="b" gradientUnits="userSpaceOnUse" x1="42519.285" y1="-7078.789" x2="42575.336" y2="-6966.931" />
174+ <linearGradient id="a">
175+ <stop offset="0" stop-color="#fff" stop-opacity="0" />
176+ <stop offset=".495" stop-color="#71c2ff" />
177+ <stop offset="1" stop-color="#39aaff" />
178+ </linearGradient>
179+ </defs>
180+ <rect id="rect" ry="15.111" y="2" x="2" height="164" width="560" fill="none" stroke="#a6a6a6" stroke-width="4" stroke-linejoin="round" paint-order="fill stroke markers" />
181+ <text style="line-height:0%;-inkscape-font-specification:'Inter';marker:none" x="203.16" y="-85.813" transform="matrix(1.0087 0 0 .99138 -19.194 133.848)" color="#000" font-weight="400" font-size="11.814" font-family="Inter, 'DejaVu Sans', sans-serif" letter-spacing="0" word-spacing="0" overflow="visible" fill="#2185d0" stroke-width=".985">
182+ <tspan id="claim-svg" style="line-height:1;-inkscape-font-specification:'Inter'" x="203.16" y="-85.813" font-size="33.596">GET IT ON</tspan>
183+ </text>
184+ <path aria-label="Codeberg" d="M214.654 71.02c-8.453 0-15.047 2.79-19.803 8.369-4.803 5.577-7.215 12.943-7.215 22.096 0 7.034 1.764 13.158 5.281 18.372 4.862 7.275 12.274 10.912 22.2 10.912 6.907 0 12.922-2.516 18.049-7.548l-4.718-7.185c-4.57 2.85-8.512 4.275-11.844 4.275-5.069 0-9.112-1.91-12.12-5.729-2.847-3.638-4.271-8.004-4.271-13.097 0-5.76 1.211-10.428 3.613-14.005 2.773-4.183 6.694-6.274 11.747-6.274 3.65 0 7.684 1.574 12.11 4.728l4.734-7.546c-5.925-4.91-11.844-7.368-17.763-7.368zm167.7 0l-11.657 6.456v52.201h9.441l.925-4.091c2.843 3.455 6.844 5.183 12.03 5.183 5.238 0 9.638-1.548 13.224-4.64 4.56-4.061 6.85-10.033 6.85-17.914 0-6.122-1.547-11.033-4.634-14.732-3.523-4.184-8.38-6.275-14.612-6.275-2.226 0-4.266.418-6.105 1.274-2.348 1.09-4.176 2.607-5.462 4.546zm-62.745.183l-11.674 6.367v13.186c-2.895-2.304-6.471-3.455-10.722-3.455-4.93 0-9.16 1.606-12.667 4.82-4.692 4.304-7.056 10.427-7.056 18.37 0 5.638 1.466 10.247 4.362 13.824 3.454 4.304 8.486 6.456 15.085 6.456 2.343 0 4.622-.517 6.838-1.547 2.232-1.03 3.83-2.334 4.825-3.909l1.663 4.364h9.346zm-65.647 16.098c-6.057 0-10.956 1.878-14.718 5.636-4.139 4.123-6.206 9.52-6.206 16.188 0 5.88 1.855 10.854 5.553 14.916 4.134 4.486 9.272 6.73 15.371 6.73 5.255 0 9.84-1.759 13.783-5.275 4.75-4.183 7.125-9.641 7.125-16.371 0-5.758-1.599-10.638-4.808-14.641-3.826-4.79-9.192-7.183-16.1-7.183zm91.746 0c-5.988 0-10.914 1.94-14.819 5.82-4.314 4.245-6.477 9.609-6.477 16.096 0 6.61 1.923 11.792 5.744 15.552 4.017 4 9.596 6.002 16.758 6.002 6.647 0 12.205-1.94 16.641-5.822l-2.964-6.092c-4.368 2.426-8.56 3.637-12.572 3.637-2.842 0-5.302-.908-7.401-2.728-2.051-1.88-3.194-4.214-3.417-7.001h28.852v-4.183c0-6.003-1.6-10.885-4.809-14.643-3.693-4.427-8.884-6.638-15.536-6.638zm92.543 0c-5.978 0-10.909 1.94-14.803 5.82-4.326 4.245-6.472 9.609-6.472 16.096 0 6.61 1.907 11.792 5.733 15.552 4 4 9.585 6.002 16.753 6.002 6.658 0 12.205-1.94 16.652-5.822l-2.954-6.092c-4.389 2.426-8.587 3.637-12.588 3.637-2.837 0-5.308-.908-7.406-2.728-2.04-1.88-3.183-4.214-3.427-7.001h28.878v-4.183c0-6.003-1.605-10.885-4.814-14.643-3.709-4.427-8.879-6.638-15.552-6.638zm45.163 0c-1.838 0-3.672.485-5.462 1.455-1.727.908-2.901 2-3.512 3.272l-1.11-3.635h-9.9v41.286h11.477V100.03c.978-2.12 2.524-3.18 4.623-3.18 2.28 0 4.442 1.15 6.466 3.454l9.814-5.274c-2.71-5.154-6.844-7.73-12.396-7.73zm30.121 0c-4.883 0-9.107 1.606-12.683 4.82-4.691 4.304-7.024 10.427-7.024 18.37 0 5.577 1.435 10.186 4.336 13.824 3.4 4.304 8.188 6.456 14.351 6.456 5.064 0 8.974-2.032 11.759-6.094 0 9.094-3.342 13.642-10 13.642-4.697 0-8.921-1.213-12.683-3.638l-2.954 5.82c4.856 4.365 10.637 6.549 17.295 6.549 6.413 0 11.354-1.85 14.813-5.549 3.502-3.758 5.266-9.125 5.255-16.098v-37.01h-8.974l-.914 4.455c0-.604-.893-1.515-2.688-2.728-2.716-1.879-6.005-2.82-9.889-2.82zm-167.923 8.094c5.553 0 8.496 2.97 8.794 8.912h-17.869c.675-5.942 3.704-8.912 9.075-8.912zm92.554 0c5.547 0 8.474 2.97 8.788 8.912h-17.858c.674-5.942 3.703-8.912 9.07-8.912zm-184.204.089c5.989 0 8.98 4.547 8.98 13.64 0 8.732-2.991 13.097-8.98 13.097-5.982 0-8.98-4.365-8.98-13.096 0-9.094 2.998-13.641 8.98-13.641zm45.748 0c2.04 0 3.794.67 5.282 2.002 1.53 1.272 2.518 2.908 2.943 4.909v11.55c-.318 2.243-1.408 4.243-3.315 6.002-1.913 1.698-3.985 2.547-6.2 2.547-5.989 0-8.98-4.516-8.98-13.55 0-4.123.924-7.396 2.778-9.82 1.85-2.426 4.347-3.64 7.492-3.64zm216.312 0c1.982 0 3.762.7 5.377 2.093 1.669 1.335 2.625 2.94 2.875 4.818v10.46c0 2.607-.935 4.878-2.785 6.82-1.854 1.878-4.043 2.819-6.572 2.819-6.047 0-9.075-4.516-9.075-13.55 0-4.123.924-7.396 2.779-9.82 1.849-2.426 4.325-3.64 7.401-3.64zm-124.322.094c2.832 0 5.048 1.211 6.663 3.637 1.594 2.425 2.407 5.728 2.407 9.912 0 4.244-.866 7.58-2.598 10.006-1.727 2.424-4.07 3.637-7.019 3.637-2.295 0-4.31-.76-6.03-2.274-1.68-1.518-2.604-3.396-2.769-5.637v-9.916c0-2.606.893-4.818 2.673-6.637 1.854-1.817 4.075-2.728 6.673-2.728z" style="line-height:1.25;-inkscape-font-specification:'Tajawal Bold';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal" font-weight="700" font-size="17.899" font-family="Tajawal" letter-spacing="-.285" word-spacing="0" fill="#2185d0" />
185+ <g paint-order="stroke markers fill">
186+ <path style="font-variation-settings:normal" d="M42519.285-7078.79a.76.568 0 00-.738.675l33.586 125.888a87.182 87.182 0 0039.381-33.763l-71.565-92.52a.76.568 0 00-.664-.28z" transform="matrix(.75692 0 0 .74393 -32088.397 5317.32)" opacity=".5" fill="url(#b)" />
187+ <path d="M93.742 20.95A65.99 64.857 0 0028 85.807a65.99 64.857 0 0010.076 34.447l55.019-69.909a1.03.756 0 011.785 0l55.022 69.912a65.99 64.857 0 0010.078-34.45A65.99 64.857 0 0093.99 20.95a65.99 64.857 0 00-.248 0z" fill="#2185d0" />
188+ </g>
189+ </svg>
190\ No newline at end of file
191 diff --git a/public/img/logo.png b/public/img/logo.png
192new file mode 100644
193index 0000000..93e608e
194 Binary files /dev/null and b/public/img/logo.png differ
195 diff --git a/public/img/logo.svg b/public/img/logo.svg
196new file mode 100644
197index 0000000..cdc0267
198--- /dev/null
199+++ b/public/img/logo.svg
200 @@ -0,0 +1 @@
201+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200"><g transform="translate(0 -852.36)"><rect width="180" height="180" x="10" y="862.36" rx="8.546" ry="7.52" style="fill-opacity:.24215;fill:#e7eab7"/><path d="M159.21 52.277c0 12.686-11.082 22.97-24.752 22.97s-24.752-10.284-24.752-22.97 11.082-22.97 24.752-22.97 24.752 10.284 24.752 22.97z" style="fill-opacity:.89686;fill:#b3b3b3" transform="matrix(.6464 0 0 .69655 -38.912 967.95)"/><path d="M118.91 1020.4c.102-.453.25-.888.344-1.344a72.568 72.568 0 0 0 1.094-7.219c.248-2.444.375-4.927.375-7.437s-.127-4.993-.375-7.438-.61-4.851-1.094-7.218a72.281 72.281 0 0 0-1.813-6.97 72.276 72.276 0 0 0-2.437-6.687c-.92-2.175-1.943-4.283-3.063-6.343s-2.318-4.066-3.625-6-2.705-3.798-4.187-5.594a73.377 73.377 0 0 0-4.72-5.156c-1.644-1.645-3.36-3.237-5.155-4.72s-3.66-2.88-5.594-4.187c-1.934-1.306-3.94-2.505-6-3.625s-4.169-2.142-6.344-3.062a72.255 72.255 0 0 0-6.687-2.438 72.245 72.245 0 0 0-6.97-1.812 72.57 72.57 0 0 0-7.218-1.094c-2.445-.248-4.927-.375-7.437-.375s-4.993.127-7.438.375-4.852.61-7.219 1.094c-.456.093-.89.242-1.344.344v25.5c1.704-.552 3.345-1.23 5.125-1.594 1.595-.327 3.228-.583 4.875-.75s3.309-.25 5-.25 3.353.082 5 .25c1.648.167 3.28.423 4.875.75 3.19.652 6.257 1.604 9.188 2.844s5.737 2.77 8.344 4.53a49.125 49.125 0 0 1 7.25 5.97 49.138 49.138 0 0 1 5.969 7.25 49.135 49.135 0 0 1 4.53 8.343 48.502 48.502 0 0 1 2.845 9.188c.326 1.595.582 3.228.75 4.875s.25 3.308.25 5c0 1.691-.083 3.353-.25 5a49.126 49.126 0 0 1-.75 4.875c-.365 1.78-1.043 3.42-1.594 5.125h25.5z" style="fill-opacity:.89686;fill:#b3b3b3"/><path d="M48 874.36c-4.487 0-8.911.212-13.281.656-.92.094-1.805.294-2.719.407v29.562c1.894-.303 3.76-.68 5.688-.875 3.388-.345 6.833-.532 10.312-.532 3.478 0 6.924.187 10.312.532 3.388.344 6.72.86 10 1.53a99.75 99.75 0 0 1 18.906 5.844c3.014 1.275 5.956 2.699 8.812 4.25s5.632 3.252 8.313 5.063 5.261 3.727 7.75 5.781 4.876 4.252 7.156 6.531 4.478 4.668 6.531 7.157c2.054 2.488 3.97 5.069 5.781 7.75s3.511 5.456 5.063 8.312 2.975 5.798 4.25 8.813 2.393 6.094 3.375 9.25a99.975 99.975 0 0 1 2.469 9.656c.671 3.28 1.187 6.612 1.531 10 .344 3.388.531 6.834.531 10.313 0 3.479-.187 6.924-.531 10.312-.196 1.927-.572 3.794-.875 5.687h29.562c.112-.914.313-1.799.406-2.718.444-4.37.656-8.794.656-13.281 0-4.488-.212-8.911-.656-13.281-.444-4.37-1.134-8.675-2-12.906a129.23 129.23 0 0 0-3.187-12.47c-1.266-4.07-2.73-8.049-4.375-11.937a129.601 129.601 0 0 0-11.969-22.094c-2.336-3.458-4.85-6.79-7.5-10s-5.434-6.31-8.375-9.25-6.04-5.726-9.25-8.375-6.542-5.164-10-7.5a129.885 129.885 0 0 0-22.094-11.97 128.88 128.88 0 0 0-11.938-4.374 129.205 129.205 0 0 0-12.469-3.188c-4.231-.866-8.536-1.556-12.906-2-4.349-.48-8.773-.69-13.26-.69z" style="fill-opacity:.89686;fill:#b3b3b3"/></g></svg>
202\ No newline at end of file
203 diff --git a/public/img/minimal-favicon.png b/public/img/minimal-favicon.png
204new file mode 100644
205index 0000000..e7cdbde
206 Binary files /dev/null and b/public/img/minimal-favicon.png differ
207 diff --git a/public/img/minimal-minimal.png b/public/img/minimal-minimal.png
208new file mode 100644
209index 0000000..8f60a03
210 Binary files /dev/null and b/public/img/minimal-minimal.png differ
211 diff --git a/public/img/minimal-thumbnail.png b/public/img/minimal-thumbnail.png
212new file mode 100644
213index 0000000..e6c0478
214 Binary files /dev/null and b/public/img/minimal-thumbnail.png differ
215 diff --git a/public/img/sourcehut.svg b/public/img/sourcehut.svg
216new file mode 100644
217index 0000000..c7a12e9
218--- /dev/null
219+++ b/public/img/sourcehut.svg
220 @@ -0,0 +1,77 @@
221+ <?xml version="1.0" encoding="UTF-8" standalone="no"?>
222+ <!-- Created with Inkscape (http://www.inkscape.org/) -->
223+
224+ <svg
225+ width="300"
226+ height="80"
227+ viewBox="0 0 79.375001 21.166666"
228+ version="1.1"
229+ id="svg5"
230+ inkscape:version="1.1 (c68e22c387, 2021-05-23)"
231+ sodipodi:docname="sourcehut-black.svg"
232+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
233+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
234+ xmlns="http://www.w3.org/2000/svg"
235+ xmlns:svg="http://www.w3.org/2000/svg">
236+ <sodipodi:namedview
237+ id="namedview7"
238+ pagecolor="#505050"
239+ bordercolor="#ffffff"
240+ borderopacity="1"
241+ inkscape:pageshadow="0"
242+ inkscape:pageopacity="0"
243+ inkscape:pagecheckerboard="1"
244+ inkscape:document-units="px"
245+ showgrid="false"
246+ units="px"
247+ height="80px"
248+ inkscape:zoom="3.0930415"
249+ inkscape:cx="152.6006"
250+ inkscape:cy="77.75518"
251+ inkscape:window-width="1920"
252+ inkscape:window-height="1059"
253+ inkscape:window-x="0"
254+ inkscape:window-y="0"
255+ inkscape:window-maximized="1"
256+ inkscape:current-layer="layer1" />
257+ <defs
258+ id="defs2">
259+ <rect
260+ x="72.43578"
261+ y="4.989779"
262+ width="233.3009"
263+ height="93.363552"
264+ id="rect22993" />
265+ <rect
266+ x="76.460692"
267+ y="7.5029808"
268+ width="210.43456"
269+ height="46.880685"
270+ id="rect5098" />
271+ </defs>
272+ <g
273+ inkscape:label="Layer 1"
274+ inkscape:groupmode="layer"
275+ id="layer1">
276+ <path
277+ d="m 10.58314,1.3501934 c -5.1005652,0 -9.23314,4.1325746 -9.23314,9.2331386 0,5.100566 4.1325748,9.233141 9.23314,9.233141 5.100565,0 9.23314,-4.132575 9.23314,-9.233141 0,-5.100564 -4.132575,-9.2331386 -9.23314,-9.2331386 z m 0,16.6792216 c -4.1139596,0 -7.4460807,-3.332121 -7.4460807,-7.446083 0,-4.1139582 3.3321211,-7.4460793 7.4460807,-7.4460793 4.11396,0 7.446082,3.3321211 7.446082,7.4460793 0,4.113962 -3.332122,7.446083 -7.446082,7.446083 z"
278+ id="path49"
279+ style="stroke-width:0.0372303" />
280+ <text
281+ xml:space="preserve"
282+ transform="scale(0.26458333)"
283+ id="text22991"
284+ style="fill:black;fill-opacity:1;line-height:1.25;stroke:none;font-family:sans-serif;font-style:normal;font-weight:normal;font-size:40px;white-space:pre;shape-inside:url(#rect22993)" />
285+ <text
286+ xml:space="preserve"
287+ style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:11.2889px;line-height:1.25;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
288+ x="22.349714"
289+ y="13.896598"
290+ id="text29885"><tspan
291+ sodipodi:role="line"
292+ id="tspan29883"
293+ style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:11.2889px;font-family:'DejaVu Sans';-inkscape-font-specification:'DejaVu Sans, Normal';font-variant-ligatures:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-east-asian:normal;stroke-width:0.264583"
294+ x="22.349714"
295+ y="13.896598">sourcehut</tspan></text>
296+ </g>
297+ </svg>
298 diff --git a/public/index.html b/public/index.html
299new file mode 100644
300index 0000000..46effe5
301--- /dev/null
302+++ b/public/index.html
303 @@ -0,0 +1,82 @@
304+ <!DOCTYPE html>
305+ <html lang="en-US">
306+ <head>
307+ <meta charset="UTF-8" />
308+ <meta http-equiv="X-UA-Compatible" content="IE=edge" />
309+ <meta name="viewport" content="width=device-width, initial-scale=1" />
310+ <title></title>
311+ <meta
312+ name="description"
313+ itemprop="about"
314+ content="ForgeFeed Specifications"
315+ />
316+ <link rel="stylesheet" href="https://forge-feed.org/styles.css" />
317+ </head>
318+
319+ <body>
320+ <div class="wrapper">
321+ <header>
322+ <a href="https://forge-feed.org">
323+ <img
324+ src="https://forge-feed.org/img/logo.svg"
325+ class="site-logo"
326+ alt="Logo"
327+ width="275px"
328+ height="auto"
329+ /></a>
330+
331+ <p>ForgeFeed Specifications</p>
332+
333+
334+ <a href="https://codeberg.org/ayllu/forge-feed">
335+ <img
336+ src="https://forge-feed.org/img/codeberg.svg"
337+ class="site-logo"
338+ alt="Codeberg Logo"
339+ />
340+ </a>
341+
342+ <a href="https://git.sr.ht/~kevinschoon/forge-feed">
343+ <img
344+ src="https://forge-feed.org/img/sourcehut.svg"
345+ class="site-logo sourcehut"
346+ alt="Sourcehut Logo"
347+ />
348+ </a>
349+
350+
351+
352+ </header>
353+
354+ <section>
355+ <h1>Forge-Feed</h1>
356+ <p><strong>Please note that these specifications are currently PROVISIONAL
357+ and should not be implemented. This specification is not endorsed or
358+ supported by any particular organization entity.</strong></p>
359+ <p>ForgeFeed is a collection of specifications and recommendations which when
360+ implemented can enhance interoperability and content discovery of different
361+ <a href="https://en.wikipedia.org/wiki/Forge_(software)">code forges</a>
362+ across the internet.</p>
363+ <p>NOTE that all specifications provided below MAY be implemented indepedenantly
364+ at the descrescion of the developer however it is a recommended that a server
365+ implement them all for maximum effect.</p>
366+ <p>The following specifications are currently covered:</p>
367+ <ul>
368+ <li><a href="/webfinger-project">WebFinger Project Identification</a> - Identify Software Projects via WebFinger</li>
369+ <li><a href="/webfinger-repository">WebFinger Repository Identification</a> - Identify VCS Repository Content via WebFinger</li>
370+ <li><a href="/project-atom-feed">Atom Feed Project Discovery</a> - Subscribe to a forge over Atom</li>
371+ </ul>
372+
373+ </section>
374+
375+ <footer>
376+ <a href="/LICENSE.txt">
377+ <img
378+ src="https://forge-feed.org/img/cc0.png"
379+ alt="cc0 logo"
380+ />
381+ </a>
382+ </footer>
383+ </div>
384+ </body>
385+ </html>
386 diff --git a/public/project-atom-feed/index.html b/public/project-atom-feed/index.html
387new file mode 100644
388index 0000000..0f88613
389--- /dev/null
390+++ b/public/project-atom-feed/index.html
391 @@ -0,0 +1,178 @@
392+ <!DOCTYPE html>
393+ <html lang="en-US">
394+ <head>
395+ <meta charset="UTF-8" />
396+ <meta http-equiv="X-UA-Compatible" content="IE=edge" />
397+ <meta name="viewport" content="width=device-width, initial-scale=1" />
398+ <title></title>
399+ <meta
400+ name="description"
401+ itemprop="about"
402+ content="ForgeFeed Specifications"
403+ />
404+ <link rel="stylesheet" href="https://forge-feed.org/styles.css" />
405+ </head>
406+
407+ <body>
408+ <div class="wrapper">
409+ <header>
410+ <a href="https://forge-feed.org">
411+ <img
412+ src="https://forge-feed.org/img/logo.svg"
413+ class="site-logo"
414+ alt="Logo"
415+ width="275px"
416+ height="auto"
417+ /></a>
418+
419+ <p>ForgeFeed Specifications</p>
420+
421+
422+ <a href="https://codeberg.org/ayllu/forge-feed">
423+ <img
424+ src="https://forge-feed.org/img/codeberg.svg"
425+ class="site-logo"
426+ alt="Codeberg Logo"
427+ />
428+ </a>
429+
430+ <a href="https://git.sr.ht/~kevinschoon/forge-feed">
431+ <img
432+ src="https://forge-feed.org/img/sourcehut.svg"
433+ class="site-logo sourcehut"
434+ alt="Sourcehut Logo"
435+ />
436+ </a>
437+
438+
439+
440+ </header>
441+
442+ <section>
443+ <h1>Atom Feed</h1>
444+ <h1 id="atom-feeds">Atom Feeds</h1>
445+ <p>Your forge should expose an <a href="https://www.rfc-editor.org/rfc/rfc4287">Atom</a>
446+ feed in order for other peers to subscribe to interesting code projects that
447+ are developed on your forge. The server should expose projects ordered by those
448+ which have been recently updated. THe heuristic you use to determine what has
449+ been updated depends on your forge. A common way to do this may be to simply
450+ look at your VCS's concept of a commit and order updates with that.</p>
451+ <h2 id="determine-if-a-host-supports-forge-feed">Determine if a Host Supports Forge Feed</h2>
452+ <p>In order to participate in ForgeFeed your forge MUST present an HTML link
453+ element such as below at the root domain of your forge. For example,
454+ <code>code.example.org</code> MUST have a link element present in it's html header:</p>
455+ <pre data-lang="html" style="background-color:#2b303b;color:#c0c5ce;" class="language-html "><code class="language-html" data-lang="html"><span>&lt;</span><span style="color:#bf616a;">html</span><span>&gt;
456+ </span><span> &lt;</span><span style="color:#bf616a;">head</span><span>&gt;
457+ </span><span> &lt;</span><span style="color:#bf616a;">title</span><span>&gt;My Forge&lt;/</span><span style="color:#bf616a;">title</span><span>&gt;
458+ </span><span> &lt;</span><span style="color:#bf616a;">link
459+ </span><span> </span><span style="color:#d08770;">rel</span><span>=&quot;</span><span style="color:#a3be8c;">alternate</span><span>&quot;
460+ </span><span> </span><span style="color:#d08770;">type</span><span>=&quot;</span><span style="color:#a3be8c;">application/atom+xml</span><span>&quot;
461+ </span><span> </span><span style="color:#d08770;">title</span><span>=&quot;</span><span style="color:#a3be8c;">Recent Forge Activity</span><span>&quot;
462+ </span><span> </span><span style="color:#d08770;">href</span><span>=&quot;</span><span style="color:#a3be8c;">https://code.example.org/firehose.xml</span><span>&quot; /&gt;
463+ </span><span> </span><span style="color:#65737e;">&lt;!-- index-url refers to the RSS link on the current webpage which contains forge updates --&gt;
464+ </span><span> &lt;</span><span style="color:#bf616a;">meta </span><span style="color:#d08770;">name</span><span>=&quot;</span><span style="color:#a3be8c;">forge-feed:index-url</span><span>&quot; </span><span style="color:#d08770;">content</span><span>=&quot;</span><span style="color:#a3be8c;">https://code.example.org/firehose.xml</span><span>&quot;/&gt;
465+ </span><span> &lt;/</span><span style="color:#bf616a;">head</span><span>&gt;
466+ </span><span> &lt;</span><span style="color:#bf616a;">body</span><span>&gt;
467+ </span><span> ...
468+ </span><span> &lt;/</span><span style="color:#bf616a;">body</span><span>&gt;
469+ </span><span>&lt;/</span><span style="color:#bf616a;">html</span><span>&gt;
470+ </span></code></pre>
471+ <p>The link MAY have a title of "Recent Forge Activity" such that it uniquely
472+ identifies this feed as being related to forge updates. A server MUST provide a
473+ meta tag with the name forge-feed:index where the content of the tag matches
474+ the href of an Atom link listed on this page which should be used for indexing
475+ by external crawlers. Applications which rely on the forge-feed:index meta
476+ tag MUST stop crawling the serving website if this tag is no longer present
477+ in the pages HTML.</p>
478+ <h3 id="an-example-feed">An example Feed</h3>
479+ <p>Below is an example Atom feed with an optional repository section (described below).</p>
480+ <pre data-lang="xml" style="background-color:#2b303b;color:#c0c5ce;" class="language-xml "><code class="language-xml" data-lang="xml"><span>&lt;?</span><span style="color:#bf616a;">xml </span><span style="color:#d08770;">version</span><span>=&quot;</span><span style="color:#a3be8c;">1.0</span><span>&quot; </span><span style="color:#d08770;">encoding</span><span>=&quot;</span><span style="color:#a3be8c;">utf-8</span><span>&quot;?&gt;
481+ </span><span> &lt;</span><span style="color:#bf616a;">feed </span><span style="color:#d08770;">xmlns</span><span>=&quot;</span><span style="color:#a3be8c;">http://www.w3.org/2005/Atom</span><span>&quot;
482+ </span><span> </span><span style="color:#d08770;">xmlns:forge-feed</span><span>=&quot;</span><span style="color:#a3be8c;">http://forge-feed.org/project-atom-feed</span><span>&quot;&gt;
483+ </span><span>
484+ </span><span> &lt;</span><span style="color:#bf616a;">title</span><span>&gt;Acme Forge Firehose&lt;/</span><span style="color:#bf616a;">title</span><span>&gt;
485+ </span><span> &lt;</span><span style="color:#bf616a;">subtitle</span><span>&gt;Recent Project Updates @ Acme Forge&lt;/</span><span style="color:#bf616a;">subtitle</span><span>&gt;
486+ </span><span> &lt;</span><span style="color:#bf616a;">link </span><span style="color:#d08770;">href</span><span>=&quot;</span><span style="color:#a3be8c;">https://code.example.org/firehose.xml</span><span>&quot; </span><span style="color:#d08770;">rel</span><span>=&quot;</span><span style="color:#a3be8c;">self</span><span>&quot; /&gt;
487+ </span><span> &lt;</span><span style="color:#bf616a;">link </span><span style="color:#d08770;">href</span><span>=&quot;</span><span style="color:#a3be8c;">https://code.example.org/</span><span>&quot; /&gt;
488+ </span><span> &lt;</span><span style="color:#bf616a;">id</span><span>&gt;urn:uuid:44decbfc-ec17-42fa-994e-67dc13029072&lt;/</span><span style="color:#bf616a;">id</span><span>&gt;
489+ </span><span> &lt;</span><span style="color:#bf616a;">updated</span><span>&gt;2025-06-18T11:23:02Z&lt;/</span><span style="color:#bf616a;">updated</span><span>&gt;
490+ </span><span>
491+ </span><span> &lt;</span><span style="color:#bf616a;">entry</span><span>&gt;
492+ </span><span> &lt;</span><span style="color:#bf616a;">title</span><span>&gt;Spartacus Game&lt;/</span><span style="color:#bf616a;">title</span><span>&gt;
493+ </span><span> &lt;</span><span style="color:#bf616a;">link </span><span style="color:#d08770;">href</span><span>=&quot;</span><span style="color:#a3be8c;">https://code.example.org/spartacus</span><span>&quot; /&gt;
494+ </span><span> &lt;</span><span style="color:#bf616a;">id</span><span>&gt;urn:uuid:51b2ad2b-34ff-4a69-9f45-a300bf296d05&lt;/</span><span style="color:#bf616a;">id</span><span>&gt;
495+ </span><span> &lt;</span><span style="color:#bf616a;">published</span><span>&gt;2025-06-18T11:23:02Z&lt;/</span><span style="color:#bf616a;">published</span><span>&gt;
496+ </span><span> &lt;</span><span style="color:#bf616a;">updated</span><span>&gt;2025-06-18T11:23:02Z&lt;/</span><span style="color:#bf616a;">updated</span><span>&gt;
497+ </span><span> &lt;</span><span style="color:#bf616a;">summary</span><span>&gt;A Game Engine </span><span style="background-color:#bf616a;color:#2b303b;">&amp;</span><span> Text Adventure Written in FORTRAN 77&lt;/</span><span style="color:#bf616a;">summary</span><span>&gt;
498+ </span><span> &lt;</span><span style="color:#bf616a;">forge-feed:project</span><span>&gt;project:spartacus&lt;/</span><span style="color:#bf616a;">forge-feed:project</span><span>&gt;
499+ </span><span> &lt;/</span><span style="color:#bf616a;">entry</span><span>&gt;
500+ </span><span>&lt;/</span><span style="color:#bf616a;">feed</span><span>&gt;
501+ </span></code></pre>
502+ <h3 id="forgefeed-extension">ForgeFeed Extension</h3>
503+ <p>In order to facilitate discovery by external indexes it is highly recommended
504+ that your server implement the webfinger <a href="/webfinger-project">project specification</a>
505+ so that repository indexes may populate their state with rich information
506+ about code repositories hosted on your server.</p>
507+ <p>The extension currently supports only a single field called <code>project</code>.</p>
508+ <pre data-lang="xml" style="background-color:#2b303b;color:#c0c5ce;" class="language-xml "><code class="language-xml" data-lang="xml"><span>&lt;</span><span style="color:#bf616a;">forge-feed:project</span><span>&gt;project:spartacus&lt;/</span><span style="color:#bf616a;">forge-feed:project</span><span>&gt;
509+ </span></code></pre>
510+ <p>If the host section of the URI is included that is MUST match domain name
511+ of the server which is providing the feed.</p>
512+ <h3 id="security-concerns">Security Concerns</h3>
513+ <h4 id="private-projects">Private Projects</h4>
514+ <p>Forge-feed enabled Atom feeds have no support for sharing private projects
515+ and any project that is not shared publicly on the internet must be hidden
516+ from the Atom activity feed stream. If your forge provides the ability to change
517+ a project from public to private it must be understood that clients may
518+ already have cached versions of your project data.</p>
519+ <h3 id="recommendations-for-enumerating-project-events">Recommendations for Enumerating Project Events</h3>
520+ <h4 id="specify-a-maximum-timeframe">Specify a Maximum Timeframe</h4>
521+ <p>Your activity feed should not include project events that are older than 1
522+ week.</p>
523+ <h4 id="project-items-should-be-unique">Project Items SHOULD be Unique</h4>
524+ <p>Although it is permitted to return duplicate projects the feed SHOULD only
525+ return unique projects in a given window.</p>
526+ <h4 id="event-clamping">Event "Clamping"</h4>
527+ <p>It may be undesirable to enumerate project events items with the simple
528+ heuristic of</p>
529+ <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>end = time.now()
530+ </span><span>start = end - 6h
531+ </span><span>
532+ </span><span>events = project_events_between(start, end)
533+ </span></code></pre>
534+ <p>Because the oldest project events will fall out of the time window on
535+ subsequent queries by feed readers. This can cause some feed readers to
536+ frequently request new content from your server. Instead events can be
537+ "clamped" within a certain time period. For example you may choose to
538+ publish four buckets of updates per day:</p>
539+ <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>00:00:00 06:00:00
540+ </span><span>06:00:00 12:00:00
541+ </span><span>12:00:00 18:00:00
542+ </span><span>18:00:00 00:00:00
543+ </span><span>
544+ </span><span>For example if the current time is 2021-03-05 13:00:55 UTC you could use
545+ </span><span>the following example to return a summary of project events from the
546+ </span><span>previous time bucket.
547+ </span><span>
548+ </span><span>now = time.now()
549+ </span><span>start = now.set_time(&quot;06:00:00&quot;)
550+ </span><span>end = now.set_time(&quot;12:00:00&quot;)
551+ </span><span>
552+ </span><span>events = project_events_between(start, end)
553+ </span></code></pre>
554+ <p>This approach with a TTL value of 60 (minutes) will reduce excess requests
555+ from some readers but allow all clients to receive timely updates.</p>
556+
557+ </section>
558+
559+ <footer>
560+ <a href="/LICENSE.txt">
561+ <img
562+ src="https://forge-feed.org/img/cc0.png"
563+ alt="cc0 logo"
564+ />
565+ </a>
566+ </footer>
567+ </div>
568+ </body>
569+ </html>
570 diff --git a/public/robots.txt b/public/robots.txt
571new file mode 100644
572index 0000000..a2e9da9
573--- /dev/null
574+++ b/public/robots.txt
575 @@ -0,0 +1,4 @@
576+ User-agent: *
577+ Disallow:
578+ Allow: /
579+ Sitemap: https://forge-feed.org/sitemap.xml
580 diff --git a/public/site.webmanifest b/public/site.webmanifest
581new file mode 100644
582index 0000000..06d341a
583--- /dev/null
584+++ b/public/site.webmanifest
585 @@ -0,0 +1,19 @@
586+ {
587+ "name": "",
588+ "short_name": "",
589+ "icons": [
590+ {
591+ "src": "/android-chrome-192x192.png",
592+ "sizes": "192x192",
593+ "type": "image/png"
594+ },
595+ {
596+ "src": "/android-chrome-512x512.png",
597+ "sizes": "512x512",
598+ "type": "image/png"
599+ }
600+ ],
601+ "theme_color": "#ffffff",
602+ "background_color": "#ffffff",
603+ "display": "standalone"
604+ }
605 diff --git a/public/sitemap.xml b/public/sitemap.xml
606new file mode 100644
607index 0000000..cc6fbee
608--- /dev/null
609+++ b/public/sitemap.xml
610 @@ -0,0 +1,15 @@
611+ <?xml version="1.0" encoding="UTF-8"?>
612+ <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
613+ <url>
614+ <loc>https://forge-feed.org/</loc>
615+ </url>
616+ <url>
617+ <loc>https://forge-feed.org/project-atom-feed/</loc>
618+ </url>
619+ <url>
620+ <loc>https://forge-feed.org/webfinger-project/</loc>
621+ </url>
622+ <url>
623+ <loc>https://forge-feed.org/webfinger-repository/</loc>
624+ </url>
625+ </urlset>
626 diff --git a/public/styles.css b/public/styles.css
627new file mode 100644
628index 0000000..3409bc1
629--- /dev/null
630+++ b/public/styles.css
631 @@ -0,0 +1 @@
632+ .wrapper{width:860px;margin:0 auto}header{width:170px;float:left;position:fixed;-webkit-font-smoothing:subpixel-antialiased}body{background-color:#fff;padding:50px;font:14px/1.5 "Noto Sans","Helvetica Neue",Helvetica,Arial,sans-serif;color:#222;font-weight:400}h1,h2,h3,h4,h5,h6{color:#222;margin:0 0 20px}p,ul,ol,table,pre,dl{margin:0 0 20px}h1,h2,h3{line-height:1.1}h1{font-size:28px}a{color:#267cb9;text-decoration:none}a:hover,a:focus{color:salmon}a small{font-size:11px;color:#000;margin-top:-.3em;display:block}a:hover small{color:#777}strong{color:#222;font-weight:700}section{width:600px;float:right;padding-bottom:50px}small{font-size:11px}hr{border:0;background:#e5e5e5;height:1px;margin:0 0 20px}footer{width:270px;float:left;position:fixed;bottom:50px;-webkit-font-smoothing:subpixel-antialiased}pre{padding:8px 15px;border-radius:5px;border:1px solid #e5e5e5;overflow-x:auto}ul.downloads{list-style:none;height:40px;padding:0;background:#f4f4f4;border-radius:5px;border:1px solid #e0e0e0;width:270px}.downloads li{width:89px;float:left;border-right:1px solid #e0e0e0;height:40px}.downloads li:first-child a{border-radius:5px 0 0 5px}.downloads li:last-child a{border-radius:0 5px 5px 0}.downloads a{line-height:1;font-size:11px;display:block;text-align:center;padding-top:6px;height:34px}.downloads a:hover,.downloads a:focus{font-weight:bold}.downloads ul a:active{background-color:#f0f0f0}.downloads li+li+li{border-right:none;width:89px}.downloads a strong{font-size:14px;display:block;color:#222}.site-logo{margin-bottom:1rem;width:100%}@media print,screen and (max-width: 960px){div.wrapper{width:auto;margin:0}header,section,footer{float:none;position:static;width:auto}header{padding-right:320px}section{border:1px solid #e5e5e5;border-width:1px 0;padding:20px 0;margin:0 0 20px}header a small{display:inline}header ul{position:absolute;right:50px;top:52px}}@media print,screen and (max-width: 720px){body{word-wrap:break-word}header{padding:0}header ul,header p.view{position:static;margin:1rem auto}pre,code{word-wrap:normal;text-wrap:wrap}}@media print,screen and (max-width: 480px){body{padding:15px}.downloads{width:100%;margin:1rem auto}.downloads li,.downloads li+li+li{width:33%}}@media print{body{padding:.4in;font-size:12pt;color:#444}}::selection{background:#639;color:#fff}table{margin:1rem auto;border-collapse:collapse}table thead th,table tfoot th{color:#202020;background:rgba(0,0,0,.15)}table caption{padding:.5em}table th,table td{padding:.5em;border:1px solid #e5e5e5}pre,code{font-family:monospace}code{border-radius:3px}pre{overflow:auto}pre code{background-color:rgba(0,0,0,0);color:inherit}@media (prefers-color-scheme: dark){.sourcehut{filter:invert(100%)}body{background-color:#222;color:#fff}strong{color:#fff}h1,h2,h3,h4,h5,h6{color:#fff}a small{color:#fff}}footer>a>img{max-height:20px}
633\ No newline at end of file
634 diff --git a/public/webfinger-project/index.html b/public/webfinger-project/index.html
635new file mode 100644
636index 0000000..7392b92
637--- /dev/null
638+++ b/public/webfinger-project/index.html
639 @@ -0,0 +1,297 @@
640+ <!DOCTYPE html>
641+ <html lang="en-US">
642+ <head>
643+ <meta charset="UTF-8" />
644+ <meta http-equiv="X-UA-Compatible" content="IE=edge" />
645+ <meta name="viewport" content="width=device-width, initial-scale=1" />
646+ <title></title>
647+ <meta
648+ name="description"
649+ itemprop="about"
650+ content="ForgeFeed Specifications"
651+ />
652+ <link rel="stylesheet" href="https://forge-feed.org/styles.css" />
653+ </head>
654+
655+ <body>
656+ <div class="wrapper">
657+ <header>
658+ <a href="https://forge-feed.org">
659+ <img
660+ src="https://forge-feed.org/img/logo.svg"
661+ class="site-logo"
662+ alt="Logo"
663+ width="275px"
664+ height="auto"
665+ /></a>
666+
667+ <p>ForgeFeed Specifications</p>
668+
669+
670+ <a href="https://codeberg.org/ayllu/forge-feed">
671+ <img
672+ src="https://forge-feed.org/img/codeberg.svg"
673+ class="site-logo"
674+ alt="Codeberg Logo"
675+ />
676+ </a>
677+
678+ <a href="https://git.sr.ht/~kevinschoon/forge-feed">
679+ <img
680+ src="https://forge-feed.org/img/sourcehut.svg"
681+ class="site-logo sourcehut"
682+ alt="Sourcehut Logo"
683+ />
684+ </a>
685+
686+
687+
688+ </header>
689+
690+ <section>
691+ <h1>Project Discovery via WebFinger</h1>
692+ <p>A project refers to a software project which may contain multiple repositories
693+ as well as other resources such as mailing lists, bug trackers, links to
694+ chatrooms, etc. NOTE that some forges do not make a distinction between a
695+ project and a repository. If your forge does not then you MAY choose to expose
696+ repositories as a project with a single repository resource link.</p>
697+ <h1 id="project-uri">Project URI</h1>
698+ <p>A project URI identifies a software project and optionally the host that is
699+ resides on. This value is similar to
700+ <a href="https://datatracker.ietf.org/doc/html/rfc7565">RFC7565</a>. The slug and hostname
701+ part MUST match the URI path specification as defined in
702+ <a href="https://www.rfc-editor.org/rfc/rfc3986#section-3.3">RFC3986-3.3</a> while the
703+ hostname, if specified, must match
704+ <a href="https://www.rfc-editor.org/rfc/rfc3986#section-3.2.2">RFC3986-3.2.2</a>.</p>
705+ <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>project-uri = prefix slug hostname
706+ </span><span>
707+ </span><span>prefix = &quot;project:&quot;
708+ </span><span>slug = rfc3986-path
709+ </span><span>hostname = [@ rfc3986-hostname]
710+ </span></code></pre>
711+ <h3 id="slug">Slug</h3>
712+ <p>The Slug represents a unique string that identifies a project at a particular code forge.</p>
713+ <h3 id="hostname">Hostname</h3>
714+ <p>If the hostname part is missing then the address of the server receiving the
715+ query is assumed. For example the following two queries are equivalent:</p>
716+ <pre data-lang="text" style="background-color:#2b303b;color:#c0c5ce;" class="language-text "><code class="language-text" data-lang="text"><span>https://example.org/.well-known/webfinger?resource=project:spartacus
717+ </span><span>https://example.org/.well-known/webfinger?resource=project:spartacus@example.org
718+ </span></code></pre>
719+ <p>TODO: Make this an actual spec, for now, some Python:</p>
720+ <pre data-lang="python" style="background-color:#2b303b;color:#c0c5ce;" class="language-python "><code class="language-python" data-lang="python"><span style="color:#b48ead;">from </span><span>urllib.parse </span><span style="color:#b48ead;">import </span><span>urlparse, quote_plus
721+ </span><span>
722+ </span><span style="color:#b48ead;">def </span><span style="color:#8fa1b3;">from_string</span><span>(</span><span style="color:#bf616a;">text</span><span>):
723+ </span><span> url = </span><span style="color:#bf616a;">urlparse</span><span>(text)
724+ </span><span> </span><span style="color:#b48ead;">if </span><span>not url.path:
725+ </span><span> </span><span style="color:#b48ead;">return </span><span>(</span><span style="color:#d08770;">None</span><span>, </span><span style="color:#d08770;">None</span><span>)
726+ </span><span> split = url.path.</span><span style="color:#bf616a;">split</span><span>(&quot;</span><span style="color:#a3be8c;">@</span><span>&quot;, </span><span style="color:#d08770;">1</span><span>)
727+ </span><span> </span><span style="color:#b48ead;">if </span><span style="color:#96b5b4;">len</span><span>(split) == </span><span style="color:#d08770;">2</span><span>:
728+ </span><span> </span><span style="color:#b48ead;">return </span><span>(split[</span><span style="color:#d08770;">0</span><span>], split[</span><span style="color:#d08770;">1</span><span>])
729+ </span><span> </span><span style="color:#b48ead;">return </span><span>(split[</span><span style="color:#d08770;">0</span><span>], </span><span style="color:#d08770;">None</span><span>)
730+ </span><span>
731+ </span><span style="color:#b48ead;">def </span><span style="color:#8fa1b3;">to_string</span><span>(</span><span style="color:#bf616a;">slug</span><span>, </span><span style="color:#bf616a;">domain</span><span>=</span><span style="color:#d08770;">None</span><span>):
732+ </span><span> </span><span style="color:#b48ead;">if </span><span>domain:
733+ </span><span> </span><span style="color:#b48ead;">return </span><span style="color:#bf616a;">quote_plus</span><span>(</span><span style="color:#b48ead;">f</span><span>&quot;</span><span style="color:#a3be8c;">project:</span><span>{slug}</span><span style="color:#a3be8c;">@</span><span>{domain}&quot;)
734+ </span><span> </span><span style="color:#b48ead;">else</span><span>:
735+ </span><span> </span><span style="color:#b48ead;">return </span><span style="color:#bf616a;">quote_plus</span><span>(</span><span style="color:#b48ead;">f</span><span>&quot;</span><span style="color:#a3be8c;">project:</span><span>{slug}&quot;)
736+ </span></code></pre>
737+ <h3 id="properties">Properties</h3>
738+ <h4 id="http-forge-feed-org-rel-repository">http://forge-feed.org/rel/repository</h4>
739+ <p>Reference to a VCS managed code repository.</p>
740+ <h4 id="http-feed-forge-org-ns-chatroom">http://feed-forge.org/ns/chatroom</h4>
741+ <p>Hint describing the backing type of chatroom. See <a href="https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml">uri-schemes</a>.</p>
742+ <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>matrix
743+ </span><span>irc
744+ </span><span>xmpp
745+ </span></code></pre>
746+ <h3 id="link-extension-types">Link Extension Types</h3>
747+ <h4 id="avatar">Avatar</h4>
748+ <p>Forges that allow users to configure a logo can expose this information as
749+ an avatar for use in other applications.</p>
750+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
751+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://webfinger.net/rel/avatar</span><span>&quot;,
752+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/stylized-logo.png</span><span>&quot;
753+ </span><span>}
754+ </span></code></pre>
755+ <h4 id="homepage">Homepage</h4>
756+ <p>Link to an HTTP representation of the project homepage.</p>
757+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
758+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/rel/homepage</span><span>&quot;,
759+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/example/spartacus</span><span>&quot;
760+ </span><span>}
761+ </span></code></pre>
762+ <h4 id="description">Description</h4>
763+ <p>A short text representation of the project.</p>
764+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
765+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://example.org/rel/description</span><span>&quot;,
766+ </span><span> &quot;</span><span style="color:#a3be8c;">titles</span><span>&quot;: {
767+ </span><span> &quot;</span><span style="color:#a3be8c;">en-us</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">A Text Adventure Written in FORTRAN 77</span><span>&quot;,
768+ </span><span> &quot;</span><span style="color:#a3be8c;">es</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">Una Aventura de Texto Escrita en FORTRAN 77</span><span>&quot;
769+ </span><span> }
770+ </span><span>}
771+ </span></code></pre>
772+ <h4 id="chat-links">Chat Links</h4>
773+ <p>Links to chatrooms: IRC, Matrix, XMPP, etc.</p>
774+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
775+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/rel/chatroom</span><span>&quot;,
776+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">ircs://irc.libera.chat/#spartacus-game</span><span>&quot;,
777+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
778+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/chatroom</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">irc</span><span>&quot;
779+ </span><span> }
780+ </span><span>}
781+ </span></code></pre>
782+ <h4 id="mailing-lists">Mailing Lists</h4>
783+ <p>Links to associated mailing lists, forms, etc.</p>
784+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
785+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/rel/mailing-list</span><span>&quot;,
786+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">mailto://list-name@mail.example.org</span><span>&quot;,
787+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
788+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/mailing-list-subscribe</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">mailto://subscribe+list-name@mail.example.org</span><span>&quot;,
789+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/mailing-list-unsubscribe</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">mailto://unsubscribe+list-name@mail.example.org</span><span>&quot;
790+ </span><span> }
791+ </span><span>}
792+ </span></code></pre>
793+ <h4 id="ticketing-systems">Ticketing Systems</h4>
794+ <p>Links to issue tracking systems.</p>
795+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
796+ </span><span> &quot;</span><span style="color:#a3be8c;">ref</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/ticketing-system</span><span>&quot;,
797+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/bugs</span><span>&quot;,
798+ </span><span>}
799+ </span></code></pre>
800+ <h4 id="repository-links">Repository Links</h4>
801+ <p>Links of code repositories associated with this software project.</p>
802+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
803+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://example.org/rel/repository</span><span>&quot;,
804+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/example/spartacus</span><span>&quot;,
805+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
806+ </span><span> &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">repository:example/spartacus</span><span>&quot;
807+ </span><span> }
808+ </span><span>}
809+ </span></code></pre>
810+ <h2 id="example-multi-repository-query">Example Multi-Repository Query</h2>
811+ <p>A <a href="https://webfinger.net/spec/">WebFinger</a> query may be used to identify
812+ detailed information about a public repository at a particular forge. Here is
813+ an example response about a fictitious project which has two code repositories
814+ associated with it as well as chat links, and a bug tracking system.</p>
815+ <p><code>GET https://example.org/.well-known/webfinger?resource=project:spartacus</code></p>
816+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
817+ </span><span> &quot;</span><span style="color:#a3be8c;">subject</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">project:spartacus</span><span>&quot;,
818+ </span><span> &quot;</span><span style="color:#a3be8c;">aliases</span><span>&quot;: [
819+ </span><span> &quot;</span><span style="color:#a3be8c;">https://example.org</span><span>&quot;
820+ </span><span> ],
821+ </span><span> &quot;</span><span style="color:#a3be8c;">links</span><span>&quot;: [
822+ </span><span> {
823+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://webfinger.net/rel/avatar</span><span>&quot;,
824+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/stylized-logo.png</span><span>&quot;
825+ </span><span> },
826+ </span><span> {
827+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/rel/homepage</span><span>&quot;,
828+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://code.example.org/spartacus</span><span>&quot;
829+ </span><span> },
830+ </span><span> {
831+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/description</span><span>&quot;,
832+ </span><span> &quot;</span><span style="color:#a3be8c;">titles</span><span>&quot;: {
833+ </span><span> &quot;</span><span style="color:#a3be8c;">en-us</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">A Text Adventure Written in FORTRAN 77</span><span>&quot;,
834+ </span><span> &quot;</span><span style="color:#a3be8c;">es</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">Una Aventura de Texto Escrita en FORTRAN 77</span><span>&quot;
835+ </span><span> }
836+ </span><span> },
837+ </span><span> {
838+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/chatroom</span><span>&quot;,
839+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">ircs://irc.libera.chat/#spartacus-game</span><span>&quot;,
840+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
841+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/chatroom</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">irc</span><span>&quot;
842+ </span><span> }
843+ </span><span> },
844+ </span><span> {
845+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/ticketing-system</span><span>&quot;,
846+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/bugs</span><span>&quot;
847+ </span><span> },
848+ </span><span> {
849+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/label</span><span>&quot;,
850+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
851+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/label</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">fortran</span><span>&quot;
852+ </span><span> }
853+ </span><span> },
854+ </span><span> {
855+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/label</span><span>&quot;,
856+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
857+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/label</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">text-adventure</span><span>&quot;
858+ </span><span> }
859+ </span><span> },
860+ </span><span> {
861+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository</span><span>&quot;,
862+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://code.example.org/spartacus/spartan-engine</span><span>&quot;,
863+ </span><span> &quot;</span><span style="color:#a3be8c;">titles</span><span>&quot;: {
864+ </span><span> &quot;</span><span style="color:#a3be8c;">en-us</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">The Spartan Game Engine</span><span>&quot;
865+ </span><span> },
866+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
867+ </span><span> &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository-uri</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">repository:spartacus/game-engine</span><span>&quot;
868+ </span><span> }
869+ </span><span> },
870+ </span><span> {
871+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository</span><span>&quot;,
872+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://code.example.org/spartacus/game</span><span>&quot;,
873+ </span><span> &quot;</span><span style="color:#a3be8c;">titles</span><span>&quot;: {
874+ </span><span> &quot;</span><span style="color:#a3be8c;">en-us</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">Implementation of the Spartacus Text Adventure game</span><span>&quot;
875+ </span><span> },
876+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
877+ </span><span> &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository-uri</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">repository:spartacus/game</span><span>&quot;
878+ </span><span> }
879+ </span><span> },
880+ </span><span> {
881+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository</span><span>&quot;,
882+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://code.example.org/spartacus/game</span><span>&quot;,
883+ </span><span> &quot;</span><span style="color:#a3be8c;">titles</span><span>&quot;: {
884+ </span><span> &quot;</span><span style="color:#a3be8c;">en-us</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">Promotional Website for the Spartacus Game</span><span>&quot;
885+ </span><span> },
886+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
887+ </span><span> &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository-uri</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">repository:spartacus/www</span><span>&quot;
888+ </span><span> }
889+ </span><span> }
890+ </span><span> ]
891+ </span><span>}
892+ </span></code></pre>
893+ <h2 id="example-single-repository-query">Example Single Repository Query</h2>
894+ <p>Here is an example of a project with only a single repository associated with it.</p>
895+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
896+ </span><span> &quot;</span><span style="color:#a3be8c;">subject</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">project:fuu/bar</span><span>&quot;,
897+ </span><span> &quot;</span><span style="color:#a3be8c;">links</span><span>&quot;: [
898+ </span><span> {
899+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository</span><span>&quot;,
900+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://code.example.org/fuu/bar</span><span>&quot;,
901+ </span><span> &quot;</span><span style="color:#a3be8c;">titles</span><span>&quot;: {
902+ </span><span> &quot;</span><span style="color:#a3be8c;">en-us</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">Baz Qux</span><span>&quot;
903+ </span><span> },
904+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
905+ </span><span> &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/repository-uri</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">repository:fuu/bar</span><span>&quot;
906+ </span><span> }
907+ </span><span> }
908+ </span><span> ]
909+ </span><span>}
910+ </span></code></pre>
911+ <h3 id="security">Security</h3>
912+ <p>Projects which are not publicly available should not be identifiable by
913+ making webfinger queries at all. A project which is private MUST return
914+ the same response as a repository which does not exist when making a webfinger
915+ request.</p>
916+ <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>GET https://example.org/.well-known/webfinger?resource=project:example/spartacus
917+ </span><span>200
918+ </span><span>GET https://example.org/.well-known/webfinger?resource=project:example/private-project
919+ </span><span>404
920+ </span><span>GET https://example.org/.well-known/webfinger?resource=project:example/non-existent-project
921+ </span><span>404
922+ </span></code></pre>
923+
924+ </section>
925+
926+ <footer>
927+ <a href="/LICENSE.txt">
928+ <img
929+ src="https://forge-feed.org/img/cc0.png"
930+ alt="cc0 logo"
931+ />
932+ </a>
933+ </footer>
934+ </div>
935+ </body>
936+ </html>
937 diff --git a/public/webfinger-repository/index.html b/public/webfinger-repository/index.html
938new file mode 100644
939index 0000000..f2e5819
940--- /dev/null
941+++ b/public/webfinger-repository/index.html
942 @@ -0,0 +1,233 @@
943+ <!DOCTYPE html>
944+ <html lang="en-US">
945+ <head>
946+ <meta charset="UTF-8" />
947+ <meta http-equiv="X-UA-Compatible" content="IE=edge" />
948+ <meta name="viewport" content="width=device-width, initial-scale=1" />
949+ <title></title>
950+ <meta
951+ name="description"
952+ itemprop="about"
953+ content="ForgeFeed Specifications"
954+ />
955+ <link rel="stylesheet" href="https://forge-feed.org/styles.css" />
956+ </head>
957+
958+ <body>
959+ <div class="wrapper">
960+ <header>
961+ <a href="https://forge-feed.org">
962+ <img
963+ src="https://forge-feed.org/img/logo.svg"
964+ class="site-logo"
965+ alt="Logo"
966+ width="275px"
967+ height="auto"
968+ /></a>
969+
970+ <p>ForgeFeed Specifications</p>
971+
972+
973+ <a href="https://codeberg.org/ayllu/forge-feed">
974+ <img
975+ src="https://forge-feed.org/img/codeberg.svg"
976+ class="site-logo"
977+ alt="Codeberg Logo"
978+ />
979+ </a>
980+
981+ <a href="https://git.sr.ht/~kevinschoon/forge-feed">
982+ <img
983+ src="https://forge-feed.org/img/sourcehut.svg"
984+ class="site-logo sourcehut"
985+ alt="Sourcehut Logo"
986+ />
987+ </a>
988+
989+
990+
991+ </header>
992+
993+ <section>
994+ <h1>Repository Discovery via WebFinger</h1>
995+ <p>A repository refers to a version control managed source code which may be
996+ browsed over HTTP or downloaded with specific tooling.</p>
997+ <h2 id="repository-uri">Repository URI</h2>
998+ <p>A repository URI identifies a code repository and optionally the host that is
999+ resides on. This value is similar to
1000+ <a href="https://datatracker.ietf.org/doc/html/rfc7565">RFC7565</a>. The slug and hostname
1001+ part MUST match the URI path specification as defined in
1002+ <a href="https://www.rfc-editor.org/rfc/rfc3986#section-3.3">RFC3986-3.3</a> while the
1003+ hostname, if specified, must match
1004+ <a href="https://www.rfc-editor.org/rfc/rfc3986#section-3.2.2">RFC3986-3.2.2</a></p>
1005+ <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>repository-uri = prefix slug hostname
1006+ </span><span>
1007+ </span><span>prefix = &quot;repository:&quot;
1008+ </span><span>slug = rfc3986-path
1009+ </span><span>hostname = [@ rfc3986-hostname]
1010+ </span></code></pre>
1011+ <h3 id="slug">Slug</h3>
1012+ <p>The Slug represents a unique string that identifies a repository at a
1013+ particular code forge. Repository refers to a VCS managed codebase of some
1014+ kind, e.g. a Git repository.</p>
1015+ <h3 id="hostname">Hostname</h3>
1016+ <p>If the hostname part is missing then the address of the server receiving the
1017+ query is assumed. For example the following two queries are equivalent:</p>
1018+ <pre data-lang="text" style="background-color:#2b303b;color:#c0c5ce;" class="language-text "><code class="language-text" data-lang="text"><span>https://example.org/.well-known/webfinger?resource=repository:spartacus/game
1019+ </span><span>https://example.org/.well-known/webfinger?resource=repository:spartacus/game@example.org
1020+ </span></code></pre>
1021+ <p>TODO: Make this an actual spec, for now, some Python:</p>
1022+ <pre data-lang="python" style="background-color:#2b303b;color:#c0c5ce;" class="language-python "><code class="language-python" data-lang="python"><span style="color:#b48ead;">from </span><span>urllib.parse </span><span style="color:#b48ead;">import </span><span>urlparse, quote_plus
1023+ </span><span>
1024+ </span><span style="color:#b48ead;">def </span><span style="color:#8fa1b3;">from_string</span><span>(</span><span style="color:#bf616a;">text</span><span>):
1025+ </span><span> url = </span><span style="color:#bf616a;">urlparse</span><span>(text)
1026+ </span><span> </span><span style="color:#b48ead;">if </span><span>not url.path:
1027+ </span><span> </span><span style="color:#b48ead;">return </span><span>(</span><span style="color:#d08770;">None</span><span>, </span><span style="color:#d08770;">None</span><span>)
1028+ </span><span> split = url.path.</span><span style="color:#bf616a;">split</span><span>(&quot;</span><span style="color:#a3be8c;">@</span><span>&quot;, </span><span style="color:#d08770;">1</span><span>)
1029+ </span><span> </span><span style="color:#b48ead;">if </span><span style="color:#96b5b4;">len</span><span>(split) == </span><span style="color:#d08770;">2</span><span>:
1030+ </span><span> </span><span style="color:#b48ead;">return </span><span>(split[</span><span style="color:#d08770;">0</span><span>], split[</span><span style="color:#d08770;">1</span><span>])
1031+ </span><span> </span><span style="color:#b48ead;">return </span><span>(split[</span><span style="color:#d08770;">0</span><span>], </span><span style="color:#d08770;">None</span><span>)
1032+ </span><span>
1033+ </span><span style="color:#b48ead;">def </span><span style="color:#8fa1b3;">to_string</span><span>(</span><span style="color:#bf616a;">slug</span><span>, </span><span style="color:#bf616a;">domain</span><span>=</span><span style="color:#d08770;">None</span><span>):
1034+ </span><span> </span><span style="color:#b48ead;">if </span><span>domain:
1035+ </span><span> </span><span style="color:#b48ead;">return </span><span style="color:#bf616a;">quote_plus</span><span>(</span><span style="color:#b48ead;">f</span><span>&quot;</span><span style="color:#a3be8c;">repository:</span><span>{slug}</span><span style="color:#a3be8c;">@</span><span>{domain}&quot;)
1036+ </span><span> </span><span style="color:#b48ead;">else</span><span>:
1037+ </span><span> </span><span style="color:#b48ead;">return </span><span style="color:#bf616a;">quote_plus</span><span>(</span><span style="color:#b48ead;">f</span><span>&quot;</span><span style="color:#a3be8c;">repository:</span><span>{slug}&quot;)
1038+ </span></code></pre>
1039+ <h3 id="properties">Properties</h3>
1040+ <h4 id="http-feed-forge-org-ns-vcs-type">http://feed-forge.org/ns/vcs-type</h4>
1041+ <p>Identifies VCS types, valid strings are:</p>
1042+ <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>bzr (GNU Bazaar) bazaar.canonical.com
1043+ </span><span>darcs (Darcs) darcs.net
1044+ </span><span>fossil (Fossil) fossil-scm.org
1045+ </span><span>git (Git) git-scm.com
1046+ </span><span>hg (Mercurial) mercurial-scm.org
1047+ </span><span>pijul (Pijul) pijul.org
1048+ </span><span>svn (Apache Subversion) subversion.apache.org
1049+ </span></code></pre>
1050+ <h4 id="http-feed-forge-org-ns-spdx-identifier">http://feed-forge.org/ns/spdx-identifier</h4>
1051+ <p>Refers to a valid SPDX identifier, see <a href="https://spdx.org/licenses/">license-list</a></p>
1052+ <h3 id="link-extension-types">Link Extension Types</h3>
1053+ <h4 id="avatar">Avatar</h4>
1054+ <p>Forges that allow users to configure a logo can expose this information as
1055+ an avatar for use in other applications.</p>
1056+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
1057+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://webfinger.net/rel/avatar</span><span>&quot;,
1058+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/stylized-logo.png</span><span>&quot;
1059+ </span><span>}
1060+ </span></code></pre>
1061+ <h4 id="homepage">Homepage</h4>
1062+ <p>Link to an HTTP representation of the repository.</p>
1063+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
1064+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/rel/homepage</span><span>&quot;,
1065+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/spartacus/game</span><span>&quot;
1066+ </span><span>}
1067+ </span></code></pre>
1068+ <h4 id="description">Description</h4>
1069+ <p>A short text representation of the repository.</p>
1070+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
1071+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://example.org/rel/description</span><span>&quot;,
1072+ </span><span> &quot;</span><span style="color:#a3be8c;">titles</span><span>&quot;: {
1073+ </span><span> &quot;</span><span style="color:#a3be8c;">en-us</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">A Text Adventure Written in FORTRAN 77</span><span>&quot;,
1074+ </span><span> &quot;</span><span style="color:#a3be8c;">es</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">Una Aventura de Texto Escrita en FORTRAN 77</span><span>&quot;
1075+ </span><span> }
1076+ </span><span>}
1077+ </span></code></pre>
1078+ <h4 id="license">License</h4>
1079+ <p>A license SPDX identifier and link to the license's full text.</p>
1080+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
1081+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/rel/license</span><span>&quot;,
1082+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.com/example/spartacus/tree/LICENSE</span><span>&quot;,
1083+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
1084+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/spdx-identifier</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">GPL-2.0-or-later</span><span>&quot;
1085+ </span><span> }
1086+ </span><span>}
1087+ </span></code></pre>
1088+ <h4 id="clone-links">Clone Links</h4>
1089+ <p>Clone links define how one can download a copy of the remote
1090+ software onto their own server.</p>
1091+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
1092+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/rel/clone</span><span>&quot;,
1093+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/example/spartacus</span><span>&quot;,
1094+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
1095+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/vcs-type</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">git</span><span>&quot;
1096+ </span><span> }
1097+ </span><span>}
1098+ </span></code></pre>
1099+ <h2 id="webfinger-query">WebFinger Query</h2>
1100+ <p>A <a href="https://webfinger.net/spec/">WebFinger</a> query may be used to identify
1101+ detailed information about a public repository at a particular forge. Here is
1102+ an example response about a fictitious repository:</p>
1103+ <p><code>GET https://example.org/.well-known/webfinger?resource=repository:spartacus/game</code></p>
1104+ <pre data-lang="json" style="background-color:#2b303b;color:#c0c5ce;" class="language-json "><code class="language-json" data-lang="json"><span>{
1105+ </span><span> &quot;</span><span style="color:#a3be8c;">subject</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">repository:spartacus/game</span><span>&quot;,
1106+ </span><span> &quot;</span><span style="color:#a3be8c;">aliases</span><span>&quot;: [
1107+ </span><span> &quot;</span><span style="color:#a3be8c;">https://example.org/spartacus/game</span><span>&quot;
1108+ </span><span> ],
1109+ </span><span> &quot;</span><span style="color:#a3be8c;">links</span><span>&quot;: [
1110+ </span><span> {
1111+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://webfinger.net/rel/avatar</span><span>&quot;,
1112+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/stylized-logo.png</span><span>&quot;
1113+ </span><span> },
1114+ </span><span> {
1115+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/description</span><span>&quot;,
1116+ </span><span> &quot;</span><span style="color:#a3be8c;">titles</span><span>&quot;: {
1117+ </span><span> &quot;</span><span style="color:#a3be8c;">en-us</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">A Text Adventure Written in FORTRAN 77</span><span>&quot;,
1118+ </span><span> &quot;</span><span style="color:#a3be8c;">es</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">Una Aventura de Texto Escrita en FORTRAN 77</span><span>&quot;
1119+ </span><span> }
1120+ </span><span> },
1121+ </span><span> {
1122+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/rel/clone</span><span>&quot;,
1123+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.org/spartacus/game</span><span>&quot;,
1124+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
1125+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/vcs-type</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">git</span><span>&quot;
1126+ </span><span> }
1127+ </span><span> },
1128+ </span><span> {
1129+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/license</span><span>&quot;,
1130+ </span><span> &quot;</span><span style="color:#a3be8c;">href</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">https://example.com/spartacus/game/tree/LICENSE</span><span>&quot;,
1131+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
1132+ </span><span> &quot;</span><span style="color:#a3be8c;">spdx-identifier</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">GPL-2.0-or-later</span><span>&quot;
1133+ </span><span> }
1134+ </span><span> },
1135+ </span><span> {
1136+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/label</span><span>&quot;,
1137+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
1138+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/label</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">fortran</span><span>&quot;
1139+ </span><span> }
1140+ </span><span> },
1141+ </span><span> {
1142+ </span><span> &quot;</span><span style="color:#a3be8c;">rel</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">http://forge-feed.org/rel/label</span><span>&quot;,
1143+ </span><span> &quot;</span><span style="color:#a3be8c;">properties</span><span>&quot;: {
1144+ </span><span> &quot;</span><span style="color:#a3be8c;">http://feed-forge.org/ns/label</span><span>&quot;: &quot;</span><span style="color:#a3be8c;">text-adventure</span><span>&quot;
1145+ </span><span> }
1146+ </span><span> }
1147+ </span><span> ]
1148+ </span><span>}
1149+ </span></code></pre>
1150+ <h3 id="security">Security</h3>
1151+ <p>Repositories which are not publicly available should not be identifiable by
1152+ making webfinger queries at all. A repository which is private MUST return
1153+ the same response as a repository which does not exist when making a webfinger
1154+ request.</p>
1155+ <pre style="background-color:#2b303b;color:#c0c5ce;"><code><span>GET https://example.org/.well-known/webfinger?resource=repository:spartacus/game
1156+ </span><span>200
1157+ </span><span>GET https://example.org/.well-known/webfinger?resource=repository:example/private-repository
1158+ </span><span>404
1159+ </span><span>GET https://example.org/.well-known/webfinger?resource=repository:example/non-existent-repository
1160+ </span><span>404
1161+ </span></code></pre>
1162+
1163+ </section>
1164+
1165+ <footer>
1166+ <a href="/LICENSE.txt">
1167+ <img
1168+ src="https://forge-feed.org/img/cc0.png"
1169+ alt="cc0 logo"
1170+ />
1171+ </a>
1172+ </footer>
1173+ </div>
1174+ </body>
1175+ </html>