feat(astro): support lessons without parts or chapters (#374)

Author: AriPerkkio

docs/tutorialkit.dev/src/content/docs/guides/creating-content.mdx

@@ -3,6 +3,7 @@ title: Content creation
 description: 'Creating content in TutorialKit.'
 ---
 import { FileTree } from '@astrojs/starlight/components';
+import { Tabs, TabItem } from '@astrojs/starlight/components';
 
 From an information architecture perspective, tutorial content is divided into **parts**, which are further divided into **chapters**, each consisting of **lessons**.
 
@@ -36,6 +37,64 @@ This structure is reflected in the directory structure of your TutorialKit proje
 
 Navigate into one of these folders to see another folder that represents a **chapter**. Inside the chapter folder, you will find one or more **lesson** folders.
 
+You can also omit parts or chapters such that you only have lessons or only lessons and parts. Here are a few examples:
+
+<Tabs>
+  <TabItem label="Structure">
+    ```plaintext
+    - Lesson 1: Getting started
+    - Lesson 2: Adding pages
+    ```
+  </TabItem>
+
+  <TabItem label="File tree">
+    <FileTree>
+      - src
+        - content
+          - tutorial
+            - getting-started
+              - _files/
+              - _solution/
+              - content.md
+            - adding-pages/
+            - meta.md
+        - config.ts
+        - templates/
+    </FileTree>
+  </TabItem>
+</Tabs>
+
+<Tabs>
+  <TabItem label="Structure">
+    ```plaintext
+    - Part 1: Introduction
+      - Lesson 1: What is Vite?
+      - Lesson 2: Installing
+        - …
+    - Part 2: Project structure
+        - …
+    ```
+  </TabItem>
+
+  <TabItem label="File tree">
+    <FileTree>
+      - src
+        - content
+          - tutorial
+            - introduction/
+              - what-is-vite/
+                - _files/
+                - _solution/
+                - content.md
+              - installing/
+            - project-structure/
+            - meta.md
+        - config.ts
+        - templates/
+    </FileTree>
+  </TabItem>
+</Tabs>
+
 ## A lesson content file
 
 Navigate to the `src/content/tutorial/1-basics/1-introduction/1-welcome` folder and open the `content.md` in your editor. You will see a file structured like this:

e2e/configs/lessons-in-part.ts

@@ -0,0 +1,10 @@
+import tutorialkit from '@tutorialkit/astro';
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+  devToolbar: { enabled: false },
+  server: { port: 4332 },
+  outDir: './dist-lessons-in-part',
+  integrations: [tutorialkit()],
+  srcDir: './src-custom/lessons-in-part',
+});

e2e/configs/lessons-in-root.ts

@@ -0,0 +1,10 @@
+import tutorialkit from '@tutorialkit/astro';
+import { defineConfig } from 'astro/config';
+
+export default defineConfig({
+  devToolbar: { enabled: false },
+  server: { port: 4331 },
+  outDir: './dist-lessons-in-root',
+  integrations: [tutorialkit()],
+  srcDir: './src-custom/lessons-in-root',
+});

e2e/package.json

@@ -7,6 +7,10 @@
     "preview": "astro build && astro preview",
     "dev:override-components": "astro dev --config ./configs/override-components.ts",
     "preview:override-components": "astro build --config ./configs/override-components.ts && astro preview --config ./configs/override-components.ts",
+    "dev:lessons-in-root": "astro dev --config ./configs/lessons-in-root.ts",
+    "preview:lessons-in-root": "astro build --config ./configs/lessons-in-root.ts && astro preview --config ./configs/lessons-in-root.ts",
+    "dev:lessons-in-part": "astro dev --config ./configs/lessons-in-part.ts",
+    "preview:lessons-in-part": "astro build --config ./configs/lessons-in-part.ts && astro preview --config ./configs/lessons-in-part.ts",
     "test": "playwright test",
     "test:ui": "pnpm run test --ui"
   },

e2e/playwright.config.ts

@@ -1,33 +1,59 @@
 import { defineConfig } from '@playwright/test';
 
+const serverOptions = {
+  reuseExistingServer: !process.env.CI,
+  stdout: 'ignore',
+  stderr: 'pipe',
+} as const;
+
 export default defineConfig({
   projects: [
     {
       name: 'Default',
       testMatch: 'test/*.test.ts',
-      testIgnore: 'test/*.override-components.test.ts',
+      testIgnore: [
+        'test/*.override-components.test.ts',
+        'test/*.lessons-in-part.test.ts',
+        'test/*.lessons-in-root.test.ts',
+      ],
       use: { baseURL: 'http://localhost:4329' },
     },
     {
       name: 'Override Components',
       testMatch: 'test/*.override-components.test.ts',
       use: { baseURL: 'http://localhost:4330' },
     },
+    {
+      name: 'Lessons in root',
+      testMatch: 'test/*.lessons-in-root.test.ts',
+      use: { baseURL: 'http://localhost:4331' },
+    },
+    {
+      name: 'Lessons in part',
+      testMatch: 'test/*.lessons-in-part.test.ts',
+      use: { baseURL: 'http://localhost:4332' },
+    },
   ],
   webServer: [
     {
       command: 'pnpm preview',
       url: 'http://localhost:4329',
-      reuseExistingServer: !process.env.CI,
-      stdout: 'ignore',
-      stderr: 'pipe',
+      ...serverOptions,
     },
     {
       command: 'pnpm preview:override-components',
       url: 'http://localhost:4330',
-      reuseExistingServer: !process.env.CI,
-      stdout: 'ignore',
-      stderr: 'pipe',
+      ...serverOptions,
+    },
+    {
+      command: 'pnpm preview:lessons-in-root',
+      url: 'http://localhost:4331',
+      ...serverOptions,
+    },
+    {
+      command: 'pnpm preview:lessons-in-part',
+      url: 'http://localhost:4332',
+      ...serverOptions,
     },
   ],
   expect: {

e2e/src-custom/lessons-in-part/content/config.ts

@@ -0,0 +1,9 @@
+import { contentSchema } from '@tutorialkit/types';
+import { defineCollection } from 'astro:content';
+
+const tutorial = defineCollection({
+  type: 'content',
+  schema: contentSchema,
+});
+
+export const collections = { tutorial };

e2e/src-custom/lessons-in-part/content/tutorial/meta.md

@@ -0,0 +1,5 @@
+---
+type: tutorial
+mainCommand: ''
+prepareCommands: []
+---

e2e/src-custom/lessons-in-part/content/tutorial/part-one/lesson-1/content.md

@@ -0,0 +1,8 @@
+---
+type: lesson
+title: Lesson one
+---
+
+# Lessons in part test - Lesson one
+
+Lesson in part without chapter

e2e/src-custom/lessons-in-part/content/tutorial/part-one/lesson-2/content.md

@@ -0,0 +1,8 @@
+---
+type: lesson
+title: Lesson two
+---
+
+# Lessons in part test - Lesson two
+
+Lesson in part without chapter

e2e/src-custom/lessons-in-part/content/tutorial/part-one/meta.md

@@ -0,0 +1,4 @@
+---
+type: part
+title: 'Part one'
+---