https://github.com/halo-sigs/obsidian-halo

Publish your Obsidian documents to Halo.
https://github.com/halo-sigs/obsidian-halo

halo obsidian obsidian-plugin

Last synced: 3 days ago
JSON representation

Publish your Obsidian documents to Halo.

• Host: GitHub
• URL: https://github.com/halo-sigs/obsidian-halo
• Owner: halo-sigs
• License: gpl-3.0
• Created: 2023-06-02T10:18:13.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-05-04T07:18:32.000Z (7 months ago)
• Last Synced: 2024-12-09T03:39:45.365Z (4 days ago)
• Topics: halo, obsidian, obsidian-plugin
• Language: TypeScript
• Homepage:
• Size: 1.76 MB
• Stars: 27
• Watchers: 2
• Forks: 6
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-halo - obsidian-halo - Obsidian 发布插件，支持发布、更新文档到 Halo。 (Halo 2.0 / 其他)

README

        
# Obsidian plugin for Halo

This plugin allows you to publish your Obsidian documents to [Halo](https://github.com/halo-dev/halo).

[中文文档](./README.zh-CN.md)

## Preview

![settings](./images/settings-en.png)

![commands](./images/commands-en.png)

## Usage

1. Search for "Halo" in Obsidian's community plugins browser.

2. Click **Install**.

3. Go to **Settings** -> **Community Plugins** -> **Halo** and configure the settings.

4. Create a new site:

   1. Site name: the name of the site, optional.

   2. Site URL: the URL of the site, e.g. `https://example.com`.

   3. Personal access token:

      The personal access token of your Halo site, needs `Post Manage` permission.

       ![PAT](./images/pat-en.png)

       More information about personal access token: [Personal Access Token](https://docs.halo.run/user-guide/user-center#%E4%B8%AA%E4%BA%BA%E4%BB%A4%E7%89%8C)

   4. Set as default: set the site as the default site.

5. Open a note you want to publish, and run the command `Halo: Publish to Halo`.

6. All available commands:

   - **Halo: Publish to Halo**: publish the current note to Halo.

   - **Halo: Publish to Halo (use default settings)**: publish the current note to the default site.

   - **Halo: Pull posts from Halo**: pull posts from Halo to Obsidian.

   - **Halo: Update content from Halo**: update the content of the current note from Halo.

## Development

1. [Create a new Obisidian vault](https://help.obsidian.md/Getting+started/Create+a+vault) for development.

2. Clone this repo to the **plugins folder** of the newly created vault.

   ```bash

   cd path/to/vault/.obsidian/plugins

   git clone https://github.com/ruibaby/obsidian-halo

   ```

3. Install dependencies

   ```bash

   cd obsidian-halo

   npm install

   ```

4. Build the plugin

   ```bash

   npm run dev

   ```

5. Reload Obsidian and enable the plugin in Settings.

## Credits

- [obsidian-wordpress](https://github.com/devbean/obsidian-wordpress): the original idea came from this repo.

## TODO

- [x] i18n

- [ ] Upload images

- [x] Publish this plugin to Obsidian community