rbcli 0.2.11 → 0.2.12

data/docs-src/themes/hugo-theme-learn/exampleSite/content/cont/tags.en.md

@@ -0,0 +1,39 @@
+---
+date: 2018-11-29T08:41:44+01:00
+title: Tags
+weight: 40
+tags: ["documentation", "tutorial"]
+---
+
+*Learn theme* support one default taxonomy of gohugo: the *tag* feature.
+
+## Configuration 
+
+Just add tags to any page: 
+
+```markdown
+---
+date: 2018-11-29T08:41:44+01:00
+title: Theme tutorial
+weight: 15
+tags: ["tutorial", "theme"] 
+---
+```
+
+## Behavior
+
+
+The tags are displayed at the top of the page, in their insertion order.
+
+Each tag is a link to a *Taxonomy* page displaying all the articles with the given tag. 
+
+## List all the tags
+
+In the `config.toml`  file you can add a shortcut to display all the tags
+
+```toml
+[[menu.shortcuts]]
+name = "<i class='fas fa-tags'></i> Tags"
+url = "/tags"
+weight = 30
+```

data/docs-src/themes/hugo-theme-learn/exampleSite/content/cont/tags.fr.md

@@ -0,0 +1,40 @@
+---
+date: 2018-11-29T08:41:44+01:00
+title: Tags
+weight: 40
+tags: ["documentation", "tutorial"]
+---
+
+
+Le *thème Learn* supporte une des taxonomy par défaut de GoHugo : les tags.
+
+## Configuration 
+
+Il suffit d'ajouter un tableau de tags sur la page  : 
+
+```markdown
+---
+date: 2018-11-29T08:41:44+01:00
+title: Tutoriel pour le thème
+weight: 15
+tags: ["tutoriel", "theme"] 
+---
+```
+
+## Comportement
+
+Les tags sont affichés en haut de la page, dans l'ordre dans lequel ils ont été saisis. 
+
+Chaque tag est un lien vers une page *Taxonomy*, qui affiche tous les article avec ce tag.
+
+
+## Liste des tags
+
+Il est possible de rajouter un raccourci dans le fichier `config.toml` afin d'afficher une page listant tous les tags
+
+```toml
+[[menu.shortcuts]]
+name = "<i class='fas fa-tags'></i> Tags"
+url = "/tags"
+weight = 30
+```

data/docs-src/themes/hugo-theme-learn/exampleSite/content/credits.en.md

@@ -0,0 +1,28 @@
+---
+title: Credits
+disableToc: true
+---
+
+## Contributors
+
+Thanks to them <i class="fas fa-heart"></i> for making Open Source Software a better place !
+
+{{% ghcontributors "https://api.github.com/repos/matcornic/hugo-theme-learn/contributors?per_page=100" %}}
+
+And a special thanks to [@vjeantet](https://github.com/vjeantet) for his work on [docdock](https://github.com/vjeantet/hugo-theme-docdock), a fork of hugo-theme-learn. v2.0.0 of this theme is inspired by his work.
+
+## Packages and libraries
+* [mermaid](https://knsv.github.io/mermaid) - generation of diagram and flowchart from text in a similar manner as markdown
+* [font awesome](http://fontawesome.io/) - the iconic font and CSS framework
+* [jQuery](https://jquery.com) - The Write Less, Do More, JavaScript Library
+* [lunr](https://lunrjs.com) - Lunr enables you to provide a great search experience without the need for external, server-side, search services...
+* [horsey](https://bevacqua.github.io/horsey/) - Progressive and customizable autocomplete component
+* [clipboard.js](https://zenorocha.github.io/clipboard.js) - copy text to clipboard
+* [highlight.js](https://highlightjs.org) - Javascript syntax highlighter
+* [modernizr](https://modernizr.com) - A JavaScript toolkit that allows web developers to use new CSS3 and HTML5 features while maintaining a fine level of control over browsers that don't support
+
+## Tooling
+
+* [Netlify](https://www.netlify.com) - Continuous deployement and hosting of this documentation
+* [Hugo](https://gohugo.io/)
+

data/docs-src/themes/hugo-theme-learn/exampleSite/content/credits.fr.md

@@ -0,0 +1,28 @@
+---
+title: Crédits
+disableToc: true
+---
+
+## Contributeurs
+
+Merci à eux <i class="fas fa-heart"></i> de rendre le monde Open Source meilleur  !
+
+{{% ghcontributors "https://api.github.com/repos/matcornic/hugo-theme-learn/contributors?per_page=100" %}}
+
+Et un grand merci à [@vjeantet](https://github.com/vjeantet) pour son travail sur [docdock](https://github.com/vjeantet/hugo-theme-docdock), un fork de _hugo-theme-learn_. La v2.0.0 du thème est en grande partie inspirée de son travail.
+
+## Packages et librairies
+* [mermaid](https://knsv.github.io/mermaid) - géneration de diagrames et graphiques à partir de texte similaire à Markdown
+* [font awesome](http://fontawesome.io/) - Le framework de polices iconiques
+* [jQuery](https://jquery.com) - La plus connue des librairies Javascript
+* [lunr](https://lunrjs.com) - Lunr fournit des fonctions de recherche sans service externe
+* [horsey](https://bevacqua.github.io/horsey/) - Autocomplétion de composants (utiliser pour les suggestions de recherche)
+* [clipboard.js](https://zenorocha.github.io/clipboard.js) - Copier le texte dans le presse-papier
+* [highlight.js](https://highlightjs.org) - Mise en valeur de syntaxes
+* [modernizr](https://modernizr.com) - Une boite à outil Javascript qui permet aux développeurs d'utiliser les dernières fonctionnalités de CSS et HTML5, même sur de vieux navigateurs.
+
+## Outils
+
+* [Netlify](https://www.netlify.com) - Déploiement continue et hébergement de cette documentation
+* [Hugo](https://gohugo.io/)
+

data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/_index.en.md

@@ -0,0 +1,16 @@
+---
+date: 2016-04-09T16:50:16+02:00
+title: Shortcodes
+pre: "<b>3. </b>"
+weight: 15
+---
+
+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 inside a page.
+
+**Hugo-theme-learn** provides multiple shortcodes on top of existing ones.
+
+{{%children style="h2" description="true" %}}

data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/_index.fr.md

@@ -0,0 +1,16 @@
+---
+date: 2016-04-09T16:50:16+02:00
+title: Shortcodes
+pre: "<b>3. </b>"
+weight: 15
+---
+
+Hugo utilise Markdown pour son format simple. Cependant, il y a beaucoup de chose que Markdown ne supporte pas bien. On pourrait utiliser du HTML pur pour améliorer les capacité du Markdown.
+
+Mais c'est probablement une mauvaise idée. Tout le monde utilise le Markdown parce que c'est pur et simple à lire même lorsqu'il est affiché en texte brut. Vous devez éviter le HTML autant que possible pour garder le contenu simple.
+
+Cependant, pour éviter les limitations, Hugo a créé les [shortcodes](https://gohugo.io/extras/shortcodes/). Un shortcode est un bout de code (*snippet*) dans une page.
+
+**Hugo-theme-learn** fournit de multiple shortcodes en plus de ceux existant.
+
+{{%children style="h2" description="true" %}}

data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/attachments.en.md

@@ -0,0 +1,85 @@
+---
+title: Attachments
+description : "The Attachments shortcode displays a list of files attached to a page."
+---
+
+The Attachments shortcode displays a list of files attached to a page.
+
+{{% attachments /%}}
+
+## Usage
+
+The shortcurt lists files found in a **specific folder**.
+Currently, it support two implementations for pages
+
+1. If your page is a markdown file, attachements must be place in a **folder** named like your page and ending with **.files**.
+
+    > * content
+    >   * _index.md
+    >   * page.files
+    >      * attachment.pdf
+    >   * page.md
+
+2. If your page is a **folder**, attachements must be place in a nested **'files'** folder.
+
+    > * content
+    >   * _index.md
+    >   * page
+    >      * index.md
+    >      * files
+    >          * attachment.pdf
+
+Be aware that if you use a multilingual website, you will need to have as many folders as languages.
+
+That's all !
+
+### Parameters
+
+| Parameter | Default | Description |
+|:--|:--|:--|
+| title | "Attachments" | List's title  |
+| style | "" | Choose between "orange", "grey", "blue" and "green" for nice style |
+| pattern | ".*" | A regular expressions, used to filter the attachments by file name. <br/><br/>The **pattern** parameter value must be [regular expressions](https://en.wikipedia.org/wiki/Regular_expression).
+
+For example:
+
+* To match a file suffix of 'jpg', use **.*jpg** (not *.jpg).
+* To match file names ending in 'jpg' or 'png', use **.*(jpg|png)**
+
+### Examples
+
+#### List of attachments ending in pdf or mp4
+
+
+    {{%/*attachments title="Related files" pattern=".*(pdf|mp4)"/*/%}}
+
+renders as
+
+{{%attachments title="Related files" pattern=".*(pdf|mp4)"/%}}
+
+#### Colored styled box
+
+    {{%/*attachments style="orange" /*/%}}
+
+renders as
+
+{{% attachments style="orange" /%}}
+
+
+    {{%/*attachments style="grey" /*/%}}
+
+renders as 
+
+{{% attachments style="grey" /%}}
+
+    {{%/*attachments style="blue" /*/%}}
+
+renders as
+
+{{% attachments style="blue" /%}}
+    
+    {{%/*attachments style="green" /*/%}}
+
+renders as
+
+{{% attachments style="green" /%}}

data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/attachments.fr.md

@@ -0,0 +1,85 @@
+---
+title: Attachments (Pièces jointes)
+description : "The Attachments shortcode displays a list of files attached to a page."
+---
+
+Le shortcode *Attachments* affiche une liste de pièces jointes d'une page.
+
+{{% attachments /%}}
+
+## Utilisation
+
+Le shortcode affiche la liste de fichiers trouvés dans un **dossier spécifique**
+A l'heure actuelle, il supporte deux implémentations
+
+1. Si votre page est un fichier Markdown, les pièces jointes doivent être placée dans un **dossier** nommé comme le nom de la page et suffixé par **.files**.
+
+    > * content
+    >   * _index.md
+    >   * page.files
+    >      * attachment.pdf
+    >   * page.md
+
+2. Si votre page est un **dossier**, les pièces jointes doivent être placées dans un dossier fils **'files'**.
+
+    > * content
+    >   * _index.md
+    >   * page
+    >      * index.md
+    >      * files
+    >          * attachment.pdf
+
+Attention, si votre site est multi-langue, vous devrez avec autant de dossier qu'il y a de langues.
+
+C'est tout !
+
+### Paramètres
+
+| Paramètre | Défaut | Description |
+|:--|:--|:--|
+| title | "Pièces jointes" | Titre de la liste  |
+| style | "" | Choisir entre "orange", "grey", "blue" et "green" pour un style plus sympa |
+| pattern | ".*" | Une expression régulière, utilisée pour filtrer les pièces jointes par leur nom de fichier. <br/><br/>Le paramètre **pattern** doit être une [expression régulière](https://en.wikipedia.org/wiki/Regular_expression).
+
+Par exemple:
+
+* Pour trouver les fichiers avec le suffixe 'jpg', utilisez **.*jpg** (pas *.jpg).
+* Pour trouver les fichiers avec les suffixe 'jpg' ou 'png', utilisez **.*(jpg|png)**
+
+### Exemples
+
+#### Lister les pièces jointes de type pdf ou mp4
+
+
+    {{%/*attachments title="Fichiers associés" pattern=".*(pdf|mp4)"/*/%}}
+
+s'affiche comme
+
+{{%attachments title="Fichiers associés" pattern=".*(pdf|mp4)"/%}}
+
+#### Modifier le style
+
+    {{%/*attachments style="orange" /*/%}}
+
+s'affiche comme
+
+{{% attachments style="orange" /%}}
+
+
+    {{%/*attachments style="grey" /*/%}}
+
+s'affiche comme
+
+{{% attachments style="grey" /%}}
+
+    {{%/*attachments style="blue" /*/%}}
+
+s'affiche comme
+
+{{% attachments style="blue" /%}}
+    
+    {{%/*attachments style="green" /*/%}}
+
+s'affiche comme
+
+{{% attachments style="green" /%}}

data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/button.en.md

@@ -0,0 +1,16 @@
+---
+title: Button
+description : "Nice buttons on your page."
+---
+
+A button is a just a clickable button with optional icon.
+
+```
+{{%/* button href="https://getgrav.org/" */%}}Get Grav{{%/* /button */%}}
+{{%/* button href="https://getgrav.org/" icon="fas fa-download" */%}}Get Grav with icon{{%/* /button */%}}
+{{%/* button href="https://getgrav.org/" icon="fas fa-download" icon-position="right" */%}}Get Grav with icon right{{%/* /button */%}}
+```
+
+{{% button href="https://getgrav.org/" %}}Get Grav{{% /button %}}
+{{% button href="https://getgrav.org/" icon="fas fa-download" %}}Get Grav with icon{{% /button %}}
+{{% button href="https://getgrav.org/" icon="fas fa-download" icon-position="right" %}}Get Grav with icon right{{% /button %}}

data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/button.fr.md

@@ -0,0 +1,16 @@
+---
+title: Button (Bouton)
+description : "De beaux boutons sur votre page."
+---
+
+Le shortcode *button* est simplement un bouton cliquable avec une icône optionnelle.
+
+```
+{{%/* button href="https://getgrav.org/" */%}}Téléchargez Grav{{%/* /button */%}}
+{{%/* button href="https://getgrav.org/" icon="fas fa-download" */%}}Téléchargez Grav avec icône{{%/* /button */%}}
+{{%/* button href="https://getgrav.org/" icon="fas fa-download" icon-position="right" */%}}Téléchargez Grav avec icône à droite{{%/* /button */%}}
+```
+
+{{% button href="https://getgrav.org/" %}}Téléchargez Grav{{% /button %}}
+{{% button href="https://getgrav.org/" icon="fas fa-download" %}}Téléchargez Grav avec icône{{% /button %}}
+{{% button href="https://getgrav.org/" icon="fas fa-download" icon-position="right" %}}Téléchargez Grav avec icône à droite{{% /button %}}

data/docs-src/themes/hugo-theme-learn/exampleSite/content/shortcodes/children/_index.en.md

@@ -0,0 +1,45 @@
+---
+title : Children
+description : List the child pages of a page
+---
+
+Use the children shortcode to list the child pages of a page and the further descendants (children's children). By default, the shortcode displays links to the child pages.
+
+## Usage
+
+| Parameter | Default | Description |
+|:--|:--|:--|
+| page | _current_ | Specify the page name (section name) to display children for |
+| style | "li" | Choose the style used to display descendants. It could be any HTML tag name |
+| showhidden | "false" | When true, child pages hidden from the menu will be displayed |
+| description  | "false" | Allows you to include a short text under each page in the list.<br/>when no description exists for the page, children shortcode takes the first 70 words of your content. [read more info about summaries on gohugo.io](https://gohugo.io/content/summaries/)  |
+| depth | 1 | Enter a number to specify the depth of descendants to display. For example, if the value is 2, the shortcode will display 2 levels of child pages. <br/> **Tips:** set 999 to get all descendants|
+| sort | none | Sort Children By<br><li><strong>Weight</strong> - to sort on menu order</li><li><strong>Name</strong> - to sort alphabetically on menu label</li><li><strong>Identifier</strong> - to sort alphabetically on identifier set in frontmatter</li><li><strong>URL</strong> - URL</li> |
+
+## Demo
+
+	{{%/* children  */%}}
+
+{{% children %}}
+
+	{{%/* children description="true"   */%}}
+
+{{%children description="true"   %}}
+
+	{{%/* children depth="3" showhidden="true" */%}}
+
+{{% children depth="3" showhidden="true" %}}
+
+	{{%/* children style="h2" depth="3" description="true" */%}}
+
+{{% children style="h2" depth="3" description="true" %}}
+
+	{{%/* children style="div" depth="999" */%}}
+
+{{% children style="div" depth="999" %}}
+
+
+
+
+
+