docs: add BRAT installation instructions

This commit is contained in:
hermes
2026-04-23 13:40:09 +00:00
parent 23bfd2e2e2
commit af24952dad
+17 -4
View File
@@ -2,18 +2,31 @@
This is an extension for the [Obsidian Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api) plugin. It adds a new endpoint to retrieve backlinks for a specific note. This is an extension for the [Obsidian Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api) plugin. It adds a new endpoint to retrieve backlinks for a specific note.
## Features
- **GET `/extensions/backlinks/{filepath}`**: Returns all notes that link to the specified file.
## Installation ## Installation
### Option 1: Using BRAT (Recommended for Testers)
The easiest way to install and keep this plugin updated is using the **BRAT (Beta Reviewer's Auto-update Tool)** plugin.
1. Install the **BRAT** plugin from the Obsidian Community Plugins gallery.
2. Open BRAT settings and click **"Add Beta plugin"**.
3. Paste the following repository URL:
`https://gitea-wc4w40kskg0c4g400s0wcgsg.coolify-7dou.ja7z.net/hermes/obsidian-local-rest-api-backlinks`
4. Click **"Add Plugin"**.
5. Enable the plugin in **Settings > Community Plugins**.
### Option 2: Manual Installation
1. Install the [Obsidian Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api) plugin. 1. Install the [Obsidian Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api) plugin.
2. Download the `main.js` and `manifest.json` from the `/dist` folder of this repository. 2. Download the `main.js` and `manifest.json` from the `/dist` folder of this repository (or the latest release).
3. Create a folder named `obsidian-local-rest-api-backlinks` in your vault's `.obsidian/plugins/` directory. 3. Create a folder named `obsidian-local-rest-api-backlinks` in your vault's `.obsidian/plugins/` directory.
4. Place `main.js` and `manifest.json` into that folder. 4. Place `main.js` and `manifest.json` into that folder.
5. Restart Obsidian or reload plugins. 5. Restart Obsidian or reload plugins.
6. Enable the plugin in **Settings > Community Plugins**. 6. Enable the plugin in **Settings > Community Plugins**.
## Usage Example ## Usage Example
The extension adds a new route to the Local REST API.
**Endpoint:** `GET /extensions/backlinks/{filepath}`
```bash ```bash
curl -k -H "Authorization: Bearer YOUR_API_KEY" \ curl -k -H "Authorization: Bearer YOUR_API_KEY" \
"https://127.0.0.1:PORT/extensions/backlinks/MyNote.md" "https://127.0.0.1:PORT/extensions/backlinks/MyNote.md"