Auto: misc.

This commit is contained in:
2021-01-03 19:12:35 +01:00
parent 2271a9a5b4
commit a946fb9527
2 changed files with 11 additions and 6 deletions
+8 -3
View File
@@ -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"
+3 -3
View File
@@ -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: <https://github.com>.
- Install [[git]] if needed: <https://git-scm.com/download>.
- If you don't have a [[personal knowledge management]] system of choice to manage your notes, we currently recommend [[foam]]: <https://foambubble.github.io/foam/>. To use foam:
- If you don't have a [[personal knowledge management]] system of choice to manage your notes, we currently recommend [[foam]]: <https://foambubble.github.io/foam/> (see [[agora editor]] for alternatives). To use foam:
- Fork its template repository: <https://github.com/foambubble/foam-template/>. You can use any name you desire for your repository.
- Install [[vscode]] if necessary: <https://code.visualstudio.com/download>. 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"