EXPERIENCE MANAGER GUIDES e EDGE DELIVERY SERVICES

Abra o repositório de modelos padronizados do Experience Manager Guides aem-guides-boilerplate.

Crie um novo repositório usando este modelo. Saiba mais sobre Criação de um repositório a partir de um modelo. Verifique se a visibilidade do repositório está definida como Pública para que possa ser acessada pelo EDS.

No GitHub, navegue até a barra lateral esquerda e selecione Configurações do desenvolvedor.

Na barra lateral esquerda, selecione Aplicativos OAuth.

Selecione Novo aplicativo OAuth.

{width="650"}

Registre seu aplicativo fornecendo os seguintes detalhes obrigatórios:

• Nome do aplicativo: insira o nome do seu repositório EDS
• URL da Página Inicial: Insira a URL para a instância do Experience Manager Guides. (Para formato de URL de exemplo, consulte a etapa 4 da seção Criar um novo Aplicativo GitHub).
• URL de retorno de chamada: Igual à URL da Página Inicial

Selecione a opção Habilitar Fluxo de Dispositivo e selecione Registrar aplicativo para concluir o registro.

{width="650"}

No repositório do GitHub, abra o arquivo fstab.yaml.

Atualize o valor url usando o seguinte formato:

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

A tabela a seguir descreve cada campo no URL:

Por exemplo, se o nome de usuário do GitHub for my-username e o nome do repositório for my-eds-repo, o arquivo fstab.yaml será exibido da seguinte maneira:

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

{width="650"}

Repita as etapas 2 e 3 da seção Conectar o GitHub à Adobe por meio da Sincronização de Código AEM para autorizar o repositório.

Navegue até a página Sincronização de Código AEM e selecione Instalar.

A Sincronização de Código AEM monitora as alterações no repositório e garante que as atualizações sejam enviadas corretamente para o GitHub.

Na próxima página, conceda acesso ao repositório criado. Selecione Selecionar apenas repositórios e selecione seu repositório na lista suspensa.

{width="350"}

Selecione Instalar e autorizar.

Você é redirecionado para a página de configuração do GitHub.

Revise os detalhes do código-fonte e selecione Próximo.

Na página Fonte de conteúdo, defina as seguintes configurações:

• Tipo de fonte de conteúdo: Selecione Outros (traga sua própria marcação).
• URL de origem do conteúdo: Revise a URL configurada como a URL do ponto de montagem no arquivo fstab.yaml. Se você não atualizou o URL no arquivo, é possível atualizá-lo aqui.
• Extensão de arquivo: Altere o sufixo .html padrão para .htm.

Verifique se Usar uma fonte de conteúdo diferente está selecionado.

Na página Usuários, adicione usuários se necessário e selecione Avançar.

Revise o resumo da configuração e selecione Salvar.

Após o registro bem-sucedido, uma página de confirmação é exibida. Você pode copiar e salvar as URLs do Visualização e do Live para seu site a partir desta página.

Vá para Configurações do Workspace > Publicar perfis.

Selecione o ícone + para criar um novo perfil de publicação e fornecer os seguintes detalhes:

• Tipo de servidor*: Selecione Git (Edge Delivery Service) na lista suspensa.

• Nome*: Digite um nome para o perfil de publicação.

• Tipo de conta Git*: Selecione GitHub ou GitLab na lista suspensa, dependendo do seu provedor de repositório Git.

• URL da instância*: Insira a URL da sua instância do GitHub ou do GitLab, por exemplo, https://github.com ou https://gitlab.com.

• Nome do repositório*: Insira o nome do seu repositório GitHub ou GitLab.

• Nome de usuário*: digite seu nome de usuário do GitHub ou do GitLab.

• Nome da ramificação: Definido como main (padrão).

• Pasta raiz*: Definido como docs (padrão).

• Proprietário do site (GitLab somente): Insira o proprietário do site do Edge Delivery Services.

• Repositório do site (GitLab somente): Insira o nome do repositório associado ao site do Edge Delivery Services.

• Chave de API HLX: Insira a chave de API HLX para sua configuração de EDS. Essa chave é necessária para oferecer suporte ao recurso Não publicado introduzido na versão 2026.11.0 do Experience Manager Guides as a Cloud Service. Além disso, a chave será necessária para publicar o conteúdo no EDS se o tamanho do conteúdo for superior a 100 arquivos.

• Credenciais de autenticação: forneça as credenciais com base no tipo de conta Git selecionado:

  • GitHub: Insira a ID do Cliente* e o segredo do Cliente* obtidos do seu aplicativo GitHub OAuth. Consulte Criar um novo aplicativo OAuth para obter detalhes.
  • GitLab: Insira o token de acesso* gerado para sua conta GitLab.

(Somente GitHub) Selecione Logon para autenticar. Para o GitLab, nenhum logon é necessário porque o token de acesso é usado para autenticação.

{width="650"}

Selecione Salvar. Para o GitHub, a opção Salvar está disponível após a autenticação bem-sucedida.

Abra o mapa no console Mapa.

Na guia Predefinições de saída, selecione + para criar uma nova predefinição de saída.

Na caixa de diálogo Nova predefinição de saída, forneça os seguintes detalhes:

• Tipo: Selecionar Serviço Edge Delivery
• Nome: forneça um nome para esta predefinição

Selecione Adicionar.

{width="650"}

Abra a predefinição de saída EDS recém-criada e configure os seguintes campos:

• Filtragem condicional: Selecione Nenhum para gerar saída sem filtragem ou Usando DITAVAL para aplicar filtragem condicional.

• Publicar subpasta: Digite o nome da subpasta na qual a saída é publicada. A subpasta é criada no repositório sob a pasta raiz e seu nome aparece nos links de EDS para o conteúdo publicado. Por exemplo, se a pasta raiz for docs e a subpasta de publicação for product-guide, o conteúdo será publicado em docs/contents/product-guide.

• Perfil de publicação: selecione o perfil de publicação GitHub ou GitLab configurado na seção anterior.

  {width="650"}

Selecione Salvar e depois Gerar saída.

Vá para o repositório do GitHub e abra a pasta blocks.

Selecione o bloco navegações estruturais.

{width="650"}

Abra o arquivo css e atualize a cor do texto.

Confirme as alterações no GitHub.

Atualize o site para ver as atualizações.

Abra o arquivo de tópico e selecione o texto dentro de um elemento de tag.

Na captura de tela a seguir, o conteúdo dentro da tag example é selecionado.
{width="650"}

Para configurar o texto dentro da tag example:

• Navegue até Propriedades do conteúdo.
• Adicione o atributo outputclass.
• Defina o valor como example eds-force-block.
• Selecione Adicionar.
  {width="650"}

Salve e gere novamente a saída.

Crie uma nova pasta com o mesmo nome que outputclass dentro do diretório blocks. Saiba mais sobre adicionando arquivos a um repositório.

{width="650"}

Adicione os arquivos css necessários e js opcionais.

{width="650"}

Confirme as alterações e gere novamente a saída.