Authoring
Publications
A Publication is the top-level container for a body of related content —
one blog, one magazine, one documentation site. You can have as many as you
like; each is a site.standard.publication record in your Bluesky account.
Creating a Publication
- Open Publications from the side menu.
- Click Add New Publication.
- Fill in the dialog. Only Title is required — everything else can be set or changed later from the Config tab.
| Field | What it's for |
|---|---|
| Title | The name of the Publication. |
| Domain | The domain the content will be served from, e.g. myblog.com. For a hosted SkyScribe Site this is filled in for you; for an SDK-driven website it's the domain that website runs on. Leave it blank for now if you're not sure. |
| URL Prefix | Set this only if the content lives under a subpath, e.g. blog for myblog.com/blog/…. Leave empty if it's at the domain root. |
| Description | A short summary, used in feeds and link previews. |
| Splash Image / Logo Image | Optional images — a feature image and a header logo. Pick them from your Image Library or paste an image URL. |
| Show in Discover | Whether the Publication may appear in SkyScribe's public discovery listing. |
The new Publication appears in the side list. Selecting it opens its tabs.
Your Publications list
The Publications page, and the Publications section of your Dashboard, list the Publications you own first, then the ones you're a Collaborator on. Each is marked with an Owner or Collaborator pill. On the Dashboard, a Publication you collaborate on shows its website address, if it has one, but not its SkyScribe Site status, which belongs to its owner.
Every Publication, here and at the top of its tabs, has an at:// badge beside its name: hover to see the Publication's full AT Protocol address, click to copy it.
Publications you wrote in other apps (Leaflet, pckt, Offprint and others) are listed below yours under Foreign Publications, with Import to bring one into SkyScribe. See Importing a whole publication.
The Publication tabs
Every Publication has four tabs:
Manage
The content workspace: your Categories and the Documents inside them.
- Draft New Document starts a new Document.
- Add New Category creates a new section.
- Drag Categories and Documents to reorder them, then click Save Order. If you try to leave with unsaved order changes, you're asked whether to stay, discard, or save first.
- Each Document row has View, Edit, Share, and Unpublish, plus a Visit on Site link in the overflow menu that opens its live URL. Rows look the same as on the Documents page — see Finding your Documents.
Config
Publication settings, in fieldsets:
| Fieldset | Contains |
|---|---|
| Identity | Title, Domain, URL Prefix, Description |
| Images | Splash Image, Logo Image |
| Discovery | Show in Discover toggle |
| Notifications | Show "Notify subscribers?" prompt after publishing toggle — see Sharing & notifications |
| In other apps | Refresh theme and icon — see below |
| Danger Zone | Delete Publication |
Changes are saved with the tab's Save button; you're warned if you try to leave with unsaved changes.
How your Publication looks in other apps
Other apps that read your Publication (readers, feeds, other blogging tools) can show it with its own colours and icon. SkyScribe fills these in for you:
- Theme colours come from the Site Design of the Publication's SkyScribe Site: its background, text and button colours. They're updated whenever you launch the site, change its design or edit that design. A Publication without a SkyScribe Site has no theme colours.
- Icon is your Logo Image, cropped to a square. It's updated when you change the logo, and removed if you remove it.
Click Refresh theme and icon in the In other apps fieldset to bring a Publication up to date, for example one made before this was added, or one whose SkyScribe Site has since been removed.
How your Documents appear in other apps
Other apps link to each published Document at the address your website
serves it from: the Publication's domain, then its URL Prefix, then the
Document's Category and URL slug, e.g.
myblog.com/blog/essays/a-year-of-letters. SkyScribe keeps that address
up to date for you, including when you change a Category's URL path, move
a Document to another Category, or change the Publication's Domain or URL
Prefix. If some Documents can't be updated at the time, you'll see a
warning naming them; saving one of them puts its address right.
A Document with a Splash image also shows it as its thumbnail in other apps. A Document published before this was added gets its thumbnail the next time you save it.
Collaborators
Invite other people to submit Documents to this Publication — see Collaborators & Contributors.
Insights
Visit figures for the SkyScribe Site or SDK-driven website showing this Publication: page views, visits, top pages and where readers came from. Only the Publication's owner sees them. See Site analytics.
Deleting a Publication
In Config → Danger Zone, click Delete Publication. You're asked to type the Publication's URL to confirm.
Careful
Deleting a Publication removes the publication record. Any hosted SkyScribe Site bound to it stops working, and any SDK-driven website pointed at it will no longer find it. Your Documents are separate records and are not deleted — but with no Publication referencing them, they are no longer published anywhere.
Next
Writing Documents covers the editor itself.