Installer sur n'importe quel site web

Tout site auquel vous pouvez ajouter une balise de script se connecte à Universally via le type de projet Site Web quelconque. Vous ajoutez une ligne dans l'en-tête (<head>) de chaque page, puis vous choisissez comment les pages traduites sont servies : dans le navigateur du visiteur aux mêmes adresses (JavaScript), ou sur un sous-domaine par langue tel que fr.example.com (Sous-domaine). La ligne est nécessaire dans les deux modes.

Avant de commencer

• Accès à l'en-tête (<head>) de chaque page. Dans un constructeur de site web, il s'agit de la boîte de code d'en-tête dans les paramètres. Dans vos propres fichiers, c'est le modèle que chaque page partage.
• Le rôle Propriétaire ou Administrateur dans votre espace de travail Universally, pour créer le projet et voir son extrait. Les éditeurs voient "Demander à un administrateur de projet l'extrait d'installation de ce projet." au lieu de la ligne.
• Pour le mode Sous-domaine, accès au DNS de votre domaine. Chaque langue nécessite trois enregistrements.

Créer le projet

1. Démarrez un nouveau projet. Sous Sélectionnez votre technologie, choisissez Site Web quelconque.
2. Remplissez le champ Domaine, le domaine complet sur lequel votre site est servi, tel que example.com. Si le domaine ne se résout pas encore, vous verrez un avertissement, et vous pourrez continuer.
3. Remplissez Nom du projet, vérifiez la Langue source (Anglais (US) par défaut), et cliquez sur Suivant.

Choisissez comment les pages traduites sont servies

L'écran Instructions de configuration demande "Comment les pages traduites doivent-elles être servies ?" et propose ces cartes :

Carte	Exemple	Ce que dit la carte
JavaScript	site.com	Installation la plus rapide, aucune modification DNS, fonctionne sur n'importe quelle plateforme. Aucune visibilité par les moteurs de recherche, et pages publiques uniquement.
Sous-domaine	fr.site.com	Sûr et rapide. Ne touche jamais votre trafic en direct et fonctionne avec n'importe quel registraire.
Domaine		Désactivé, marqué Bientôt disponible.

Aucune carte n'est sélectionnée pour vous, et le bouton Continuer reste désactivé jusqu'à ce que vous choisissiez. Votre site continue de fonctionner exactement comme il est : rien ne change jusqu'à la dernière étape, et vous décidez quand cela se produit.

Choisissez JavaScript si vous souhaitez la configuration la plus rapide et que vous n'avez pas besoin que les pages traduites apparaissent dans les résultats de recherche. Voir Mode de service JavaScript pour ce qui est traduit et ce qui ne l'est pas. Choisissez Sous-domaine si vous souhaitez que chaque langue ait sa propre adresse.

Un projet JavaScript peut être déplacé vers des sous-domaines plus tard depuis sa page Configuration. Un projet Sous-domaine ne peut pas revenir à JavaScript.

Ajouter l'extrait

L'étape Ajouter l'extrait dessine votre ligne à l'intérieur d'une page d'exemple. Le tableau de bord remplit la clé de votre projet :

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

1. Cliquez sur Copier la ligne. Cela copie uniquement la balise de script, et le bouton devient Copié.
2. Collez-la n'importe où entre les balises <head> et </head>, sur chaque page. Dans un constructeur de site web, utilisez la boîte de code d'en-tête globale dans les paramètres. Dans vos propres fichiers, utilisez le modèle que chaque page partage.
3. Enregistrez et publiez la modification.

En mode JavaScript, la ligne affiche le sélecteur de langue et traduit chaque page. En mode Sous-domaine, elle affiche le sélecteur qui relie vos sous-domaines linguistiques. Les boutons Marquer comme terminé sur l'écran sont stockés dans votre navigateur et ne bloquent rien.

Publier et vérifier la connexion

Enregistré n'est pas en ligne sur la plupart des constructeurs, et la vérification ne voit que ce qui est publié.

1. Publiez votre site.
2. Cliquez sur Vérifier la connexion.

La vérification charge votre page d'accueil et recherche la ligne. Trouvé signifie que la ligne est sur votre domaine, qu'elle appartient à ce projet et qu'il n'y a rien d'autre à installer. Rien ne change encore pour vos visiteurs, car votre site commence à servir des traductions une fois que vous ajoutez des langues.

Continuer et Je le ferai plus tard permettent tous deux de passer à l'étape suivante, et rien n'attend la vérification. La ligne reste sur la page Configuration du projet, sous La ligne dont votre site a besoin.

Ajouter des langues en mode JavaScript

1. Sur Ajouter des langues, répondez à « Dans quelles langues souhaitez-vous traduire ? » par au moins une langue cible.
2. Cliquez sur Terminer. Il reste désactivé jusqu'à ce que le projet ait une langue.

La boîte de dialogue des langues affiche toujours Format d'URL, mais la valeur n'est pas utilisée en mode JavaScript car vos URL ne changent jamais. Voir Ajouter et supprimer des langues.

Ajouter des langues en mode sous-domaine

L'étape des langues affiche la carte Langues à la place.

1. Cliquez sur Ajouter un sous-domaine pour la langue.
2. Dans Ajouter une langue cible, choisissez Langue et Région, puis un format de Sous-domaine. Le français avec le Code de langue sur example.com devient fr.example.com.
3. Ajoutez les trois enregistrements DNS que la ligne indique chez votre gestionnaire de domaine, et attendez que la ligne affiche En ligne.

Les enregistrements, leurs statuts et les vérifications sont décrits dans Sous-domaines de langue.

Vérifier que cela a fonctionné

• Mode JavaScript : ouvrez votre site dans une fenêtre privée. Le sélecteur se trouve dans le coin inférieur droit. Choisissez une langue et la page se recharge dans cette langue à la même adresse.
• Mode sous-domaine : ouvrez https://fr.example.com/ une fois que sa ligne est En ligne. Il sert votre site traduit, et le sélecteur relie les hôtes de langue.

Si cela ne fonctionne pas

• Nous avons chargé votre domaine mais la ligne n'était pas sur la page : le changement n'a pas été sauvegardé ou publié, un hôte ou un CDN sert toujours une copie mise en cache, ou la ligne est allée ailleurs que dans le <head>. La vérification ne regarde que votre page d'accueil.
• Nous n'avons pas pu charger votre domaine du tout : le site est hors ligne, derrière une connexion, bloque la requête, ou le domaine sur le projet est incorrect.
• Cette ligne appartient à un autre projet : remplacez-la par la ligne de la page Configuration de ce projet, puis vérifiez à nouveau.
• Un sous-domaine de langue reste sur Vérification ou Échec : voir Sous-domaines de langue.

Plus de cas sont décrits dans Les traductions n'apparaissent pas.