add FAQs page

site/content/faq/are-there-any-video-courses.md

@@ -0,0 +1,10 @@
+---
+question: Are there any video courses?
+---
+
+There are no official ones, but here are a couple of third-part ones that we know of.
+
+- [Egghead](https://egghead.io/playlists/getting-started-with-svelte-3-05a8541a)
+- [Udemy](https://www.udemy.com/sveltejs-the-complete-guide/)
+
+Note that Udemy very frequently has discounts over 90%.

site/content/faq/does-svelte-scale.md

@@ -0,0 +1,5 @@
+---
+question: Does Svelte scale?
+---
+
+There will be a blog post about this eventually, but in the meantime, check out [this issue](https://github.com/sveltejs/svelte/issues/2546).

site/content/faq/how-can-i-get-syntax-highlighting.md

@@ -0,0 +1,5 @@
+---
+question: How can I get VSCode to syntax-highlight my .svelte files?
+---
+
+There is an [official VSCode extension for Svelte](https://marketplace.visualstudio.com/items?itemName=svelte.svelte-vscode), however it is still in the **beta** testing stage, and not all issues have been ironed out.

site/content/faq/how-can-i-update-my-v2-components.md

@@ -0,0 +1,5 @@
+---
+question: How can I update my components written in Svelte v2?
+---
+
+svelte-upgrade isn't fully working for v2->v3 yet, [but it's close](https://github.com/sveltejs/svelte-upgrade/pull/12).

site/content/faq/how-do-i-test-svelte-apps.md

@@ -0,0 +1,6 @@
+---
+question: How do I test Svelte apps?
+---
+
+We don't have a good answer to this yet, but it is a priority. There are a few approaches that people take when testing, but it generally involves compiling the component and mounting it to something and then performing the tests.
+You essentially need to create a bundle for each component you're testing (since svelte is a compiler and not a normal library) and then mount them. You can mount to a JSDOM instance, or you can use Puppeteer if you need a real browser, or you can use a tool like Cypress. There is an example of this in the Sapper starter template.

site/content/faq/im-new-to-svelte.md

@@ -0,0 +1,7 @@
+---
+question: I'm new to Svelte. Where should I start?
+---
+
+We think the best way to get started is playing through the interactive [Tutorial](https://svelte.dev/tutorial). Each step there is mainly focused on one specific aspect and is easy to follow. You'll be editing and running real Svelte components right in your browser.
+
+Five to ten minutes should be enough to get you up and running. An hour and a half should get you through the entire tutorial.

site/content/faq/is-svelte-dev-down.md

@@ -0,0 +1,5 @@
+---
+question: Is svelte.dev down?
+---
+
+Probably not, but it's possible. If you can't seem to access any `.dev` sites, check out [this SuperUser question and answer](https://superuser.com/q/1413402).

site/content/faq/is-svelte-v2-still-availabile.md

@@ -0,0 +1,7 @@
+---
+question: Is Svelte v2 still available?
+---
+
+New features aren't being added to it, and bugs will probably only be fixed if they are extremely nasty or present some sort of security vulnerability.
+
+The documentation is still available [here](https://v2.svelte.dev/guide).

site/content/faq/is-there-a-component-library.md

@@ -0,0 +1,5 @@
+---
+question: Is there a UI component library?
+---
+
+There are several UI component libraries. Find them under the [code section](https://svelte-community.netlify.com/code) of the Svelte Community website.

site/content/faq/is-there-a-router.md

@@ -0,0 +1,13 @@
+---
+question: Is there a router?
+---
+
+You can use any router lib you want. A lot of people use [page.js](https://github.com/visionmedia/page.js). There's also [navaid](https://github.com/lukeed/navaid), which is very similar.
+
+If you prefer a declarative HTML approach, there's [svelte-routing](https://github.com/EmilTholin/svelte-routing).
+
+If you need hash-based routing on the client side, check out [svelte-spa-router](https://github.com/ItalyPaleAle/svelte-spa-router), or [abstract-state-router](https://github.com/TehShrike/abstract-state-router/), a mature router for business software.
+
+For filesystem-based routing, you can take a look at [Routify](https://routify.dev).
+
+For an official solution, there's nothing that's simply a routing library. There is, however, the official [Sapper](https://sapper.svelte.dev/) framework, a Next.js-style application framework built on Svelte, which includes its own filesystem-based routing.

site/content/faq/what-about-typescript-support.md

@@ -0,0 +1,5 @@
+---
+question: What about Typescript support?
+---
+
+We have no TS support **yet** but it's very much planned - v3 was partly about laying the foundation for it.  You can track progress in [#1639](https://github.com/sveltejs/svelte/issues/1639).

site/src/routes/faq.js

@@ -1,4 +0,0 @@
-export function get(req, res) {
-	res.writeHead(302, { Location: 'https://github.com/sveltejs/svelte/wiki/FAQ' });
-	res.end();
-}

site/src/routes/faq/_faqs.js

@@ -0,0 +1,53 @@
+import fs from 'fs';
+import path from 'path';
+import { extract_frontmatter, link_renderer } from '@sveltejs/site-kit/utils/markdown.js';
+import marked from 'marked';
+import { makeSlugProcessor } from '../../utils/slug';
+import { highlight } from '../../utils/highlight';
+import { SLUG_PRESERVE_UNICODE } from '../../../config';
+
+const makeSlug = makeSlugProcessor(SLUG_PRESERVE_UNICODE);
+
+export default function get_posts() {
+	return fs
+		.readdirSync('content/faq')
+		.map(file => {
+			if (path.extname(file) !== '.md') return;
+
+			const match = /^(.+)\.md$/.exec(file);
+			if (!match) throw new Error(`Invalid filename '${file}'`);
+
+			const [, slug] = match;
+
+			const markdown = fs.readFileSync(`content/faq/${file}`, 'utf-8');
+
+			const { content, metadata } = extract_frontmatter(markdown);
+
+			const renderer = new marked.Renderer();
+
+			renderer.link = link_renderer;
+
+			renderer.code = highlight;
+
+			renderer.heading = (text, level, rawtext) => {
+				const fragment = makeSlug(rawtext);
+
+				return `
+					<h${level}>
+						<span id="${fragment}" class="offset-anchor"></span>
+						${text}
+					</h${level}>`;
+			};
+
+			const answer = marked(
+				content.replace(/^\t+/gm, match => match.split('\t').join('  ')),
+				{ renderer }
+			);
+
+			return {
+				slug,
+				answer,
+				metadata
+			};
+		});
+}

site/src/routes/faq/index.json.js

@@ -0,0 +1,23 @@
+import send from '@polka/send';
+import get_faqs from './_faqs.js';
+
+let json;
+
+export function get(req, res) {
+	if (!json || process.env.NODE_ENV !== 'production') {
+		const faqs = get_faqs()
+			.map(faq => {
+				return {
+					answer: faq.answer,
+					metadata: faq.metadata
+				};
+			});
+
+		json = JSON.stringify(faqs);
+	}
+
+	send(res, 200, json, {
+		'Content-Type': 'application/json',
+		'Cache-Control': `max-age=${5 * 60 * 1e3}` // 5 minutes
+	});
+}

site/src/routes/faq/index.svelte

@@ -0,0 +1,72 @@
+<script context="module">
+	export async function preload() {
+		const faqs = await this.fetch(`faq.json`).then(r => r.json());
+		return { faqs };
+	}
+</script>
+
+<script>
+	const description = "Frequently Asked Questions about Svelte"
+
+	export let faqs;
+</script>
+
+<svelte:head>
+	<title>Frequently Asked Questions • Svelte</title>
+
+	<meta name="twitter:title" content="Svelte FAQ">
+	<meta name="twitter:description" content={description}>
+	<meta name="Description" content={description}>
+</svelte:head>
+
+<div class='faqs stretch'>
+	<h1>Frequently Asked Questions</h1>
+	{#each faqs as faq}
+		<article class='faq'>
+			<h2>{faq.metadata.question}</h2>
+			<p>{@html faq.answer}</p>
+		</article>
+	{/each}
+</div>
+
+<style>
+	.faqs {
+		grid-template-columns: 1fr 1fr;
+		grid-gap: 1em;
+		min-height: calc(100vh - var(--nav-h));
+		padding: var(--top-offset) var(--side-nav) 6rem var(--side-nav);
+		max-width: var(--main-width);
+		margin: 0 auto;
+	}
+
+	h2 {
+		display: inline-block;
+		margin: 3.2rem 0 1rem 0;
+		color: var(--text);
+		max-width: 18em;
+		font-size: var(--h3);
+		font-weight: 400;
+	}
+
+	.faq:first-child {
+		margin: 0 0 2rem 0;
+		padding: 0 0 4rem 0;
+		border-bottom: var(--border-w) solid #6767785b; /* based on --second */
+	}
+
+	.faq:first-child h2 {
+		font-size: 4rem;
+		font-weight: 400;
+		color: var(--second);
+	}
+
+	.faq p {
+		font-size: var(--h5);
+		max-width: 30em;
+		color: var(--second);
+	}
+
+	:global(.faqs .faq ul) {
+		margin-left: 3.2rem;
+	}
+</style>

site/src/routes/faq/rss.xml.js

@@ -0,0 +1,42 @@
+import send from '@polka/send';
+import get_posts from '../blog/_posts.js';
+
+const months = ',Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec'.split(',');
+
+function formatPubdate(str) {
+	const [y, m, d] = str.split('-');
+	return `${d} ${months[+m]} ${y} 12:00 +0000`;
+}
+
+const rss = `
+<?xml version="1.0" encoding="UTF-8" ?>
+<rss version="2.0">
+
+<channel>
+	<title>Svelte blog</title>
+	<link>https://svelte.dev/blog</link>
+	<description>News and information about the magical disappearing UI framework</description>
+	<image>
+		<url>https://svelte.dev/favicon.png</url>
+		<title>Svelte</title>
+		<link>https://svelte.dev/blog</link>
+	</image>
+	${get_posts().filter(post => !post.metadata.draft).map(post => `
+		<item>
+			<title>${post.metadata.title}</title>
+			<link>https://svelte.dev/blog/${post.slug}</link>
+			<description>${post.metadata.description}</description>
+			<pubDate>${formatPubdate(post.metadata.pubdate)}</pubDate>
+		</item>
+	`).join('')}
+</channel>
+
+</rss>
+`.replace(/>[^\S]+/gm, '>').replace(/[^\S]+</gm, '<').trim();
+
+export function get(req, res) {
+	send(res, 200, rss, {
+		'Cache-Control': `max-age=${30 * 60 * 1e3}`,
+		'Content-Type': 'application/rss+xml'
+	});
+}