3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-08-03 08:49:51 +02:00
Code Issues Projects Releases Packages Wiki Activity

Deploy website

Browse source 
Deploy website version based on 1ea8c3b11e
This commit is contained in:
Website Deployment Script 2019-12-18 00:58:08 +00:00
parent ad33fd66e0
commit 9e86af3e60
100 changed files with 2088 additions and 2088 deletions
Download patch file Download diff file Expand all files Collapse all files

48
docs/fr/site-creation/index.html
View file

@ -1,4 +1,4 @@
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Creating your site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus a été crée dans l&#x27;espoir de rendre plus simple la création de site et de documentation pour vos projets open source."/><meta name="docsearch:version" content="1.14.3"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Creating your site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus a été crée dans l&#x27;espoir de rendre plus simple la création de site et de documentation pour vos projets open source."/><meta property="og:image" content="https://docusaurus.io/img/docusaurus.png"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://docusaurus.io/img/docusaurus.png"/><link rel="shortcut icon" href="/img/docusaurus.ico"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css"/><link rel="alternate" type="application/atom+xml" href="https://docusaurus.io/blog/atom.xml" title="Docusaurus Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://docusaurus.io/blog/feed.xml" title="Docusaurus Blog RSS Feed"/><script>
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Creating your site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus a été crée dans l&#x27;espoir de rendre plus simple la création de site et de documentation pour votre projet open source."/><meta name="docsearch:version" content="1.14.3"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Creating your site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus a été crée dans l&#x27;espoir de rendre plus simple la création de site et de documentation pour votre projet open source."/><meta property="og:image" content="https://docusaurus.io/img/docusaurus.png"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://docusaurus.io/img/docusaurus.png"/><link rel="shortcut icon" href="/img/docusaurus.ico"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css"/><link rel="alternate" type="application/atom+xml" href="https://docusaurus.io/blog/atom.xml" title="Docusaurus Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://docusaurus.io/blog/feed.xml" title="Docusaurus Blog RSS Feed"/><script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
@ -80,10 +80,10 @@
};
}
});
</script></nav></div><div class="container mainContainer docsContainer"><div class="wrapper"><div class="post"><header class="postHeader"><a class="edit-page-link button" href="https://crowdin.com/project/docusaurus/fr" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Creating your site</h1></header><article><div><span><p>Docusaurus a été crée dans l'espoir de rendre plus simple la création de site et de documentation pour vos projets open source.</p>
<p>Après l'<a href="/docs/fr/installation">installation</a> et la <a href="/docs/fr/site-preparation">preparation</a>, une grande partie du travail pour créer la base du site pour votre documentation est déjà terminée.</p>
</script></nav></div><div class="container mainContainer docsContainer"><div class="wrapper"><div class="post"><header class="postHeader"><a class="edit-page-link button" href="https://crowdin.com/project/docusaurus/fr" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Creating your site</h1></header><article><div><span><p>Docusaurus a été crée dans l'espoir de rendre plus simple la création de site et de documentation pour votre projet open source.</p>
<p>Après l'<a href="/docs/fr/installation">installation</a> et la <a href="/docs/fr/site-preparation">préparation</a>, une grande partie du travail pour créer la base du site pour votre documentation est déjà terminée.</p>
<h2><a class="anchor" aria-hidden="true" id="structure-du-site"></a><a href="#structure-du-site" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Structure du site</h2>
<p>La structure de votre site ressemble à ce qui suit:</p>
<p>La structure de votre site ressemble à ce qui suit :</p>
<pre><code class="hljs css language-bash">root-directory
├── docs
└── website
@ -99,43 +99,43 @@
<blockquote>
<p>Cela suppose que vous avez supprimé les fichiers d'exemple <code>.md</code> qui ont été installé par le script d'<a href="/docs/fr/installation">initialisation</a>.</p>
</blockquote>
<p>Tous vos fichiers de documentation doivent être placé dans le répertoire <code>docs</code> sous la forme de fichier markdown <code>.md</code>. Tout les publications du blog doivent être à l'intérieur du répertoire <code>blog</code>.</p>
<p>Tous vos fichiers de documentation doivent être placé dans le répertoire <code>docs</code> comme fichier markdown <code>.md</code>. Toutes les publications du blog doivent être à l'intérieur du répertoire <code>blog</code>.</p>
<blockquote>
<p>Les fichiers de publications de blog doivent être formatés comme <code>YYYY-MM-DD-votre-nom-de-fichier.md</code></p>
<p>Les fichiers de publications de blog doivent être formatés ainsi <code>YYYY-MM-DD-votre-nom-de-fichier.md</code></p>
</blockquote>
<h2><a class="anchor" aria-hidden="true" id="création-dun-site-de-base"></a><a href="#création-dun-site-de-base" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Création d'un site de base</h2>
<p>Pour créer un site entièrement fonctionnel, il vous suffit de faire ces quelques étapes :</p>
<ol>
<li><p>Ajouter votre documentation au répertoire <code>/docs</code> sous la forme d'une fichier <code>.md</code>, en vous assurant que vous avez le bon <a href="/docs/fr/doc-markdown#documents">en-tête</a> dans chaque fichier. One example header would be the following, where <code>id</code> is the link name (e.g., <code>docs/intro.html</code>) and the <code>title</code> is the webpage's title.</p>
<li><p>Ajoutez votre documentation au répertoire <code>/docs</code> sous la forme d'un fichier <code>.md</code>, en vous assurant que vous avez le bon <a href="/docs/fr/doc-markdown#documents">entête</a> dans chaque fichier. Un exemple d'entête serait le suivant, où <code>id</code> est le nom du lien (par exemple, <code>docs/intro.html</code>) et <code>title</code> est le titre de la page Web.</p>
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
<span class="hljs-attr">id:</span> <span class="hljs-string">intro</span>
<span class="hljs-attr">title:</span> <span class="hljs-string">Getting</span> <span class="hljs-string">Started</span>
<span class="hljs-attr">title:</span> <span class="hljs-string">Pour</span> <span class="hljs-string">commencer</span>
<span class="hljs-meta">---</span>
<span class="hljs-string">My</span> <span class="hljs-string">new</span> <span class="hljs-string">content</span> <span class="hljs-string">here..</span>
<span class="hljs-string">Mon</span> <span class="hljs-string">nouveau</span> <span class="hljs-string">contenu</span> <span class="hljs-string">ici..</span>
</code></pre></li>
<li><p>Si vous le souhaitez, ajoutez zéro ou plus de documentations au fichier <a href="/docs/fr/navigation#adding-docs-to-a-sidebar"><code>sidebars.json</code></a> pour que votre documentation soit rendue dans la barre latérale.</p></li>
</ol>
<blockquote>
<p>If you do not add your documentation to the <code>sidebars.json</code> file, the docs will be rendered, but they can only be linked to from other documentation and visited with the known URL.</p>
<p>Si vous n'ajoutez pas votre documentation au fichier <code>sidebars.json</code>, les docs seront rendues, mais elles ne pourront être liées qu'à partir d'une autre documentation et visités avec l'URL connue.</p>
</blockquote>
<ol start="3">
<li>Modify the <code>website/siteConfig.js</code> file to <a href="/docs/fr/site-config">configure your site</a>, following the comments included in the <a href="/docs/fr/site-config">docs</a> and the <code>website/siteConfig.js</code> to guide you.</li>
<li>Create any <a href="/docs/fr/custom-pages#customizing-your-site-footer">custom pages</a> and/or <a href="/docs/fr/custom-pages#customizing-your-site-footer">customize</a> the <code>website/core/Footer.js</code> file that provides the footer for your site.</li>
<li>Place les composants, comme les images, dans le dossier <code>website/static/</code>.</li>
<li>Run the site to see the results of your changes.</li>
<li>Modifiez le fichier <code>website/siteConfig.js</code> pour <a href="/docs/fr/site-config">configurer votre site</a>, en suivant les commentaires inclus dans les <a href="/docs/fr/site-config">docs</a> et le <code>website/siteConfig.js</code> pour vous guider.</li>
<li>Créez n'importe quelle <a href="/docs/fr/custom-pages#customizing-your-site-footer">page personnalisée</a> et/ou <a href="/docs/fr/custom-pages#customizing-your-site-footer">personnalisez</a> le fichier <code>website/core/Footer.js</code> qui fournit le pied de page de votre site.</li>
<li>Placez les composants, comme les images, dans le dossier <code>website/static/</code>.</li>
<li>Exécutez le site pour voir les résultats de vos modifications.</li>
</ol>
<pre><code class="hljs css language-bash"><span class="hljs-built_in">cd</span> website
yarn run start <span class="hljs-comment"># or `npm run start`</span>
<span class="hljs-comment"># Navigate to http://localhost:3000</span>
yarn run start <span class="hljs-comment"># our `npm run start`</span>
<span class="hljs-comment"># Naviguez vers http://localhost:3000</span>
</code></pre>
<h2><a class="anchor" aria-hidden="true" id="personnalisation-spéciale"></a><a href="#personnalisation-spéciale" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Personnalisation spéciale</h2>
<h3><a class="anchor" aria-hidden="true" id="page-daccueil-de-la-documentation"></a><a href="#page-daccueil-de-la-documentation" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Page d'accueil de la documentation</h3>
<p>Si vous préférez que votre page d'accueil soit directement dans votre documentation, vous pouvez le faire à travers une redirection.</p>
<ol>
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
<li>Ajouter une page <a href="/docs/fr/custom-pages#adding-static-pages">statique personnalisée <code>index.html</code></a> dans le répertoire <code>site/static</code> avec le contenu suivant :</li>
<li>Supprimez le fichier <code>index.js</code> du répertoire <code>website/pages</code> s'il existe.</li>
<li>Ajoutez une page <a href="/docs/fr/custom-pages#adding-static-pages">statique personnalisée <code>index.html</code></a> dans le répertoire <code>site/static</code> avec le contenu suivant :</li>
</ol>
<pre><code class="hljs css language-html"><span class="hljs-meta">&lt;!DOCTYPE html&gt;</span>
<pre><code class="hljs css language-html"><span class="hljs-tag">&lt;<span class="hljs-name">!</span> <span class="hljs-attr">OCTYPE</span> <span class="hljs-attr">html</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">head</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /&gt;</span>
@ -146,19 +146,19 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
<span class="hljs-tag">&lt;<span class="hljs-name">script</span> <span class="hljs-attr">type</span>=<span class="hljs-string">"text/javascript"</span>&gt;</span><span class="javascript">
<span class="hljs-built_in">window</span>.location.href = <span class="hljs-string">'docs/id-of-doc-to-land-on.html'</span>;
</span><span class="hljs-tag">&lt;/<span class="hljs-name">script</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">title</span>&gt;</span>Your Site Title Here<span class="hljs-tag">&lt;/<span class="hljs-name">title</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">title</span>&gt;</span>Titre de votre site ici<span class="hljs-tag">&lt;/<span class="hljs-name">title</span>&gt;</span>
<span class="hljs-tag">&lt;/<span class="hljs-name">head</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">body</span>&gt;</span>
If you are not redirected automatically, follow this
<span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">"docs/id-of-doc-to-land-on.html"</span>&gt;</span>link<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span>.
Si vous n'êtes pas redirigé automatiquement, suivez ce
<span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">"docs/id-of-doc-to-land-on.html"</span>&gt;</span>lien<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span>.
<span class="hljs-tag">&lt;/<span class="hljs-name">body</span>&gt;</span>
<span class="hljs-tag">&lt;/<span class="hljs-name">html</span>&gt;</span>
</code></pre>
<blockquote>
<p>You will get the <code>id</code> of the document to land on the <code>.md</code> metadata of that doc page.</p>
<p>Vous obtiendrez l'<code>id</code> du document d'accueil avec les métadonnées <code>.md</code> de cette page de doc.</p>
</blockquote>
<h3><a class="anchor" aria-hidden="true" id="blog-uniquement"></a><a href="#blog-uniquement" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Blog uniquement</h3>
<p>Vous pouvez aussi utiliser Docusaurus pour héberger votre <a href="/docs/fr/adding-blog#i-want-to-run-in-blog-only-mode">blog seul</a>.</p>
<p>Vous pouvez aussi utiliser Docusaurus pour héberger votre <a href="/docs/fr/adding-blog#i-want-to-run-in-blog-only-mode">blog uniquement</a>.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/site-preparation"><span class="arrow-prev">← </span><span>Préparation du site</span></a><a class="docs-next button" href="/docs/fr/publishing"><span>Publication de votre site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#structure-du-site">Structure du site</a></li><li><a href="#création-dun-site-de-base">Création d'un site de base</a></li><li><a href="#personnalisation-spéciale">Personnalisation spéciale</a><ul class="toc-headings"><li><a href="#page-daccueil-de-la-documentation">Page d'accueil de la documentation</a></li><li><a href="#blog-uniquement">Blog uniquement</a></li></ul></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/" class="nav-home"><img src="/img/docusaurus_monochrome.svg" alt="Docusaurus" width="66" height="58"/></a><div class="footerSection"><h5>Docs</h5><a href="
/docs/fr/installation">Getting Started</a><a href="
/docs/fr/versioning">Versioning</a><a href="