mirror of
https://github.com/facebook/docusaurus.git
synced 2025-12-30 05:52:50 +00:00
Website Deployment Script
parent
9e86af3e60
commit
48bfb0ed7d
|
|
@ -158,7 +158,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.10.x/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.10.x/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -85,13 +85,13 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -85,13 +85,13 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.11.x/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.11.x/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -85,13 +85,13 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -85,13 +85,13 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads, it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads, it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.12.0/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.12.0/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -85,13 +85,13 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -85,13 +85,13 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads, it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads, it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.13.0/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.13.0/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -86,13 +86,13 @@
|
|||
<ol>
|
||||
<li>Edit the file <code>docusaurus-tutorial/website/siteConfig.js</code> and fill in the following values:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -86,13 +86,13 @@
|
|||
<ol>
|
||||
<li>Edit the file <code>docusaurus-tutorial/website/siteConfig.js</code> and fill in the following values:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.9.x/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/1.9.x/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -85,13 +85,13 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -85,13 +85,13 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads, it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads, it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads, it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Now, when Docusaurus generates or builds your site, it will copy the file from <code>static/index.html</code> and place it in the site's main directory. The static file is served when a visitor arrives on your page. When the page loads, it will redirect the visitor to <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>You can use this template:</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/next/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/next/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -86,13 +86,13 @@
|
|||
<ol>
|
||||
<li>Edit the file <code>docusaurus-tutorial/website/siteConfig.js</code> and fill in the following values:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -86,13 +86,13 @@
|
|||
<ol>
|
||||
<li>Edit the file <code>docusaurus-tutorial/website/siteConfig.js</code> and fill in the following values:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,7 @@ yarn run start <span class="hljs-comment"># or `npm run start`</span>
|
|||
<li>Remove the <code>index.js</code> file from the <code>website/pages</code> directory, if it exists.</li>
|
||||
<li>Add a <a href="/docs/en/custom-pages#adding-static-pages">custom static <code>index.html</code> page</a> in the <code>website/static</code> directory with the following contents:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -86,13 +86,13 @@
|
|||
<ol>
|
||||
<li>Edit the file <code>docusaurus-tutorial/website/siteConfig.js</code> and fill in the following values:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -86,13 +86,13 @@
|
|||
<ol>
|
||||
<li>Edit the file <code>docusaurus-tutorial/website/siteConfig.js</code> and fill in the following values:</li>
|
||||
</ol>
|
||||
<pre><code class="hljs"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
<span class="hljs-params">...</span>
|
||||
url: <span class="hljs-string">'https://USERNAME.github.io'</span>, <span class="hljs-comment">// Replace USERNAME with your GitHub username.</span>
|
||||
baseUrl: <span class="hljs-string">'/docusaurus-tutorial/'</span>, <span class="hljs-comment">// The name of your GitHub project.</span>
|
||||
projectName: <span class="hljs-string">'docusaurus-tutorial'</span>, <span class="hljs-comment">// The name of your GitHub project. Same as above.</span>
|
||||
organizationName: <span class="hljs-string">'USERNAME'</span> <span class="hljs-comment">// Your GitHub username.</span>
|
||||
...
|
||||
<span class="hljs-params">...</span>
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
|
|
|
|||
|
|
@ -103,7 +103,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="options-dentête"></a><a href="#options-dentête" 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>Options d'entête</h2>
|
||||
<p>Le seul champ requis est <code>title</code>; cependant, nous fournissons des options pour ajouter des informations sur l'auteur à votre article de blog également.</p>
|
||||
<ul>
|
||||
<li><code>auteur</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>author</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>authorURL</code> - L'URL associée à l'auteur. Ceci pourrait être un compte Twitter, GitHub, Facebook, etc.</li>
|
||||
<li><code>authorFBID</code> - L'ID de profil Facebook qui est utilisé pour récupérer l'image de profil.</li>
|
||||
<li><code>authorImageURL</code> - L'URL vers l'image de l'auteur. (Remarque : Si vous utilisez à la fois <code>authorFBID</code> et <code>authorImageURL</code>, <code>authorFBID</code> prendra la priorité. N’incluez pas <code>authorFBID</code> si vous voulez que <code>authorImageURL</code> apparaisse.)</li>
|
||||
|
|
@ -129,7 +129,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale"></a><a href="#changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale" 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>Changer le nombre de messages du blog sur la barre latérale</h2>
|
||||
<p>Par défaut, 5 messages récents sont affichés sur la barre latérale.</p>
|
||||
<p>Vous pouvez configurer un nombre spécifique de messages de blog à afficher en ajoutant un paramètre <code>blogSidebarCount</code> à votre <code>siteConfig.js</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>"ALL"</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>'ALL'</code>.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-js">blogSidebarCount: <span class="hljs-string">'ALL'</span>,
|
||||
</code></pre>
|
||||
|
|
@ -143,7 +143,7 @@
|
|||
<p>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 <code><HEAD></code> de votre page web.</p>
|
||||
<p>Un résumé du texte du message est fourni dans le flux RSS depuis <code><!--truncate--></code>. Si aucune balise <code><!--truncate--></code> n'est trouvée, alors tout le texte jusqu'au 250ème caractère sera utilisé.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="boutons-de-réseaux-sociaux"></a><a href="#boutons-de-réseaux-sociaux" 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>Boutons de réseaux sociaux</h2>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et / ou Twitter au bas de vos billets, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> <a href="/docs/fr/1.10.x/site-config">configuration du site</a> options dans <code>siteConfig.js</code>.</p>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et/ou Twitter au bas de vos articles de blog, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> de la <a href="/docs/fr/1.10.x/site-config">configuration du site</a> dans <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="sujets-avancés"></a><a href="#sujets-avancés" 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>Sujets avancés</h2>
|
||||
<h3><a class="anchor" aria-hidden="true" id="je-veux-exécuter-en-mode-blog-uniquement"></a><a href="#je-veux-exécuter-en-mode-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>Je veux exécuter en mode "Blog uniquement".</h3>
|
||||
<p>Vous pouvez exécuter votre site Docusaurus sans page d'accueil et avoir en premier votre blog.</p>
|
||||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Maintenant, lorsque Docusaurus génère ou construit votre site, il copiera le fichier de <code>static/index.html</code> 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 <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez utiliser ce modèle :</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -103,7 +103,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="options-dentête"></a><a href="#options-dentête" 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>Options d'entête</h2>
|
||||
<p>Le seul champ requis est <code>title</code>; cependant, nous fournissons des options pour ajouter des informations sur l'auteur à votre article de blog également.</p>
|
||||
<ul>
|
||||
<li><code>auteur</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>author</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>authorURL</code> - L'URL associée à l'auteur. Ceci pourrait être un compte Twitter, GitHub, Facebook, etc.</li>
|
||||
<li><code>authorFBID</code> - L'ID de profil Facebook qui est utilisé pour récupérer l'image de profil.</li>
|
||||
<li><code>authorImageURL</code> - L'URL vers l'image de l'auteur. (Remarque : Si vous utilisez à la fois <code>authorFBID</code> et <code>authorImageURL</code>, <code>authorFBID</code> prendra la priorité. N’incluez pas <code>authorFBID</code> si vous voulez que <code>authorImageURL</code> apparaisse.)</li>
|
||||
|
|
@ -129,7 +129,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale"></a><a href="#changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale" 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>Changer le nombre de messages du blog sur la barre latérale</h2>
|
||||
<p>Par défaut, 5 messages récents sont affichés sur la barre latérale.</p>
|
||||
<p>Vous pouvez configurer un nombre spécifique de messages de blog à afficher en ajoutant un paramètre <code>blogSidebarCount</code> à votre <code>siteConfig.js</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>"ALL"</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>'ALL'</code>.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-js">blogSidebarCount: <span class="hljs-string">'ALL'</span>,
|
||||
</code></pre>
|
||||
|
|
@ -143,7 +143,7 @@
|
|||
<p>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 <code><HEAD></code> de votre page web.</p>
|
||||
<p>Un résumé du texte du message est fourni dans le flux RSS depuis <code><!--truncate--></code>. Si aucune balise <code><!--truncate--></code> n'est trouvée, alors tout le texte jusqu'au 250ème caractère sera utilisé.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="boutons-de-réseaux-sociaux"></a><a href="#boutons-de-réseaux-sociaux" 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>Boutons de réseaux sociaux</h2>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et / ou Twitter au bas de vos billets, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> <a href="/docs/fr/1.10.x/site-config">configuration du site</a> options dans <code>siteConfig.js</code>.</p>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et/ou Twitter au bas de vos articles de blog, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> de la <a href="/docs/fr/1.10.x/site-config">configuration du site</a> dans <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="sujets-avancés"></a><a href="#sujets-avancés" 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>Sujets avancés</h2>
|
||||
<h3><a class="anchor" aria-hidden="true" id="je-veux-exécuter-en-mode-blog-uniquement"></a><a href="#je-veux-exécuter-en-mode-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>Je veux exécuter en mode "Blog uniquement".</h3>
|
||||
<p>Vous pouvez exécuter votre site Docusaurus sans page d'accueil et avoir en premier votre blog.</p>
|
||||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Maintenant, lorsque Docusaurus génère ou construit votre site, il copiera le fichier de <code>static/index.html</code> 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 <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez utiliser ce modèle :</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -224,7 +224,7 @@ module.exports = MyPage;
|
|||
<p>More examples of how these components are used can be found in the <a href="/docs/fr/1.10.x/site-preparation">generated example files</a> as well as in Docusaurus' own repository for its website set-up.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="translating-strings"></a><a href="#translating-strings" 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>Translating Strings</h2>
|
||||
<p>When translations are enabled, any pages inside <code>website/pages/en</code> will be translated for all enabled languages. Les URLs pour les pages non-anglophones utiliseront leurs tags de langue comme indiqué dans le fichier <code>languages.js</code> . Par exemple, l'URL d'une page française de <code>website/pages/en/help.js</code> se trouve à <code>${baseUrl}fr/help.html</code>.</p>
|
||||
<p>When writing pages that you wish to translate, wrap any strings to be translated inside a <code><translate></code> tag. e.g.,</p>
|
||||
<p>When writing pages that you wish to translate, wrap any strings to be translated inside a <code><translate></code> tag. Par exemple :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span><span class="token constant">I</span> like translations<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>p</span><span class="token punctuation">></span></span>
|
||||
|
|
|
|||
|
|
@ -224,7 +224,7 @@ module.exports = MyPage;
|
|||
<p>More examples of how these components are used can be found in the <a href="/docs/fr/1.10.x/site-preparation">generated example files</a> as well as in Docusaurus' own repository for its website set-up.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="translating-strings"></a><a href="#translating-strings" 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>Translating Strings</h2>
|
||||
<p>When translations are enabled, any pages inside <code>website/pages/en</code> will be translated for all enabled languages. Les URLs pour les pages non-anglophones utiliseront leurs tags de langue comme indiqué dans le fichier <code>languages.js</code> . Par exemple, l'URL d'une page française de <code>website/pages/en/help.js</code> se trouve à <code>${baseUrl}fr/help.html</code>.</p>
|
||||
<p>When writing pages that you wish to translate, wrap any strings to be translated inside a <code><translate></code> tag. e.g.,</p>
|
||||
<p>When writing pages that you wish to translate, wrap any strings to be translated inside a <code><translate></code> tag. Par exemple :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span><span class="token constant">I</span> like translations<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>p</span><span class="token punctuation">></span></span>
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Custom Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding `.js` files to the `website/pages` directory. These files are [React](https://reactjs.org/) components and the `render()` is called to create them, backed by CSS classes, etc."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Custom Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding `.js` files to the `website/pages` directory. These files are [React](https://reactjs.org/) components and the `render()` is called to create them, backed by CSS classes, etc."/><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>Custom Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers `.js` au répertoire `website/pages`. Ces fichiers sont des composants [React](https://reactjs.org/) et le `render()` est appelé pour les créer, avec le renfort des classes CSS, etc."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Custom Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers `.js` au répertoire `website/pages`. Ces fichiers sont des composants [React](https://reactjs.org/) et le `render()` est appelé pour les créer, avec le renfort des classes CSS, etc."/><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,12 +80,12 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Custom Pages</h1></header><article><div><span><p>You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding <code>.js</code> files to the <code>website/pages</code> directory. These files are <a href="https://reactjs.org/">React</a> components and the <code>render()</code> is called to create them, backed by CSS classes, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-your-home-page"></a><a href="#customizing-your-home-page" 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>Customizing Your Home Page</h2>
|
||||
<p>The easiest way to get started customizing your home page is to use the example site that was <a href="/docs/fr/1.10.x/site-creation">created</a> when you ran the <a href="/docs/fr/1.10.x/installation">Docusaurus initialization script</a>.</p>
|
||||
<p>You can <a href="/docs/fr/1.10.x/site-preparation#verifying-installation">start</a> your local server and go to <code>http://localhost:3000</code> to see what the example home page looks like. From there, edit the <code>website/pages/en/index.js</code> file and its various components to use the images and text you want for your project.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-other-custom-pages"></a><a href="#adding-other-custom-pages" 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>Adding Other Custom Pages</h2>
|
||||
<p>Docusaurus provides some helpful example pages in the <code>website/pages/en</code> directory, including <code>index.js</code>, <code>users.js</code>, and <code>help.js</code>. These are good examples to showcase how to create a custom page for Docusaurus.</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">Custom Pages</h1></header><article><div><span><p>Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers <code>.js</code> au répertoire <code>website/pages</code>. Ces fichiers sont des composants <a href="https://reactjs.org/">React</a> et le <code>render()</code> est appelé pour les créer, avec le renfort des classes CSS, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-de-votre-page-daccueil"></a><a href="#personnalisation-de-votre-page-daccueil" 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 de votre page d'accueil</h2>
|
||||
<p>La façon la plus simple de commencer à personnaliser votre page d'accueil est d'utiliser le site d'exemple qui a été <a href="/docs/fr/1.10.x/site-creation">créé</a> lorsque vous avez exécuté le <a href="/docs/fr/1.10.x/installation">script d'initialisation Docusaurus</a>.</p>
|
||||
<p>Vous pouvez <a href="/docs/fr/1.10.x/site-preparation#verifying-installation">démarrer</a> votre serveur local et aller à l'adresse <code>http://localhost:3000</code> pour voir à quoi ressemble la page d'accueil d'exemple. À partir de là, éditez le fichier <code>website/pages/fr/index.js</code> et ses divers composants pour utiliser les images et le texte que vous voulez pour votre projet.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-dautres-pages-personnalisées"></a><a href="#ajouter-dautres-pages-personnalisées" 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>Ajouter d'autres pages personnalisées</h2>
|
||||
<p>Docusaurus fournit quelques exemples de pages utiles dans le répertoire <code>website/pages/en</code>, y compris <code>index.js</code>, <code>users.js</code> et <code>help.js</code>. Ce sont de bons exemples pour montrer comment créer une page personnalisée pour Docusaurus.</p>
|
||||
<pre><code class="hljs css language-bash">root-directory
|
||||
├── docs
|
||||
└── website
|
||||
|
|
@ -101,22 +101,22 @@
|
|||
├── siteConfig.js
|
||||
└── static
|
||||
</code></pre>
|
||||
<p>You are also free to write your own pages. It is strongly suggested that you at least have an index page, but none of the pages provided are mandatory to include in your site. More information on how to use the provided components or include your own can be found <a href="/docs/fr/1.10.x/api-pages">here</a>. Information on how to link to your different pages in the header navigation bar can be found <a href="/docs/fr/1.10.x/navigation">here</a>.</p>
|
||||
<p>Vous êtes également libre d'écrire vos propres pages. Il est fortement conseillé d'avoir au moins une page d'index, mais aucune des pages fournies n'est à inclure obligatoirement dans votre site. Plus d'informations sur la façon d'utiliser les composants fournis ou d'inclure vos propres composants peuvent être trouvées <a href="/docs/fr/1.10.x/api-pages">ici</a>. Des informations sur la façon de créer un lien vers vos différentes pages dans la barre de navigation d'entête peuvent être trouvées <a href="/docs/fr/1.10.x/navigation">ici</a>.</p>
|
||||
<blockquote>
|
||||
<p>If you want your page to show up in your navigation header, you will need to update <code>siteConfig.js</code> to add to the <code>headerLinks</code> element. e.g., <code>{ page: 'about-slash', label: 'About/' }</code>,</p>
|
||||
<p>Si vous voulez que votre page apparaisse dans votre entête de navigation, vous devrez mettre à jour <code>siteConfig.js</code> pour l'ajouter à l'élément <code>headerLinks</code>. Par exemple, <code>{ page: 'about-slash', label: 'About/' }</code>,</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-static-pages"></a><a href="#adding-static-pages" 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>Adding Static Pages</h2>
|
||||
<p>Static <code>.html</code> files can also be used, but they will not include Docusaurus' header, footer, or styles by default. These can be added to the <code>static</code> directory in the same way as other <a href="/docs/fr/1.10.x/api-pages#using-static-assets">static assets</a>. Alternatively, they can be placed in the <code>pages</code> directory and would be served as-is instead of being rendered from React.</p>
|
||||
<p>If you wish to use Docusaurus' stylesheet, you can access it at <code>${baseUrl}css/main.css</code>. If you wish to use separate CSS for these static pages, you can exclude them from being concatenated to Docusaurus' styles by adding them into the <code>siteConfig.separateCss</code> field in <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-de-pages-statiques"></a><a href="#ajouter-de-pages-statiques" 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>Ajouter de pages statiques</h2>
|
||||
<p>Les fichiers statiques <code>.html</code> peuvent également être utilisés, mais ils n'incluront pas l'entête de Docusaurus, le pied de page ou les styles par défaut. Celles-ci peuvent être ajoutées au répertoire <code>static</code> de la même manière que les autres <a href="/docs/fr/1.10.x/api-pages#using-static-assets">ressources statiques</a>. Autrement, elles peuvent être placées dans le répertoire <code>pages</code> et seront traitées en tant que telles au lieu d'être affichées à partir de React.</p>
|
||||
<p>Si vous souhaitez utiliser la feuille de style de Docusaurus, vous pouvez y accéder depuis <code>${baseUrl}css/main.css</code>. Si vous souhaitez utiliser des CSS séparés pour ces pages statiques, vous pouvez les empêcher d'être concaténés aux styles de Docusaurus en les ajoutant dans le champ <code>siteConfig.separateCss</code> dans <code>siteConfig.js</code>.</p>
|
||||
<blockquote>
|
||||
<p>You can set the <a href="/docs/fr/1.10.x/site-config#optional-fields"><code>$wrapPagesHTML</code> site config option</a> in order to wrap raw HTML fragments with the Docusaurus site styling, header and footer.</p>
|
||||
<p>Vous pouvez définir l'<a href="/docs/fr/1.10.x/site-config#optional-fields">option de configuration du site <code>$wrapPagesHTML</code></a> afin d'encapsuler les fragments HTML bruts avec le style du site Docusaurus, l'entête et le pied de page.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-your-site-footer"></a><a href="#customizing-your-site-footer" 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>Customizing Your Site Footer</h2>
|
||||
<p>Starting from the example <code>core/Footer.js</code> file that was <a href="/docs/fr/1.10.x/site-creation">created</a> when you ran the <a href="/docs/fr/1.10.x/installation">Docusaurus initialization script</a>, edit the footer to include any links to pages on your site or other sites that you wish to have.</p>
|
||||
<p>The example provided has three columns with a footer image on the left and Facebook's open source logo and copyright at the bottom. If your project is not a Facebook open source project, remove the logo and copyright. Otherwise, feel free to get creative with your footer and make it look however you'd like!</p>
|
||||
<p>Some suggestions for links you may want to provide: documentation, API, Twitter, Discord, Facebook groups, Stack Overflow, GitHub, etc.</p>
|
||||
<p>Your footer will automatically get applied to all pages on your site, including docs and blog posts. The sole exception to this is any static HTML pages you include.</p>
|
||||
<p>If you do not want a footer for your site, change the <code>render</code> function of <code>core/Footer.js</code> to return <code>null</code>. e.g.,</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-du-pied-de-page-de-votre-site"></a><a href="#personnalisation-du-pied-de-page-de-votre-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>Personnalisation du pied de page de votre site</h2>
|
||||
<p>À partir de l'exemple du fichier <code>core/Footer.js</code> qui a été <a href="/docs/fr/1.10.x/site-creation">créé</a> lorsque vous avez exécuté le <a href="/docs/fr/1.10.x/installation">script d'initialisation Docusaurus</a>, éditez le pied de page pour inclure tous les liens vers des pages de votre site ou d'autres sites que vous souhaitez avoir.</p>
|
||||
<p>L'exemple fourni a trois colonnes avec une image de pied de page à gauche et le logo open source de Facebook et les droits d'auteur en bas. Si votre projet n'est pas un projet open source Facebook, supprimez le logo et les droits d'auteur. Sinon, n'hésitez pas à faire preuve de créativité avec votre pied de page et à lui donner un aspect que vous aimeriez !</p>
|
||||
<p>Quelques suggestions pour les liens que vous pouvez fournir : documentation, API, Twitter, Discord, groupes Facebook, Stack Overflow, GitHub, etc.</p>
|
||||
<p>Votre pied de page sera automatiquement appliqué à toutes les pages de votre site, y compris les docs et les articles du blog. La seule exception à cela, c'est toute page HTML statique que vous incluez.</p>
|
||||
<p>Si vous ne voulez pas de pied de page pour votre site, changez la fonction <code>render</code> de <code>core/Footer.js</code> pour retourner <code>null</code>. Par exemple :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token keyword">const</span> React <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'react'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
|
||||
|
||||
<span class="token keyword">class</span> <span class="token class-name">Footer</span> <span class="token keyword">extends</span> <span class="token class-name">React<span class="token punctuation">.</span>Component</span> <span class="token punctuation">{</span>
|
||||
|
|
@ -127,7 +127,7 @@
|
|||
|
||||
module<span class="token punctuation">.</span>exports <span class="token operator">=</span> Footer<span class="token punctuation">;</span>
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/adding-blog"><span class="arrow-prev">← </span><span>Ajouter un blog</span></a><a class="docs-next button" href="/docs/fr/1.10.x/search"><span>Activation de la recherche</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#customizing-your-home-page">Customizing Your Home Page</a></li><li><a href="#adding-other-custom-pages">Adding Other Custom Pages</a></li><li><a href="#adding-static-pages">Adding Static Pages</a></li><li><a href="#customizing-your-site-footer">Customizing Your Site Footer</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/adding-blog"><span class="arrow-prev">← </span><span>Ajouter un blog</span></a><a class="docs-next button" href="/docs/fr/1.10.x/search"><span>Activation de la recherche</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#personnalisation-de-votre-page-daccueil">Personnalisation de votre page d'accueil</a></li><li><a href="#ajouter-dautres-pages-personnalisées">Ajouter d'autres pages personnalisées</a></li><li><a href="#ajouter-de-pages-statiques">Ajouter de pages statiques</a></li><li><a href="#personnalisation-du-pied-de-page-de-votre-site">Personnalisation du pied de page de votre site</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Custom Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding `.js` files to the `website/pages` directory. These files are [React](https://reactjs.org/) components and the `render()` is called to create them, backed by CSS classes, etc."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Custom Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding `.js` files to the `website/pages` directory. These files are [React](https://reactjs.org/) components and the `render()` is called to create them, backed by CSS classes, etc."/><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>Custom Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers `.js` au répertoire `website/pages`. Ces fichiers sont des composants [React](https://reactjs.org/) et le `render()` est appelé pour les créer, avec le renfort des classes CSS, etc."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Custom Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers `.js` au répertoire `website/pages`. Ces fichiers sont des composants [React](https://reactjs.org/) et le `render()` est appelé pour les créer, avec le renfort des classes CSS, etc."/><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,12 +80,12 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Custom Pages</h1></header><article><div><span><p>You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding <code>.js</code> files to the <code>website/pages</code> directory. These files are <a href="https://reactjs.org/">React</a> components and the <code>render()</code> is called to create them, backed by CSS classes, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-your-home-page"></a><a href="#customizing-your-home-page" 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>Customizing Your Home Page</h2>
|
||||
<p>The easiest way to get started customizing your home page is to use the example site that was <a href="/docs/fr/1.10.x/site-creation">created</a> when you ran the <a href="/docs/fr/1.10.x/installation">Docusaurus initialization script</a>.</p>
|
||||
<p>You can <a href="/docs/fr/1.10.x/site-preparation#verifying-installation">start</a> your local server and go to <code>http://localhost:3000</code> to see what the example home page looks like. From there, edit the <code>website/pages/en/index.js</code> file and its various components to use the images and text you want for your project.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-other-custom-pages"></a><a href="#adding-other-custom-pages" 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>Adding Other Custom Pages</h2>
|
||||
<p>Docusaurus provides some helpful example pages in the <code>website/pages/en</code> directory, including <code>index.js</code>, <code>users.js</code>, and <code>help.js</code>. These are good examples to showcase how to create a custom page for Docusaurus.</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">Custom Pages</h1></header><article><div><span><p>Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers <code>.js</code> au répertoire <code>website/pages</code>. Ces fichiers sont des composants <a href="https://reactjs.org/">React</a> et le <code>render()</code> est appelé pour les créer, avec le renfort des classes CSS, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-de-votre-page-daccueil"></a><a href="#personnalisation-de-votre-page-daccueil" 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 de votre page d'accueil</h2>
|
||||
<p>La façon la plus simple de commencer à personnaliser votre page d'accueil est d'utiliser le site d'exemple qui a été <a href="/docs/fr/1.10.x/site-creation">créé</a> lorsque vous avez exécuté le <a href="/docs/fr/1.10.x/installation">script d'initialisation Docusaurus</a>.</p>
|
||||
<p>Vous pouvez <a href="/docs/fr/1.10.x/site-preparation#verifying-installation">démarrer</a> votre serveur local et aller à l'adresse <code>http://localhost:3000</code> pour voir à quoi ressemble la page d'accueil d'exemple. À partir de là, éditez le fichier <code>website/pages/fr/index.js</code> et ses divers composants pour utiliser les images et le texte que vous voulez pour votre projet.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-dautres-pages-personnalisées"></a><a href="#ajouter-dautres-pages-personnalisées" 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>Ajouter d'autres pages personnalisées</h2>
|
||||
<p>Docusaurus fournit quelques exemples de pages utiles dans le répertoire <code>website/pages/en</code>, y compris <code>index.js</code>, <code>users.js</code> et <code>help.js</code>. Ce sont de bons exemples pour montrer comment créer une page personnalisée pour Docusaurus.</p>
|
||||
<pre><code class="hljs css language-bash">root-directory
|
||||
├── docs
|
||||
└── website
|
||||
|
|
@ -101,22 +101,22 @@
|
|||
├── siteConfig.js
|
||||
└── static
|
||||
</code></pre>
|
||||
<p>You are also free to write your own pages. It is strongly suggested that you at least have an index page, but none of the pages provided are mandatory to include in your site. More information on how to use the provided components or include your own can be found <a href="/docs/fr/1.10.x/api-pages">here</a>. Information on how to link to your different pages in the header navigation bar can be found <a href="/docs/fr/1.10.x/navigation">here</a>.</p>
|
||||
<p>Vous êtes également libre d'écrire vos propres pages. Il est fortement conseillé d'avoir au moins une page d'index, mais aucune des pages fournies n'est à inclure obligatoirement dans votre site. Plus d'informations sur la façon d'utiliser les composants fournis ou d'inclure vos propres composants peuvent être trouvées <a href="/docs/fr/1.10.x/api-pages">ici</a>. Des informations sur la façon de créer un lien vers vos différentes pages dans la barre de navigation d'entête peuvent être trouvées <a href="/docs/fr/1.10.x/navigation">ici</a>.</p>
|
||||
<blockquote>
|
||||
<p>If you want your page to show up in your navigation header, you will need to update <code>siteConfig.js</code> to add to the <code>headerLinks</code> element. e.g., <code>{ page: 'about-slash', label: 'About/' }</code>,</p>
|
||||
<p>Si vous voulez que votre page apparaisse dans votre entête de navigation, vous devrez mettre à jour <code>siteConfig.js</code> pour l'ajouter à l'élément <code>headerLinks</code>. Par exemple, <code>{ page: 'about-slash', label: 'About/' }</code>,</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-static-pages"></a><a href="#adding-static-pages" 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>Adding Static Pages</h2>
|
||||
<p>Static <code>.html</code> files can also be used, but they will not include Docusaurus' header, footer, or styles by default. These can be added to the <code>static</code> directory in the same way as other <a href="/docs/fr/1.10.x/api-pages#using-static-assets">static assets</a>. Alternatively, they can be placed in the <code>pages</code> directory and would be served as-is instead of being rendered from React.</p>
|
||||
<p>If you wish to use Docusaurus' stylesheet, you can access it at <code>${baseUrl}css/main.css</code>. If you wish to use separate CSS for these static pages, you can exclude them from being concatenated to Docusaurus' styles by adding them into the <code>siteConfig.separateCss</code> field in <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-de-pages-statiques"></a><a href="#ajouter-de-pages-statiques" 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>Ajouter de pages statiques</h2>
|
||||
<p>Les fichiers statiques <code>.html</code> peuvent également être utilisés, mais ils n'incluront pas l'entête de Docusaurus, le pied de page ou les styles par défaut. Celles-ci peuvent être ajoutées au répertoire <code>static</code> de la même manière que les autres <a href="/docs/fr/1.10.x/api-pages#using-static-assets">ressources statiques</a>. Autrement, elles peuvent être placées dans le répertoire <code>pages</code> et seront traitées en tant que telles au lieu d'être affichées à partir de React.</p>
|
||||
<p>Si vous souhaitez utiliser la feuille de style de Docusaurus, vous pouvez y accéder depuis <code>${baseUrl}css/main.css</code>. Si vous souhaitez utiliser des CSS séparés pour ces pages statiques, vous pouvez les empêcher d'être concaténés aux styles de Docusaurus en les ajoutant dans le champ <code>siteConfig.separateCss</code> dans <code>siteConfig.js</code>.</p>
|
||||
<blockquote>
|
||||
<p>You can set the <a href="/docs/fr/1.10.x/site-config#optional-fields"><code>$wrapPagesHTML</code> site config option</a> in order to wrap raw HTML fragments with the Docusaurus site styling, header and footer.</p>
|
||||
<p>Vous pouvez définir l'<a href="/docs/fr/1.10.x/site-config#optional-fields">option de configuration du site <code>$wrapPagesHTML</code></a> afin d'encapsuler les fragments HTML bruts avec le style du site Docusaurus, l'entête et le pied de page.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-your-site-footer"></a><a href="#customizing-your-site-footer" 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>Customizing Your Site Footer</h2>
|
||||
<p>Starting from the example <code>core/Footer.js</code> file that was <a href="/docs/fr/1.10.x/site-creation">created</a> when you ran the <a href="/docs/fr/1.10.x/installation">Docusaurus initialization script</a>, edit the footer to include any links to pages on your site or other sites that you wish to have.</p>
|
||||
<p>The example provided has three columns with a footer image on the left and Facebook's open source logo and copyright at the bottom. If your project is not a Facebook open source project, remove the logo and copyright. Otherwise, feel free to get creative with your footer and make it look however you'd like!</p>
|
||||
<p>Some suggestions for links you may want to provide: documentation, API, Twitter, Discord, Facebook groups, Stack Overflow, GitHub, etc.</p>
|
||||
<p>Your footer will automatically get applied to all pages on your site, including docs and blog posts. The sole exception to this is any static HTML pages you include.</p>
|
||||
<p>If you do not want a footer for your site, change the <code>render</code> function of <code>core/Footer.js</code> to return <code>null</code>. e.g.,</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-du-pied-de-page-de-votre-site"></a><a href="#personnalisation-du-pied-de-page-de-votre-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>Personnalisation du pied de page de votre site</h2>
|
||||
<p>À partir de l'exemple du fichier <code>core/Footer.js</code> qui a été <a href="/docs/fr/1.10.x/site-creation">créé</a> lorsque vous avez exécuté le <a href="/docs/fr/1.10.x/installation">script d'initialisation Docusaurus</a>, éditez le pied de page pour inclure tous les liens vers des pages de votre site ou d'autres sites que vous souhaitez avoir.</p>
|
||||
<p>L'exemple fourni a trois colonnes avec une image de pied de page à gauche et le logo open source de Facebook et les droits d'auteur en bas. Si votre projet n'est pas un projet open source Facebook, supprimez le logo et les droits d'auteur. Sinon, n'hésitez pas à faire preuve de créativité avec votre pied de page et à lui donner un aspect que vous aimeriez !</p>
|
||||
<p>Quelques suggestions pour les liens que vous pouvez fournir : documentation, API, Twitter, Discord, groupes Facebook, Stack Overflow, GitHub, etc.</p>
|
||||
<p>Votre pied de page sera automatiquement appliqué à toutes les pages de votre site, y compris les docs et les articles du blog. La seule exception à cela, c'est toute page HTML statique que vous incluez.</p>
|
||||
<p>Si vous ne voulez pas de pied de page pour votre site, changez la fonction <code>render</code> de <code>core/Footer.js</code> pour retourner <code>null</code>. Par exemple :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token keyword">const</span> React <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'react'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
|
||||
|
||||
<span class="token keyword">class</span> <span class="token class-name">Footer</span> <span class="token keyword">extends</span> <span class="token class-name">React<span class="token punctuation">.</span>Component</span> <span class="token punctuation">{</span>
|
||||
|
|
@ -127,7 +127,7 @@
|
|||
|
||||
module<span class="token punctuation">.</span>exports <span class="token operator">=</span> Footer<span class="token punctuation">;</span>
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/adding-blog"><span class="arrow-prev">← </span><span>Ajouter un blog</span></a><a class="docs-next button" href="/docs/fr/1.10.x/search"><span>Activation de la recherche</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#customizing-your-home-page">Customizing Your Home Page</a></li><li><a href="#adding-other-custom-pages">Adding Other Custom Pages</a></li><li><a href="#adding-static-pages">Adding Static Pages</a></li><li><a href="#customizing-your-site-footer">Customizing Your Site Footer</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/adding-blog"><span class="arrow-prev">← </span><span>Ajouter un blog</span></a><a class="docs-next button" href="/docs/fr/1.10.x/search"><span>Activation de la recherche</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#personnalisation-de-votre-page-daccueil">Personnalisation de votre page d'accueil</a></li><li><a href="#ajouter-dautres-pages-personnalisées">Ajouter d'autres pages personnalisées</a></li><li><a href="#ajouter-de-pages-statiques">Ajouter de pages statiques</a></li><li><a href="#personnalisation-du-pied-de-page-de-votre-site">Personnalisation du pied de page de votre site</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -118,8 +118,8 @@
|
|||
<h3><a class="anchor" aria-hidden="true" id="publications-de-blog"></a><a href="#publications-de-blog" 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>Publications de blog</h3>
|
||||
<p>Les articles du blog suivent les entêtes de markdown qui sont encadrées par une ligne <code>---</code> de chaque coté:</p>
|
||||
<p><code>titre</code>: Le titre de cet article du blog.</p>
|
||||
<p><code>author</code>: L'auteur de cet article du blog. Si ce champ est omis, aucun nom d'auteur ne sera affiché.</p>
|
||||
<p><code>authorURL</code>: Un vers une page lorsqu'un utilisateur du site clique sur le nom de l'auteur. Si ce champ est omis, le nom de l'auteur ne sera lié à rien.</p>
|
||||
<p><code>author</code> : L'auteur de cet article du blog. Si ce champ est omis, aucun nom d'auteur ne sera affiché.</p>
|
||||
<p><code>authorURL</code> : Une page vers laquelle se connecter lorsqu'un utilisateur du site clique sur le nom de l'auteur. Si ce champ est omis, le nom de l'auteur ne sera lié à rien.</p>
|
||||
<p><code>authorFBID</code> : L'identifiant Facebook de l'auteur, utilisé uniquement pour obtenir la photo de profil de l'auteur à afficher avec l'article du blog. Si ce champ est omis, aucune image d’auteur ne sera affichée pour l'article du blog.</p>
|
||||
<p>Par exemple :</p>
|
||||
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
|
||||
|
|
|
|||
|
|
@ -118,8 +118,8 @@
|
|||
<h3><a class="anchor" aria-hidden="true" id="publications-de-blog"></a><a href="#publications-de-blog" 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>Publications de blog</h3>
|
||||
<p>Les articles du blog suivent les entêtes de markdown qui sont encadrées par une ligne <code>---</code> de chaque coté:</p>
|
||||
<p><code>titre</code>: Le titre de cet article du blog.</p>
|
||||
<p><code>author</code>: L'auteur de cet article du blog. Si ce champ est omis, aucun nom d'auteur ne sera affiché.</p>
|
||||
<p><code>authorURL</code>: Un vers une page lorsqu'un utilisateur du site clique sur le nom de l'auteur. Si ce champ est omis, le nom de l'auteur ne sera lié à rien.</p>
|
||||
<p><code>author</code> : L'auteur de cet article du blog. Si ce champ est omis, aucun nom d'auteur ne sera affiché.</p>
|
||||
<p><code>authorURL</code> : Une page vers laquelle se connecter lorsqu'un utilisateur du site clique sur le nom de l'auteur. Si ce champ est omis, le nom de l'auteur ne sera lié à rien.</p>
|
||||
<p><code>authorFBID</code> : L'identifiant Facebook de l'auteur, utilisé uniquement pour obtenir la photo de profil de l'auteur à afficher avec l'article du blog. Si ce champ est omis, aucune image d’auteur ne sera affichée pour l'article du blog.</p>
|
||||
<p>Par exemple :</p>
|
||||
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
|
||||
|
|
|
|||
|
|
@ -95,11 +95,11 @@
|
|||
</blockquote></li>
|
||||
<li><p>Exécutez le script d'installation de Docusaurus : <code>npx docusaurus-init</code>.</p>
|
||||
<blockquote>
|
||||
<p>Si vous n’avez pas node 8.2 + ou si vous préférez installer Docusaurus de manière globale, exécutez <code>yarn global add docusaurus-init</code> ou <code>npm install - global docusaurus-init</code>. Après, exécutez <code>docusaurus-init</code>.</p>
|
||||
<p>Si vous n’avez pas node 8.2 + ou si vous préférez installer Docusaurus de manière globale, exécutez <code>yarn global add docusaurus-init</code> ou <code>npm install --global docusaurus-init</code>. Après, exécutez <code>docusaurus-init</code>.</p>
|
||||
</blockquote></li>
|
||||
</ol>
|
||||
<h2><a class="anchor" aria-hidden="true" id="vérification-de-linstallation"></a><a href="#vérification-de-linstallation" 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>Vérification de l'installation</h2>
|
||||
<p>Ainsi que les répertoires et les fichiers déjà existants, votre répertoire racine contient maintenant une structure semblable à :</p>
|
||||
<p>Avec les répertoires et les fichiers déjà existants, votre répertoire racine contient maintenant une structure semblable à :</p>
|
||||
<pre><code class="hljs css language-bash">root-directory
|
||||
├── Dockerfile
|
||||
├── README.md
|
||||
|
|
@ -131,7 +131,7 @@
|
|||
<li><p><code>cd website</code></p></li>
|
||||
<li><p>Depuis le répertoire <code>website</code>, exécutez le serveur web local en utilisant <code>yarn start</code> ou <code>npm start</code>.</p></li>
|
||||
<li><p>Chargez le site d'exemple depuis l'adresse <a href="http://localhost:3000">http://localhost:3000</a> 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.</p>
|
||||
<p>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 <code>website</code> causeront une actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.</p></li>
|
||||
<p>Vous devriez voir le site d'exemple chargé dans votre navigateur Web. Il y a aussi un serveur LiveReload en cours d'exécution et toute modification apportée à la documentation et aux fichiers dans le répertoire <code>website</code> provoquera l'actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.</p></li>
|
||||
</ol>
|
||||
<p><img src="/img/getting-started-preparation-verify.png" alt=""></p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="lancement-du-serveur-derrière-un-proxy"></a><a href="#lancement-du-serveur-derrière-un-proxy" 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>Lancement du serveur derrière un proxy</h3>
|
||||
|
|
@ -141,7 +141,7 @@ yarn start (ou npm run start)
|
|||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="mettre-à-jour-votre-version-de-docusaurus"></a><a href="#mettre-à-jour-votre-version-de-docusaurus" 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>Mettre à jour votre version de Docusaurus</h2>
|
||||
<p>A tout moment, après avoir installé Docusaurus, vous pouvez vérifier votre version actuelle en allant dans le répertoire <code>website</code> et en écrivant <code>yarn outdated docusaurus</code> ou <code>npm outdated docusaurus</code>.</p>
|
||||
<p>Vous pourrez voir quelque chose comme ça:</p>
|
||||
<p>Vous verrez quelque chose comme ceci :</p>
|
||||
<pre><code class="hljs">$ yarn outdated
|
||||
Using globally installed version of Yarn
|
||||
yarn outdated v1.5.1
|
||||
|
|
@ -158,14 +158,14 @@ docusaurus 1.0.9 1.2.0 1.2.0 devDependencies https://github.com/facebook/doc
|
|||
<blockquote>
|
||||
<p>S'il n'y as pas de version visible sur la sortie de la commande <code>outdated</code>, vous êtes à jour.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez mettre à jour la <a href="https://www.npmjs.com/package/docusaurus">dernière version</a> de Docusaurus via:</p>
|
||||
<p>Vous pouvez mettre à jour la <a href="https://www.npmjs.com/package/docusaurus">dernière version</a> de Docusaurus via :</p>
|
||||
<pre><code class="hljs">yarn upgrade docusaurus --latest
|
||||
</code></pre>
|
||||
<p>ou</p>
|
||||
<pre><code class="hljs">npm update docusaurus
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>Si vous obtenez une erreur après la mise à jours, essayez de nettoyer votre cache Babel (généralement il se trouve dans un <a href="https://babeljs.io/docs/en/babel-register/#environment-variables">dossier temporaire</a>) ou de lancer le serveur Docusaurus (par exemple <code>yarn start</code> avec le paramètre d'environnement <code>BABEL_DISABLE_CACHE=1</code>.</p>
|
||||
<p>Si vous obtenez une erreur après la mise à jour, essayez de nettoyer votre cache Babel (généralement il se trouve dans un <a href="https://babeljs.io/docs/en/babel-register/#environment-variables">dossier temporaire</a>) ou lancer le serveur Docusaurus (par exemple <code>yarn start</code> avec le paramètre d'environnement <code>BABEL_DISABLE_CACHE=1</code>.</p>
|
||||
</blockquote>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.10.x/site-preparation"><span>Préparation du site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#installation-de-docusaurus">Installation de Docusaurus</a></li><li><a href="#vérification-de-linstallation">Vérification de l'installation</a></li><li><a href="#exécution-du-site-web-dexemple">Exécution du site web d'exemple</a><ul class="toc-headings"><li><a href="#lancement-du-serveur-derrière-un-proxy">Lancement du serveur derrière un proxy</a></li></ul></li><li><a href="#mettre-à-jour-votre-version-de-docusaurus">Mettre à jour votre version de Docusaurus</a></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="
|
||||
|
|
|
|||
|
|
@ -95,11 +95,11 @@
|
|||
</blockquote></li>
|
||||
<li><p>Exécutez le script d'installation de Docusaurus : <code>npx docusaurus-init</code>.</p>
|
||||
<blockquote>
|
||||
<p>Si vous n’avez pas node 8.2 + ou si vous préférez installer Docusaurus de manière globale, exécutez <code>yarn global add docusaurus-init</code> ou <code>npm install - global docusaurus-init</code>. Après, exécutez <code>docusaurus-init</code>.</p>
|
||||
<p>Si vous n’avez pas node 8.2 + ou si vous préférez installer Docusaurus de manière globale, exécutez <code>yarn global add docusaurus-init</code> ou <code>npm install --global docusaurus-init</code>. Après, exécutez <code>docusaurus-init</code>.</p>
|
||||
</blockquote></li>
|
||||
</ol>
|
||||
<h2><a class="anchor" aria-hidden="true" id="vérification-de-linstallation"></a><a href="#vérification-de-linstallation" 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>Vérification de l'installation</h2>
|
||||
<p>Ainsi que les répertoires et les fichiers déjà existants, votre répertoire racine contient maintenant une structure semblable à :</p>
|
||||
<p>Avec les répertoires et les fichiers déjà existants, votre répertoire racine contient maintenant une structure semblable à :</p>
|
||||
<pre><code class="hljs css language-bash">root-directory
|
||||
├── Dockerfile
|
||||
├── README.md
|
||||
|
|
@ -131,7 +131,7 @@
|
|||
<li><p><code>cd website</code></p></li>
|
||||
<li><p>Depuis le répertoire <code>website</code>, exécutez le serveur web local en utilisant <code>yarn start</code> ou <code>npm start</code>.</p></li>
|
||||
<li><p>Chargez le site d'exemple depuis l'adresse <a href="http://localhost:3000">http://localhost:3000</a> 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.</p>
|
||||
<p>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 <code>website</code> causeront une actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.</p></li>
|
||||
<p>Vous devriez voir le site d'exemple chargé dans votre navigateur Web. Il y a aussi un serveur LiveReload en cours d'exécution et toute modification apportée à la documentation et aux fichiers dans le répertoire <code>website</code> provoquera l'actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.</p></li>
|
||||
</ol>
|
||||
<p><img src="/img/getting-started-preparation-verify.png" alt=""></p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="lancement-du-serveur-derrière-un-proxy"></a><a href="#lancement-du-serveur-derrière-un-proxy" 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>Lancement du serveur derrière un proxy</h3>
|
||||
|
|
@ -141,7 +141,7 @@ yarn start (ou npm run start)
|
|||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="mettre-à-jour-votre-version-de-docusaurus"></a><a href="#mettre-à-jour-votre-version-de-docusaurus" 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>Mettre à jour votre version de Docusaurus</h2>
|
||||
<p>A tout moment, après avoir installé Docusaurus, vous pouvez vérifier votre version actuelle en allant dans le répertoire <code>website</code> et en écrivant <code>yarn outdated docusaurus</code> ou <code>npm outdated docusaurus</code>.</p>
|
||||
<p>Vous pourrez voir quelque chose comme ça:</p>
|
||||
<p>Vous verrez quelque chose comme ceci :</p>
|
||||
<pre><code class="hljs">$ yarn outdated
|
||||
Using globally installed version of Yarn
|
||||
yarn outdated v1.5.1
|
||||
|
|
@ -158,14 +158,14 @@ docusaurus 1.0.9 1.2.0 1.2.0 devDependencies https://github.com/facebook/doc
|
|||
<blockquote>
|
||||
<p>S'il n'y as pas de version visible sur la sortie de la commande <code>outdated</code>, vous êtes à jour.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez mettre à jour la <a href="https://www.npmjs.com/package/docusaurus">dernière version</a> de Docusaurus via:</p>
|
||||
<p>Vous pouvez mettre à jour la <a href="https://www.npmjs.com/package/docusaurus">dernière version</a> de Docusaurus via :</p>
|
||||
<pre><code class="hljs">yarn upgrade docusaurus --latest
|
||||
</code></pre>
|
||||
<p>ou</p>
|
||||
<pre><code class="hljs">npm update docusaurus
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>Si vous obtenez une erreur après la mise à jours, essayez de nettoyer votre cache Babel (généralement il se trouve dans un <a href="https://babeljs.io/docs/en/babel-register/#environment-variables">dossier temporaire</a>) ou de lancer le serveur Docusaurus (par exemple <code>yarn start</code> avec le paramètre d'environnement <code>BABEL_DISABLE_CACHE=1</code>.</p>
|
||||
<p>Si vous obtenez une erreur après la mise à jour, essayez de nettoyer votre cache Babel (généralement il se trouve dans un <a href="https://babeljs.io/docs/en/babel-register/#environment-variables">dossier temporaire</a>) ou lancer le serveur Docusaurus (par exemple <code>yarn start</code> avec le paramètre d'environnement <code>BABEL_DISABLE_CACHE=1</code>.</p>
|
||||
</blockquote>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.10.x/site-preparation"><span>Préparation du site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#installation-de-docusaurus">Installation de Docusaurus</a></li><li><a href="#vérification-de-linstallation">Vérification de l'installation</a></li><li><a href="#exécution-du-site-web-dexemple">Exécution du site web d'exemple</a><ul class="toc-headings"><li><a href="#lancement-du-serveur-derrière-un-proxy">Lancement du serveur derrière un proxy</a></li></ul></li><li><a href="#mettre-à-jour-votre-version-de-docusaurus">Mettre à jour votre version de Docusaurus</a></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="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Navigation and Sidebars · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Referencing Site Documents"/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Navigation and Sidebars · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="## Referencing Site Documents"/><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>Navigation and Sidebars · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Faire référence aux documents du site"/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Navigation and Sidebars · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="## Faire référence aux documents du site"/><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,34 +80,34 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Navigation and Sidebars</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="referencing-site-documents"></a><a href="#referencing-site-documents" 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>Referencing Site Documents</h2>
|
||||
<p>If you want to reference another document in your <code>docs</code> directory (or the location you set via the <a href="https://docusaurus.io/docs/en/site-config.html#optional-fields">optional <code>customDocsPath</code></a> path site configuration option), then you just use the name of the document you want to reference.</p>
|
||||
<p>For example, if you are in <code>doc2.md</code> and you want to reference <code>doc1.md</code>:</p>
|
||||
<pre><code class="hljs css language-md">I am referencing a [<span class="hljs-string">document</span>](<span class="hljs-link">doc1.md</span>).
|
||||
</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">Navigation and Sidebars</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="faire-référence-aux-documents-du-site"></a><a href="#faire-référence-aux-documents-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>Faire référence aux documents du site</h2>
|
||||
<p>Si vous voulez référencer un autre document dans votre dossier <code>docs</code> (ou l'emplacement que vous avez défini via le chemin <a href="https://docusaurus.io/docs/en/site-config.html#optional-fields">optionnel <code>customDocsPath</code></a> de la configuration du site), alors utilisez simplement le nom du document que vous voulez référencer.</p>
|
||||
<p>Par exemple, si vous êtes dans <code>doc2.md</code> et que vous voulez faire référence à <code>doc1.md</code>:</p>
|
||||
<pre><code class="hljs css language-md">Je fais référence à un [<span class="hljs-string">document</span>](<span class="hljs-link">doc1.md</span>).
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-documents-are-linked"></a><a href="#how-documents-are-linked" 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>How Documents are Linked</h2>
|
||||
<p>New markdown files within <code>docs</code> will show up as pages on the website. Links to those documents are created first by using the <code>id</code> in the header of each document. If there is no <code>id</code> field, then the name of the file will serve as the link name.</p>
|
||||
<p>For example, creating an empty file such as <code>docs/getting-started.md</code> will enable the new page URL as <code>/docs/getting-started.html</code>.</p>
|
||||
<p>Suppose you add this to your document:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-les-documents-sont-liés"></a><a href="#comment-les-documents-sont-liés" 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>Comment les documents sont liés</h2>
|
||||
<p>Les nouveaux fichiers markdown dans <code>docs</code> apparaîtront sous forme de pages sur le site web. Les liens vers ces documents sont créés d'abord en utilisant l'<code>id</code> dans l'entête de chaque document. S'il n'y a pas de champ <code>id</code>, alors le nom du fichier servira de nom de lien.</p>
|
||||
<p>Par exemple, la création d'un fichier vide tel que <code>docs/getting-started.md</code> activera l'URL de la nouvelle page avec <code>/docs/getting-started.html</code>.</p>
|
||||
<p>Supposons que vous ajoutiez ceci à votre document :</p>
|
||||
<pre><code class="hljs css language-yaml"><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>
|
||||
<p>If you set the <code>id</code> field in the markdown header of the file, the doc will then be accessed from a URL of the form <code>/docs/intro.html</code>.</p>
|
||||
<p>Si vous définissez le champ <code>id</code> dans l'entête du fichier markdown, le doc sera alors accédé à partir d'une URL de la forme <code>/docs/intro.html</code>.</p>
|
||||
<blockquote>
|
||||
<p>You need an <code>id</code> field to be able to add the document to the sidebar.</p>
|
||||
<p>Vous avez besoin d'un champ <code>id</code> pour pouvoir ajouter le document à la barre latérale.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-documents-to-a-sidebar"></a><a href="#adding-documents-to-a-sidebar" 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>Adding Documents to a Sidebar</h2>
|
||||
<p>Many times, you will want to add a document to a sidebar that will be associated with one of the headers in the top navigation bar of the website. The most common sidebar, and the one that comes installed when Docusaurus is initialized, is the <code>docs</code> sidebar.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-des-documents-à-une-barre-latérale"></a><a href="#ajouter-des-documents-à-une-barre-latérale" 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>Ajouter des documents à une barre latérale</h2>
|
||||
<p>Souvent, vous voudrez ajouter un document à une barre latérale qui sera associée à l'un des entêtes dans la barre de navigation supérieure du site web. La barre latérale la plus courante, et celle qui est installée lorsque Docusaurus est initialisé, c'est la barre latérale <code>docs</code>.</p>
|
||||
<blockquote>
|
||||
<p>"docs" is just a name. It has no inherent meaning. You can change it as you wish.</p>
|
||||
<p>« docs » est juste un nom. Il n'a pas de signification particulière. Vous pouvez le modifier comme vous le souhaitez.</p>
|
||||
</blockquote>
|
||||
<p>You configure the contents of the sidebar, and the order of its documents, in the <code>website/sidebars.json</code> file.</p>
|
||||
<p>Vous configurez le contenu de la barre latérale et l'ordre de ses documents, dans le fichier <code>website/sidebars.json</code>.</p>
|
||||
<blockquote>
|
||||
<p>Until you add your document to <code>website/sidebars.json</code>, they will only be accessible via a direct URL. The doc will not show up in any sidebar.</p>
|
||||
<p>Jusqu'à ce que vous ajoutiez votre document à <code>website/sidebars.json</code>, il ne sera accessible que par une URL directe. Le doc n'apparaîtra dans aucune barre latérale.</p>
|
||||
</blockquote>
|
||||
<p>Within <code>sidebars.json</code>, add the <code>id</code> you used in the document header to existing sidebar/category. In the below case, <code>docs</code> is the name of the sidebar and <code>Getting Started</code> is a category within the sidebar.</p>
|
||||
<p>Dans <code>sidebars.json</code>, ajoutez l'<code>id</code> que vous avez utilisé dans l'entête du document à la barre latérale/catégorie existante. Dans le cas ci-dessous, <code>docs</code> est le nom de la barre latérale et <code>Getting Started</code> est une catégorie dans la barre latérale.</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"Getting Started"</span>: [
|
||||
|
|
@ -118,29 +118,29 @@
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>Or you can create a new category within the sidebar:</p>
|
||||
<p>Ou vous pouvez créer une nouvelle catégorie dans la barre latérale :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"My New Sidebar Category"</span>: [
|
||||
<span class="hljs-string">"Ma nouvelle catégorie de la barre latérale"</span>: [
|
||||
<span class="hljs-string">"getting-started"</span>
|
||||
],
|
||||
...
|
||||
...
|
||||
},
|
||||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>However, for a document located in a docs subdirectory like below:</p>
|
||||
<p>Cependant, pour un document situé dans un sous-répertoire de docs comme ci-dessous :</p>
|
||||
<pre><code class="hljs css language-bash">docs
|
||||
└── dir1
|
||||
└── getting-started.md
|
||||
</code></pre>
|
||||
<p>You should provide <code>directory/id</code> instead of <code>id</code> in <code>sidebars.json</code>.</p>
|
||||
<p>Vous devez fournir <code>le_répertoire/id</code> au lieu d'<code>id</code> dans <code>sidebars.json</code>.</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"My New Sidebar Category"</span>: [
|
||||
<span class="hljs-string">"Ma nouvelle catégorie de la barre latérale"</span>: [
|
||||
<span class="hljs-string">"dir1/getting-started"</span>
|
||||
],
|
||||
...
|
||||
...
|
||||
},
|
||||
...
|
||||
}
|
||||
|
|
@ -291,7 +291,7 @@ The above will generate:
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/search"><span class="arrow-prev">← </span><span>Activation de la recherche</span></a><a class="docs-next button" href="/docs/fr/1.10.x/translation"><span>Traductions & Localisation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#referencing-site-documents">Referencing Site Documents</a></li><li><a href="#how-documents-are-linked">How Documents are Linked</a></li><li><a href="#adding-documents-to-a-sidebar">Adding Documents to a Sidebar</a><ul class="toc-headings"><li><a href="#adding-subcategories">Adding Subcategories</a></li><li><a href="#adding-new-sidebars">Adding New Sidebars</a></li></ul></li><li><a href="#additions-to-the-site-navigation-bar">Additions to the Site Navigation Bar</a><ul class="toc-headings"><li><a href="#adding-documents">Adding Documents</a></li><li><a href="#adding-custom-pages">Adding Custom Pages</a></li><li><a href="#adding-external-links">Adding External Links</a></li></ul></li><li><a href="#site-navigation-bar-positioning">Site Navigation Bar Positioning</a><ul class="toc-headings"><li><a href="#search">Search</a></li><li><a href="#languages-dropdown">Languages Dropdown</a></li></ul></li><li><a href="#active-links-in-site-navigation-bar">Active Links In Site Navigation Bar</a></li><li><a href="#secondary-on-page-navigation">Secondary On-Page Navigation</a></li><li><a href="#collapsible-categories">Collapsible Categories</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/search"><span class="arrow-prev">← </span><span>Activation de la recherche</span></a><a class="docs-next button" href="/docs/fr/1.10.x/translation"><span>Traductions & Localisation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#faire-référence-aux-documents-du-site">Faire référence aux documents du site</a></li><li><a href="#comment-les-documents-sont-liés">Comment les documents sont liés</a></li><li><a href="#ajouter-des-documents-à-une-barre-latérale">Ajouter des documents à une barre latérale</a><ul class="toc-headings"><li><a href="#adding-subcategories">Adding Subcategories</a></li><li><a href="#adding-new-sidebars">Adding New Sidebars</a></li></ul></li><li><a href="#additions-to-the-site-navigation-bar">Additions to the Site Navigation Bar</a><ul class="toc-headings"><li><a href="#adding-documents">Adding Documents</a></li><li><a href="#adding-custom-pages">Adding Custom Pages</a></li><li><a href="#adding-external-links">Adding External Links</a></li></ul></li><li><a href="#site-navigation-bar-positioning">Site Navigation Bar Positioning</a><ul class="toc-headings"><li><a href="#search">Search</a></li><li><a href="#languages-dropdown">Languages Dropdown</a></li></ul></li><li><a href="#active-links-in-site-navigation-bar">Active Links In Site Navigation Bar</a></li><li><a href="#secondary-on-page-navigation">Secondary On-Page Navigation</a></li><li><a href="#collapsible-categories">Collapsible Categories</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Navigation and Sidebars · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Referencing Site Documents"/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Navigation and Sidebars · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="## Referencing Site Documents"/><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>Navigation and Sidebars · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Faire référence aux documents du site"/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Navigation and Sidebars · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="## Faire référence aux documents du site"/><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,34 +80,34 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Navigation and Sidebars</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="referencing-site-documents"></a><a href="#referencing-site-documents" 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>Referencing Site Documents</h2>
|
||||
<p>If you want to reference another document in your <code>docs</code> directory (or the location you set via the <a href="https://docusaurus.io/docs/en/site-config.html#optional-fields">optional <code>customDocsPath</code></a> path site configuration option), then you just use the name of the document you want to reference.</p>
|
||||
<p>For example, if you are in <code>doc2.md</code> and you want to reference <code>doc1.md</code>:</p>
|
||||
<pre><code class="hljs css language-md">I am referencing a [<span class="hljs-string">document</span>](<span class="hljs-link">doc1.md</span>).
|
||||
</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">Navigation and Sidebars</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="faire-référence-aux-documents-du-site"></a><a href="#faire-référence-aux-documents-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>Faire référence aux documents du site</h2>
|
||||
<p>Si vous voulez référencer un autre document dans votre dossier <code>docs</code> (ou l'emplacement que vous avez défini via le chemin <a href="https://docusaurus.io/docs/en/site-config.html#optional-fields">optionnel <code>customDocsPath</code></a> de la configuration du site), alors utilisez simplement le nom du document que vous voulez référencer.</p>
|
||||
<p>Par exemple, si vous êtes dans <code>doc2.md</code> et que vous voulez faire référence à <code>doc1.md</code>:</p>
|
||||
<pre><code class="hljs css language-md">Je fais référence à un [<span class="hljs-string">document</span>](<span class="hljs-link">doc1.md</span>).
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-documents-are-linked"></a><a href="#how-documents-are-linked" 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>How Documents are Linked</h2>
|
||||
<p>New markdown files within <code>docs</code> will show up as pages on the website. Links to those documents are created first by using the <code>id</code> in the header of each document. If there is no <code>id</code> field, then the name of the file will serve as the link name.</p>
|
||||
<p>For example, creating an empty file such as <code>docs/getting-started.md</code> will enable the new page URL as <code>/docs/getting-started.html</code>.</p>
|
||||
<p>Suppose you add this to your document:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-les-documents-sont-liés"></a><a href="#comment-les-documents-sont-liés" 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>Comment les documents sont liés</h2>
|
||||
<p>Les nouveaux fichiers markdown dans <code>docs</code> apparaîtront sous forme de pages sur le site web. Les liens vers ces documents sont créés d'abord en utilisant l'<code>id</code> dans l'entête de chaque document. S'il n'y a pas de champ <code>id</code>, alors le nom du fichier servira de nom de lien.</p>
|
||||
<p>Par exemple, la création d'un fichier vide tel que <code>docs/getting-started.md</code> activera l'URL de la nouvelle page avec <code>/docs/getting-started.html</code>.</p>
|
||||
<p>Supposons que vous ajoutiez ceci à votre document :</p>
|
||||
<pre><code class="hljs css language-yaml"><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>
|
||||
<p>If you set the <code>id</code> field in the markdown header of the file, the doc will then be accessed from a URL of the form <code>/docs/intro.html</code>.</p>
|
||||
<p>Si vous définissez le champ <code>id</code> dans l'entête du fichier markdown, le doc sera alors accédé à partir d'une URL de la forme <code>/docs/intro.html</code>.</p>
|
||||
<blockquote>
|
||||
<p>You need an <code>id</code> field to be able to add the document to the sidebar.</p>
|
||||
<p>Vous avez besoin d'un champ <code>id</code> pour pouvoir ajouter le document à la barre latérale.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-documents-to-a-sidebar"></a><a href="#adding-documents-to-a-sidebar" 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>Adding Documents to a Sidebar</h2>
|
||||
<p>Many times, you will want to add a document to a sidebar that will be associated with one of the headers in the top navigation bar of the website. The most common sidebar, and the one that comes installed when Docusaurus is initialized, is the <code>docs</code> sidebar.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-des-documents-à-une-barre-latérale"></a><a href="#ajouter-des-documents-à-une-barre-latérale" 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>Ajouter des documents à une barre latérale</h2>
|
||||
<p>Souvent, vous voudrez ajouter un document à une barre latérale qui sera associée à l'un des entêtes dans la barre de navigation supérieure du site web. La barre latérale la plus courante, et celle qui est installée lorsque Docusaurus est initialisé, c'est la barre latérale <code>docs</code>.</p>
|
||||
<blockquote>
|
||||
<p>"docs" is just a name. It has no inherent meaning. You can change it as you wish.</p>
|
||||
<p>« docs » est juste un nom. Il n'a pas de signification particulière. Vous pouvez le modifier comme vous le souhaitez.</p>
|
||||
</blockquote>
|
||||
<p>You configure the contents of the sidebar, and the order of its documents, in the <code>website/sidebars.json</code> file.</p>
|
||||
<p>Vous configurez le contenu de la barre latérale et l'ordre de ses documents, dans le fichier <code>website/sidebars.json</code>.</p>
|
||||
<blockquote>
|
||||
<p>Until you add your document to <code>website/sidebars.json</code>, they will only be accessible via a direct URL. The doc will not show up in any sidebar.</p>
|
||||
<p>Jusqu'à ce que vous ajoutiez votre document à <code>website/sidebars.json</code>, il ne sera accessible que par une URL directe. Le doc n'apparaîtra dans aucune barre latérale.</p>
|
||||
</blockquote>
|
||||
<p>Within <code>sidebars.json</code>, add the <code>id</code> you used in the document header to existing sidebar/category. In the below case, <code>docs</code> is the name of the sidebar and <code>Getting Started</code> is a category within the sidebar.</p>
|
||||
<p>Dans <code>sidebars.json</code>, ajoutez l'<code>id</code> que vous avez utilisé dans l'entête du document à la barre latérale/catégorie existante. Dans le cas ci-dessous, <code>docs</code> est le nom de la barre latérale et <code>Getting Started</code> est une catégorie dans la barre latérale.</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"Getting Started"</span>: [
|
||||
|
|
@ -118,29 +118,29 @@
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>Or you can create a new category within the sidebar:</p>
|
||||
<p>Ou vous pouvez créer une nouvelle catégorie dans la barre latérale :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"My New Sidebar Category"</span>: [
|
||||
<span class="hljs-string">"Ma nouvelle catégorie de la barre latérale"</span>: [
|
||||
<span class="hljs-string">"getting-started"</span>
|
||||
],
|
||||
...
|
||||
...
|
||||
},
|
||||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>However, for a document located in a docs subdirectory like below:</p>
|
||||
<p>Cependant, pour un document situé dans un sous-répertoire de docs comme ci-dessous :</p>
|
||||
<pre><code class="hljs css language-bash">docs
|
||||
└── dir1
|
||||
└── getting-started.md
|
||||
</code></pre>
|
||||
<p>You should provide <code>directory/id</code> instead of <code>id</code> in <code>sidebars.json</code>.</p>
|
||||
<p>Vous devez fournir <code>le_répertoire/id</code> au lieu d'<code>id</code> dans <code>sidebars.json</code>.</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"My New Sidebar Category"</span>: [
|
||||
<span class="hljs-string">"Ma nouvelle catégorie de la barre latérale"</span>: [
|
||||
<span class="hljs-string">"dir1/getting-started"</span>
|
||||
],
|
||||
...
|
||||
...
|
||||
},
|
||||
...
|
||||
}
|
||||
|
|
@ -291,7 +291,7 @@ The above will generate:
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/search"><span class="arrow-prev">← </span><span>Activation de la recherche</span></a><a class="docs-next button" href="/docs/fr/1.10.x/translation"><span>Traductions & Localisation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#referencing-site-documents">Referencing Site Documents</a></li><li><a href="#how-documents-are-linked">How Documents are Linked</a></li><li><a href="#adding-documents-to-a-sidebar">Adding Documents to a Sidebar</a><ul class="toc-headings"><li><a href="#adding-subcategories">Adding Subcategories</a></li><li><a href="#adding-new-sidebars">Adding New Sidebars</a></li></ul></li><li><a href="#additions-to-the-site-navigation-bar">Additions to the Site Navigation Bar</a><ul class="toc-headings"><li><a href="#adding-documents">Adding Documents</a></li><li><a href="#adding-custom-pages">Adding Custom Pages</a></li><li><a href="#adding-external-links">Adding External Links</a></li></ul></li><li><a href="#site-navigation-bar-positioning">Site Navigation Bar Positioning</a><ul class="toc-headings"><li><a href="#search">Search</a></li><li><a href="#languages-dropdown">Languages Dropdown</a></li></ul></li><li><a href="#active-links-in-site-navigation-bar">Active Links In Site Navigation Bar</a></li><li><a href="#secondary-on-page-navigation">Secondary On-Page Navigation</a></li><li><a href="#collapsible-categories">Collapsible Categories</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/search"><span class="arrow-prev">← </span><span>Activation de la recherche</span></a><a class="docs-next button" href="/docs/fr/1.10.x/translation"><span>Traductions & Localisation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#faire-référence-aux-documents-du-site">Faire référence aux documents du site</a></li><li><a href="#comment-les-documents-sont-liés">Comment les documents sont liés</a></li><li><a href="#ajouter-des-documents-à-une-barre-latérale">Ajouter des documents à une barre latérale</a><ul class="toc-headings"><li><a href="#adding-subcategories">Adding Subcategories</a></li><li><a href="#adding-new-sidebars">Adding New Sidebars</a></li></ul></li><li><a href="#additions-to-the-site-navigation-bar">Additions to the Site Navigation Bar</a><ul class="toc-headings"><li><a href="#adding-documents">Adding Documents</a></li><li><a href="#adding-custom-pages">Adding Custom Pages</a></li><li><a href="#adding-external-links">Adding External Links</a></li></ul></li><li><a href="#site-navigation-bar-positioning">Site Navigation Bar Positioning</a><ul class="toc-headings"><li><a href="#search">Search</a></li><li><a href="#languages-dropdown">Languages Dropdown</a></li></ul></li><li><a href="#active-links-in-site-navigation-bar">Active Links In Site Navigation Bar</a></li><li><a href="#secondary-on-page-navigation">Secondary On-Page Navigation</a></li><li><a href="#collapsible-categories">Collapsible Categories</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Enabling Search · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus supports search using [Algolia DocSearch](https://community.algolia.com/docsearch/). Once your website is online, you can [submit it to DocSearch](https://community.algolia.com/docsearch/). Algolia will then send you credentials you can add to your `siteConfig.js`."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Enabling Search · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus supports search using [Algolia DocSearch](https://community.algolia.com/docsearch/). Once your website is online, you can [submit it to DocSearch](https://community.algolia.com/docsearch/). Algolia will then send you credentials you can add to your `siteConfig.js`."/><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>Enabling Search · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus prend en charge la recherche en utilisant [Algolia DocSearch](https://community.algolia.com/docsearch/). Une fois que votre site est en ligne, vous pouvez [le soumettre à DocSearch](https://community.algolia.com/docsearch/). Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre `siteConfig.js`."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Enabling Search · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus prend en charge la recherche en utilisant [Algolia DocSearch](https://community.algolia.com/docsearch/). Une fois que votre site est en ligne, vous pouvez [le soumettre à DocSearch](https://community.algolia.com/docsearch/). Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre `siteConfig.js`."/><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,22 +80,22 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Enabling Search</h1></header><article><div><span><p>Docusaurus supports search using <a href="https://community.algolia.com/docsearch/">Algolia DocSearch</a>. Once your website is online, you can <a href="https://community.algolia.com/docsearch/">submit it to DocSearch</a>. Algolia will then send you credentials you can add to your <code>siteConfig.js</code>.</p>
|
||||
<p>DocSearch works by crawling the content of your website every 24 hours and putting all the content in an Algolia index. This content is then queried directly from your front-end using the Algolia API. Note that your website needs to be publicly available for this to work (ie. not behind a firewall). This service is free.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="enabling-the-search-bar"></a><a href="#enabling-the-search-bar" 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>Enabling the Search Bar</h2>
|
||||
<p>Enter your API key and index name (sent by Algolia) into <code>siteConfig.js</code> in the <code>algolia</code> section to enable search for your site.</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">Enabling Search</h1></header><article><div><span><p>Docusaurus prend en charge la recherche en utilisant <a href="https://community.algolia.com/docsearch/">Algolia DocSearch</a>. Une fois que votre site est en ligne, vous pouvez <a href="https://community.algolia.com/docsearch/">le soumettre à DocSearch</a>. Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre <code>siteConfig.js</code>.</p>
|
||||
<p>DocSearch travaille en explorant le contenu de votre site Web toutes les 24 heures et en mettant tout le contenu dans un index Algolia. Ce contenu est ensuite interrogé directement depuis votre front-end en utilisant l'API Algolia. Notez que votre site Web doit être accessible au public pour que cela fonctionne (par exemple pas derrière un pare-feu). Ce service est gratuit.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="activation-de-la-barre-de-recherche"></a><a href="#activation-de-la-barre-de-recherche" 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>Activation de la barre de recherche</h2>
|
||||
<p>Entrez votre clé API et le nom de l'index (envoyé par Algolia) dans <code>siteConfig.js</code> dans la section <code>algolia</code> pour activer la recherche de votre site.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
<span class="hljs-attr">apiKey</span>: <span class="hljs-string">'my-api-key'</span>,
|
||||
<span class="hljs-attr">indexName</span>: <span class="hljs-string">'my-index-name'</span>,
|
||||
<span class="hljs-attr">algoliaOptions</span>: {} <span class="hljs-comment">// Optional, if provided by Algolia</span>
|
||||
<span class="hljs-attr">algoliaOptions</span>: {} <span class="hljs-comment">// Facultatif, si fourni par Algolia</span>
|
||||
},
|
||||
...
|
||||
...
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="extra-search-options"></a><a href="#extra-search-options" 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>Extra Search Options</h2>
|
||||
<p>You can also specify extra <a href="https://community.algolia.com/docsearch/documentation/">search options used by Algolia</a> by using an <code>algoliaOptions</code> field in <code>algolia</code>. This may be useful if you want to provide different search results for the different versions or languages of your docs. Any occurrences of "VERSION" or "LANGUAGE" will be replaced by the version or language of the current page, respectively. More details about search options can be <a href="https://www.algolia.com/doc/api-reference/api-parameters/#overview">found here</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="options-de-recherche-supplémentaires"></a><a href="#options-de-recherche-supplémentaires" 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>Options de recherche supplémentaires</h2>
|
||||
<p>Vous pouvez également spécifier des options de recherche supplémentaires <a href="https://community.algolia.com/docsearch/documentation/">utilisées par Algolia</a> en utilisant un champ <code>algoliaOptions</code> dans <code>algolia</code>. Cela peut être utile si vous voulez fournir des résultats de recherche différents pour les différentes versions ou langues de vos docs. Toutes les occurrences de "VERSION" ou "LANGUAGE" seront remplacées respectivement par la version ou la langue de la page courante. Plus de détails sur les options de recherche peuvent être <a href="https://www.algolia.com/doc/api-reference/api-parameters/#overview">trouvés ici</a>.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
|
|
@ -106,10 +106,10 @@
|
|||
},
|
||||
};
|
||||
</code></pre>
|
||||
<p>Algolia might provide you with <a href="https://community.algolia.com/docsearch/documentation/">extra search options</a>. If so, you should add them to the <code>algoliaOptions</code> object.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="controlling-the-location-of-the-search-bar"></a><a href="#controlling-the-location-of-the-search-bar" 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>Controlling the Location of the Search Bar</h2>
|
||||
<p>By default, the search bar will be the rightmost element in the top navigation bar.</p>
|
||||
<p>If you want to change the default location, add the <code>searchBar</code> flag in the <code>headerLinks</code> field of <code>siteConfig.js</code> in your desired location. For example, you may want the search bar between your internal and external links.</p>
|
||||
<p>Algolia peut vous fournir des <a href="https://community.algolia.com/docsearch/documentation/">options de recherche supplémentaires</a>. Si c'est le cas, vous devriez les ajouter à l'objet <code>algoliaOptions</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="contrôle-de-lemplacement-de-la-barre-de-recherche"></a><a href="#contrôle-de-lemplacement-de-la-barre-de-recherche" 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>Contrôle de l'emplacement de la barre de recherche</h2>
|
||||
<p>Par défaut, la barre de recherche sera l'élément le plus à droite de la barre de navigation supérieure.</p>
|
||||
<p>Si vous voulez changer l'emplacement par défaut, ajoutez l'option <code>searchBar</code> dans le champ <code>headerLinks</code> de <code>siteConfig.js</code> à l'emplacement souhaité. Par exemple, vous souhaitez peut-être que la barre de recherche se trouve entre vos liens internes et externes.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
headerLinks: [
|
||||
|
|
@ -122,20 +122,20 @@
|
|||
...
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-the-placeholder"></a><a href="#customizing-the-placeholder" 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>Customizing the placeholder</h2>
|
||||
<p>If you want to change the placeholder (which defaults to <em>Search</em>), add the <code>placeholder</code> field in your config. For example, you may want the search bar to display <em>Ask me something</em>:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-du-placeholder"></a><a href="#personnalisation-du-placeholder" 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 du placeholder</h2>
|
||||
<p>Si vous souhaitez modifier le placeholder (dont la valeur par défaut est <em>Search</em>), ajoutez le champ <code>placeholder</code> dans votre configuration. Par exemple, vous pouvez vouloir que la barre de recherche affiche <em>Demandez-moi quelque chose</em> :</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
...
|
||||
placeholder: <span class="hljs-string">'Ask me something'</span>
|
||||
placeholder: <span class="hljs-string">'Demandez-moi quelque chose'</span>
|
||||
},
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="disabling-the-search-bar"></a><a href="#disabling-the-search-bar" 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>Disabling the Search Bar</h2>
|
||||
<p>To disable the search bar, comment out (recommended) or delete the <code>algolia</code> section in the <code>siteConfig.js</code> file.</p>
|
||||
<p>Also, if you have customized the location of the search bar in <code>headerLinks</code>, set <code>search: false</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/custom-pages"><span class="arrow-prev">← </span><span>Pages personnalisées</span></a><a class="docs-next button" href="/docs/fr/1.10.x/navigation"><span>Navigation et Barre latérale</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#enabling-the-search-bar">Enabling the Search Bar</a></li><li><a href="#extra-search-options">Extra Search Options</a></li><li><a href="#controlling-the-location-of-the-search-bar">Controlling the Location of the Search Bar</a></li><li><a href="#customizing-the-placeholder">Customizing the placeholder</a></li><li><a href="#disabling-the-search-bar">Disabling the Search Bar</a></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="
|
||||
<h2><a class="anchor" aria-hidden="true" id="désactivation-de-la-barre-de-recherche"></a><a href="#désactivation-de-la-barre-de-recherche" 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>Désactivation de la barre de recherche</h2>
|
||||
<p>Pour désactiver la barre de recherche, commentez (recommandé) ou supprimez la section <code>algolia</code> dans le fichier <code>siteConfig.js</code>.</p>
|
||||
<p>Aussi, si vous avez personnalisé l'emplacement de la barre de recherche dans <code>headerLinks</code>, définissez <code>search: false</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/custom-pages"><span class="arrow-prev">← </span><span>Pages personnalisées</span></a><a class="docs-next button" href="/docs/fr/1.10.x/navigation"><span>Navigation et Barre latérale</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#activation-de-la-barre-de-recherche">Activation de la barre de recherche</a></li><li><a href="#options-de-recherche-supplémentaires">Options de recherche supplémentaires</a></li><li><a href="#contrôle-de-lemplacement-de-la-barre-de-recherche">Contrôle de l'emplacement de la barre de recherche</a></li><li><a href="#personnalisation-du-placeholder">Personnalisation du placeholder</a></li><li><a href="#désactivation-de-la-barre-de-recherche">Désactivation de la barre de recherche</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Enabling Search · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus supports search using [Algolia DocSearch](https://community.algolia.com/docsearch/). Once your website is online, you can [submit it to DocSearch](https://community.algolia.com/docsearch/). Algolia will then send you credentials you can add to your `siteConfig.js`."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Enabling Search · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus supports search using [Algolia DocSearch](https://community.algolia.com/docsearch/). Once your website is online, you can [submit it to DocSearch](https://community.algolia.com/docsearch/). Algolia will then send you credentials you can add to your `siteConfig.js`."/><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>Enabling Search · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus prend en charge la recherche en utilisant [Algolia DocSearch](https://community.algolia.com/docsearch/). Une fois que votre site est en ligne, vous pouvez [le soumettre à DocSearch](https://community.algolia.com/docsearch/). Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre `siteConfig.js`."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Enabling Search · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus prend en charge la recherche en utilisant [Algolia DocSearch](https://community.algolia.com/docsearch/). Une fois que votre site est en ligne, vous pouvez [le soumettre à DocSearch](https://community.algolia.com/docsearch/). Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre `siteConfig.js`."/><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,22 +80,22 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Enabling Search</h1></header><article><div><span><p>Docusaurus supports search using <a href="https://community.algolia.com/docsearch/">Algolia DocSearch</a>. Once your website is online, you can <a href="https://community.algolia.com/docsearch/">submit it to DocSearch</a>. Algolia will then send you credentials you can add to your <code>siteConfig.js</code>.</p>
|
||||
<p>DocSearch works by crawling the content of your website every 24 hours and putting all the content in an Algolia index. This content is then queried directly from your front-end using the Algolia API. Note that your website needs to be publicly available for this to work (ie. not behind a firewall). This service is free.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="enabling-the-search-bar"></a><a href="#enabling-the-search-bar" 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>Enabling the Search Bar</h2>
|
||||
<p>Enter your API key and index name (sent by Algolia) into <code>siteConfig.js</code> in the <code>algolia</code> section to enable search for your site.</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">Enabling Search</h1></header><article><div><span><p>Docusaurus prend en charge la recherche en utilisant <a href="https://community.algolia.com/docsearch/">Algolia DocSearch</a>. Une fois que votre site est en ligne, vous pouvez <a href="https://community.algolia.com/docsearch/">le soumettre à DocSearch</a>. Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre <code>siteConfig.js</code>.</p>
|
||||
<p>DocSearch travaille en explorant le contenu de votre site Web toutes les 24 heures et en mettant tout le contenu dans un index Algolia. Ce contenu est ensuite interrogé directement depuis votre front-end en utilisant l'API Algolia. Notez que votre site Web doit être accessible au public pour que cela fonctionne (par exemple pas derrière un pare-feu). Ce service est gratuit.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="activation-de-la-barre-de-recherche"></a><a href="#activation-de-la-barre-de-recherche" 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>Activation de la barre de recherche</h2>
|
||||
<p>Entrez votre clé API et le nom de l'index (envoyé par Algolia) dans <code>siteConfig.js</code> dans la section <code>algolia</code> pour activer la recherche de votre site.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
<span class="hljs-attr">apiKey</span>: <span class="hljs-string">'my-api-key'</span>,
|
||||
<span class="hljs-attr">indexName</span>: <span class="hljs-string">'my-index-name'</span>,
|
||||
<span class="hljs-attr">algoliaOptions</span>: {} <span class="hljs-comment">// Optional, if provided by Algolia</span>
|
||||
<span class="hljs-attr">algoliaOptions</span>: {} <span class="hljs-comment">// Facultatif, si fourni par Algolia</span>
|
||||
},
|
||||
...
|
||||
...
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="extra-search-options"></a><a href="#extra-search-options" 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>Extra Search Options</h2>
|
||||
<p>You can also specify extra <a href="https://community.algolia.com/docsearch/documentation/">search options used by Algolia</a> by using an <code>algoliaOptions</code> field in <code>algolia</code>. This may be useful if you want to provide different search results for the different versions or languages of your docs. Any occurrences of "VERSION" or "LANGUAGE" will be replaced by the version or language of the current page, respectively. More details about search options can be <a href="https://www.algolia.com/doc/api-reference/api-parameters/#overview">found here</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="options-de-recherche-supplémentaires"></a><a href="#options-de-recherche-supplémentaires" 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>Options de recherche supplémentaires</h2>
|
||||
<p>Vous pouvez également spécifier des options de recherche supplémentaires <a href="https://community.algolia.com/docsearch/documentation/">utilisées par Algolia</a> en utilisant un champ <code>algoliaOptions</code> dans <code>algolia</code>. Cela peut être utile si vous voulez fournir des résultats de recherche différents pour les différentes versions ou langues de vos docs. Toutes les occurrences de "VERSION" ou "LANGUAGE" seront remplacées respectivement par la version ou la langue de la page courante. Plus de détails sur les options de recherche peuvent être <a href="https://www.algolia.com/doc/api-reference/api-parameters/#overview">trouvés ici</a>.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
|
|
@ -106,10 +106,10 @@
|
|||
},
|
||||
};
|
||||
</code></pre>
|
||||
<p>Algolia might provide you with <a href="https://community.algolia.com/docsearch/documentation/">extra search options</a>. If so, you should add them to the <code>algoliaOptions</code> object.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="controlling-the-location-of-the-search-bar"></a><a href="#controlling-the-location-of-the-search-bar" 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>Controlling the Location of the Search Bar</h2>
|
||||
<p>By default, the search bar will be the rightmost element in the top navigation bar.</p>
|
||||
<p>If you want to change the default location, add the <code>searchBar</code> flag in the <code>headerLinks</code> field of <code>siteConfig.js</code> in your desired location. For example, you may want the search bar between your internal and external links.</p>
|
||||
<p>Algolia peut vous fournir des <a href="https://community.algolia.com/docsearch/documentation/">options de recherche supplémentaires</a>. Si c'est le cas, vous devriez les ajouter à l'objet <code>algoliaOptions</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="contrôle-de-lemplacement-de-la-barre-de-recherche"></a><a href="#contrôle-de-lemplacement-de-la-barre-de-recherche" 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>Contrôle de l'emplacement de la barre de recherche</h2>
|
||||
<p>Par défaut, la barre de recherche sera l'élément le plus à droite de la barre de navigation supérieure.</p>
|
||||
<p>Si vous voulez changer l'emplacement par défaut, ajoutez l'option <code>searchBar</code> dans le champ <code>headerLinks</code> de <code>siteConfig.js</code> à l'emplacement souhaité. Par exemple, vous souhaitez peut-être que la barre de recherche se trouve entre vos liens internes et externes.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
headerLinks: [
|
||||
|
|
@ -122,20 +122,20 @@
|
|||
...
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-the-placeholder"></a><a href="#customizing-the-placeholder" 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>Customizing the placeholder</h2>
|
||||
<p>If you want to change the placeholder (which defaults to <em>Search</em>), add the <code>placeholder</code> field in your config. For example, you may want the search bar to display <em>Ask me something</em>:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-du-placeholder"></a><a href="#personnalisation-du-placeholder" 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 du placeholder</h2>
|
||||
<p>Si vous souhaitez modifier le placeholder (dont la valeur par défaut est <em>Search</em>), ajoutez le champ <code>placeholder</code> dans votre configuration. Par exemple, vous pouvez vouloir que la barre de recherche affiche <em>Demandez-moi quelque chose</em> :</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
...
|
||||
placeholder: <span class="hljs-string">'Ask me something'</span>
|
||||
placeholder: <span class="hljs-string">'Demandez-moi quelque chose'</span>
|
||||
},
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="disabling-the-search-bar"></a><a href="#disabling-the-search-bar" 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>Disabling the Search Bar</h2>
|
||||
<p>To disable the search bar, comment out (recommended) or delete the <code>algolia</code> section in the <code>siteConfig.js</code> file.</p>
|
||||
<p>Also, if you have customized the location of the search bar in <code>headerLinks</code>, set <code>search: false</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/custom-pages"><span class="arrow-prev">← </span><span>Pages personnalisées</span></a><a class="docs-next button" href="/docs/fr/1.10.x/navigation"><span>Navigation et Barre latérale</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#enabling-the-search-bar">Enabling the Search Bar</a></li><li><a href="#extra-search-options">Extra Search Options</a></li><li><a href="#controlling-the-location-of-the-search-bar">Controlling the Location of the Search Bar</a></li><li><a href="#customizing-the-placeholder">Customizing the placeholder</a></li><li><a href="#disabling-the-search-bar">Disabling the Search Bar</a></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="
|
||||
<h2><a class="anchor" aria-hidden="true" id="désactivation-de-la-barre-de-recherche"></a><a href="#désactivation-de-la-barre-de-recherche" 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>Désactivation de la barre de recherche</h2>
|
||||
<p>Pour désactiver la barre de recherche, commentez (recommandé) ou supprimez la section <code>algolia</code> dans le fichier <code>siteConfig.js</code>.</p>
|
||||
<p>Aussi, si vous avez personnalisé l'emplacement de la barre de recherche dans <code>headerLinks</code>, définissez <code>search: false</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/custom-pages"><span class="arrow-prev">← </span><span>Pages personnalisées</span></a><a class="docs-next button" href="/docs/fr/1.10.x/navigation"><span>Navigation et Barre latérale</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#activation-de-la-barre-de-recherche">Activation de la barre de recherche</a></li><li><a href="#options-de-recherche-supplémentaires">Options de recherche supplémentaires</a></li><li><a href="#contrôle-de-lemplacement-de-la-barre-de-recherche">Contrôle de l'emplacement de la barre de recherche</a></li><li><a href="#personnalisation-du-placeholder">Personnalisation du placeholder</a></li><li><a href="#désactivation-de-la-barre-de-recherche">Désactivation de la barre de recherche</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -81,8 +81,8 @@
|
|||
}
|
||||
});
|
||||
</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">Translations & Localization</h1></header><article><div><span><p>Docusaurus propose une fonctionnalité de traduction facile en utilisant <a href="https://crowdin.com/">Crowdin</a>. Les fichiers de documentation écrits en anglais sont envoyés à Crowdin pour une traduction par les utilisateurs au sein d’une communauté. Les pages de haut niveau écrites avec des chaînes anglaises peuvent être traduites en enregistrant toutes les chaînes que vous souhaitez traduire dans une balise <code><translate></code> . D'autres titres et étiquettes seront également trouvés et correctement traduits.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="docusaurus-translation-configurations"></a><a href="#docusaurus-translation-configurations" 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>Docusaurus Translation Configurations</h2>
|
||||
<p>Pour générer des fichiers d'exemple pour les traductions avec Docusaurus, exécutez le script <code>exemples</code> avec l'argument de ligne de commande <code>traductions</code>:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="configurations-de-traduction-de-docusaurus"></a><a href="#configurations-de-traduction-de-docusaurus" 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>Configurations de traduction de Docusaurus</h2>
|
||||
<p>Pour générer des fichiers d'exemple pour les traductions avec Docusaurus, exécutez le script <code>examples</code> avec l'argument de la ligne de commande <code>translations</code> :</p>
|
||||
<pre><code class="hljs css language-bash">npm run examples translations
|
||||
</code></pre>
|
||||
<p>ou</p>
|
||||
|
|
@ -97,37 +97,37 @@ languages.js
|
|||
<li>Le fichier <code>pages/en/help-with-translations.js</code> inclut la même page d'aide de démarrage générée par le script <code>examples</code> mais inclut maintenant les balises de traduction.</li>
|
||||
</ul>
|
||||
<blockquote>
|
||||
<p>Généralement, vous utiliserez <code>help-with-translations.js</code> comme guide pour activer les traductions dans vos autres pages, mais vous ne livrerez pas réellement le fichier à votre repo (c'est-à-dire que vous pourrez le supprimer). Cependant, si vous voulez une page d'Aide, et que vous n'en avez pas, vous pouvez renommer ce fichier en <code>help.js</code> et l'utiliser comme point de départ.</p>
|
||||
<p>Généralement, vous utiliserez <code>help-with-translations.js</code> comme guide pour activer les traductions dans vos autres pages, mais vous ne livrerez pas réellement le fichier à votre dépôt (c'est-à-dire que vous pourrez le supprimer). Cependant, si vous voulez une page d'Aide, et que vous n'en avez pas, vous pouvez renommer ce fichier en <code>help.js</code> et l'utiliser comme point de départ.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li><p>Le fichier <code>languages.js</code> indique à Docusaurus quelles langues vous souhaitez activer pour votre site. Par défaut, nous attendons que l'anglais qu'il soit activé.</p></li>
|
||||
<li><p>Le fichier <code>crowdin.yaml</code> est utilisé pour configurer l'intégration de Crowdin et est copié à un niveau supérieur dans votre projet Docusaurus. Si votre projet Docusaurus réside dans <code>/project/website</code>, alors <code>crowdin.yaml</code> sera copié dans <code>/project/crowdin.yaml</code>.</p></li>
|
||||
<li><p>Le fichier <code>languages.js</code> indique à Docusaurus quelles langues vous souhaitez activer pour votre site. Par défaut, nous espérons que l'anglais sera activé.</p></li>
|
||||
<li><p>Le fichier <code>crowdin.yaml</code> est utilisé pour configurer l'intégration de Crowdin et est copié d'un niveau vers le haut dans le dépôt de votre projet Docusaurus. Si votre projet Docusaurus réside dans <code>/project/website</code>, alors <code>crowdin.yaml</code> sera copié dans <code>/project/crowdin.yaml</code>.</p></li>
|
||||
</ul>
|
||||
<h2><a class="anchor" aria-hidden="true" id="traduire-vos-docs-existantes"></a><a href="#traduire-vos-docs-existantes" 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>Traduire vos docs existantes</h2>
|
||||
<p>Vos fichiers de documentation (par exemple les fichiers <code>.md</code> qui vivent dans votre répertoire <code>docs</code>) ne doivent pas être modifiés ou déplacés pour supporter les traductions. Ils seront envoyés à Crowdin pour être traduits directement.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="activer-les-traductions-sur-les-pages"></a><a href="#activer-les-traductions-sur-les-pages" 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>Activer les traductions sur les pages</h2>
|
||||
<p>Les pages vous permettent de personnaliser la mise en page et le contenu spécifique des pages comme une page d'index personnalisée ou une page d'aide.</p>
|
||||
<p>Les pages avec du texte que vous souhaitez traduire doivent être placées dans le répertoire <code>site/pages/en</code> .</p>
|
||||
<p>Wrap strings you want translated in a <code><translate></code> tag, and add the following <code>require</code> statement to the top of the file:</p>
|
||||
<p>Enveloppez les chaînes de caractères que vous voulez traduire dans une balise <code><translate></code>, et ajoutez l'instruction suivante <code>require</code> en haut du fichier :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token operator">...</span>
|
||||
<span class="token keyword">const</span> translate <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'../../server/translate.js'</span><span class="token punctuation">)</span><span class="token punctuation">.</span>translate<span class="token punctuation">;</span>
|
||||
<span class="token operator">...</span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>h2</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span>This header will be translated<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span>Cette entête sera traduite<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>h2</span><span class="token punctuation">></span></span>
|
||||
<span class="token operator">...</span>
|
||||
</code></pre>
|
||||
<p>You can also include an optional description attribute to give more context to a translator about how to translate the string:</p>
|
||||
<p>Vous pouvez également inclure un attribut de description facultatif pour donner plus de contexte à un traducteur sur la façon de traduire la chaîne :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span> <span class="token attr-name">desc</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>flower, not verb<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>Rose<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>The <code><translate></code> tag generally works well on pure strings. If you have a string like "Docusaurus currently provides support to help your website use <a href="${siteConfig.baseUrl}${siteConfig.docsUrl}/${this.props.language}/translation.html">translations</a>", wrapping the <code><translation></code> tag around that entire string will cause issues because of the markdown linking, etc. Your options are to not translate those strings, or spread a bunch of <code><translate></code> tags amongst the pure substrings of that string.</p>
|
||||
<p>La balise <code><translate></code> fonctionne généralement bien sur des chaînes de caractères pures. Si vous avez une chaîne comme "Docusaurus fournit actuellement un support pour aider votre site à utiliser <a href="${siteConfig.baseUrl}${siteConfig.docsUrl}/${this.props.language}/translation.html">translations</a>", encapsuler la balise <code><translation></code> autour de cette chaîne entière causera des problèmes à cause du lien markdown, etc. Vos possibilités sont de ne pas traduire ces chaînes de caractères, ou de disséminer un tas de balises <code><translate></code> parmi les chaînes de caractères pures de cette chaîne.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="gathering-strings-to-translate"></a><a href="#gathering-strings-to-translate" 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>Gathering Strings to Translate</h2>
|
||||
<p>The strings within localized Pages must be extracted and provided to Crowdin.</p>
|
||||
<p>Add the following script to your <code>website/package.json</code> file, if it does not exist already:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="collecter-des-chaînes-à-traduire"></a><a href="#collecter-des-chaînes-à-traduire" 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>Collecter des chaînes à traduire</h2>
|
||||
<p>Les chaînes dans les pages à traduire doivent être extraites et fournies à Crowdin.</p>
|
||||
<p>Ajoutez le script suivant à votre fichier <code>website/package.json</code> s'il n'existe pas déjà :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
...
|
||||
<span class="hljs-string">"scripts"</span>: {
|
||||
|
|
@ -136,17 +136,17 @@ languages.js
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>Running the script will generate a <code>website/i18n/en.json</code> file containing all the strings that will be translated from English into other languages.</p>
|
||||
<p>The script will include text from the following places:</p>
|
||||
<p>L'exécution du script générera un fichier <code>website/i18n/fr.json</code> contenant toutes les chaînes qui seront traduites de l'anglais dans d'autres langues.</p>
|
||||
<p>Le script comprendra du texte provenant des endroits suivants :</p>
|
||||
<ul>
|
||||
<li><code>title</code> and <code>sidebar_label</code> strings in document markdown headers</li>
|
||||
<li>category names in <code>sidebars.json</code></li>
|
||||
<li>tagline in <code>siteConfig.js</code></li>
|
||||
<li>header link <code>label</code> strings in <code>siteConfig.js</code></li>
|
||||
<li>strings wrapped in the <code><translate></code> tag in any <code>.js</code> files inside <code>pages</code></li>
|
||||
<li>Les chaînes <code>title</code> et <code>sidebar_label</code> dans les entêtes du document markdown</li>
|
||||
<li>Les noms des catégories dans <code>sidebars.json</code></li>
|
||||
<li>tagline dans <code>siteConfig.js</code></li>
|
||||
<li>Les chaînes <code>label</code> de headerLinks dans <code>siteConfig.js</code></li>
|
||||
<li>Les chaînes enveloppées dans la balise <code><translate></code> dans tous les fichiers <code>.js</code> dans <code>pages</code></li>
|
||||
</ul>
|
||||
<h3><a class="anchor" aria-hidden="true" id="custom-translation-strings"></a><a href="#custom-translation-strings" 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>Custom Translation Strings</h3>
|
||||
<p>If you want to add additional custom translation strings or override any of the strings that get produced by the script that creates the <code>website/i18n/en.json</code> file, you can add a <code>website/data/custom-translation-strings.json</code> file. The file should have a form of:</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="chaînes-de-traduction-personnalisées"></a><a href="#chaînes-de-traduction-personnalisées" 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>Chaînes de traduction personnalisées</h3>
|
||||
<p>Si vous voulez ajouter des chaînes de traduction personnalisées supplémentaires ou remplacer l'une des chaînes qui sont produites par le script qui crée le fichier <code>website/i18n/en.json</code>, vous pouvez ajouter un fichier <code>website/data/custom-translation-strings.json</code> . Le fichier doit être sous la forme :</p>
|
||||
<pre><code class="hljs css language-json">{
|
||||
<span class="hljs-attr">"localized-strings"</span>: {
|
||||
<span class="hljs-attr">"docs"</span>: {
|
||||
|
|
@ -166,22 +166,22 @@ languages.js
|
|||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p>where <code>localized-strings</code> represent strings in your documentation content and <code>pages-strings</code> represents metadata in your documentation (e.g., title, links, etc).</p>
|
||||
<p>Here is an example:</p>
|
||||
<p>où <code>localized-strings</code> représentent des chaînes de caractères dans le contenu de votre documentation et <code>pages-strings</code> représente des métadonnées dans votre documentation (par exemple, titre, liens, etc.).</p>
|
||||
<p>Voici un exemple :</p>
|
||||
<pre><code class="hljs css language-json">{
|
||||
<span class="hljs-attr">"_comment"</span>: <span class="hljs-string">"This file is used to provide custom strings for translations, including overriding defaults"</span>,
|
||||
<span class="hljs-attr">"_comment"</span>: <span class="hljs-string">"Ce fichier est utilisé pour fournir des chaînes personnalisées pour les traductions, y compris en supportant les valeurs par défaut"</span>,
|
||||
<span class="hljs-attr">"localized-strings"</span>: {
|
||||
<span class="hljs-attr">"translation"</span>: <span class="hljs-string">"Translations and Localization"</span>
|
||||
<span class="hljs-attr">"traduction"</span>: <span class="hljs-string">"Traductions et localisation"</span>
|
||||
},
|
||||
<span class="hljs-attr">"pages-strings"</span>: {
|
||||
<span class="hljs-attr">"Help Translate|recruit community translators for your project"</span>: <span class="hljs-string">"Help Us Translate"</span>
|
||||
<span class="hljs-attr">"Aidez à traduire|recrutez des traducteurs de la communauté pour votre projet"</span>: <span class="hljs-string">"Aidez-nous à traduire"</span>
|
||||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p>See the generated <code>website/i18n/en.json</code> for an example.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-strings-get-translated"></a><a href="#how-strings-get-translated" 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>How Strings Get Translated</h2>
|
||||
<p>Docusaurus itself does not do any translation from one language to another. Instead, it integrates <a href="https://crowdin.com/">Crowdin</a> to upload translations and then downloads the appropriately translated files from Crowdin.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-docusaurus-uses-string-translations"></a><a href="#how-docusaurus-uses-string-translations" 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>How Docusaurus Uses String Translations</h2>
|
||||
<p>Voir le <code>website/i18n/en.json</code> généré pour exemple.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-les-chaînes-de-caractères-sont-traduites"></a><a href="#comment-les-chaînes-de-caractères-sont-traduites" 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>Comment les chaînes de caractères sont traduites</h2>
|
||||
<p>Docusaurus lui-même ne fait aucune traduction d'une langue à une autre. Au lieu de cela, il intègre <a href="https://crowdin.com/">Crowdin</a> pour télécharger les traductions et ensuite extraire les fichiers correctement traduits à partir de Crowdin.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères"></a><a href="#comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères" 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>Comment Docusaurus utilise les traductions de chaînes de caractères</h2>
|
||||
<p>This section provides context about how translations in Docusaurus works.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="strings"></a><a href="#strings" 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>Strings</h3>
|
||||
<p>A Docusaurus site has many strings used throughout it that require localization. However, maintaining a list of strings used throughout a site can be laborious. Docusaurus simplifies this by centralizing strings.</p>
|
||||
|
|
@ -304,7 +304,7 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
|
|||
<span class="hljs-attr">languages_mapping:</span> <span class="hljs-meta">*anchor</span>
|
||||
</code></pre>
|
||||
<p>Translated, versioned documents will be copied into <code>website/translated_docs/${language}/${version}/</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/navigation"><span class="arrow-prev">← </span><span>Navigation et Barre latérale</span></a><a class="docs-next button" href="/docs/fr/1.10.x/versioning"><span>Gestion de version</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#docusaurus-translation-configurations">Docusaurus Translation Configurations</a></li><li><a href="#traduire-vos-docs-existantes">Traduire vos docs existantes</a></li><li><a href="#activer-les-traductions-sur-les-pages">Activer les traductions sur les pages</a></li><li><a href="#gathering-strings-to-translate">Gathering Strings to Translate</a><ul class="toc-headings"><li><a href="#custom-translation-strings">Custom Translation Strings</a></li></ul></li><li><a href="#how-strings-get-translated">How Strings Get Translated</a></li><li><a href="#how-docusaurus-uses-string-translations">How Docusaurus Uses String Translations</a><ul class="toc-headings"><li><a href="#strings">Strings</a></li><li><a href="#markdown-files">Markdown Files</a></li><li><a href="#other-pages">Other Pages</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#setup-the-crowdin-scripts">Setup the Crowdin Scripts</a></li><li><a href="#manual-file-sync">Manual File Sync</a></li><li><a href="#automated-file-sync-using-circleci">Automated File Sync Using CircleCI</a></li></ul></li><li><a href="#versioned-translations">Versioned Translations</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/navigation"><span class="arrow-prev">← </span><span>Navigation et Barre latérale</span></a><a class="docs-next button" href="/docs/fr/1.10.x/versioning"><span>Gestion de version</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#configurations-de-traduction-de-docusaurus">Configurations de traduction de Docusaurus</a></li><li><a href="#traduire-vos-docs-existantes">Traduire vos docs existantes</a></li><li><a href="#activer-les-traductions-sur-les-pages">Activer les traductions sur les pages</a></li><li><a href="#collecter-des-chaînes-à-traduire">Collecter des chaînes à traduire</a><ul class="toc-headings"><li><a href="#chaînes-de-traduction-personnalisées">Chaînes de traduction personnalisées</a></li></ul></li><li><a href="#comment-les-chaînes-de-caractères-sont-traduites">Comment les chaînes de caractères sont traduites</a></li><li><a href="#comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères">Comment Docusaurus utilise les traductions de chaînes de caractères</a><ul class="toc-headings"><li><a href="#strings">Strings</a></li><li><a href="#markdown-files">Markdown Files</a></li><li><a href="#other-pages">Other Pages</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#setup-the-crowdin-scripts">Setup the Crowdin Scripts</a></li><li><a href="#manual-file-sync">Manual File Sync</a></li><li><a href="#automated-file-sync-using-circleci">Automated File Sync Using CircleCI</a></li></ul></li><li><a href="#versioned-translations">Versioned Translations</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -81,8 +81,8 @@
|
|||
}
|
||||
});
|
||||
</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">Translations & Localization</h1></header><article><div><span><p>Docusaurus propose une fonctionnalité de traduction facile en utilisant <a href="https://crowdin.com/">Crowdin</a>. Les fichiers de documentation écrits en anglais sont envoyés à Crowdin pour une traduction par les utilisateurs au sein d’une communauté. Les pages de haut niveau écrites avec des chaînes anglaises peuvent être traduites en enregistrant toutes les chaînes que vous souhaitez traduire dans une balise <code><translate></code> . D'autres titres et étiquettes seront également trouvés et correctement traduits.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="docusaurus-translation-configurations"></a><a href="#docusaurus-translation-configurations" 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>Docusaurus Translation Configurations</h2>
|
||||
<p>Pour générer des fichiers d'exemple pour les traductions avec Docusaurus, exécutez le script <code>exemples</code> avec l'argument de ligne de commande <code>traductions</code>:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="configurations-de-traduction-de-docusaurus"></a><a href="#configurations-de-traduction-de-docusaurus" 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>Configurations de traduction de Docusaurus</h2>
|
||||
<p>Pour générer des fichiers d'exemple pour les traductions avec Docusaurus, exécutez le script <code>examples</code> avec l'argument de la ligne de commande <code>translations</code> :</p>
|
||||
<pre><code class="hljs css language-bash">npm run examples translations
|
||||
</code></pre>
|
||||
<p>ou</p>
|
||||
|
|
@ -97,37 +97,37 @@ languages.js
|
|||
<li>Le fichier <code>pages/en/help-with-translations.js</code> inclut la même page d'aide de démarrage générée par le script <code>examples</code> mais inclut maintenant les balises de traduction.</li>
|
||||
</ul>
|
||||
<blockquote>
|
||||
<p>Généralement, vous utiliserez <code>help-with-translations.js</code> comme guide pour activer les traductions dans vos autres pages, mais vous ne livrerez pas réellement le fichier à votre repo (c'est-à-dire que vous pourrez le supprimer). Cependant, si vous voulez une page d'Aide, et que vous n'en avez pas, vous pouvez renommer ce fichier en <code>help.js</code> et l'utiliser comme point de départ.</p>
|
||||
<p>Généralement, vous utiliserez <code>help-with-translations.js</code> comme guide pour activer les traductions dans vos autres pages, mais vous ne livrerez pas réellement le fichier à votre dépôt (c'est-à-dire que vous pourrez le supprimer). Cependant, si vous voulez une page d'Aide, et que vous n'en avez pas, vous pouvez renommer ce fichier en <code>help.js</code> et l'utiliser comme point de départ.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li><p>Le fichier <code>languages.js</code> indique à Docusaurus quelles langues vous souhaitez activer pour votre site. Par défaut, nous attendons que l'anglais qu'il soit activé.</p></li>
|
||||
<li><p>Le fichier <code>crowdin.yaml</code> est utilisé pour configurer l'intégration de Crowdin et est copié à un niveau supérieur dans votre projet Docusaurus. Si votre projet Docusaurus réside dans <code>/project/website</code>, alors <code>crowdin.yaml</code> sera copié dans <code>/project/crowdin.yaml</code>.</p></li>
|
||||
<li><p>Le fichier <code>languages.js</code> indique à Docusaurus quelles langues vous souhaitez activer pour votre site. Par défaut, nous espérons que l'anglais sera activé.</p></li>
|
||||
<li><p>Le fichier <code>crowdin.yaml</code> est utilisé pour configurer l'intégration de Crowdin et est copié d'un niveau vers le haut dans le dépôt de votre projet Docusaurus. Si votre projet Docusaurus réside dans <code>/project/website</code>, alors <code>crowdin.yaml</code> sera copié dans <code>/project/crowdin.yaml</code>.</p></li>
|
||||
</ul>
|
||||
<h2><a class="anchor" aria-hidden="true" id="traduire-vos-docs-existantes"></a><a href="#traduire-vos-docs-existantes" 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>Traduire vos docs existantes</h2>
|
||||
<p>Vos fichiers de documentation (par exemple les fichiers <code>.md</code> qui vivent dans votre répertoire <code>docs</code>) ne doivent pas être modifiés ou déplacés pour supporter les traductions. Ils seront envoyés à Crowdin pour être traduits directement.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="activer-les-traductions-sur-les-pages"></a><a href="#activer-les-traductions-sur-les-pages" 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>Activer les traductions sur les pages</h2>
|
||||
<p>Les pages vous permettent de personnaliser la mise en page et le contenu spécifique des pages comme une page d'index personnalisée ou une page d'aide.</p>
|
||||
<p>Les pages avec du texte que vous souhaitez traduire doivent être placées dans le répertoire <code>site/pages/en</code> .</p>
|
||||
<p>Wrap strings you want translated in a <code><translate></code> tag, and add the following <code>require</code> statement to the top of the file:</p>
|
||||
<p>Enveloppez les chaînes de caractères que vous voulez traduire dans une balise <code><translate></code>, et ajoutez l'instruction suivante <code>require</code> en haut du fichier :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token operator">...</span>
|
||||
<span class="token keyword">const</span> translate <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'../../server/translate.js'</span><span class="token punctuation">)</span><span class="token punctuation">.</span>translate<span class="token punctuation">;</span>
|
||||
<span class="token operator">...</span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>h2</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span>This header will be translated<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span>Cette entête sera traduite<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>h2</span><span class="token punctuation">></span></span>
|
||||
<span class="token operator">...</span>
|
||||
</code></pre>
|
||||
<p>You can also include an optional description attribute to give more context to a translator about how to translate the string:</p>
|
||||
<p>Vous pouvez également inclure un attribut de description facultatif pour donner plus de contexte à un traducteur sur la façon de traduire la chaîne :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span> <span class="token attr-name">desc</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>flower, not verb<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>Rose<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>The <code><translate></code> tag generally works well on pure strings. If you have a string like "Docusaurus currently provides support to help your website use <a href="${siteConfig.baseUrl}${siteConfig.docsUrl}/${this.props.language}/translation.html">translations</a>", wrapping the <code><translation></code> tag around that entire string will cause issues because of the markdown linking, etc. Your options are to not translate those strings, or spread a bunch of <code><translate></code> tags amongst the pure substrings of that string.</p>
|
||||
<p>La balise <code><translate></code> fonctionne généralement bien sur des chaînes de caractères pures. Si vous avez une chaîne comme "Docusaurus fournit actuellement un support pour aider votre site à utiliser <a href="${siteConfig.baseUrl}${siteConfig.docsUrl}/${this.props.language}/translation.html">translations</a>", encapsuler la balise <code><translation></code> autour de cette chaîne entière causera des problèmes à cause du lien markdown, etc. Vos possibilités sont de ne pas traduire ces chaînes de caractères, ou de disséminer un tas de balises <code><translate></code> parmi les chaînes de caractères pures de cette chaîne.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="gathering-strings-to-translate"></a><a href="#gathering-strings-to-translate" 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>Gathering Strings to Translate</h2>
|
||||
<p>The strings within localized Pages must be extracted and provided to Crowdin.</p>
|
||||
<p>Add the following script to your <code>website/package.json</code> file, if it does not exist already:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="collecter-des-chaînes-à-traduire"></a><a href="#collecter-des-chaînes-à-traduire" 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>Collecter des chaînes à traduire</h2>
|
||||
<p>Les chaînes dans les pages à traduire doivent être extraites et fournies à Crowdin.</p>
|
||||
<p>Ajoutez le script suivant à votre fichier <code>website/package.json</code> s'il n'existe pas déjà :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
...
|
||||
<span class="hljs-string">"scripts"</span>: {
|
||||
|
|
@ -136,17 +136,17 @@ languages.js
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>Running the script will generate a <code>website/i18n/en.json</code> file containing all the strings that will be translated from English into other languages.</p>
|
||||
<p>The script will include text from the following places:</p>
|
||||
<p>L'exécution du script générera un fichier <code>website/i18n/fr.json</code> contenant toutes les chaînes qui seront traduites de l'anglais dans d'autres langues.</p>
|
||||
<p>Le script comprendra du texte provenant des endroits suivants :</p>
|
||||
<ul>
|
||||
<li><code>title</code> and <code>sidebar_label</code> strings in document markdown headers</li>
|
||||
<li>category names in <code>sidebars.json</code></li>
|
||||
<li>tagline in <code>siteConfig.js</code></li>
|
||||
<li>header link <code>label</code> strings in <code>siteConfig.js</code></li>
|
||||
<li>strings wrapped in the <code><translate></code> tag in any <code>.js</code> files inside <code>pages</code></li>
|
||||
<li>Les chaînes <code>title</code> et <code>sidebar_label</code> dans les entêtes du document markdown</li>
|
||||
<li>Les noms des catégories dans <code>sidebars.json</code></li>
|
||||
<li>tagline dans <code>siteConfig.js</code></li>
|
||||
<li>Les chaînes <code>label</code> de headerLinks dans <code>siteConfig.js</code></li>
|
||||
<li>Les chaînes enveloppées dans la balise <code><translate></code> dans tous les fichiers <code>.js</code> dans <code>pages</code></li>
|
||||
</ul>
|
||||
<h3><a class="anchor" aria-hidden="true" id="custom-translation-strings"></a><a href="#custom-translation-strings" 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>Custom Translation Strings</h3>
|
||||
<p>If you want to add additional custom translation strings or override any of the strings that get produced by the script that creates the <code>website/i18n/en.json</code> file, you can add a <code>website/data/custom-translation-strings.json</code> file. The file should have a form of:</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="chaînes-de-traduction-personnalisées"></a><a href="#chaînes-de-traduction-personnalisées" 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>Chaînes de traduction personnalisées</h3>
|
||||
<p>Si vous voulez ajouter des chaînes de traduction personnalisées supplémentaires ou remplacer l'une des chaînes qui sont produites par le script qui crée le fichier <code>website/i18n/en.json</code>, vous pouvez ajouter un fichier <code>website/data/custom-translation-strings.json</code> . Le fichier doit être sous la forme :</p>
|
||||
<pre><code class="hljs css language-json">{
|
||||
<span class="hljs-attr">"localized-strings"</span>: {
|
||||
<span class="hljs-attr">"docs"</span>: {
|
||||
|
|
@ -166,22 +166,22 @@ languages.js
|
|||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p>where <code>localized-strings</code> represent strings in your documentation content and <code>pages-strings</code> represents metadata in your documentation (e.g., title, links, etc).</p>
|
||||
<p>Here is an example:</p>
|
||||
<p>où <code>localized-strings</code> représentent des chaînes de caractères dans le contenu de votre documentation et <code>pages-strings</code> représente des métadonnées dans votre documentation (par exemple, titre, liens, etc.).</p>
|
||||
<p>Voici un exemple :</p>
|
||||
<pre><code class="hljs css language-json">{
|
||||
<span class="hljs-attr">"_comment"</span>: <span class="hljs-string">"This file is used to provide custom strings for translations, including overriding defaults"</span>,
|
||||
<span class="hljs-attr">"_comment"</span>: <span class="hljs-string">"Ce fichier est utilisé pour fournir des chaînes personnalisées pour les traductions, y compris en supportant les valeurs par défaut"</span>,
|
||||
<span class="hljs-attr">"localized-strings"</span>: {
|
||||
<span class="hljs-attr">"translation"</span>: <span class="hljs-string">"Translations and Localization"</span>
|
||||
<span class="hljs-attr">"traduction"</span>: <span class="hljs-string">"Traductions et localisation"</span>
|
||||
},
|
||||
<span class="hljs-attr">"pages-strings"</span>: {
|
||||
<span class="hljs-attr">"Help Translate|recruit community translators for your project"</span>: <span class="hljs-string">"Help Us Translate"</span>
|
||||
<span class="hljs-attr">"Aidez à traduire|recrutez des traducteurs de la communauté pour votre projet"</span>: <span class="hljs-string">"Aidez-nous à traduire"</span>
|
||||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p>See the generated <code>website/i18n/en.json</code> for an example.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-strings-get-translated"></a><a href="#how-strings-get-translated" 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>How Strings Get Translated</h2>
|
||||
<p>Docusaurus itself does not do any translation from one language to another. Instead, it integrates <a href="https://crowdin.com/">Crowdin</a> to upload translations and then downloads the appropriately translated files from Crowdin.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-docusaurus-uses-string-translations"></a><a href="#how-docusaurus-uses-string-translations" 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>How Docusaurus Uses String Translations</h2>
|
||||
<p>Voir le <code>website/i18n/en.json</code> généré pour exemple.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-les-chaînes-de-caractères-sont-traduites"></a><a href="#comment-les-chaînes-de-caractères-sont-traduites" 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>Comment les chaînes de caractères sont traduites</h2>
|
||||
<p>Docusaurus lui-même ne fait aucune traduction d'une langue à une autre. Au lieu de cela, il intègre <a href="https://crowdin.com/">Crowdin</a> pour télécharger les traductions et ensuite extraire les fichiers correctement traduits à partir de Crowdin.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères"></a><a href="#comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères" 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>Comment Docusaurus utilise les traductions de chaînes de caractères</h2>
|
||||
<p>This section provides context about how translations in Docusaurus works.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="strings"></a><a href="#strings" 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>Strings</h3>
|
||||
<p>A Docusaurus site has many strings used throughout it that require localization. However, maintaining a list of strings used throughout a site can be laborious. Docusaurus simplifies this by centralizing strings.</p>
|
||||
|
|
@ -304,7 +304,7 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
|
|||
<span class="hljs-attr">languages_mapping:</span> <span class="hljs-meta">*anchor</span>
|
||||
</code></pre>
|
||||
<p>Translated, versioned documents will be copied into <code>website/translated_docs/${language}/${version}/</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/navigation"><span class="arrow-prev">← </span><span>Navigation et Barre latérale</span></a><a class="docs-next button" href="/docs/fr/1.10.x/versioning"><span>Gestion de version</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#docusaurus-translation-configurations">Docusaurus Translation Configurations</a></li><li><a href="#traduire-vos-docs-existantes">Traduire vos docs existantes</a></li><li><a href="#activer-les-traductions-sur-les-pages">Activer les traductions sur les pages</a></li><li><a href="#gathering-strings-to-translate">Gathering Strings to Translate</a><ul class="toc-headings"><li><a href="#custom-translation-strings">Custom Translation Strings</a></li></ul></li><li><a href="#how-strings-get-translated">How Strings Get Translated</a></li><li><a href="#how-docusaurus-uses-string-translations">How Docusaurus Uses String Translations</a><ul class="toc-headings"><li><a href="#strings">Strings</a></li><li><a href="#markdown-files">Markdown Files</a></li><li><a href="#other-pages">Other Pages</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#setup-the-crowdin-scripts">Setup the Crowdin Scripts</a></li><li><a href="#manual-file-sync">Manual File Sync</a></li><li><a href="#automated-file-sync-using-circleci">Automated File Sync Using CircleCI</a></li></ul></li><li><a href="#versioned-translations">Versioned Translations</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/navigation"><span class="arrow-prev">← </span><span>Navigation et Barre latérale</span></a><a class="docs-next button" href="/docs/fr/1.10.x/versioning"><span>Gestion de version</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#configurations-de-traduction-de-docusaurus">Configurations de traduction de Docusaurus</a></li><li><a href="#traduire-vos-docs-existantes">Traduire vos docs existantes</a></li><li><a href="#activer-les-traductions-sur-les-pages">Activer les traductions sur les pages</a></li><li><a href="#collecter-des-chaînes-à-traduire">Collecter des chaînes à traduire</a><ul class="toc-headings"><li><a href="#chaînes-de-traduction-personnalisées">Chaînes de traduction personnalisées</a></li></ul></li><li><a href="#comment-les-chaînes-de-caractères-sont-traduites">Comment les chaînes de caractères sont traduites</a></li><li><a href="#comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères">Comment Docusaurus utilise les traductions de chaînes de caractères</a><ul class="toc-headings"><li><a href="#strings">Strings</a></li><li><a href="#markdown-files">Markdown Files</a></li><li><a href="#other-pages">Other Pages</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#setup-the-crowdin-scripts">Setup the Crowdin Scripts</a></li><li><a href="#manual-file-sync">Manual File Sync</a></li><li><a href="#automated-file-sync-using-circleci">Automated File Sync Using CircleCI</a></li></ul></li><li><a href="#versioned-translations">Versioned Translations</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Create a New Site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create a New Site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes."/><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>Create a New Site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create a New Site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes."/><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,18 +80,18 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Create a New Site</h1></header><article><div><span><p>In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes.</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">Create a New Site</h1></header><article><div><span><p>Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes.</p>
|
||||
<p><img src="/img/undraw_docusaurus_browser.svg" alt="Docusaurus browser"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="scaffold-the-site"></a><a href="#scaffold-the-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>Scaffold the Site</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="conception-du-site"></a><a href="#conception-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>Conception du site</h2>
|
||||
<ol>
|
||||
<li>Execute the <code>docusaurus-init</code> command in your terminal.</li>
|
||||
<li>Exécutez la commande <code>docusaurus-init</code> dans votre terminal.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">docusaurus-init
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>The <code>Linking dependencies...</code> step might take a while, but it will finish eventually.</p>
|
||||
<p>L'étape <code>Lier les dépendances... (Linking dependencies...)</code> peut prendre un certain temps, mais elle finira par se terminer.</p>
|
||||
</blockquote>
|
||||
<p>The following contents will be created in your current directory. Some example documentation pages (under <code>docs</code>) and blog posts (under <code>website/blog</code>) are included.</p>
|
||||
<p>Le contenu suivant sera créé dans votre répertoire courant. Quelques exemples de pages de documentation (sous <code>docs</code>) et des articles de blog (sous <code>website/blog</code>) sont inclus.</p>
|
||||
<pre><code class="hljs css language-sh">├── Dockerfile
|
||||
├── docker-compose.yml
|
||||
├── docs
|
||||
|
|
@ -130,12 +130,12 @@
|
|||
└── yarn.lock
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
<li>Run <code>cd website</code> to go into the <code>website</code> directory.</li>
|
||||
<li>Run <code>npm start</code> or <code>yarn start</code>.</li>
|
||||
<li>Exécutez <code>cd website</code> pour aller dans le répertoire <code>website</code>.</li>
|
||||
<li>Exécutez <code>npm start</code> ou <code>yarn start</code>.</li>
|
||||
</ol>
|
||||
<p>A browser window will open up at <a href="http://localhost:3000">http://localhost:3000</a>.</p>
|
||||
<p>Congratulations, you have just made your first Docusaurus site! Click around the pages to get a feel for it.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-setup"><span class="arrow-prev">← </span><span>Paramétrage</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-create-pages"><span>Créer des pages</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#scaffold-the-site">Scaffold the Site</a></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="
|
||||
<p>Une fenêtre de navigateur s'ouvrira à l'adresse <a href="http://localhost:3000">http://localhost:3000</a>.</p>
|
||||
<p>Félicitations, vous venez de faire votre premier site Docusaurus ! Cliquez sur les pages pour vous faire une idée.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-setup"><span class="arrow-prev">← </span><span>Paramétrage</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-create-pages"><span>Créer des pages</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#conception-du-site">Conception du site</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Create a New Site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create a New Site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes."/><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>Create a New Site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create a New Site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes."/><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,18 +80,18 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Create a New Site</h1></header><article><div><span><p>In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes.</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">Create a New Site</h1></header><article><div><span><p>Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes.</p>
|
||||
<p><img src="/img/undraw_docusaurus_browser.svg" alt="Docusaurus browser"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="scaffold-the-site"></a><a href="#scaffold-the-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>Scaffold the Site</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="conception-du-site"></a><a href="#conception-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>Conception du site</h2>
|
||||
<ol>
|
||||
<li>Execute the <code>docusaurus-init</code> command in your terminal.</li>
|
||||
<li>Exécutez la commande <code>docusaurus-init</code> dans votre terminal.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">docusaurus-init
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>The <code>Linking dependencies...</code> step might take a while, but it will finish eventually.</p>
|
||||
<p>L'étape <code>Lier les dépendances... (Linking dependencies...)</code> peut prendre un certain temps, mais elle finira par se terminer.</p>
|
||||
</blockquote>
|
||||
<p>The following contents will be created in your current directory. Some example documentation pages (under <code>docs</code>) and blog posts (under <code>website/blog</code>) are included.</p>
|
||||
<p>Le contenu suivant sera créé dans votre répertoire courant. Quelques exemples de pages de documentation (sous <code>docs</code>) et des articles de blog (sous <code>website/blog</code>) sont inclus.</p>
|
||||
<pre><code class="hljs css language-sh">├── Dockerfile
|
||||
├── docker-compose.yml
|
||||
├── docs
|
||||
|
|
@ -130,12 +130,12 @@
|
|||
└── yarn.lock
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
<li>Run <code>cd website</code> to go into the <code>website</code> directory.</li>
|
||||
<li>Run <code>npm start</code> or <code>yarn start</code>.</li>
|
||||
<li>Exécutez <code>cd website</code> pour aller dans le répertoire <code>website</code>.</li>
|
||||
<li>Exécutez <code>npm start</code> ou <code>yarn start</code>.</li>
|
||||
</ol>
|
||||
<p>A browser window will open up at <a href="http://localhost:3000">http://localhost:3000</a>.</p>
|
||||
<p>Congratulations, you have just made your first Docusaurus site! Click around the pages to get a feel for it.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-setup"><span class="arrow-prev">← </span><span>Paramétrage</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-create-pages"><span>Créer des pages</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#scaffold-the-site">Scaffold the Site</a></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="
|
||||
<p>Une fenêtre de navigateur s'ouvrira à l'adresse <a href="http://localhost:3000">http://localhost:3000</a>.</p>
|
||||
<p>Félicitations, vous venez de faire votre premier site Docusaurus ! Cliquez sur les pages pour vous faire une idée.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-setup"><span class="arrow-prev">← </span><span>Paramétrage</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-create-pages"><span>Créer des pages</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#conception-du-site">Conception du site</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Create Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page."/><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>Create Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation."/><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,11 +80,11 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Create Pages</h1></header><article><div><span><p>In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page.</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">Create Pages</h1></header><article><div><span><p>Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation.</p>
|
||||
<p><img src="/img/undraw_docusaurus_tree.svg" alt="Docusaurus MacBook"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="creating-a-regular-page"></a><a href="#creating-a-regular-page" 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>Creating a Regular Page</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dune-page-ordinaire"></a><a href="#création-dune-page-ordinaire" 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'une page ordinaire</h2>
|
||||
<ol>
|
||||
<li><p>Go into the <code>pages/en</code> directory and create a file called <code>hello-world.js</code> with the following contents:</p>
|
||||
<li><p>Allez dans le répertoire <code>pages/en</code> et créez un fichier appelé <code>hello-world.js</code> avec le contenu suivant :</p>
|
||||
<p>const React = require('react');</p>
|
||||
<p>const CompLibrary = require('../../core/CompLibrary.js');</p>
|
||||
<p>const Container = CompLibrary.Container;
|
||||
|
|
@ -94,7 +94,7 @@ return (
|
|||
<div className="docMainWrapper wrapper">
|
||||
<Container className="mainContainer documentContainer postContainer">
|
||||
<h1>Hello World!</h1>
|
||||
<p>This is my first page!</p>
|
||||
<p>C'est ma première page !</p>
|
||||
</Container>
|
||||
</div>
|
||||
);
|
||||
|
|
@ -102,37 +102,37 @@ return (
|
|||
<p>module.exports = HelloWorld;</p></li>
|
||||
</ol>
|
||||
<ol start="2">
|
||||
<li>Go to <a href="http://localhost:3000/hello-world">http://localhost:3000/hello-world</a> and you should be able to see the new page.</li>
|
||||
<li>Change the text within the <code><p>...</p></code> to "I can write JSX here!". The browser should refresh automatically to reflect the changes.</li>
|
||||
<li>Allez à l'adresse <a href="http://localhost:3000/hello-world">http://localhost:3000/hello-world</a> et vous devriez pouvoir voir la nouvelle page.</li>
|
||||
<li>Changez le texte dans le <code><p>...</p></code> en "Je peux écrire du JSX ici !". Le navigateur devrait se rafraîchir automatiquement pour faire apparaître les changements.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-deletion">- <p>This is my first page!</p></span>
|
||||
<span class="hljs-addition">+ <p>I can write JSX here!</p></span>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-deletion">- <p>C'est ma première page !</p></span>
|
||||
<span class="hljs-addition">+ <p>Je peux écrire du JSX ici !</p></span>
|
||||
</code></pre>
|
||||
<p>React is being used as a templating engine for rendering static markup. You can leverage on the expressibility of React to build rich web content. Learn more about creating pages <a href="custom-pages">here</a>.</p>
|
||||
<p>React est utilisé comme moteur de template pour le rendu du balisage statique. Vous pouvez tirer parti de la puissance d'expression de React pour créer du contenu web riche. Apprenez en plus sur la création de pages <a href="custom-pages">ici</a>.</p>
|
||||
<p><img src="/img/undraw_docusaurus_react.svg" alt="Docusaurus React"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="create-a-documentation-page"></a><a href="#create-a-documentation-page" 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>Create a Documentation Page</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dune-page-de-documentation"></a><a href="#création-dune-page-de-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>Création d'une page de documentation</h2>
|
||||
<ol>
|
||||
<li><p>Create a new file in the <code>docs</code> folder called <code>doc4.md</code>. The <code>docs</code> folder is in the root of your Docusaurus project, one level above <code>website</code>.</p></li>
|
||||
<li><p>Paste the following contents:</p>
|
||||
<li><p>Créer un nouveau fichier dans le dossier <code>docs</code> appelé <code>doc4.md</code>. Le dossier <code>docs</code> est à la racine de votre projet Docusaurus, un niveau au-dessus de <code>website</code>.</p></li>
|
||||
<li><p>Collez le contenu suivant :</p>
|
||||
<hr>
|
||||
<p>id: doc4
|
||||
title: This is Doc 4</p>
|
||||
title: Il s'agit du Doc 4</p>
|
||||
<hr>
|
||||
<p>I can write content using <a href="https://github.github.com/gfm/">GitHub-flavored Markdown syntax</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="markdown-syntax"></a><a href="#markdown-syntax" 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>Markdown Syntax</h2>
|
||||
<p><strong>Bold</strong> <em>italic</em> <code>code</code> <a href="#url">Links</a></p>
|
||||
<p>Je peux écrire du contenu en utilisant la <a href="https://github.github.com/gfm/">syntaxe de Markdown flavored GitHub</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="syntaxe-de-markdown"></a><a href="#syntaxe-de-markdown" 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>Syntaxe de Markdown</h2>
|
||||
<p><strong>Gras</strong> <em>italique</em> <code>code</code> <a href="#url">Liens</a></p>
|
||||
<blockquote>
|
||||
<p>Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
|
||||
id sem consectetuer libero luctus adipiscing.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li>Hey</li>
|
||||
<li>Salut</li>
|
||||
<li>Ho</li>
|
||||
<li>Let's Go</li>
|
||||
<li>Allons-y</li>
|
||||
</ul></li>
|
||||
</ol>
|
||||
<ol start="3">
|
||||
<li>The <code>sidebars.json</code> is where you specify the order of your documentation pages, so open <code>website/sidebars.json</code> and add <code>"doc4"</code> after <code>"doc1"</code>. This ID should be the same one as in the metadata for the Markdown file above, so if you gave a different ID in Step 2, just make sure to use the same ID in the sidebar file.</li>
|
||||
<li>Le <code>sidebars.json</code> est l'endroit où vous spécifiez l'ordre de vos pages de documentation, alors ouvrez <code>website/sidebars.json</code> et ajoutez <code>"doc4"</code> après <code>"doc1"</code>. Cet ID doit être le même que dans les métadonnées du fichier Markdown ci-dessus, donc si vous avez donné un ID différent à l'étape 2, assurez-vous d'utiliser le même ID dans le fichier de la barre latérale.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-diff">{
|
||||
"docs": {
|
||||
|
|
@ -149,12 +149,12 @@ id sem consectetuer libero luctus adipiscing.</p>
|
|||
}
|
||||
</code></pre>
|
||||
<ol start="4">
|
||||
<li>A server restart is needed to pick up sidebar changes, so kill your dev server (<kbd>Cmd</kbd> + <kbd>C</kbd> or <kbd>Ctrl</kbd> + <kbd>C</kbd>) and restart it with <code>npm run start</code>.</li>
|
||||
<li>Navigate to <a href="http://localhost:3000/docs/doc4">http://localhost:3000/docs/doc4</a>.</li>
|
||||
<li>Un redémarrage du serveur est nécessaire pour récupérer les modifications de la barre latérale, alors tuez votre serveur de développement (<kbd>Cmd</kbd> + <kbd>C</kbd> ou <kbd>Ctrl</kbd> + <kbd>C</kbd>) et redémarrez-le avec <code>npm run start</code>.</li>
|
||||
<li>Naviguez vers l'adresse <a href="http://localhost:3000/docs/doc4">http://localhost:3000/docs/doc4</a>.</li>
|
||||
</ol>
|
||||
<p>You've created your first documentation page on Docusaurus!</p>
|
||||
<p>Learn more about creating docs pages <a href="navigation">here</a>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-create-new-site"><span class="arrow-prev">← </span><span>Créer un nouveau site</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-publish-site"><span>Publier le site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#creating-a-regular-page">Creating a Regular Page</a></li><li><a href="#create-a-documentation-page">Create a Documentation Page</a></li><li><a href="#markdown-syntax">Markdown Syntax</a></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="
|
||||
<p>Vous avez créé votre première page de documentation sur Docusaurus !</p>
|
||||
<p>Apprenez en plus sur la création de page de documentation <a href="navigation">ici</a>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-create-new-site"><span class="arrow-prev">← </span><span>Créer un nouveau site</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-publish-site"><span>Publier le site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#création-dune-page-ordinaire">Création d'une page ordinaire</a></li><li><a href="#création-dune-page-de-documentation">Création d'une page de documentation</a></li><li><a href="#syntaxe-de-markdown">Syntaxe de Markdown</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Create Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page."/><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>Create Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation."/><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,11 +80,11 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Create Pages</h1></header><article><div><span><p>In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page.</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">Create Pages</h1></header><article><div><span><p>Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation.</p>
|
||||
<p><img src="/img/undraw_docusaurus_tree.svg" alt="Docusaurus MacBook"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="creating-a-regular-page"></a><a href="#creating-a-regular-page" 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>Creating a Regular Page</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dune-page-ordinaire"></a><a href="#création-dune-page-ordinaire" 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'une page ordinaire</h2>
|
||||
<ol>
|
||||
<li><p>Go into the <code>pages/en</code> directory and create a file called <code>hello-world.js</code> with the following contents:</p>
|
||||
<li><p>Allez dans le répertoire <code>pages/en</code> et créez un fichier appelé <code>hello-world.js</code> avec le contenu suivant :</p>
|
||||
<p>const React = require('react');</p>
|
||||
<p>const CompLibrary = require('../../core/CompLibrary.js');</p>
|
||||
<p>const Container = CompLibrary.Container;
|
||||
|
|
@ -94,7 +94,7 @@ return (
|
|||
<div className="docMainWrapper wrapper">
|
||||
<Container className="mainContainer documentContainer postContainer">
|
||||
<h1>Hello World!</h1>
|
||||
<p>This is my first page!</p>
|
||||
<p>C'est ma première page !</p>
|
||||
</Container>
|
||||
</div>
|
||||
);
|
||||
|
|
@ -102,37 +102,37 @@ return (
|
|||
<p>module.exports = HelloWorld;</p></li>
|
||||
</ol>
|
||||
<ol start="2">
|
||||
<li>Go to <a href="http://localhost:3000/hello-world">http://localhost:3000/hello-world</a> and you should be able to see the new page.</li>
|
||||
<li>Change the text within the <code><p>...</p></code> to "I can write JSX here!". The browser should refresh automatically to reflect the changes.</li>
|
||||
<li>Allez à l'adresse <a href="http://localhost:3000/hello-world">http://localhost:3000/hello-world</a> et vous devriez pouvoir voir la nouvelle page.</li>
|
||||
<li>Changez le texte dans le <code><p>...</p></code> en "Je peux écrire du JSX ici !". Le navigateur devrait se rafraîchir automatiquement pour faire apparaître les changements.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-deletion">- <p>This is my first page!</p></span>
|
||||
<span class="hljs-addition">+ <p>I can write JSX here!</p></span>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-deletion">- <p>C'est ma première page !</p></span>
|
||||
<span class="hljs-addition">+ <p>Je peux écrire du JSX ici !</p></span>
|
||||
</code></pre>
|
||||
<p>React is being used as a templating engine for rendering static markup. You can leverage on the expressibility of React to build rich web content. Learn more about creating pages <a href="custom-pages">here</a>.</p>
|
||||
<p>React est utilisé comme moteur de template pour le rendu du balisage statique. Vous pouvez tirer parti de la puissance d'expression de React pour créer du contenu web riche. Apprenez en plus sur la création de pages <a href="custom-pages">ici</a>.</p>
|
||||
<p><img src="/img/undraw_docusaurus_react.svg" alt="Docusaurus React"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="create-a-documentation-page"></a><a href="#create-a-documentation-page" 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>Create a Documentation Page</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dune-page-de-documentation"></a><a href="#création-dune-page-de-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>Création d'une page de documentation</h2>
|
||||
<ol>
|
||||
<li><p>Create a new file in the <code>docs</code> folder called <code>doc4.md</code>. The <code>docs</code> folder is in the root of your Docusaurus project, one level above <code>website</code>.</p></li>
|
||||
<li><p>Paste the following contents:</p>
|
||||
<li><p>Créer un nouveau fichier dans le dossier <code>docs</code> appelé <code>doc4.md</code>. Le dossier <code>docs</code> est à la racine de votre projet Docusaurus, un niveau au-dessus de <code>website</code>.</p></li>
|
||||
<li><p>Collez le contenu suivant :</p>
|
||||
<hr>
|
||||
<p>id: doc4
|
||||
title: This is Doc 4</p>
|
||||
title: Il s'agit du Doc 4</p>
|
||||
<hr>
|
||||
<p>I can write content using <a href="https://github.github.com/gfm/">GitHub-flavored Markdown syntax</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="markdown-syntax"></a><a href="#markdown-syntax" 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>Markdown Syntax</h2>
|
||||
<p><strong>Bold</strong> <em>italic</em> <code>code</code> <a href="#url">Links</a></p>
|
||||
<p>Je peux écrire du contenu en utilisant la <a href="https://github.github.com/gfm/">syntaxe de Markdown flavored GitHub</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="syntaxe-de-markdown"></a><a href="#syntaxe-de-markdown" 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>Syntaxe de Markdown</h2>
|
||||
<p><strong>Gras</strong> <em>italique</em> <code>code</code> <a href="#url">Liens</a></p>
|
||||
<blockquote>
|
||||
<p>Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
|
||||
id sem consectetuer libero luctus adipiscing.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li>Hey</li>
|
||||
<li>Salut</li>
|
||||
<li>Ho</li>
|
||||
<li>Let's Go</li>
|
||||
<li>Allons-y</li>
|
||||
</ul></li>
|
||||
</ol>
|
||||
<ol start="3">
|
||||
<li>The <code>sidebars.json</code> is where you specify the order of your documentation pages, so open <code>website/sidebars.json</code> and add <code>"doc4"</code> after <code>"doc1"</code>. This ID should be the same one as in the metadata for the Markdown file above, so if you gave a different ID in Step 2, just make sure to use the same ID in the sidebar file.</li>
|
||||
<li>Le <code>sidebars.json</code> est l'endroit où vous spécifiez l'ordre de vos pages de documentation, alors ouvrez <code>website/sidebars.json</code> et ajoutez <code>"doc4"</code> après <code>"doc1"</code>. Cet ID doit être le même que dans les métadonnées du fichier Markdown ci-dessus, donc si vous avez donné un ID différent à l'étape 2, assurez-vous d'utiliser le même ID dans le fichier de la barre latérale.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-diff">{
|
||||
"docs": {
|
||||
|
|
@ -149,12 +149,12 @@ id sem consectetuer libero luctus adipiscing.</p>
|
|||
}
|
||||
</code></pre>
|
||||
<ol start="4">
|
||||
<li>A server restart is needed to pick up sidebar changes, so kill your dev server (<kbd>Cmd</kbd> + <kbd>C</kbd> or <kbd>Ctrl</kbd> + <kbd>C</kbd>) and restart it with <code>npm run start</code>.</li>
|
||||
<li>Navigate to <a href="http://localhost:3000/docs/doc4">http://localhost:3000/docs/doc4</a>.</li>
|
||||
<li>Un redémarrage du serveur est nécessaire pour récupérer les modifications de la barre latérale, alors tuez votre serveur de développement (<kbd>Cmd</kbd> + <kbd>C</kbd> ou <kbd>Ctrl</kbd> + <kbd>C</kbd>) et redémarrez-le avec <code>npm run start</code>.</li>
|
||||
<li>Naviguez vers l'adresse <a href="http://localhost:3000/docs/doc4">http://localhost:3000/docs/doc4</a>.</li>
|
||||
</ol>
|
||||
<p>You've created your first documentation page on Docusaurus!</p>
|
||||
<p>Learn more about creating docs pages <a href="navigation">here</a>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-create-new-site"><span class="arrow-prev">← </span><span>Créer un nouveau site</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-publish-site"><span>Publier le site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#creating-a-regular-page">Creating a Regular Page</a></li><li><a href="#create-a-documentation-page">Create a Documentation Page</a></li><li><a href="#markdown-syntax">Markdown Syntax</a></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="
|
||||
<p>Vous avez créé votre première page de documentation sur Docusaurus !</p>
|
||||
<p>Apprenez en plus sur la création de page de documentation <a href="navigation">ici</a>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-create-new-site"><span class="arrow-prev">← </span><span>Créer un nouveau site</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-publish-site"><span>Publier le site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#création-dune-page-ordinaire">Création d'une page ordinaire</a></li><li><a href="#création-dune-page-de-documentation">Création d'une page de documentation</a></li><li><a href="#syntaxe-de-markdown">Syntaxe de Markdown</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -81,32 +81,32 @@
|
|||
}
|
||||
});
|
||||
</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">Publish the Site</h1></header><article><div><span><p><img src="/img/undraw_docusaurus_fb.svg" alt="Docusaurus Facebook"> {.docImage}</p>
|
||||
<p>Next, we'll learn how to publish the site to the WWW for everyone to browse! For the purpose of the tutorial, we'll use GitHub pages to host our website. But you can use any static file hosting service that you want, e.g. Netlify, Amazon S3, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<p>Ensuite, nous allons apprendre à publier le site sur le WWW pour que tout le monde puisse y naviguer ! Dans le cadre du tutoriel, nous utiliserons les pages GitHub pour héberger notre site Web. Mais vous pouvez utiliser n'importe quel service d'hébergement de fichiers statique que vous voulez, comme par exemple Netlify, Amazon S3, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="mettre-le-site-en-ligne"></a><a href="#mettre-le-site-en-ligne" 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>Mettre le site en ligne</h2>
|
||||
<p>Tuez d'abord le serveur web en appuyant sur Cmd + C ou Ctrl + C selon votre système d'exploitation.</p>
|
||||
<p>Dans <code>website/siteConfig.js</code>, remplissez les champs suivants :</p>
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
...
|
||||
url: 'https://USERNAME.github.io', // Replace USERNAME with your GitHub username.
|
||||
baseUrl: '/docusaurus-tutorial/', // The name of your GitHub project.
|
||||
projectName: 'docusaurus-tutorial', // The name of your GitHub project. Same as above.
|
||||
organizationName: 'USERNAME' // Your GitHub username.
|
||||
url: 'https://USERNAME.github.io', // Remplacez USERNAME avec votre nom d'utilisateur GitHub.
|
||||
baseUrl: '/docusaurus-tutorial/', // Le nom de votre projet GitHub.
|
||||
projectName: 'docusaurus-tutorial', // Le nom de votre projet GitHub. Identique au précédent.
|
||||
organizationName: 'USERNAME' // Votre nom d'utilisateur GitHub.
|
||||
...
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
<li><p>In the <code>website</code> directory, run <code>npm run build</code> or <code>yarn build</code>. Cela va générer un dossier <code>build</code> dans le dossier <code>website</code> contenant les fichiers <code>.html</code> de toute votre documentation et d'autres pages incluses dans <code>pages</code>. Make sure the <code>build</code> directory is there before running the next step.</p></li>
|
||||
<li><p>Replace <code><GIT_USER></code> with your GitHub username and run the following command.</p>
|
||||
<li><p>Dans le répertoire <code>website</code>, exécutez <code>npm run build</code> ou <code>yarn build</code>. Cela va générer un dossier <code>build</code> dans le dossier <code>website</code> contenant les fichiers <code>.html</code> de toute votre documentation et d'autres pages incluses dans <code>pages</code>. Assurez-vous que le répertoire <code>build</code> est là avant d'exécuter l'étape suivante.</p></li>
|
||||
<li><p>Remplacez <code><GIT_USER></code> par votre nom d'utilisateur GitHub et exécutez la commande suivante.</p>
|
||||
<p>$ GIT_USER=<GIT_USER> CURRENT_BRANCH=master USE_SSH=true npm run publish-gh-pages</p></li>
|
||||
</ol>
|
||||
<p>The built code will be pushed to the <code>gh-pages</code> branch of your repository.</p>
|
||||
<p>Le code construit sera poussé dans la branche <code>gh-pages</code> de votre dépôt.</p>
|
||||
<ol start="4">
|
||||
<li>Go to <code>https://USERNAME.github.io/docusaurus-tutorial/</code> and view your site in action!</li>
|
||||
<li>Allez sur <code>https://USERNAME.github.io/docusaurus-tutorial/</code> et regardez votre site en action !</li>
|
||||
</ol>
|
||||
<blockquote>
|
||||
<p>Note that when you run <code>npm run start</code> again, the <code>baseUrl</code> will now be part of the path.</p>
|
||||
<p>Notez que lorsque vous exécutez à nouveau <code>npm run start</code>, la <code>baseUrl</code> fera désormais partie du chemin.</p>
|
||||
</blockquote>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-create-pages"><span class="arrow-prev">← </span><span>Créer des pages</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-version"><span>Ajouter des versions</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#put-the-site-online">Put the Site Online</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-create-pages"><span class="arrow-prev">← </span><span>Créer des pages</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-version"><span>Ajouter des versions</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#mettre-le-site-en-ligne">Mettre le site en ligne</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -81,32 +81,32 @@
|
|||
}
|
||||
});
|
||||
</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">Publish the Site</h1></header><article><div><span><p><img src="/img/undraw_docusaurus_fb.svg" alt="Docusaurus Facebook"> {.docImage}</p>
|
||||
<p>Next, we'll learn how to publish the site to the WWW for everyone to browse! For the purpose of the tutorial, we'll use GitHub pages to host our website. But you can use any static file hosting service that you want, e.g. Netlify, Amazon S3, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<p>Ensuite, nous allons apprendre à publier le site sur le WWW pour que tout le monde puisse y naviguer ! Dans le cadre du tutoriel, nous utiliserons les pages GitHub pour héberger notre site Web. Mais vous pouvez utiliser n'importe quel service d'hébergement de fichiers statique que vous voulez, comme par exemple Netlify, Amazon S3, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="mettre-le-site-en-ligne"></a><a href="#mettre-le-site-en-ligne" 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>Mettre le site en ligne</h2>
|
||||
<p>Tuez d'abord le serveur web en appuyant sur Cmd + C ou Ctrl + C selon votre système d'exploitation.</p>
|
||||
<p>Dans <code>website/siteConfig.js</code>, remplissez les champs suivants :</p>
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
...
|
||||
url: 'https://USERNAME.github.io', // Replace USERNAME with your GitHub username.
|
||||
baseUrl: '/docusaurus-tutorial/', // The name of your GitHub project.
|
||||
projectName: 'docusaurus-tutorial', // The name of your GitHub project. Same as above.
|
||||
organizationName: 'USERNAME' // Your GitHub username.
|
||||
url: 'https://USERNAME.github.io', // Remplacez USERNAME avec votre nom d'utilisateur GitHub.
|
||||
baseUrl: '/docusaurus-tutorial/', // Le nom de votre projet GitHub.
|
||||
projectName: 'docusaurus-tutorial', // Le nom de votre projet GitHub. Identique au précédent.
|
||||
organizationName: 'USERNAME' // Votre nom d'utilisateur GitHub.
|
||||
...
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
<li><p>In the <code>website</code> directory, run <code>npm run build</code> or <code>yarn build</code>. Cela va générer un dossier <code>build</code> dans le dossier <code>website</code> contenant les fichiers <code>.html</code> de toute votre documentation et d'autres pages incluses dans <code>pages</code>. Make sure the <code>build</code> directory is there before running the next step.</p></li>
|
||||
<li><p>Replace <code><GIT_USER></code> with your GitHub username and run the following command.</p>
|
||||
<li><p>Dans le répertoire <code>website</code>, exécutez <code>npm run build</code> ou <code>yarn build</code>. Cela va générer un dossier <code>build</code> dans le dossier <code>website</code> contenant les fichiers <code>.html</code> de toute votre documentation et d'autres pages incluses dans <code>pages</code>. Assurez-vous que le répertoire <code>build</code> est là avant d'exécuter l'étape suivante.</p></li>
|
||||
<li><p>Remplacez <code><GIT_USER></code> par votre nom d'utilisateur GitHub et exécutez la commande suivante.</p>
|
||||
<p>$ GIT_USER=<GIT_USER> CURRENT_BRANCH=master USE_SSH=true npm run publish-gh-pages</p></li>
|
||||
</ol>
|
||||
<p>The built code will be pushed to the <code>gh-pages</code> branch of your repository.</p>
|
||||
<p>Le code construit sera poussé dans la branche <code>gh-pages</code> de votre dépôt.</p>
|
||||
<ol start="4">
|
||||
<li>Go to <code>https://USERNAME.github.io/docusaurus-tutorial/</code> and view your site in action!</li>
|
||||
<li>Allez sur <code>https://USERNAME.github.io/docusaurus-tutorial/</code> et regardez votre site en action !</li>
|
||||
</ol>
|
||||
<blockquote>
|
||||
<p>Note that when you run <code>npm run start</code> again, the <code>baseUrl</code> will now be part of the path.</p>
|
||||
<p>Notez que lorsque vous exécutez à nouveau <code>npm run start</code>, la <code>baseUrl</code> fera désormais partie du chemin.</p>
|
||||
</blockquote>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-create-pages"><span class="arrow-prev">← </span><span>Créer des pages</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-version"><span>Ajouter des versions</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#put-the-site-online">Put the Site Online</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-create-pages"><span class="arrow-prev">← </span><span>Créer des pages</span></a><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-version"><span>Ajouter des versions</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#mettre-le-site-en-ligne">Mettre le site en ligne</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Setting Up · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!"/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Setting Up · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!"/><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>Setting Up · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !"/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Setting Up · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !"/><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,62 +80,62 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Setting Up</h1></header><article><div><span><p>This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!</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">Setting Up</h1></header><article><div><span><p>Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !</p>
|
||||
<p><img src="/img/undraw_docusaurus_mountain.svg" alt="Docusaurus campfire"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-nodejs"></a><a href="#install-nodejs" 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>Install Node.js</h2>
|
||||
<p>Node.js is an environment that can run JavaScript code outside of a web browser and is used to write and run server-side JavaScript apps.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-nodejs"></a><a href="#installation-de-nodejs" 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>Installation de Node.js</h2>
|
||||
<p>Node.js est un environnement qui peut exécuter du code JavaScript en dehors d'un navigateur web et est utilisé pour écrire et exécuter des applications JavaScript côté serveur.</p>
|
||||
<blockquote>
|
||||
<p>Docusaurus' minimum supported Node.js version is Node 8, but more recent versions will work as well.</p>
|
||||
<p>La version minimale de Node.js supportée par Docusaurus est Node 8, mais des versions plus récentes fonctionneront également.</p>
|
||||
</blockquote>
|
||||
<ol>
|
||||
<li>Open your Terminal.</li>
|
||||
<li>If you have <code>brew</code> on your OS, run the following command to install Node (a JavaScript runtime that allows you to run JavaScript on the server) and <code>npm</code> the package manager (allows you to install npm modules from your terminal).</li>
|
||||
<li>Ouvrez votre Terminal.</li>
|
||||
<li>Si vous avez <code>brew</code> sur votre OS, exécutez la commande suivante pour installer Node (un runtime JavaScript qui vous permet d'exécuter JavaScript sur le serveur) et <code>npm</code> le gestionnaire de paquets (vous permet d'installer des modules npm depuis votre terminal).</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">brew install node
|
||||
</code></pre>
|
||||
<p>Alternatively, you can download an installer from the <a href="https://nodejs.org/en/">Node.js homepage</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="check-your-nodejs-installation"></a><a href="#check-your-nodejs-installation" 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>Check your Node.js installation</h2>
|
||||
<p>Check that you have the minimum required version installed by running the following command:</p>
|
||||
<p>Vous pouvez également télécharger un installateur depuis la <a href="https://nodejs.org/en/">page d'accueil Node.js</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="vérifification-de-votre-installation-de-nodejs"></a><a href="#vérifification-de-votre-installation-de-nodejs" 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>Vérifification de votre installation de Node.js</h2>
|
||||
<p>Vérifiez que vous avez la version minimale requise installée en exécutant la commande suivante :</p>
|
||||
<pre><code class="hljs css language-sh">node -v
|
||||
</code></pre>
|
||||
<p>You should see a version larger than Node 8.</p>
|
||||
<p>Vous devriez voir une version plus récente que Node 8.</p>
|
||||
<pre><code class="hljs css language-sh">node -v
|
||||
v8.15.1
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-yarn-optional"></a><a href="#install-yarn-optional" 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>Install Yarn (Optional)</h2>
|
||||
<p>We highly recommend you to install Yarn, an alternative package manager that has superb performance for managing your NPM dependencies. Check it out <a href="https://yarnpkg.com/en/docs/install">here</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-yarn-facultatif"></a><a href="#installation-de-yarn-facultatif" 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>Installation de Yarn (facultatif)</h2>
|
||||
<p>Nous vous recommandons fortement d'installer Yarn, un gestionnaire de paquets alternatif qui a de superbes performances pour gérer vos dépendances NPM. Découvrez le <a href="https://yarnpkg.com/en/docs/install">ici</a>.</p>
|
||||
<blockquote>
|
||||
<p>You can still proceed with the tutorial without Yarn.</p>
|
||||
<p>Vous pouvez continuer le tutoriel sans Yarn.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="create-a-github-repository"></a><a href="#create-a-github-repository" 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>Create a GitHub Repository</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dun-dépôt-github"></a><a href="#création-dun-dépôt-github" 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 dépôt GitHub</h2>
|
||||
<ol>
|
||||
<li>Go to <a href="https://github.com/">https://github.com/</a> and sign up for an account if you don't already have one.</li>
|
||||
<li>Click on <strong>"New Repository"</strong> or go to <a href="https://github.com/new">https://github.com/new</a>.</li>
|
||||
<li>Name your repository without spaces. For e.g. <code>docusaurus-tutorial</code>.</li>
|
||||
<li>Proceed to create the repository without adding <code>.gitignore</code> or a license.</li>
|
||||
<li>Allez sur <a href="https://github.com/">https://github.com/</a> et créez un compte si vous n'en avez pas déjà un.</li>
|
||||
<li>Cliquez sur <strong>"Nouveau dépôt" ("New Repository")</strong> ou allez sur <a href="https://github.com/new">https://github.com/new</a>.</li>
|
||||
<li>Nommez votre dépôt sans espaces. Par exemple, <code>docusaurus-tutorial</code>.</li>
|
||||
<li>Procédez à la création du dépôt sans ajouter <code>.gitignore</code> ou une licence.</li>
|
||||
</ol>
|
||||
<p><img src="/img/tutorial-git-clone.png" alt="GitHub create repo"> {.docImage}</p>
|
||||
<ol start="5">
|
||||
<li>Clone your repository to your local machine:</li>
|
||||
<li>Clonez votre dépôt sur votre machine locale :</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">git <span class="hljs-built_in">clone</span> git@github.com:USERNAME/docusaurus-tutorial.git <span class="hljs-comment"># SSH</span>
|
||||
<span class="hljs-comment"># or</span>
|
||||
<span class="hljs-comment"># ou</span>
|
||||
git <span class="hljs-built_in">clone</span> https://github.com/USERNAME/docusaurus-tutorial.git <span class="hljs-comment"># HTTPS</span>
|
||||
</code></pre>
|
||||
<ol start="6">
|
||||
<li><code>cd</code> into the repository which you just created.</li>
|
||||
<li><code>cd</code> dans le dépôt que vous venez de créer.</li>
|
||||
</ol>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-the-docusaurus-init-command"></a><a href="#install-the-docusaurus-init-command" 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>Install the Docusaurus init command</h2>
|
||||
<p>Docusaurus comes with a command line tool to help you scaffold a Docusaurus site with some example templates. Let's install the installer!</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-la-commande-init-de-docusaurus"></a><a href="#installation-de-la-commande-init-de-docusaurus" 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>Installation de la commande init de Docusaurus</h2>
|
||||
<p>Docusaurus est livré avec un outil en ligne de commande pour vous aider à concevoir un site Docusaurus avec quelques exemples de modèles. Installons l'installateur !</p>
|
||||
<ol>
|
||||
<li>Run the following command:</li>
|
||||
<li>Exécutez la commande suivante :</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">npm install --global docusaurus-init
|
||||
</code></pre>
|
||||
<p>or if you have Yarn:</p>
|
||||
<p>ou si vous avez Yarn :</p>
|
||||
<pre><code class="hljs css language-sh">yarn global add docusaurus-init
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-create-new-site"><span>Créer un nouveau site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#install-nodejs">Install Node.js</a></li><li><a href="#check-your-nodejs-installation">Check your Node.js installation</a></li><li><a href="#install-yarn-optional">Install Yarn (Optional)</a></li><li><a href="#create-a-github-repository">Create a GitHub Repository</a></li><li><a href="#install-the-docusaurus-init-command">Install the Docusaurus init command</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-create-new-site"><span>Créer un nouveau site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#installation-de-nodejs">Installation de Node.js</a></li><li><a href="#vérifification-de-votre-installation-de-nodejs">Vérifification de votre installation de Node.js</a></li><li><a href="#installation-de-yarn-facultatif">Installation de Yarn (facultatif)</a></li><li><a href="#création-dun-dépôt-github">Création d'un dépôt GitHub</a></li><li><a href="#installation-de-la-commande-init-de-docusaurus">Installation de la commande init de Docusaurus</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Setting Up · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!"/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Setting Up · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!"/><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>Setting Up · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !"/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Setting Up · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !"/><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,62 +80,62 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Setting Up</h1></header><article><div><span><p>This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!</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">Setting Up</h1></header><article><div><span><p>Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !</p>
|
||||
<p><img src="/img/undraw_docusaurus_mountain.svg" alt="Docusaurus campfire"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-nodejs"></a><a href="#install-nodejs" 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>Install Node.js</h2>
|
||||
<p>Node.js is an environment that can run JavaScript code outside of a web browser and is used to write and run server-side JavaScript apps.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-nodejs"></a><a href="#installation-de-nodejs" 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>Installation de Node.js</h2>
|
||||
<p>Node.js est un environnement qui peut exécuter du code JavaScript en dehors d'un navigateur web et est utilisé pour écrire et exécuter des applications JavaScript côté serveur.</p>
|
||||
<blockquote>
|
||||
<p>Docusaurus' minimum supported Node.js version is Node 8, but more recent versions will work as well.</p>
|
||||
<p>La version minimale de Node.js supportée par Docusaurus est Node 8, mais des versions plus récentes fonctionneront également.</p>
|
||||
</blockquote>
|
||||
<ol>
|
||||
<li>Open your Terminal.</li>
|
||||
<li>If you have <code>brew</code> on your OS, run the following command to install Node (a JavaScript runtime that allows you to run JavaScript on the server) and <code>npm</code> the package manager (allows you to install npm modules from your terminal).</li>
|
||||
<li>Ouvrez votre Terminal.</li>
|
||||
<li>Si vous avez <code>brew</code> sur votre OS, exécutez la commande suivante pour installer Node (un runtime JavaScript qui vous permet d'exécuter JavaScript sur le serveur) et <code>npm</code> le gestionnaire de paquets (vous permet d'installer des modules npm depuis votre terminal).</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">brew install node
|
||||
</code></pre>
|
||||
<p>Alternatively, you can download an installer from the <a href="https://nodejs.org/en/">Node.js homepage</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="check-your-nodejs-installation"></a><a href="#check-your-nodejs-installation" 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>Check your Node.js installation</h2>
|
||||
<p>Check that you have the minimum required version installed by running the following command:</p>
|
||||
<p>Vous pouvez également télécharger un installateur depuis la <a href="https://nodejs.org/en/">page d'accueil Node.js</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="vérifification-de-votre-installation-de-nodejs"></a><a href="#vérifification-de-votre-installation-de-nodejs" 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>Vérifification de votre installation de Node.js</h2>
|
||||
<p>Vérifiez que vous avez la version minimale requise installée en exécutant la commande suivante :</p>
|
||||
<pre><code class="hljs css language-sh">node -v
|
||||
</code></pre>
|
||||
<p>You should see a version larger than Node 8.</p>
|
||||
<p>Vous devriez voir une version plus récente que Node 8.</p>
|
||||
<pre><code class="hljs css language-sh">node -v
|
||||
v8.15.1
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-yarn-optional"></a><a href="#install-yarn-optional" 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>Install Yarn (Optional)</h2>
|
||||
<p>We highly recommend you to install Yarn, an alternative package manager that has superb performance for managing your NPM dependencies. Check it out <a href="https://yarnpkg.com/en/docs/install">here</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-yarn-facultatif"></a><a href="#installation-de-yarn-facultatif" 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>Installation de Yarn (facultatif)</h2>
|
||||
<p>Nous vous recommandons fortement d'installer Yarn, un gestionnaire de paquets alternatif qui a de superbes performances pour gérer vos dépendances NPM. Découvrez le <a href="https://yarnpkg.com/en/docs/install">ici</a>.</p>
|
||||
<blockquote>
|
||||
<p>You can still proceed with the tutorial without Yarn.</p>
|
||||
<p>Vous pouvez continuer le tutoriel sans Yarn.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="create-a-github-repository"></a><a href="#create-a-github-repository" 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>Create a GitHub Repository</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dun-dépôt-github"></a><a href="#création-dun-dépôt-github" 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 dépôt GitHub</h2>
|
||||
<ol>
|
||||
<li>Go to <a href="https://github.com/">https://github.com/</a> and sign up for an account if you don't already have one.</li>
|
||||
<li>Click on <strong>"New Repository"</strong> or go to <a href="https://github.com/new">https://github.com/new</a>.</li>
|
||||
<li>Name your repository without spaces. For e.g. <code>docusaurus-tutorial</code>.</li>
|
||||
<li>Proceed to create the repository without adding <code>.gitignore</code> or a license.</li>
|
||||
<li>Allez sur <a href="https://github.com/">https://github.com/</a> et créez un compte si vous n'en avez pas déjà un.</li>
|
||||
<li>Cliquez sur <strong>"Nouveau dépôt" ("New Repository")</strong> ou allez sur <a href="https://github.com/new">https://github.com/new</a>.</li>
|
||||
<li>Nommez votre dépôt sans espaces. Par exemple, <code>docusaurus-tutorial</code>.</li>
|
||||
<li>Procédez à la création du dépôt sans ajouter <code>.gitignore</code> ou une licence.</li>
|
||||
</ol>
|
||||
<p><img src="/img/tutorial-git-clone.png" alt="GitHub create repo"> {.docImage}</p>
|
||||
<ol start="5">
|
||||
<li>Clone your repository to your local machine:</li>
|
||||
<li>Clonez votre dépôt sur votre machine locale :</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">git <span class="hljs-built_in">clone</span> git@github.com:USERNAME/docusaurus-tutorial.git <span class="hljs-comment"># SSH</span>
|
||||
<span class="hljs-comment"># or</span>
|
||||
<span class="hljs-comment"># ou</span>
|
||||
git <span class="hljs-built_in">clone</span> https://github.com/USERNAME/docusaurus-tutorial.git <span class="hljs-comment"># HTTPS</span>
|
||||
</code></pre>
|
||||
<ol start="6">
|
||||
<li><code>cd</code> into the repository which you just created.</li>
|
||||
<li><code>cd</code> dans le dépôt que vous venez de créer.</li>
|
||||
</ol>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-the-docusaurus-init-command"></a><a href="#install-the-docusaurus-init-command" 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>Install the Docusaurus init command</h2>
|
||||
<p>Docusaurus comes with a command line tool to help you scaffold a Docusaurus site with some example templates. Let's install the installer!</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-la-commande-init-de-docusaurus"></a><a href="#installation-de-la-commande-init-de-docusaurus" 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>Installation de la commande init de Docusaurus</h2>
|
||||
<p>Docusaurus est livré avec un outil en ligne de commande pour vous aider à concevoir un site Docusaurus avec quelques exemples de modèles. Installons l'installateur !</p>
|
||||
<ol>
|
||||
<li>Run the following command:</li>
|
||||
<li>Exécutez la commande suivante :</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">npm install --global docusaurus-init
|
||||
</code></pre>
|
||||
<p>or if you have Yarn:</p>
|
||||
<p>ou si vous avez Yarn :</p>
|
||||
<pre><code class="hljs css language-sh">yarn global add docusaurus-init
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-create-new-site"><span>Créer un nouveau site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#install-nodejs">Install Node.js</a></li><li><a href="#check-your-nodejs-installation">Check your Node.js installation</a></li><li><a href="#install-yarn-optional">Install Yarn (Optional)</a></li><li><a href="#create-a-github-repository">Create a GitHub Repository</a></li><li><a href="#install-the-docusaurus-init-command">Install the Docusaurus init command</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.10.x/tutorial-create-new-site"><span>Créer un nouveau site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#installation-de-nodejs">Installation de Node.js</a></li><li><a href="#vérifification-de-votre-installation-de-nodejs">Vérifification de votre installation de Node.js</a></li><li><a href="#installation-de-yarn-facultatif">Installation de Yarn (facultatif)</a></li><li><a href="#création-dun-dépôt-github">Création d'un dépôt GitHub</a></li><li><a href="#installation-de-la-commande-init-de-docusaurus">Installation de la commande init de Docusaurus</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Add Versions · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Add Versions · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes."/><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>Add Versions · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Add Versions · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée."/><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,39 +80,39 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Add Versions</h1></header><article><div><span><p>With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes.</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">Add Versions</h1></header><article><div><span><p>Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée.</p>
|
||||
<p><img src="/img/undraw_docusaurus_process.svg" alt="Docusaurus process"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="releasing-a-version"></a><a href="#releasing-a-version" 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>Releasing a Version</h2>
|
||||
<p>Assuming we are happy with the current state of the documentation and we want to freeze it as the v1.0.0 docs. We first run the following command to generate a <code>versions.js</code> file, which will be used to list down all the versions of docs in the project.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="libérer-une-version"></a><a href="#libérer-une-version" 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>Libérer une version</h2>
|
||||
<p>En supposant que nous sommes satisfaits de l'état actuel de la documentation et que nous voulons la geler comme la documentation v1.0.0. Nous exécutons d'abord la commande suivante pour générer un fichier <code>versions.js</code> , qui sera utilisé pour lister toutes les versions de documents du projet.</p>
|
||||
<pre><code class="hljs css language-sh">npm run examples versions <span class="hljs-comment"># yarn examples versions</span>
|
||||
</code></pre>
|
||||
<p>Next, we run a command with the version we want to create, e.g. 1.0.0,</p>
|
||||
<p>Ensuite, nous exécutons une commande avec la version que nous voulons créer, par exemple 1.0.0,</p>
|
||||
<pre><code class="hljs css language-sh">npm run version 1.0.0 <span class="hljs-comment"># yarn version 1.0.0</span>
|
||||
</code></pre>
|
||||
<p>This will preserve all documents currently in the <code>docs</code> directory and make them available as documentation for version 1.0.0.</p>
|
||||
<p>Documents in the <code>docs</code> directory will be considered part of version next and they are available, for example, at the URL <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Documents from the latest version use the URL <code>docs/doc1</code>.</p>
|
||||
<p>Let's test out that versioning actually works. We can go to <code>docs/doc1.md</code> and change the first line of the body:</p>
|
||||
<p>Cela préservera tous les documents actuellement dans le répertoire <code>docs</code> et les rendra disponibles en tant que documentation pour la version 1.0.0.</p>
|
||||
<p>Les documents dans le répertoire <code>docs</code> seront considérés comme faisant partie de la version suivante et sont disponibles, par exemple, à l'URL <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Les documents de la dernière version utilisent l'URL <code>docs/doc1</code>.</p>
|
||||
<p>Testons comment le versionnage fonctionne réellement. On peut aller dans <code>docs/doc1.md</code> et changer la première ligne du corps :</p>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-comment">---</span>
|
||||
id: doc1
|
||||
title: Latin-ish
|
||||
sidebar_label: Example Page
|
||||
sidebar_label: Page d'exemple
|
||||
<span class="hljs-comment">---</span>
|
||||
|
||||
<span class="hljs-deletion">- Check the [documentation](https://docusaurus.io) for how to use Docusaurus.</span>
|
||||
<span class="hljs-addition">+ This is the latest version of the docs.</span>
|
||||
<span class="hljs-deletion">- Vérifiez la [documentation](https://docusaurus.io) pour savoir comment utiliser Docusaurus.</span>
|
||||
<span class="hljs-addition">+ Ceci est la dernière version de la documentation.</span>
|
||||
|
||||
## Lorem
|
||||
|
||||
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies.
|
||||
</code></pre>
|
||||
<p>If we go to the <code>localhost:3000/<baseUrl>/docs/doc1</code> URL in our browser, realize that it's still showing the previous line. That's because the version we're looking at now is the 1.0.0 version, which has already been frozen in time.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="next-version"></a><a href="#next-version" 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>Next Version</h2>
|
||||
<p>The latest versions of the docs have to be accessed by adding <code>next</code> to the URL: <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Note that the version beside the title also changes to <code>next</code> when we are on that URL.</p>
|
||||
<p>A versions page has been created for us at <code>localhost:3000/<baseUrl>/versions</code> which shows a list of the current versions of the documentation. See that both <code>1.0.0</code> and <code>master</code> are being listed here and they correctly link to the respective versions of the documentation.</p>
|
||||
<p>Go ahead and publish your versioned site!</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="wrap-up"></a><a href="#wrap-up" 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>Wrap Up</h2>
|
||||
<p>That's all folks! In this short tutorial, you have experienced how easy it was to create a documentation website from scratch and making versions for them. There are many more things you can do with Docusaurus, such as adding a blog, search and translations. Check out the Guides section for more.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-publish-site"><span class="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#releasing-a-version">Releasing a Version</a></li><li><a href="#next-version">Next Version</a></li><li><a href="#wrap-up">Wrap Up</a></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="
|
||||
<p>Si nous allons à l'URL <code>localhost:3000/<baseUrl>/docs/doc1</code> dans notre navigateur, nous réalisons qu'elle montre toujours la ligne précédente. C'est parce que la version que nous regardons maintenant la version 1.0.0, qui a déjà été figée dans le temps.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="prochaine-version"></a><a href="#prochaine-version" 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>Prochaine version</h2>
|
||||
<p>Les dernières versions de la documentation doivent être accessibles en ajoutant <code>next</code> à l'URL : <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Notez que la version à côté du titre change également à <code>next</code> lorsque nous sommes sur cette URL.</p>
|
||||
<p>Une page de versions a été créée pour nous à l'adresse <code>localhost:3000/<baseUrl>/versions</code> qui affiche une liste des versions actuelles de la documentation. Vous voyez que <code>1.0.0</code> et <code>master</code> sont toutes les deux listées ici et qu'elles sont correctement liées aux versions respectives de la documentation.</p>
|
||||
<p>Allez-y et publiez votre site versionné !</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="récapitulatif"></a><a href="#récapitulatif" 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>Récapitulatif</h2>
|
||||
<p>C'est fini, Mesdames Messieurs ! Dans ce court tutoriel, vous avez pu constater à quel point il était facile de créer un site Web de documentation à partir de zéro et de créer des versions. Il y a bien d'autres choses que vous pouvez faire avec Docusaurus, comme ajouter un blog, rechercher et traduire. Consultez la section Guides pour en savoir plus.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-publish-site"><span class="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#libérer-une-version">Libérer une version</a></li><li><a href="#prochaine-version">Prochaine version</a></li><li><a href="#récapitulatif">Récapitulatif</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Add Versions · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Add Versions · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes."/><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>Add Versions · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée."/><meta name="docsearch:version" content="1.10.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Add Versions · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée."/><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,39 +80,39 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Add Versions</h1></header><article><div><span><p>With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes.</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">Add Versions</h1></header><article><div><span><p>Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée.</p>
|
||||
<p><img src="/img/undraw_docusaurus_process.svg" alt="Docusaurus process"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="releasing-a-version"></a><a href="#releasing-a-version" 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>Releasing a Version</h2>
|
||||
<p>Assuming we are happy with the current state of the documentation and we want to freeze it as the v1.0.0 docs. We first run the following command to generate a <code>versions.js</code> file, which will be used to list down all the versions of docs in the project.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="libérer-une-version"></a><a href="#libérer-une-version" 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>Libérer une version</h2>
|
||||
<p>En supposant que nous sommes satisfaits de l'état actuel de la documentation et que nous voulons la geler comme la documentation v1.0.0. Nous exécutons d'abord la commande suivante pour générer un fichier <code>versions.js</code> , qui sera utilisé pour lister toutes les versions de documents du projet.</p>
|
||||
<pre><code class="hljs css language-sh">npm run examples versions <span class="hljs-comment"># yarn examples versions</span>
|
||||
</code></pre>
|
||||
<p>Next, we run a command with the version we want to create, e.g. 1.0.0,</p>
|
||||
<p>Ensuite, nous exécutons une commande avec la version que nous voulons créer, par exemple 1.0.0,</p>
|
||||
<pre><code class="hljs css language-sh">npm run version 1.0.0 <span class="hljs-comment"># yarn version 1.0.0</span>
|
||||
</code></pre>
|
||||
<p>This will preserve all documents currently in the <code>docs</code> directory and make them available as documentation for version 1.0.0.</p>
|
||||
<p>Documents in the <code>docs</code> directory will be considered part of version next and they are available, for example, at the URL <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Documents from the latest version use the URL <code>docs/doc1</code>.</p>
|
||||
<p>Let's test out that versioning actually works. We can go to <code>docs/doc1.md</code> and change the first line of the body:</p>
|
||||
<p>Cela préservera tous les documents actuellement dans le répertoire <code>docs</code> et les rendra disponibles en tant que documentation pour la version 1.0.0.</p>
|
||||
<p>Les documents dans le répertoire <code>docs</code> seront considérés comme faisant partie de la version suivante et sont disponibles, par exemple, à l'URL <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Les documents de la dernière version utilisent l'URL <code>docs/doc1</code>.</p>
|
||||
<p>Testons comment le versionnage fonctionne réellement. On peut aller dans <code>docs/doc1.md</code> et changer la première ligne du corps :</p>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-comment">---</span>
|
||||
id: doc1
|
||||
title: Latin-ish
|
||||
sidebar_label: Example Page
|
||||
sidebar_label: Page d'exemple
|
||||
<span class="hljs-comment">---</span>
|
||||
|
||||
<span class="hljs-deletion">- Check the [documentation](https://docusaurus.io) for how to use Docusaurus.</span>
|
||||
<span class="hljs-addition">+ This is the latest version of the docs.</span>
|
||||
<span class="hljs-deletion">- Vérifiez la [documentation](https://docusaurus.io) pour savoir comment utiliser Docusaurus.</span>
|
||||
<span class="hljs-addition">+ Ceci est la dernière version de la documentation.</span>
|
||||
|
||||
## Lorem
|
||||
|
||||
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies.
|
||||
</code></pre>
|
||||
<p>If we go to the <code>localhost:3000/<baseUrl>/docs/doc1</code> URL in our browser, realize that it's still showing the previous line. That's because the version we're looking at now is the 1.0.0 version, which has already been frozen in time.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="next-version"></a><a href="#next-version" 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>Next Version</h2>
|
||||
<p>The latest versions of the docs have to be accessed by adding <code>next</code> to the URL: <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Note that the version beside the title also changes to <code>next</code> when we are on that URL.</p>
|
||||
<p>A versions page has been created for us at <code>localhost:3000/<baseUrl>/versions</code> which shows a list of the current versions of the documentation. See that both <code>1.0.0</code> and <code>master</code> are being listed here and they correctly link to the respective versions of the documentation.</p>
|
||||
<p>Go ahead and publish your versioned site!</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="wrap-up"></a><a href="#wrap-up" 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>Wrap Up</h2>
|
||||
<p>That's all folks! In this short tutorial, you have experienced how easy it was to create a documentation website from scratch and making versions for them. There are many more things you can do with Docusaurus, such as adding a blog, search and translations. Check out the Guides section for more.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-publish-site"><span class="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#releasing-a-version">Releasing a Version</a></li><li><a href="#next-version">Next Version</a></li><li><a href="#wrap-up">Wrap Up</a></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="
|
||||
<p>Si nous allons à l'URL <code>localhost:3000/<baseUrl>/docs/doc1</code> dans notre navigateur, nous réalisons qu'elle montre toujours la ligne précédente. C'est parce que la version que nous regardons maintenant la version 1.0.0, qui a déjà été figée dans le temps.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="prochaine-version"></a><a href="#prochaine-version" 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>Prochaine version</h2>
|
||||
<p>Les dernières versions de la documentation doivent être accessibles en ajoutant <code>next</code> à l'URL : <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Notez que la version à côté du titre change également à <code>next</code> lorsque nous sommes sur cette URL.</p>
|
||||
<p>Une page de versions a été créée pour nous à l'adresse <code>localhost:3000/<baseUrl>/versions</code> qui affiche une liste des versions actuelles de la documentation. Vous voyez que <code>1.0.0</code> et <code>master</code> sont toutes les deux listées ici et qu'elles sont correctement liées aux versions respectives de la documentation.</p>
|
||||
<p>Allez-y et publiez votre site versionné !</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="récapitulatif"></a><a href="#récapitulatif" 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>Récapitulatif</h2>
|
||||
<p>C'est fini, Mesdames Messieurs ! Dans ce court tutoriel, vous avez pu constater à quel point il était facile de créer un site Web de documentation à partir de zéro et de créer des versions. Il y a bien d'autres choses que vous pouvez faire avec Docusaurus, comme ajouter un blog, rechercher et traduire. Consultez la section Guides pour en savoir plus.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.10.x/tutorial-publish-site"><span class="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#libérer-une-version">Libérer une version</a></li><li><a href="#prochaine-version">Prochaine version</a></li><li><a href="#récapitulatif">Récapitulatif</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -94,7 +94,7 @@
|
|||
},
|
||||
...
|
||||
</code></pre>
|
||||
<p>Run the script with a command line argument of the version you wish to create. e.g.,</p>
|
||||
<p>Run the script with a command line argument of the version you wish to create. Par exemple :</p>
|
||||
<pre><code class="hljs css language-bash">yarn run version 1.0.0
|
||||
</code></pre>
|
||||
<p>This will preserve all documents currently in the <code>docs</code> directory and make them available as documentation for version <code>1.0.0</code>.</p>
|
||||
|
|
@ -132,7 +132,7 @@
|
|||
},
|
||||
...
|
||||
</code></pre>
|
||||
<p>Run the script with command line arguments of first, the current version name, then second, the new version name. e.g.,</p>
|
||||
<p>Run the script with command line arguments of first, the current version name, then second, the new version name. Par exemple :</p>
|
||||
<pre><code class="hljs css language-bash">yarn run rename-version 1.0.0 1.0.1
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="versioning-and-translations"></a><a href="#versioning-and-translations" 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>Versioning and Translations</h2>
|
||||
|
|
|
|||
|
|
@ -94,7 +94,7 @@
|
|||
},
|
||||
...
|
||||
</code></pre>
|
||||
<p>Run the script with a command line argument of the version you wish to create. e.g.,</p>
|
||||
<p>Run the script with a command line argument of the version you wish to create. Par exemple :</p>
|
||||
<pre><code class="hljs css language-bash">yarn run version 1.0.0
|
||||
</code></pre>
|
||||
<p>This will preserve all documents currently in the <code>docs</code> directory and make them available as documentation for version <code>1.0.0</code>.</p>
|
||||
|
|
@ -132,7 +132,7 @@
|
|||
},
|
||||
...
|
||||
</code></pre>
|
||||
<p>Run the script with command line arguments of first, the current version name, then second, the new version name. e.g.,</p>
|
||||
<p>Run the script with command line arguments of first, the current version name, then second, the new version name. Par exemple :</p>
|
||||
<pre><code class="hljs css language-bash">yarn run rename-version 1.0.0 1.0.1
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="versioning-and-translations"></a><a href="#versioning-and-translations" 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>Versioning and Translations</h2>
|
||||
|
|
|
|||
|
|
@ -103,7 +103,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="options-dentête"></a><a href="#options-dentête" 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>Options d'entête</h2>
|
||||
<p>Le seul champ requis est <code>title</code>; cependant, nous fournissons des options pour ajouter des informations sur l'auteur à votre article de blog également.</p>
|
||||
<ul>
|
||||
<li><code>auteur</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>author</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>authorURL</code> - L'URL associée à l'auteur. Ceci pourrait être un compte Twitter, GitHub, Facebook, etc.</li>
|
||||
<li><code>authorFBID</code> - L'ID de profil Facebook qui est utilisé pour récupérer l'image de profil.</li>
|
||||
<li><code>authorImageURL</code> - L'URL vers l'image de l'auteur. (Remarque : Si vous utilisez à la fois <code>authorFBID</code> et <code>authorImageURL</code>, <code>authorFBID</code> prendra la priorité. N’incluez pas <code>authorFBID</code> si vous voulez que <code>authorImageURL</code> apparaisse.)</li>
|
||||
|
|
@ -129,7 +129,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale"></a><a href="#changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale" 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>Changer le nombre de messages du blog sur la barre latérale</h2>
|
||||
<p>Par défaut, 5 messages récents sont affichés sur la barre latérale.</p>
|
||||
<p>Vous pouvez configurer un nombre spécifique de messages de blog à afficher en ajoutant un paramètre <code>blogSidebarCount</code> à votre <code>siteConfig.js</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>"ALL"</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>'ALL'</code>.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-js">blogSidebarCount: <span class="hljs-string">'ALL'</span>,
|
||||
</code></pre>
|
||||
|
|
@ -143,7 +143,7 @@
|
|||
<p>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 ajoutées sur le tag HTML <code><HEAD></code> de votre page web.</p>
|
||||
<p>Un résumé du texte du message est fourni dans le flux RSS depuis <code><!--truncate--></code>. Si aucune balise <code><!--truncate--></code> n'est trouvée, alors tout le texte jusqu'au 250ème caractère sera utilisé.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="boutons-de-réseaux-sociaux"></a><a href="#boutons-de-réseaux-sociaux" 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>Boutons de réseaux sociaux</h2>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et / ou Twitter au bas de vos billets, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> <a href="/docs/fr/1.11.x/site-config">configuration du site</a> options dans <code>siteConfig.js</code>.</p>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et/ou Twitter au bas de vos articles de blog, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> de la <a href="/docs/fr/1.11.x/site-config">configuration du site</a> dans <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="sujets-avancés"></a><a href="#sujets-avancés" 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>Sujets avancés</h2>
|
||||
<h3><a class="anchor" aria-hidden="true" id="je-veux-exécuter-en-mode-blog-uniquement"></a><a href="#je-veux-exécuter-en-mode-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>Je veux exécuter en mode "Blog uniquement".</h3>
|
||||
<p>Vous pouvez exécuter votre site Docusaurus sans page d'accueil et avoir en premier votre blog.</p>
|
||||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Maintenant, lorsque Docusaurus génère ou construit votre site, il copiera le fichier de <code>static/index.html</code> 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 <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez utiliser ce modèle :</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -103,7 +103,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="options-dentête"></a><a href="#options-dentête" 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>Options d'entête</h2>
|
||||
<p>Le seul champ requis est <code>title</code>; cependant, nous fournissons des options pour ajouter des informations sur l'auteur à votre article de blog également.</p>
|
||||
<ul>
|
||||
<li><code>auteur</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>author</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>authorURL</code> - L'URL associée à l'auteur. Ceci pourrait être un compte Twitter, GitHub, Facebook, etc.</li>
|
||||
<li><code>authorFBID</code> - L'ID de profil Facebook qui est utilisé pour récupérer l'image de profil.</li>
|
||||
<li><code>authorImageURL</code> - L'URL vers l'image de l'auteur. (Remarque : Si vous utilisez à la fois <code>authorFBID</code> et <code>authorImageURL</code>, <code>authorFBID</code> prendra la priorité. N’incluez pas <code>authorFBID</code> si vous voulez que <code>authorImageURL</code> apparaisse.)</li>
|
||||
|
|
@ -129,7 +129,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale"></a><a href="#changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale" 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>Changer le nombre de messages du blog sur la barre latérale</h2>
|
||||
<p>Par défaut, 5 messages récents sont affichés sur la barre latérale.</p>
|
||||
<p>Vous pouvez configurer un nombre spécifique de messages de blog à afficher en ajoutant un paramètre <code>blogSidebarCount</code> à votre <code>siteConfig.js</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>"ALL"</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>'ALL'</code>.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-js">blogSidebarCount: <span class="hljs-string">'ALL'</span>,
|
||||
</code></pre>
|
||||
|
|
@ -143,7 +143,7 @@
|
|||
<p>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 ajoutées sur le tag HTML <code><HEAD></code> de votre page web.</p>
|
||||
<p>Un résumé du texte du message est fourni dans le flux RSS depuis <code><!--truncate--></code>. Si aucune balise <code><!--truncate--></code> n'est trouvée, alors tout le texte jusqu'au 250ème caractère sera utilisé.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="boutons-de-réseaux-sociaux"></a><a href="#boutons-de-réseaux-sociaux" 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>Boutons de réseaux sociaux</h2>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et / ou Twitter au bas de vos billets, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> <a href="/docs/fr/1.11.x/site-config">configuration du site</a> options dans <code>siteConfig.js</code>.</p>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et/ou Twitter au bas de vos articles de blog, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> de la <a href="/docs/fr/1.11.x/site-config">configuration du site</a> dans <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="sujets-avancés"></a><a href="#sujets-avancés" 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>Sujets avancés</h2>
|
||||
<h3><a class="anchor" aria-hidden="true" id="je-veux-exécuter-en-mode-blog-uniquement"></a><a href="#je-veux-exécuter-en-mode-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>Je veux exécuter en mode "Blog uniquement".</h3>
|
||||
<p>Vous pouvez exécuter votre site Docusaurus sans page d'accueil et avoir en premier votre blog.</p>
|
||||
|
|
@ -158,7 +158,7 @@
|
|||
<p>Maintenant, lorsque Docusaurus génère ou construit votre site, il copiera le fichier de <code>static/index.html</code> 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 <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez utiliser ce modèle :</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -224,7 +224,7 @@ module.exports = MyPage;
|
|||
<p>More examples of how these components are used can be found in the <a href="/docs/fr/1.11.x/site-preparation">generated example files</a> as well as in Docusaurus' own repository for its website set-up.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="translating-strings"></a><a href="#translating-strings" 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>Translating Strings</h2>
|
||||
<p>When translations are enabled, any pages inside <code>website/pages/en</code> will be translated for all enabled languages. Les URLs pour les pages non-anglophones utiliseront leurs tags de langue comme indiqué dans le fichier <code>languages.js</code> . Par exemple, l'URL d'une page française de <code>website/pages/en/help.js</code> se trouve à <code>${baseUrl}fr/help.html</code>.</p>
|
||||
<p>When writing pages that you wish to translate, wrap any strings to be translated inside a <code><translate></code> tag. e.g.,</p>
|
||||
<p>When writing pages that you wish to translate, wrap any strings to be translated inside a <code><translate></code> tag. Par exemple :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span><span class="token constant">I</span> like translations<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>p</span><span class="token punctuation">></span></span>
|
||||
|
|
|
|||
|
|
@ -224,7 +224,7 @@ module.exports = MyPage;
|
|||
<p>More examples of how these components are used can be found in the <a href="/docs/fr/1.11.x/site-preparation">generated example files</a> as well as in Docusaurus' own repository for its website set-up.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="translating-strings"></a><a href="#translating-strings" 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>Translating Strings</h2>
|
||||
<p>When translations are enabled, any pages inside <code>website/pages/en</code> will be translated for all enabled languages. Les URLs pour les pages non-anglophones utiliseront leurs tags de langue comme indiqué dans le fichier <code>languages.js</code> . Par exemple, l'URL d'une page française de <code>website/pages/en/help.js</code> se trouve à <code>${baseUrl}fr/help.html</code>.</p>
|
||||
<p>When writing pages that you wish to translate, wrap any strings to be translated inside a <code><translate></code> tag. e.g.,</p>
|
||||
<p>When writing pages that you wish to translate, wrap any strings to be translated inside a <code><translate></code> tag. Par exemple :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span><span class="token constant">I</span> like translations<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>p</span><span class="token punctuation">></span></span>
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Custom Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding `.js` files to the `website/pages` directory. These files are [React](https://reactjs.org/) components and the `render()` is called to create them, backed by CSS classes, etc."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Custom Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding `.js` files to the `website/pages` directory. These files are [React](https://reactjs.org/) components and the `render()` is called to create them, backed by CSS classes, etc."/><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>Custom Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers `.js` au répertoire `website/pages`. Ces fichiers sont des composants [React](https://reactjs.org/) et le `render()` est appelé pour les créer, avec le renfort des classes CSS, etc."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Custom Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers `.js` au répertoire `website/pages`. Ces fichiers sont des composants [React](https://reactjs.org/) et le `render()` est appelé pour les créer, avec le renfort des classes CSS, etc."/><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,12 +80,12 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Custom Pages</h1></header><article><div><span><p>You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding <code>.js</code> files to the <code>website/pages</code> directory. These files are <a href="https://reactjs.org/">React</a> components and the <code>render()</code> is called to create them, backed by CSS classes, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-your-home-page"></a><a href="#customizing-your-home-page" 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>Customizing Your Home Page</h2>
|
||||
<p>The easiest way to get started customizing your home page is to use the example site that was <a href="/docs/fr/1.11.x/site-creation">created</a> when you ran the <a href="/docs/fr/1.11.x/installation">Docusaurus initialization script</a>.</p>
|
||||
<p>You can <a href="/docs/fr/1.11.x/site-preparation#verifying-installation">start</a> your local server and go to <code>http://localhost:3000</code> to see what the example home page looks like. From there, edit the <code>website/pages/en/index.js</code> file and its various components to use the images and text you want for your project.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-other-custom-pages"></a><a href="#adding-other-custom-pages" 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>Adding Other Custom Pages</h2>
|
||||
<p>Docusaurus provides some helpful example pages in the <code>website/pages/en</code> directory, including <code>index.js</code>, <code>users.js</code>, and <code>help.js</code>. These are good examples to showcase how to create a custom page for Docusaurus.</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">Custom Pages</h1></header><article><div><span><p>Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers <code>.js</code> au répertoire <code>website/pages</code>. Ces fichiers sont des composants <a href="https://reactjs.org/">React</a> et le <code>render()</code> est appelé pour les créer, avec le renfort des classes CSS, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-de-votre-page-daccueil"></a><a href="#personnalisation-de-votre-page-daccueil" 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 de votre page d'accueil</h2>
|
||||
<p>La façon la plus simple de commencer à personnaliser votre page d'accueil est d'utiliser le site d'exemple qui a été <a href="/docs/fr/1.11.x/site-creation">créé</a> lorsque vous avez exécuté le <a href="/docs/fr/1.11.x/installation">script d'initialisation Docusaurus</a>.</p>
|
||||
<p>Vous pouvez <a href="/docs/fr/1.11.x/site-preparation#verifying-installation">démarrer</a> votre serveur local et aller à l'adresse <code>http://localhost:3000</code> pour voir à quoi ressemble la page d'accueil d'exemple. À partir de là, éditez le fichier <code>website/pages/fr/index.js</code> et ses divers composants pour utiliser les images et le texte que vous voulez pour votre projet.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-dautres-pages-personnalisées"></a><a href="#ajouter-dautres-pages-personnalisées" 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>Ajouter d'autres pages personnalisées</h2>
|
||||
<p>Docusaurus fournit quelques exemples de pages utiles dans le répertoire <code>website/pages/en</code>, y compris <code>index.js</code>, <code>users.js</code> et <code>help.js</code>. Ce sont de bons exemples pour montrer comment créer une page personnalisée pour Docusaurus.</p>
|
||||
<pre><code class="hljs css language-bash">root-directory
|
||||
├── docs
|
||||
└── website
|
||||
|
|
@ -102,22 +102,22 @@
|
|||
├── siteConfig.js
|
||||
└── static
|
||||
</code></pre>
|
||||
<p>You are also free to write your own pages. It is strongly suggested that you at least have an index page, but none of the pages provided are mandatory to include in your site. More information on how to use the provided components or include your own can be found <a href="/docs/fr/1.11.x/api-pages">here</a>. Information on how to link to your different pages in the header navigation bar can be found <a href="/docs/fr/1.11.x/navigation">here</a>.</p>
|
||||
<p>Vous êtes également libre d'écrire vos propres pages. Il est fortement conseillé d'avoir au moins une page d'index, mais aucune des pages fournies n'est à inclure obligatoirement dans votre site. Plus d'informations sur la façon d'utiliser les composants fournis ou d'inclure vos propres composants peuvent être trouvées <a href="/docs/fr/1.11.x/api-pages">ici</a>. Des informations sur la façon de créer un lien vers vos différentes pages dans la barre de navigation d'entête peuvent être trouvées <a href="/docs/fr/1.11.x/navigation">ici</a>.</p>
|
||||
<blockquote>
|
||||
<p>If you want your page to show up in your navigation header, you will need to update <code>siteConfig.js</code> to add to the <code>headerLinks</code> element. e.g., <code>{ page: 'about-slash', label: 'About/' }</code>,</p>
|
||||
<p>Si vous voulez que votre page apparaisse dans votre entête de navigation, vous devrez mettre à jour <code>siteConfig.js</code> pour l'ajouter à l'élément <code>headerLinks</code>. Par exemple, <code>{ page: 'about-slash', label: 'About/' }</code>,</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-static-pages"></a><a href="#adding-static-pages" 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>Adding Static Pages</h2>
|
||||
<p>Static <code>.html</code> files can also be used, but they will not include Docusaurus' header, footer, or styles by default. These can be added to the <code>static</code> directory in the same way as other <a href="/docs/fr/1.11.x/api-pages#using-static-assets">static assets</a>. Alternatively, they can be placed in the <code>pages</code> directory and would be served as-is instead of being rendered from React.</p>
|
||||
<p>If you wish to use Docusaurus' stylesheet, you can access it at <code>${baseUrl}css/main.css</code>. If you wish to use separate CSS for these static pages, you can exclude them from being concatenated to Docusaurus' styles by adding them into the <code>siteConfig.separateCss</code> field in <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-de-pages-statiques"></a><a href="#ajouter-de-pages-statiques" 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>Ajouter de pages statiques</h2>
|
||||
<p>Les fichiers statiques <code>.html</code> peuvent également être utilisés, mais ils n'incluront pas l'entête de Docusaurus, le pied de page ou les styles par défaut. Celles-ci peuvent être ajoutées au répertoire <code>static</code> de la même manière que les autres <a href="/docs/fr/1.11.x/api-pages#using-static-assets">ressources statiques</a>. Autrement, elles peuvent être placées dans le répertoire <code>pages</code> et seront traitées en tant que telles au lieu d'être affichées à partir de React.</p>
|
||||
<p>Si vous souhaitez utiliser la feuille de style de Docusaurus, vous pouvez y accéder depuis <code>${baseUrl}css/main.css</code>. Si vous souhaitez utiliser des CSS séparés pour ces pages statiques, vous pouvez les empêcher d'être concaténés aux styles de Docusaurus en les ajoutant dans le champ <code>siteConfig.separateCss</code> dans <code>siteConfig.js</code>.</p>
|
||||
<blockquote>
|
||||
<p>You can set the <a href="/docs/fr/1.11.x/site-config#optional-fields"><code>$wrapPagesHTML</code> site config option</a> in order to wrap raw HTML fragments with the Docusaurus site styling, header and footer.</p>
|
||||
<p>Vous pouvez définir l'<a href="/docs/fr/1.11.x/site-config#optional-fields">option de configuration du site <code>$wrapPagesHTML</code></a> afin d'encapsuler les fragments HTML bruts avec le style du site Docusaurus, l'entête et le pied de page.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-your-site-footer"></a><a href="#customizing-your-site-footer" 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>Customizing Your Site Footer</h2>
|
||||
<p>Starting from the example <code>core/Footer.js</code> file that was <a href="/docs/fr/1.11.x/site-creation">created</a> when you ran the <a href="/docs/fr/1.11.x/installation">Docusaurus initialization script</a>, edit the footer to include any links to pages on your site or other sites that you wish to have.</p>
|
||||
<p>The example provided has three columns with a footer image on the left and Facebook's open source logo and copyright at the bottom. If your project is not a Facebook open source project, remove the logo and copyright. Otherwise, feel free to get creative with your footer and make it look however you'd like!</p>
|
||||
<p>Some suggestions for links you may want to provide: documentation, API, Twitter, Discord, Facebook groups, Stack Overflow, GitHub, etc.</p>
|
||||
<p>Your footer will automatically get applied to all pages on your site, including docs and blog posts. The sole exception to this is any static HTML pages you include.</p>
|
||||
<p>If you do not want a footer for your site, change the <code>render</code> function of <code>core/Footer.js</code> to return <code>null</code>. e.g.,</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-du-pied-de-page-de-votre-site"></a><a href="#personnalisation-du-pied-de-page-de-votre-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>Personnalisation du pied de page de votre site</h2>
|
||||
<p>À partir de l'exemple du fichier <code>core/Footer.js</code> qui a été <a href="/docs/fr/1.11.x/site-creation">créé</a> lorsque vous avez exécuté le <a href="/docs/fr/1.11.x/installation">script d'initialisation Docusaurus</a>, éditez le pied de page pour inclure tous les liens vers des pages de votre site ou d'autres sites que vous souhaitez avoir.</p>
|
||||
<p>L'exemple fourni a trois colonnes avec une image de pied de page à gauche et le logo open source de Facebook et les droits d'auteur en bas. Si votre projet n'est pas un projet open source Facebook, supprimez le logo et les droits d'auteur. Sinon, n'hésitez pas à faire preuve de créativité avec votre pied de page et à lui donner un aspect que vous aimeriez !</p>
|
||||
<p>Quelques suggestions pour les liens que vous pouvez fournir : documentation, API, Twitter, Discord, groupes Facebook, Stack Overflow, GitHub, etc.</p>
|
||||
<p>Votre pied de page sera automatiquement appliqué à toutes les pages de votre site, y compris les docs et les articles du blog. La seule exception à cela, c'est toute page HTML statique que vous incluez.</p>
|
||||
<p>Si vous ne voulez pas de pied de page pour votre site, changez la fonction <code>render</code> de <code>core/Footer.js</code> pour retourner <code>null</code>. Par exemple :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token keyword">const</span> React <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'react'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
|
||||
|
||||
<span class="token keyword">class</span> <span class="token class-name">Footer</span> <span class="token keyword">extends</span> <span class="token class-name">React<span class="token punctuation">.</span>Component</span> <span class="token punctuation">{</span>
|
||||
|
|
@ -128,7 +128,7 @@
|
|||
|
||||
module<span class="token punctuation">.</span>exports <span class="token operator">=</span> Footer<span class="token punctuation">;</span>
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/adding-blog"><span class="arrow-prev">← </span><span>Ajouter un blog</span></a><a class="docs-next button" href="/docs/fr/1.11.x/search"><span>Activation de la recherche</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#customizing-your-home-page">Customizing Your Home Page</a></li><li><a href="#adding-other-custom-pages">Adding Other Custom Pages</a></li><li><a href="#adding-static-pages">Adding Static Pages</a></li><li><a href="#customizing-your-site-footer">Customizing Your Site Footer</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/adding-blog"><span class="arrow-prev">← </span><span>Ajouter un blog</span></a><a class="docs-next button" href="/docs/fr/1.11.x/search"><span>Activation de la recherche</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#personnalisation-de-votre-page-daccueil">Personnalisation de votre page d'accueil</a></li><li><a href="#ajouter-dautres-pages-personnalisées">Ajouter d'autres pages personnalisées</a></li><li><a href="#ajouter-de-pages-statiques">Ajouter de pages statiques</a></li><li><a href="#personnalisation-du-pied-de-page-de-votre-site">Personnalisation du pied de page de votre site</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Custom Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding `.js` files to the `website/pages` directory. These files are [React](https://reactjs.org/) components and the `render()` is called to create them, backed by CSS classes, etc."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Custom Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding `.js` files to the `website/pages` directory. These files are [React](https://reactjs.org/) components and the `render()` is called to create them, backed by CSS classes, etc."/><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>Custom Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers `.js` au répertoire `website/pages`. Ces fichiers sont des composants [React](https://reactjs.org/) et le `render()` est appelé pour les créer, avec le renfort des classes CSS, etc."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Custom Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers `.js` au répertoire `website/pages`. Ces fichiers sont des composants [React](https://reactjs.org/) et le `render()` est appelé pour les créer, avec le renfort des classes CSS, etc."/><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,12 +80,12 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Custom Pages</h1></header><article><div><span><p>You can add pages to your site that are not part of the standard docs or blog markdown files. You can do this by adding <code>.js</code> files to the <code>website/pages</code> directory. These files are <a href="https://reactjs.org/">React</a> components and the <code>render()</code> is called to create them, backed by CSS classes, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-your-home-page"></a><a href="#customizing-your-home-page" 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>Customizing Your Home Page</h2>
|
||||
<p>The easiest way to get started customizing your home page is to use the example site that was <a href="/docs/fr/1.11.x/site-creation">created</a> when you ran the <a href="/docs/fr/1.11.x/installation">Docusaurus initialization script</a>.</p>
|
||||
<p>You can <a href="/docs/fr/1.11.x/site-preparation#verifying-installation">start</a> your local server and go to <code>http://localhost:3000</code> to see what the example home page looks like. From there, edit the <code>website/pages/en/index.js</code> file and its various components to use the images and text you want for your project.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-other-custom-pages"></a><a href="#adding-other-custom-pages" 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>Adding Other Custom Pages</h2>
|
||||
<p>Docusaurus provides some helpful example pages in the <code>website/pages/en</code> directory, including <code>index.js</code>, <code>users.js</code>, and <code>help.js</code>. These are good examples to showcase how to create a custom page for Docusaurus.</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">Custom Pages</h1></header><article><div><span><p>Vous pouvez ajouter à votre site des pages qui ne font ni partie des documents standard ni des fichiers markdown du blog. Vous pouvez le faire en ajoutant des fichiers <code>.js</code> au répertoire <code>website/pages</code>. Ces fichiers sont des composants <a href="https://reactjs.org/">React</a> et le <code>render()</code> est appelé pour les créer, avec le renfort des classes CSS, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-de-votre-page-daccueil"></a><a href="#personnalisation-de-votre-page-daccueil" 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 de votre page d'accueil</h2>
|
||||
<p>La façon la plus simple de commencer à personnaliser votre page d'accueil est d'utiliser le site d'exemple qui a été <a href="/docs/fr/1.11.x/site-creation">créé</a> lorsque vous avez exécuté le <a href="/docs/fr/1.11.x/installation">script d'initialisation Docusaurus</a>.</p>
|
||||
<p>Vous pouvez <a href="/docs/fr/1.11.x/site-preparation#verifying-installation">démarrer</a> votre serveur local et aller à l'adresse <code>http://localhost:3000</code> pour voir à quoi ressemble la page d'accueil d'exemple. À partir de là, éditez le fichier <code>website/pages/fr/index.js</code> et ses divers composants pour utiliser les images et le texte que vous voulez pour votre projet.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-dautres-pages-personnalisées"></a><a href="#ajouter-dautres-pages-personnalisées" 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>Ajouter d'autres pages personnalisées</h2>
|
||||
<p>Docusaurus fournit quelques exemples de pages utiles dans le répertoire <code>website/pages/en</code>, y compris <code>index.js</code>, <code>users.js</code> et <code>help.js</code>. Ce sont de bons exemples pour montrer comment créer une page personnalisée pour Docusaurus.</p>
|
||||
<pre><code class="hljs css language-bash">root-directory
|
||||
├── docs
|
||||
└── website
|
||||
|
|
@ -102,22 +102,22 @@
|
|||
├── siteConfig.js
|
||||
└── static
|
||||
</code></pre>
|
||||
<p>You are also free to write your own pages. It is strongly suggested that you at least have an index page, but none of the pages provided are mandatory to include in your site. More information on how to use the provided components or include your own can be found <a href="/docs/fr/1.11.x/api-pages">here</a>. Information on how to link to your different pages in the header navigation bar can be found <a href="/docs/fr/1.11.x/navigation">here</a>.</p>
|
||||
<p>Vous êtes également libre d'écrire vos propres pages. Il est fortement conseillé d'avoir au moins une page d'index, mais aucune des pages fournies n'est à inclure obligatoirement dans votre site. Plus d'informations sur la façon d'utiliser les composants fournis ou d'inclure vos propres composants peuvent être trouvées <a href="/docs/fr/1.11.x/api-pages">ici</a>. Des informations sur la façon de créer un lien vers vos différentes pages dans la barre de navigation d'entête peuvent être trouvées <a href="/docs/fr/1.11.x/navigation">ici</a>.</p>
|
||||
<blockquote>
|
||||
<p>If you want your page to show up in your navigation header, you will need to update <code>siteConfig.js</code> to add to the <code>headerLinks</code> element. e.g., <code>{ page: 'about-slash', label: 'About/' }</code>,</p>
|
||||
<p>Si vous voulez que votre page apparaisse dans votre entête de navigation, vous devrez mettre à jour <code>siteConfig.js</code> pour l'ajouter à l'élément <code>headerLinks</code>. Par exemple, <code>{ page: 'about-slash', label: 'About/' }</code>,</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-static-pages"></a><a href="#adding-static-pages" 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>Adding Static Pages</h2>
|
||||
<p>Static <code>.html</code> files can also be used, but they will not include Docusaurus' header, footer, or styles by default. These can be added to the <code>static</code> directory in the same way as other <a href="/docs/fr/1.11.x/api-pages#using-static-assets">static assets</a>. Alternatively, they can be placed in the <code>pages</code> directory and would be served as-is instead of being rendered from React.</p>
|
||||
<p>If you wish to use Docusaurus' stylesheet, you can access it at <code>${baseUrl}css/main.css</code>. If you wish to use separate CSS for these static pages, you can exclude them from being concatenated to Docusaurus' styles by adding them into the <code>siteConfig.separateCss</code> field in <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-de-pages-statiques"></a><a href="#ajouter-de-pages-statiques" 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>Ajouter de pages statiques</h2>
|
||||
<p>Les fichiers statiques <code>.html</code> peuvent également être utilisés, mais ils n'incluront pas l'entête de Docusaurus, le pied de page ou les styles par défaut. Celles-ci peuvent être ajoutées au répertoire <code>static</code> de la même manière que les autres <a href="/docs/fr/1.11.x/api-pages#using-static-assets">ressources statiques</a>. Autrement, elles peuvent être placées dans le répertoire <code>pages</code> et seront traitées en tant que telles au lieu d'être affichées à partir de React.</p>
|
||||
<p>Si vous souhaitez utiliser la feuille de style de Docusaurus, vous pouvez y accéder depuis <code>${baseUrl}css/main.css</code>. Si vous souhaitez utiliser des CSS séparés pour ces pages statiques, vous pouvez les empêcher d'être concaténés aux styles de Docusaurus en les ajoutant dans le champ <code>siteConfig.separateCss</code> dans <code>siteConfig.js</code>.</p>
|
||||
<blockquote>
|
||||
<p>You can set the <a href="/docs/fr/1.11.x/site-config#optional-fields"><code>$wrapPagesHTML</code> site config option</a> in order to wrap raw HTML fragments with the Docusaurus site styling, header and footer.</p>
|
||||
<p>Vous pouvez définir l'<a href="/docs/fr/1.11.x/site-config#optional-fields">option de configuration du site <code>$wrapPagesHTML</code></a> afin d'encapsuler les fragments HTML bruts avec le style du site Docusaurus, l'entête et le pied de page.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-your-site-footer"></a><a href="#customizing-your-site-footer" 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>Customizing Your Site Footer</h2>
|
||||
<p>Starting from the example <code>core/Footer.js</code> file that was <a href="/docs/fr/1.11.x/site-creation">created</a> when you ran the <a href="/docs/fr/1.11.x/installation">Docusaurus initialization script</a>, edit the footer to include any links to pages on your site or other sites that you wish to have.</p>
|
||||
<p>The example provided has three columns with a footer image on the left and Facebook's open source logo and copyright at the bottom. If your project is not a Facebook open source project, remove the logo and copyright. Otherwise, feel free to get creative with your footer and make it look however you'd like!</p>
|
||||
<p>Some suggestions for links you may want to provide: documentation, API, Twitter, Discord, Facebook groups, Stack Overflow, GitHub, etc.</p>
|
||||
<p>Your footer will automatically get applied to all pages on your site, including docs and blog posts. The sole exception to this is any static HTML pages you include.</p>
|
||||
<p>If you do not want a footer for your site, change the <code>render</code> function of <code>core/Footer.js</code> to return <code>null</code>. e.g.,</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-du-pied-de-page-de-votre-site"></a><a href="#personnalisation-du-pied-de-page-de-votre-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>Personnalisation du pied de page de votre site</h2>
|
||||
<p>À partir de l'exemple du fichier <code>core/Footer.js</code> qui a été <a href="/docs/fr/1.11.x/site-creation">créé</a> lorsque vous avez exécuté le <a href="/docs/fr/1.11.x/installation">script d'initialisation Docusaurus</a>, éditez le pied de page pour inclure tous les liens vers des pages de votre site ou d'autres sites que vous souhaitez avoir.</p>
|
||||
<p>L'exemple fourni a trois colonnes avec une image de pied de page à gauche et le logo open source de Facebook et les droits d'auteur en bas. Si votre projet n'est pas un projet open source Facebook, supprimez le logo et les droits d'auteur. Sinon, n'hésitez pas à faire preuve de créativité avec votre pied de page et à lui donner un aspect que vous aimeriez !</p>
|
||||
<p>Quelques suggestions pour les liens que vous pouvez fournir : documentation, API, Twitter, Discord, groupes Facebook, Stack Overflow, GitHub, etc.</p>
|
||||
<p>Votre pied de page sera automatiquement appliqué à toutes les pages de votre site, y compris les docs et les articles du blog. La seule exception à cela, c'est toute page HTML statique que vous incluez.</p>
|
||||
<p>Si vous ne voulez pas de pied de page pour votre site, changez la fonction <code>render</code> de <code>core/Footer.js</code> pour retourner <code>null</code>. Par exemple :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token keyword">const</span> React <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'react'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
|
||||
|
||||
<span class="token keyword">class</span> <span class="token class-name">Footer</span> <span class="token keyword">extends</span> <span class="token class-name">React<span class="token punctuation">.</span>Component</span> <span class="token punctuation">{</span>
|
||||
|
|
@ -128,7 +128,7 @@
|
|||
|
||||
module<span class="token punctuation">.</span>exports <span class="token operator">=</span> Footer<span class="token punctuation">;</span>
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/adding-blog"><span class="arrow-prev">← </span><span>Ajouter un blog</span></a><a class="docs-next button" href="/docs/fr/1.11.x/search"><span>Activation de la recherche</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#customizing-your-home-page">Customizing Your Home Page</a></li><li><a href="#adding-other-custom-pages">Adding Other Custom Pages</a></li><li><a href="#adding-static-pages">Adding Static Pages</a></li><li><a href="#customizing-your-site-footer">Customizing Your Site Footer</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/adding-blog"><span class="arrow-prev">← </span><span>Ajouter un blog</span></a><a class="docs-next button" href="/docs/fr/1.11.x/search"><span>Activation de la recherche</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#personnalisation-de-votre-page-daccueil">Personnalisation de votre page d'accueil</a></li><li><a href="#ajouter-dautres-pages-personnalisées">Ajouter d'autres pages personnalisées</a></li><li><a href="#ajouter-de-pages-statiques">Ajouter de pages statiques</a></li><li><a href="#personnalisation-du-pied-de-page-de-votre-site">Personnalisation du pied de page de votre site</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -118,8 +118,8 @@
|
|||
<h3><a class="anchor" aria-hidden="true" id="publications-de-blog"></a><a href="#publications-de-blog" 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>Publications de blog</h3>
|
||||
<p>Les articles du blog suivent les entêtes de markdown qui sont encadrées par une ligne <code>---</code> de chaque coté:</p>
|
||||
<p><code>titre</code>: Le titre de cet article du blog.</p>
|
||||
<p><code>author</code>: L'auteur de cet article du blog. Si ce champ est omis, aucun nom d'auteur ne sera affiché.</p>
|
||||
<p><code>authorURL</code>: Un vers une page lorsqu'un utilisateur du site clique sur le nom de l'auteur. Si ce champ est omis, le nom de l'auteur ne sera lié à rien.</p>
|
||||
<p><code>author</code> : L'auteur de cet article du blog. Si ce champ est omis, aucun nom d'auteur ne sera affiché.</p>
|
||||
<p><code>authorURL</code> : Une page vers laquelle se connecter lorsqu'un utilisateur du site clique sur le nom de l'auteur. Si ce champ est omis, le nom de l'auteur ne sera lié à rien.</p>
|
||||
<p><code>authorFBID</code> : L'identifiant Facebook de l'auteur, utilisé uniquement pour obtenir la photo de profil de l'auteur à afficher avec l'article du blog. Si ce champ est omis, aucune image d’auteur ne sera affichée pour l'article du blog.</p>
|
||||
<p>Par exemple :</p>
|
||||
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
|
||||
|
|
|
|||
|
|
@ -118,8 +118,8 @@
|
|||
<h3><a class="anchor" aria-hidden="true" id="publications-de-blog"></a><a href="#publications-de-blog" 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>Publications de blog</h3>
|
||||
<p>Les articles du blog suivent les entêtes de markdown qui sont encadrées par une ligne <code>---</code> de chaque coté:</p>
|
||||
<p><code>titre</code>: Le titre de cet article du blog.</p>
|
||||
<p><code>author</code>: L'auteur de cet article du blog. Si ce champ est omis, aucun nom d'auteur ne sera affiché.</p>
|
||||
<p><code>authorURL</code>: Un vers une page lorsqu'un utilisateur du site clique sur le nom de l'auteur. Si ce champ est omis, le nom de l'auteur ne sera lié à rien.</p>
|
||||
<p><code>author</code> : L'auteur de cet article du blog. Si ce champ est omis, aucun nom d'auteur ne sera affiché.</p>
|
||||
<p><code>authorURL</code> : Une page vers laquelle se connecter lorsqu'un utilisateur du site clique sur le nom de l'auteur. Si ce champ est omis, le nom de l'auteur ne sera lié à rien.</p>
|
||||
<p><code>authorFBID</code> : L'identifiant Facebook de l'auteur, utilisé uniquement pour obtenir la photo de profil de l'auteur à afficher avec l'article du blog. Si ce champ est omis, aucune image d’auteur ne sera affichée pour l'article du blog.</p>
|
||||
<p>Par exemple :</p>
|
||||
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
|
||||
|
|
|
|||
|
|
@ -95,11 +95,11 @@
|
|||
</blockquote></li>
|
||||
<li><p>Exécutez le script d'installation de Docusaurus : <code>npx docusaurus-init</code>.</p>
|
||||
<blockquote>
|
||||
<p>Si vous n’avez pas node 8.2 + ou si vous préférez installer Docusaurus de manière globale, exécutez <code>yarn global add docusaurus-init</code> ou <code>npm install - global docusaurus-init</code>. Après, exécutez <code>docusaurus-init</code>.</p>
|
||||
<p>Si vous n’avez pas node 8.2 + ou si vous préférez installer Docusaurus de manière globale, exécutez <code>yarn global add docusaurus-init</code> ou <code>npm install --global docusaurus-init</code>. Après, exécutez <code>docusaurus-init</code>.</p>
|
||||
</blockquote></li>
|
||||
</ol>
|
||||
<h2><a class="anchor" aria-hidden="true" id="vérification-de-linstallation"></a><a href="#vérification-de-linstallation" 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>Vérification de l'installation</h2>
|
||||
<p>Ainsi que les répertoires et les fichiers déjà existants, votre répertoire racine contient maintenant une structure semblable à :</p>
|
||||
<p>Avec les répertoires et les fichiers déjà existants, votre répertoire racine contient maintenant une structure semblable à :</p>
|
||||
<pre><code class="hljs css language-bash">root-directory
|
||||
├── Dockerfile
|
||||
├── README.md
|
||||
|
|
@ -131,7 +131,7 @@
|
|||
<li><p><code>cd website</code></p></li>
|
||||
<li><p>Depuis le répertoire <code>website</code>, exécutez le serveur web local en utilisant <code>yarn start</code> ou <code>npm start</code>.</p></li>
|
||||
<li><p>Chargez le site d'exemple depuis l'adresse <a href="http://localhost:3000">http://localhost:3000</a> 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.</p>
|
||||
<p>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 <code>website</code> causeront une actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.</p></li>
|
||||
<p>Vous devriez voir le site d'exemple chargé dans votre navigateur Web. Il y a aussi un serveur LiveReload en cours d'exécution et toute modification apportée à la documentation et aux fichiers dans le répertoire <code>website</code> provoquera l'actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.</p></li>
|
||||
</ol>
|
||||
<p><img src="/img/getting-started-preparation-verify.png" alt=""></p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="lancement-du-serveur-derrière-un-proxy"></a><a href="#lancement-du-serveur-derrière-un-proxy" 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>Lancement du serveur derrière un proxy</h3>
|
||||
|
|
@ -141,7 +141,7 @@ yarn start (ou npm run start)
|
|||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="mettre-à-jour-votre-version-de-docusaurus"></a><a href="#mettre-à-jour-votre-version-de-docusaurus" 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>Mettre à jour votre version de Docusaurus</h2>
|
||||
<p>A tout moment, après avoir installé Docusaurus, vous pouvez vérifier votre version actuelle en allant dans le répertoire <code>website</code> et en écrivant <code>yarn outdated docusaurus</code> ou <code>npm outdated docusaurus</code>.</p>
|
||||
<p>Vous pourrez voir quelque chose comme ça:</p>
|
||||
<p>Vous verrez quelque chose comme ceci :</p>
|
||||
<pre><code class="hljs">$ yarn outdated
|
||||
Using globally installed version of Yarn
|
||||
yarn outdated v1.5.1
|
||||
|
|
@ -158,14 +158,14 @@ docusaurus 1.0.9 1.2.0 1.2.0 devDependencies https://github.com/facebook/doc
|
|||
<blockquote>
|
||||
<p>S'il n'y as pas de version visible sur la sortie de la commande <code>outdated</code>, vous êtes à jour.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez mettre à jour la <a href="https://www.npmjs.com/package/docusaurus">dernière version</a> de Docusaurus via:</p>
|
||||
<p>Vous pouvez mettre à jour la <a href="https://www.npmjs.com/package/docusaurus">dernière version</a> de Docusaurus via :</p>
|
||||
<pre><code class="hljs">yarn upgrade docusaurus --latest
|
||||
</code></pre>
|
||||
<p>ou</p>
|
||||
<pre><code class="hljs">npm update docusaurus
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>Si vous obtenez une erreur après la mise à jours, essayez de nettoyer votre cache Babel (généralement il se trouve dans un <a href="https://babeljs.io/docs/en/babel-register/#environment-variables">dossier temporaire</a>) ou de lancer le serveur Docusaurus (par exemple <code>yarn start</code> avec le paramètre d'environnement <code>BABEL_DISABLE_CACHE=1</code>.</p>
|
||||
<p>Si vous obtenez une erreur après la mise à jour, essayez de nettoyer votre cache Babel (généralement il se trouve dans un <a href="https://babeljs.io/docs/en/babel-register/#environment-variables">dossier temporaire</a>) ou lancer le serveur Docusaurus (par exemple <code>yarn start</code> avec le paramètre d'environnement <code>BABEL_DISABLE_CACHE=1</code>.</p>
|
||||
</blockquote>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.11.x/site-preparation"><span>Préparation du site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#installation-de-docusaurus">Installation de Docusaurus</a></li><li><a href="#vérification-de-linstallation">Vérification de l'installation</a></li><li><a href="#exécution-du-site-web-dexemple">Exécution du site web d'exemple</a><ul class="toc-headings"><li><a href="#lancement-du-serveur-derrière-un-proxy">Lancement du serveur derrière un proxy</a></li></ul></li><li><a href="#mettre-à-jour-votre-version-de-docusaurus">Mettre à jour votre version de Docusaurus</a></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="
|
||||
|
|
|
|||
|
|
@ -95,11 +95,11 @@
|
|||
</blockquote></li>
|
||||
<li><p>Exécutez le script d'installation de Docusaurus : <code>npx docusaurus-init</code>.</p>
|
||||
<blockquote>
|
||||
<p>Si vous n’avez pas node 8.2 + ou si vous préférez installer Docusaurus de manière globale, exécutez <code>yarn global add docusaurus-init</code> ou <code>npm install - global docusaurus-init</code>. Après, exécutez <code>docusaurus-init</code>.</p>
|
||||
<p>Si vous n’avez pas node 8.2 + ou si vous préférez installer Docusaurus de manière globale, exécutez <code>yarn global add docusaurus-init</code> ou <code>npm install --global docusaurus-init</code>. Après, exécutez <code>docusaurus-init</code>.</p>
|
||||
</blockquote></li>
|
||||
</ol>
|
||||
<h2><a class="anchor" aria-hidden="true" id="vérification-de-linstallation"></a><a href="#vérification-de-linstallation" 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>Vérification de l'installation</h2>
|
||||
<p>Ainsi que les répertoires et les fichiers déjà existants, votre répertoire racine contient maintenant une structure semblable à :</p>
|
||||
<p>Avec les répertoires et les fichiers déjà existants, votre répertoire racine contient maintenant une structure semblable à :</p>
|
||||
<pre><code class="hljs css language-bash">root-directory
|
||||
├── Dockerfile
|
||||
├── README.md
|
||||
|
|
@ -131,7 +131,7 @@
|
|||
<li><p><code>cd website</code></p></li>
|
||||
<li><p>Depuis le répertoire <code>website</code>, exécutez le serveur web local en utilisant <code>yarn start</code> ou <code>npm start</code>.</p></li>
|
||||
<li><p>Chargez le site d'exemple depuis l'adresse <a href="http://localhost:3000">http://localhost:3000</a> 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.</p>
|
||||
<p>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 <code>website</code> causeront une actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.</p></li>
|
||||
<p>Vous devriez voir le site d'exemple chargé dans votre navigateur Web. Il y a aussi un serveur LiveReload en cours d'exécution et toute modification apportée à la documentation et aux fichiers dans le répertoire <code>website</code> provoquera l'actualisation de la page. Une couleur de thème primaire et secondaire générée aléatoirement sera choisie pour vous.</p></li>
|
||||
</ol>
|
||||
<p><img src="/img/getting-started-preparation-verify.png" alt=""></p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="lancement-du-serveur-derrière-un-proxy"></a><a href="#lancement-du-serveur-derrière-un-proxy" 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>Lancement du serveur derrière un proxy</h3>
|
||||
|
|
@ -141,7 +141,7 @@ yarn start (ou npm run start)
|
|||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="mettre-à-jour-votre-version-de-docusaurus"></a><a href="#mettre-à-jour-votre-version-de-docusaurus" 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>Mettre à jour votre version de Docusaurus</h2>
|
||||
<p>A tout moment, après avoir installé Docusaurus, vous pouvez vérifier votre version actuelle en allant dans le répertoire <code>website</code> et en écrivant <code>yarn outdated docusaurus</code> ou <code>npm outdated docusaurus</code>.</p>
|
||||
<p>Vous pourrez voir quelque chose comme ça:</p>
|
||||
<p>Vous verrez quelque chose comme ceci :</p>
|
||||
<pre><code class="hljs">$ yarn outdated
|
||||
Using globally installed version of Yarn
|
||||
yarn outdated v1.5.1
|
||||
|
|
@ -158,14 +158,14 @@ docusaurus 1.0.9 1.2.0 1.2.0 devDependencies https://github.com/facebook/doc
|
|||
<blockquote>
|
||||
<p>S'il n'y as pas de version visible sur la sortie de la commande <code>outdated</code>, vous êtes à jour.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez mettre à jour la <a href="https://www.npmjs.com/package/docusaurus">dernière version</a> de Docusaurus via:</p>
|
||||
<p>Vous pouvez mettre à jour la <a href="https://www.npmjs.com/package/docusaurus">dernière version</a> de Docusaurus via :</p>
|
||||
<pre><code class="hljs">yarn upgrade docusaurus --latest
|
||||
</code></pre>
|
||||
<p>ou</p>
|
||||
<pre><code class="hljs">npm update docusaurus
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>Si vous obtenez une erreur après la mise à jours, essayez de nettoyer votre cache Babel (généralement il se trouve dans un <a href="https://babeljs.io/docs/en/babel-register/#environment-variables">dossier temporaire</a>) ou de lancer le serveur Docusaurus (par exemple <code>yarn start</code> avec le paramètre d'environnement <code>BABEL_DISABLE_CACHE=1</code>.</p>
|
||||
<p>Si vous obtenez une erreur après la mise à jour, essayez de nettoyer votre cache Babel (généralement il se trouve dans un <a href="https://babeljs.io/docs/en/babel-register/#environment-variables">dossier temporaire</a>) ou lancer le serveur Docusaurus (par exemple <code>yarn start</code> avec le paramètre d'environnement <code>BABEL_DISABLE_CACHE=1</code>.</p>
|
||||
</blockquote>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.11.x/site-preparation"><span>Préparation du site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#installation-de-docusaurus">Installation de Docusaurus</a></li><li><a href="#vérification-de-linstallation">Vérification de l'installation</a></li><li><a href="#exécution-du-site-web-dexemple">Exécution du site web d'exemple</a><ul class="toc-headings"><li><a href="#lancement-du-serveur-derrière-un-proxy">Lancement du serveur derrière un proxy</a></li></ul></li><li><a href="#mettre-à-jour-votre-version-de-docusaurus">Mettre à jour votre version de Docusaurus</a></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="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Navigation and Sidebars · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Referencing Site Documents"/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Navigation and Sidebars · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="## Referencing Site Documents"/><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>Navigation and Sidebars · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Faire référence aux documents du site"/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Navigation and Sidebars · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="## Faire référence aux documents du site"/><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,34 +80,34 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Navigation and Sidebars</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="referencing-site-documents"></a><a href="#referencing-site-documents" 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>Referencing Site Documents</h2>
|
||||
<p>If you want to reference another document in your <code>docs</code> directory (or the location you set via the <a href="https://docusaurus.io/docs/en/site-config.html#optional-fields">optional <code>customDocsPath</code></a> path site configuration option), then you just use the name of the document you want to reference.</p>
|
||||
<p>For example, if you are in <code>doc2.md</code> and you want to reference <code>doc1.md</code>:</p>
|
||||
<pre><code class="hljs css language-md">I am referencing a [<span class="hljs-string">document</span>](<span class="hljs-link">doc1.md</span>).
|
||||
</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">Navigation and Sidebars</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="faire-référence-aux-documents-du-site"></a><a href="#faire-référence-aux-documents-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>Faire référence aux documents du site</h2>
|
||||
<p>Si vous voulez référencer un autre document dans votre dossier <code>docs</code> (ou l'emplacement que vous avez défini via le chemin <a href="https://docusaurus.io/docs/en/site-config.html#optional-fields">optionnel <code>customDocsPath</code></a> de la configuration du site), alors utilisez simplement le nom du document que vous voulez référencer.</p>
|
||||
<p>Par exemple, si vous êtes dans <code>doc2.md</code> et que vous voulez faire référence à <code>doc1.md</code>:</p>
|
||||
<pre><code class="hljs css language-md">Je fais référence à un [<span class="hljs-string">document</span>](<span class="hljs-link">doc1.md</span>).
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-documents-are-linked"></a><a href="#how-documents-are-linked" 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>How Documents are Linked</h2>
|
||||
<p>New markdown files within <code>docs</code> will show up as pages on the website. Links to those documents are created first by using the <code>id</code> in the header of each document. If there is no <code>id</code> field, then the name of the file will serve as the link name.</p>
|
||||
<p>For example, creating an empty file such as <code>docs/getting-started.md</code> will enable the new page URL as <code>/docs/getting-started.html</code>.</p>
|
||||
<p>Suppose you add this to your document:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-les-documents-sont-liés"></a><a href="#comment-les-documents-sont-liés" 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>Comment les documents sont liés</h2>
|
||||
<p>Les nouveaux fichiers markdown dans <code>docs</code> apparaîtront sous forme de pages sur le site web. Les liens vers ces documents sont créés d'abord en utilisant l'<code>id</code> dans l'entête de chaque document. S'il n'y a pas de champ <code>id</code>, alors le nom du fichier servira de nom de lien.</p>
|
||||
<p>Par exemple, la création d'un fichier vide tel que <code>docs/getting-started.md</code> activera l'URL de la nouvelle page avec <code>/docs/getting-started.html</code>.</p>
|
||||
<p>Supposons que vous ajoutiez ceci à votre document :</p>
|
||||
<pre><code class="hljs css language-yaml"><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>
|
||||
<p>If you set the <code>id</code> field in the markdown header of the file, the doc will then be accessed from a URL of the form <code>/docs/intro.html</code>.</p>
|
||||
<p>Si vous définissez le champ <code>id</code> dans l'entête du fichier markdown, le doc sera alors accédé à partir d'une URL de la forme <code>/docs/intro.html</code>.</p>
|
||||
<blockquote>
|
||||
<p>You need an <code>id</code> field to be able to add the document to the sidebar.</p>
|
||||
<p>Vous avez besoin d'un champ <code>id</code> pour pouvoir ajouter le document à la barre latérale.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-documents-to-a-sidebar"></a><a href="#adding-documents-to-a-sidebar" 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>Adding Documents to a Sidebar</h2>
|
||||
<p>Many times, you will want to add a document to a sidebar that will be associated with one of the headers in the top navigation bar of the website. The most common sidebar, and the one that comes installed when Docusaurus is initialized, is the <code>docs</code> sidebar.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-des-documents-à-une-barre-latérale"></a><a href="#ajouter-des-documents-à-une-barre-latérale" 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>Ajouter des documents à une barre latérale</h2>
|
||||
<p>Souvent, vous voudrez ajouter un document à une barre latérale qui sera associée à l'un des entêtes dans la barre de navigation supérieure du site web. La barre latérale la plus courante, et celle qui est installée lorsque Docusaurus est initialisé, c'est la barre latérale <code>docs</code>.</p>
|
||||
<blockquote>
|
||||
<p>"docs" is just a name. It has no inherent meaning. You can change it as you wish.</p>
|
||||
<p>« docs » est juste un nom. Il n'a pas de signification particulière. Vous pouvez le modifier comme vous le souhaitez.</p>
|
||||
</blockquote>
|
||||
<p>You configure the contents of the sidebar, and the order of its documents, in the <code>website/sidebars.json</code> file.</p>
|
||||
<p>Vous configurez le contenu de la barre latérale et l'ordre de ses documents, dans le fichier <code>website/sidebars.json</code>.</p>
|
||||
<blockquote>
|
||||
<p>Until you add your document to <code>website/sidebars.json</code>, they will only be accessible via a direct URL. The doc will not show up in any sidebar.</p>
|
||||
<p>Jusqu'à ce que vous ajoutiez votre document à <code>website/sidebars.json</code>, il ne sera accessible que par une URL directe. Le doc n'apparaîtra dans aucune barre latérale.</p>
|
||||
</blockquote>
|
||||
<p>Within <code>sidebars.json</code>, add the <code>id</code> you used in the document header to existing sidebar/category. In the below case, <code>docs</code> is the name of the sidebar and <code>Getting Started</code> is a category within the sidebar.</p>
|
||||
<p>Dans <code>sidebars.json</code>, ajoutez l'<code>id</code> que vous avez utilisé dans l'entête du document à la barre latérale/catégorie existante. Dans le cas ci-dessous, <code>docs</code> est le nom de la barre latérale et <code>Getting Started</code> est une catégorie dans la barre latérale.</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"Getting Started"</span>: [
|
||||
|
|
@ -118,29 +118,29 @@
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>Or you can create a new category within the sidebar:</p>
|
||||
<p>Ou vous pouvez créer une nouvelle catégorie dans la barre latérale :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"My New Sidebar Category"</span>: [
|
||||
<span class="hljs-string">"Ma nouvelle catégorie de la barre latérale"</span>: [
|
||||
<span class="hljs-string">"getting-started"</span>
|
||||
],
|
||||
...
|
||||
...
|
||||
},
|
||||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>However, for a document located in a docs subdirectory like below:</p>
|
||||
<p>Cependant, pour un document situé dans un sous-répertoire de docs comme ci-dessous :</p>
|
||||
<pre><code class="hljs css language-bash">docs
|
||||
└── dir1
|
||||
└── getting-started.md
|
||||
</code></pre>
|
||||
<p>You should provide <code>directory/id</code> instead of <code>id</code> in <code>sidebars.json</code>.</p>
|
||||
<p>Vous devez fournir <code>le_répertoire/id</code> au lieu d'<code>id</code> dans <code>sidebars.json</code>.</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"My New Sidebar Category"</span>: [
|
||||
<span class="hljs-string">"Ma nouvelle catégorie de la barre latérale"</span>: [
|
||||
<span class="hljs-string">"dir1/getting-started"</span>
|
||||
],
|
||||
...
|
||||
...
|
||||
},
|
||||
...
|
||||
}
|
||||
|
|
@ -291,7 +291,7 @@ The above will generate:
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/search"><span class="arrow-prev">← </span><span>Activation de la recherche</span></a><a class="docs-next button" href="/docs/fr/1.11.x/translation"><span>Traductions & Localisation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#referencing-site-documents">Referencing Site Documents</a></li><li><a href="#how-documents-are-linked">How Documents are Linked</a></li><li><a href="#adding-documents-to-a-sidebar">Adding Documents to a Sidebar</a><ul class="toc-headings"><li><a href="#adding-subcategories">Adding Subcategories</a></li><li><a href="#adding-new-sidebars">Adding New Sidebars</a></li></ul></li><li><a href="#additions-to-the-site-navigation-bar">Additions to the Site Navigation Bar</a><ul class="toc-headings"><li><a href="#adding-documents">Adding Documents</a></li><li><a href="#adding-custom-pages">Adding Custom Pages</a></li><li><a href="#adding-external-links">Adding External Links</a></li></ul></li><li><a href="#site-navigation-bar-positioning">Site Navigation Bar Positioning</a><ul class="toc-headings"><li><a href="#search">Search</a></li><li><a href="#languages-dropdown">Languages Dropdown</a></li></ul></li><li><a href="#active-links-in-site-navigation-bar">Active Links In Site Navigation Bar</a></li><li><a href="#secondary-on-page-navigation">Secondary On-Page Navigation</a></li><li><a href="#collapsible-categories">Collapsible Categories</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/search"><span class="arrow-prev">← </span><span>Activation de la recherche</span></a><a class="docs-next button" href="/docs/fr/1.11.x/translation"><span>Traductions & Localisation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#faire-référence-aux-documents-du-site">Faire référence aux documents du site</a></li><li><a href="#comment-les-documents-sont-liés">Comment les documents sont liés</a></li><li><a href="#ajouter-des-documents-à-une-barre-latérale">Ajouter des documents à une barre latérale</a><ul class="toc-headings"><li><a href="#adding-subcategories">Adding Subcategories</a></li><li><a href="#adding-new-sidebars">Adding New Sidebars</a></li></ul></li><li><a href="#additions-to-the-site-navigation-bar">Additions to the Site Navigation Bar</a><ul class="toc-headings"><li><a href="#adding-documents">Adding Documents</a></li><li><a href="#adding-custom-pages">Adding Custom Pages</a></li><li><a href="#adding-external-links">Adding External Links</a></li></ul></li><li><a href="#site-navigation-bar-positioning">Site Navigation Bar Positioning</a><ul class="toc-headings"><li><a href="#search">Search</a></li><li><a href="#languages-dropdown">Languages Dropdown</a></li></ul></li><li><a href="#active-links-in-site-navigation-bar">Active Links In Site Navigation Bar</a></li><li><a href="#secondary-on-page-navigation">Secondary On-Page Navigation</a></li><li><a href="#collapsible-categories">Collapsible Categories</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Navigation and Sidebars · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Referencing Site Documents"/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Navigation and Sidebars · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="## Referencing Site Documents"/><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>Navigation and Sidebars · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="## Faire référence aux documents du site"/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Navigation and Sidebars · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="## Faire référence aux documents du site"/><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,34 +80,34 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Navigation and Sidebars</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="referencing-site-documents"></a><a href="#referencing-site-documents" 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>Referencing Site Documents</h2>
|
||||
<p>If you want to reference another document in your <code>docs</code> directory (or the location you set via the <a href="https://docusaurus.io/docs/en/site-config.html#optional-fields">optional <code>customDocsPath</code></a> path site configuration option), then you just use the name of the document you want to reference.</p>
|
||||
<p>For example, if you are in <code>doc2.md</code> and you want to reference <code>doc1.md</code>:</p>
|
||||
<pre><code class="hljs css language-md">I am referencing a [<span class="hljs-string">document</span>](<span class="hljs-link">doc1.md</span>).
|
||||
</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">Navigation and Sidebars</h1></header><article><div><span><h2><a class="anchor" aria-hidden="true" id="faire-référence-aux-documents-du-site"></a><a href="#faire-référence-aux-documents-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>Faire référence aux documents du site</h2>
|
||||
<p>Si vous voulez référencer un autre document dans votre dossier <code>docs</code> (ou l'emplacement que vous avez défini via le chemin <a href="https://docusaurus.io/docs/en/site-config.html#optional-fields">optionnel <code>customDocsPath</code></a> de la configuration du site), alors utilisez simplement le nom du document que vous voulez référencer.</p>
|
||||
<p>Par exemple, si vous êtes dans <code>doc2.md</code> et que vous voulez faire référence à <code>doc1.md</code>:</p>
|
||||
<pre><code class="hljs css language-md">Je fais référence à un [<span class="hljs-string">document</span>](<span class="hljs-link">doc1.md</span>).
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-documents-are-linked"></a><a href="#how-documents-are-linked" 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>How Documents are Linked</h2>
|
||||
<p>New markdown files within <code>docs</code> will show up as pages on the website. Links to those documents are created first by using the <code>id</code> in the header of each document. If there is no <code>id</code> field, then the name of the file will serve as the link name.</p>
|
||||
<p>For example, creating an empty file such as <code>docs/getting-started.md</code> will enable the new page URL as <code>/docs/getting-started.html</code>.</p>
|
||||
<p>Suppose you add this to your document:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-les-documents-sont-liés"></a><a href="#comment-les-documents-sont-liés" 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>Comment les documents sont liés</h2>
|
||||
<p>Les nouveaux fichiers markdown dans <code>docs</code> apparaîtront sous forme de pages sur le site web. Les liens vers ces documents sont créés d'abord en utilisant l'<code>id</code> dans l'entête de chaque document. S'il n'y a pas de champ <code>id</code>, alors le nom du fichier servira de nom de lien.</p>
|
||||
<p>Par exemple, la création d'un fichier vide tel que <code>docs/getting-started.md</code> activera l'URL de la nouvelle page avec <code>/docs/getting-started.html</code>.</p>
|
||||
<p>Supposons que vous ajoutiez ceci à votre document :</p>
|
||||
<pre><code class="hljs css language-yaml"><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>
|
||||
<p>If you set the <code>id</code> field in the markdown header of the file, the doc will then be accessed from a URL of the form <code>/docs/intro.html</code>.</p>
|
||||
<p>Si vous définissez le champ <code>id</code> dans l'entête du fichier markdown, le doc sera alors accédé à partir d'une URL de la forme <code>/docs/intro.html</code>.</p>
|
||||
<blockquote>
|
||||
<p>You need an <code>id</code> field to be able to add the document to the sidebar.</p>
|
||||
<p>Vous avez besoin d'un champ <code>id</code> pour pouvoir ajouter le document à la barre latérale.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="adding-documents-to-a-sidebar"></a><a href="#adding-documents-to-a-sidebar" 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>Adding Documents to a Sidebar</h2>
|
||||
<p>Many times, you will want to add a document to a sidebar that will be associated with one of the headers in the top navigation bar of the website. The most common sidebar, and the one that comes installed when Docusaurus is initialized, is the <code>docs</code> sidebar.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="ajouter-des-documents-à-une-barre-latérale"></a><a href="#ajouter-des-documents-à-une-barre-latérale" 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>Ajouter des documents à une barre latérale</h2>
|
||||
<p>Souvent, vous voudrez ajouter un document à une barre latérale qui sera associée à l'un des entêtes dans la barre de navigation supérieure du site web. La barre latérale la plus courante, et celle qui est installée lorsque Docusaurus est initialisé, c'est la barre latérale <code>docs</code>.</p>
|
||||
<blockquote>
|
||||
<p>"docs" is just a name. It has no inherent meaning. You can change it as you wish.</p>
|
||||
<p>« docs » est juste un nom. Il n'a pas de signification particulière. Vous pouvez le modifier comme vous le souhaitez.</p>
|
||||
</blockquote>
|
||||
<p>You configure the contents of the sidebar, and the order of its documents, in the <code>website/sidebars.json</code> file.</p>
|
||||
<p>Vous configurez le contenu de la barre latérale et l'ordre de ses documents, dans le fichier <code>website/sidebars.json</code>.</p>
|
||||
<blockquote>
|
||||
<p>Until you add your document to <code>website/sidebars.json</code>, they will only be accessible via a direct URL. The doc will not show up in any sidebar.</p>
|
||||
<p>Jusqu'à ce que vous ajoutiez votre document à <code>website/sidebars.json</code>, il ne sera accessible que par une URL directe. Le doc n'apparaîtra dans aucune barre latérale.</p>
|
||||
</blockquote>
|
||||
<p>Within <code>sidebars.json</code>, add the <code>id</code> you used in the document header to existing sidebar/category. In the below case, <code>docs</code> is the name of the sidebar and <code>Getting Started</code> is a category within the sidebar.</p>
|
||||
<p>Dans <code>sidebars.json</code>, ajoutez l'<code>id</code> que vous avez utilisé dans l'entête du document à la barre latérale/catégorie existante. Dans le cas ci-dessous, <code>docs</code> est le nom de la barre latérale et <code>Getting Started</code> est une catégorie dans la barre latérale.</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"Getting Started"</span>: [
|
||||
|
|
@ -118,29 +118,29 @@
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>Or you can create a new category within the sidebar:</p>
|
||||
<p>Ou vous pouvez créer une nouvelle catégorie dans la barre latérale :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"My New Sidebar Category"</span>: [
|
||||
<span class="hljs-string">"Ma nouvelle catégorie de la barre latérale"</span>: [
|
||||
<span class="hljs-string">"getting-started"</span>
|
||||
],
|
||||
...
|
||||
...
|
||||
},
|
||||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>However, for a document located in a docs subdirectory like below:</p>
|
||||
<p>Cependant, pour un document situé dans un sous-répertoire de docs comme ci-dessous :</p>
|
||||
<pre><code class="hljs css language-bash">docs
|
||||
└── dir1
|
||||
└── getting-started.md
|
||||
</code></pre>
|
||||
<p>You should provide <code>directory/id</code> instead of <code>id</code> in <code>sidebars.json</code>.</p>
|
||||
<p>Vous devez fournir <code>le_répertoire/id</code> au lieu d'<code>id</code> dans <code>sidebars.json</code>.</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
<span class="hljs-string">"docs"</span>: {
|
||||
<span class="hljs-string">"My New Sidebar Category"</span>: [
|
||||
<span class="hljs-string">"Ma nouvelle catégorie de la barre latérale"</span>: [
|
||||
<span class="hljs-string">"dir1/getting-started"</span>
|
||||
],
|
||||
...
|
||||
...
|
||||
},
|
||||
...
|
||||
}
|
||||
|
|
@ -291,7 +291,7 @@ The above will generate:
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/search"><span class="arrow-prev">← </span><span>Activation de la recherche</span></a><a class="docs-next button" href="/docs/fr/1.11.x/translation"><span>Traductions & Localisation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#referencing-site-documents">Referencing Site Documents</a></li><li><a href="#how-documents-are-linked">How Documents are Linked</a></li><li><a href="#adding-documents-to-a-sidebar">Adding Documents to a Sidebar</a><ul class="toc-headings"><li><a href="#adding-subcategories">Adding Subcategories</a></li><li><a href="#adding-new-sidebars">Adding New Sidebars</a></li></ul></li><li><a href="#additions-to-the-site-navigation-bar">Additions to the Site Navigation Bar</a><ul class="toc-headings"><li><a href="#adding-documents">Adding Documents</a></li><li><a href="#adding-custom-pages">Adding Custom Pages</a></li><li><a href="#adding-external-links">Adding External Links</a></li></ul></li><li><a href="#site-navigation-bar-positioning">Site Navigation Bar Positioning</a><ul class="toc-headings"><li><a href="#search">Search</a></li><li><a href="#languages-dropdown">Languages Dropdown</a></li></ul></li><li><a href="#active-links-in-site-navigation-bar">Active Links In Site Navigation Bar</a></li><li><a href="#secondary-on-page-navigation">Secondary On-Page Navigation</a></li><li><a href="#collapsible-categories">Collapsible Categories</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/search"><span class="arrow-prev">← </span><span>Activation de la recherche</span></a><a class="docs-next button" href="/docs/fr/1.11.x/translation"><span>Traductions & Localisation</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#faire-référence-aux-documents-du-site">Faire référence aux documents du site</a></li><li><a href="#comment-les-documents-sont-liés">Comment les documents sont liés</a></li><li><a href="#ajouter-des-documents-à-une-barre-latérale">Ajouter des documents à une barre latérale</a><ul class="toc-headings"><li><a href="#adding-subcategories">Adding Subcategories</a></li><li><a href="#adding-new-sidebars">Adding New Sidebars</a></li></ul></li><li><a href="#additions-to-the-site-navigation-bar">Additions to the Site Navigation Bar</a><ul class="toc-headings"><li><a href="#adding-documents">Adding Documents</a></li><li><a href="#adding-custom-pages">Adding Custom Pages</a></li><li><a href="#adding-external-links">Adding External Links</a></li></ul></li><li><a href="#site-navigation-bar-positioning">Site Navigation Bar Positioning</a><ul class="toc-headings"><li><a href="#search">Search</a></li><li><a href="#languages-dropdown">Languages Dropdown</a></li></ul></li><li><a href="#active-links-in-site-navigation-bar">Active Links In Site Navigation Bar</a></li><li><a href="#secondary-on-page-navigation">Secondary On-Page Navigation</a></li><li><a href="#collapsible-categories">Collapsible Categories</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Enabling Search · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus supports search using [Algolia DocSearch](https://community.algolia.com/docsearch/). Once your website is online, you can [submit it to DocSearch](https://community.algolia.com/docsearch/). Algolia will then send you credentials you can add to your `siteConfig.js`."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Enabling Search · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus supports search using [Algolia DocSearch](https://community.algolia.com/docsearch/). Once your website is online, you can [submit it to DocSearch](https://community.algolia.com/docsearch/). Algolia will then send you credentials you can add to your `siteConfig.js`."/><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>Enabling Search · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus prend en charge la recherche en utilisant [Algolia DocSearch](https://community.algolia.com/docsearch/). Une fois que votre site est en ligne, vous pouvez [le soumettre à DocSearch](https://community.algolia.com/docsearch/). Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre `siteConfig.js`."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Enabling Search · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus prend en charge la recherche en utilisant [Algolia DocSearch](https://community.algolia.com/docsearch/). Une fois que votre site est en ligne, vous pouvez [le soumettre à DocSearch](https://community.algolia.com/docsearch/). Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre `siteConfig.js`."/><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,22 +80,22 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Enabling Search</h1></header><article><div><span><p>Docusaurus supports search using <a href="https://community.algolia.com/docsearch/">Algolia DocSearch</a>. Once your website is online, you can <a href="https://community.algolia.com/docsearch/">submit it to DocSearch</a>. Algolia will then send you credentials you can add to your <code>siteConfig.js</code>.</p>
|
||||
<p>DocSearch works by crawling the content of your website every 24 hours and putting all the content in an Algolia index. This content is then queried directly from your front-end using the Algolia API. Note that your website needs to be publicly available for this to work (ie. not behind a firewall). This service is free.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="enabling-the-search-bar"></a><a href="#enabling-the-search-bar" 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>Enabling the Search Bar</h2>
|
||||
<p>Enter your API key and index name (sent by Algolia) into <code>siteConfig.js</code> in the <code>algolia</code> section to enable search for your site.</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">Enabling Search</h1></header><article><div><span><p>Docusaurus prend en charge la recherche en utilisant <a href="https://community.algolia.com/docsearch/">Algolia DocSearch</a>. Une fois que votre site est en ligne, vous pouvez <a href="https://community.algolia.com/docsearch/">le soumettre à DocSearch</a>. Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre <code>siteConfig.js</code>.</p>
|
||||
<p>DocSearch travaille en explorant le contenu de votre site Web toutes les 24 heures et en mettant tout le contenu dans un index Algolia. Ce contenu est ensuite interrogé directement depuis votre front-end en utilisant l'API Algolia. Notez que votre site Web doit être accessible au public pour que cela fonctionne (par exemple pas derrière un pare-feu). Ce service est gratuit.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="activation-de-la-barre-de-recherche"></a><a href="#activation-de-la-barre-de-recherche" 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>Activation de la barre de recherche</h2>
|
||||
<p>Entrez votre clé API et le nom de l'index (envoyé par Algolia) dans <code>siteConfig.js</code> dans la section <code>algolia</code> pour activer la recherche de votre site.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
<span class="hljs-attr">apiKey</span>: <span class="hljs-string">'my-api-key'</span>,
|
||||
<span class="hljs-attr">indexName</span>: <span class="hljs-string">'my-index-name'</span>,
|
||||
<span class="hljs-attr">algoliaOptions</span>: {} <span class="hljs-comment">// Optional, if provided by Algolia</span>
|
||||
<span class="hljs-attr">algoliaOptions</span>: {} <span class="hljs-comment">// Facultatif, si fourni par Algolia</span>
|
||||
},
|
||||
...
|
||||
...
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="extra-search-options"></a><a href="#extra-search-options" 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>Extra Search Options</h2>
|
||||
<p>You can also specify extra <a href="https://community.algolia.com/docsearch/documentation/">search options used by Algolia</a> by using an <code>algoliaOptions</code> field in <code>algolia</code>. This may be useful if you want to provide different search results for the different versions or languages of your docs. Any occurrences of "VERSION" or "LANGUAGE" will be replaced by the version or language of the current page, respectively. More details about search options can be <a href="https://www.algolia.com/doc/api-reference/api-parameters/#overview">found here</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="options-de-recherche-supplémentaires"></a><a href="#options-de-recherche-supplémentaires" 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>Options de recherche supplémentaires</h2>
|
||||
<p>Vous pouvez également spécifier des options de recherche supplémentaires <a href="https://community.algolia.com/docsearch/documentation/">utilisées par Algolia</a> en utilisant un champ <code>algoliaOptions</code> dans <code>algolia</code>. Cela peut être utile si vous voulez fournir des résultats de recherche différents pour les différentes versions ou langues de vos docs. Toutes les occurrences de "VERSION" ou "LANGUAGE" seront remplacées respectivement par la version ou la langue de la page courante. Plus de détails sur les options de recherche peuvent être <a href="https://www.algolia.com/doc/api-reference/api-parameters/#overview">trouvés ici</a>.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
|
|
@ -106,10 +106,10 @@
|
|||
},
|
||||
};
|
||||
</code></pre>
|
||||
<p>Algolia might provide you with <a href="https://community.algolia.com/docsearch/documentation/">extra search options</a>. If so, you should add them to the <code>algoliaOptions</code> object.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="controlling-the-location-of-the-search-bar"></a><a href="#controlling-the-location-of-the-search-bar" 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>Controlling the Location of the Search Bar</h2>
|
||||
<p>By default, the search bar will be the rightmost element in the top navigation bar.</p>
|
||||
<p>If you want to change the default location, add the <code>searchBar</code> flag in the <code>headerLinks</code> field of <code>siteConfig.js</code> in your desired location. For example, you may want the search bar between your internal and external links.</p>
|
||||
<p>Algolia peut vous fournir des <a href="https://community.algolia.com/docsearch/documentation/">options de recherche supplémentaires</a>. Si c'est le cas, vous devriez les ajouter à l'objet <code>algoliaOptions</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="contrôle-de-lemplacement-de-la-barre-de-recherche"></a><a href="#contrôle-de-lemplacement-de-la-barre-de-recherche" 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>Contrôle de l'emplacement de la barre de recherche</h2>
|
||||
<p>Par défaut, la barre de recherche sera l'élément le plus à droite de la barre de navigation supérieure.</p>
|
||||
<p>Si vous voulez changer l'emplacement par défaut, ajoutez l'option <code>searchBar</code> dans le champ <code>headerLinks</code> de <code>siteConfig.js</code> à l'emplacement souhaité. Par exemple, vous souhaitez peut-être que la barre de recherche se trouve entre vos liens internes et externes.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
headerLinks: [
|
||||
|
|
@ -122,20 +122,20 @@
|
|||
...
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-the-placeholder"></a><a href="#customizing-the-placeholder" 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>Customizing the placeholder</h2>
|
||||
<p>If you want to change the placeholder (which defaults to <em>Search</em>), add the <code>placeholder</code> field in your config. For example, you may want the search bar to display <em>Ask me something</em>:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-du-placeholder"></a><a href="#personnalisation-du-placeholder" 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 du placeholder</h2>
|
||||
<p>Si vous souhaitez modifier le placeholder (dont la valeur par défaut est <em>Search</em>), ajoutez le champ <code>placeholder</code> dans votre configuration. Par exemple, vous pouvez vouloir que la barre de recherche affiche <em>Demandez-moi quelque chose</em> :</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
...
|
||||
placeholder: <span class="hljs-string">'Ask me something'</span>
|
||||
placeholder: <span class="hljs-string">'Demandez-moi quelque chose'</span>
|
||||
},
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="disabling-the-search-bar"></a><a href="#disabling-the-search-bar" 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>Disabling the Search Bar</h2>
|
||||
<p>To disable the search bar, comment out (recommended) or delete the <code>algolia</code> section in the <code>siteConfig.js</code> file.</p>
|
||||
<p>Also, if you have customized the location of the search bar in <code>headerLinks</code>, set <code>search: false</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/custom-pages"><span class="arrow-prev">← </span><span>Pages personnalisées</span></a><a class="docs-next button" href="/docs/fr/1.11.x/navigation"><span>Navigation et Barre latérale</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#enabling-the-search-bar">Enabling the Search Bar</a></li><li><a href="#extra-search-options">Extra Search Options</a></li><li><a href="#controlling-the-location-of-the-search-bar">Controlling the Location of the Search Bar</a></li><li><a href="#customizing-the-placeholder">Customizing the placeholder</a></li><li><a href="#disabling-the-search-bar">Disabling the Search Bar</a></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="
|
||||
<h2><a class="anchor" aria-hidden="true" id="désactivation-de-la-barre-de-recherche"></a><a href="#désactivation-de-la-barre-de-recherche" 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>Désactivation de la barre de recherche</h2>
|
||||
<p>Pour désactiver la barre de recherche, commentez (recommandé) ou supprimez la section <code>algolia</code> dans le fichier <code>siteConfig.js</code>.</p>
|
||||
<p>Aussi, si vous avez personnalisé l'emplacement de la barre de recherche dans <code>headerLinks</code>, définissez <code>search: false</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/custom-pages"><span class="arrow-prev">← </span><span>Pages personnalisées</span></a><a class="docs-next button" href="/docs/fr/1.11.x/navigation"><span>Navigation et Barre latérale</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#activation-de-la-barre-de-recherche">Activation de la barre de recherche</a></li><li><a href="#options-de-recherche-supplémentaires">Options de recherche supplémentaires</a></li><li><a href="#contrôle-de-lemplacement-de-la-barre-de-recherche">Contrôle de l'emplacement de la barre de recherche</a></li><li><a href="#personnalisation-du-placeholder">Personnalisation du placeholder</a></li><li><a href="#désactivation-de-la-barre-de-recherche">Désactivation de la barre de recherche</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Enabling Search · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus supports search using [Algolia DocSearch](https://community.algolia.com/docsearch/). Once your website is online, you can [submit it to DocSearch](https://community.algolia.com/docsearch/). Algolia will then send you credentials you can add to your `siteConfig.js`."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Enabling Search · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus supports search using [Algolia DocSearch](https://community.algolia.com/docsearch/). Once your website is online, you can [submit it to DocSearch](https://community.algolia.com/docsearch/). Algolia will then send you credentials you can add to your `siteConfig.js`."/><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>Enabling Search · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus prend en charge la recherche en utilisant [Algolia DocSearch](https://community.algolia.com/docsearch/). Une fois que votre site est en ligne, vous pouvez [le soumettre à DocSearch](https://community.algolia.com/docsearch/). Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre `siteConfig.js`."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Enabling Search · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus prend en charge la recherche en utilisant [Algolia DocSearch](https://community.algolia.com/docsearch/). Une fois que votre site est en ligne, vous pouvez [le soumettre à DocSearch](https://community.algolia.com/docsearch/). Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre `siteConfig.js`."/><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,22 +80,22 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Enabling Search</h1></header><article><div><span><p>Docusaurus supports search using <a href="https://community.algolia.com/docsearch/">Algolia DocSearch</a>. Once your website is online, you can <a href="https://community.algolia.com/docsearch/">submit it to DocSearch</a>. Algolia will then send you credentials you can add to your <code>siteConfig.js</code>.</p>
|
||||
<p>DocSearch works by crawling the content of your website every 24 hours and putting all the content in an Algolia index. This content is then queried directly from your front-end using the Algolia API. Note that your website needs to be publicly available for this to work (ie. not behind a firewall). This service is free.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="enabling-the-search-bar"></a><a href="#enabling-the-search-bar" 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>Enabling the Search Bar</h2>
|
||||
<p>Enter your API key and index name (sent by Algolia) into <code>siteConfig.js</code> in the <code>algolia</code> section to enable search for your site.</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">Enabling Search</h1></header><article><div><span><p>Docusaurus prend en charge la recherche en utilisant <a href="https://community.algolia.com/docsearch/">Algolia DocSearch</a>. Une fois que votre site est en ligne, vous pouvez <a href="https://community.algolia.com/docsearch/">le soumettre à DocSearch</a>. Algolia vous enverra alors les identifiants que vous pourrez ajouter à votre <code>siteConfig.js</code>.</p>
|
||||
<p>DocSearch travaille en explorant le contenu de votre site Web toutes les 24 heures et en mettant tout le contenu dans un index Algolia. Ce contenu est ensuite interrogé directement depuis votre front-end en utilisant l'API Algolia. Notez que votre site Web doit être accessible au public pour que cela fonctionne (par exemple pas derrière un pare-feu). Ce service est gratuit.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="activation-de-la-barre-de-recherche"></a><a href="#activation-de-la-barre-de-recherche" 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>Activation de la barre de recherche</h2>
|
||||
<p>Entrez votre clé API et le nom de l'index (envoyé par Algolia) dans <code>siteConfig.js</code> dans la section <code>algolia</code> pour activer la recherche de votre site.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
<span class="hljs-attr">apiKey</span>: <span class="hljs-string">'my-api-key'</span>,
|
||||
<span class="hljs-attr">indexName</span>: <span class="hljs-string">'my-index-name'</span>,
|
||||
<span class="hljs-attr">algoliaOptions</span>: {} <span class="hljs-comment">// Optional, if provided by Algolia</span>
|
||||
<span class="hljs-attr">algoliaOptions</span>: {} <span class="hljs-comment">// Facultatif, si fourni par Algolia</span>
|
||||
},
|
||||
...
|
||||
...
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="extra-search-options"></a><a href="#extra-search-options" 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>Extra Search Options</h2>
|
||||
<p>You can also specify extra <a href="https://community.algolia.com/docsearch/documentation/">search options used by Algolia</a> by using an <code>algoliaOptions</code> field in <code>algolia</code>. This may be useful if you want to provide different search results for the different versions or languages of your docs. Any occurrences of "VERSION" or "LANGUAGE" will be replaced by the version or language of the current page, respectively. More details about search options can be <a href="https://www.algolia.com/doc/api-reference/api-parameters/#overview">found here</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="options-de-recherche-supplémentaires"></a><a href="#options-de-recherche-supplémentaires" 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>Options de recherche supplémentaires</h2>
|
||||
<p>Vous pouvez également spécifier des options de recherche supplémentaires <a href="https://community.algolia.com/docsearch/documentation/">utilisées par Algolia</a> en utilisant un champ <code>algoliaOptions</code> dans <code>algolia</code>. Cela peut être utile si vous voulez fournir des résultats de recherche différents pour les différentes versions ou langues de vos docs. Toutes les occurrences de "VERSION" ou "LANGUAGE" seront remplacées respectivement par la version ou la langue de la page courante. Plus de détails sur les options de recherche peuvent être <a href="https://www.algolia.com/doc/api-reference/api-parameters/#overview">trouvés ici</a>.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
|
|
@ -106,10 +106,10 @@
|
|||
},
|
||||
};
|
||||
</code></pre>
|
||||
<p>Algolia might provide you with <a href="https://community.algolia.com/docsearch/documentation/">extra search options</a>. If so, you should add them to the <code>algoliaOptions</code> object.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="controlling-the-location-of-the-search-bar"></a><a href="#controlling-the-location-of-the-search-bar" 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>Controlling the Location of the Search Bar</h2>
|
||||
<p>By default, the search bar will be the rightmost element in the top navigation bar.</p>
|
||||
<p>If you want to change the default location, add the <code>searchBar</code> flag in the <code>headerLinks</code> field of <code>siteConfig.js</code> in your desired location. For example, you may want the search bar between your internal and external links.</p>
|
||||
<p>Algolia peut vous fournir des <a href="https://community.algolia.com/docsearch/documentation/">options de recherche supplémentaires</a>. Si c'est le cas, vous devriez les ajouter à l'objet <code>algoliaOptions</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="contrôle-de-lemplacement-de-la-barre-de-recherche"></a><a href="#contrôle-de-lemplacement-de-la-barre-de-recherche" 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>Contrôle de l'emplacement de la barre de recherche</h2>
|
||||
<p>Par défaut, la barre de recherche sera l'élément le plus à droite de la barre de navigation supérieure.</p>
|
||||
<p>Si vous voulez changer l'emplacement par défaut, ajoutez l'option <code>searchBar</code> dans le champ <code>headerLinks</code> de <code>siteConfig.js</code> à l'emplacement souhaité. Par exemple, vous souhaitez peut-être que la barre de recherche se trouve entre vos liens internes et externes.</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
headerLinks: [
|
||||
|
|
@ -122,20 +122,20 @@
|
|||
...
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="customizing-the-placeholder"></a><a href="#customizing-the-placeholder" 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>Customizing the placeholder</h2>
|
||||
<p>If you want to change the placeholder (which defaults to <em>Search</em>), add the <code>placeholder</code> field in your config. For example, you may want the search bar to display <em>Ask me something</em>:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="personnalisation-du-placeholder"></a><a href="#personnalisation-du-placeholder" 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 du placeholder</h2>
|
||||
<p>Si vous souhaitez modifier le placeholder (dont la valeur par défaut est <em>Search</em>), ajoutez le champ <code>placeholder</code> dans votre configuration. Par exemple, vous pouvez vouloir que la barre de recherche affiche <em>Demandez-moi quelque chose</em> :</p>
|
||||
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
|
||||
...
|
||||
algolia: {
|
||||
...
|
||||
placeholder: <span class="hljs-string">'Ask me something'</span>
|
||||
placeholder: <span class="hljs-string">'Demandez-moi quelque chose'</span>
|
||||
},
|
||||
};
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="disabling-the-search-bar"></a><a href="#disabling-the-search-bar" 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>Disabling the Search Bar</h2>
|
||||
<p>To disable the search bar, comment out (recommended) or delete the <code>algolia</code> section in the <code>siteConfig.js</code> file.</p>
|
||||
<p>Also, if you have customized the location of the search bar in <code>headerLinks</code>, set <code>search: false</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/custom-pages"><span class="arrow-prev">← </span><span>Pages personnalisées</span></a><a class="docs-next button" href="/docs/fr/1.11.x/navigation"><span>Navigation et Barre latérale</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#enabling-the-search-bar">Enabling the Search Bar</a></li><li><a href="#extra-search-options">Extra Search Options</a></li><li><a href="#controlling-the-location-of-the-search-bar">Controlling the Location of the Search Bar</a></li><li><a href="#customizing-the-placeholder">Customizing the placeholder</a></li><li><a href="#disabling-the-search-bar">Disabling the Search Bar</a></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="
|
||||
<h2><a class="anchor" aria-hidden="true" id="désactivation-de-la-barre-de-recherche"></a><a href="#désactivation-de-la-barre-de-recherche" 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>Désactivation de la barre de recherche</h2>
|
||||
<p>Pour désactiver la barre de recherche, commentez (recommandé) ou supprimez la section <code>algolia</code> dans le fichier <code>siteConfig.js</code>.</p>
|
||||
<p>Aussi, si vous avez personnalisé l'emplacement de la barre de recherche dans <code>headerLinks</code>, définissez <code>search: false</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/custom-pages"><span class="arrow-prev">← </span><span>Pages personnalisées</span></a><a class="docs-next button" href="/docs/fr/1.11.x/navigation"><span>Navigation et Barre latérale</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#activation-de-la-barre-de-recherche">Activation de la barre de recherche</a></li><li><a href="#options-de-recherche-supplémentaires">Options de recherche supplémentaires</a></li><li><a href="#contrôle-de-lemplacement-de-la-barre-de-recherche">Contrôle de l'emplacement de la barre de recherche</a></li><li><a href="#personnalisation-du-placeholder">Personnalisation du placeholder</a></li><li><a href="#désactivation-de-la-barre-de-recherche">Désactivation de la barre de recherche</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -81,8 +81,8 @@
|
|||
}
|
||||
});
|
||||
</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">Translations & Localization</h1></header><article><div><span><p>Docusaurus propose une fonctionnalité de traduction facile en utilisant <a href="https://crowdin.com/">Crowdin</a>. Les fichiers de documentation écrits en anglais sont envoyés à Crowdin pour une traduction par les utilisateurs au sein d’une communauté. Les pages de haut niveau écrites avec des chaînes anglaises peuvent être traduites en enregistrant toutes les chaînes que vous souhaitez traduire dans une balise <code><translate></code> . D'autres titres et étiquettes seront également trouvés et correctement traduits.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="docusaurus-translation-configurations"></a><a href="#docusaurus-translation-configurations" 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>Docusaurus Translation Configurations</h2>
|
||||
<p>Pour générer des fichiers d'exemple pour les traductions avec Docusaurus, exécutez le script <code>exemples</code> avec l'argument de ligne de commande <code>traductions</code>:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="configurations-de-traduction-de-docusaurus"></a><a href="#configurations-de-traduction-de-docusaurus" 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>Configurations de traduction de Docusaurus</h2>
|
||||
<p>Pour générer des fichiers d'exemple pour les traductions avec Docusaurus, exécutez le script <code>examples</code> avec l'argument de la ligne de commande <code>translations</code> :</p>
|
||||
<pre><code class="hljs css language-bash">npm run examples translations
|
||||
</code></pre>
|
||||
<p>ou</p>
|
||||
|
|
@ -97,37 +97,37 @@ languages.js
|
|||
<li>Le fichier <code>pages/en/help-with-translations.js</code> inclut la même page d'aide de démarrage générée par le script <code>examples</code> mais inclut maintenant les balises de traduction.</li>
|
||||
</ul>
|
||||
<blockquote>
|
||||
<p>Généralement, vous utiliserez <code>help-with-translations.js</code> comme guide pour activer les traductions dans vos autres pages, mais vous ne livrerez pas réellement le fichier à votre repo (c'est-à-dire que vous pourrez le supprimer). Cependant, si vous voulez une page d'Aide, et que vous n'en avez pas, vous pouvez renommer ce fichier en <code>help.js</code> et l'utiliser comme point de départ.</p>
|
||||
<p>Généralement, vous utiliserez <code>help-with-translations.js</code> comme guide pour activer les traductions dans vos autres pages, mais vous ne livrerez pas réellement le fichier à votre dépôt (c'est-à-dire que vous pourrez le supprimer). Cependant, si vous voulez une page d'Aide, et que vous n'en avez pas, vous pouvez renommer ce fichier en <code>help.js</code> et l'utiliser comme point de départ.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li><p>Le fichier <code>languages.js</code> indique à Docusaurus quelles langues vous souhaitez activer pour votre site. Par défaut, nous attendons que l'anglais qu'il soit activé.</p></li>
|
||||
<li><p>Le fichier <code>crowdin.yaml</code> est utilisé pour configurer l'intégration de Crowdin et est copié à un niveau supérieur dans votre projet Docusaurus. Si votre projet Docusaurus réside dans <code>/project/website</code>, alors <code>crowdin.yaml</code> sera copié dans <code>/project/crowdin.yaml</code>.</p></li>
|
||||
<li><p>Le fichier <code>languages.js</code> indique à Docusaurus quelles langues vous souhaitez activer pour votre site. Par défaut, nous espérons que l'anglais sera activé.</p></li>
|
||||
<li><p>Le fichier <code>crowdin.yaml</code> est utilisé pour configurer l'intégration de Crowdin et est copié d'un niveau vers le haut dans le dépôt de votre projet Docusaurus. Si votre projet Docusaurus réside dans <code>/project/website</code>, alors <code>crowdin.yaml</code> sera copié dans <code>/project/crowdin.yaml</code>.</p></li>
|
||||
</ul>
|
||||
<h2><a class="anchor" aria-hidden="true" id="traduire-vos-docs-existantes"></a><a href="#traduire-vos-docs-existantes" 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>Traduire vos docs existantes</h2>
|
||||
<p>Vos fichiers de documentation (par exemple les fichiers <code>.md</code> qui vivent dans votre répertoire <code>docs</code>) ne doivent pas être modifiés ou déplacés pour supporter les traductions. Ils seront envoyés à Crowdin pour être traduits directement.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="activer-les-traductions-sur-les-pages"></a><a href="#activer-les-traductions-sur-les-pages" 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>Activer les traductions sur les pages</h2>
|
||||
<p>Les pages vous permettent de personnaliser la mise en page et le contenu spécifique des pages comme une page d'index personnalisée ou une page d'aide.</p>
|
||||
<p>Les pages avec du texte que vous souhaitez traduire doivent être placées dans le répertoire <code>site/pages/en</code> .</p>
|
||||
<p>Wrap strings you want translated in a <code><translate></code> tag, and add the following <code>require</code> statement to the top of the file:</p>
|
||||
<p>Enveloppez les chaînes de caractères que vous voulez traduire dans une balise <code><translate></code>, et ajoutez l'instruction suivante <code>require</code> en haut du fichier :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token operator">...</span>
|
||||
<span class="token keyword">const</span> translate <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'../../server/translate.js'</span><span class="token punctuation">)</span><span class="token punctuation">.</span>translate<span class="token punctuation">;</span>
|
||||
<span class="token operator">...</span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>h2</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span>This header will be translated<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span>Cette entête sera traduite<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>h2</span><span class="token punctuation">></span></span>
|
||||
<span class="token operator">...</span>
|
||||
</code></pre>
|
||||
<p>You can also include an optional description attribute to give more context to a translator about how to translate the string:</p>
|
||||
<p>Vous pouvez également inclure un attribut de description facultatif pour donner plus de contexte à un traducteur sur la façon de traduire la chaîne :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span> <span class="token attr-name">desc</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>flower, not verb<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>Rose<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>The <code><translate></code> tag generally works well on pure strings. If you have a string like "Docusaurus currently provides support to help your website use <a href="${siteConfig.baseUrl}${siteConfig.docsUrl}/${this.props.language}/translation.html">translations</a>", wrapping the <code><translation></code> tag around that entire string will cause issues because of the markdown linking, etc. Your options are to not translate those strings, or spread a bunch of <code><translate></code> tags amongst the pure substrings of that string.</p>
|
||||
<p>La balise <code><translate></code> fonctionne généralement bien sur des chaînes de caractères pures. Si vous avez une chaîne comme "Docusaurus fournit actuellement un support pour aider votre site à utiliser <a href="${siteConfig.baseUrl}${siteConfig.docsUrl}/${this.props.language}/translation.html">translations</a>", encapsuler la balise <code><translation></code> autour de cette chaîne entière causera des problèmes à cause du lien markdown, etc. Vos possibilités sont de ne pas traduire ces chaînes de caractères, ou de disséminer un tas de balises <code><translate></code> parmi les chaînes de caractères pures de cette chaîne.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="gathering-strings-to-translate"></a><a href="#gathering-strings-to-translate" 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>Gathering Strings to Translate</h2>
|
||||
<p>The strings within localized Pages must be extracted and provided to Crowdin.</p>
|
||||
<p>Add the following script to your <code>website/package.json</code> file, if it does not exist already:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="collecter-des-chaînes-à-traduire"></a><a href="#collecter-des-chaînes-à-traduire" 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>Collecter des chaînes à traduire</h2>
|
||||
<p>Les chaînes dans les pages à traduire doivent être extraites et fournies à Crowdin.</p>
|
||||
<p>Ajoutez le script suivant à votre fichier <code>website/package.json</code> s'il n'existe pas déjà :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
...
|
||||
<span class="hljs-string">"scripts"</span>: {
|
||||
|
|
@ -136,17 +136,17 @@ languages.js
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>Running the script will generate a <code>website/i18n/en.json</code> file containing all the strings that will be translated from English into other languages.</p>
|
||||
<p>The script will include text from the following places:</p>
|
||||
<p>L'exécution du script générera un fichier <code>website/i18n/fr.json</code> contenant toutes les chaînes qui seront traduites de l'anglais dans d'autres langues.</p>
|
||||
<p>Le script comprendra du texte provenant des endroits suivants :</p>
|
||||
<ul>
|
||||
<li><code>title</code> and <code>sidebar_label</code> strings in document markdown headers</li>
|
||||
<li>category names in <code>sidebars.json</code></li>
|
||||
<li>tagline in <code>siteConfig.js</code></li>
|
||||
<li>header link <code>label</code> strings in <code>siteConfig.js</code></li>
|
||||
<li>strings wrapped in the <code><translate></code> tag in any <code>.js</code> files inside <code>pages</code></li>
|
||||
<li>Les chaînes <code>title</code> et <code>sidebar_label</code> dans les entêtes du document markdown</li>
|
||||
<li>Les noms des catégories dans <code>sidebars.json</code></li>
|
||||
<li>tagline dans <code>siteConfig.js</code></li>
|
||||
<li>Les chaînes <code>label</code> de headerLinks dans <code>siteConfig.js</code></li>
|
||||
<li>Les chaînes enveloppées dans la balise <code><translate></code> dans tous les fichiers <code>.js</code> dans <code>pages</code></li>
|
||||
</ul>
|
||||
<h3><a class="anchor" aria-hidden="true" id="custom-translation-strings"></a><a href="#custom-translation-strings" 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>Custom Translation Strings</h3>
|
||||
<p>If you want to add additional custom translation strings or override any of the strings that get produced by the script that creates the <code>website/i18n/en.json</code> file, you can add a <code>website/data/custom-translation-strings.json</code> file. The file should have a form of:</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="chaînes-de-traduction-personnalisées"></a><a href="#chaînes-de-traduction-personnalisées" 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>Chaînes de traduction personnalisées</h3>
|
||||
<p>Si vous voulez ajouter des chaînes de traduction personnalisées supplémentaires ou remplacer l'une des chaînes qui sont produites par le script qui crée le fichier <code>website/i18n/en.json</code>, vous pouvez ajouter un fichier <code>website/data/custom-translation-strings.json</code> . Le fichier doit être sous la forme :</p>
|
||||
<pre><code class="hljs css language-json">{
|
||||
<span class="hljs-attr">"localized-strings"</span>: {
|
||||
<span class="hljs-attr">"docs"</span>: {
|
||||
|
|
@ -166,22 +166,22 @@ languages.js
|
|||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p>where <code>localized-strings</code> represent strings in your documentation content and <code>pages-strings</code> represents metadata in your documentation (e.g., title, links, etc).</p>
|
||||
<p>Here is an example:</p>
|
||||
<p>où <code>localized-strings</code> représentent des chaînes de caractères dans le contenu de votre documentation et <code>pages-strings</code> représente des métadonnées dans votre documentation (par exemple, titre, liens, etc.).</p>
|
||||
<p>Voici un exemple :</p>
|
||||
<pre><code class="hljs css language-json">{
|
||||
<span class="hljs-attr">"_comment"</span>: <span class="hljs-string">"This file is used to provide custom strings for translations, including overriding defaults"</span>,
|
||||
<span class="hljs-attr">"_comment"</span>: <span class="hljs-string">"Ce fichier est utilisé pour fournir des chaînes personnalisées pour les traductions, y compris en supportant les valeurs par défaut"</span>,
|
||||
<span class="hljs-attr">"localized-strings"</span>: {
|
||||
<span class="hljs-attr">"translation"</span>: <span class="hljs-string">"Translations and Localization"</span>
|
||||
<span class="hljs-attr">"traduction"</span>: <span class="hljs-string">"Traductions et localisation"</span>
|
||||
},
|
||||
<span class="hljs-attr">"pages-strings"</span>: {
|
||||
<span class="hljs-attr">"Help Translate|recruit community translators for your project"</span>: <span class="hljs-string">"Help Us Translate"</span>
|
||||
<span class="hljs-attr">"Aidez à traduire|recrutez des traducteurs de la communauté pour votre projet"</span>: <span class="hljs-string">"Aidez-nous à traduire"</span>
|
||||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p>See the generated <code>website/i18n/en.json</code> for an example.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-strings-get-translated"></a><a href="#how-strings-get-translated" 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>How Strings Get Translated</h2>
|
||||
<p>Docusaurus itself does not do any translation from one language to another. Instead, it integrates <a href="https://crowdin.com/">Crowdin</a> to upload translations and then downloads the appropriately translated files from Crowdin.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-docusaurus-uses-string-translations"></a><a href="#how-docusaurus-uses-string-translations" 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>How Docusaurus Uses String Translations</h2>
|
||||
<p>Voir le <code>website/i18n/en.json</code> généré pour exemple.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-les-chaînes-de-caractères-sont-traduites"></a><a href="#comment-les-chaînes-de-caractères-sont-traduites" 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>Comment les chaînes de caractères sont traduites</h2>
|
||||
<p>Docusaurus lui-même ne fait aucune traduction d'une langue à une autre. Au lieu de cela, il intègre <a href="https://crowdin.com/">Crowdin</a> pour télécharger les traductions et ensuite extraire les fichiers correctement traduits à partir de Crowdin.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères"></a><a href="#comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères" 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>Comment Docusaurus utilise les traductions de chaînes de caractères</h2>
|
||||
<p>This section provides context about how translations in Docusaurus works.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="strings"></a><a href="#strings" 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>Strings</h3>
|
||||
<p>A Docusaurus site has many strings used throughout it that require localization. However, maintaining a list of strings used throughout a site can be laborious. Docusaurus simplifies this by centralizing strings.</p>
|
||||
|
|
@ -304,7 +304,7 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
|
|||
<span class="hljs-attr">languages_mapping:</span> <span class="hljs-meta">*anchor</span>
|
||||
</code></pre>
|
||||
<p>Translated, versioned documents will be copied into <code>website/translated_docs/${language}/${version}/</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/navigation"><span class="arrow-prev">← </span><span>Navigation et Barre latérale</span></a><a class="docs-next button" href="/docs/fr/1.11.x/versioning"><span>Gestion de version</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#docusaurus-translation-configurations">Docusaurus Translation Configurations</a></li><li><a href="#traduire-vos-docs-existantes">Traduire vos docs existantes</a></li><li><a href="#activer-les-traductions-sur-les-pages">Activer les traductions sur les pages</a></li><li><a href="#gathering-strings-to-translate">Gathering Strings to Translate</a><ul class="toc-headings"><li><a href="#custom-translation-strings">Custom Translation Strings</a></li></ul></li><li><a href="#how-strings-get-translated">How Strings Get Translated</a></li><li><a href="#how-docusaurus-uses-string-translations">How Docusaurus Uses String Translations</a><ul class="toc-headings"><li><a href="#strings">Strings</a></li><li><a href="#markdown-files">Markdown Files</a></li><li><a href="#other-pages">Other Pages</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#setup-the-crowdin-scripts">Setup the Crowdin Scripts</a></li><li><a href="#manual-file-sync">Manual File Sync</a></li><li><a href="#automated-file-sync-using-circleci">Automated File Sync Using CircleCI</a></li></ul></li><li><a href="#versioned-translations">Versioned Translations</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/navigation"><span class="arrow-prev">← </span><span>Navigation et Barre latérale</span></a><a class="docs-next button" href="/docs/fr/1.11.x/versioning"><span>Gestion de version</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#configurations-de-traduction-de-docusaurus">Configurations de traduction de Docusaurus</a></li><li><a href="#traduire-vos-docs-existantes">Traduire vos docs existantes</a></li><li><a href="#activer-les-traductions-sur-les-pages">Activer les traductions sur les pages</a></li><li><a href="#collecter-des-chaînes-à-traduire">Collecter des chaînes à traduire</a><ul class="toc-headings"><li><a href="#chaînes-de-traduction-personnalisées">Chaînes de traduction personnalisées</a></li></ul></li><li><a href="#comment-les-chaînes-de-caractères-sont-traduites">Comment les chaînes de caractères sont traduites</a></li><li><a href="#comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères">Comment Docusaurus utilise les traductions de chaînes de caractères</a><ul class="toc-headings"><li><a href="#strings">Strings</a></li><li><a href="#markdown-files">Markdown Files</a></li><li><a href="#other-pages">Other Pages</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#setup-the-crowdin-scripts">Setup the Crowdin Scripts</a></li><li><a href="#manual-file-sync">Manual File Sync</a></li><li><a href="#automated-file-sync-using-circleci">Automated File Sync Using CircleCI</a></li></ul></li><li><a href="#versioned-translations">Versioned Translations</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -81,8 +81,8 @@
|
|||
}
|
||||
});
|
||||
</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">Translations & Localization</h1></header><article><div><span><p>Docusaurus propose une fonctionnalité de traduction facile en utilisant <a href="https://crowdin.com/">Crowdin</a>. Les fichiers de documentation écrits en anglais sont envoyés à Crowdin pour une traduction par les utilisateurs au sein d’une communauté. Les pages de haut niveau écrites avec des chaînes anglaises peuvent être traduites en enregistrant toutes les chaînes que vous souhaitez traduire dans une balise <code><translate></code> . D'autres titres et étiquettes seront également trouvés et correctement traduits.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="docusaurus-translation-configurations"></a><a href="#docusaurus-translation-configurations" 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>Docusaurus Translation Configurations</h2>
|
||||
<p>Pour générer des fichiers d'exemple pour les traductions avec Docusaurus, exécutez le script <code>exemples</code> avec l'argument de ligne de commande <code>traductions</code>:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="configurations-de-traduction-de-docusaurus"></a><a href="#configurations-de-traduction-de-docusaurus" 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>Configurations de traduction de Docusaurus</h2>
|
||||
<p>Pour générer des fichiers d'exemple pour les traductions avec Docusaurus, exécutez le script <code>examples</code> avec l'argument de la ligne de commande <code>translations</code> :</p>
|
||||
<pre><code class="hljs css language-bash">npm run examples translations
|
||||
</code></pre>
|
||||
<p>ou</p>
|
||||
|
|
@ -97,37 +97,37 @@ languages.js
|
|||
<li>Le fichier <code>pages/en/help-with-translations.js</code> inclut la même page d'aide de démarrage générée par le script <code>examples</code> mais inclut maintenant les balises de traduction.</li>
|
||||
</ul>
|
||||
<blockquote>
|
||||
<p>Généralement, vous utiliserez <code>help-with-translations.js</code> comme guide pour activer les traductions dans vos autres pages, mais vous ne livrerez pas réellement le fichier à votre repo (c'est-à-dire que vous pourrez le supprimer). Cependant, si vous voulez une page d'Aide, et que vous n'en avez pas, vous pouvez renommer ce fichier en <code>help.js</code> et l'utiliser comme point de départ.</p>
|
||||
<p>Généralement, vous utiliserez <code>help-with-translations.js</code> comme guide pour activer les traductions dans vos autres pages, mais vous ne livrerez pas réellement le fichier à votre dépôt (c'est-à-dire que vous pourrez le supprimer). Cependant, si vous voulez une page d'Aide, et que vous n'en avez pas, vous pouvez renommer ce fichier en <code>help.js</code> et l'utiliser comme point de départ.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li><p>Le fichier <code>languages.js</code> indique à Docusaurus quelles langues vous souhaitez activer pour votre site. Par défaut, nous attendons que l'anglais qu'il soit activé.</p></li>
|
||||
<li><p>Le fichier <code>crowdin.yaml</code> est utilisé pour configurer l'intégration de Crowdin et est copié à un niveau supérieur dans votre projet Docusaurus. Si votre projet Docusaurus réside dans <code>/project/website</code>, alors <code>crowdin.yaml</code> sera copié dans <code>/project/crowdin.yaml</code>.</p></li>
|
||||
<li><p>Le fichier <code>languages.js</code> indique à Docusaurus quelles langues vous souhaitez activer pour votre site. Par défaut, nous espérons que l'anglais sera activé.</p></li>
|
||||
<li><p>Le fichier <code>crowdin.yaml</code> est utilisé pour configurer l'intégration de Crowdin et est copié d'un niveau vers le haut dans le dépôt de votre projet Docusaurus. Si votre projet Docusaurus réside dans <code>/project/website</code>, alors <code>crowdin.yaml</code> sera copié dans <code>/project/crowdin.yaml</code>.</p></li>
|
||||
</ul>
|
||||
<h2><a class="anchor" aria-hidden="true" id="traduire-vos-docs-existantes"></a><a href="#traduire-vos-docs-existantes" 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>Traduire vos docs existantes</h2>
|
||||
<p>Vos fichiers de documentation (par exemple les fichiers <code>.md</code> qui vivent dans votre répertoire <code>docs</code>) ne doivent pas être modifiés ou déplacés pour supporter les traductions. Ils seront envoyés à Crowdin pour être traduits directement.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="activer-les-traductions-sur-les-pages"></a><a href="#activer-les-traductions-sur-les-pages" 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>Activer les traductions sur les pages</h2>
|
||||
<p>Les pages vous permettent de personnaliser la mise en page et le contenu spécifique des pages comme une page d'index personnalisée ou une page d'aide.</p>
|
||||
<p>Les pages avec du texte que vous souhaitez traduire doivent être placées dans le répertoire <code>site/pages/en</code> .</p>
|
||||
<p>Wrap strings you want translated in a <code><translate></code> tag, and add the following <code>require</code> statement to the top of the file:</p>
|
||||
<p>Enveloppez les chaînes de caractères que vous voulez traduire dans une balise <code><translate></code>, et ajoutez l'instruction suivante <code>require</code> en haut du fichier :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token operator">...</span>
|
||||
<span class="token keyword">const</span> translate <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'../../server/translate.js'</span><span class="token punctuation">)</span><span class="token punctuation">.</span>translate<span class="token punctuation">;</span>
|
||||
<span class="token operator">...</span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>h2</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span>This header will be translated<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span><span class="token punctuation">></span></span>Cette entête sera traduite<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>h2</span><span class="token punctuation">></span></span>
|
||||
<span class="token operator">...</span>
|
||||
</code></pre>
|
||||
<p>You can also include an optional description attribute to give more context to a translator about how to translate the string:</p>
|
||||
<p>Vous pouvez également inclure un attribut de description facultatif pour donner plus de contexte à un traducteur sur la façon de traduire la chaîne :</p>
|
||||
<pre><code class="hljs css language-jsx"><span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>translate</span> <span class="token attr-name">desc</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token punctuation">"</span>flower, not verb<span class="token punctuation">"</span></span><span class="token punctuation">></span></span>Rose<span class="token tag"><span class="token tag"><span class="token punctuation"></</span>translate</span><span class="token punctuation">></span></span>
|
||||
<span class="token tag"><span class="token tag"><span class="token punctuation"><</span>p</span><span class="token punctuation">></span></span>
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>The <code><translate></code> tag generally works well on pure strings. If you have a string like "Docusaurus currently provides support to help your website use <a href="${siteConfig.baseUrl}${siteConfig.docsUrl}/${this.props.language}/translation.html">translations</a>", wrapping the <code><translation></code> tag around that entire string will cause issues because of the markdown linking, etc. Your options are to not translate those strings, or spread a bunch of <code><translate></code> tags amongst the pure substrings of that string.</p>
|
||||
<p>La balise <code><translate></code> fonctionne généralement bien sur des chaînes de caractères pures. Si vous avez une chaîne comme "Docusaurus fournit actuellement un support pour aider votre site à utiliser <a href="${siteConfig.baseUrl}${siteConfig.docsUrl}/${this.props.language}/translation.html">translations</a>", encapsuler la balise <code><translation></code> autour de cette chaîne entière causera des problèmes à cause du lien markdown, etc. Vos possibilités sont de ne pas traduire ces chaînes de caractères, ou de disséminer un tas de balises <code><translate></code> parmi les chaînes de caractères pures de cette chaîne.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="gathering-strings-to-translate"></a><a href="#gathering-strings-to-translate" 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>Gathering Strings to Translate</h2>
|
||||
<p>The strings within localized Pages must be extracted and provided to Crowdin.</p>
|
||||
<p>Add the following script to your <code>website/package.json</code> file, if it does not exist already:</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="collecter-des-chaînes-à-traduire"></a><a href="#collecter-des-chaînes-à-traduire" 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>Collecter des chaînes à traduire</h2>
|
||||
<p>Les chaînes dans les pages à traduire doivent être extraites et fournies à Crowdin.</p>
|
||||
<p>Ajoutez le script suivant à votre fichier <code>website/package.json</code> s'il n'existe pas déjà :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
...
|
||||
<span class="hljs-string">"scripts"</span>: {
|
||||
|
|
@ -136,17 +136,17 @@ languages.js
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>Running the script will generate a <code>website/i18n/en.json</code> file containing all the strings that will be translated from English into other languages.</p>
|
||||
<p>The script will include text from the following places:</p>
|
||||
<p>L'exécution du script générera un fichier <code>website/i18n/fr.json</code> contenant toutes les chaînes qui seront traduites de l'anglais dans d'autres langues.</p>
|
||||
<p>Le script comprendra du texte provenant des endroits suivants :</p>
|
||||
<ul>
|
||||
<li><code>title</code> and <code>sidebar_label</code> strings in document markdown headers</li>
|
||||
<li>category names in <code>sidebars.json</code></li>
|
||||
<li>tagline in <code>siteConfig.js</code></li>
|
||||
<li>header link <code>label</code> strings in <code>siteConfig.js</code></li>
|
||||
<li>strings wrapped in the <code><translate></code> tag in any <code>.js</code> files inside <code>pages</code></li>
|
||||
<li>Les chaînes <code>title</code> et <code>sidebar_label</code> dans les entêtes du document markdown</li>
|
||||
<li>Les noms des catégories dans <code>sidebars.json</code></li>
|
||||
<li>tagline dans <code>siteConfig.js</code></li>
|
||||
<li>Les chaînes <code>label</code> de headerLinks dans <code>siteConfig.js</code></li>
|
||||
<li>Les chaînes enveloppées dans la balise <code><translate></code> dans tous les fichiers <code>.js</code> dans <code>pages</code></li>
|
||||
</ul>
|
||||
<h3><a class="anchor" aria-hidden="true" id="custom-translation-strings"></a><a href="#custom-translation-strings" 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>Custom Translation Strings</h3>
|
||||
<p>If you want to add additional custom translation strings or override any of the strings that get produced by the script that creates the <code>website/i18n/en.json</code> file, you can add a <code>website/data/custom-translation-strings.json</code> file. The file should have a form of:</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="chaînes-de-traduction-personnalisées"></a><a href="#chaînes-de-traduction-personnalisées" 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>Chaînes de traduction personnalisées</h3>
|
||||
<p>Si vous voulez ajouter des chaînes de traduction personnalisées supplémentaires ou remplacer l'une des chaînes qui sont produites par le script qui crée le fichier <code>website/i18n/en.json</code>, vous pouvez ajouter un fichier <code>website/data/custom-translation-strings.json</code> . Le fichier doit être sous la forme :</p>
|
||||
<pre><code class="hljs css language-json">{
|
||||
<span class="hljs-attr">"localized-strings"</span>: {
|
||||
<span class="hljs-attr">"docs"</span>: {
|
||||
|
|
@ -166,22 +166,22 @@ languages.js
|
|||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p>where <code>localized-strings</code> represent strings in your documentation content and <code>pages-strings</code> represents metadata in your documentation (e.g., title, links, etc).</p>
|
||||
<p>Here is an example:</p>
|
||||
<p>où <code>localized-strings</code> représentent des chaînes de caractères dans le contenu de votre documentation et <code>pages-strings</code> représente des métadonnées dans votre documentation (par exemple, titre, liens, etc.).</p>
|
||||
<p>Voici un exemple :</p>
|
||||
<pre><code class="hljs css language-json">{
|
||||
<span class="hljs-attr">"_comment"</span>: <span class="hljs-string">"This file is used to provide custom strings for translations, including overriding defaults"</span>,
|
||||
<span class="hljs-attr">"_comment"</span>: <span class="hljs-string">"Ce fichier est utilisé pour fournir des chaînes personnalisées pour les traductions, y compris en supportant les valeurs par défaut"</span>,
|
||||
<span class="hljs-attr">"localized-strings"</span>: {
|
||||
<span class="hljs-attr">"translation"</span>: <span class="hljs-string">"Translations and Localization"</span>
|
||||
<span class="hljs-attr">"traduction"</span>: <span class="hljs-string">"Traductions et localisation"</span>
|
||||
},
|
||||
<span class="hljs-attr">"pages-strings"</span>: {
|
||||
<span class="hljs-attr">"Help Translate|recruit community translators for your project"</span>: <span class="hljs-string">"Help Us Translate"</span>
|
||||
<span class="hljs-attr">"Aidez à traduire|recrutez des traducteurs de la communauté pour votre projet"</span>: <span class="hljs-string">"Aidez-nous à traduire"</span>
|
||||
}
|
||||
}
|
||||
</code></pre>
|
||||
<p>See the generated <code>website/i18n/en.json</code> for an example.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-strings-get-translated"></a><a href="#how-strings-get-translated" 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>How Strings Get Translated</h2>
|
||||
<p>Docusaurus itself does not do any translation from one language to another. Instead, it integrates <a href="https://crowdin.com/">Crowdin</a> to upload translations and then downloads the appropriately translated files from Crowdin.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="how-docusaurus-uses-string-translations"></a><a href="#how-docusaurus-uses-string-translations" 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>How Docusaurus Uses String Translations</h2>
|
||||
<p>Voir le <code>website/i18n/en.json</code> généré pour exemple.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-les-chaînes-de-caractères-sont-traduites"></a><a href="#comment-les-chaînes-de-caractères-sont-traduites" 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>Comment les chaînes de caractères sont traduites</h2>
|
||||
<p>Docusaurus lui-même ne fait aucune traduction d'une langue à une autre. Au lieu de cela, il intègre <a href="https://crowdin.com/">Crowdin</a> pour télécharger les traductions et ensuite extraire les fichiers correctement traduits à partir de Crowdin.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères"></a><a href="#comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères" 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>Comment Docusaurus utilise les traductions de chaînes de caractères</h2>
|
||||
<p>This section provides context about how translations in Docusaurus works.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="strings"></a><a href="#strings" 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>Strings</h3>
|
||||
<p>A Docusaurus site has many strings used throughout it that require localization. However, maintaining a list of strings used throughout a site can be laborious. Docusaurus simplifies this by centralizing strings.</p>
|
||||
|
|
@ -304,7 +304,7 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
|
|||
<span class="hljs-attr">languages_mapping:</span> <span class="hljs-meta">*anchor</span>
|
||||
</code></pre>
|
||||
<p>Translated, versioned documents will be copied into <code>website/translated_docs/${language}/${version}/</code>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/navigation"><span class="arrow-prev">← </span><span>Navigation et Barre latérale</span></a><a class="docs-next button" href="/docs/fr/1.11.x/versioning"><span>Gestion de version</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#docusaurus-translation-configurations">Docusaurus Translation Configurations</a></li><li><a href="#traduire-vos-docs-existantes">Traduire vos docs existantes</a></li><li><a href="#activer-les-traductions-sur-les-pages">Activer les traductions sur les pages</a></li><li><a href="#gathering-strings-to-translate">Gathering Strings to Translate</a><ul class="toc-headings"><li><a href="#custom-translation-strings">Custom Translation Strings</a></li></ul></li><li><a href="#how-strings-get-translated">How Strings Get Translated</a></li><li><a href="#how-docusaurus-uses-string-translations">How Docusaurus Uses String Translations</a><ul class="toc-headings"><li><a href="#strings">Strings</a></li><li><a href="#markdown-files">Markdown Files</a></li><li><a href="#other-pages">Other Pages</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#setup-the-crowdin-scripts">Setup the Crowdin Scripts</a></li><li><a href="#manual-file-sync">Manual File Sync</a></li><li><a href="#automated-file-sync-using-circleci">Automated File Sync Using CircleCI</a></li></ul></li><li><a href="#versioned-translations">Versioned Translations</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/navigation"><span class="arrow-prev">← </span><span>Navigation et Barre latérale</span></a><a class="docs-next button" href="/docs/fr/1.11.x/versioning"><span>Gestion de version</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#configurations-de-traduction-de-docusaurus">Configurations de traduction de Docusaurus</a></li><li><a href="#traduire-vos-docs-existantes">Traduire vos docs existantes</a></li><li><a href="#activer-les-traductions-sur-les-pages">Activer les traductions sur les pages</a></li><li><a href="#collecter-des-chaînes-à-traduire">Collecter des chaînes à traduire</a><ul class="toc-headings"><li><a href="#chaînes-de-traduction-personnalisées">Chaînes de traduction personnalisées</a></li></ul></li><li><a href="#comment-les-chaînes-de-caractères-sont-traduites">Comment les chaînes de caractères sont traduites</a></li><li><a href="#comment-docusaurus-utilise-les-traductions-de-chaînes-de-caractères">Comment Docusaurus utilise les traductions de chaînes de caractères</a><ul class="toc-headings"><li><a href="#strings">Strings</a></li><li><a href="#markdown-files">Markdown Files</a></li><li><a href="#other-pages">Other Pages</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#setup-the-crowdin-scripts">Setup the Crowdin Scripts</a></li><li><a href="#manual-file-sync">Manual File Sync</a></li><li><a href="#automated-file-sync-using-circleci">Automated File Sync Using CircleCI</a></li></ul></li><li><a href="#versioned-translations">Versioned Translations</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Create a New Site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create a New Site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes."/><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>Create a New Site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create a New Site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes."/><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,18 +80,18 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Create a New Site</h1></header><article><div><span><p>In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes.</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">Create a New Site</h1></header><article><div><span><p>Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes.</p>
|
||||
<p><img src="/img/undraw_docusaurus_browser.svg" alt="Docusaurus browser"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="scaffold-the-site"></a><a href="#scaffold-the-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>Scaffold the Site</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="conception-du-site"></a><a href="#conception-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>Conception du site</h2>
|
||||
<ol>
|
||||
<li>Execute the <code>docusaurus-init</code> command in your terminal.</li>
|
||||
<li>Exécutez la commande <code>docusaurus-init</code> dans votre terminal.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">docusaurus-init
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>The <code>Linking dependencies...</code> step might take a while, but it will finish eventually.</p>
|
||||
<p>L'étape <code>Lier les dépendances... (Linking dependencies...)</code> peut prendre un certain temps, mais elle finira par se terminer.</p>
|
||||
</blockquote>
|
||||
<p>The following contents will be created in your current directory. Some example documentation pages (under <code>docs</code>) and blog posts (under <code>website/blog</code>) are included.</p>
|
||||
<p>Le contenu suivant sera créé dans votre répertoire courant. Quelques exemples de pages de documentation (sous <code>docs</code>) et des articles de blog (sous <code>website/blog</code>) sont inclus.</p>
|
||||
<pre><code class="hljs css language-sh">├── Dockerfile
|
||||
├── docker-compose.yml
|
||||
├── docs
|
||||
|
|
@ -130,12 +130,12 @@
|
|||
└── yarn.lock
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
<li>Run <code>cd website</code> to go into the <code>website</code> directory.</li>
|
||||
<li>Run <code>npm start</code> or <code>yarn start</code>.</li>
|
||||
<li>Exécutez <code>cd website</code> pour aller dans le répertoire <code>website</code>.</li>
|
||||
<li>Exécutez <code>npm start</code> ou <code>yarn start</code>.</li>
|
||||
</ol>
|
||||
<p>A browser window will open up at <a href="http://localhost:3000">http://localhost:3000</a>.</p>
|
||||
<p>Congratulations, you have just made your first Docusaurus site! Click around the pages to get a feel for it.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-setup"><span class="arrow-prev">← </span><span>Paramétrage</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-create-pages"><span>Créer des pages</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#scaffold-the-site">Scaffold the Site</a></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="
|
||||
<p>Une fenêtre de navigateur s'ouvrira à l'adresse <a href="http://localhost:3000">http://localhost:3000</a>.</p>
|
||||
<p>Félicitations, vous venez de faire votre premier site Docusaurus ! Cliquez sur les pages pour vous faire une idée.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-setup"><span class="arrow-prev">← </span><span>Paramétrage</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-create-pages"><span>Créer des pages</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#conception-du-site">Conception du site</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Create a New Site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create a New Site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes."/><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>Create a New Site · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create a New Site · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes."/><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,18 +80,18 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Create a New Site</h1></header><article><div><span><p>In this section, we'll get our Docusaurus site up and running for local development. The process only takes a few minutes.</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">Create a New Site</h1></header><article><div><span><p>Dans cette section, nous allons faire fonctionner notre site Docusaurus pour le développement local. Le processus ne prend que quelques minutes.</p>
|
||||
<p><img src="/img/undraw_docusaurus_browser.svg" alt="Docusaurus browser"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="scaffold-the-site"></a><a href="#scaffold-the-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>Scaffold the Site</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="conception-du-site"></a><a href="#conception-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>Conception du site</h2>
|
||||
<ol>
|
||||
<li>Execute the <code>docusaurus-init</code> command in your terminal.</li>
|
||||
<li>Exécutez la commande <code>docusaurus-init</code> dans votre terminal.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">docusaurus-init
|
||||
</code></pre>
|
||||
<blockquote>
|
||||
<p>The <code>Linking dependencies...</code> step might take a while, but it will finish eventually.</p>
|
||||
<p>L'étape <code>Lier les dépendances... (Linking dependencies...)</code> peut prendre un certain temps, mais elle finira par se terminer.</p>
|
||||
</blockquote>
|
||||
<p>The following contents will be created in your current directory. Some example documentation pages (under <code>docs</code>) and blog posts (under <code>website/blog</code>) are included.</p>
|
||||
<p>Le contenu suivant sera créé dans votre répertoire courant. Quelques exemples de pages de documentation (sous <code>docs</code>) et des articles de blog (sous <code>website/blog</code>) sont inclus.</p>
|
||||
<pre><code class="hljs css language-sh">├── Dockerfile
|
||||
├── docker-compose.yml
|
||||
├── docs
|
||||
|
|
@ -130,12 +130,12 @@
|
|||
└── yarn.lock
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
<li>Run <code>cd website</code> to go into the <code>website</code> directory.</li>
|
||||
<li>Run <code>npm start</code> or <code>yarn start</code>.</li>
|
||||
<li>Exécutez <code>cd website</code> pour aller dans le répertoire <code>website</code>.</li>
|
||||
<li>Exécutez <code>npm start</code> ou <code>yarn start</code>.</li>
|
||||
</ol>
|
||||
<p>A browser window will open up at <a href="http://localhost:3000">http://localhost:3000</a>.</p>
|
||||
<p>Congratulations, you have just made your first Docusaurus site! Click around the pages to get a feel for it.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-setup"><span class="arrow-prev">← </span><span>Paramétrage</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-create-pages"><span>Créer des pages</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#scaffold-the-site">Scaffold the Site</a></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="
|
||||
<p>Une fenêtre de navigateur s'ouvrira à l'adresse <a href="http://localhost:3000">http://localhost:3000</a>.</p>
|
||||
<p>Félicitations, vous venez de faire votre premier site Docusaurus ! Cliquez sur les pages pour vous faire une idée.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-setup"><span class="arrow-prev">← </span><span>Paramétrage</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-create-pages"><span>Créer des pages</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#conception-du-site">Conception du site</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Create Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page."/><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>Create Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation."/><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,11 +80,11 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Create Pages</h1></header><article><div><span><p>In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page.</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">Create Pages</h1></header><article><div><span><p>Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation.</p>
|
||||
<p><img src="/img/undraw_docusaurus_tree.svg" alt="Docusaurus MacBook"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="creating-a-regular-page"></a><a href="#creating-a-regular-page" 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>Creating a Regular Page</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dune-page-ordinaire"></a><a href="#création-dune-page-ordinaire" 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'une page ordinaire</h2>
|
||||
<ol>
|
||||
<li><p>Go into the <code>pages/en</code> directory and create a file called <code>hello-world.js</code> with the following contents:</p>
|
||||
<li><p>Allez dans le répertoire <code>pages/en</code> et créez un fichier appelé <code>hello-world.js</code> avec le contenu suivant :</p>
|
||||
<p>const React = require('react');</p>
|
||||
<p>const CompLibrary = require('../../core/CompLibrary.js');</p>
|
||||
<p>const Container = CompLibrary.Container;
|
||||
|
|
@ -94,7 +94,7 @@ return (
|
|||
<div className="docMainWrapper wrapper">
|
||||
<Container className="mainContainer documentContainer postContainer">
|
||||
<h1>Hello World!</h1>
|
||||
<p>This is my first page!</p>
|
||||
<p>C'est ma première page !</p>
|
||||
</Container>
|
||||
</div>
|
||||
);
|
||||
|
|
@ -102,37 +102,37 @@ return (
|
|||
<p>module.exports = HelloWorld;</p></li>
|
||||
</ol>
|
||||
<ol start="2">
|
||||
<li>Go to <a href="http://localhost:3000/hello-world">http://localhost:3000/hello-world</a> and you should be able to see the new page.</li>
|
||||
<li>Change the text within the <code><p>...</p></code> to "I can write JSX here!". The browser should refresh automatically to reflect the changes.</li>
|
||||
<li>Allez à l'adresse <a href="http://localhost:3000/hello-world">http://localhost:3000/hello-world</a> et vous devriez pouvoir voir la nouvelle page.</li>
|
||||
<li>Changez le texte dans le <code><p>...</p></code> en "Je peux écrire du JSX ici !". Le navigateur devrait se rafraîchir automatiquement pour faire apparaître les changements.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-deletion">- <p>This is my first page!</p></span>
|
||||
<span class="hljs-addition">+ <p>I can write JSX here!</p></span>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-deletion">- <p>C'est ma première page !</p></span>
|
||||
<span class="hljs-addition">+ <p>Je peux écrire du JSX ici !</p></span>
|
||||
</code></pre>
|
||||
<p>React is being used as a templating engine for rendering static markup. You can leverage on the expressibility of React to build rich web content. Learn more about creating pages <a href="custom-pages">here</a>.</p>
|
||||
<p>React est utilisé comme moteur de template pour le rendu du balisage statique. Vous pouvez tirer parti de la puissance d'expression de React pour créer du contenu web riche. Apprenez en plus sur la création de pages <a href="custom-pages">ici</a>.</p>
|
||||
<p><img src="/img/undraw_docusaurus_react.svg" alt="Docusaurus React"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="create-a-documentation-page"></a><a href="#create-a-documentation-page" 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>Create a Documentation Page</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dune-page-de-documentation"></a><a href="#création-dune-page-de-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>Création d'une page de documentation</h2>
|
||||
<ol>
|
||||
<li><p>Create a new file in the <code>docs</code> folder called <code>doc4.md</code>. The <code>docs</code> folder is in the root of your Docusaurus project, one level above <code>website</code>.</p></li>
|
||||
<li><p>Paste the following contents:</p>
|
||||
<li><p>Créer un nouveau fichier dans le dossier <code>docs</code> appelé <code>doc4.md</code>. Le dossier <code>docs</code> est à la racine de votre projet Docusaurus, un niveau au-dessus de <code>website</code>.</p></li>
|
||||
<li><p>Collez le contenu suivant :</p>
|
||||
<hr>
|
||||
<p>id: doc4
|
||||
title: This is Doc 4</p>
|
||||
title: Il s'agit du Doc 4</p>
|
||||
<hr>
|
||||
<p>I can write content using <a href="https://github.github.com/gfm/">GitHub-flavored Markdown syntax</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="markdown-syntax"></a><a href="#markdown-syntax" 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>Markdown Syntax</h2>
|
||||
<p><strong>Bold</strong> <em>italic</em> <code>code</code> <a href="#url">Links</a></p>
|
||||
<p>Je peux écrire du contenu en utilisant la <a href="https://github.github.com/gfm/">syntaxe de Markdown flavored GitHub</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="syntaxe-de-markdown"></a><a href="#syntaxe-de-markdown" 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>Syntaxe de Markdown</h2>
|
||||
<p><strong>Gras</strong> <em>italique</em> <code>code</code> <a href="#url">Liens</a></p>
|
||||
<blockquote>
|
||||
<p>Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
|
||||
id sem consectetuer libero luctus adipiscing.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li>Hey</li>
|
||||
<li>Salut</li>
|
||||
<li>Ho</li>
|
||||
<li>Let's Go</li>
|
||||
<li>Allons-y</li>
|
||||
</ul></li>
|
||||
</ol>
|
||||
<ol start="3">
|
||||
<li>The <code>sidebars.json</code> is where you specify the order of your documentation pages, so open <code>website/sidebars.json</code> and add <code>"doc4"</code> after <code>"doc1"</code>. This ID should be the same one as in the metadata for the Markdown file above, so if you gave a different ID in Step 2, just make sure to use the same ID in the sidebar file.</li>
|
||||
<li>Le <code>sidebars.json</code> est l'endroit où vous spécifiez l'ordre de vos pages de documentation, alors ouvrez <code>website/sidebars.json</code> et ajoutez <code>"doc4"</code> après <code>"doc1"</code>. Cet ID doit être le même que dans les métadonnées du fichier Markdown ci-dessus, donc si vous avez donné un ID différent à l'étape 2, assurez-vous d'utiliser le même ID dans le fichier de la barre latérale.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-diff">{
|
||||
"docs": {
|
||||
|
|
@ -149,12 +149,12 @@ id sem consectetuer libero luctus adipiscing.</p>
|
|||
}
|
||||
</code></pre>
|
||||
<ol start="4">
|
||||
<li>A server restart is needed to pick up sidebar changes, so kill your dev server (<kbd>Cmd</kbd> + <kbd>C</kbd> or <kbd>Ctrl</kbd> + <kbd>C</kbd>) and restart it with <code>npm run start</code>.</li>
|
||||
<li>Navigate to <a href="http://localhost:3000/docs/doc4">http://localhost:3000/docs/doc4</a>.</li>
|
||||
<li>Un redémarrage du serveur est nécessaire pour récupérer les modifications de la barre latérale, alors tuez votre serveur de développement (<kbd>Cmd</kbd> + <kbd>C</kbd> ou <kbd>Ctrl</kbd> + <kbd>C</kbd>) et redémarrez-le avec <code>npm run start</code>.</li>
|
||||
<li>Naviguez vers l'adresse <a href="http://localhost:3000/docs/doc4">http://localhost:3000/docs/doc4</a>.</li>
|
||||
</ol>
|
||||
<p>You've created your first documentation page on Docusaurus!</p>
|
||||
<p>Learn more about creating docs pages <a href="navigation">here</a>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-create-new-site"><span class="arrow-prev">← </span><span>Créer un nouveau site</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-publish-site"><span>Publier le site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#creating-a-regular-page">Creating a Regular Page</a></li><li><a href="#create-a-documentation-page">Create a Documentation Page</a></li><li><a href="#markdown-syntax">Markdown Syntax</a></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="
|
||||
<p>Vous avez créé votre première page de documentation sur Docusaurus !</p>
|
||||
<p>Apprenez en plus sur la création de page de documentation <a href="navigation">ici</a>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-create-new-site"><span class="arrow-prev">← </span><span>Créer un nouveau site</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-publish-site"><span>Publier le site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#création-dune-page-ordinaire">Création d'une page ordinaire</a></li><li><a href="#création-dune-page-de-documentation">Création d'une page de documentation</a></li><li><a href="#syntaxe-de-markdown">Syntaxe de Markdown</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Create Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page."/><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>Create Pages · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Create Pages · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation."/><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,11 +80,11 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Create Pages</h1></header><article><div><span><p>In this section, we will learn about creating two types of pages in Docusaurus: a regular page and a documentation page.</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">Create Pages</h1></header><article><div><span><p>Dans cette section, nous apprendrons comment créer deux types de pages dans Docusaurus : une page normale et une page de documentation.</p>
|
||||
<p><img src="/img/undraw_docusaurus_tree.svg" alt="Docusaurus MacBook"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="creating-a-regular-page"></a><a href="#creating-a-regular-page" 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>Creating a Regular Page</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dune-page-ordinaire"></a><a href="#création-dune-page-ordinaire" 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'une page ordinaire</h2>
|
||||
<ol>
|
||||
<li><p>Go into the <code>pages/en</code> directory and create a file called <code>hello-world.js</code> with the following contents:</p>
|
||||
<li><p>Allez dans le répertoire <code>pages/en</code> et créez un fichier appelé <code>hello-world.js</code> avec le contenu suivant :</p>
|
||||
<p>const React = require('react');</p>
|
||||
<p>const CompLibrary = require('../../core/CompLibrary.js');</p>
|
||||
<p>const Container = CompLibrary.Container;
|
||||
|
|
@ -94,7 +94,7 @@ return (
|
|||
<div className="docMainWrapper wrapper">
|
||||
<Container className="mainContainer documentContainer postContainer">
|
||||
<h1>Hello World!</h1>
|
||||
<p>This is my first page!</p>
|
||||
<p>C'est ma première page !</p>
|
||||
</Container>
|
||||
</div>
|
||||
);
|
||||
|
|
@ -102,37 +102,37 @@ return (
|
|||
<p>module.exports = HelloWorld;</p></li>
|
||||
</ol>
|
||||
<ol start="2">
|
||||
<li>Go to <a href="http://localhost:3000/hello-world">http://localhost:3000/hello-world</a> and you should be able to see the new page.</li>
|
||||
<li>Change the text within the <code><p>...</p></code> to "I can write JSX here!". The browser should refresh automatically to reflect the changes.</li>
|
||||
<li>Allez à l'adresse <a href="http://localhost:3000/hello-world">http://localhost:3000/hello-world</a> et vous devriez pouvoir voir la nouvelle page.</li>
|
||||
<li>Changez le texte dans le <code><p>...</p></code> en "Je peux écrire du JSX ici !". Le navigateur devrait se rafraîchir automatiquement pour faire apparaître les changements.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-deletion">- <p>This is my first page!</p></span>
|
||||
<span class="hljs-addition">+ <p>I can write JSX here!</p></span>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-deletion">- <p>C'est ma première page !</p></span>
|
||||
<span class="hljs-addition">+ <p>Je peux écrire du JSX ici !</p></span>
|
||||
</code></pre>
|
||||
<p>React is being used as a templating engine for rendering static markup. You can leverage on the expressibility of React to build rich web content. Learn more about creating pages <a href="custom-pages">here</a>.</p>
|
||||
<p>React est utilisé comme moteur de template pour le rendu du balisage statique. Vous pouvez tirer parti de la puissance d'expression de React pour créer du contenu web riche. Apprenez en plus sur la création de pages <a href="custom-pages">ici</a>.</p>
|
||||
<p><img src="/img/undraw_docusaurus_react.svg" alt="Docusaurus React"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="create-a-documentation-page"></a><a href="#create-a-documentation-page" 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>Create a Documentation Page</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dune-page-de-documentation"></a><a href="#création-dune-page-de-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>Création d'une page de documentation</h2>
|
||||
<ol>
|
||||
<li><p>Create a new file in the <code>docs</code> folder called <code>doc4.md</code>. The <code>docs</code> folder is in the root of your Docusaurus project, one level above <code>website</code>.</p></li>
|
||||
<li><p>Paste the following contents:</p>
|
||||
<li><p>Créer un nouveau fichier dans le dossier <code>docs</code> appelé <code>doc4.md</code>. Le dossier <code>docs</code> est à la racine de votre projet Docusaurus, un niveau au-dessus de <code>website</code>.</p></li>
|
||||
<li><p>Collez le contenu suivant :</p>
|
||||
<hr>
|
||||
<p>id: doc4
|
||||
title: This is Doc 4</p>
|
||||
title: Il s'agit du Doc 4</p>
|
||||
<hr>
|
||||
<p>I can write content using <a href="https://github.github.com/gfm/">GitHub-flavored Markdown syntax</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="markdown-syntax"></a><a href="#markdown-syntax" 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>Markdown Syntax</h2>
|
||||
<p><strong>Bold</strong> <em>italic</em> <code>code</code> <a href="#url">Links</a></p>
|
||||
<p>Je peux écrire du contenu en utilisant la <a href="https://github.github.com/gfm/">syntaxe de Markdown flavored GitHub</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="syntaxe-de-markdown"></a><a href="#syntaxe-de-markdown" 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>Syntaxe de Markdown</h2>
|
||||
<p><strong>Gras</strong> <em>italique</em> <code>code</code> <a href="#url">Liens</a></p>
|
||||
<blockquote>
|
||||
<p>Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
|
||||
id sem consectetuer libero luctus adipiscing.</p>
|
||||
</blockquote>
|
||||
<ul>
|
||||
<li>Hey</li>
|
||||
<li>Salut</li>
|
||||
<li>Ho</li>
|
||||
<li>Let's Go</li>
|
||||
<li>Allons-y</li>
|
||||
</ul></li>
|
||||
</ol>
|
||||
<ol start="3">
|
||||
<li>The <code>sidebars.json</code> is where you specify the order of your documentation pages, so open <code>website/sidebars.json</code> and add <code>"doc4"</code> after <code>"doc1"</code>. This ID should be the same one as in the metadata for the Markdown file above, so if you gave a different ID in Step 2, just make sure to use the same ID in the sidebar file.</li>
|
||||
<li>Le <code>sidebars.json</code> est l'endroit où vous spécifiez l'ordre de vos pages de documentation, alors ouvrez <code>website/sidebars.json</code> et ajoutez <code>"doc4"</code> après <code>"doc1"</code>. Cet ID doit être le même que dans les métadonnées du fichier Markdown ci-dessus, donc si vous avez donné un ID différent à l'étape 2, assurez-vous d'utiliser le même ID dans le fichier de la barre latérale.</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-diff">{
|
||||
"docs": {
|
||||
|
|
@ -149,12 +149,12 @@ id sem consectetuer libero luctus adipiscing.</p>
|
|||
}
|
||||
</code></pre>
|
||||
<ol start="4">
|
||||
<li>A server restart is needed to pick up sidebar changes, so kill your dev server (<kbd>Cmd</kbd> + <kbd>C</kbd> or <kbd>Ctrl</kbd> + <kbd>C</kbd>) and restart it with <code>npm run start</code>.</li>
|
||||
<li>Navigate to <a href="http://localhost:3000/docs/doc4">http://localhost:3000/docs/doc4</a>.</li>
|
||||
<li>Un redémarrage du serveur est nécessaire pour récupérer les modifications de la barre latérale, alors tuez votre serveur de développement (<kbd>Cmd</kbd> + <kbd>C</kbd> ou <kbd>Ctrl</kbd> + <kbd>C</kbd>) et redémarrez-le avec <code>npm run start</code>.</li>
|
||||
<li>Naviguez vers l'adresse <a href="http://localhost:3000/docs/doc4">http://localhost:3000/docs/doc4</a>.</li>
|
||||
</ol>
|
||||
<p>You've created your first documentation page on Docusaurus!</p>
|
||||
<p>Learn more about creating docs pages <a href="navigation">here</a>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-create-new-site"><span class="arrow-prev">← </span><span>Créer un nouveau site</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-publish-site"><span>Publier le site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#creating-a-regular-page">Creating a Regular Page</a></li><li><a href="#create-a-documentation-page">Create a Documentation Page</a></li><li><a href="#markdown-syntax">Markdown Syntax</a></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="
|
||||
<p>Vous avez créé votre première page de documentation sur Docusaurus !</p>
|
||||
<p>Apprenez en plus sur la création de page de documentation <a href="navigation">ici</a>.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-create-new-site"><span class="arrow-prev">← </span><span>Créer un nouveau site</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-publish-site"><span>Publier le site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#création-dune-page-ordinaire">Création d'une page ordinaire</a></li><li><a href="#création-dune-page-de-documentation">Création d'une page de documentation</a></li><li><a href="#syntaxe-de-markdown">Syntaxe de Markdown</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -81,32 +81,32 @@
|
|||
}
|
||||
});
|
||||
</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">Publish the Site</h1></header><article><div><span><p><img src="/img/undraw_docusaurus_fb.svg" alt="Docusaurus Facebook"> {.docImage}</p>
|
||||
<p>Next, we'll learn how to publish the site to the WWW for everyone to browse! For the purpose of the tutorial, we'll use GitHub pages to host our website. But you can use any static file hosting service that you want, e.g. Netlify, Amazon S3, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<p>Ensuite, nous allons apprendre à publier le site sur le WWW pour que tout le monde puisse y naviguer ! Dans le cadre du tutoriel, nous utiliserons les pages GitHub pour héberger notre site Web. Mais vous pouvez utiliser n'importe quel service d'hébergement de fichiers statique que vous voulez, comme par exemple Netlify, Amazon S3, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="mettre-le-site-en-ligne"></a><a href="#mettre-le-site-en-ligne" 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>Mettre le site en ligne</h2>
|
||||
<p>Tuez d'abord le serveur web en appuyant sur Cmd + C ou Ctrl + C selon votre système d'exploitation.</p>
|
||||
<p>Dans <code>website/siteConfig.js</code>, remplissez les champs suivants :</p>
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
...
|
||||
url: 'https://USERNAME.github.io', // Replace USERNAME with your GitHub username.
|
||||
baseUrl: '/docusaurus-tutorial/', // The name of your GitHub project.
|
||||
projectName: 'docusaurus-tutorial', // The name of your GitHub project. Same as above.
|
||||
organizationName: 'USERNAME' // Your GitHub username.
|
||||
url: 'https://USERNAME.github.io', // Remplacez USERNAME avec votre nom d'utilisateur GitHub.
|
||||
baseUrl: '/docusaurus-tutorial/', // Le nom de votre projet GitHub.
|
||||
projectName: 'docusaurus-tutorial', // Le nom de votre projet GitHub. Identique au précédent.
|
||||
organizationName: 'USERNAME' // Votre nom d'utilisateur GitHub.
|
||||
...
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
<li><p>In the <code>website</code> directory, run <code>npm run build</code> or <code>yarn build</code>. Cela va générer un dossier <code>build</code> dans le dossier <code>website</code> contenant les fichiers <code>.html</code> de toute votre documentation et d'autres pages incluses dans <code>pages</code>. Make sure the <code>build</code> directory is there before running the next step.</p></li>
|
||||
<li><p>Replace <code><GIT_USER></code> with your GitHub username and run the following command.</p>
|
||||
<li><p>Dans le répertoire <code>website</code>, exécutez <code>npm run build</code> ou <code>yarn build</code>. Cela va générer un dossier <code>build</code> dans le dossier <code>website</code> contenant les fichiers <code>.html</code> de toute votre documentation et d'autres pages incluses dans <code>pages</code>. Assurez-vous que le répertoire <code>build</code> est là avant d'exécuter l'étape suivante.</p></li>
|
||||
<li><p>Remplacez <code><GIT_USER></code> par votre nom d'utilisateur GitHub et exécutez la commande suivante.</p>
|
||||
<p>$ GIT_USER=<GIT_USER> CURRENT_BRANCH=master USE_SSH=true npm run publish-gh-pages</p></li>
|
||||
</ol>
|
||||
<p>The built code will be pushed to the <code>gh-pages</code> branch of your repository.</p>
|
||||
<p>Le code construit sera poussé dans la branche <code>gh-pages</code> de votre dépôt.</p>
|
||||
<ol start="4">
|
||||
<li>Go to <code>https://USERNAME.github.io/docusaurus-tutorial/</code> and view your site in action!</li>
|
||||
<li>Allez sur <code>https://USERNAME.github.io/docusaurus-tutorial/</code> et regardez votre site en action !</li>
|
||||
</ol>
|
||||
<blockquote>
|
||||
<p>Note that when you run <code>npm run start</code> again, the <code>baseUrl</code> will now be part of the path.</p>
|
||||
<p>Notez que lorsque vous exécutez à nouveau <code>npm run start</code>, la <code>baseUrl</code> fera désormais partie du chemin.</p>
|
||||
</blockquote>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-create-pages"><span class="arrow-prev">← </span><span>Créer des pages</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-version"><span>Ajouter des versions</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#put-the-site-online">Put the Site Online</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-create-pages"><span class="arrow-prev">← </span><span>Créer des pages</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-version"><span>Ajouter des versions</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#mettre-le-site-en-ligne">Mettre le site en ligne</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -81,32 +81,32 @@
|
|||
}
|
||||
});
|
||||
</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">Publish the Site</h1></header><article><div><span><p><img src="/img/undraw_docusaurus_fb.svg" alt="Docusaurus Facebook"> {.docImage}</p>
|
||||
<p>Next, we'll learn how to publish the site to the WWW for everyone to browse! For the purpose of the tutorial, we'll use GitHub pages to host our website. But you can use any static file hosting service that you want, e.g. Netlify, Amazon S3, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="put-the-site-online"></a><a href="#put-the-site-online" 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>Put the Site Online</h2>
|
||||
<p>Kill the web server first by pressing Cmd + C or Ctrl + C depending on your operating system.</p>
|
||||
<p>In <code>website/siteConfig.js</code>, fill in the following fields:</p>
|
||||
<p>Ensuite, nous allons apprendre à publier le site sur le WWW pour que tout le monde puisse y naviguer ! Dans le cadre du tutoriel, nous utiliserons les pages GitHub pour héberger notre site Web. Mais vous pouvez utiliser n'importe quel service d'hébergement de fichiers statique que vous voulez, comme par exemple Netlify, Amazon S3, etc.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="mettre-le-site-en-ligne"></a><a href="#mettre-le-site-en-ligne" 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>Mettre le site en ligne</h2>
|
||||
<p>Tuez d'abord le serveur web en appuyant sur Cmd + C ou Ctrl + C selon votre système d'exploitation.</p>
|
||||
<p>Dans <code>website/siteConfig.js</code>, remplissez les champs suivants :</p>
|
||||
<pre><code class="hljs">const siteConfig = {
|
||||
...
|
||||
url: 'https://USERNAME.github.io', // Replace USERNAME with your GitHub username.
|
||||
baseUrl: '/docusaurus-tutorial/', // The name of your GitHub project.
|
||||
projectName: 'docusaurus-tutorial', // The name of your GitHub project. Same as above.
|
||||
organizationName: 'USERNAME' // Your GitHub username.
|
||||
url: 'https://USERNAME.github.io', // Remplacez USERNAME avec votre nom d'utilisateur GitHub.
|
||||
baseUrl: '/docusaurus-tutorial/', // Le nom de votre projet GitHub.
|
||||
projectName: 'docusaurus-tutorial', // Le nom de votre projet GitHub. Identique au précédent.
|
||||
organizationName: 'USERNAME' // Votre nom d'utilisateur GitHub.
|
||||
...
|
||||
}
|
||||
</code></pre>
|
||||
<ol start="2">
|
||||
<li><p>In the <code>website</code> directory, run <code>npm run build</code> or <code>yarn build</code>. Cela va générer un dossier <code>build</code> dans le dossier <code>website</code> contenant les fichiers <code>.html</code> de toute votre documentation et d'autres pages incluses dans <code>pages</code>. Make sure the <code>build</code> directory is there before running the next step.</p></li>
|
||||
<li><p>Replace <code><GIT_USER></code> with your GitHub username and run the following command.</p>
|
||||
<li><p>Dans le répertoire <code>website</code>, exécutez <code>npm run build</code> ou <code>yarn build</code>. Cela va générer un dossier <code>build</code> dans le dossier <code>website</code> contenant les fichiers <code>.html</code> de toute votre documentation et d'autres pages incluses dans <code>pages</code>. Assurez-vous que le répertoire <code>build</code> est là avant d'exécuter l'étape suivante.</p></li>
|
||||
<li><p>Remplacez <code><GIT_USER></code> par votre nom d'utilisateur GitHub et exécutez la commande suivante.</p>
|
||||
<p>$ GIT_USER=<GIT_USER> CURRENT_BRANCH=master USE_SSH=true npm run publish-gh-pages</p></li>
|
||||
</ol>
|
||||
<p>The built code will be pushed to the <code>gh-pages</code> branch of your repository.</p>
|
||||
<p>Le code construit sera poussé dans la branche <code>gh-pages</code> de votre dépôt.</p>
|
||||
<ol start="4">
|
||||
<li>Go to <code>https://USERNAME.github.io/docusaurus-tutorial/</code> and view your site in action!</li>
|
||||
<li>Allez sur <code>https://USERNAME.github.io/docusaurus-tutorial/</code> et regardez votre site en action !</li>
|
||||
</ol>
|
||||
<blockquote>
|
||||
<p>Note that when you run <code>npm run start</code> again, the <code>baseUrl</code> will now be part of the path.</p>
|
||||
<p>Notez que lorsque vous exécutez à nouveau <code>npm run start</code>, la <code>baseUrl</code> fera désormais partie du chemin.</p>
|
||||
</blockquote>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-create-pages"><span class="arrow-prev">← </span><span>Créer des pages</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-version"><span>Ajouter des versions</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#put-the-site-online">Put the Site Online</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-create-pages"><span class="arrow-prev">← </span><span>Créer des pages</span></a><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-version"><span>Ajouter des versions</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#mettre-le-site-en-ligne">Mettre le site en ligne</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Setting Up · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!"/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Setting Up · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!"/><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>Setting Up · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !"/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Setting Up · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !"/><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,62 +80,62 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Setting Up</h1></header><article><div><span><p>This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!</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">Setting Up</h1></header><article><div><span><p>Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !</p>
|
||||
<p><img src="/img/undraw_docusaurus_mountain.svg" alt="Docusaurus campfire"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-nodejs"></a><a href="#install-nodejs" 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>Install Node.js</h2>
|
||||
<p>Node.js is an environment that can run JavaScript code outside of a web browser and is used to write and run server-side JavaScript apps.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-nodejs"></a><a href="#installation-de-nodejs" 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>Installation de Node.js</h2>
|
||||
<p>Node.js est un environnement qui peut exécuter du code JavaScript en dehors d'un navigateur web et est utilisé pour écrire et exécuter des applications JavaScript côté serveur.</p>
|
||||
<blockquote>
|
||||
<p>Docusaurus' minimum supported Node.js version is Node 8, but more recent versions will work as well.</p>
|
||||
<p>La version minimale de Node.js supportée par Docusaurus est Node 8, mais des versions plus récentes fonctionneront également.</p>
|
||||
</blockquote>
|
||||
<ol>
|
||||
<li>Open your Terminal.</li>
|
||||
<li>If you have <code>brew</code> on your OS, run the following command to install Node (a JavaScript runtime that allows you to run JavaScript on the server) and <code>npm</code> the package manager (allows you to install npm modules from your terminal).</li>
|
||||
<li>Ouvrez votre Terminal.</li>
|
||||
<li>Si vous avez <code>brew</code> sur votre OS, exécutez la commande suivante pour installer Node (un runtime JavaScript qui vous permet d'exécuter JavaScript sur le serveur) et <code>npm</code> le gestionnaire de paquets (vous permet d'installer des modules npm depuis votre terminal).</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">brew install node
|
||||
</code></pre>
|
||||
<p>Alternatively, you can download an installer from the <a href="https://nodejs.org/en/">Node.js homepage</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="check-your-nodejs-installation"></a><a href="#check-your-nodejs-installation" 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>Check your Node.js installation</h2>
|
||||
<p>Check that you have the minimum required version installed by running the following command:</p>
|
||||
<p>Vous pouvez également télécharger un installateur depuis la <a href="https://nodejs.org/en/">page d'accueil Node.js</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="vérifification-de-votre-installation-de-nodejs"></a><a href="#vérifification-de-votre-installation-de-nodejs" 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>Vérifification de votre installation de Node.js</h2>
|
||||
<p>Vérifiez que vous avez la version minimale requise installée en exécutant la commande suivante :</p>
|
||||
<pre><code class="hljs css language-sh">node -v
|
||||
</code></pre>
|
||||
<p>You should see a version larger than Node 8.</p>
|
||||
<p>Vous devriez voir une version plus récente que Node 8.</p>
|
||||
<pre><code class="hljs css language-sh">node -v
|
||||
v8.15.1
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-yarn-optional"></a><a href="#install-yarn-optional" 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>Install Yarn (Optional)</h2>
|
||||
<p>We highly recommend you to install Yarn, an alternative package manager that has superb performance for managing your NPM dependencies. Check it out <a href="https://yarnpkg.com/en/docs/install">here</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-yarn-facultatif"></a><a href="#installation-de-yarn-facultatif" 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>Installation de Yarn (facultatif)</h2>
|
||||
<p>Nous vous recommandons fortement d'installer Yarn, un gestionnaire de paquets alternatif qui a de superbes performances pour gérer vos dépendances NPM. Découvrez le <a href="https://yarnpkg.com/en/docs/install">ici</a>.</p>
|
||||
<blockquote>
|
||||
<p>You can still proceed with the tutorial without Yarn.</p>
|
||||
<p>Vous pouvez continuer le tutoriel sans Yarn.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="create-a-github-repository"></a><a href="#create-a-github-repository" 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>Create a GitHub Repository</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dun-dépôt-github"></a><a href="#création-dun-dépôt-github" 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 dépôt GitHub</h2>
|
||||
<ol>
|
||||
<li>Go to <a href="https://github.com/">https://github.com/</a> and sign up for an account if you don't already have one.</li>
|
||||
<li>Click on <strong>"New Repository"</strong> or go to <a href="https://github.com/new">https://github.com/new</a>.</li>
|
||||
<li>Name your repository without spaces. For e.g. <code>docusaurus-tutorial</code>.</li>
|
||||
<li>Proceed to create the repository without adding <code>.gitignore</code> or a license.</li>
|
||||
<li>Allez sur <a href="https://github.com/">https://github.com/</a> et créez un compte si vous n'en avez pas déjà un.</li>
|
||||
<li>Cliquez sur <strong>"Nouveau dépôt" ("New Repository")</strong> ou allez sur <a href="https://github.com/new">https://github.com/new</a>.</li>
|
||||
<li>Nommez votre dépôt sans espaces. Par exemple, <code>docusaurus-tutorial</code>.</li>
|
||||
<li>Procédez à la création du dépôt sans ajouter <code>.gitignore</code> ou une licence.</li>
|
||||
</ol>
|
||||
<p><img src="/img/tutorial-git-clone.png" alt="GitHub create repo"> {.docImage}</p>
|
||||
<ol start="5">
|
||||
<li>Clone your repository to your local machine:</li>
|
||||
<li>Clonez votre dépôt sur votre machine locale :</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">git <span class="hljs-built_in">clone</span> git@github.com:USERNAME/docusaurus-tutorial.git <span class="hljs-comment"># SSH</span>
|
||||
<span class="hljs-comment"># or</span>
|
||||
<span class="hljs-comment"># ou</span>
|
||||
git <span class="hljs-built_in">clone</span> https://github.com/USERNAME/docusaurus-tutorial.git <span class="hljs-comment"># HTTPS</span>
|
||||
</code></pre>
|
||||
<ol start="6">
|
||||
<li><code>cd</code> into the repository which you just created.</li>
|
||||
<li><code>cd</code> dans le dépôt que vous venez de créer.</li>
|
||||
</ol>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-the-docusaurus-init-command"></a><a href="#install-the-docusaurus-init-command" 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>Install the Docusaurus init command</h2>
|
||||
<p>Docusaurus comes with a command line tool to help you scaffold a Docusaurus site with some example templates. Let's install the installer!</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-la-commande-init-de-docusaurus"></a><a href="#installation-de-la-commande-init-de-docusaurus" 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>Installation de la commande init de Docusaurus</h2>
|
||||
<p>Docusaurus est livré avec un outil en ligne de commande pour vous aider à concevoir un site Docusaurus avec quelques exemples de modèles. Installons l'installateur !</p>
|
||||
<ol>
|
||||
<li>Run the following command:</li>
|
||||
<li>Exécutez la commande suivante :</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">npm install --global docusaurus-init
|
||||
</code></pre>
|
||||
<p>or if you have Yarn:</p>
|
||||
<p>ou si vous avez Yarn :</p>
|
||||
<pre><code class="hljs css language-sh">yarn global add docusaurus-init
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-create-new-site"><span>Créer un nouveau site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#install-nodejs">Install Node.js</a></li><li><a href="#check-your-nodejs-installation">Check your Node.js installation</a></li><li><a href="#install-yarn-optional">Install Yarn (Optional)</a></li><li><a href="#create-a-github-repository">Create a GitHub Repository</a></li><li><a href="#install-the-docusaurus-init-command">Install the Docusaurus init command</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-create-new-site"><span>Créer un nouveau site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#installation-de-nodejs">Installation de Node.js</a></li><li><a href="#vérifification-de-votre-installation-de-nodejs">Vérifification de votre installation de Node.js</a></li><li><a href="#installation-de-yarn-facultatif">Installation de Yarn (facultatif)</a></li><li><a href="#création-dun-dépôt-github">Création d'un dépôt GitHub</a></li><li><a href="#installation-de-la-commande-init-de-docusaurus">Installation de la commande init de Docusaurus</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Setting Up · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!"/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Setting Up · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!"/><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>Setting Up · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !"/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Setting Up · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !"/><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,62 +80,62 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Setting Up</h1></header><article><div><span><p>This tutorial is geared at first-time users who want detailed instructions on how to go from zero to a Docusaurus website that has versions. Let's start!</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">Setting Up</h1></header><article><div><span><p>Ce tutoriel s'adresse aux nouveaux utilisateurs qui veulent des instructions détaillées sur la façon de passer de zéro à un site Web Docusaurus avec des versions. C'est parti !</p>
|
||||
<p><img src="/img/undraw_docusaurus_mountain.svg" alt="Docusaurus campfire"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-nodejs"></a><a href="#install-nodejs" 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>Install Node.js</h2>
|
||||
<p>Node.js is an environment that can run JavaScript code outside of a web browser and is used to write and run server-side JavaScript apps.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-nodejs"></a><a href="#installation-de-nodejs" 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>Installation de Node.js</h2>
|
||||
<p>Node.js est un environnement qui peut exécuter du code JavaScript en dehors d'un navigateur web et est utilisé pour écrire et exécuter des applications JavaScript côté serveur.</p>
|
||||
<blockquote>
|
||||
<p>Docusaurus' minimum supported Node.js version is Node 8, but more recent versions will work as well.</p>
|
||||
<p>La version minimale de Node.js supportée par Docusaurus est Node 8, mais des versions plus récentes fonctionneront également.</p>
|
||||
</blockquote>
|
||||
<ol>
|
||||
<li>Open your Terminal.</li>
|
||||
<li>If you have <code>brew</code> on your OS, run the following command to install Node (a JavaScript runtime that allows you to run JavaScript on the server) and <code>npm</code> the package manager (allows you to install npm modules from your terminal).</li>
|
||||
<li>Ouvrez votre Terminal.</li>
|
||||
<li>Si vous avez <code>brew</code> sur votre OS, exécutez la commande suivante pour installer Node (un runtime JavaScript qui vous permet d'exécuter JavaScript sur le serveur) et <code>npm</code> le gestionnaire de paquets (vous permet d'installer des modules npm depuis votre terminal).</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">brew install node
|
||||
</code></pre>
|
||||
<p>Alternatively, you can download an installer from the <a href="https://nodejs.org/en/">Node.js homepage</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="check-your-nodejs-installation"></a><a href="#check-your-nodejs-installation" 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>Check your Node.js installation</h2>
|
||||
<p>Check that you have the minimum required version installed by running the following command:</p>
|
||||
<p>Vous pouvez également télécharger un installateur depuis la <a href="https://nodejs.org/en/">page d'accueil Node.js</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="vérifification-de-votre-installation-de-nodejs"></a><a href="#vérifification-de-votre-installation-de-nodejs" 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>Vérifification de votre installation de Node.js</h2>
|
||||
<p>Vérifiez que vous avez la version minimale requise installée en exécutant la commande suivante :</p>
|
||||
<pre><code class="hljs css language-sh">node -v
|
||||
</code></pre>
|
||||
<p>You should see a version larger than Node 8.</p>
|
||||
<p>Vous devriez voir une version plus récente que Node 8.</p>
|
||||
<pre><code class="hljs css language-sh">node -v
|
||||
v8.15.1
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-yarn-optional"></a><a href="#install-yarn-optional" 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>Install Yarn (Optional)</h2>
|
||||
<p>We highly recommend you to install Yarn, an alternative package manager that has superb performance for managing your NPM dependencies. Check it out <a href="https://yarnpkg.com/en/docs/install">here</a>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-yarn-facultatif"></a><a href="#installation-de-yarn-facultatif" 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>Installation de Yarn (facultatif)</h2>
|
||||
<p>Nous vous recommandons fortement d'installer Yarn, un gestionnaire de paquets alternatif qui a de superbes performances pour gérer vos dépendances NPM. Découvrez le <a href="https://yarnpkg.com/en/docs/install">ici</a>.</p>
|
||||
<blockquote>
|
||||
<p>You can still proceed with the tutorial without Yarn.</p>
|
||||
<p>Vous pouvez continuer le tutoriel sans Yarn.</p>
|
||||
</blockquote>
|
||||
<h2><a class="anchor" aria-hidden="true" id="create-a-github-repository"></a><a href="#create-a-github-repository" 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>Create a GitHub Repository</h2>
|
||||
<h2><a class="anchor" aria-hidden="true" id="création-dun-dépôt-github"></a><a href="#création-dun-dépôt-github" 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 dépôt GitHub</h2>
|
||||
<ol>
|
||||
<li>Go to <a href="https://github.com/">https://github.com/</a> and sign up for an account if you don't already have one.</li>
|
||||
<li>Click on <strong>"New Repository"</strong> or go to <a href="https://github.com/new">https://github.com/new</a>.</li>
|
||||
<li>Name your repository without spaces. For e.g. <code>docusaurus-tutorial</code>.</li>
|
||||
<li>Proceed to create the repository without adding <code>.gitignore</code> or a license.</li>
|
||||
<li>Allez sur <a href="https://github.com/">https://github.com/</a> et créez un compte si vous n'en avez pas déjà un.</li>
|
||||
<li>Cliquez sur <strong>"Nouveau dépôt" ("New Repository")</strong> ou allez sur <a href="https://github.com/new">https://github.com/new</a>.</li>
|
||||
<li>Nommez votre dépôt sans espaces. Par exemple, <code>docusaurus-tutorial</code>.</li>
|
||||
<li>Procédez à la création du dépôt sans ajouter <code>.gitignore</code> ou une licence.</li>
|
||||
</ol>
|
||||
<p><img src="/img/tutorial-git-clone.png" alt="GitHub create repo"> {.docImage}</p>
|
||||
<ol start="5">
|
||||
<li>Clone your repository to your local machine:</li>
|
||||
<li>Clonez votre dépôt sur votre machine locale :</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">git <span class="hljs-built_in">clone</span> git@github.com:USERNAME/docusaurus-tutorial.git <span class="hljs-comment"># SSH</span>
|
||||
<span class="hljs-comment"># or</span>
|
||||
<span class="hljs-comment"># ou</span>
|
||||
git <span class="hljs-built_in">clone</span> https://github.com/USERNAME/docusaurus-tutorial.git <span class="hljs-comment"># HTTPS</span>
|
||||
</code></pre>
|
||||
<ol start="6">
|
||||
<li><code>cd</code> into the repository which you just created.</li>
|
||||
<li><code>cd</code> dans le dépôt que vous venez de créer.</li>
|
||||
</ol>
|
||||
<h2><a class="anchor" aria-hidden="true" id="install-the-docusaurus-init-command"></a><a href="#install-the-docusaurus-init-command" 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>Install the Docusaurus init command</h2>
|
||||
<p>Docusaurus comes with a command line tool to help you scaffold a Docusaurus site with some example templates. Let's install the installer!</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="installation-de-la-commande-init-de-docusaurus"></a><a href="#installation-de-la-commande-init-de-docusaurus" 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>Installation de la commande init de Docusaurus</h2>
|
||||
<p>Docusaurus est livré avec un outil en ligne de commande pour vous aider à concevoir un site Docusaurus avec quelques exemples de modèles. Installons l'installateur !</p>
|
||||
<ol>
|
||||
<li>Run the following command:</li>
|
||||
<li>Exécutez la commande suivante :</li>
|
||||
</ol>
|
||||
<pre><code class="hljs css language-sh">npm install --global docusaurus-init
|
||||
</code></pre>
|
||||
<p>or if you have Yarn:</p>
|
||||
<p>ou si vous avez Yarn :</p>
|
||||
<pre><code class="hljs css language-sh">yarn global add docusaurus-init
|
||||
</code></pre>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-create-new-site"><span>Créer un nouveau site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#install-nodejs">Install Node.js</a></li><li><a href="#check-your-nodejs-installation">Check your Node.js installation</a></li><li><a href="#install-yarn-optional">Install Yarn (Optional)</a></li><li><a href="#create-a-github-repository">Create a GitHub Repository</a></li><li><a href="#install-the-docusaurus-init-command">Install the Docusaurus init command</a></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="
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-next button" href="/docs/fr/1.11.x/tutorial-create-new-site"><span>Créer un nouveau site</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#installation-de-nodejs">Installation de Node.js</a></li><li><a href="#vérifification-de-votre-installation-de-nodejs">Vérifification de votre installation de Node.js</a></li><li><a href="#installation-de-yarn-facultatif">Installation de Yarn (facultatif)</a></li><li><a href="#création-dun-dépôt-github">Création d'un dépôt GitHub</a></li><li><a href="#installation-de-la-commande-init-de-docusaurus">Installation de la commande init de Docusaurus</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Add Versions · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Add Versions · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes."/><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>Add Versions · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Add Versions · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée."/><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,39 +80,39 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Add Versions</h1></header><article><div><span><p>With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes.</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">Add Versions</h1></header><article><div><span><p>Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée.</p>
|
||||
<p><img src="/img/undraw_docusaurus_process.svg" alt="Docusaurus process"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="releasing-a-version"></a><a href="#releasing-a-version" 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>Releasing a Version</h2>
|
||||
<p>Assuming we are happy with the current state of the documentation and we want to freeze it as the v1.0.0 docs. We first run the following command to generate a <code>versions.js</code> file, which will be used to list down all the versions of docs in the project.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="libérer-une-version"></a><a href="#libérer-une-version" 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>Libérer une version</h2>
|
||||
<p>En supposant que nous sommes satisfaits de l'état actuel de la documentation et que nous voulons la geler comme la documentation v1.0.0. Nous exécutons d'abord la commande suivante pour générer un fichier <code>versions.js</code> , qui sera utilisé pour lister toutes les versions de documents du projet.</p>
|
||||
<pre><code class="hljs css language-sh">npm run examples versions <span class="hljs-comment"># yarn examples versions</span>
|
||||
</code></pre>
|
||||
<p>Next, we run a command with the version we want to create, e.g. 1.0.0,</p>
|
||||
<p>Ensuite, nous exécutons une commande avec la version que nous voulons créer, par exemple 1.0.0,</p>
|
||||
<pre><code class="hljs css language-sh">npm run version 1.0.0 <span class="hljs-comment"># yarn version 1.0.0</span>
|
||||
</code></pre>
|
||||
<p>This will preserve all documents currently in the <code>docs</code> directory and make them available as documentation for version 1.0.0.</p>
|
||||
<p>Documents in the <code>docs</code> directory will be considered part of version next and they are available, for example, at the URL <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Documents from the latest version use the URL <code>docs/doc1</code>.</p>
|
||||
<p>Let's test out that versioning actually works. We can go to <code>docs/doc1.md</code> and change the first line of the body:</p>
|
||||
<p>Cela préservera tous les documents actuellement dans le répertoire <code>docs</code> et les rendra disponibles en tant que documentation pour la version 1.0.0.</p>
|
||||
<p>Les documents dans le répertoire <code>docs</code> seront considérés comme faisant partie de la version suivante et sont disponibles, par exemple, à l'URL <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Les documents de la dernière version utilisent l'URL <code>docs/doc1</code>.</p>
|
||||
<p>Testons comment le versionnage fonctionne réellement. On peut aller dans <code>docs/doc1.md</code> et changer la première ligne du corps :</p>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-comment">---</span>
|
||||
id: doc1
|
||||
title: Latin-ish
|
||||
sidebar_label: Example Page
|
||||
sidebar_label: Page d'exemple
|
||||
<span class="hljs-comment">---</span>
|
||||
|
||||
<span class="hljs-deletion">- Check the [documentation](https://docusaurus.io) for how to use Docusaurus.</span>
|
||||
<span class="hljs-addition">+ This is the latest version of the docs.</span>
|
||||
<span class="hljs-deletion">- Vérifiez la [documentation](https://docusaurus.io) pour savoir comment utiliser Docusaurus.</span>
|
||||
<span class="hljs-addition">+ Ceci est la dernière version de la documentation.</span>
|
||||
|
||||
## Lorem
|
||||
|
||||
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies.
|
||||
</code></pre>
|
||||
<p>If we go to the <code>localhost:3000/<baseUrl>/docs/doc1</code> URL in our browser, realize that it's still showing the previous line. That's because the version we're looking at now is the 1.0.0 version, which has already been frozen in time.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="next-version"></a><a href="#next-version" 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>Next Version</h2>
|
||||
<p>The latest versions of the docs have to be accessed by adding <code>next</code> to the URL: <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Note that the version beside the title also changes to <code>next</code> when we are on that URL.</p>
|
||||
<p>A versions page has been created for us at <code>localhost:3000/<baseUrl>/versions</code> which shows a list of the current versions of the documentation. See that both <code>1.0.0</code> and <code>master</code> are being listed here and they correctly link to the respective versions of the documentation.</p>
|
||||
<p>Go ahead and publish your versioned site!</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="wrap-up"></a><a href="#wrap-up" 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>Wrap Up</h2>
|
||||
<p>That's all folks! In this short tutorial, you have experienced how easy it was to create a documentation website from scratch and making versions for them. There are many more things you can do with Docusaurus, such as adding a blog, search and translations. Check out the Guides section for more.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-publish-site"><span class="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#releasing-a-version">Releasing a Version</a></li><li><a href="#next-version">Next Version</a></li><li><a href="#wrap-up">Wrap Up</a></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="
|
||||
<p>Si nous allons à l'URL <code>localhost:3000/<baseUrl>/docs/doc1</code> dans notre navigateur, nous réalisons qu'elle montre toujours la ligne précédente. C'est parce que la version que nous regardons maintenant la version 1.0.0, qui a déjà été figée dans le temps.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="prochaine-version"></a><a href="#prochaine-version" 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>Prochaine version</h2>
|
||||
<p>Les dernières versions de la documentation doivent être accessibles en ajoutant <code>next</code> à l'URL : <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Notez que la version à côté du titre change également à <code>next</code> lorsque nous sommes sur cette URL.</p>
|
||||
<p>Une page de versions a été créée pour nous à l'adresse <code>localhost:3000/<baseUrl>/versions</code> qui affiche une liste des versions actuelles de la documentation. Vous voyez que <code>1.0.0</code> et <code>master</code> sont toutes les deux listées ici et qu'elles sont correctement liées aux versions respectives de la documentation.</p>
|
||||
<p>Allez-y et publiez votre site versionné !</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="récapitulatif"></a><a href="#récapitulatif" 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>Récapitulatif</h2>
|
||||
<p>C'est fini, Mesdames Messieurs ! Dans ce court tutoriel, vous avez pu constater à quel point il était facile de créer un site Web de documentation à partir de zéro et de créer des versions. Il y a bien d'autres choses que vous pouvez faire avec Docusaurus, comme ajouter un blog, rechercher et traduire. Consultez la section Guides pour en savoir plus.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-publish-site"><span class="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#libérer-une-version">Libérer une version</a></li><li><a href="#prochaine-version">Prochaine version</a></li><li><a href="#récapitulatif">Récapitulatif</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Add Versions · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Add Versions · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes."/><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>Add Versions · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée."/><meta name="docsearch:version" content="1.11.x"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Add Versions · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée."/><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,39 +80,39 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Add Versions</h1></header><article><div><span><p>With an example site deployed, we can now try out one of the killer features of Docusaurus - versioned documentation. Versioned documentation helps to show relevant documentation to the users for the current version of the tool they are using and also hide unreleased documentation from users, reducing confusion. Documentations for older versions are also preserved and accessible to users of older versions of the tool even as the latest documentation changes.</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">Add Versions</h1></header><article><div><span><p>Avec un site d'exemple déployé, nous pouvons maintenant essayer l'une des fonctionnalités mortelles de Docusaurus - la documentation versionnée. La documentation versionnée aide à afficher la documentation pertinente aux utilisateurs pour la version actuelle de l'outil qu'ils utilisent et masque également la documentation non publiée aux utilisateurs, en réduisant la confusion. Les documentations pour les anciennes versions sont également conservées et accessibles aux utilisateurs des anciennes versions de l'outil même lorsque la dernière documentation est modifiée.</p>
|
||||
<p><img src="/img/undraw_docusaurus_process.svg" alt="Docusaurus process"> {.docImage}</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="releasing-a-version"></a><a href="#releasing-a-version" 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>Releasing a Version</h2>
|
||||
<p>Assuming we are happy with the current state of the documentation and we want to freeze it as the v1.0.0 docs. We first run the following command to generate a <code>versions.js</code> file, which will be used to list down all the versions of docs in the project.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="libérer-une-version"></a><a href="#libérer-une-version" 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>Libérer une version</h2>
|
||||
<p>En supposant que nous sommes satisfaits de l'état actuel de la documentation et que nous voulons la geler comme la documentation v1.0.0. Nous exécutons d'abord la commande suivante pour générer un fichier <code>versions.js</code> , qui sera utilisé pour lister toutes les versions de documents du projet.</p>
|
||||
<pre><code class="hljs css language-sh">npm run examples versions <span class="hljs-comment"># yarn examples versions</span>
|
||||
</code></pre>
|
||||
<p>Next, we run a command with the version we want to create, e.g. 1.0.0,</p>
|
||||
<p>Ensuite, nous exécutons une commande avec la version que nous voulons créer, par exemple 1.0.0,</p>
|
||||
<pre><code class="hljs css language-sh">npm run version 1.0.0 <span class="hljs-comment"># yarn version 1.0.0</span>
|
||||
</code></pre>
|
||||
<p>This will preserve all documents currently in the <code>docs</code> directory and make them available as documentation for version 1.0.0.</p>
|
||||
<p>Documents in the <code>docs</code> directory will be considered part of version next and they are available, for example, at the URL <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Documents from the latest version use the URL <code>docs/doc1</code>.</p>
|
||||
<p>Let's test out that versioning actually works. We can go to <code>docs/doc1.md</code> and change the first line of the body:</p>
|
||||
<p>Cela préservera tous les documents actuellement dans le répertoire <code>docs</code> et les rendra disponibles en tant que documentation pour la version 1.0.0.</p>
|
||||
<p>Les documents dans le répertoire <code>docs</code> seront considérés comme faisant partie de la version suivante et sont disponibles, par exemple, à l'URL <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Les documents de la dernière version utilisent l'URL <code>docs/doc1</code>.</p>
|
||||
<p>Testons comment le versionnage fonctionne réellement. On peut aller dans <code>docs/doc1.md</code> et changer la première ligne du corps :</p>
|
||||
<pre><code class="hljs css language-diff"><span class="hljs-comment">---</span>
|
||||
id: doc1
|
||||
title: Latin-ish
|
||||
sidebar_label: Example Page
|
||||
sidebar_label: Page d'exemple
|
||||
<span class="hljs-comment">---</span>
|
||||
|
||||
<span class="hljs-deletion">- Check the [documentation](https://docusaurus.io) for how to use Docusaurus.</span>
|
||||
<span class="hljs-addition">+ This is the latest version of the docs.</span>
|
||||
<span class="hljs-deletion">- Vérifiez la [documentation](https://docusaurus.io) pour savoir comment utiliser Docusaurus.</span>
|
||||
<span class="hljs-addition">+ Ceci est la dernière version de la documentation.</span>
|
||||
|
||||
## Lorem
|
||||
|
||||
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies.
|
||||
</code></pre>
|
||||
<p>If we go to the <code>localhost:3000/<baseUrl>/docs/doc1</code> URL in our browser, realize that it's still showing the previous line. That's because the version we're looking at now is the 1.0.0 version, which has already been frozen in time.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="next-version"></a><a href="#next-version" 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>Next Version</h2>
|
||||
<p>The latest versions of the docs have to be accessed by adding <code>next</code> to the URL: <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Note that the version beside the title also changes to <code>next</code> when we are on that URL.</p>
|
||||
<p>A versions page has been created for us at <code>localhost:3000/<baseUrl>/versions</code> which shows a list of the current versions of the documentation. See that both <code>1.0.0</code> and <code>master</code> are being listed here and they correctly link to the respective versions of the documentation.</p>
|
||||
<p>Go ahead and publish your versioned site!</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="wrap-up"></a><a href="#wrap-up" 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>Wrap Up</h2>
|
||||
<p>That's all folks! In this short tutorial, you have experienced how easy it was to create a documentation website from scratch and making versions for them. There are many more things you can do with Docusaurus, such as adding a blog, search and translations. Check out the Guides section for more.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-publish-site"><span class="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#releasing-a-version">Releasing a Version</a></li><li><a href="#next-version">Next Version</a></li><li><a href="#wrap-up">Wrap Up</a></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="
|
||||
<p>Si nous allons à l'URL <code>localhost:3000/<baseUrl>/docs/doc1</code> dans notre navigateur, nous réalisons qu'elle montre toujours la ligne précédente. C'est parce que la version que nous regardons maintenant la version 1.0.0, qui a déjà été figée dans le temps.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="prochaine-version"></a><a href="#prochaine-version" 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>Prochaine version</h2>
|
||||
<p>Les dernières versions de la documentation doivent être accessibles en ajoutant <code>next</code> à l'URL : <code>localhost:3000/<baseUrl>/docs/next/doc1</code>. Notez que la version à côté du titre change également à <code>next</code> lorsque nous sommes sur cette URL.</p>
|
||||
<p>Une page de versions a été créée pour nous à l'adresse <code>localhost:3000/<baseUrl>/versions</code> qui affiche une liste des versions actuelles de la documentation. Vous voyez que <code>1.0.0</code> et <code>master</code> sont toutes les deux listées ici et qu'elles sont correctement liées aux versions respectives de la documentation.</p>
|
||||
<p>Allez-y et publiez votre site versionné !</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="récapitulatif"></a><a href="#récapitulatif" 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>Récapitulatif</h2>
|
||||
<p>C'est fini, Mesdames Messieurs ! Dans ce court tutoriel, vous avez pu constater à quel point il était facile de créer un site Web de documentation à partir de zéro et de créer des versions. Il y a bien d'autres choses que vous pouvez faire avec Docusaurus, comme ajouter un blog, rechercher et traduire. Consultez la section Guides pour en savoir plus.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.11.x/tutorial-publish-site"><span class="arrow-prev">← </span><span>Publier le site</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#libérer-une-version">Libérer une version</a></li><li><a href="#prochaine-version">Prochaine version</a></li><li><a href="#récapitulatif">Récapitulatif</a></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="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
|
|||
|
|
@ -94,7 +94,7 @@
|
|||
},
|
||||
...
|
||||
</code></pre>
|
||||
<p>Run the script with a command line argument of the version you wish to create. e.g.,</p>
|
||||
<p>Run the script with a command line argument of the version you wish to create. Par exemple :</p>
|
||||
<pre><code class="hljs css language-bash">yarn run version 1.0.0
|
||||
</code></pre>
|
||||
<p>This will preserve all documents currently in the <code>docs</code> directory and make them available as documentation for version <code>1.0.0</code>.</p>
|
||||
|
|
@ -132,7 +132,7 @@
|
|||
},
|
||||
...
|
||||
</code></pre>
|
||||
<p>Run the script with command line arguments of first, the current version name, then second, the new version name. e.g.,</p>
|
||||
<p>Run the script with command line arguments of first, the current version name, then second, the new version name. Par exemple :</p>
|
||||
<pre><code class="hljs css language-bash">yarn run rename-version 1.0.0 1.0.1
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="versioning-and-translations"></a><a href="#versioning-and-translations" 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>Versioning and Translations</h2>
|
||||
|
|
|
|||
|
|
@ -94,7 +94,7 @@
|
|||
},
|
||||
...
|
||||
</code></pre>
|
||||
<p>Run the script with a command line argument of the version you wish to create. e.g.,</p>
|
||||
<p>Run the script with a command line argument of the version you wish to create. Par exemple :</p>
|
||||
<pre><code class="hljs css language-bash">yarn run version 1.0.0
|
||||
</code></pre>
|
||||
<p>This will preserve all documents currently in the <code>docs</code> directory and make them available as documentation for version <code>1.0.0</code>.</p>
|
||||
|
|
@ -132,7 +132,7 @@
|
|||
},
|
||||
...
|
||||
</code></pre>
|
||||
<p>Run the script with command line arguments of first, the current version name, then second, the new version name. e.g.,</p>
|
||||
<p>Run the script with command line arguments of first, the current version name, then second, the new version name. Par exemple :</p>
|
||||
<pre><code class="hljs css language-bash">yarn run rename-version 1.0.0 1.0.1
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="versioning-and-translations"></a><a href="#versioning-and-translations" 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>Versioning and Translations</h2>
|
||||
|
|
|
|||
|
|
@ -104,7 +104,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="options-dentête"></a><a href="#options-dentête" 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>Options d'entête</h2>
|
||||
<p>Le seul champ requis est <code>title</code>, cependant, nous fournissons des options pour ajouter des informations sur l'auteur à votre blog ainsi que d'autres options.</p>
|
||||
<ul>
|
||||
<li><code>auteur</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>author</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>authorURL</code> - L'URL associée à l'auteur. Ceci pourrait être un compte Twitter, GitHub, Facebook, etc.</li>
|
||||
<li><code>authorFBID</code> - L'ID de profil Facebook qui est utilisé pour récupérer l'image de profil.</li>
|
||||
<li><code>authorImageURL</code> - L'URL vers l'image de l'auteur. (Remarque : Si vous utilisez à la fois <code>authorFBID</code> et <code>authorImageURL</code>, <code>authorFBID</code> prendra la priorité. N’incluez pas <code>authorFBID</code> si vous voulez que <code>authorImageURL</code> apparaisse.)</li>
|
||||
|
|
@ -131,7 +131,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale"></a><a href="#changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale" 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>Changer le nombre de messages du blog sur la barre latérale</h2>
|
||||
<p>Par défaut, 5 messages récents sont affichés sur la barre latérale.</p>
|
||||
<p>Vous pouvez configurer un nombre spécifique de messages de blog à afficher en ajoutant un paramètre <code>blogSidebarCount</code> à votre <code>siteConfig.js</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>"ALL"</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>'ALL'</code>.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-js">blogSidebarCount: <span class="hljs-string">'ALL'</span>,
|
||||
</code></pre>
|
||||
|
|
@ -145,7 +145,7 @@
|
|||
<p>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 ajoutées sur le tag HTML <code><HEAD></code> de votre page web.</p>
|
||||
<p>Un résumé du texte du message est fourni dans le flux RSS depuis <code><!--truncate--></code>. Si aucune balise <code><!--truncate--></code> n'est trouvée, alors tout le texte jusqu'au 250ème caractère sera utilisé.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="boutons-de-réseaux-sociaux"></a><a href="#boutons-de-réseaux-sociaux" 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>Boutons de réseaux sociaux</h2>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et / ou Twitter au bas de vos billets, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> <a href="/docs/fr/1.12.0/site-config">configuration du site</a> options dans <code>siteConfig.js</code>.</p>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et/ou Twitter au bas de vos articles de blog, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> de la <a href="/docs/fr/1.12.0/site-config">configuration du site</a> dans <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="sujets-avancés"></a><a href="#sujets-avancés" 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>Sujets avancés</h2>
|
||||
<h3><a class="anchor" aria-hidden="true" id="je-veux-exécuter-en-mode-blog-uniquement"></a><a href="#je-veux-exécuter-en-mode-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>Je veux exécuter en mode "Blog uniquement".</h3>
|
||||
<p>Vous pouvez exécuter votre site Docusaurus sans page d'accueil et avoir en premier votre blog.</p>
|
||||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Maintenant, lorsque Docusaurus génère ou construit votre site, il copiera le fichier de <code>static/index.html</code> 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 <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez utiliser ce modèle :</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
|
|
@ -104,7 +104,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="options-dentête"></a><a href="#options-dentête" 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>Options d'entête</h2>
|
||||
<p>Le seul champ requis est <code>title</code>, cependant, nous fournissons des options pour ajouter des informations sur l'auteur à votre blog ainsi que d'autres options.</p>
|
||||
<ul>
|
||||
<li><code>auteur</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>author</code> - L'étiquette du texte de l'auteur par ligne.</li>
|
||||
<li><code>authorURL</code> - L'URL associée à l'auteur. Ceci pourrait être un compte Twitter, GitHub, Facebook, etc.</li>
|
||||
<li><code>authorFBID</code> - L'ID de profil Facebook qui est utilisé pour récupérer l'image de profil.</li>
|
||||
<li><code>authorImageURL</code> - L'URL vers l'image de l'auteur. (Remarque : Si vous utilisez à la fois <code>authorFBID</code> et <code>authorImageURL</code>, <code>authorFBID</code> prendra la priorité. N’incluez pas <code>authorFBID</code> si vous voulez que <code>authorImageURL</code> apparaisse.)</li>
|
||||
|
|
@ -131,7 +131,7 @@
|
|||
<h2><a class="anchor" aria-hidden="true" id="changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale"></a><a href="#changer-le-nombre-de-messages-du-blog-sur-la-barre-latérale" 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>Changer le nombre de messages du blog sur la barre latérale</h2>
|
||||
<p>Par défaut, 5 messages récents sont affichés sur la barre latérale.</p>
|
||||
<p>Vous pouvez configurer un nombre spécifique de messages de blog à afficher en ajoutant un paramètre <code>blogSidebarCount</code> à votre <code>siteConfig.js</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>"ALL"</code>.</p>
|
||||
<p>Les options disponibles sont un entier représentant le nombre de messages à afficher ou une chaîne avec la valeur <code>'ALL'</code>.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-js">blogSidebarCount: <span class="hljs-string">'ALL'</span>,
|
||||
</code></pre>
|
||||
|
|
@ -145,7 +145,7 @@
|
|||
<p>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 ajoutées sur le tag HTML <code><HEAD></code> de votre page web.</p>
|
||||
<p>Un résumé du texte du message est fourni dans le flux RSS depuis <code><!--truncate--></code>. Si aucune balise <code><!--truncate--></code> n'est trouvée, alors tout le texte jusqu'au 250ème caractère sera utilisé.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="boutons-de-réseaux-sociaux"></a><a href="#boutons-de-réseaux-sociaux" 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>Boutons de réseaux sociaux</h2>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et / ou Twitter au bas de vos billets, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> <a href="/docs/fr/1.12.0/site-config">configuration du site</a> options dans <code>siteConfig.js</code>.</p>
|
||||
<p>Si vous voulez des boutons sociaux Facebook et/ou Twitter au bas de vos articles de blog, définissez les options <code>facebookAppId</code> et/ou <code>twitter</code> de la <a href="/docs/fr/1.12.0/site-config">configuration du site</a> dans <code>siteConfig.js</code>.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="sujets-avancés"></a><a href="#sujets-avancés" 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>Sujets avancés</h2>
|
||||
<h3><a class="anchor" aria-hidden="true" id="je-veux-exécuter-en-mode-blog-uniquement"></a><a href="#je-veux-exécuter-en-mode-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>Je veux exécuter en mode "Blog uniquement".</h3>
|
||||
<p>Vous pouvez exécuter votre site Docusaurus sans page d'accueil et avoir en premier votre blog.</p>
|
||||
|
|
@ -160,7 +160,7 @@
|
|||
<p>Maintenant, lorsque Docusaurus génère ou construit votre site, il copiera le fichier de <code>static/index.html</code> 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 <code>/blog</code>.</p>
|
||||
</blockquote>
|
||||
<p>Vous pouvez utiliser ce modèle :</p>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE html></span>
|
||||
<pre><code class="hljs css language-html"><span class="hljs-meta"><!DOCTYPE <span class="hljs-meta-keyword">html</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">html</span> <span class="hljs-attr">lang</span>=<span class="hljs-string">"en-US"</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">head</span>></span>
|
||||
<span class="hljs-tag"><<span class="hljs-name">meta</span> <span class="hljs-attr">charset</span>=<span class="hljs-string">"UTF-8"</span> /></span>
|
||||
|
|
|
|||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue