• a [[bot]]
  • part of [[agora bridge]] component of the [[agora]].
    • [[pull]] [[agora bridge]]
    • in control of the [[system account]] in supported platforms.
  • interacts with existing networks, starting with Mastodon and Twitter.
    • see [[agora social media integration]].
    • [[mastodon]] https://botsin.space/@agora
      • see bots/mastodon in [[go/agora-bridge]].
    • [[twitter]] https://twitter.com/an_agora
      • see bots/twitter in [[go/agora-bridge]].
    • [[matrix]] [[agora matrix bot]]
      • see [[go/agora-matrix-bot]], [[mit license]] so separate repo while we figure that out (the [[agora]] is [[apache license]], [[flancia]] is [[creative commons]] plus an [[agora contract]].)
  • [[functionality]]
    • [[current]]
      • replies to @mentions if the tweet/toot contains [[wikilinks]] with links to anagora.org
      • follows back
      • starts threads with its replies on [[matrix]]
      • stores links to messages in the [[agora]]
    • [[planned]]
      • stores full messages in the [[agora]] for users that consent
        • optionally offers to them [[gitea]] hosting, else forwards updates to a repository of their choice
  • a [[project]]

    • DONE reply to @mentions

    • DONE store [[matrix]] messages from [[agora discuss]] and other rooms that opt in?

      --[2022-03-02 Wed 12:59:45] => 688:09:46

    • LATER reply to @mentions with resolved wikilinks for whole threads

    • https://twitter.com/flancian/status/1415398630731681793 pull

Agora Editor

• To contribute to the [[Agora]], you need to write down notes or posts in one of the [[supported formats]] and upload your notes to a git repository of your choice. These steps are expanded below.
  • Get a [[github]] account if you don't have a git host already: https://github.com.
    • Install [[git]] if needed: https://git-scm.com/download. It should be installed by default in [[linux]], comes bundled with [[mac os]].
  • See [[agora signup]] for more details on the process.
• In a nutshell: you need to host your notes (more generally, [[resources]], defaulting to [[markdown]] plus [[wikilinks]]), somewhere online. And then let the [[agora]] know about it.
  • The Agora doesn't host your data, but rather pulls it from a location you control and renders it for you and other users; in the process interlinking your data with that of other users.
  • Most users currently host [[git]] repositories on https://github.com or https://gitlab.com.
  • Note using the default format (Markdown) lets you also easily publish your [[blog]] or [[digital garden]] independently online with tools such as [[jekyll]], [[gatsby]] or [[nikola]].
• As of [[2021-05-07]], the recommended Agora editor is:
  • [[foam]], if you want open source hosted locally.
    • [[foam]] is a [[vscode]] [[extension]].
    • [[foam]] is less straightforward to set up than the next options.
  • [[logseq]], if you want open source, value the convenience of a hosted setup, and use [[chrome]] or a [[chromium based browser]] (any browser but [[firefox]], essentially).
  • [[obsidian]] if you don't mind using closed software from a small ethical company, in particular a small one with a vibrant open source extension community.
    • You need at least also the [[obsidian git]] plugin. See [[obsidian plugins]] for more.
    • [[install obsidian]] by visiting https://obsidian.md and then follow [[vault backup]] to set up backup to [[git]]: https://docs.github.com/en/github/importing-your-projects-to-github/adding-an-existing-project-to-github-using-the-command-line pull.
    • Then follow the procedure below to add your vault or [[digital garden]] to the [[agora]].
  • You can also use:
    • [[dendron]], which should be a drop-in [[foam]] replacement in [[vscode]].
    • [[roam]] plus [[roam2agora]]
    • [[org mode]]
    • (In essence, all you really need to use the [[Agora]] is the capability to produce text in some format and make it publicly available somewhere. Plain text would suffice.)
• After getting yourself a [[repository]], you need to let an [[agora]] know about it so it can be pulled and integrated.
  • Please send a [[pr]] adding your garden to [[gardens yaml]], accepting the agora's [[contract]] and indicating your desired username; or reach out to signup@anagora.org, [[flancian]] or [[vera]] with information about your use case. We'll do our best to make it work! We want the [[agora]] to be maximally inclusive.
  • All [[agora]] users must agree to its [[contract]] as defined by the system account.
    • The contracts of other users can optionally be a [[endorsed]].
• My proposal to you now is that we use the capability of sharing and discovering context-relevant media at effectively zero cost for the greater good: let's agree on a protocol to escape [[vendor lock-in]] and cooperate optimally on projects of [[public utility]].
  • [[agora protocol]]

agora signup

• To [[read]] the Agora, you don't need anything but a [[web browser]].
  • This [[Agora]] is fully browsable on https://anagora.org pull.
  • You can add the Agora as a [[search engine]].
• To [[contribute]] to the Agora, first you need to publish your [[digital garden]] or [[content]] elsewhere online. The Agora doesn't host your data, but rather pulls it from a location you control and renders it for you and other users; it interlinks it with that of other users.
  • If you know your way around [[git]], [[markdown]] on git is the default format. If you use [[roam]] or a [[roam like]] or you have a notes database, you're almost there.
  • Whatever participation mechanism you choose, you need to let an Agora [[maintainer]] know where your content is, so it can be pulled and [[integrated]]. We strive to continuously support new sources and formats.
    • You can send email to signup@anagora.org or reach out to a member of [[flancia collective]] with:
      • The URL of your repo or content.
      • Your desired username.
      • Confirmation that you agree to the Agora's [[contract]] (only the one by the @agora user; other contracts are optional).
    • Alternatively if you know your way around [[git]] you can send a PR for gardens.yaml in the Agora repo: [[go/agora]].
  • The Agora wants to be [[maximally inclusive]], but it is in its infancy; it is a [[work in progress]]. If you want to participate and can't, please also send email to signup@anagora.org to let us know.
    • Non-git sources and formats other than [[Markdown]] will be supported in the future; if you store your notes using some other system, please reach out.
    • Through projects such as [[agora twitter integration]], we hope to make the Agora available to anyone that has access to a social network account.
• Please refer to [[agora install]] in case you want to run your own Agora; and to [[agora editor]] for more information on clients.

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>

Developed by [[@evan]] Boehs, [[unlicense]]d, powered by [[flancia]]

Wikilinks everywhere is a chrome extension that brings [[wikilinks]], and through it the [[internet]], to life. It can be installed on a large number of browsers and services, and will intelligently determine where [[broken]] wikilinks should go to based on your settings.

Sources

You can order or disable any of these sources at will. When a wikilink (regardless of if it is properly linked already) is detected the extension will go through these sources in that order you provided. The default order is explained below.

Options

Global

• Error codes:
  • Comma separated HTTP status codes
  • Supports nxx
  • Default: 4xx, 5xx

Source specific

• Ignore errors
  • Checkbox
  • Should error cases be ignored?
  • Default: Unchecked

Actual sources

Note: The last source is the catchall, no matter what it will ignore errors and faithfully complete the link. This means do nothing has importance. Don't remove or reorder

Existing

If a existing link is already present do nothing

Note: the only difference between the existing source and others is it changes nothing in the browser. By default, if the existing link resolves to global.error, it will move on to the sources below and consider replacing it with them

Note: this might have made no sense. Don't mess with it, probably, it exists for a reason

Prefix

Things like WP:link for wikipedia, or AG:link for [[anagora]], the schema looks like PREFIX:page.

Options

• Prefixes
  • A table of prefixes and the corresponding url
    • use {page} to have the provided back link, so with the WP prefix the url would be wikipedia.org/wiki/{page}/
    • DON'T INCLUDE THE : IN THE PREFIX

[[IWLEP]]

The user's [[IWLEP]] rules. See the IWLEP page for that config, but it is it looks a lot like your config, instead made by the author of the backlink. Don't worry, it can't be faked *unless the user gets hacked but lots worse things could happen.

Unprefixed

Iterates through all the listed urls in your order until one does not error, or all error.

{page} is the value between the brackets

Options

• List
  • Default:
    • wikipedia.org/wiki/{page}/
    • anogora.org/{page}/

Nothing

What does it say on the tin?

Concerns

Bandwidth

We use an extraordinarily large amount of bandwidth, and there is not much that we can do. That being said, the whole web is obese so I highly doubt we end up using more than 0.2 of the bandwidth of a standard blog (~1Kb a page so ~15kb a wikilink so ~150kb a page). Below is what we tried

✔️ Request methods

There is no STATUS request so we had to make due with HEAD. This will only fetch the part of the website that has the page name and useful information. It does not get the page contents, saving bucket loads of bandwidth.

👷‍♀️ Local catch

Once implemented we will store the last 1000 pages we checked, so if a wikilink is frequencintly used it will only be loaded once

❌ Catch server

This means storing the status code of every website we checked. I don't really like the idea of storing personal information like that.

Ratelimits

By

Browsers

• Powercord 🔌 (Discord) Plugin
• Chrome
• FireFox 🔥🦊

• A [[project]]. [[open source]].
  • The [[goal]] is to make [[wikilinks]] work everywhere on the internet.
    • A [[wikilink]] is any entity or phrase surrounded by two square brackets.
    • [[wikilinks]] can be [[lazily resolved]] in a user chosen [[context]].
      • Default context: an [[agora]] of the user's choice.
  • It has a [[browser extension]] component.
    • The [[user]] can install an extension and see "dead" [[wikilinks]] "come to life" anywhere around the internet.
    • [[prototype]] [[agora ext]]
  • It has a [[social network]] component.
    • People could start using [[wikilinks]] on any platform that supports user generated [[content]] online, social networks being likely the most popular interfaces.
    • For the purpose of connecting to such platforms we'd like to develop an [[agora bridge]].
  • [[go]] https://docs.google.com/document/d/1h2kSuh7TntPj_XZ7BnLPDwtwshq7skzF3BIYwLgVquA/edit# pull
  • [[chat]] https://app.element.io/#/room/#wikilinks:matrix.org
  • [[tweet]] https://twitter.com/flancian/status/1337835415215202308 pull
  • See also [[agora rfcs]], in particular 0 and 2.

[[2021-04-14]]

The plan is to get in at least two pomodoros in this to advance it somehow in the direction of a prototype. Will try to build on [[agora ext]].

Wikilinks everywhere

[[wikilinks]]

<link rel="stylesheet" href="https://doc.anagora.org/css/center.css"> <button class="pull-url" value="https://doc.anagora.org/css/center.css">">pull</button>

<div class="container-fluid text-center">
    <div class="vertical-center-row">
        <h1>500 Internal Error <small>wtf.</small></h1>
    </div>
</div>