দ্রুত শুরু
প্রয়োজনীয় পরিবেশ
- Node.js
^20.19.0অথবা>=22.12.0 - Svelte 5, SvelteKit 2 (
2.65.1বা পরের সংস্করণ) অথবা SvelteKit 3, এবং Vite 8 - pnpm 10 সুপারিশ করা হয়; create command npm, Yarn এবং Bun-ও সমর্থন করে
প্রজেক্ট তৈরী
নিম্নলিখিত কমান্ডগুলির মধ্যে একটি ব্যবহার করুন আপনি কোন প্যাকেজ ম্যানেজার ব্যবহার করছেন তার উপর নির্ভর করে
npm create @sveltepress@latest রেপোজিটরি ও তৈরি হওয়া template pnpm 10 দিয়ে যাচাই করা হয়।
একটি বিদ্যমান sveltekit প্রজেক্টে যোগ করা
ভিট প্লাগিন প্যাকেজ ইন্সটল করুন
npm install --save @sveltepress/vite vite.config.(js|ts) এ sveltekit plugin পরিবর্তন করুন
import { } from '@sveltejs/kit/vite'
import { } from '@sveltepress/vite'
import { } from 'vite'
const = ({
: [
(),
(),
],
})
export default sveltekit() plugin সরিয়ে ফেলুনsveltepress() ইতিমধ্যেই আপনার জন্য SvelteKit সেট আপ করে। plugins এ sveltekit() এবং sveltepress() উভয়ই রাখলে প্রতিটি Svelte ফাইল দুইবার কম্পাইল হয় এবং dev server Expected token } ত্রুটিসহ ক্র্যাশ করে।
sveltepress() এর মাধ্যমে SvelteKit config দিন
SvelteKit 3 আর svelte.config.js পড়ে না, এবং ফাইলটি থাকলে চালু হতে অস্বীকার করে। এর অপশনগুলো (আগে kit এর ভেতরে থাকা সবকিছুসহ) sveltepress({ svelteKitOptions }) এ সরিয়ে নিন, তারপর svelte.config.js মুছে ফেলুন। Sveltepress স্বয়ংক্রিয়ভাবে '.md' extension যুক্ত করে দেয়।
import from '@sveltejs/adapter-static'
import { } from '@sveltejs/vite-plugin-svelte'
import { } from '@sveltepress/vite'
import { } from 'vite'
export default ({
: [
({
: {
: [()],
: ({
: 'dist',
}),
},
}),
],
}) SvelteKit 2-ও svelteKitOptions গ্রহণ করে। চাইলে svelte.config.js রেখে দিয়ে এর extensions এ '.md' যুক্ত করতে পারেন:
import from '@sveltejs/adapter-static'
import { } from '@sveltejs/vite-plugin-svelte'
/**
* @type {import('@sveltejs/kit').Config}
*/
const = {
: ['.svelte'],
: ['.svelte', '.md'], // add .md here
: [()],
: {
: ({
: 'dist',
}),
},
}
export default SvelteKit 3 এ আপগ্রেড
@sveltejs/kitকে^3.0.0এ এবং আপনার adapter কে এর SvelteKit 3 রিলিজে আপগ্রেড করুন, যেমন@sveltejs/adapter-static^4.0.0। SvelteKit 3 এর জন্য Node.js>=22.17প্রয়োজন।- নিজের কোড মাইগ্রেট করতে
npx sv migrate sveltekit-3চালান, যেমন$app/stores,$app/pathsএরbaseএবং$libimport। - নিশ্চিত করুন SvelteKit config উপরের মতো
sveltepress({ svelteKitOptions })এ আছে। মাইগ্রেশনsvelte.config.jsকে আপনার Vite config এর একটিsveltekit(...)কলে সরিয়ে দেয়: সেই অবজেক্টটিsvelteKitOptionsএ সরিয়ে নিন এবংsveltekit(...)plugin সরিয়ে ফেলুন।
Sveltepress এর নিজের আর কোনো পরিবর্তন লাগে না। মনে রাখুন:
$libএর জায়গায় এখন#libsubpath import। ভার্সন ম্যানেজমেন্ট$lib/এর মতোই#lib/import ট্র্যাক করে, তাই আপনার manifest যদি$lib/**শেয়ার করে, তবেcontent.sharedএ#lib/**-ও যুক্ত করুন।- Default Theme এর
pwaঅপশন@vite-pwa/sveltekitএর উপর নির্ভর করে, যা এখনও SvelteKit 3 সমর্থন করে না। SvelteKit 3 এ কোনো service worker তৈরি হয় না, এবং build একটি সতর্কবার্তা দেখায়।