Instalar em qualquer site

Qualquer site onde você possa adicionar uma tag de script se conecta ao Universally através do tipo de projeto Qualquer Site. Você adiciona uma linha ao <head> de cada página e, em seguida, escolhe como as páginas traduzidas serão servidas: no navegador do visitante nos mesmos endereços (JavaScript) ou em um subdomínio por idioma, como fr.example.com (Subdomínio). A linha é necessária em ambos os modos.

Antes de começar

• Acesso ao <head> de cada página. Em um construtor de sites, essa é a caixa de código do head nas configurações. Nos seus próprios arquivos, é o template que todas as páginas compartilham.
• A função Proprietário ou Administrador em seu espaço de trabalho Universally, para criar o projeto e ver seu snippet. Editores veem "Peça a um administrador do projeto o snippet de instalação deste projeto." em vez da linha.
• Para o modo Subdomínio, acesso ao DNS do seu domínio. Cada idioma precisa de três registros.

Criar o projeto

1. Inicie um novo projeto. Em Selecione Sua Tecnologia, escolha Qualquer Site.
2. Preencha Domínio, o domínio totalmente qualificado em que seu site é servido, como example.com. Se o domínio ainda não resolver, você verá um aviso e poderá continuar.
3. Preencha Nome do Projeto, verifique Idioma de Origem (Inglês (EUA) por padrão) e clique em Avançar.

Escolha como as páginas traduzidas serão servidas

A tela Instruções de Configuração pergunta "Como as páginas traduzidas devem ser servidas?" e oferece estes cartões:

Cartão	Exemplo	O que o cartão diz
JavaScript	website.com	Mais rápido de instalar, sem alteração de DNS, funciona em qualquer plataforma. Sem visibilidade para motores de busca e apenas páginas públicas.
Subdomínio	fr.website.com	Seguro e rápido. Nunca toca no seu tráfego ativo e funciona em qualquer registrador.
Domínio		Desativado, marcado como Em Breve.

Nenhum cartão é escolhido para você, e Continuar permanece desativado até que você escolha. Seu site continua funcionando exatamente como está: nada muda até a etapa final, e você decide quando isso acontece.

Escolha JavaScript se você quiser a configuração mais rápida e não precisar de páginas traduzidas nos resultados de busca. Veja modo de serviço JavaScript para o que ele traduz e o que não traduz. Escolha Subdomínio se você quiser cada idioma em seu próprio endereço.

Um projeto JavaScript pode ser movido para subdomínios posteriormente a partir de sua página Configuração. Um projeto Subdomínio não pode voltar para JavaScript.

Adicionar o snippet

A etapa Adicionar o snippet desenha sua linha dentro de uma página de exemplo. O painel preenche a chave do seu projeto:

<script src="https://scripts.universally.com/p/YOUR_PUBLIC_KEY/s.js" async></script>

1. Clique em Copiar linha. Ele copia apenas a tag de script, e o botão muda para Copiado.
2. Cole em qualquer lugar entre as tags <head> e </head>, em todas as páginas. Em um construtor de sites, use a caixa de código do head do site inteiro nas configurações. Nos seus próprios arquivos, use o template que todas as páginas compartilham.
3. Salve e publique a alteração.

No modo JavaScript, a linha renderiza o seletor de idioma e traduz cada página. No modo Subdomínio, ela renderiza o seletor que vincula seus subdomínios de idioma. Os botões Marcar como concluído na tela são armazenados no seu navegador e não bloqueiam nada.

Publicar e verificar a conexão

Salvo não está ativo na maioria dos construtores, e a verificação só vê o que está publicado.

1. Publique seu site.
2. Clique em Verificar conexão.

A verificação carrega sua página inicial e procura pela linha. Encontrada significa que a linha está no seu domínio, pertence a este projeto e não há mais nada a instalar. Nada muda para seus visitantes ainda, pois seu site começa a servir traduções assim que você adiciona idiomas.

Continuar e Farei isso mais tarde avançam, e nada fica pendente na verificação. A linha permanece na página Configuração do projeto, em A linha que seu site precisa.

Adicionar idiomas no modo JavaScript

1. Em Adicionar idiomas, responda "Quais idiomas você deseja traduzir?" com pelo menos um idioma de destino.
2. Clique em Concluir. Ele permanece desativado até que o projeto tenha um idioma.

A caixa de diálogo de idiomas ainda mostra Formato do URL, mas o valor não é usado no modo JavaScript porque seus URLs nunca mudam. Veja Adicionar e remover idiomas.

Adicionar idiomas no modo Subdomínio

A etapa de idiomas mostra o cartão Idiomas em vez disso.

1. Clique em Adicionar subdomínio para idioma.
2. Em Adicionar Idioma de Destino, escolha Idioma e Região, depois um formato de Subdomínio. Francês com Código do Idioma em example.com se torna fr.example.com.
3. Adicione os três registros DNS que a linha mostra em quem gerencia seu domínio, e espere a linha ficar Ativa.

Os registros, seus status e as verificações estão cobertos em Subdomínios de idioma.

Verificar se funcionou

• Modo JavaScript: abra seu site em uma janela privada. O seletor fica no canto inferior direito. Escolha um idioma e a página recarrega nele no mesmo endereço.
• Modo Subdomínio: abra https://fr.example.com/ assim que a linha estiver Ativa. Ele serve seu site traduzido, e o seletor vincula os nomes de host dos idiomas.

Se não funcionar

• Carregamos seu domínio, mas a linha não estava na página: a alteração não foi salva ou publicada, um host ou CDN ainda serve uma cópia em cache, ou a linha foi para outro lugar que não o <head>. A verificação olha apenas sua página inicial.
• Não conseguimos carregar seu domínio: o site está offline, atrás de um login, bloqueando a solicitação ou o domínio no projeto está incorreto.
• Essa linha pertence a outro projeto: substitua-a pela linha na página Configuração deste projeto e verifique novamente.
• Um subdomínio de idioma permanece em Verificando ou Falhou: veja Subdomínios de idioma.

Mais casos estão em Traduções não estão aparecendo.