mirror of
https://github.com/facebook/docusaurus.git
synced 2025-08-03 16:59:06 +02:00
parent
ad33fd66e0
commit
9e86af3e60
100 changed files with 2088 additions and 2088 deletions
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="fr"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Markdown Features · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus uses [GitHub Flavored Markdown (GFM)](https://guides.github.com/features/mastering-markdown/). En savoir plus sur les champs spécifiques de Docusaurus lors de l'écriture de Markdown."/><meta name="docsearch:version" content="1.12.0"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Markdown Features · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus uses [GitHub Flavored Markdown (GFM)](https://guides.github.com/features/mastering-markdown/). En savoir plus sur les champs spécifiques de Docusaurus lors de l'écriture de Markdown."/><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>Markdown Features · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus utilise [GitHub Flavored Markdown (GFM)](https://guides.github.com/features/mastering-markdown/). En savoir plus sur les champs spécifiques de Docusaurus lors de l'écriture de Markdown."/><meta name="docsearch:version" content="1.12.0"/><meta name="docsearch:language" content="fr"/><meta property="og:title" content="Markdown Features · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus utilise [GitHub Flavored Markdown (GFM)](https://guides.github.com/features/mastering-markdown/). En savoir plus sur les champs spécifiques de Docusaurus lors de l'écriture de Markdown."/><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,14 +80,14 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</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">Markdown Features</h1></header><article><div><span><p>Docusaurus uses <a href="https://guides.github.com/features/mastering-markdown/">GitHub Flavored Markdown (GFM)</a>. En savoir plus sur les champs spécifiques de Docusaurus lors de l'écriture de Markdown.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="en-têtes-de-markdown"></a><a href="#en-têtes-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>En-têtes de Markdown</h2>
|
||||
</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">Markdown Features</h1></header><article><div><span><p>Docusaurus utilise <a href="https://guides.github.com/features/mastering-markdown/">GitHub Flavored Markdown (GFM)</a>. En savoir plus sur les champs spécifiques de Docusaurus lors de l'écriture de Markdown.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="entêtes-de-markdown"></a><a href="#entêtes-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>Entêtes de Markdown</h2>
|
||||
<h3><a class="anchor" aria-hidden="true" id="documents"></a><a href="#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>Documents</h3>
|
||||
<p>Documents use the following markdown header fields that are enclosed by a line <code>---</code> on either side:</p>
|
||||
<p><code>id</code>: A unique document id. If this field is not present, the document's <code>id</code> will default to its file name (without the extension).</p>
|
||||
<p><code>title</code>: The title of your document. If this field is not present, the document's <code>title</code> will default to its <code>id</code>.</p>
|
||||
<p><code>hide_title</code>: Whether to hide the title at the top of the doc.</p>
|
||||
<p><code>sidebar_label</code>: The text shown in the document sidebar and in the next/previous button for this document. If this field is not present, the document's <code>sidebar_label</code> will default to its <code>title</code>.</p>
|
||||
<p>Les documents utilisent les champs d'entête markdown suivants qui sont entourés par une ligne <code>---</code> de chaque côté :</p>
|
||||
<p><code>id</code>: Un identifiant unique de document. Si ce champ n'est pas présent, le fichier <code>id</code> du document prendra par défaut son nom de fichier (sans l'extension).</p>
|
||||
<p><code>title</code>: Le titre de votre document. Si ce champ n'est pas présent, le <code>title</code> du document sera par défaut celui de son <code>id</code>.</p>
|
||||
<p><code>hide_title</code> : Si vous voulez cacher le titre en haut de la doc.</p>
|
||||
<p><code>sidebar_label</code> : Le texte affiché dans la barre latérale du document et dans le bouton suivant/précédent pour ce document. Si ce champ n'est pas présent, le <code>sidebar_label</code> du document sera par défaut celui de son <code>title</code>.</p>
|
||||
<p>Par exemple :</p>
|
||||
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
|
||||
<span class="hljs-attr">id :</span> <span class="hljs-string">doc1</span>
|
||||
|
@ -96,7 +96,7 @@
|
|||
<span class="hljs-meta">---</span>
|
||||
|
||||
</code></pre>
|
||||
<p>Versioned documents have their ids altered to include the version number when they get copied. The new <code>id</code> is <code>version-${version}-${id}</code> where <code>${version}</code> is the version number of that document and <code>${id}</code> is the original <code>id</code>. Additionally, versioned documents get an added <code>original_id</code> field with the original document id.</p>
|
||||
<p>Les documents versionnés ont leurs identifiants modifiés pour inclure le numéro de version lorsqu'ils sont copiés. Le nouvel <code>id</code> est <code>version-${version}-${id}</code> où <code>${version}</code> est le numéro de version de ce document et <code>${id}</code> est l'original <code>id</code>. De plus, les documents versionnés obtiennent un champ <code>original_id</code> supplémentaire avec l'identifiant du document original.</p>
|
||||
<p>Par exemple :</p>
|
||||
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
|
||||
<span class="hljs-attr">id:</span> <span class="hljs-string">version-1.0.0-doc1</span>
|
||||
|
@ -106,7 +106,7 @@
|
|||
<span class="hljs-meta">---</span>
|
||||
|
||||
</code></pre>
|
||||
<p><code>custom_edit_url</code>: L'url pour éditer le document. Si ce champ n'est pas présent, l'url du document va retournera <code>editUrl</code> depuis les champs optionnel de <code>siteConfig.js</code>. See <a href="/docs/fr/1.12.0/site-config">siteConfig.js</a> docs for more information.</p>
|
||||
<p><code>custom_edit_url</code>: L'url pour éditer le document. Si ce champ n'est pas présent, l'url du document va retournera <code>editUrl</code> depuis les champs optionnel de <code>siteConfig.js</code>. Consulter les docs de <a href="/docs/fr/1.12.0/site-config">siteConfig.js</a> pour plus d'informations.</p>
|
||||
<p>Par exemple :</p>
|
||||
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
|
||||
<span class="hljs-attr">id:</span> <span class="hljs-string">doc-markdown</span>
|
||||
|
@ -117,10 +117,10 @@
|
|||
</code></pre>
|
||||
<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>title</code>: The title of this blog post.</p>
|
||||
<p><code>author</code>: The author of this blog post. If this field is omitted, no author name will be shown.</p>
|
||||
<p><code>authorURL</code>: A page to link to when a site user clicks the author's name. If this field is omitted, the author's name will not link to anything.</p>
|
||||
<p><code>authorFBID</code>: The author's Facebook id, used only to get the author's profile picture to display with the blog post. If this field is omitted, no author picture will be shown for the blog post.</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>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>
|
||||
<span class="hljs-attr">title:</span> <span class="hljs-string">Mon</span> <span class="hljs-string">premier</span> <span class="hljs-string">post</span>
|
||||
|
@ -131,22 +131,22 @@
|
|||
|
||||
</code></pre>
|
||||
<h2><a class="anchor" aria-hidden="true" id="fonctionnalités-supplémentaires"></a><a href="#fonctionnalités-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>Fonctionnalités supplémentaires</h2>
|
||||
<p>Docusaurus supports some extra features when writing documentation in markdown.</p>
|
||||
<p>Docusaurus prend en charge certaines fonctionnalités supplémentaires lors de l'écriture de la documentation en markdown.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="lier-dautres-documents"></a><a href="#lier-dautres-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>Lier d'autres documents</h3>
|
||||
<p>Vous pouvez utiliser des url relatives à d'autre fichiers de documentation qui seront automatiquement convertit en des liés correspondant quand ils seront rendus.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-md">[<span class="hljs-string">Ce lien vers un autre document</span>](<span class="hljs-link">other-document.md</span>)
|
||||
</code></pre>
|
||||
<p>This markdown will automatically get converted into a link to <code>/docs/other-document.html</code> (or the appropriately translated/versioned link) once it gets rendered.</p>
|
||||
<p>Ce markdown sera automatiquement converti en un lien vers <code>/docs/other-document.html</code> (ou le lien correctement traduit/versionné) une fois qu'il sera affiché.</p>
|
||||
<p>Ceci peut vous aider quand vous voudrez naviguer dans la documentation sur GitHub puisque les liens seront des liens fonctionnels vers d'autres document (toujours sur GitHub), mais les documents auront des liens HTML corrects lorsqu'ils seront rendus.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="lien-vers-les-images-et-autres-actifs"></a><a href="#lien-vers-les-images-et-autres-actifs" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Lien vers les images et autres actifs</h3>
|
||||
<p>Des assets statiques peuvent être inclus de la même façon que le sont les documents, en utilisant des liens relatifs. Static assets used in documents and blogs should go into <code>docs/assets</code> and <code>website/blog/assets</code>, respectively. The markdown will get converted into correct link paths so that these paths will work for documents of all languages and versions.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="lien-vers-les-images-et-autres-ressources"></a><a href="#lien-vers-les-images-et-autres-ressources" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Lien vers les images et autres ressources</h3>
|
||||
<p>Des assets statiques peuvent être inclus de la même façon que le sont les documents, en utilisant des liens relatifs. Les ressources statiques utilisées dans les documents et les blogs doivent aller respectivement dans <code>docs/assets</code> et <code>website/blog/assets</code>. Le markdown sera converti avec des chemins de liens corrects afin que ces chemins fonctionnent pour les documents de toutes les langues et versions.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-md">
|
||||
</code></pre>
|
||||
<h3><a class="anchor" aria-hidden="true" id="génération-dune-table-des-matières"></a><a href="#génération-dune-table-des-matiè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>Génération d'une table des matières</h3>
|
||||
<p>Vous pouvez créer une liste auto-générée de liens, qui seront utiles pour une table des matières pour la documentation de l'API.</p>
|
||||
<p>In your markdown file, insert a line with the text ``. Write your documentation using <code>h3</code> headers for each function inside a code block. These will be found by Docusaurus and a list of links to these sections will be inserted at the text <code><AUTOGENERATED_TABLE_OF_CONTENTS></code>.</p>
|
||||
<p>Dans votre fichier Markdown, insérez une ligne avec le texte ``. Écrivez votre documentation en utilisant les entêtes <code>h3</code> pour chaque fonction à l'intérieur d'un bloc de code. Celles-ci seront trouvées par Docusaurus et une liste de liens vers ces sections sera insérée dans le texte <code><AUTOGENERATED_TABLE_OF_CONTENTS></code>.</p>
|
||||
<p>Exemple :</p>
|
||||
<pre><code class="hljs css language-md"><span class="hljs-section">### `docusaurus.function(a, b)`</span>
|
||||
|
||||
|
@ -156,31 +156,31 @@ Texte décrivant ma fonction
|
|||
|
||||
Texte décrivant ma fonction
|
||||
</code></pre>
|
||||
<p>will lead to a table of contents of the functions:</p>
|
||||
<p>ceci donnera une table des matières des fonctions :</p>
|
||||
<pre><code class="hljs css language-md"><span class="hljs-bullet">- </span><span class="hljs-code">`docusaurus.function(a, b)`</span>
|
||||
<span class="hljs-bullet">- </span><span class="hljs-code">`docdoc(file)`</span>
|
||||
</code></pre>
|
||||
<p>and each function will link to their corresponding sections in the page.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="language-specific-code-tabs"></a><a href="#language-specific-code-tabs" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Language-specific Code Tabs</h3>
|
||||
<p>Display code in multiple programming languages using code tabs. First, mark the start and end of a code tabs group, by using <code><!-- DOCUSAURUS_CODE_TABS --></code> and <code><!-- END_DOCUSAURUS_CODE_TABS --></code> respectively in your markdown. Then start each tab with <code><!--[TAB_TITLE]--></code>.</p>
|
||||
<p>Adding the following code to your Markdown file:</p>
|
||||
<p>et chaque fonction sera liée à leurs sections correspondantes dans la page.</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="onglets-de-code-spécifiques-au-langage"></a><a href="#onglets-de-code-spécifiques-au-langage" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Onglets de code spécifiques au langage</h3>
|
||||
<p>Affiche le code dans plusieurs langages de programmation en utilisant des onglets de code. Tout d'abord, marquez le début et la fin d'un groupe d'onglets de code, en utilisant respectivement <code><!-- DOCUSAURUS_CODE_TABS --></code> et <code><! - END_DOCUSAURUS_CODE_TABS --></code> dans votre markdown. Ensuite, démarrez chaque onglet avec <code><!--[TAB_TITLE]--></code>.</p>
|
||||
<p>En ajoutant le code suivant à votre fichier Markdown :</p>
|
||||
<script src="https://gist.github.com/yangshun/d36d04f383c40beb3f31dd2a16666f6c.js"></script>
|
||||
<p>produces this:</p>
|
||||
<p>cela produira :</p>
|
||||
<div class="tabs"><div class="nav-tabs"><div id="tab-group-71-tab-72" class="nav-link active" data-group="group_71" data-tab="tab-group-71-content-72">JavaScript</div><div id="tab-group-71-tab-73" class="nav-link" data-group="group_71" data-tab="tab-group-71-content-73">Python</div><div id="tab-group-71-tab-74" class="nav-link" data-group="group_71" data-tab="tab-group-71-content-74">C</div><div id="tab-group-71-tab-75" class="nav-link" data-group="group_71" data-tab="tab-group-71-content-75">Pascal</div></div><div class="tab-content"><div id="tab-group-71-content-72" class="tab-pane active" data-group="group_71" tabindex="-1"><div><span><pre><code class="hljs css language-js"><span class="hljs-built_in">console</span>.log(<span class="hljs-string">'Hello, world!'</span>);<br /></code></pre>
|
||||
</span></div></div><div id="tab-group-71-content-73" class="tab-pane" data-group="group_71" tabindex="-1"><div><span><pre><code class="hljs css language-py">print(<span class="hljs-string">'Hello, world!'</span>)<br /></code></pre>
|
||||
</span></div></div><div id="tab-group-71-content-74" class="tab-pane" data-group="group_71" tabindex="-1"><div><span><pre><code class="hljs css language-C"><span class="hljs-meta">#<span class="hljs-meta-keyword">include</span> <span class="hljs-meta-string"><stdio.h></span></span><br /><br /><span class="hljs-function"><span class="hljs-keyword">int</span> <span class="hljs-title">main</span><span class="hljs-params">()</span> </span>{<br /> <span class="hljs-built_in">printf</span>(<span class="hljs-string">"Hello World!"</span>);<br /> <span class="hljs-keyword">return</span> <span class="hljs-number">0</span>;<br />}<br /></code></pre>
|
||||
</span></div></div><div id="tab-group-71-content-75" class="tab-pane" data-group="group_71" tabindex="-1"><div><span><pre><code class="hljs css language-Pascal"><span class="hljs-keyword">program</span> HelloWorld;<br /><span class="hljs-keyword">begin</span><br /> WriteLn(<span class="hljs-string">'Hello, world!'</span>);<br /><span class="hljs-keyword">end</span>.<br /></code></pre>
|
||||
</span></div></div></div></div>
|
||||
<h2><a class="anchor" aria-hidden="true" id="coloration-syntaxique"></a><a href="#coloration-syntaxique" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Coloration syntaxique</h2>
|
||||
<p>Syntax highlighting is enabled by default on fenced code blocks. The language should be detected automatically, but you can sometimes get better results by specifying the language. You can do so using an <a href="https://github.github.com/gfm/#example-111">info string</a>, following the three opening backticks. The following JavaScript example...</p>
|
||||
<p>La coloration syntaxique est activée par défaut sur les blocs de code clôturés. Le langage devrait être détectée automatiquement, mais vous pouvez parfois obtenir de meilleurs résultats en spécifiant le langage. Vous pouvez le faire à l'aide d'un <a href="https://github.github.com/gfm/#example-111">info string</a>, en suivant les trois backticks d'ouverture. L'exemple JavaScript suivant...</p>
|
||||
<pre><code class="hljs">```js
|
||||
ReactDOM.render(<h1>Hello, world!</h1>, document.getElementById('root'));
|
||||
```
|
||||
</code></pre>
|
||||
<p>...would be rendered with syntax highlighting like so:</p>
|
||||
<p>...serait rendu avec la coloration syntaxique comme ceci :</p>
|
||||
<pre><code class="hljs css language-js">ReactDOM.render(<span class="xml"><span class="hljs-tag"><<span class="hljs-name">h1</span>></span>Hello, world!<span class="hljs-tag"></<span class="hljs-name">h1</span>></span></span>, <span class="hljs-built_in">document</span>.getElementById(<span class="hljs-string">'root'</span>));
|
||||
</code></pre>
|
||||
<p>Highlighting is provided by <a href="https://highlightjs.org">Highlight.js</a> using the theme specified in your <code>siteConfig.js</code> file as part of the <code>highlight</code> key:</p>
|
||||
<p>La mise en surbrillance est fournie par <a href="https://highlightjs.org">Highlight.js</a> en utilisant le thème spécifié dans votre fichier <code>siteConfig.js</code> dans la partie de la clé <code>highlight</code> :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
...
|
||||
highlight: {
|
||||
|
@ -189,9 +189,9 @@ ReactDOM.render(<h1>Hello, world!</h1>, document.getElementById('roo
|
|||
...
|
||||
}
|
||||
</code></pre>
|
||||
<p>You can find the full list of supported themes in the Highlight.js <a href="https://github.com/isagalaev/highlight.js/tree/master/src/styles"><code>styles</code></a> directory.</p>
|
||||
<p>Vous pouvez trouver la liste complète des thèmes pris en charge dans le dossier <a href="https://github.com/isagalaev/highlight.js/tree/master/src/styles"><code>styles</code></a> deHighlight.js .</p>
|
||||
<h3><a class="anchor" aria-hidden="true" id="ajout-de-langues-supplémentaires"></a><a href="#ajout-de-langues-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>Ajout de langues supplémentaires</h3>
|
||||
<p>While Highlight.js provides support for <a href="https://highlightjs.org/static/demo/">many popular languages out of the box</a>, you may find the need to register additional language support. For these cases, we provide an escape valve by exposing the <code>hljs</code> constant as part of the <code>highlight</code> config key. This in turn allows you to call <a href="http://highlightjs.readthedocs.io/en/latest/api.html#registerlanguage-name-language"><code>registerLanguage</code></a>:</p>
|
||||
<p>Bien que Highlight.js fournit le support pour <a href="https://highlightjs.org/static/demo/">de nombreux langages populaires</a>, vous pouvez trouver le besoin d'enregistrer un support linguistique supplémentaire. Pour ces cas, nous fournissons une issue de secours en exposant la constante <code>hljs</code> dans la clé de configuration <code>highlight</code>. Cela vous permet d'appeler <a href="http://highlightjs.readthedocs.io/en/latest/api.html#registerlanguage-name-language"><code>registerLanguage</code></a> :</p>
|
||||
<pre><code class="hljs css language-js">{
|
||||
...
|
||||
highlight: {
|
||||
|
@ -225,9 +225,9 @@ usePrism: ['jsx']
|
|||
<span class="token punctuation">}</span>
|
||||
<span class="token punctuation">}</span>
|
||||
</code></pre>
|
||||
<h3><a class="anchor" aria-hidden="true" id="adding-copy-code-buttons"></a><a href="#adding-copy-code-buttons" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 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 Copy Code Buttons</h3>
|
||||
<p>Docusaurus allows for adding buttons to copy the code within fenced code blocks. Please follow the instructions <a href="https://gist.github.com/yangshun/55db997ed0f8f4e6527571fc3bee4675">here</a> to add "Copy" buttons to your code blocks.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.12.0/commands"><span class="arrow-prev">← </span><span>Commande CLI</span></a><a class="docs-next button" href="/docs/fr/1.12.0/api-pages"><span>Pages et styles</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#en-têtes-de-markdown">En-têtes de Markdown</a><ul class="toc-headings"><li><a href="#documents">Documents</a></li><li><a href="#publications-de-blog">Publications de blog</a></li></ul></li><li><a href="#fonctionnalités-supplémentaires">Fonctionnalités supplémentaires</a><ul class="toc-headings"><li><a href="#lier-dautres-documents">Lier d'autres documents</a></li><li><a href="#lien-vers-les-images-et-autres-actifs">Lien vers les images et autres actifs</a></li><li><a href="#génération-dune-table-des-matières">Génération d'une table des matières</a></li><li><a href="#language-specific-code-tabs">Language-specific Code Tabs</a></li></ul></li><li><a href="#coloration-syntaxique">Coloration syntaxique</a><ul class="toc-headings"><li><a href="#ajout-de-langues-supplémentaires">Ajout de langues supplémentaires</a></li><li><a href="#utilisation-de-prism-comme-coloration-syntaxique-supplémentaire">Utilisation de Prism comme coloration syntaxique supplémentaire</a></li><li><a href="#adding-copy-code-buttons">Adding Copy Code Buttons</a></li></ul></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/" class="nav-home"><img src="/img/docusaurus_monochrome.svg" alt="Docusaurus" width="66" height="58"/></a><div class="footerSection"><h5>Docs</h5><a href="
|
||||
<h3><a class="anchor" aria-hidden="true" id="ajout-des-boutons-de-copie-de-code"></a><a href="#ajout-des-boutons-de-copie-de-code" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Ajout des boutons de copie de code</h3>
|
||||
<p>Docusaurus permet d'ajouter des boutons pour copier le code dans des blocs de code clôturés. Veuillez suivre les instructions <a href="https://gist.github.com/yangshun/55db997ed0f8f4e6527571fc3bee4675">ici</a> pour ajouter les boutons "Copier" à vos blocs de code.</p>
|
||||
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/fr/1.12.0/commands"><span class="arrow-prev">← </span><span>Commande CLI</span></a><a class="docs-next button" href="/docs/fr/1.12.0/api-pages"><span>Pages et styles</span><span class="arrow-next"> →</span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#entêtes-de-markdown">Entêtes de Markdown</a><ul class="toc-headings"><li><a href="#documents">Documents</a></li><li><a href="#publications-de-blog">Publications de blog</a></li></ul></li><li><a href="#fonctionnalités-supplémentaires">Fonctionnalités supplémentaires</a><ul class="toc-headings"><li><a href="#lier-dautres-documents">Lier d'autres documents</a></li><li><a href="#lien-vers-les-images-et-autres-ressources">Lien vers les images et autres ressources</a></li><li><a href="#génération-dune-table-des-matières">Génération d'une table des matières</a></li><li><a href="#onglets-de-code-spécifiques-au-langage">Onglets de code spécifiques au langage</a></li></ul></li><li><a href="#coloration-syntaxique">Coloration syntaxique</a><ul class="toc-headings"><li><a href="#ajout-de-langues-supplémentaires">Ajout de langues supplémentaires</a></li><li><a href="#utilisation-de-prism-comme-coloration-syntaxique-supplémentaire">Utilisation de Prism comme coloration syntaxique supplémentaire</a></li><li><a href="#ajout-des-boutons-de-copie-de-code">Ajout des boutons de copie de code</a></li></ul></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/" class="nav-home"><img src="/img/docusaurus_monochrome.svg" alt="Docusaurus" width="66" height="58"/></a><div class="footerSection"><h5>Docs</h5><a href="
|
||||
/docs/fr/installation">Getting Started</a><a href="
|
||||
/docs/fr/versioning">Versioning</a><a href="
|
||||
/docs/fr/translation">Localization</a><a href="
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue