Crear una carpeta

Crear una carpeta en la documentación es muy sencillo. Gracias Starlight, solo tenemos que dirigirnos a la carpeta raiz, y encontrar el archivo astro.config.mjs. Al entrar observara algo tal que asi:

// @ts-check
import { defineConfig } from "astro/config";
import starlight from "@astrojs/starlight";

// https://astro.build/config
export default defineConfig({
  integrations: [
    starlight({
      title: "Documentación GM",
      social: {
        github: "http://192.168.2.248:3000/GM-Transport",
      },
      customCss: ["./src/styles/global.css"],
      logo: {
        src: "./src/assets/gm-logo-rounded.png",
        alt: "Logo",
      },
      sidebar: [
        {
          label: "Inicio",
          autogenerate: { directory: "introduction" },
        },
        {
          label: "Configuración de StarLight",
          autogenerate: { directory: "star-light" },
          collapsed: true,
        },
      ],
    }),
  ],
});

Para crear una carpeta, solo debemos agregar un nuevo objeto al arreglo sidebar con la siguiente estructura:

{
  label: "Nombre de la carpeta",
  autogenerate: { directory: "nombre-de-la-carpeta" },
  collapsed: true,
},

Donde Nombre de la carpeta es el nombre que deseas que tenga la carpeta en el menú lateral, y nombre-de-la-carpeta es el nombre de la carpeta que deseas crear en la documentación. Por ejemplo, si deseas crear una carpeta llamada Ejemplos, el objeto se vería así:

{
  label: "Ejemplos",
  autogenerate: { directory: "ejemplos" },
  collapsed: true,
},

Cabe destacar que para que esto funcione, debe existir una carpeta con el nombre ejemplos en la carpeta src/content/docs/. Si no existe, debes crearla manualmente. Una vez creada, al publicar los cambios, la carpeta Ejemplos aparecerá en el menú lateral de la documentación. Y listo, ya has creado una carpeta en la documentación de Arquitectura de Software de la empresa GM Transport.

Escrito por: Omar Flores Salazar