Customization du template des pour préparer le terrain pour les licences et Ajout du copyleft et unlicenced.

Reviewed-on: Open-Harbor/astro-open-source-quebec#2
Reviewed-by: Mathias Beaulieu-Duncan <mathias@openharbor.io>

astro.config.mjs

@@ -36,7 +36,12 @@ export default defineConfig({
 			social: { // todo: implement gitea social
 				github: 'https://git.quebec',
 			},
-			sidebar: sidebarFr
+			sidebar: sidebarFr,
+			components: {
+				TwoColumnContent: './src/components/TwoColumnContent.astro',
+				ContentPanel: './src/components/CtaContentPanel.astro',
+				Footer: './src/components/FooterWithCta.astro',
+			},
 		}),
 	],
 	redirects: {

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "",
+  "name": "opensource.quebec",
   "type": "module",
   "version": "0.0.1",
   "scripts": {

src/components/CtaContentPanel.astro

@@ -0,0 +1,30 @@
+---
+import Default from '@astrojs/starlight/components/ContentPanel.astro';
+
+const { entry, ...props } = Astro.props;
+---
+<div class="content-panel">
+    <div class="sl-container"><slot /></div>
+</div>
+
+<style>
+    .content-panel {
+        padding: 1.5rem var(--sl-content-pad-x);
+    }
+    .content-panel + .content-panel {
+        border-top: 1px solid var(--sl-color-hairline);
+    }
+    .sl-container {
+        max-width: var(--sl-content-width);
+    }
+
+    .sl-container > :global(* + *) {
+        margin-top: 1.5rem;
+    }
+
+    @media (min-width: 72rem) {
+        .sl-container {
+            margin-inline: var(--sl-content-margin-inline, auto);
+        }
+    }
+</style>

src/components/FooterWithCta.astro

@@ -0,0 +1,67 @@
+---
+import type { Props } from '@astrojs/starlight/props';
+
+import EditLink from 'virtual:starlight/components/EditLink';
+import LastUpdated from 'virtual:starlight/components/LastUpdated';
+import Pagination from 'virtual:starlight/components/Pagination';
+import config from 'virtual:starlight/user-config';
+import {Icon} from '@astrojs/starlight/components';
+import CTA from "../content/components/CTA.astro";
+
+const { entry, ...props } = Astro.props;
+---
+
+<footer class="sl-flex">
+    <div class="meta sl-flex">
+        {entry.data.cta &&
+            <div>{entry.data.cta}</div>
+            <CTA title="CTA du footer" />
+        }
+    </div>
+    <div class="meta sl-flex">
+        <EditLink {...Astro.props} />
+        <LastUpdated {...Astro.props} />
+    </div>
+    <Pagination {...Astro.props} />
+
+    {
+        config.credits && (
+                    <a class="kudos sl-flex" href="https://starlight.astro.build">
+                        <Icon name={'starlight'} /> {Astro.locals.t('builtWithStarlight.label')}
+                    </a>
+        )
+    }
+</footer>
+
+<style>
+    footer {
+        flex-direction: column;
+        gap: 1.5rem;
+    }
+    .meta {
+        gap: 0.75rem 3rem;
+        justify-content: space-between;
+        flex-wrap: wrap;
+        margin-top: 3rem;
+        font-size: var(--sl-text-sm);
+        color: var(--sl-color-gray-3);
+    }
+    .meta > :global(p:only-child) {
+        margin-inline-start: auto;
+    }
+
+    .kudos {
+        align-items: center;
+        gap: 0.5em;
+        margin: 1.5rem auto;
+        font-size: var(--sl-text-xs);
+        text-decoration: none;
+        color: var(--sl-color-gray-3);
+    }
+    .kudos :global(svg) {
+        color: var(--sl-color-orange);
+    }
+    .kudos:hover {
+        color: var(--sl-color-white);
+    }
+</style>

src/components/TwoColumnContent.astro

@@ -0,0 +1,22 @@
+---
+import Default from '@astrojs/starlight/components/TwoColumnContent.astro';
+
+const { entry, ...props } = Astro.props;
+
+const isProd = import.meta.env.PROD;
+const isDev = import.meta.env.DEV;
+---
+
+<Default>
+    <slot />
+    <slot name="right-sidebar" slot="right-sidebar" />
+
+    {isDev &&
+        <div>
+            <strong>Débug</strong>
+            <label>Props</label> <pre>{Object.keys(Astro.props).toString()}</pre>
+            <label>Entry</label> <pre>{Object.keys(entry).toString()}</pre>
+            <label>Data</label> <pre>{Object.keys(entry.data).toString()}</pre>
+        </div>
+    }
+</Default>

src/content.config.ts

@@ -1,7 +1,14 @@
-import { defineCollection } from 'astro:content';
+import { z, defineCollection } from 'astro:content';
 import { docsLoader } from '@astrojs/starlight/loaders';
 import { docsSchema } from '@astrojs/starlight/schema';
 
 export const collections = {
-	docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+	docs: defineCollection({
-};
+		loader: docsLoader(),
+		schema: docsSchema({
+			extend: z.object({
+				cta: z.string().optional(),
+			})
+		})
+	}),
+};

src/content/components/CTA.astro

@@ -0,0 +1,12 @@
+---
+import {Icon} from '@astrojs/starlight/components';
+import type { Icons } from '@astrojs/starlight/components/Icons';
+
+interface Props {
+    icon?: keyof typeof Icons;
+    title?: string;
+}
+const { icon, title } = Astro.props;
+---
+
+{title ?? "title"}{icon && <Icon name={icon} class="icon" size="1.333em" />}

src/content/docs/fr/guides/licences/Introduction-aux-licences-pour-le-code.mdx

@@ -0,0 +1,77 @@
+---
+title: Introduction aux licences applicable au code
+description: Gnu, GPL, MIT, etc. Une introduction aux licences pour le code.
+author: L'équipe OSQ
+lastUpdated: 2025-01-30
+draft: false
+---
+
+import {Aside, Card, CardGrid, LinkButton} from "@astrojs/starlight/components";
+
+## Qu'est-ce qu'une licence
+C'est un texte légal qui accompagne le code pour déterminer quel est l'entente entre le développeur et celui qui utilise le code.
+
+## Quels critères prioriser pour son projet
+
+## Les licences principales
+
+<CardGrid>
+    <Card title="Apache">
+        <LinkButton
+            href="/fr/guides/licences/apache/"
+            variant="secondary"
+            iconPlacement="end">
+            Plus d'informations
+        </LinkButton>
+    </Card>
+    <Card title="GNU">
+        <LinkButton
+            href="/fr/guides/licences/gnu/"
+            variant="secondary"
+            iconPlacement="end">
+            Plus d'informations
+        </LinkButton>
+    </Card>
+    <Card title="GPL">
+        <LinkButton
+            href="/fr/guides/licences/gpl/"
+            variant="secondary"
+            iconPlacement="end">
+            Plus d'informations
+        </LinkButton>
+    </Card>
+    <Card title="MIT">
+        <LinkButton
+            href="/fr/guides/licences/mit/"
+            variant="secondary"
+            iconPlacement="end">
+            Plus d'informations
+        </LinkButton>
+    </Card>
+</CardGrid>
+
+## Les licences plus par rapport à la gestion de la communauté
+
+<CardGrid>
+    <Card title="DBAD">
+
+        <LinkButton
+            href="/fr/guides/licences/dbad/"
+            variant="secondary"
+            iconPlacement="end">
+            Plus d'informations
+        </LinkButton>
+    </Card>
+</CardGrid>
+
+## Plus de lecture
+
+### Anglais
+- [Page wikipedia sur les types de licences opensource](https://en.wikipedia.org/wiki/Open-source_license)
+- [Listes de licence pour des projets gratuits](https://en.wikipedia.org/wiki/Category:Free_and_open-source_software_licenses)
+
+
+
+<Aside type="danger" title={"Notes importantes"}>
+    Ceci n'est pas un conseil légal, il sert uniquement à accélérer l'apprentissage par rapport à la publication de code. Si vous avez un plan d'affaires ou du code, consultez un avocat pour vous conseiller.
+</Aside>

src/content/docs/fr/guides/licences/apache.mdx

@@ -0,0 +1,7 @@
+---
+title: Apache
+description: apache
+author: L'équipe OSQ
+lastUpdated: 2025-01-30
+draft: false
+---

src/content/docs/fr/guides/licences/copyleft.mdx

@@ -0,0 +1,8 @@
+---
+title: Copyleft
+description: Copyleft
+author: L'équipe OSQ
+lastUpdated: 2025-03-05
+draft: false
+cta: https://www.gnu.org/philosophy/free-sw.html
+---

src/content/docs/fr/guides/licences/dbad.mdx

@@ -0,0 +1,7 @@
+---
+title: DBAD
+description: DBAD
+author: L'équipe OSQ
+lastUpdated: 2025-01-30
+draft: false
+---

src/content/docs/fr/guides/licences/gnu.mdx

@@ -0,0 +1,7 @@
+---
+title: GNU
+description: GNU
+author: L'équipe OSQ
+lastUpdated: 2025-01-30
+draft: false
+---

src/content/docs/fr/guides/licences/gpl.mdx

@@ -0,0 +1,7 @@
+---
+title: GPL
+description: GPL
+author: L'équipe OSQ
+lastUpdated: 2025-01-30
+draft: false
+---

src/content/docs/fr/guides/licences/mit.mdx

@@ -0,0 +1,7 @@
+---
+title: MIT
+description: MIT
+author: L'équipe OSQ
+lastUpdated: 2025-01-30
+draft: false
+---

src/content/docs/fr/guides/licences/unlicenced.mdx

@@ -0,0 +1,14 @@
+---
+title: Unlicense
+description: Permet de publier votre code dans le domaine public plus facilement grâce au travail qui a été fait pour SQLite
+author: L'équipe OSQ
+lastUpdated: 2025-03-05
+draft: false
+cta: https://unlicense.org/
+---
+
+## La grosse différence avec le copyleft
+
+C'est qu'il y a eu un travail légal fait pour libérer les droits des contributeurs et la même protection de sans garantie comme la licence MIT.
+
+https://ar.to/2010/01/dissecting-the-unlicense

src/sidebars/fr/sidebar.ts

@@ -19,6 +19,32 @@
           }
         ]
       },
+      {
+        label: 'Licences',
+        items: [
+          {
+            slug: 'guides/licences/introduction-aux-licences-pour-le-code',
+          },
+          {
+            slug: 'guides/licences/apache'
+          },
+          {
+            slug: 'guides/licences/gnu'
+          },
+          {
+            slug: 'guides/licences/gpl'
+          },
+          {
+            slug: 'guides/licences/mit'
+          },
+          {
+            slug: 'guides/licences/unlicenced'
+          },
+          {
+            slug: 'guides/licences/copyleft'
+          }
+        ]
+      },
     ],
   },
   {