README file from
GithubAre.na Manager
Publish content from Obsidian to Are.na and the other way around.
Commands
Currently this plugin offers 5 commands:
| Command | Description |
|---|---|
Get blocks from channel |
Get all the blocks from a channel and create a new note in Obsidian with the content of each block. |
Pull block |
Updates the current open note with the content of a block from Are.na. |
Push note |
Pushes the content of the current open note to a block in Are.na. |
Get block from Are.na |
Creates a new note with the content of a block from your Are.na account. |
Get block by its ID or URL |
Creates a new note with the content of a block from Are.na by its ID or URL. |
Go to block in Are.na |
Opens the block in the Are.na website. |
Installation
- Install the plugin and enable it.
- Create a new Are.na application at https://dev.are.na/oauth/applications.
You can use any valid URL in the
Redirect URIfield. - Submit the form and copy the
Personal Access Token. - Open the plugin settings page and set the following options:
- Personal Access Token: the
Personal Access Tokenyou copied earlier. - Username: Your Are.na slug (e.g.,
usernameinhttps://www.are.na/username). - Folder: The folder where you want to store the notes (the folder is called
arenaby default).
- Personal Access Token: the
- You are done! Use any of the commands above to interact with your Are.na blocks and channels.
Attachments download
The plugin doesn’t download attachments by default. If you want to download them, you can enable the Download attachments option in the settings. You can choose from the following download locations:
- Download inside the channel folder: Attachments will be stored in the same folder as the note. For example:
arena/fantastic-channel/{folder name}. If you leave the field empty, your attachments will be stored in the channel folder. - Download to a custom folder: Attachments will be stored in a custom folder. For example:
attachments/web/files-i-saved-in-arena
Frontmatter structure
When you get a block from Are.na, the plugin will add some frontmatter automatically to allow syncronizing your note and the block.
| Property | Description |
|---|---|
| blockid | the id of the block in Are.na |
| class | the class of the block in Are.na (e.g. Link or Attachment) |
| title | the title of the block in Are.na |
| user | the user who created the block in Are.na |
| channel | the channel where the block was pulled from |
| source title | the title of the block's source |
| source url | the url of the block's source |
Roadmap
- Fetch all the user's channels.
- Attachment offline support.
- Getting blocks by their ID or URL.
- Avoid overiding the frontmatter when pulling a block.
- Template system (from this issue)
- Getting blocks to folders outside of the Are.na directory designated in the settings.
- Getting blocks from other users’ channels.
- Downloading blocks by URL.
- Creating new channels from the content of a note or directory
Contributing
If you have ideas, suggestions, or bug reports feel free to open an issue.