Okay/Spec: Difference between revisions
No edit summary |
|||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 23: | Line 23: | ||
== controversies == | == controversies == | ||
* <s>What “server” means is kind of nebulous.</s> | * <s>What “server” means is kind of nebulous.</s> | ||
* What do we do about invalid HTML? | * What do we do about invalid HTML? | ||
| Line 140: | Line 139: | ||
|- | |- | ||
|<code>ok-title</code> | |<code>ok-title</code> | ||
|Any non-void element, <code><nowiki><h1 /></nowiki></code>preferred. | |Any non-void element, <code><nowiki><h1 /></nowiki></code> preferred. | ||
|What the space is called in common parlance. | |What the space is called in common parlance. | ||
|- | |- | ||
|<code>ok-subtitle</code> | |<code>ok-subtitle</code> | ||
|Any non-void element, <code><nowiki><p /></nowiki></code>preferred. | |Any non-void element, <code><nowiki><p /></nowiki></code> preferred. | ||
|An extra bit of text that is displayed alongside the title in certain contexts. | |An extra bit of text that is displayed alongside the title in certain contexts. | ||
|- | |- | ||
|<code>ok-description</code> | |<code>ok-description</code> | ||
|Any non-void element, <code><nowiki><p /></nowiki></code>preferred. | |Any non-void element, <code><nowiki><p /></nowiki></code> preferred. | ||
|A long description of what the space is about. | |A long description of what the space is about. | ||
|} | |} | ||
| Line 164: | Line 163: | ||
The registration page allows clients to register their public key and [[Okay/Spec#profiles|profile]] with the space. | The registration page allows clients to register their public key and [[Okay/Spec#profiles|profile]] with the space. | ||
== | == directory == | ||
The ''' | The '''room directory''' is represented using the <code>ok-rooms</code> [[Okay/Spec#michaelformats|michaelformat]]. It contains the list of every room in a space. This list <span class="may">may</span> be [[Okay/Spec#pagination|paginated]]. | ||
A space's room directory <span class="must">must</span> be present in its [[Okay/Spec#ok-space|ok-space]] element, either [[Okay/Spec#linking to stuff|linked]] using the <code>ok-rooms</code> rel value or included inline. | |||
Each room in the space <span class="must">must</span> be linked with a single <code><a /></code> element with the <code>ok-room</code> rel value. Rooms <span class="mustnt">must not</span> be included inline in the room directory. | |||
Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms"> | Here's an example of what a room directory might look like:<syntaxhighlight lang="html"><main class="ok-rooms"> | ||
| Line 185: | Line 184: | ||
== messages == | == messages == | ||
== profiles == | == profiles == | ||
== subscriptions == | == [https://www.youtube.com/shorts/IIISJgeTyPk subscriptions] == | ||
== settings == | == settings == | ||
== pagination == | == pagination == | ||