Merge branch 'main' into joan/mobile-support

Author: Nemikolh

.github/workflows/ci.yaml

@@ -19,15 +19,13 @@ jobs:
           - os: windows-latest
             node_version: 20.13.1 # 20.14.0 keeps causing a native `node::SetCppgcReference+18123` error in Vitest
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
       - name: Setup
         uses: pnpm/action-setup@v4
-        with:
-          version: 8.15.6
-      - name: Checkout
-        uses: actions/checkout@v4
       - name: Install dependencies
         run: pnpm install
       - name: Lint
@@ -41,12 +39,10 @@ jobs:
     name: Docs
     runs-on: ubuntu-latest
     steps:
-      - name: Setup
-        uses: pnpm/action-setup@v4
-        with:
-          version: 8.15.6
       - name: Checkout
         uses: actions/checkout@v4
+      - name: Setup
+        uses: pnpm/action-setup@v4
       - name: Install dependencies
         run: pnpm install
       - name: Build

.gitignore

@@ -22,3 +22,4 @@ dist-ssr
 tsconfig.tsbuildinfo
 tsconfig.build.tsbuildinfo
 .tmp
+.tmp-*

docs/demo/theme.ts

@@ -179,6 +179,7 @@ export const theme: ConfigBase['theme'] = {
         },
         panel: {
           backgroundColor: 'var(--tk-elements-panel-backgroundColor)',
+          textColor: 'var(--tk-elements-panel-textColor)',
           header: {
             backgroundColor: 'var(--tk-elements-panel-header-backgroundColor)',
             textColor: 'var(--tk-elements-panel-header-textColor)',

docs/tutorialkit.dev/astro.config.ts

@@ -19,7 +19,11 @@ export default defineConfig({
         light: './src/assets/brand/tutorialkit-logo-light.svg',
         replacesTitle: true,
       },
-      plugins: [starlightLinksValidator()],
+      plugins: [
+        starlightLinksValidator({
+          exclude: ['../../guides/**/*'],
+        }),
+      ],
       sidebar: [
         {
           label: 'Guides',
@@ -34,7 +38,7 @@ export default defineConfig({
               link: '/guides/installation/',
             },
             {
-              label: 'Creating a Lesson',
+              label: 'Content creation',
               link: '/guides/creating-content/',
             },
             {
@@ -51,6 +55,15 @@ export default defineConfig({
             },
           ],
         },
+        {
+          label: 'Reference',
+          items: [
+            {
+              label: 'Theming',
+              link: '/reference/theming/',
+            },
+          ],
+        },
       ],
       tableOfContents: {
         maxHeadingLevel: 5,

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

@@ -1,6 +1,6 @@
 ---
-title: Creating a Lesson
-description: 'Creating lessons in TutorialKit.'
+title: Content creation
+description: 'Creating content in TutorialKit.'
 ---
 import { FileTree } from '@astrojs/starlight/components';
 
@@ -109,3 +109,38 @@ template: my-advanced-template
 ```
 
 This declaration will make TutorialKit use the `src/templates/my-advanced-template` directory as the base for the lesson.
+
+If you start having a lot of templates and they all share some files, you can create a shared template that they all extend. This way, you can keep the shared files in one place and avoid duplication. To do that, you need to specify the `extends` property in the template's `.tk-config.json` file:
+
+```json
+{
+  "extends": "../shared-template"
+}
+```
+
+This will make the template inherit all files from the `shared-template` directory. You can then override any file in the template by placing a file with the same name in the template's directory.
+Here's an example of how you can structure your templates:
+
+```
+src/templates
+├── shared-template
+│   ├── index.js
+│   ├── index.html
+│   └── package.json
+│
+└── first-template
+│   │   # Contains { "extends": "../shared-template" }
+│   │   # Inherits all files from "shared-template"
+│   ├── .tk-config.json
+│   │
+│   │   # Only available in first-template
+│   └── main.js
+│
+└── second-template
+    │   # Contains { "extends": "../shared-template" }
+    │   # Inherits all files from "shared-template"
+    ├── .tk-config.json
+    │
+    │   # Overrides "index.js" from "shared-template"
+    └── index.js
+```