Configuring Urara + Indiekit

[kwaa]

Here is a tutorial on how to configure Indiekit for use with Urara.

• example.com: your urara blog domain
• indiekit.example.com: your indiekit domain

Urara Blog

Remark FFF

Install remark-fff to be compatible with hugo frontmatter:

🚨 untested, please open an issue if there are bugs.

pnpm add -D remark-fff

./mdsvex.config.ts:

+ import remarkFFF from 'remark-fff'
...
export default defineConfig({
  ...
  remarkPlugins: [
+   remarkFFF,
    remarkUraraFm,
    remarkUraraSpoiler,
    [remarkFootnotes, { inlineNotes: true }]
  ],
})

Head Config

./src/lib/config/general.ts:

export const head: HeadConfig = {
  custom: () => [
    '<link rel="micropub" href="https://indiekit.example.com/micropub" />',
    '<link rel="authorization_endpoint" href="https://indieauth.com/auth" />',
    '<link rel="token_endpoint" href="https://indiekit.example.com/token" />'
  ],
  me: ['https://github.com/example'] // RelMeAuth
}

Indiekit

Assuming here that you have the Indiekit service running successfully, let's modify the configuration to be compatible with Urara.

For a complete guide, please refer to the Indiekit website at https://getindiekit.com

Plugins

If you don't store your code in github, use the corresponding plugin

npm i @indiekit/preset-hugo @indiekit/store-github

Config

Modify this paragraph for your use case and put it in package.json.

  "indiekit": {
    "plugins": [
      "@indiekit/preset-hugo",
      "@indiekit/store-github"
    ],
    "publication": {
      "categories": "https://example.com/tags.json",
      "me": "https://example.com",
      "postTypes": [
        {
          "type": "article",
          "name": "Article",
          "post": {
            "path": "urara/{slug}/index.md",
            "url": "{slug}"
          },
          "media": {
            "path": "urara/{slug}/{filename}",
            "url": "{slug}/{filename}"
          }
        },
        {
          "type": "note",
          "name": "Note",
          "post": {
            "path": "urara/{slug}/index.md",
            "url": "{slug}"
          }
        },
        {
          "type": "photo",
          "name": "Photo",
          "post": {
            "path": "urara/{slug}/index.md",
            "url": "{slug}"
          },
          "media": {
            "path": "urara/{slug}/{filename}",
            "url": "{slug}/{filename}"
          }
        },
        {
          "type": "reply",
          "name": "Reply",
          "post": {
            "path": "urara/{slug}/index.md",
            "url": "{slug}/{filename}"
          }
        }
      ]
    },
    "@indiekit/preset-hugo": {
      "frontMatterFormat": "yaml"
    },
    "@indiekit/store-github": {
      "user": "user",
      "repo": "repo",
      "branch": "master"
    }
  }