Merge pull request #44 from riot/fr/v2.2.4

Fr/v2.2.4
riot · Oct 26, 2015 · 406a088 · 406a088
2 parents c40521b + ade7fe9
commit 406a088
Show file tree

Hide file tree

Showing 21 changed files with 3,741 additions and 4 deletions.
diff --git a/_includes/fr/api-tabs.html b/_includes/fr/api-tabs.html
@@ -0,0 +1,12 @@
+
+<div id="tabs">
+  <a href="/fr/api/">Tags personnalisés</a>
+  <a href="/fr/api/compiler/">Compilateur</a>
+  <a href="/fr/api/observable/">Observable</a>
+  <a href="/fr/api/route/">Routeur</a>
+  <a href="/fr/api/misc/">Divers</a>
+</div>
+
+<h1>API &middot; {{ page.title }}</h1>
+
+<div id="toc"></div>
diff --git a/_includes/fr/guide-tabs.html b/_includes/fr/guide-tabs.html
@@ -0,0 +1,11 @@
+
+<div id="tabs">
+  <a href="/fr/guide/">Tags personnalisés</a>
+  <a href="/fr/guide/compiler/">Compilateur</a>
+  <a href="/fr/guide/application-design/">Design d'application</a>
+  <a href="/fr/guide/v1.0/">v1.0</a>
+</div>
+
+<h1>{{ page.title }}</h1>
+
+<div id="toc"></div>
diff --git a/_layouts/fr.html b/_layouts/fr.html
@@ -0,0 +1,78 @@
+<!doctype html>
+
+{% capture nav %}
+<a href="/fr/compare/">Comparer</a>
+<a href="/fr/faq/">FAQ</a>
+<a href="/fr/guide/">Guide</a>
+<a href="/fr/api/">API</a>
+<a href="/fr/download/">Télécharger</a>
+<a href="/fr/forum/">Forum</a>
+{% endcapture %}
+
+<html lang="fr">
+
+<head>
+	<meta charset="UTF-8">
+	<link href="http://gmpg.org/xfn/11" rel="profile">
+
+	<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1">
+	<meta http-equiv="X-UA-Compatible" content="IE=edge">
+
+	<title>
+		{{ page.title }}{% if page.path != "index.md" %} &middot; {{ site.title }} {% endif %}
+	</title>
+
+	{% if page.description %}
+	<meta name="description" content="{{ page.description }}">
+	{% endif %}
+
+	<!-- favicons -->
+	<link rel="shortcut icon" href="/img/favicon-152x152.png">
+	<link rel="icon" type="image/png" sizes="152x152" href="/img/favicon-152x152.png">
+	<link rel="apple-touch-icon-precomposed" sizes="152x152" href="/img/favicon-152x152.png">
+
+	<!-- RSS
+	  <link rel="alternate" type="application/atom+xml" title="{{ site.title }}" href="/atom.xml">
+	  -->
+
+	<!-- style -->
+	<link rel="stylesheet" href="/style.css">
+
+</head>
+
+<body id="{{ page.id }}" class="{{ page.class }}">
+
+<div class="wrap">
+
+	<a id="fork" href="{{ site.repo }}">Fork me on GitHub</a>
+
+	<header id="header">
+      <span id="logo">
+        <a href="/fr/"><img id="riot-logo" src="/img/logo/riot120x.png"></a>
+        <strong>by</strong>
+        <a href="https://muut.com/"><img id="muut-logo" src="/img/logo/muut.png"></a>
+      </span>
+
+		<nav id="nav">{{ nav }}</nav>
+
+	</header>
+
+	<main id="main">
+		{{ content }}
+	</main>
+
+</div>
+
+<footer id="footer">
+	<div class="wrap">
+		<a href="/fr/"><img src="/img/logo/riot120x.png"></a>
+		<nav>{{ nav }}</nav>
+	</div>
+</footer>
+
+<script src="/script.js"></script>
+
+</body>
+
+
+</html>
diff --git a/api/index.md b/api/index.md
@@ -60,7 +60,7 @@ var tags = riot.mount('div#main', 'my-tag', api)
 Mount a custom tag named tagName on a given domNode passing optional data with opts. For example:
 
 ```
-// mounts "my-tag" to given DOM node
+// mounts "users" tag to #slide node and pass api as options
 riot.mount(document.getElementById('slide'), 'users', api)
 ```
 

diff --git a/api/route.md b/api/route.md
@@ -47,13 +47,13 @@ riot.route.start() // start again
 
 ### riot.route.stop()
 
-Remove the hashchange listeners clearing also the [riot.route.route](#route) callbacks.
+Remove the hashchange listeners clearing also the [riot.route](#route) callbacks.
 
 ```javascript
 riot.route.stop()
 ```
 
-Stopping the default router allow the use of a different router on your appliaction.
+Stopping the default router allow the use of a different router on your application.
 
 ### riot.route(to)
 

diff --git a/fr/api/compiler.md b/fr/api/compiler.md
@@ -0,0 +1,147 @@
+---
+title: Compilateur
+layout: fr
+class: apidoc
+---
+
+{% include fr/api-tabs.html %}
+
+## Sur le navigateur
+
+Les méthodes suivantes s'appliquent uniquement aux navigateurs. Allez en [section serveur](#sur-le-serveur) si vous voulez compilez avec node ou io.js.
+
+### <a name="compile"></a> riot.compile(callback)
+
+Compile tous les tags définis avec `<script type="riot/tag">` en JavaScript. Il peut s'agir de définitions de scripts inline ou de ressources externes qui chargent des scripts définis avec l'attribut `src`. Une fois tous les scripts compilés, la fonction `callback` passée est appelée. Par exemple:
+
+``` javascript
+riot.compile(function() {
+  var tags = riot.mount('*')
+})
+```
+
+Vous pouvez écartez l'appel à `riot.compile` et juste écrire:
+
+``` javascript
+var tags = riot.mount('*')
+```
+
+mais vous ignorez quand toutes les ressources externes sont chargées et compilées. La valeur de retour sera une Array vide si vous avez des scripts externes. Si tous les scripts sont définis sur la page, alors l'appel à riot.compile peut être omis.
+
+Pour plus de détails, lisez l'[introduction au compilateur](/guide/compiler/).
+
+### <a name="compile-fn"></a> riot.compile(url, callback)
+
+Charge l'URL donnée et compile tous les tags, après quoi la fonction `callback` est appelée. Par exemple:
+
+``` javascript
+riot.compile('my/tags.tag', function() {
+  // les tags sont chargés et prêts à être utilisés
+})
+```
+
+### <a name="compile-tag"></a> riot.compile(tag)
+
+Compile et exécute le `tag` donné. Par exemple:
+
+```
+<template id="mon_tag">
+  <mon-tag>
+    <p>Hello, World!</p>
+  </mon-tag>
+</template>
+
+<script>
+riot.compile(mon_tag.innerHTML)
+</script>
+```
+
+Après cet appel, vous pouvez utiliser `mon-tag` normalement.
+
+Une définition de tag est repérée si le premier caractère non vide est `<`, autrement l'argument est considéré comme une URL.
+
+### <a name="compile-to-str"></a> riot.compile(tag, true)
+
+Compile le `tag` et le retourne sous forme de chaîne de caractères. Seule la transformation du tag en JavaScript est effectuée, le tag n'est pas exécuté sur le navigateur. Vous pouvez utiliser cette méthode pour par exemple mesurer la performance du compilateur.
+
+``` js
+var js = riot.compile(my_tag.innerHTML, true)
+```
+
+## Sur le serveur
+
+Après avoir exécuté `npm install riot` , vous pouvez faire les choses suivantes:
+
+```
+var riot = require('riot')
+
+var js = riot.compile(tag)
+```
+
+La fonction `compile` reçoit en argument une définition de tag (string) et retourne du JavaScript (string).
+
+### <a name="css-parser"></a> riot.parsers.css [tagName, css]
+
+Des parseurs personnalisés pouvant être utilisés pour compiler le CSS de vos tags. Par exemple:
+
+```js
+riot.parsers.css.myparser = function(tag, css) {
+  return css.replace(/@tag/, tag)
+}
+```
+
+```html
+<custom-parsers>
+  <p>hi</p>
+  <style type="text/myparser">
+    @tag {color: red;}
+  </style>
+</custom-parsers>
+```
+
+sera compilé en:
+
+```html
+<custom-parsers>
+  <p>hi</p>
+  <style type="text/myparser">
+    custom-parsers {color: red;}
+  </style>
+</custom-parsers>
+```
+
+### <a name="js-parser"></a> riot.parsers.js [js, options]
+
+Des parseurs personnalisés pouvant être utilisés pour compiler le JavaScript de vos tags. Par exemple:
+
+```js
+riot.parsers.js.myparser = function(js) {
+  return js.replace(/@version/, '1.0.0')
+}
+```
+
+```html
+<custom-parsers>
+  <p>hi</p>
+  <script type="text/myparser">
+    this.version = "@version"
+  </script>
+</custom-parsers>
+```
+
+sera compilé en:
+
+```html
+<custom-parsers>
+  <p>hi</p>
+  <script type="text/myparser">
+    this.version = "1.0.0"
+  </script>
+</custom-parsers>
+```
+
+### <a name="html-parser"></a> riot.parsers.html [html]
+
+Des parseurs personnalisés pouvant être utilisés pour compiler le HTML de vos tags.
+
+