EXPERIENCE MANAGER GUIDES y EDGE DELIVERY SERVICES

Abra el repositorio de plantillas de plantillas de plantillas de plantillas de plantillas de Experience Manager Guides aem-guides-boilerplate.

Cree un nuevo repositorio con esta plantilla. Más información acerca de Crear un repositorio a partir de una plantilla. Asegúrese de que la visibilidad del repositorio esté establecida en Public para que EDS pueda acceder a ella.

En GitHub, vaya a la barra lateral izquierda y seleccione Configuración de desarrollador.

En la barra lateral izquierda, seleccione Aplicaciones OAuth.

Seleccione Nueva aplicación de OAuth.

{width="650"}

Registre la solicitud proporcionando los siguientes detalles obligatorios:

• Nombre de aplicación: escriba el nombre del repositorio EDS
• URL de la página principal: escriba la URL de la instancia de Experience Manager Guides. (Para ver el formato de URL de ejemplo, consulte el paso 4 de Crear una nueva aplicación de GitHub sección).
• URL de devolución de llamada de autorización: Igual que la URL de la página principal

Seleccione la opción Habilitar flujo de dispositivo y, a continuación, seleccione Registrar aplicación para completar el registro.

{width="650"}

En su repositorio de GitHub, abra el archivo fstab.yaml.

Actualice el valor url con el siguiente formato:

https://guides.adobe.com/eds-workers/<account type>/<git acc domain>/<git username>/<git repo>/<branch>/<root folder>

En la tabla siguiente se describe cada campo de la dirección URL:

Por ejemplo, si el nombre de usuario de GitHub es my-username y el nombre del repositorio es my-eds-repo, el archivo fstab.yaml aparece de la siguiente manera:

mountpoints:
  /:
    url: https://guides.adobe.com/eds-workers/github/github.com/my-username/my-eds-repo/main/docs
    type: markup

{width="650"}

Repita los pasos 2 y 3 de Conecte GitHub a Adobe a través de la sección AEM Code Sync para autorizar el repositorio.

Vaya a la página Sincronización de código AEM y seleccione Instalar.

AEM Code Sync supervisa los cambios en el repositorio y garantiza que las actualizaciones se inserten correctamente en GitHub.

En la página siguiente, conceda acceso al repositorio que ha creado. Seleccione Seleccionar solo repositorios y, a continuación, seleccione su repositorio en la lista desplegable.

{width="350"}

Seleccione Instalar y autorizar.

Se le redirigirá a la página de configuración de GitHub.

Revise los detalles del código fuente y seleccione Siguiente.

En la página Origen del contenido, configure las siguientes opciones:

• Tipo de origen de contenido: Seleccione Otro (traiga su propio marcado).
• URL de origen de contenido: Revise la URL configurada como URL de punto de montaje en el archivo fstab.yaml. Si no ha actualizado la dirección URL del archivo, puede actualizarla aquí.
• Extensión de archivo: Cambie el sufijo predeterminado .html a .htm.

Asegúrese de que Usar un origen de contenido diferente está seleccionado.

En la página Usuarios, agregue usuarios si es necesario y seleccione Siguiente.

Revise el resumen de la configuración y seleccione Guardar.

Después de registrarse correctamente, aparece una página de confirmación. Puede copiar y guardar las direcciones URL Vista previa y Activo de su sitio web desde esta página.

Vaya a Configuración de Workspace > Publicar perfiles.

Seleccione el icono + para crear un nuevo perfil de publicación y proporcione los siguientes detalles:

• Tipo de servidor*: Seleccione Git (servicio de Edge Delivery) en el menú desplegable.

• Nombre*: Escriba un nombre para el perfil de publicación.

• Tipo de cuenta Git*: Seleccione GitHub o GitLab del menú desplegable, según el proveedor del repositorio Git.

• URL de instancia*: Escriba la URL de su instancia de GitHub o GitLab, por ejemplo, https://github.com o https://gitlab.com.

• Nombre del repositorio*: Escriba el nombre de su repositorio de GitHub o GitLab.

• Nombre de usuario*: Escriba su nombre de usuario de GitHub o GitLab.

• Nombre de la rama: Establecido en main (predeterminado).

• Carpeta raíz*: establecida en docs (predeterminada).

• Propietario del sitio (Solo GitLab): Escriba el propietario del sitio de Edge Delivery Services.

• Repositorio de sitios (Solo GitLab): Escriba el nombre del repositorio asociado con el sitio de Edge Delivery Services.

• Clave de API HLX: Escriba la clave de API HLX para la configuración de EDS. Esta clave es necesaria para admitir la función Publicación cancelada introducida en la versión 2026.11.0 de Experience Manager Guides as a Cloud Service. Además, la clave es necesaria para publicar el contenido en EDS si el tamaño del contenido es de más de 100 archivos.

• Credenciales de autenticación: Proporcione las credenciales según el tipo de cuenta de Git seleccionada:

  • GitHub: Escriba el ID de cliente* y el secreto de cliente* obtenido de su aplicación OAuth de GitHub. Consulte Crear una nueva aplicación de OAuth para obtener más información.
  • GitLab: Escriba el token de acceso* generado para su cuenta de GitLab.

(Solo GitHub) Seleccione Iniciar sesión para autenticarse. Para GitLab, no se requiere inicio de sesión porque el token de acceso se utiliza para la autenticación.

{width="650"}

Seleccione Guardar. Para GitHub, la opción Guardar está disponible después de la autenticación correcta.

Abra el mapa en la consola Mapa.

En la pestaña Ajustes preestablecidos de salida, seleccione + para crear un nuevo ajuste preestablecido de salida.

En el cuadro de diálogo Nuevo ajuste preestablecido de salida, proporcione los siguientes detalles:

• Tipo: Seleccione Servicio Edge Delivery
• Nombre: proporcione un nombre para este ajuste preestablecido

Seleccione Añadir.

{width="650"}

Abra el ajuste preestablecido de salida EDS recién creado y configure los siguientes campos:

• Filtro condicional: Seleccione Ninguno para generar resultados sin filtrar o Usar DITAVAL para aplicar el filtrado condicional.

• Publicar subcarpeta: Escriba el nombre de la subcarpeta en la que se publica el resultado. La subcarpeta se crea en el repositorio bajo la carpeta raíz y su nombre aparece en los vínculos EDS al contenido publicado. Por ejemplo, si la carpeta raíz es docs y la subcarpeta de publicación es product-guide, el contenido se publica en docs/contents/product-guide.

• Perfil de publicación: Seleccione el perfil de publicación de GitHub o GitLab configurado en la sección anterior.

  {width="650"}

Seleccione Guardar y, a continuación, Generar salida.

Vaya al repositorio de GitHub y abra la carpeta blocks.

Seleccione el bloque rutas.

{width="650"}

Abra el archivo css y actualice el color del texto.

Confirme los cambios en GitHub.

Actualice el sitio web activo para ver las actualizaciones.

Abra el archivo de tema y seleccione el texto dentro de un elemento de etiqueta.

En la siguiente captura de pantalla, se selecciona el contenido dentro de la etiqueta example.
{width="650"}

Para configurar el texto dentro de la etiqueta example:

• Vaya a Propiedades de contenido.
• Agregue el atributo outputclass.
• Establezca su valor en example eds-force-block.
• Seleccione Añadir.
  {width="650"}

Guarde y vuelva a generar la salida.

Cree una nueva carpeta con el mismo nombre que outputclass dentro del directorio blocks. Obtenga información acerca de agregar archivos a un repositorio.

{width="650"}

Agregue los css necesarios y los js archivos opcionales.

{width="650"}

Confirme los cambios y vuelva a generar la salida.