Is the blog integration documentation incomplete?

[raayonsh]

I tried following the instructions in the blog integration guide, but ran into a couple of issues and errors:

Missing Layout/Container: I got /blog to render, but it is missing the navbar and container styling. Should the guide suggest creating it under app/(home)/blog/page.tsx instead of app/blog/page.tsx to inherit the layout?

Incomplete i18n Example: Toward the bottom of the guide, the code snippet imports an i18n module, but the docs don't show or explain what should be inside that i18n file.

[fuma-nama]

you can port the created routes to the route group you want. and i18n part expects you already have a working i18n setup following https://www.fumadocs.dev/docs/internationalization/next.

[raayonsh]

I am using Next.js static export and ran into this issue when trying to view individual blog pages:

Page "/blog/[slug]/page" is missing exported function "generateStaticParams()", which is required with "output: export" config. See more info here: https://nextjs.org/docs/messages/generate-static-params

Could you help me fix this issue?

---

Earlier, I faced another issue,

## Error Type
Console Error

## Error Message
Encountered a script tag while rendering React component. Scripts inside React components are never executed when rendering on the client. Consider using template tag instead (https://developer.mozilla.org/en-US/docs/Web/HTML/Element/template).


    at script (<anonymous>:null:null)
    at Provider (components/provider.tsx:7:10)
    at Layout (app/layout.tsx:13:9)

## Code Frame
  5 |
  6 | export function Provider({ children }: { children: ReactNode }) {
> 7 |   return <RootProvider search={{ SearchDialog }}>{children}</RootProvider>;
    |          ^
  8 | }
  9 |

Next.js version: 16.4.2 (Turbopack)

...which I was able to fix by setting images: { unoptimized: true }, which I believe should have been enabled by default.

[raayonsh]

In src/app/(home)/blog/[slug]/page.tsx, if I add this function, it works, but I don't understand what the problem was.

export async function generateStaticParams() {
  return blogSource.getPages().map((page) => ({
    slug: page.slugs[0],
  }))
}

[fuma-nama]

You can ask AI to explain to you or read Next.js docs.

[raayonsh]

Another issue with /blog is that images fail to load, even though the image file is present in the directory:

username@DESKTOP-KN231H7:~/projects/test-two/content/blog$ tree
.
├── hello-world.mdx
└── hello-world.png

1 directory, 2 files

...but, if I use an image link for example "https://www.fumadocs.dev/_next/image?url=%2F_next%2Fstatic%2Fimmutable%2Fmedia%2Fcli.3fokim1061bjv.png&w=3840&q=75" it works fine and the image shows up.

[raayonsh]

The image path needs to be an absolute path and not relative. For example, if the path says /blog/hello-world.png we should place the image in public/blog/hello-world.png and not in content/blog/hello-world.png.

[fuma-nama]

it's expected because Next.js only serves the images in /public, universal for other web frameworks.

https://nextjs.org/docs/app/api-reference/file-conventions/public-folder