sk-seo
v0.4.3
Published
A lightweight, no depenencies, Sveltekit SEO component to save your time
Downloads
857
Maintainers
Readme
Installation
npm i -D sk-seo
If you're using @adapter-static, make sure to follow this
Usage
import the file
<script>
import Seo from 'sk-seo';
</script>
Then place this code anywhere in your svelte file
<Seo
title="Contact"
description="Where to contact Dahoom AlShaya, whether for business needs or general inquiries"
keywords="Contact, business, inquiries"
/>
Standard Parameters
| Parameter | Description | Type | Default |
| ------------- | ----------------------- | ------- | ----------------------- |
| title
| The title of the page | string | ~ |
| description
| The description of the page | string | ~ |
| keywords
| The keywords to be used for search engine optimization or search | string | ~ |
| index
| Whether or not crawlers should crawl this page | boolean | true |
Advanced
All these choices are optional
| Parameter | Description | Type | Default |
| ------------- | ----------------------- | ------- | ----------------------- |
| siteName
| The name of the site | string | ~ |
| canonical
| Current URL of the page. For resolving duplicate pages with SEO | string | ~ |
| twitter
| Indicates whether Twitter meta tags should be generated | boolean | true |
| openGraph
| Indicates whether og / OpenGraph meta tags should be generated | boolean | true |
| schemaOrg
| Indicates whether jsonLd/SchemaOrg meta script should be generated | boolean | false |
| schemaType
| The type of jsonld schema (Person, Organisation, Create) @default Person,Organisation | string/Array | ['Person', 'Organisation'] |
| jsonld
| Appends contents to jsonld script (used by search engines for names, contact information, etc) | object {}
| ~ |
| imageURL
| The URL of the image to be used for preview (twitter, discord image preview when your url is shared) | string | ~ |
| logo
| The logo image URL for SchemaOrg | string | ~ |
| author
| Represents the author of the page | string | ~ |
| socials
| An array of social media links for SchemaOrg | Array | ~ |
| name
| The name to be used for SchemaOrg | string | ~ |
How it works
The component uses <svelte:head>
to place meta tags that are filled with sveltekit $page and inputted variables, this means that a lot of the tags are automatically filled for you for each page in your website. An example of this is og:url
, which requires the url of the current page:
<meta property="og:url" content="{$page.url}">
Extendable
If you want to use an unusual meta tag or use your own custom one (eg: google site verification). It's easy as:
<Seo title="abc" description="def">
<meta name="google-site-verification" content="abcd123">
</Seo>
Why
A lot of SEO is repeated boilerplate for twitter, open graph and schemaOrg. This component's sole purpose is to do away with all the annoyances and just help you focus on your content without having to spend hours making sure all the meta tags are correctly set on each and every page.
I initially made this for my personal website and decided to open source it to so that no one has to go through the headache I did to make sure everything is functional.
Keywords?!
It's optional for anyone who wants to use it. Google doesn't rely on keywords anymore but apparently bing still does put a tiny weight on it. I personally use keywords for my personal website's search function.
Prerendering
If you are using adapter-static, you need to add your base URL in svelte.config.js
, otherwise $page.url
will default to http://sveltekit-prerender
.
// svelte.config.js
const config = {
kit: {
prerender: {
origin: 'https://mossberg.dev' // Replace with your URL.
}
}
}
Duplicated Meta?
If you're behind Cloudflare
and find yourself with duplicated meta tags, then you should disable auto-minify!
Speed -> Optimization -> Content Optimization -> Auto Minify -> UNCHECK HTML
License
Extra
If you have any ideas of fixes/imporvements/features that could be added then please suggest them here
Credits
- Thanks to ArchangelGCA for the multiple quality of life imporvements and fixes!
- Thanks to RodneyLab for his blog post which taught me about jsonLd and for suggesting an interesting snippet of code to render jsonLd