Advanced Setup

Excluding certain routes

⚠️ The exclude option has been reported as buggy.

If you encounter any issues with it, please open a PR that fixes/ improves the exlusion mechanism. A PR will be reviewed promptly.

Exclude routes from being translated with the exclude option.

// src/lib/i18n.js
import { createI18n } from "@inlang/paraglide-sveltekit"
import * as runtime from "$lib/paraglide/runtime.js"

export const i18n = createI18n(runtime, {
	// don't include the /api/ routes
	// this matches any route that starts with /api/
	exclude: [/^\/api\//],
})

Excluded routes will:

• Not have any rel="alternate" links added to them
• Not have their Paths translated
• Not have links pointing to them translated

Make sure excluded pages are still wrapped in the <ParaglideJS> so that outgoing links are still translated.

Text direction

Paraglide guesses the text direction using the Intl.Locale API. This is not supported in all runtimes. Use the textDirection option to provide the text direction yourself.

// src/lib/i18n.js
import { createI18n } from "@inlang/paraglide-sveltekit"
import * as runtime from "$lib/paraglide/runtime.js"

export const i18n = createI18n(runtime, {
	textDirection: {
		en: "ltr",
		ar: "rtl",
	},
})

Full URLs in <link rel="alternate"> tags

According to the spec, alternate links for pages must be full URLs. Do this by setting the prerender.origin option in your svelte.config.js.

// svelte.config.js

/** @type {import('@sveltejs/kit').Config} */
const config = {
	kit: {
		// ...
		prerender: {
			origin: "https://example.com",
		},
	},
}

export default config