{ "version": "https://jsonfeed.org/version/1", "title": "Marmite 0.3.2", "home_page_url": "https://marmite.blog", "feed_url": "https://marmite.blog/tag-atproto.json", "description": "Static Site Generator
for blogs
made with ❤️ and 🦀", "items": [ { "id": "https://marmite.blog/atproto-standard-site.html", "url": "https://marmite.blog/atproto-standard-site.html", "title": "AT Protocol standard.site", "content_html": "

Marmite natively supports publishing your blog posts using the decentralized AT Protocol and the standard.site lexicons. This enables your posts to be discovered, read, and interacted with (e.g., inside the Bluesky) across the decentralized web while keeping your Marmite site as the canonical source.

\n
\n

Setup & Configuration

\n

To enable the AT Protocol features, add the atproto configuration block to your marmite.yaml:

\n
name: "My Blog"\nurl: "https://myblog.com"\n\natproto:\n  handle: "myhandle.bsky.social"\n  publication_uri: "at://did:plc:.../site.standard.publication/..."\n  publish_content: true
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NameRequiredDescription
handleYesYour AT Protocol handle (e.g. yourname.bsky.social or a custom domain handle)
publication_uriYesThe AT-URI of your publication. You should register this publication externally (e.g., using a client like standard.horse, std-pub, or the goat CLI)
publish_contentNoIf true, Marmite will strip HTML tags from your compiled markdown and publish the post body text up to 10,000 characters as textContent to the AT Protocol record (defaults to true)
\n
\n

Authentication

\n

Before publishing, you must authenticate Marmite with your PDS.

\n

First, ensure atproto.handle is configured in your marmite.yaml.

\n

Next, create an App Password for your account (e.g., in Bluesky go to Settings, App Passwords).

\n

Export the password in your environment:

\n
export ATPROTO_APP_PASSWORD="xxxx-xxxx-xxxx-xxxx"
\n

Finally, run the authentication subcommand pointing to your site's directory:

\n
marmite <site_folder> atproto auth
\n

Custom PDS / Self-Hosting (Optional)

\n

If you are self-hosting your PDS or if the automatic endpoint resolution fails, you can explicitly override the PDS endpoint using the ATPROTO_PDS_URL environment variable before authenticating:

\n
export ATPROTO_PDS_URL="https://my-custom-pds.com"
\n

Marmite will:

\n\n
\n

Local Site Build & Verification

\n

When you compile your site using marmite build or run the dev server with marmite serve, Marmite automatically takes care of domain-level and page-level standard.site verification:

\n

Automatic .well-known Generation

\n

Marmite generates a verification file at:\n/.well-known/site.standard.publication in your output directory.\nThis file contains your publication_uri. Indexers and clients check this file on your domain to verify that you indeed own the AT Protocol publication record.

\n

Automatic Header Injection

\n

For the homepage and pages, the default templates automatically inject the publication discovery link:

\n
<link rel="site.standard.publication" href="at://did:plc:.../site.standard.publication/...">
\n

For posts, Marmite reads the state mapping from your published records and automatically injects the document link into the header of each post:

\n
<link rel="site.standard.document" href="at://did:plc:.../site.standard.document/...">
\n
\n

Publishing Posts (publish)

\n

To publish your posts to your PDS, run:

\n
marmite <site_folder> atproto publish
\n

Also, check --help for more options.

\n

That command:

\n
    \n
  1. Gathers all valid markdown posts (excluding drafts).
    2. \n
  2. Computes a content hash of each post to detect modifications.
    3. \n
  3. Authenticates with your PDS (using the saved PDS URL or overridden via the ATPROTO_PDS_URL environment variable).
    4. \n
  4. Performs createRecord (for new posts) or putRecord (for modified posts) under the site.standard.document collection in your repository.
    5. \n
  5. Saves the mapping of post slugs to AT-URIs inside .marmite-atproto-state.json.
    6. \n
\n

Subsequent site marmite build read this local state file and automatically inject the document AT-URIs into the compiled HTML heads.

\n
\n

Customizing Templates (Advanced)

\n

If you are using a custom theme and want to manually inject standard.site tags, add the following to your HTML heads:

\n

Base layout (base.html or similar):

\n
{% if site.atproto and site.atproto.publication_uri %}\n<link rel="site.standard.publication" href="{{ site.atproto.publication_uri }}">\n{% endif %}
\n

Content layout (content.html or similar):

\n
{% if content.at_uri %}\n<link rel="site.standard.document" href="{{ content.at_uri }}">\n{% endif %}
\n
\n

Please consider giving a ☆ on Marmite Github repository, that helps a lot!

\n
\n\n\n", "summary": "\"Complete guide to publishing your Marmite blog posts to the decentralized AT Protocol using the standard.site specification.\"", "date_published": "2026-06-17T00:00:00-00:00", "image": "media/atproto-standard-site.banner.jpg", "authors": [ { "name": "Bruno Rocha", "url": "https://go.rocha.social/@bruno", "avatar": "https://github.com/rochacbruno.png" } ], "tags": [ "docs", "atproto", "standard.site" ], "language": "en" } ] }