From 9e86af3e6060e8e43562a2891489f54e6e834fe1 Mon Sep 17 00:00:00 2001 From: Website Deployment Script Date: Wed, 18 Dec 2019 00:58:08 +0000 Subject: [PATCH] Deploy website Deploy website version based on 1ea8c3b11eb3d09b7e824aff10df902f068b0c89 --- docs/fr/1.10.x/adding-blog.html | 36 ++--- docs/fr/1.10.x/adding-blog/index.html | 36 ++--- docs/fr/1.10.x/doc-markdown.html | 66 ++++----- docs/fr/1.10.x/doc-markdown/index.html | 66 ++++----- docs/fr/1.10.x/installation.html | 8 +- docs/fr/1.10.x/installation/index.html | 8 +- docs/fr/1.10.x/publishing.html | 124 ++++++++-------- docs/fr/1.10.x/publishing/index.html | 124 ++++++++-------- docs/fr/1.10.x/site-creation.html | 48 +++---- docs/fr/1.10.x/site-creation/index.html | 48 +++---- docs/fr/1.10.x/site-preparation.html | 4 +- docs/fr/1.10.x/site-preparation/index.html | 4 +- docs/fr/1.10.x/tutorial-publish-site.html | 2 +- .../1.10.x/tutorial-publish-site/index.html | 2 +- docs/fr/1.11.x/adding-blog.html | 36 ++--- docs/fr/1.11.x/adding-blog/index.html | 36 ++--- docs/fr/1.11.x/doc-markdown.html | 66 ++++----- docs/fr/1.11.x/doc-markdown/index.html | 66 ++++----- docs/fr/1.11.x/installation.html | 8 +- docs/fr/1.11.x/installation/index.html | 8 +- docs/fr/1.11.x/publishing.html | 124 ++++++++-------- docs/fr/1.11.x/publishing/index.html | 124 ++++++++-------- docs/fr/1.11.x/site-creation.html | 48 +++---- docs/fr/1.11.x/site-creation/index.html | 48 +++---- docs/fr/1.11.x/site-preparation.html | 4 +- docs/fr/1.11.x/site-preparation/index.html | 4 +- docs/fr/1.11.x/tutorial-publish-site.html | 2 +- .../1.11.x/tutorial-publish-site/index.html | 2 +- docs/fr/1.12.0/adding-blog.html | 40 +++--- docs/fr/1.12.0/adding-blog/index.html | 40 +++--- docs/fr/1.12.0/doc-markdown.html | 66 ++++----- docs/fr/1.12.0/doc-markdown/index.html | 66 ++++----- docs/fr/1.12.0/installation.html | 8 +- docs/fr/1.12.0/installation/index.html | 8 +- docs/fr/1.12.0/publishing.html | 130 ++++++++--------- docs/fr/1.12.0/publishing/index.html | 130 ++++++++--------- docs/fr/1.12.0/site-creation.html | 48 +++---- docs/fr/1.12.0/site-creation/index.html | 48 +++---- docs/fr/1.12.0/site-preparation.html | 4 +- docs/fr/1.12.0/site-preparation/index.html | 4 +- docs/fr/1.12.0/tutorial-publish-site.html | 2 +- .../1.12.0/tutorial-publish-site/index.html | 2 +- docs/fr/1.13.0/adding-blog.html | 40 +++--- docs/fr/1.13.0/adding-blog/index.html | 40 +++--- docs/fr/1.13.0/doc-markdown.html | 66 ++++----- docs/fr/1.13.0/doc-markdown/index.html | 66 ++++----- docs/fr/1.13.0/installation.html | 8 +- docs/fr/1.13.0/installation/index.html | 8 +- docs/fr/1.13.0/publishing.html | 130 ++++++++--------- docs/fr/1.13.0/publishing/index.html | 130 ++++++++--------- docs/fr/1.13.0/site-creation.html | 48 +++---- docs/fr/1.13.0/site-creation/index.html | 48 +++---- docs/fr/1.13.0/site-preparation.html | 4 +- docs/fr/1.13.0/site-preparation/index.html | 4 +- docs/fr/1.9.x/adding-blog.html | 36 ++--- docs/fr/1.9.x/adding-blog/index.html | 36 ++--- docs/fr/1.9.x/doc-markdown.html | 66 ++++----- docs/fr/1.9.x/doc-markdown/index.html | 66 ++++----- docs/fr/1.9.x/installation.html | 8 +- docs/fr/1.9.x/installation/index.html | 8 +- docs/fr/1.9.x/publishing.html | 128 ++++++++--------- docs/fr/1.9.x/publishing/index.html | 128 ++++++++--------- docs/fr/1.9.x/site-creation.html | 50 +++---- docs/fr/1.9.x/site-creation/index.html | 50 +++---- docs/fr/1.9.x/site-preparation.html | 4 +- docs/fr/1.9.x/site-preparation/index.html | 4 +- docs/fr/1.9.x/tutorial-publish-site.html | 2 +- .../fr/1.9.x/tutorial-publish-site/index.html | 2 +- docs/fr/adding-blog.html | 40 +++--- docs/fr/adding-blog/index.html | 40 +++--- docs/fr/doc-markdown.html | 78 +++++----- docs/fr/doc-markdown/index.html | 78 +++++----- docs/fr/installation.html | 10 +- docs/fr/installation/index.html | 10 +- docs/fr/next/adding-blog.html | 40 +++--- docs/fr/next/adding-blog/index.html | 40 +++--- docs/fr/next/doc-markdown.html | 68 ++++----- docs/fr/next/doc-markdown/index.html | 68 ++++----- docs/fr/next/installation.html | 12 +- docs/fr/next/installation/index.html | 12 +- docs/fr/next/publishing.html | 130 ++++++++--------- docs/fr/next/publishing/index.html | 130 ++++++++--------- docs/fr/next/site-creation.html | 48 +++---- docs/fr/next/site-creation/index.html | 48 +++---- docs/fr/next/site-preparation.html | 4 +- docs/fr/next/site-preparation/index.html | 4 +- docs/fr/publishing.html | 134 +++++++++--------- docs/fr/publishing/index.html | 134 +++++++++--------- docs/fr/site-creation.html | 48 +++---- docs/fr/site-creation/index.html | 48 +++---- docs/fr/site-preparation.html | 4 +- docs/fr/site-preparation/index.html | 4 +- en/index.html | 2 +- fr/index.html | 2 +- index.html | 2 +- ko/index.html | 2 +- pt-BR/index.html | 2 +- ro/index.html | 2 +- ru/index.html | 2 +- zh-CN/index.html | 2 +- 100 files changed, 2088 insertions(+), 2088 deletions(-) diff --git a/docs/fr/1.10.x/adding-blog.html b/docs/fr/1.10.x/adding-blog.html index 69e1c822a6..05db4737d3 100644 --- a/docs/fr/1.10.x/adding-blog.html +++ b/docs/fr/1.10.x/adding-blog.html @@ -103,18 +103,18 @@

Options d'entête

Le seul champ requis est title; cependant, nous fournissons des options pour ajouter des informations sur l'auteur à votre article de blog également.

-

Summary Truncation

+

Résumé de l'article

Utilisez le marqueur <!--truncate--> dans votre message de blog pour représenter ce qui sera affiché comme résumé lors de l'affichage de tous les articles de blog publiés. Tout ce qui précède <!--truncate--> fera partie du résumé. Par exemple :

---
-title: Truncation Example
+title: Exemple de résumé
 ---
-All this will be part of the blog post summary.
+Tout ceci fera partie du résumé du blog post.
 
 Même cela.
 
@@ -135,19 +135,19 @@

Changer le titre de la barre latérale

Vous pouvez configurer un titre de barre latérale spécifique en ajoutant un paramètre blogSidebarTitle à votre siteConfig.js.

-

L'option est un objet qui peut avoir les clés par défaut et tous. Spécifier une valeur par default vous permet de changer le titre de la barre latérale par défaut. Spécifier une valeur pour tous vous permet de changer le titre de la barre latérale lorsque l'option blogSidebarCount est définie à 'ALL'.

+

L'option est un objet qui peut avoir les clés default et all. Spécifier une valeur pour default vous permet de changer le titre par défaut de la barre latérale. Spécifier une valeur pour all vous permet de changer le titre de la barre latérale lorsque l'option blogSidebarCount est définie à 'ALL'.

Exemple :

-
blogSidebarTitle : { default: 'Recent posts', all: 'All blog posts' },
+
blogSidebarTitle : { default: 'Articles récents', all: 'Tous les articles du blog' },
 

 
Flux RSS

-
Docusaurus provides an RSS feed for your blog posts. Les formats de flux RSS et Atom sont pris en charge. This data is automatically to your website page's HTML <HEAD> tag.

-
A summary of the post's text is provided in the RSS feed up to the <!--truncate-->. If no <!--truncate--> tag is found, then all text up 250 characters are used.

+
Docusaurus fournit un flux RSS pour vos articles de blog. Les formats de flux RSS et Atom sont pris en charge. Ces données sont automatiquement affichées sur le tag HTML <HEAD> de votre page web.

+
Un résumé du texte du message est fourni dans le flux RSS depuis <!--truncate-->. Si aucune balise <!--truncate--> n'est trouvée, alors tout le texte jusqu'au 250ème caractère sera utilisé.

 
Boutons de réseaux sociaux

 
Si vous voulez des boutons sociaux Facebook et / ou Twitter au bas de vos billets, définissez les options facebookAppId et/ou twitter configuration du site options dans siteConfig.js.

-
Advanced Topics

-
Je veux lancer en mode "Blog Only".

-
You can run your Docusaurus site without a landing page and instead have your blog load first.

-
To do this:

+
Sujets avancés

+
Je veux exécuter en mode "Blog uniquement".

+
Vous pouvez exécuter votre site Docusaurus sans page d'accueil et avoir en premier votre blog.

+
Pour faire cela :

 
    
 
  1. Créer un fichier index.html dans website/static/.
    2. 
 
  2. Placez le contenu du modèle ci-dessous dans website/static/index.html
    3. 
@@ -157,7 +157,7 @@
 
    
 
    Maintenant, lorsque Docusaurus génère ou construit votre site, il copiera le fichier de static/index.html et le placera dans le répertoire principal du site. Le fichier statique est utilisé lorsqu'un visiteur arrive sur votre page. Lorsque la page charge, elle redirigera le visiteur vers /blog.
    
 
    
-
    You can use this template:
    
+
    Vous pouvez utiliser ce modèle :
    
 
    <!DOCTYPE html>
 <html lang="en-US">
   <head>
@@ -166,15 +166,15 @@
     <script type="text/javascript">
       window.location.href = 'blog/';
     </script>
-    <title>Title of Your Blog</title>
+    <title>Titre de botre blog</title>
   </head>
   <body>
-    If you are not redirected automatically, follow this
-    <a href="blog/">link</a>.
+    Si vous n'êtes pas redirigé automatiquement, suivez ce
+    <a href="blog/">lien</a>.
   </body>
 </html>
 
    
-
    ← DockerPages personnalisées →

Exécution du site web d'exemple

-

After running the Docusaurus initialization script, docusaurus-init as described in the Installation section, you will have a runnable, example website to use as your site's base. Pour se faire:

+

Après avoir exécuté le script d'initialisation Docusaurus, docusaurus-init comme décrit dans la section Installation, vous aurez un site web d'exemple à utiliser comme base de votre site. Pour se faire :

  1. cd website

    2. -

  2. From within the website directory, run the local web server using yarn start or npm start.

    3. -

  3. Load the example site at http://localhost:3000 if it did not already open automatically. Si le port 3000 est déjà pris, un autre port sera utilisé. Regardez les messages de la console pour voir lequel.

    +

  4. Depuis le répertoire website, exécutez le serveur web local en utilisant yarn start ou npm start.

    5. +

  5. Chargez le site d'exemple depuis l'adresse http://localhost:3000 s'il ne s'ouvre pas automatiquement. Si le port 3000 est déjà pris, un autre port sera utilisé. Regardez les messages de la console pour voir lequel.

    Vous devrez voir le site d'exemple chargé dans votre navigateur. Il y a également un serveur de LiveReload de lancé et tous les changements effectuées sur la documentation et les fichés placés dans le dossier website causeront une actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.

diff --git a/docs/fr/1.10.x/publishing.html b/docs/fr/1.10.x/publishing.html index 5324e93583..645d2a8bba 100644 --- a/docs/fr/1.10.x/publishing.html +++ b/docs/fr/1.10.x/publishing.html @@ -1,4 +1,4 @@ -Publishing your site · Docusaurus
Translate

Publishing your site

Vous devez avoir maintenant un site fonctionnant localement. Une fois que vous l'avez personnalisé à votre gout, c'est le temps de le publier. Docusaurus génère un site web HTML statique qui est prêt à être diffusé par votre serveur web préféré ou une solution d'hébergement en ligne.

+
Translate

Publishing your site

Vous devez avoir maintenant un site fonctionnant localement. Une fois que vous l'avez personnalisé à votre gout, c'est le temps de le publier. Docusaurus génère un site web HTML statique qui est prêt à être servi par votre serveur web préféré ou une solution d'hébergement en ligne.

Création des pages HTML statiques

Pour créer une version statique de votre site web, exécutez le script suivant dans le dossier website:

yarn run build # ou `npm run build`
-

Cela va générer un dossier build dans le dossier website contenant les fichiers .html de toute votre documentation et des autres pages incluses dans pages.

+

Cela va générer un dossier build dans le dossier website contenant les fichiers .html de toute votre documentation et d'autres pages incluses dans pages.

Hébergement de pages HTML statiques

-

À ce point, vous pouvez prendre tout les fichiers dans le dossier website/build et les copier dans votre dossier html de votre serveur web préféré.

+

À ce point, vous pouvez prendre tous les fichiers dans le dossier website/build et les copier dans votre dossier html de votre serveur web préféré.

Par exemple, Apache et Nginx diffuse le contenu à partir de /var/www/html par défaut. Cela dit, choisir un serveur web ou un hébergeur est à l'extérieur du cadre de Docusaurus.

-

Lorsque vous diffusez le site à partir de votre propre serveur web, assurez-vous que le serveur web fournit bien les fichiers de composants avec les en-têtes HTTP appropriés. Les fichiers CSS peuvent être servi avec type de contenu de l'en-tête de text/css. Dans le cas de Nginx, cela signifierait le paramètre inclure /etc/nginx/mime.types; dans votre fichier nginx.conf . Voir ce problème pour plus d'informations.

+

Lorsque vous diffusez le site à partir de votre propre serveur web, assurez-vous que le serveur web fournit bien les fichiers de composants avec les entêtes HTTP appropriés. Les fichiers CSS doivent être servis avec l'entête content-type de text/css. Dans le cas de Nginx, cela signifierait le paramètre inclure /etc/nginx/mime.types; dans votre fichier nginx.conf . Consulter ce problème pour plus d'informations.

-

Hébergement dans un service:

+

Hébergement dans un service :

-

Utiliser ZEIT Now

+

Utilisation de ZEIT Now

Déployer votre projet Docusaurus sur ZEIT Now vous fournira différents avantages dans les domaines de la performance et de la facilité d'utilisation.

Mais surtout, le déploiement d'un projet Docusaurus ne prend que quelques secondes :

    @@ -113,59 +113,59 @@

    C'est tout. Vos docs seront automatiquement déployées.

    Utilisation de Github Pages

    -

    Docusaurus was designed to work really well with one of the most popular hosting solutions for open source projects: GitHub Pages.

    -

    Deploying to GitHub Pages

    +

    Docusaurus a été conçu pour bien fonctionner avec l'une des solutions d'hébergement les plus populaires pour les projets open source : Pages GitHub.

    +

    Déploiement sur les pages GitHub

      -
    1. Docusaurus supports deploying as project pages or user/organization pages, your code repository does not even need to be public.
      2. +
    2. Docusaurus prend en charge le déploiement en tant que pages de projet ou pages d'utilisateur/organisation, votre dépôt de code n'a même pas besoin d'être public.

    Même si votre dépôt est privé, tout ce qui est publié dans une branche gh-pages sera public.

    -

    Note: When you deploy as user/organization page, the publish script will deploy these sites to the root of the master branch of the username.github.io repo. In this case, note that you will want to have the Docusaurus infra, your docs, etc. either in another branch of the username.github.io repo (e.g., maybe call it source), or in another, separate repo (e.g. in the same as the documented source code).

    +

    Remarque : Lorsque vous déployez en tant qu'utilisateur/organisation des pages, le script de publication va déployer ces sites à la racine de la branche master du dépôt username.github.io. Dans ce cas, notez que vous aurez l'infra de Docusaurus, vos docs, etc. soit dans une autre branche de username.github.io repo (par exemple, appelée source), ou dans un autre dépôt séparé (par exemple dans le même que le code source documenté).

      -
    1. You will need to modify the file website/siteConfig.js and add the required parameters.
      2. +
    2. Vous devrez modifier le fichier website/siteConfig.js et ajouter les paramètres requis.
    - - - - + + + +
    NomDescription
    organizationNameL'utilisateur ou l'organisation GitHub qui possède le dépôt. If you are the owner, then it is your GitHub username. In the case of Docusaurus, that would be the "facebook" GitHub organization.
    projectNameLe nom du dépôt GitHub pour votre projet. For example, the source code for Docusaurus is hosted at https://github.com/facebook/docusaurus, so our project name in this case would be "docusaurus".
    urlYour website's URL. For projects hosted on GitHub pages, this will be "https://username.github.io"
    baseUrlBase URL for your project. For projects hosted on GitHub pages, it follows the format "/projectName/". For https://github.com/facebook/docusaurus, baseUrl is /docusaurus/.
    organizationNameL'utilisateur ou l'organisation GitHub qui possède le dépôt. Si vous en êtes le propriétaire, c'est votre nom d'utilisateur GitHub. Dans le cas de Docusaurus, ce serait l'organisation GitHub "facebook".
    projectNameLe nom du dépôt GitHub pour votre projet. Par exemple, le code source de Docusaurus est hébergé sur https://github.com/facebook/docusaurus, donc le nom de notre projet dans ce cas serait "docusaurus".
    urlL'URL de votre site web. Pour les projets hébergés sur des pages GitHub, ce sera "https://username.github.io"
    baseUrlL'URL de base pour votre projet. Pour les projets hébergés sur des pages GitHub, il suit le format "/projectName/". Pour https://github.com/facebook/docusaurus, baseUrl est /docusaurus/.
     
    const siteConfig = {
   ...
-  url: 'https://__userName__.github.io', // Your website URL
+  url: 'https://__userName__.github.io', // L'URL de votre site web
   baseUrl: '/testProject/',
   projectName: 'testProject',
   organizationName: 'userName'
   ...
 }
    -

    Dans le cas où vous souhaitez déployer le site en tant qu'utilisateur ou organisation, spécifiez le nom du projet comme <username>.github.io ou <orgname>.github.io. E.g. If your GitHub username is "user42" then user42.github.io, or in the case of an organization name of "org123", it will be org123.github.io.

    -

    Note: Not setting the url and baseUrl of your project might result in incorrect file paths generated which can cause broken links to assets paths like stylesheets and images.

    +

    Dans le cas où vous souhaitez déployer le site en tant qu'utilisateur ou organisation, spécifiez le nom du projet comme <username>.github.io ou <orgname>.github.io. Par exemple, si votre nom d'utilisateur GitHub est "user42", alors cela sera user42.github.io, ou dans le cas d'un nom d'organisation de "org123", cela sera org123.github.io.

    +

    Remarque : Ne pas définir url et baseUrl de votre projet peuvent entraîner la création de chemins de fichiers incorrects qui peuvent casser des liens vers des chemins de ressources tels que les feuilles de style et les images.

    -

    While we recommend setting the projectName and organizationName in siteConfig.js, you can also use environment variables ORGANIZATION_NAME and PROJECT_NAME.

    +

    Bien que nous recommandions de définir les projectName et organizationName dans siteConfig.js, vous pouvez également utiliser les variables d'environnement ORGANIZATION_NAME et PROJECT_NAME.

      -
    1. Now you have to specify the git user as an environment variable, and run the script publish-gh-pages
      2. +
    2. Maintenant vous devez spécifier l'utilisateur git comme variable d'environnement, et exécuter le script publish-gh-pages
    - +
    NomDescription
    GIT_USERLe nom d'utilisateur d'un compte GitHub qui a un accès à ce dépôt. Pour vos propres dépôts, ce sera habituellement votre propre nom d'utilisateur GitHub. Le GIT_USER spécifié doit avoir accès au référentiel spécifié dans la combinaison de organisation et projectName.
    GIT_USERLe nom d'utilisateur d'un compte GitHub qui a un accès à ce dépôt. Pour vos propres dépôts, ce sera habituellement votre propre nom d'utilisateur GitHub. Le GIT_USER spécifié doit avoir accès au dépôt spécifié dans la combinaison de organisationName et projectName.

    Pour exécuter le script directement à partir de la ligne de commande, vous pouvez utiliser le suivant, en remplissant les valeurs de paramètre comme il se doit.

    GIT_USER=<GIT_USER> \
   CURRENT_BRANCH=master \
   USE_SSH=true \
-  yarn run publish-gh-pages # or `npm run publish-gh-pages`
+  yarn run publish-gh-pages # ou `npm run publish-gh-pages`

    Il y a également deux paramètres optionnels définis comme variables d'environnement :

    @@ -173,8 +173,8 @@ - - + +
    NomDescription
    USE_SSHSi cela est défini à true, alors SSH est utilisé au lieu de HTTPS pour la connexion au repo GitHub. HTTPS est la valeur par défaut si cette variable n'est pas définie.
    CURRENT_BRANCHLa branche qui contient les dernières modifications docs qui seront déployées. Habituellement, la branche sera master, mais elle pourrait être une branche (par défaut ou autrement) sauf pour gh-pages. Si rien n'est défini pour cette variable, la branche actuelle sera utilisée.
    USE_SSHSi cela est défini à true, alors SSH est utilisé au lieu de HTTPS pour la connexion au dépôt GitHub. HTTPS est la valeur par défaut si cette variable n'est pas définie.
    CURRENT_BRANCHLa branche qui contient les dernières modifications docs qui seront déployées. Habituellement, la branche sera master, mais peut être n'importe quelle branche (par défaut ou autrement) sauf pour gh-pages. Si rien n'est défini pour cette variable, la branche actuelle sera utilisée.

    Si vous rencontrez des problèmes liés aux clés SSH, visitez la documentation d'authentification GitHub.

    @@ -182,21 +182,21 @@

    Nous encourageons vivement la lecture à travers la documentation GitHub Pages pour en savoir plus sur le fonctionnement de cette solution d'hébergement.

    Vous pouvez exécuter la commande au-dessus de chaque fois que vous mettez à jour les documents et que vous souhaitez déployer les modifications de votre site. L'exécution manuelle du script peut être excellente pour les sites où la documentation change rarement et il n'est pas trop gênant de se souvenir de déployer manuellement des modifications.

    Cependant, vous pouvez automatiser le processus de publication avec une intégration continue (CI).

    -

    Automatisation des Déployements en utilisant l'intégration continue

    +

    Automatisation des déploiements en utilisant une intégration continue

    Les services d'intégration continue (CI) sont généralement utilisés pour effectuer des tâches de routine lorsque de nouveaux commits sont vérifiés pour contrôler la source. Ces tâches peuvent être une combinaison de tests unitaires et de tests d'intégration, d'automatisation des builds, de publication des paquets vers NPM, et oui, de déploiement de modifications sur votre site Web. Tout ce que vous devez faire pour automatiser le déploiement de votre site est d'invoquer le script publish-gh-pages chaque fois que vos docs sont mis à jour. Dans la section suivante, nous allons couvrir la façon de faire juste cela en utilisant CircleCI, un fournisseur de service d'intégration continue populaire.

    Utilisation de CircleCI 2.0

    -

    Si vous ne l'avez pas déjà fait, vous pouvez configurer CircleCI pour votre projet open source. Ensuite, afin d'activer le déploiement automatique de votre site et de la documentation via CircleCI, il suffit de configurer Circle pour exécuter le script publish-gh-pages dans le cadre de l'étape de déploiement. Vous pouvez suivre les étapes ci-dessous pour obtenir cette configuration.

    +

    Si vous ne l'avez pas déjà fait, vous pouvez configurer CircleCI pour votre projet open source. Ensuite, afin d'activer le déploiement automatique de votre site et de la documentation via CircleCI, il suffit de configurer Circle pour exécuter le script publish-gh-pages dans la partie de l'étape de déploiement. Vous pouvez suivre les étapes ci-dessous pour obtenir cette configuration.

      -
    1. Assurez-vous que le compte GitHub qui sera défini comme GIT_USER a l'accès d"écriture au référentiel qui contient la documentation, en vérifiant Paramètres | Collaborateurs & équipes dans le référentiel.
      2. +
    2. Assurez-vous que le compte GitHub qui sera défini comme GIT_USER a l'accès d'écriture au dépôt qui contient la documentation, en vérifiant Paramètres | Collaborateurs & équipes dans le dépôt.
    3. Connectez-vous à GitHub sous GIT_USER.
      4. -
    4. Go to https://github.com/settings/tokens for the GIT_USER and generate a new personal access token, granting it full control of private repositories through the repository access scope. Stockez ce jeton dans un endroit sûr, assurez-vous de ne pas le partager avec n'importe qui. Ce jeton peut être utilisé pour authentifier les actions GitHub en votre nom à la place de votre mot de passe GitHub.
      5. +
    5. Allez sur https://github.com/settings/tokens pour le GIT_USER et générez un nouveau jeton d'accès personnel, lui accordant le contrôle total des dépôts privés via le champ d'application repository. Stockez ce jeton dans un endroit sûr, assurez-vous de ne pas le partager avec n'importe qui. Ce jeton peut être utilisé pour authentifier les actions GitHub en votre nom à la place de votre mot de passe GitHub.
    6. Ouvrez votre tableau de bord CircleCI et naviguez sur la page Paramètres de votre dépôt, puis sélectionnez "variables d'environnement". L'URL ressemble à https://circleci.com/gh/ORG/REPO/edit#env-vars, où "ORG/REPO" devrait être remplacé par votre propre organisation/référentiel GitHub.
    7. Créez une nouvelle variable d'environnement nommée GITHUB_TOKEN, en utilisant votre jeton d'accès nouvellement généré comme valeur.
    8. Créez un répertoire .circleci et créez un fichier config.yml dans ce répertoire.
    9. Copiez le texte ci-dessous dans .circleci/config.yml.
    -
    # If you only want circle to run on direct commits to master, you can uncomment this out
-# and uncomment the filters: *filter-only-master down below too
+
    # Si vous voulez seulement que le circle s'exécute sur des commits directs sur master, vous pouvez décommenter ceci
+# et décommenter les filtres : *filter-only-master aussi ci-dessous
 #
 # aliases:
 #  - &filter-only-master
@@ -208,7 +208,7 @@
 jobs:
   deploy-website:
     docker:
-      # specify the version you desire here
+      # indiquez ici la version que vous désirez
 
       - image: circleci/node:8.11.1
 
@@ -231,8 +231,8 @@
       - deploy-website:
 #         filters: *filter-only-master
 
    
-
    Assurez-vous de remplacer tous les <....> dans la commande: avec des valeurs appropriées. Pour <GIT_USER>, c'est un compte GitHub qui a accès à la documentation pour push dans votre dépôt GitHub. De nombreuses fois <GIT_USER> et <GITHUB_USERNAME> seront les mêmes.
    
-
    DO NOT place la valeur réelle de $GITHUB_TOKEN dans circle.yml. Nous avons déjà configuré cela en tant que variable d'environnement à l'étape 3.
    
+
    Assurez-vous de remplacer tous les <....> dans command: avec des valeurs appropriées. Pour <GIT_USER>, c'est un compte GitHub qui a accès à la documentation pour pousser dans votre dépôt GitHub. De nombreuses fois <GIT_USER> et <GITHUB_USERNAME> seront les mêmes.
    
+
    NE PAS placer la valeur réelle de $GITHUB_TOKEN dans circle.yml. Nous avons déjà configuré cela en tant que variable d'environnement à l'étape 3.
    
 
    
 
    Si vous voulez utiliser SSH pour votre connexion de dépôt GitHub, vous pouvez définir USE_SSH=true. La commande ci-dessus ressemblerait donc à : cd website && npm install && GIT_USER=<GIT_USER> USE_SSH=true npm run publish-gh-pages.
    
 
    Contrairement au script publish-gh-pages lancé manuellement, lorsque le script s'exécute dans l'environnement Circle, la valeur de CURRENT_BRANCH est déjà définie comme une variable d'environnement dans CircleCI et sera récupérée automatiquement par le script.
    
@@ -241,14 +241,14 @@
 
    
 
    Si vous préférez utiliser une clé de déploiement au lieu d'un jeton d'accès personnel, vous pouvez en commençant par les instructions de CircleCI pour ajouter une clé de déploiement en lecture/écriture.
    
 
    
-
    Tips & Tricks
    
+
    Conseils & astuces
    
 
    Lorsque vous déployez pour la première fois la branche gh-pages en utilisant CircleCI, vous pouvez remarquer que certains jobs déclenchés par des commits sur la branche gh-pages ne parviennent pas s'exécuter correctement à cause du manque de tests (cela peut également envoyer des notifications de builds échoués sur chat/slack).
    
-
    You can work around this by:
    
+
    Vous pouvez contourner cela :
    
 
      
-
    • Setting the environment variable CUSTOM_COMMIT_MESSAGE flag to the publish-gh-pages command with the contents of [skip ci]. e.g.
      • 
+
    • Définition de la variable d'environnement CUSTOM_COMMIT_MESSAGE dans la commande publish-gh-pages avec le contenu de [skip ci]. Par exemple :
      • 
 
    
 
    CUSTOM_COMMIT_MESSAGE="[skip ci]" \
-  yarn run publish-gh-pages # or `npm run publish-gh-pages`
+  yarn run publish-gh-pages # ou `npm run publish-gh-pages`
 
    
 
      
 
    • Vous pouvez également travailler autour de cela en créant une configuration CircleCI basique avec le contenu suivant :
      • 
@@ -262,16 +262,16 @@
     branches:
       ignore: gh-pages
     steps:
-      - run: echo "Skipping tests on gh-pages branch"
+      - run: echo "Ignore les tests sur la branche gh-pages"
    -

    Save this file as config.yml and place it in a .circleci directory inside your website/static directory.

    -

    Using Travis CI

    +

    Enregistrez ce fichier sous le nom config.yml et placez-le dans un répertoire .circleci dans votre répertoire website/static.

    +

    Utilisation de Travis CI

      -
    1. Go to https://github.com/settings/tokens and generate a new personal access token
      2. -
    2. Using your GitHub account, add the Travis CI app to the repository you want to activate.
      3. -
    3. Open your Travis CI dashboard. The URL looks like https://travis-ci.com/USERNAME/REPO, and navigate to the More options > Setting > Environment Variables section of your repository.
      4. -
    4. Create a new environment variable named GH_TOKEN with your newly generated token as its value, then GH_EMAIL (your email address) and GH_NAME (your GitHub username).
      5. -
    5. Create a .travis.yml on the root of your repository with below text.
      6. +
    6. Allez sur https://github.com/settings/tokens et générez un nouveau jeton d'accès personnel
      7. +
    7. En utilisant votre compte GitHub, ajoutez l'application Travis CI au dépôt que vous souhaitez activer.
      8. +
    8. Ouvrez votre tableau de bord Travis CI. L'URL ressemble à https://travis-ci.com/USERNAME/REPO, et accédez à la section Plus d'options > Paramètres > Variables d'environnement de votre dépôt.
      9. +
    9. Créez une nouvelle variable d'environnement nommée GH_TOKEN avec votre jeton nouvellement généré, puis GH_EMAIL (votre adresse e-mail) et GH_NAME (votre nom d'utilisateur GitHub).
      10. +
    10. Créez un .travis.yml à la racine de votre dépôt avec le texte ci-dessous.
    # .travis.yml
 language: node_js
@@ -288,27 +288,27 @@
   - echo "machine github.com login ${GH_NAME} password ${GH_TOKEN}" > ~/.netrc
   - cd website && yarn install && GIT_USER="${GH_NAME}" yarn run publish-gh-pages
    -

    Now, whenever a new commit lands in master, Travis CI will run your suite of tests and, if everything passes, your website will be deployed via the publish-gh-pages script.

    +

    Maintenant, chaque fois qu'un nouveau commit se trouve dans master, Travis CI exécutera votre suite de tests et, si tout passe, votre site sera déployé via le script publish-gh-pages .

    Hébergement sur ZEIT now

    -

    With ZEIT Now, you can deploy your site and connect it to GitHub or GitLab to automatically receive a new deployment every time you push a commit.

    -

    Hosting on Netlify

    -

    Steps to configure your Docusaurus-powered site on Netlify.

    +

    Avec ZEIT Now, vous pouvez déployer votre site et le connecter à GitHub ou GitLab pour recevoir automatiquement un nouveau déploiement à chaque fois que vous pousser un commit.

    +

    Hébergement sur Netlify

    +

    Étapes pour configurer votre site alimenté par Docusaurus sur Netlify.

      -
    1. Select New site from Git
      2. -
    2. Connect to your preferred Git provider.
      3. -
    3. Select the branch to deploy. Default is master
      4. -
    4. Configure your build steps:
      5. +
    5. Sélectionnez Nouveau site depuis Git
      6. +
    6. Connectez-vous à votre fournisseur Git préféré.
      7. +
    7. Sélectionnez la branche à déployer. La valeur par défaut est master
      8. +
    8. Configurez vos étapes de construction :
      -
    • For your build command enter: cd website; npm install; npm run build;
      • -
    • For publish directory: website/build/<projectName> (use the projectName from your siteConfig)
      • +
    • Pour votre commande de build, saisissez : cd website; npm install; npm run build;
      • +
    • Pour publier le répertoire : website/build/<projectName> (utilisez le projectName de votre siteConfig)
      -
    1. Click Deploy site
      2. +
    2. Cliquez sur Déployer site
    -

    You can also configure Netlify to rebuild on every commit to your repository, or only master branch commits.

    -

    Publishing to GitHub Enterprise

    -

    GitHub enterprise installations should work in the same manner as github.com; you only need to identify the organization's GitHub Enterprise host.

    +

    Vous pouvez également configurer Netlify pour qu'il reconstruise sur chaque commit de votre dépôt, ou seulement sur les commits de la branche master.

    +

    Publication sur GitHub Enterprise

    +

    Les installations de GitHub entreprise devraient fonctionner de la même manière que github.com; vous n'avez qu'à identifier l'hôte GitHub Enterprise de l'organisation.

    @@ -317,8 +317,8 @@
    NomDescription
    GITHUB_HOSTLe nom d'hôte du serveur d'entreprise GitHub.
    -

    Alter your siteConfig.js to add a property 'githubHost' which represents the GitHub Enterprise hostname. Alternatively, set an environment variable GITHUB_HOST when executing the publish command.

    -
← Création de votre siteDocker →