docs: escape ] in code-block filenames

[nobkd]

🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation, readme or JSdoc annotations)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Adds \\ to every code-block filename with ] to escape it. This prevents the filename from being cropped.

---

Related & Info

See this PR nuxt/content#2169, released in nuxt/content since v2.7.2, to fix this with an escape character

The fix was already shipped in Docus v1.14.4 with nuxt-themes/docus@44aefd5, but it seems, that this version isn't used here currently.
So if this is accepted, before the deps use the latest Docus, the filenames may look like in the following example with an extra \ before cutting off the filename.

---

Current Example

Here is an example image of how it currently looks, without escaping:

The route, where it is from: https://nuxt.com/docs/guide/directory-structure/server#using-a-nested-router

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[nuxt-studio]

✅ Live Preview ready!

Name	Edit	Preview	Latest Commit
Nuxt Docs	Edit on Studio ↗︎	View Live Preview	a9b11dd

[danielroe]

Checking the live preview, this now doesn't look quite right:

The tricky thing is that the website isn't yet open sourced but atinux is on that.

[nobkd]

As mentioned, this'll look wrong until Docus v1.14.4 is used.

[danielroe]

Nuxt.com doesn't use docus, and has already updated to the latest Nuxt content version.

[nobkd]

Thanks for clearing that up.
Seems, that there's a different issue in Nuxt Content

[Barbapapazes]

Thanks for clearing that up. Seems, that there's a different issue in Nuxt Content

Ah!

[Barbapapazes]

In fact, there is the issue even in the content.nuxtjs.org website.

It seems that https://github.com/nuxt/content/pull/2169/files is not really correct 😅 (sorry)

[nobkd]

Created an issue nuxt/content#2201

[danielroe]

Thank you ❤️

[nobkd]

I have no idea, why it shouldn't work with nuxt.com

Since docus was updated in nuxt content, it works there...
And I've also tried a simple project with the latest nuxt content version and the escaping works as expected.

https://stackblitz.com/edit/github-1jd81n?file=content%2Findex.md
(If you're editing and saving index.md on stackblitz, you have to pay attention to the escaping, because it is reduced. Write \\\\ to get \\ on stackblitz)

[danielroe]

Maybe it's an issue with the preview rather than the code.

[Barbapapazes]

it seems ok now!