Melloras varias

astro.config.mjs

@@ -1,6 +1,9 @@
 import { defineConfig } from 'astro/config';
 import starlight from '@astrojs/starlight';
 
+import { rehypeHeadingIds } from '@astrojs/markdown-remark'
+import rehypeAutolinkHeadings from 'rehype-autolink-headings'
+
 // https://astro.build/config
 export default defineConfig({
 	integrations: [
@@ -40,4 +43,7 @@ export default defineConfig({
 			],
 		}),
 	],
+	markdown: {
+		rehypePlugins: [rehypeHeadingIds, rehypeAutolinkHeadings],
+	},
 });

package.json

@@ -11,8 +11,10 @@
   },
   "dependencies": {
     "@astrojs/check": "^0.9.4",
+    "@astrojs/markdown-remark": "^6.0.1",
     "@astrojs/starlight": "^0.30.3",
     "astro": "^5.1.0",
+    "rehype-autolink-headings": "^7.1.0",
     "sharp": "^0.33.5",
     "typescript": "^5.7.2"
   },

src/components/ExternalLink.astro

@@ -0,0 +1,21 @@
+---
+// accept the href prop from the MDX file
+// check if the link is external
+// if it is, add target="_blank" and rel="noopener noreferrer"
+// maintain a <slot /> for the link text
+// accept the href prop from the MDX file
+const { href }: Record<string, any> = Astro.props;
+
+const domain = import.meta.env.SITE; // pulls from astro.config.mjs
+let attr: { target?: string; rel?: string } = {};
+
+// check if the link is external
+if (!href.includes(domain) && !href.startsWith("/") && !href.startsWith("#")) {
+  // if it is, add target="_blank" and rel="noopener noreferrer"
+  attr["target"] = "_blank";
+  attr["rel"] = "noopener noreferrer";
+}
+---
+
+<!-- add attributes and maintain a <slot /> for the link text -->
+<a href={href} {...attr}><slot /></a>

src/content/docs/guides/css/00-introducion.md

@@ -6,7 +6,7 @@ description: Follas de estilo en cascada...
 
 CSS (Cascading Style Sheets) é unha linguaxe de estilos utilizada para describir a presentación dun documento escrito en HTML ou XML (incluíndo vários formatos de XML como SVG ou XHTML). A principal función do CSS é controlar o aspecto visual e o formato do contido das páxinas web, permitindo separar o contido (HTML) da súa presentación (CSS).
 
-### Principais conceptos de CSS:
+### Principais conceptos de CSS
 
 1. **[Selectores](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors):** Permiten apuntar elementos HTML específicos e aplicarlles estilos. Pódese seleccionar por **[etiquetas HTML](https://developer.mozilla.org/en-US/docs/Web/CSS/Type_selectors)**, **[clases](https://developer.mozilla.org/es/docs/Web/CSS/Class_selectors)**, **[identificadores](https://developer.mozilla.org/es/docs/Web/CSS/ID_selectors)**, **[atributos](https://developer.mozilla.org/es/docs/Web/CSS/Attribute_selectors)** ou **[relacións entre elementos](https://developer.mozilla.org/en-US/docs/Web/CSS/Child_combinator)**.
 
@@ -57,7 +57,7 @@ CSS (Cascading Style Sheets) é unha linguaxe de estilos utilizada para describi
 
 5. **[Herdanza](https://developer.mozilla.org/es/docs/Learn/CSS/Building_blocks/Cascade_and_inheritance):** Algúns estilos aplicados a un elemento poden ser herdados por elementos fillos.
 
-### Sintaxe básica de CSS:
+### Sintaxe básica de CSS
 
 Unha regra CSS consta dun selector e un conxunto de propiedades e valores separados por dous puntos (:). O conxunto de propiedade-valor vai seguido por un punto e coma (;). As regras CSS normalmente son escritas nun arquivo separado coa extensión `.css` ou tamén poden ser incluídas internamente nun documento HTML.
 
@@ -99,6 +99,6 @@ Exemplo de uso externo:
 </html>
 ```
 
-### Conclusión:
+### Conclusión
 
 O CSS é unha ferramenta poderosa para controlar a aparencia visual das páxinas web, permitindo unha presentación máis atractiva e unha separación máis clara entre o contido e a súa presentación. É fundamental para a creación de sitios web modernos e responsivos.

src/content/docs/guides/html/00-introducion.md

@@ -69,14 +69,14 @@ HTML foi desenvolvido a partir da metanlinguaxe **SGML** (Standard Generalized M
 
 ## Que se necesita para escribir código HTML?
 
-HTML é texto, un tipo especial de texto pero texto ao fin. Isto fai que non exixa grandes requirimentos, abonda con contar cun editor de texto plano ou *bloc de notas*, que se pode atopar en calquera sistema operativo.
+HTML é texto, un tipo especial de texto pero texto ao fin e ao cabo. Isto fai que non exixa grandes requirimentos, abonda con contar cun editor de texto plano ou *bloc de notas*, que se pode atopar en calquera sistema operativo.
 
 Certo é que existen aplicacións especiais que ofrecen facilidades á hora de escribir: os editores de código.  Son aqueles editores con funcionalidades como:
 
 - o **resaltado cromático** das etiquetas, que ofrece unha visión máis clara do código e permite detectar erros sintácticos ou de aniñado. 
 - o **autocompletado**, que propón formas de expander ou completar etiquetas, incluso pechalas automaticamente.
 
-Tamén existen os editores **WYSIWYG** - *"What You See Is What You Get" ("O que ves é o que obtés")*-, que permiten escribir e ver o resultado en tempo real, desenvolvidos co obxectivo de permitir crear código HTML sen *case* coñecementos de linguaxe de marcado. Estes editores funcionan de forma similar a un procesador de textos, o texto articúlase mediante **funcións predeterminadas** dispoñibles nun menú, e sen necesidade de escribir manualmente as etiquetas, que o editor xera en segundo plano.
+Tamén existen os editores **WYSIWYG** - *"What You See Is What You Get" ("O que ves é o que obtés")*-, que permiten escribir e ver o resultado en tempo real. Desenvolvidos co obxectivo de permitir crear código HTML sen *case* coñecementos de linguaxe de marcado. Estes editores funcionan de forma similar a un procesador de textos, o texto articúlase mediante **funcións predeterminadas** dispoñibles nun menú, e sen necesidade de escribir manualmente as etiquetas, que o editor xera en segundo plano.
 
 :eye: Descartados os editores de texto tipo *Office*!! :bomb: