A CLI for publishing standard.site documents to ATProto
sequoia.pub
standard
site
lexicon
cli
publishing
chore: updated docs
authored by
+26
-2
+8
-1
docs/docs/pages/config.mdx
+8
-1
docs/docs/pages/config.mdx
···
15
15
| `identity` | `string` | No | - | Which stored identity to use |
16
16
| `frontmatter` | `object` | No | - | Custom frontmatter field mappings |
17
17
| `ignore` | `string[]` | No | - | Glob patterns for files to ignore |
18
+
| `bluesky` | `object` | No | - | Bluesky posting configuration |
19
+
| `bluesky.enabled` | `boolean` | No | `false` | Post to Bluesky when publishing documents |
20
+
| `bluesky.maxAgeDays` | `number` | No | `30` | Only post documents published within this many days |
18
21
19
22
### Example
20
23
···
31
34
"frontmatter": {
32
35
"publishDate": "date"
33
36
},
34
-
"ignore": ["_index.md"]
37
+
"ignore": ["_index.md"],
38
+
"bluesky": {
39
+
"enabled": true,
40
+
"maxAgeDays": 30
41
+
}
35
42
}
36
43
```
37
44
+18
-1
docs/docs/pages/publishing.mdx
+18
-1
docs/docs/pages/publishing.mdx
···
10
10
sequoia publish --dry-run
11
11
```
12
12
13
-
This will print out the posts that it has discovered, what will be published, and how many. Once everything looks good, send it!
13
+
This will print out the posts that it has discovered, what will be published, and how many. If Bluesky posting is enabled, it will also show which posts will be shared to Bluesky. Once everything looks good, send it!
14
14
15
15
```bash [Terminal]
16
16
sequoia publish
···
27
27
```
28
28
29
29
Sync will use your ATProto handle to look through all of the `standard.site.document` records on your PDS, and pull down the records that are for the publication in the config.
30
+
31
+
## Bluesky Posting
32
+
33
+
Sequoia can automatically post to Bluesky when new documents are published. Enable this in your config:
34
+
35
+
```json
36
+
{
37
+
"bluesky": {
38
+
"enabled": true,
39
+
"maxAgeDays": 30
40
+
}
41
+
}
42
+
```
43
+
44
+
When enabled, each new document will create a Bluesky post with the title, description, and canonical URL. If a cover image exists, it will be embedded in the post. The combined content is limited to 300 characters.
45
+
46
+
The `maxAgeDays` setting prevents flooding your feed when first setting up Sequoia. For example, if you have 40 existing blog posts, only those published within the last 30 days will be posted to Bluesky.
30
47
31
48
## Troubleshooting
32
49