💾 Archived View for mozz.us › files › rfc_gemini_favicon.gmi captured on 2024-03-21 at 15:09:39. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2022-04-27)
-=-=-=-=-=-=-
From: Michael Lazar (lazar.michael22@gmail.com)
Date: Wednesday, 3 June 2020
Updated: Tuesday, 26 Feb 2021 (Added motivation)
Status: DRAFT
To spread a bit of joy around geminispace.
Emojis are an official part of the unicode standard and are widely used in modern communication.
As of the Unicode Standard, Version 13.0.0, there are 3,304 emoji characters in total [1].
Compared to web favicons which primarily use image formats, they are:
[1] https://unicode.org/emoji/charts/emoji-counts.html
This RFC defines a "server" as the domain[:port] component of a gemini URL. This is typically the same as the server host, but may be different in the case of gemini proxy requests. URLs with subdomains are treated as separate servers, even though they may resolve to the same IP address. For example, "gemini://foo.example.com" and "gemini://example.com" are to be considered distinct servers with distinct favicon files.
Gemini servers MAY expose a favicon resource. If exposed, the favicon MUST reside in the root of the server directory under the path "/favicon.txt". A gemini request to this resource MUST return a standard gemini response with code "20" and a mime type of "text/plain". The response MAY include a charset and other extra meta components, as defined in the gemini protocol.
Gemini clients MAY request the favicon resource from a gemini server. A gemini client MUST NOT treat the absence of a favicon as an error. If a server does not expose a favicon, the client might handle this by leaving the area where the favicon would usually be displayed blank, or by using a "placeholder" favicon.
Gemini clients MUST cache the response from a favicon request for at least one hour, or the duration that the application is running, whichever is shorter. This is intended to reduce unnecessary server load by limiting repeated requests to the same resource.
Interactive gemini clients SHALL NOT request the favicon until the user has clicked on a URL corresponding to that server. In other words, a client cannot attempt to pre-fetch the favicon resource before the user has actively navigated to the page.
The format for a favicon document {F} is defined as follows. Brackets [] indicate optional elements:
{F} ::= {E}[{C}]
{E} ::= emoji
{C} ::= [<CR>]<LF>
An emoji is a single unicode character or character sequence as defined by the Unicode Consortium [2][3]. This includes sequences using modifiers such as skin tones, when they are applied to other emoji characters.
[2] http://www.unicode.org/emoji/charts/full-emoji-list.html
[3] https://www.unicode.org/emoji/charts/full-emoji-modifiers.html
The document may optionally end in a newline {C}. This is intended to make it easier to author favicon documents, since many text editors will automatically insert a newline at the end of a file. The newline does not contain any semantic meaning and MUST be removed by the client before rendering the favicon.
Gemini clients SHALL NOT render any favicon that does not conform to the specified format. This includes non-emoji unicode characters, and strings of multiple emoji characters that are not used as modifiers.
1. The user attempts to load a gemini URL.
gemini://gemini.example.com/files/about.txt
2. The gemini client first checks for a favicon by sending a separate request to the server.
gemini://gemini.example.com/favicon.txt
3. The server responds with a successful status and the emoji character for "eggplant".
20 text/plain 🍆
4. The client caches the favicon response for the "gemini.example.com" domain.
5. The client loads the initial URL and displays the favicon on the page.
1. The user attempts to load a gemini URL.
gemini://gemini.example.com/files/about.txt
2. The gemini client first checks for a favicon by sending a separate request to the server.
gemini://gemini.example.com/favicon.txt
3. The server responds with an error status.
51 The requested resource was not found
4. The client caches response indicating that the domain "gemini.example.com" does not contain a favicon.
5. The client loads the initial URL and displays the page without a favicon.