summaryrefslogtreecommitdiff
path: root/themes/CodeIT/exampleSite/content/posts/theme-documentation-built-in-shortcodes/index.fr.md
diff options
context:
space:
mode:
authorChristoph Cullmann <cullmann@kde.org>2021-02-18 22:21:36 +0100
committerChristoph Cullmann <cullmann@kde.org>2021-02-18 22:21:36 +0100
commit0c7cb4486a89ec6fe9680e6569ef41d4b82d557d (patch)
tree081941052bcab0caf69487b6bf5ab2df5deb3b7b /themes/CodeIT/exampleSite/content/posts/theme-documentation-built-in-shortcodes/index.fr.md
parent640572ecab69291d2c266de2011b795a861e7c21 (diff)
use maintained theme
Diffstat (limited to 'themes/CodeIT/exampleSite/content/posts/theme-documentation-built-in-shortcodes/index.fr.md')
-rw-r--r--themes/CodeIT/exampleSite/content/posts/theme-documentation-built-in-shortcodes/index.fr.md192
1 files changed, 192 insertions, 0 deletions
diff --git a/themes/CodeIT/exampleSite/content/posts/theme-documentation-built-in-shortcodes/index.fr.md b/themes/CodeIT/exampleSite/content/posts/theme-documentation-built-in-shortcodes/index.fr.md
new file mode 100644
index 0000000..ae3b60a
--- /dev/null
+++ b/themes/CodeIT/exampleSite/content/posts/theme-documentation-built-in-shortcodes/index.fr.md
@@ -0,0 +1,192 @@
+---
+weight: 3
+title: "Thème Documentation - Built-in Shortcodes"
+date: 2020-03-04T16:29:59+08:00
+lastmod: 2020-03-04T16:29:59+08:00
+draft: false
+author: "Sunt Programator!"
+authorLink: "https://suntprogramator.dev/"
+description: "Hugo fournit plusieurs shortcodes intégrés pour la commodité de l'auteur et pour garder votre contenu de démarque propre."
+resources:
+ - name: "featured"
+ src: "featured-image.png"
+
+tags: ["shortcodes"]
+categories: ["documentation"]
+
+lightgallery: true
+---
+
+**Hugo** fournit plusieurs shortcodes intégrés pour la commodité de l'auteur et pour garder votre contenu de démarque propre.
+
+<!--more-->
+
+{{< admonition warning >}}
+Sorry, this article has not been completely translated into **French**.
+Welcome to take the time to propose a translation by [:(fas fa-code-branch fa-fw): making a PR](https://github.com/sunt-programator/CodeIT/pulls) to the theme!
+{{< /admonition >}}
+
+Hugo uses Markdown for its simple content format. However, there are a lot of things that Markdown doesn’t support well. You could use pure HTML to expand possibilities.
+
+But this happens to be a bad idea. Everyone uses Markdown because it’s pure and simple to read even non-rendered. You should avoid HTML to keep it as simple as possible.
+
+To avoid this limitations, Hugo created [shortcodes](https://gohugo.io/extras/shortcodes/).
+A shortcode is a simple snippet that can generate reasonable HTML code and conforms to Markdown's design philosophy.
+
+Hugo ships with a set of predefined shortcodes that represent very common usage. These shortcodes are provided for author convenience and to keep your markdown content clean.
+
+## 1 figure {#figure}
+
+[Documentation of `figure`](https://gohugo.io/content-management/shortcodes#figure)
+
+Example `figure` input:
+
+```markdown
+{{</* figure src="/images/lighthouse.jpg" title="Lighthouse (figure)" */>}}
+```
+
+The rendered output looks like this:
+
+{{< figure src="/images/lighthouse.jpg" title="Lighthouse (figure)" >}}
+
+The HTML looks like this:
+
+```html
+<figure>
+ <img src="/images/lighthouse.jpg" />
+ <figcaption>
+ <h4>Lighthouse (figure)</h4>
+ </figcaption>
+</figure>
+```
+
+## 2 gist
+
+[Documentation of `gist`](https://gohugo.io/content-management/shortcodes#gist)
+
+Example `gist` input:
+
+```markdown
+{{</* gist spf13 7896402 */>}}
+```
+
+The rendered output looks like this:
+
+{{< gist spf13 7896402 >}}
+
+The HTML looks like this:
+
+```html
+<script
+ type="application/javascript"
+ src="https://gist.github.com/spf13/7896402.js"
+></script>
+```
+
+## 3 highlight
+
+[Documentation of `highlight`](https://gohugo.io/content-management/shortcodes#instagram)
+
+Example `highlight` input:
+
+```markdown
+{{</* highlight html */>}}
+
+<section id="main">
+ <div>
+ <h1 id="title">{{ .Title }}</h1>
+ {{ range .Pages }}
+ {{ .Render "summary"}}
+ {{ end }}
+ </div>
+</section>
+{{</* /highlight */>}}
+```
+
+The rendered output looks like this:
+
+{{< highlight html >}}
+
+<section id="main">
+ <div>
+ <h1 id="title">{{ .Title }}</h1>
+ {{ range .Pages }}
+ {{ .Render "summary"}}
+ {{ end }}
+ </div>
+</section>
+{{< /highlight >}}
+
+## 4 instagram
+
+[Documentation of `instagram`](https://gohugo.io/content-management/shortcodes#instagram)
+
+Example `instagram` input:
+
+```markdown
+{{</* instagram BWNjjyYFxVx hidecaption */>}}
+```
+
+The rendered output looks like this:
+
+{{< instagram BWNjjyYFxVx hidecaption >}}
+
+## 5 param
+
+[Documentation of `param`](https://gohugo.io/content-management/shortcodes#param)
+
+Example `param` input:
+
+```markdown
+{{</* param description */>}}
+```
+
+The rendered output looks like this:
+
+{{< param description >}}
+
+## 6 ref and relref {#ref-and-relref}
+
+[Documentation of `ref` and `relref`](https://gohugo.io/content-management/shortcodes#ref-and-relref)
+
+## 7 tweet
+
+[Documentation of `tweet`](https://gohugo.io/content-management/shortcodes#tweet)
+
+Example `tweet` input:
+
+```markdown
+{{</* tweet 877500564405444608 */>}}
+```
+
+The rendered output looks like this:
+
+{{< tweet 877500564405444608 >}}
+
+## 8 vimeo
+
+[Documentation of `vimeo`](https://gohugo.io/content-management/shortcodes#vimeo)
+
+Example `vimeo` input:
+
+```markdown
+{{</* vimeo 146022717 */>}}
+```
+
+The rendered output looks like this:
+
+{{< vimeo 146022717 >}}
+
+## 9 youtube
+
+[Documentation of `youtube`](https://gohugo.io/content-management/shortcodes#youtube)
+
+Example `youtube` input:
+
+```markdown
+{{</* youtube w7Ft2ymGmfc */>}}
+```
+
+The rendered output looks like this:
+
+{{< youtube w7Ft2ymGmfc >}}