broken anchors

caesay · caesay · commit fa1dd584873f · 2026-05-31T08:42:06.000+01:00
diff --git a/docs/troubleshooting/faq.mdx b/docs/troubleshooting/faq.mdx
@@ -9,7 +9,7 @@ Commonly asked questions about Velopack.
 - **Can Velopack bootstrap new runtimes during updates?** <br/>
   Yes, this is fully supported. Before installing updates, Velopack will prompt the user to install any missing runtimes.
 - **How do I install the `vpk` tool? / I've installed the tool but it doesn't work**
-  You need to install the [.NET 8 SDK or later](../packaging/runtime.mdx#supported-frameworks) for your platform, and then run `dotnet tool install -g vpk`. 
+  You need to install the [.NET 8 SDK or later](https://dotnet.microsoft.com/download) for your platform, and then run `dotnet tool install -g vpk`. 
   It's recommended to use the same version of `vpk` as the Velopack package referenced in your application to ensure compatibility.
   Alternatively, you can run `vpk` without installing it globally using the [`dnx`](https://learn.microsoft.com/dotnet/core/tools/dotnet-tool-exec?WT.mc_id=DT-MVP-5003472) command: `dnx vpk --version 1.0.0` (replace `1.0.0` with your Velopack package version).
   If you get a message that it was installed successfully, but running it in your terminal results in a "binary/command not found" message, it's probably because your PATH is not set-up properly. For windows, `%USERPROFILE%\.dotnet\tools` should be on the PATH. For macos, [see this issue](https://github.com/dotnet/sdk/issues/9415). In general, dotnet should set these paths up for you, but that is what you should check if things are not working.
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
@@ -1,78 +1,128 @@
-import { themes as prismThemes } from 'prism-react-renderer';
-import type { Config } from '@docusaurus/types';
-import type * as Preset from '@docusaurus/preset-classic';
+import { themes as prismThemes } from "prism-react-renderer";
+import type { Config } from "@docusaurus/types";
+import type * as Preset from "@docusaurus/preset-classic";
 
 const config: Config = {
-  title: 'Velopack',
-  tagline: 'Installer and automatic update framework for cross-platform desktop applications',
-  favicon: 'favicon/favicon.ico',
-  url: 'https://docs.velopack.io/',
-  baseUrl: '/',
+  title: "Velopack",
+  tagline:
+    "Installer and automatic update framework for cross-platform desktop applications",
+  favicon: "favicon/favicon.ico",
+  url: "https://docs.velopack.io/",
+  baseUrl: "/",
   trailingSlash: false,
-  organizationName: 'velopack',
-  projectName: 'velopack.docs',
-  onBrokenLinks: 'throw',
+  organizationName: "velopack",
+  projectName: "velopack.docs",
+  onBrokenLinks: "throw",
+  onBrokenAnchors: "throw",
   i18n: {
-    defaultLocale: 'en',
-    locales: ['en', 'es'],
+    defaultLocale: "en",
+    locales: ["en", "es"],
     localeConfigs: {
-      en: { label: 'English', htmlLang: 'en' },
-      es: { label: 'Español', htmlLang: 'es' },
+      en: { label: "English", htmlLang: "en" },
+      es: { label: "Español", htmlLang: "es" },
     },
   },
   customFields: {
-    flowBaseUrl: 'https://app.velopack.io',
+    flowBaseUrl: "https://app.velopack.io",
   },
   themes: [
-    ['@easyops-cn/docusaurus-search-local', {
-      hashed: true,
-      indexBlog: false,
-      docsRouteBasePath: '/',
-      ignoreFiles: new RegExp(".*reference/.*"),
-      language: ['en', 'es'],
-    }],
-    '@docusaurus/theme-mermaid'
+    [
+      "@easyops-cn/docusaurus-search-local",
+      {
+        hashed: true,
+        indexBlog: false,
+        docsRouteBasePath: "/",
+        ignoreFiles: new RegExp(".*reference/.*"),
+        language: ["en", "es"],
+      },
+    ],
+    "@docusaurus/theme-mermaid",
   ],
   plugins: [
-    ['@docusaurus/plugin-client-redirects', {
-      redirects: [
-        { from: '/packaging/rid', to: '/packaging/runtime' },
-        { from: '/troubleshooting/cli', to: '/reference/cli' },
-        { from: '/category/quick-start', to: '/category/getting-started' },
-      ],
-    }],
+    [
+      "@docusaurus/plugin-client-redirects",
+      {
+        redirects: [
+          { from: "/packaging/rid", to: "/packaging/runtime" },
+          { from: "/troubleshooting/cli", to: "/reference/cli" },
+          { from: "/category/quick-start", to: "/category/getting-started" },
+        ],
+      },
+    ],
   ],
   headTags: [
     // Favicon
-    { tagName: 'link', attributes: { rel: 'shortcut icon', href: '/favicon/favicon.ico' } },
-    { tagName: 'link', attributes: { rel: 'apple-touch-icon', sizes: '180x180', href: '/favicon/apple-touch-icon.png' } },
-    { tagName: 'link', attributes: { rel: 'icon', type: 'image/png', sizes: '32x32', href: '/favicon/icon_32.png' } },
-    { tagName: 'link', attributes: { rel: 'icon', type: 'image/png', sizes: '16x16', href: '/favicon/icon_16.png' } },
-    { tagName: 'link', attributes: { rel: 'manifest', href: '/favicon/site.webmanifest' } },
-    { tagName: 'link', attributes: { rel: 'mask-icon', href: '/favicon/safari-pinned-tab.svg', color: '#edd323' } },
-    { tagName: 'meta', attributes: { name: 'msapplication-TileColor', content: '#000000' } },
-    { tagName: 'meta', attributes: { name: 'theme-color', content: '#ffffff' } },
+    {
+      tagName: "link",
+      attributes: { rel: "shortcut icon", href: "/favicon/favicon.ico" },
+    },
+    {
+      tagName: "link",
+      attributes: {
+        rel: "apple-touch-icon",
+        sizes: "180x180",
+        href: "/favicon/apple-touch-icon.png",
+      },
+    },
+    {
+      tagName: "link",
+      attributes: {
+        rel: "icon",
+        type: "image/png",
+        sizes: "32x32",
+        href: "/favicon/icon_32.png",
+      },
+    },
+    {
+      tagName: "link",
+      attributes: {
+        rel: "icon",
+        type: "image/png",
+        sizes: "16x16",
+        href: "/favicon/icon_16.png",
+      },
+    },
+    {
+      tagName: "link",
+      attributes: { rel: "manifest", href: "/favicon/site.webmanifest" },
+    },
+    {
+      tagName: "link",
+      attributes: {
+        rel: "mask-icon",
+        href: "/favicon/safari-pinned-tab.svg",
+        color: "#edd323",
+      },
+    },
+    {
+      tagName: "meta",
+      attributes: { name: "msapplication-TileColor", content: "#000000" },
+    },
+    {
+      tagName: "meta",
+      attributes: { name: "theme-color", content: "#ffffff" },
+    },
   ],
   markdown: {
-    format: 'detect',
+    format: "detect",
     mermaid: true,
     hooks: {
-      onBrokenMarkdownLinks: 'throw',
+      onBrokenMarkdownLinks: "throw",
     },
   },
   presets: [
     [
-      'classic',
+      "classic",
       {
         docs: {
-          sidebarPath: './sidebars.ts',
-          routeBasePath: '/',
+          sidebarPath: "./sidebars.ts",
+          routeBasePath: "/",
           editUrl: ({ versionDocsDirPath, docPath, locale }) => {
             let match;
             if ((match = docPath.match(/reference\/.*/)) != null) {
               return undefined; // reference pages can't be edited
             }
-            if (locale != 'en') {
+            if (locale != "en") {
               return undefined;
               // return 'https://crowdin.com/project/velopack/invite?h=88bec14b5657f004fe5ba325090df5ba2031736';
             }
@@ -85,69 +135,69 @@ const config: Config = {
           showReadingTime: true,
         },
         theme: {
-          customCss: './src/css/custom.css',
+          customCss: "./src/css/custom.css",
         },
         gtag: {
-          trackingID: 'G-YM5CQ7KMDT',
+          trackingID: "G-YM5CQ7KMDT",
           anonymizeIP: true,
-        }
+        },
       } satisfies Preset.Options,
     ],
   ],
 
   themeConfig: {
-    image: 'logo/opengraph.png',
+    image: "logo/opengraph.png",
     colorMode: {
       respectPrefersColorScheme: true,
     },
     navbar: {
       // title: 'Velopack',
       hideOnScroll: false,
       logo: {
-        alt: 'Velopack Logo',
-        src: 'logo/velopack-black.svg',
-        srcDark: 'logo/velopack-white.svg',
+        alt: "Velopack Logo",
+        src: "logo/velopack-black.svg",
+        srcDark: "logo/velopack-white.svg",
       },
       items: [
         {
-          type: 'docSidebar',
-          sidebarId: 'mainSidebar',
-          position: 'left',
-          label: 'Guides',
+          type: "docSidebar",
+          sidebarId: "mainSidebar",
+          position: "left",
+          label: "Guides",
         },
         {
-          type: 'docSidebar',
-          sidebarId: 'referenceSidebar',
-          position: 'left',
-          label: 'Reference',
+          type: "docSidebar",
+          sidebarId: "referenceSidebar",
+          position: "left",
+          label: "Reference",
         },
         {
-          to: '/blog',
-          label: 'Blog',
-          position: 'left'
+          to: "/blog",
+          label: "Blog",
+          position: "left",
         },
         {
-          type: 'localeDropdown',
-          position: 'right',
+          type: "localeDropdown",
+          position: "right",
         },
         {
-          href: 'https://github.com/velopack/velopack',
-          position: 'right',
-          className: 'header-icon header-icon-github',
-          'aria-label': 'GitHub repository',
+          href: "https://github.com/velopack/velopack",
+          position: "right",
+          className: "header-icon header-icon-github",
+          "aria-label": "GitHub repository",
         },
         {
-          href: 'https://discord.gg/CjrCrNzd3F',
-          position: 'right',
-          className: 'header-icon header-icon-discord',
-          'aria-label': 'Discord invite',
+          href: "https://discord.gg/CjrCrNzd3F",
+          position: "right",
+          className: "header-icon header-icon-discord",
+          "aria-label": "Discord invite",
         },
       ],
     },
     docs: {
       sidebar: {
         autoCollapseCategories: true,
-      }
+      },
     },
     // footer: {
     //   style: 'dark',
@@ -195,7 +245,16 @@ const config: Config = {
     //   copyright: `Copyright © ${new Date().getFullYear()} Velopack Ltd.`,
     // },
     prism: {
-      additionalLanguages: ['csharp', 'rust', 'cpp', 'batch', 'powershell', 'java', 'toml', 'json'],
+      additionalLanguages: [
+        "csharp",
+        "rust",
+        "cpp",
+        "batch",
+        "powershell",
+        "java",
+        "toml",
+        "json",
+      ],
       theme: prismThemes.oneLight,
       darkTheme: prismThemes.nightOwl,
     },
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/integrating/overview.mdx b/i18n/es/docusaurus-plugin-content-docs/current/integrating/overview.mdx
@@ -108,10 +108,10 @@ Los deltas mantienen las descargas pequeñas, pero Velopack recurrirá a una des
 - Si el tamaño combinado de los deltas es mayor que el paquete completo, se descarga el paquete completo en su lugar.
 - Si no hay un paquete base local sobre el que aplicar los deltas, los deltas se deshabilitan. Dado que solo las instalaciones de Windows (instalador) incluyen un `.nupkg` completo, la primera actualización después de una instalación que no sea Windows es siempre una descarga completa.
 
-#### Concurrencia y reanudación
+#### Concurrencia y reanudación {#concurrency--resuming}
 `DownloadUpdatesAsync` adquiere un bloqueo global por aplicación (un archivo `.velopack_lock` en el directorio de paquetes) para que solo se ejecute una operación de descarga/aplicación a la vez. Si ya hay otra operación en curso, lanza `AcquireLockFailedException`. Si el paquete completo ya existe en el disco, se omite la descarga, y las descargas en curso se escriben en archivos `.partial`.
 
-### Aplicar actualizaciones
+### Aplicar actualizaciones {#apply-updates}
 Una vez que la actualización se ha descargado, tienes algunas opciones disponibles. Llamar a `ApplyUpdatesAndRestart` o `ApplyUpdatesAndExit` cerrará tu aplicación, instalará cualquier [requisito previo de bootstrap](../packaging/bootstrapping.mdx), instalará la actualización y luego opcionalmente reiniciará tu aplicación de inmediato.
 
 Si no deseas cerrar tu aplicación de inmediato, puedes llamar a `WaitExitThenApplyUpdates` en su lugar, que iniciará Update.exe y esperará 60 segundos antes de continuar. Si tu aplicación no ha salido dentro de los 60 segundos, será terminada.
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/packaging/installer.mdx b/i18n/es/docusaurus-plugin-content-docs/current/packaging/installer.mdx
@@ -22,7 +22,7 @@ El instalador de Windows extraerá la aplicación en `%LocalAppData%\{packId}`.
 
 El directorio `current` será completamente reemplazado [durante las actualizaciones](../integrating/overview.mdx). Los demás archivos añadidos por Velopack (`Update.exe` y `sq.version`) son cruciales y son archivos necesarios para que Velopack pueda actualizar correctamente su aplicación.
 
-### Instalador MSI de Windows
+### Instalador MSI de Windows {#windows-msi-installer}
 Además de `Setup.exe`, Velopack puede generar un instalador `.msi` usando WiX 5. El MSI proporciona integración completa con Windows Installer, incluida la compatibilidad con instalaciones por máquina en Archivos de programa, la implementación mediante directivas de grupo y las entradas estándar de Agregar o quitar programas.
 
 Para habilitar la generación de MSI, añada el indicador `--msi` a su comando `vpk pack`. El MSI se construye junto con `Setup.exe` durante el empaquetado.
diff --git a/i18n/es/docusaurus-plugin-content-docs/current/troubleshooting/faq.mdx b/i18n/es/docusaurus-plugin-content-docs/current/troubleshooting/faq.mdx
@@ -9,7 +9,7 @@ Preguntas frecuentes sobre Velopack.
 - **¿Puede Velopack instalar nuevos runtimes durante las actualizaciones?** <br/>
   Sí, esto es totalmente compatible. Antes de instalar las actualizaciones, Velopack solicitará al usuario que instale los runtimes que falten.
 - **¿Cómo instalo la herramienta `vpk`? / Instalé la herramienta pero no funciona**
-  Necesitas instalar el [SDK de .NET 8 o posterior](../packaging/runtime.mdx#supported-frameworks) para tu plataforma, y luego ejecutar `dotnet tool install -g vpk`. 
+  Necesitas instalar el [SDK de .NET 8 o posterior](https://dotnet.microsoft.com/download) para tu plataforma, y luego ejecutar `dotnet tool install -g vpk`. 
   Se recomienda usar la misma versión de `vpk` que el paquete de Velopack referenciado en tu aplicación para garantizar la compatibilidad.
   Alternativamente, puedes ejecutar `vpk` sin instalarlo globalmente usando el comando [`dnx`](https://learn.microsoft.com/dotnet/core/tools/dotnet-tool-exec?WT.mc_id=DT-MVP-5003472): `dnx vpk --version 1.0.0` (reemplaza `1.0.0` con la versión de tu paquete de Velopack).
   Si recibes un mensaje de que se instaló correctamente, pero al ejecutarlo en tu terminal aparece un mensaje de "binary/command not found", probablemente se deba a que tu PATH no está configurado correctamente. En Windows, `%USERPROFILE%\.dotnet\tools` debe estar en el PATH. En macOS, [consulta este problema](https://github.com/dotnet/sdk/issues/9415). En general, dotnet debería configurar estas rutas automáticamente, pero eso es lo que debes verificar si las cosas no funcionan.
