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>

• an [[action]].
  • To sign up for the [[agora]], you can:
    • get and set up an [[agora editor]]
    • sign up for the [[Fediverse]] (e.g. on [[Mastodon]]) and follow [[@agora@botsin.space]] :)