diff --git a/agora-editor.md b/agora-editor.md index dd80931d9..41e6fcb03 100644 --- a/agora-editor.md +++ b/agora-editor.md @@ -15,6 +15,7 @@ [2020-12-29]: journal/2020-12-29 "2020-12-29" [foam]: foam "Foam" [vscode]: vscode "Vscode" +[extension]: extension "Extension" [Agora]: agora "Agora" [maximally inclusive]: maximally-inclusive "Maximally Inclusive" [obsidian]: obsidian "Obsidian" diff --git a/agora-howto.md b/agora-howto.md index a756c7867..fa977a0fa 100644 --- a/agora-howto.md +++ b/agora-howto.md @@ -2,9 +2,8 @@ - [[go]] https://github.com/flancian/agora/blob/master/docs/howto.md - (If you see nodes that have a block beginning with go, they refer to go links. anagora.org/go/node redirects to the URL in that line. Example: https://flancia.org/go/agora-howto). -- [[todo]] Should be a high level walkthrough from zero to "you know how to navigate the Agora" and "you have a digital garden and you know how to integrate it into the Agora if you are willing". - To [[sign up]] for 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. Please refer to [agora howto](https://anagora.org/go/agora-howto) for detailed instructions. + - 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. Please refer to [[agora install]] for detailed setup instructions. - 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. Please send email to signup@anagora.org with: - The URL for your content. - Your desired username. diff --git a/agora-install.md b/agora-install.md index 977d5e164..157f96cc7 100644 --- a/agora-install.md +++ b/agora-install.md @@ -1,9 +1,9 @@ # Agora Install -- Set up a [[personal knowledge management]] system for note taking and upload your notes in [[Markdown]] format to a git repository of your choice. +- 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. - 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, we 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]]: . 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. @@ -18,18 +18,21 @@ - You may need to set a user.name and user.email in git. To do this, open the terminal in [[vscode]] and type: - git config --global user.name "Your Name" - git config --global user.email "yourname@example.com" -- Send email to signup@anagora.org or a Twitter DM to [[flancian]] with: +- Then send email to signup@anagora.org or a Twitter DM to [[flancian]] with: - The URL of your repo. - 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) [//begin]: # "Autogenerated link references for markdown compatibility" +[Agora]: agora "Agora" [personal knowledge management]: personal-knowledge-management "Personal Knowledge Management" -[Markdown]: markdown "Markdown" [foam]: foam "Foam" [vscode]: vscode "Vscode" [wikilinks]: wikilinks "Wikilinks" [flancian]: flancian "Flancian" [contract]: contract "CONTRACT" +[Markdown]: markdown "Markdown" [//end]: # "Autogenerated link references" \ No newline at end of file diff --git a/extension.md b/extension.md new file mode 100644 index 000000000..24f2cc1bf --- /dev/null +++ b/extension.md @@ -0,0 +1,2 @@ +# Extension + diff --git a/personal-knowledge-management.md b/personal-knowledge-management.md index 32ab59eea..150910e24 100644 --- a/personal-knowledge-management.md +++ b/personal-knowledge-management.md @@ -1,6 +1,7 @@ # Personal Knowledge Management - [[pull]] [[pkm]] +- [[pull]] [[agora editor]] - See also [[distributed knowledge graph]]. - See also [[roam-likes]]