docs(web): la web y el manual explican cómo instalar rFirma en macOS

packaging/repo/site/src/components/Install.astro

@@ -126,7 +126,7 @@ flatpak install rfirma me.sgomez.rfirma</pre>
         <div>
           <a
             href="https://github.com/sgomez/rfirma/releases/latest"
-            data-windows-download
+            data-server-download="windows"
             class="rf-btn rf-btn--pill"
             data-btn-brand
             style="text-decoration:none;padding:0 24px;min-height:44px;font-size:.9375rem"
@@ -144,21 +144,37 @@ Select-String rFirma_ .\SHA256SUMS</pre>
 
     <div id="panel-macos" role="tabpanel" aria-labelledby="tab-macos" style="padding-top:24px" hidden>
       <div class="rf-card" style="background:#ffffff;border-color:var(--rf-border-strong);gap:12px">
-        <span style="display:flex;align-items:center;gap:10px;flex-wrap:wrap">
-          <span
-            class="rf-badge"
-            style="border-color:var(--rf-warning-border);background:var(--rf-warning-bg);color:var(--rf-warning-text)"
-            >{t("install.soon")}</span
-          >
-          <strong style="font-size:1rem">{t("install.macos.title")}</strong>
-        </span>
+        <strong style="font-size:1rem">{t("install.macos.title")}</strong>
         <p style="margin:0;font-size:.9375rem;line-height:1.6;color:var(--rf-text-muted)">
           {t("install.macos.body")}
         </p>
+        <div style="position:relative">
+          <button
+            type="button"
+            class="install-copy"
+            data-copy-for="code-macos"
+            aria-label={t("install.copy.macos.aria")}
+          >
+            <span class="install-copy__idle">{t("install.copy")}</span>
+            <span class="install-copy__done">{t("install.copied")}</span>
+          </button>
+          <pre id="code-macos" class="install-code">brew install --cask sgomez/rfirma/rfirma</pre>
+        </div>
+        <div>
+          <a
+            href="https://github.com/sgomez/rfirma/releases/latest"
+            data-server-download="macos"
+            class="rf-btn rf-btn--pill"
+            data-btn-brand
+            style="text-decoration:none;padding:0 24px;min-height:44px;font-size:.9375rem"
+            >{t("install.macos.download")}</a
+          >
+        </div>
         <p
           style="margin:0;font-size:.875rem;line-height:1.6;color:var(--rf-text-muted)"
           set:html={t("install.macos.note")}
         />
+        <pre class="install-code">xattr -c /Applications/rfirma.app</pre>
       </div>
     </div>
 

packaging/repo/site/src/content/docs/manual/instalacion.md

@@ -85,28 +85,44 @@ rFirma pide esos accesos porque los necesita para firmar:
 
 ## Windows
 
-Descarga el instalador `rFirma_*_x64-setup.exe` de la
-[última Release](https://github.com/sgomez/rfirma/releases/latest). Se instala para tu
-usuario, sin permisos de administrador, y usa directamente el almacén de certificados
-de Windows.
+Descarga el instalador desde la [web](https://rfirma.sgomez.me/#instalacion) o la
+[última Release](https://github.com/sgomez/rfirma/releases/latest). Se instala solo para
+tu usuario, sin permisos de administrador, y usa los certificados que ya tienes en
+Windows.
 
-El instalador no está firmado con Authenticode, así que SmartScreen avisará al abrirlo.
-Antes de ejecutarlo, comprueba que el fichero descargado es el publicado: baja
-`SHA256SUMS` de la misma Release y compara el hash con la línea del instalador.
+Windows avisará de que el instalador no está firmado: pulsa «Más información» y
+«Ejecutar de todas formas». Si quieres comprobar la descarga, compara su hash con el de
+`SHA256SUMS`, en la Release:
 
 ```powershell
 Get-FileHash .\rFirma_*_x64-setup.exe -Algorithm SHA256
 Select-String rFirma_ .\SHA256SUMS
 ```
 
-Una vez instalado, rFirma se actualiza desde la propia aplicación: cada versión nueva
-llega con su firma minisign, que se comprueba antes de instalarla.
+Después, rFirma se actualiza sola.
 
 ## macOS
 
-La versión para macOS está en preparación y todavía no se puede instalar. Se
-integrará con el llavero de Apple. Puedes seguir el avance en el
-[repositorio](https://github.com/sgomez/rfirma).
+Necesitas un Mac con Apple Silicon y macOS 15.4 o posterior. Instálala con Homebrew:
+
+```bash
+brew install --cask sgomez/rfirma/rfirma
+```
+
+O descarga el `.dmg` desde la [web](https://rfirma.sgomez.me/#instalacion).
+
+La primera vez, macOS no la deja abrir porque no está firmada por Apple. Para
+permitirlo, ejecuta esto en el Terminal:
+
+```bash
+xattr -c /Applications/rfirma.app
+```
+
+Después, rFirma se actualiza sola. Tras cada actualización, el llavero puede volver a
+pedirte permiso para usar tus certificados.
+
+Antes de `brew uninstall`, retira desde rFirma el certificado de la CA local y el
+manejador de `afirma://`: Homebrew solo borra la aplicación.
 
 ## La huella de la clave GPG
 

packaging/repo/site/src/i18n/ca.ts

@@ -141,6 +141,7 @@ export const ca: Dictionary = {
   "install.copy.flatpak.aria": "Copiar l'ordre de Flatpak",
   "install.copy.apt.aria": "Copiar les ordres per a APT",
   "install.copy.dnf.aria": "Copiar les ordres per a DNF",
+  "install.copy.macos.aria": "Copiar l'ordre d'Homebrew",
   "install.flatpak.body":
     "Recomanada per a les distribucions de Linux que no fan servir APT ni DNF. Dones d'alta Flathub, d'on surt el runtime <code>org.gnome.Platform</code>, i el remot de rFirma, com un repositori més: així rFirma també apareix en cercar a GNOME Software. Només cal tenir instal·lats <code>flatpak</code> i <code>xdg-desktop-portal</code>.",
   "install.apt.body":
@@ -151,18 +152,18 @@ export const ca: Dictionary = {
     "Instruccions detallades, empremta de la clau i verificació, al manual (en castellà)",
   "install.uninstall":
     "Per no deixar el certificat de rFirma al navegador, prem <em>Retira el certificat</em> al panell d'estat abans de desinstal·lar.",
-  "install.soon": "En desenvolupament",
   "install.windows.title": "rFirma per a Windows",
   "install.windows.body":
-    "Instal·lador per al teu usuari, sense permisos d'administrador. Fa servir directament l'emmagatzem de certificats de Windows (MS-CAPI / CNG) i, un cop instal·lat, s'actualitza des de la mateixa aplicació: cada versió nova arriba amb la seua signatura minisign, que es comprova abans d'instal·lar-la.",
+    "S'instal·la només per al teu usuari, sense permisos d'administrador. Fa servir els certificats que ja tens a Windows i s'actualitza sola.",
   "install.windows.download": "Descarrega l'instal·lador de Windows",
   "install.windows.note":
-    'Verifica el que descarregues: baixa <code>SHA256SUMS</code> de la <a href="https://github.com/sgomez/rfirma/releases/latest" target="_blank" rel="noopener noreferrer">Release</a> i comprova que el hash de l\'instal·lador coincideix amb la seua línia. L\'instal·lador no està signat amb Authenticode, així que SmartScreen t\'avisarà en obrir-lo.',
-  "install.macos.title": "Suport per a macOS en preparació",
+    'Windows t\'avisarà que l\'instal·lador no està signat: prem «Més informació» i «Executa igualment». Si vols comprovar la baixada, compara el seu hash amb el de <code>SHA256SUMS</code>, a la <a href="https://github.com/sgomez/rfirma/releases/latest" target="_blank" rel="noopener noreferrer">Release</a>:',
+  "install.macos.title": "rFirma per a macOS",
   "install.macos.body":
-    "La versió nativa per a macOS està en fase de desenvolupament actiu. S'integrarà amb el Keychain d'Apple i CryptoTokenKit per a un accés fluid i segur a les identitats digitals del sistema.",
+    "Per a Mac amb Apple Silicon i macOS 15.4 o posterior. Instal·la-la amb Homebrew o amb el .dmg. Després s'actualitza sola.",
+  "install.macos.download": "Descarrega el .dmg de macOS",
   "install.macos.note":
-    'Es distribuirà com a imatge de disc <code>.dmg</code> i mitjançant fórmula de <code>Homebrew</code>. Pots seguir l\'avenç del projecte a <a href="https://github.com/sgomez/rfirma" target="_blank" rel="noopener noreferrer">GitHub</a>.',
+    "La primera vegada, macOS no la deixa obrir perquè no està signada per Apple. Per permetre-ho, executa això al Terminal:",
 
   "transparency.kicker": "Transparència",
   "transparency.title": "Tot el codi, a la vista",

packaging/repo/site/src/i18n/en.ts

@@ -141,6 +141,7 @@ export const en: Dictionary = {
   "install.copy.flatpak.aria": "Copy the Flatpak command",
   "install.copy.apt.aria": "Copy the APT commands",
   "install.copy.dnf.aria": "Copy the DNF commands",
+  "install.copy.macos.aria": "Copy the Homebrew command",
   "install.flatpak.body":
     "Recommended for Linux distributions that use neither APT nor DNF. You add Flathub, where the <code>org.gnome.Platform</code> runtime comes from, and rFirma's remote, like any other repository: rFirma then also shows up when you search in GNOME Software. You only need <code>flatpak</code> and <code>xdg-desktop-portal</code> installed.",
   "install.apt.body":
@@ -151,18 +152,18 @@ export const en: Dictionary = {
     "Detailed steps, key fingerprint and verification are in the manual (in Spanish)",
   "install.uninstall":
     "To leave no rFirma certificate behind in your browser, click <em>Withdraw certificate</em> in the status panel before uninstalling.",
-  "install.soon": "In development",
   "install.windows.title": "rFirma for Windows",
   "install.windows.body":
-    "Per-user installer, no administrator rights needed. It uses the Windows certificate store (MS-CAPI / CNG) directly and, once installed, updates from within the app: every new version arrives with its minisign signature, which is checked before installing it.",
+    "Installs for your user only, without administrator rights. It uses the certificates you already have in Windows and updates itself.",
   "install.windows.download": "Download the Windows installer",
   "install.windows.note":
-    'Verify what you download: get <code>SHA256SUMS</code> from the <a href="https://github.com/sgomez/rfirma/releases/latest" target="_blank" rel="noopener noreferrer">Release</a> and check that the installer\'s hash matches its line. The installer is not Authenticode-signed, so SmartScreen will warn you when you open it.',
-  "install.macos.title": "macOS support in the works",
+    'Windows will warn you that the installer isn\'t signed: click “More info” and “Run anyway”. To check the download, compare its hash with the one in <code>SHA256SUMS</code>, in the <a href="https://github.com/sgomez/rfirma/releases/latest" target="_blank" rel="noopener noreferrer">Release</a>:',
+  "install.macos.title": "rFirma for macOS",
   "install.macos.body":
-    "The native version for macOS is in active development. It will integrate with Apple's Keychain and CryptoTokenKit for smooth, secure access to the system's digital identities.",
+    "For Apple Silicon Macs with macOS 15.4 or later. Install it with Homebrew or the .dmg. It then updates itself.",
+  "install.macos.download": "Download the macOS .dmg",
   "install.macos.note":
-    'It will be distributed as a <code>.dmg</code> disk image and through a <code>Homebrew</code> formula. You can follow the project\'s progress on <a href="https://github.com/sgomez/rfirma" target="_blank" rel="noopener noreferrer">GitHub</a>.',
+    "The first time, macOS won't open it because it isn't signed by Apple. To allow it, run this in Terminal:",
 
   "transparency.kicker": "Transparency",
   "transparency.title": "All the code, in the open",

packaging/repo/site/src/i18n/es.ts

@@ -139,6 +139,7 @@ export const es = {
   "install.copy.flatpak.aria": "Copiar orden de Flatpak",
   "install.copy.apt.aria": "Copiar órdenes para APT",
   "install.copy.dnf.aria": "Copiar órdenes para DNF",
+  "install.copy.macos.aria": "Copiar orden de Homebrew",
   "install.flatpak.body":
     "Recomendada para las distribuciones de Linux que no usan APT ni DNF. Das de alta Flathub, de donde sale el runtime <code>org.gnome.Platform</code>, y el remoto de rFirma, como un repositorio más: así rFirma aparece también al buscar en GNOME Software. Solo necesitas tener instalados <code>flatpak</code> y <code>xdg-desktop-portal</code>.",
   "install.apt.body":
@@ -148,18 +149,18 @@ export const es = {
   "install.manual": "Instrucciones detalladas, huella de la clave y verificación, en el manual",
   "install.uninstall":
     "Para no dejar el certificado de rFirma en el navegador, pulsa <em>Retirar certificado</em> en el panel de estado antes de desinstalar.",
-  "install.soon": "En desarrollo",
   "install.windows.title": "rFirma para Windows",
   "install.windows.body":
-    "Instalador para tu usuario, sin permisos de administrador. Usa directamente el almacén de certificados de Windows (MS-CAPI / CNG) y, una vez instalado, se actualiza desde la propia aplicación: cada versión nueva llega con su firma minisign, que se comprueba antes de instalarla.",
+    "Se instala solo para tu usuario, sin permisos de administrador. Usa los certificados que ya tienes en Windows y se actualiza sola.",
   "install.windows.download": "Descargar el instalador de Windows",
   "install.windows.note":
-    'Verifica lo que descargas: baja <code>SHA256SUMS</code> de la <a href="https://github.com/sgomez/rfirma/releases/latest" target="_blank" rel="noopener noreferrer">Release</a> y comprueba que el hash del instalador coincide con su línea. El instalador no está firmado con Authenticode, así que SmartScreen avisará al abrirlo.',
-  "install.macos.title": "Soporte para macOS en preparación",
+    'Windows avisará de que el instalador no está firmado: pulsa «Más información» y «Ejecutar de todas formas». Si quieres comprobar la descarga, compara su hash con el de <code>SHA256SUMS</code>, en la <a href="https://github.com/sgomez/rfirma/releases/latest" target="_blank" rel="noopener noreferrer">Release</a>:',
+  "install.macos.title": "rFirma para macOS",
   "install.macos.body":
-    "La versión nativa para macOS está en fase de desarrollo activo. Se integrará con el Keychain de Apple y CryptoTokenKit para un acceso fluido y seguro a las identidades digitales del sistema.",
+    "Para Mac con Apple Silicon y macOS 15.4 o posterior. Instálala con Homebrew o con el .dmg. Después se actualiza sola.",
+  "install.macos.download": "Descargar el .dmg de macOS",
   "install.macos.note":
-    'Se distribuirá como imagen de disco <code>.dmg</code> y mediante fórmula de <code>Homebrew</code>. Puedes seguir el avance del proyecto en <a href="https://github.com/sgomez/rfirma" target="_blank" rel="noopener noreferrer">GitHub</a>.',
+    "La primera vez, macOS no la deja abrir porque no está firmada por Apple. Para permitirlo, ejecuta esto en el Terminal:",
 
   "transparency.kicker": "Transparencia",
   "transparency.title": "Todo el código, a la vista",

packaging/repo/site/src/i18n/eu.ts

@@ -143,6 +143,7 @@ export const eu: Dictionary = {
   "install.copy.flatpak.aria": "Kopiatu Flatpaken agindua",
   "install.copy.apt.aria": "Kopiatu APTrako aginduak",
   "install.copy.dnf.aria": "Kopiatu DNFrako aginduak",
+  "install.copy.macos.aria": "Kopiatu Homebrewen agindua",
   "install.flatpak.body":
     "APT edo DNF erabiltzen ez duten Linux banaketentzat gomendatua. Flathub gehitzen duzu, <code>org.gnome.Platform</code> runtimea handik datorrelako, eta rFirmaren urruneko biltegia, beste edozein biltegi bezala: horrela rFirma GNOME Software-n bilatzean ere agertzen da. <code>flatpak</code> eta <code>xdg-desktop-portal</code> instalatuta izatea besterik ez duzu behar.",
   "install.apt.body":
@@ -153,18 +154,18 @@ export const eu: Dictionary = {
     "Argibide zehatzak, gakoaren hatz-marka eta egiaztapena eskuliburuan (gaztelaniaz)",
   "install.uninstall":
     "rFirma-ren ziurtagiria nabigatzailean ez uzteko, sakatu <em>Ziurtagiria kendu</em> egoera-panelean, desinstalatu aurretik.",
-  "install.soon": "Garatzen",
   "install.windows.title": "rFirma Windowsentzat",
   "install.windows.body":
-    "Zure erabiltzailearentzako instalatzailea, administratzaile-baimenik gabe. Windowseko ziurtagiri-biltegia (MS-CAPI / CNG) zuzenean erabiltzen du eta, instalatu ondoren, aplikazioak berak eguneratzen du: bertsio berri bakoitza bere minisign sinadurarekin dator, eta instalatu aurretik egiaztatzen da.",
+    "Zure erabiltzailearentzat bakarrik instalatzen da, administratzaile-baimenik gabe. Windowsen dituzun ziurtagiriak erabiltzen ditu eta bere kabuz eguneratzen da.",
   "install.windows.download": "Deskargatu Windowseko instalatzailea",
   "install.windows.note":
-    'Egiaztatu deskargatzen duzuna: jaitsi <code>SHA256SUMS</code> <a href="https://github.com/sgomez/rfirma/releases/latest" target="_blank" rel="noopener noreferrer">Release</a>-tik eta begiratu instalatzailearen hash-a bere lerroarekin bat datorrela. Instalatzailea ez dago Authenticode-rekin sinatuta, beraz SmartScreen-ek abisua emango dizu irekitzean.',
-  "install.macos.title": "macOSentzako euskarria prestatzen",
+    'Windowsek abisatuko dizu instalatzailea ez dagoela sinatuta: sakatu «Informazio gehiago» eta «Exekutatu hala ere». Deskarga egiaztatu nahi baduzu, alderatu bere hash-a <a href="https://github.com/sgomez/rfirma/releases/latest" target="_blank" rel="noopener noreferrer">Release</a>-ko <code>SHA256SUMS</code>-ekoarekin:',
+  "install.macos.title": "rFirma macOSentzat",
   "install.macos.body":
-    "macOSentzako bertsio natiboa garapen aktiboan dago. Apple-ren Keychain eta CryptoTokenKit-ekin integratuko da, sistemaren identitate digitaletara sarbide fluidoa eta segurua izateko.",
+    "macOS 15.4 edo berriagoa duten Apple Silicon Mac-entzat. Instalatu Homebrew-rekin edo .dmg-arekin. Gero bere kabuz eguneratzen da.",
+  "install.macos.download": "Deskargatu macOSeko .dmg-a",
   "install.macos.note":
-    '<code>.dmg</code> disko-irudi gisa eta <code>Homebrew</code> formularen bidez banatuko da. Proiektuaren aurrerapena <a href="https://github.com/sgomez/rfirma" target="_blank" rel="noopener noreferrer">GitHub</a>en jarrai dezakezu.',
+    "Lehen aldian, macOSek ez du irekitzen uzten, Applek ez duelako sinatu. Baimentzeko, exekutatu hau Terminalean:",
 
   "transparency.kicker": "Gardentasuna",
   "transparency.title": "Kode osoa, ikusgai",