Commit

Author:

Hash:

Timestamp:

+28 -1 +/-2 browse

Kevin Schoon [me@kevinschoon.com]

3e14e0d38b4b69a2c4ab0c1eb22fdf34edd43774

Sun, 16 Nov 2025 10:42:45 +0000 (23 hours ago)

add meta-tag specification
add meta-tag specification

Adds a simple specification for including a meta-tag in HTML content to
indicate a reference to a forge-feed enabled project or repository.
1diff --git a/content/_index.md b/content/_index.md
2index 16c1abf..6d1a0dd 100644
3--- a/content/_index.md
4+++ b/content/_index.md
5 @@ -4,7 +4,7 @@ title: Forge-Feed
6
7 **Please note that these specifications are currently PROVISIONAL
8 and should not be implemented. This specification is not endorsed or
9- supported by any particular organization entity.**
10+ supported by any particular organizational entity.**
11
12 ForgeFeed is a collection of specifications and recommendations which when
13 implemented can enhance interoperability and content discovery of different
14 @@ -20,3 +20,4 @@ The following specifications are currently covered:
15 * [WebFinger Project Identification](/webfinger-project) - Identify Software Projects via WebFinger
16 * [WebFinger Repository Identification](/webfinger-repository) - Identify VCS Repository Content via WebFinger
17 * [Atom Feed Project Discovery](/project-atom-feed) - Subscribe to a forge over Atom
18+ * [ForgeFeed Site Identifier](/meta-tag) - HTML Meta Tag Indicating ForgeFeed Capabilities
19 diff --git a/content/meta-tag.md b/content/meta-tag.md
20new file mode 100644
21index 0000000..886fa44
22--- /dev/null
23+++ b/content/meta-tag.md
24 @@ -0,0 +1,26 @@
25+ ---
26+ title: ForgeFeed Identifier
27+ ---
28+ The ForgeFeed identifier is a simple HTML [meta tag](https://html.spec.whatwg.org/multipage/semantics.html#the-meta-element)
29+ which provides a reference to a particular forge-feed enabled project.
30+ Including a `forge-feed:project` or `forge-feed:repository` tag in a given HTML page
31+ provides a reference to a codebase or project page which can be used to construct
32+ a webfinger query. Using the forge-feed identifier indicates that a given HTML
33+ page is associated with a certain software project.
34+
35+ ## Tags
36+
37+ ### forge-feed
38+
39+ The content of a forge-feed:project tag MUST contain a valid [project-uri](/webfinger-project)
40+ or [repository-uri](/webfinger-repository). If a hostname is not part of the project-uri
41+ then the host is assumed to be at the domain which is serving the content.
42+
43+ ```html
44+ <!-- Project on the same host -->
45+ <meta name="forge-feed" content="project:spartacus"/>
46+ <!-- Or another host -->
47+ <meta name="forge-feed" content="project:spartacus@example.org"/>
48+ <!-- Or a repository link -->
49+ <meta name="forge-feed" content="repository:spartacus@code.example.org"/>
50+ ```