# Ghosty Posty

Publish your Obsidian notes directly to Ghost blogs with automatic image uploads, frontmatter metadata support, and a beautiful confirmation modal.

## Features

### Content Publishing
- **One-Command Publishing**: Publish the current note to Ghost with a single command
- **Markdown to HTML Conversion**: Automatically converts your Obsidian markdown to Ghost-compatible HTML
- **Image Upload**: Automatically uploads local images to Ghost and updates references
- **Featured Images**: First-line images are automatically set as the post's featured image
- **Wiki Link Conversion**: Converts `[[links]]` to plain text for Ghost compatibility

### Publishing Options
- **Editable Metadata**: Review and edit title, tags, and status before publishing
- **Post Status**: Choose Draft, Published, or Scheduled
- **Scheduled Publishing**: Set a future date/time (in your local timezone) to publish
- **Featured Posts**: Toggle to mark posts as featured on your Ghost site
- **Tags Management**: Add comma-separated tags directly in the modal

### Frontmatter Support
Control your posts with YAML frontmatter:
- `title`: Override the filename as the post title
- `slug`: Custom URL slug for the post
- `tags`: Array or comma-separated list of tags
- `status`: `draft`, `published`, or `scheduled`
- `publish_date` or `date`: Schedule future publishing

### Archive After Publishing
- **Optional Archive Folder**: Automatically move notes to a designated folder after a successful publish
- **Folder Autocomplete**: Suggests existing folders as you type
- **Auto-Creates Folders**: Creates the archive folder if it doesn't exist
- **Collision Safe**: Appends a timestamp if a file with the same name is already in the archive

### Cross-Platform
Works on Obsidian Desktop (Mac, Windows, Linux) and Mobile (iOS, Android).

## Installation

1. Download the latest release files:
   - `main.js`
   - `manifest.json`
   - `styles.css`

2. Create a folder in your vault: `<vault>/.obsidian/plugins/ghosty-posty/`

3. Copy all three files into this folder

4. Restart Obsidian or reload plugins

5. Enable "Ghosty Posty" in Settings → Community Plugins

## Setup

### 1. Get Your Ghost Admin API Key

1. Log in to your Ghost Admin panel
2. Navigate to **Settings → Integrations**
3. Click **Add custom integration**
4. Give it a name (e.g., "Obsidian Publisher")
5. Copy the **Admin API Key** (format: `id:secret`)

### 2. Configure the Plugin

1. Open Obsidian Settings
2. Go to **Ghosty Posty** under Community Plugins
3. Enter your **Ghost Admin URL** (e.g., `https://yourblog.com`)
4. Paste your **Admin API Key**
5. Choose your **Default post status** (Draft recommended)
6. *(Optional)* Set an **Archive folder** to automatically move notes after they're published — leave empty to disable
7. Click **Test Connection** to verify

## Usage

### Basic Publishing

1. Open the note you want to publish
2. Open the Command Palette (`Cmd/Ctrl + P`)
3. Run **"Publish to Ghost"**
4. Review the metadata in the modal:
   - Edit the title if needed
   - Choose the status (Draft/Published/Scheduled)
   - If Scheduled, pick a date and time
   - Add or modify tags
   - Toggle "Featured" if desired
5. Click **Publish**

### Using Frontmatter

Add YAML frontmatter to your notes for automatic metadata:

```yaml
---
title: "My Awesome Blog Post"
slug: "awesome-post"
tags: [blogging, tutorial, obsidian]
status: published
publish_date: 2024-12-25T09:00:00
---

Your content here...
```

### Image Handling

**Featured Images:**
- Place an image on the first line after frontmatter
- It will automatically become the featured image
- The image is removed from the post content

**Inline Images:**
- Both standard markdown `![alt](path)` and Obsidian embeds `![[image.png]]` are supported
- All local images are uploaded to Ghost automatically
- Image paths are updated to Ghost CDN URLs
- External URLs (http/https) are left unchanged

### Publishing Options

**Draft:** Save the post but don't make it visible to readers

**Published:** Make the post immediately visible on your blog

**Scheduled:** Choose a future date and time to automatically publish (uses your local timezone)

**Featured:** Mark the post as featured on your Ghost site

### Archiving Published Notes

If you set an **Archive folder** in settings, notes are automatically moved there after a successful publish:

- Leave the setting empty to keep notes in place after publishing
- The folder is created automatically if it doesn't exist
- If a file with the same name already exists in the archive, a timestamp is appended to avoid overwriting
- Internal links to the note are updated automatically when it's moved

## Tips

- Use the **Test Connection** button in settings to verify your credentials work
- Start with drafts to preview your posts before publishing
- Tags from frontmatter will be pre-filled but can be edited in the modal
- Scheduled posts use your local timezone and are converted to UTC for Ghost
- The plugin will block publishing if any image fails to upload

## Troubleshooting

**"Connection failed"**
- Verify your Ghost URL is correct (no trailing slash)
- Check that your Admin API Key is in the format `id:secret`
- Ensure your Ghost site is accessible from your network

**"Image not found"**
- Check that image paths are relative to your vault or the current note
- Verify the image file exists in your vault

**"Failed to publish"**
- Check the error message for details
- Verify you have write permissions on your Ghost site
- Try the Test Connection button to diagnose authentication issues