diff --git a/agora-editor.md b/agora-editor.md index 41e6fcb03..541f78083 100644 --- a/agora-editor.md +++ b/agora-editor.md @@ -2,9 +2,12 @@ - As of [[2020-12-29]], the recommended Agora editor is [[foam]]. - [[foam]] is a [[vscode]] [[extension]]. - - If those worlds make sense to you, congratulations :) You can use the [[Agora]]. + - If those worlds make sense to you, congratulations :) You can use the [[Agora]]. Please refer to [[agora install]] below for more details. - If they don't, please reach out. I want to make the [[Agora]] [[maximally inclusive]]. - - You can also use [[obsidian]] and manage backups to [[git]] on your own. +- You can also use: + - [[dendron]], which should be a drop-in [[foam]] replacement in [[vscode]]. + - [[obsidian]], which doesn't depend on [[vscode]] -- but you need to manage pushing to [[git]] on your own. + - [[roam]] plus [[roam2agora]] - In essence, all you really need to use the [[Agora]] is the capability to make Markdown (or just text, really) files publicly available somewhere. I use [[git]]. - [[the agora is a markdown convention]] - [[pull]] [[agora install]] @@ -17,10 +20,12 @@ [vscode]: vscode "Vscode" [extension]: extension "Extension" [Agora]: agora "Agora" +[agora install]: agora-install "Agora Install" [maximally inclusive]: maximally-inclusive "Maximally Inclusive" [obsidian]: obsidian "Obsidian" +[roam]: roam "Roam" +[roam2agora]: roam2agora "Roam2agora" [the agora is a markdown convention]: the-agora-is-a-markdown-convention "The Agora Is a Markdown Convention" [pull]: pull "Pull" -[agora install]: agora-install "Agora Install" [flancian]: flancian "Flancian" [//end]: # "Autogenerated link references" \ No newline at end of file diff --git a/agora-install.md b/agora-install.md index 157f96cc7..7f177a962 100644 --- a/agora-install.md +++ b/agora-install.md @@ -1,9 +1,9 @@ # Agora Install -- To contribute to the [[Agora]], you need to 1. write down notes or articles in [[Markdown format]] and 2. upload your notes to a ***git repository*** of your choice. These steps are expanded below. +- To contribute to the [[Agora]], you need to write down notes or posts in [[Markdown format]] 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: . - Install [[git]] if needed: . - - If you don't have a [[personal knowledge management]] system of choice to manage your notes, we currently recommend [[foam]]: . To use foam: + - If you don't have a [[personal knowledge management]] system of choice to manage your notes, we currently recommend [[foam]]: (see [[agora editor]] for alternatives). To use foam: - Fork its template repository: . You can use any name you desire for your repository. - Install [[vscode]] if necessary: . Launch it. - Select 'clone repository' -- if you're using [[github]], log in with [[github]]. Authorize [[vscode]] to make changes to your account. It sometimes requires you to retry once for some reason. @@ -23,7 +23,7 @@ - Your desired username (can be distinct from that of your git host). - Confirmation that you agree to the Agora's [[contract]] (only the one by the @agora user; other contracts are optional). - 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. -- See also (needs updating): [agora howto](https://anagora.org/go/agora-howto) +- See also (needs updating): [agora howto](https://anagora.org/go/agora-howto). [//begin]: # "Autogenerated link references for markdown compatibility"