💾 Archived View for jb55.com › ward.asia.wiki.org › federating-foreign-servers captured on 2022-01-08 at 14:02:37. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2021-12-04)
-=-=-=-=-=-=-
We consider what requests a server must handle in order to participate in wiki's federation. Such a server provides pages without taking responsibility for the client-side javascript conventionally used by federated wiki.
Wiki supports a small number of cross-origin endpoints which deliver pages and information about pages to client-side applications launched from other sites.
Wiki compatible servers are expected to deliver html hypertext content when a user's browser is directed to wiki related urls.
In rare cases 'view' might be replaced with 'origin' or with the domain name, in our example, 'example.com'.
Federated wiki servers provide additional endpoints used by the client-side javascript code they serve. These do not apply to foreign servers which presumably support unrelated interactions with their users.
One could serve only cross-origin requests for well known pages and be a useful member of the federation.
This could be joined into the federation by editing a lineup url to site the server/slug of the new resource and the resulting page dropped on a Factory to construct a lasting Reference that can move through the federation. The reference would expect a flag to be complete.
Viewing such a Reference will induce a neighborhood inquiry. Failure here is inconsequential. But to be available to search add a sitemap.
Presence in the neighborhood does suggest the availability of a site with welcome-visitors as it's root. When this is absent a potentially confusing Future appears upon clicks.
A good strategy is to use a private temporary instance of wiki to prepare these sorts of pages. If this static content is served from a 'pages' subdirectory then launch wiki on localhost:4000 to edit.
So far all of these api endpoints are well defined and easy to support independently of any other services a foreign server might offer.
Wiki will generate hyperlinks available to the host browser where one could expect to find html content. These are targeted to new tabs.
Here a foreign server is as free as any other traditional web site to take control of the browsing experience. Consider redirecting all of these into your own url scheme and leave federation browsing to the originating tab.