From 1f4bcf8a7a23cd2ea687e3a197f65508b4d1b919 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 12:58:17 +0800
Subject: Create markdown-cn.html.markdown

initiate
---
 zh-cn/markdown-cn.html.markdown | 246 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 246 insertions(+)
 create mode 100644 zh-cn/markdown-cn.html.markdown

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
new file mode 100644
index 00000000..9a863bac
--- /dev/null
+++ b/zh-cn/markdown-cn.html.markdown
@@ -0,0 +1,246 @@
+---
+language: markdown
+contributors:
+    - ["Dan Turkel", "http://danturkel.com/"]
+filename: markdown.md
+---
+
+Markdown was created by John Gruber in 2004. It's meant to be an easy to read and write syntax which converts easily to HTML (and now many other formats as well).
+
+Give me as much feedback as you want! / Feel free to fork and pull request!
+
+
+```
+<!-- Markdown is a superset of HTML, so any HTML file is valid Markdown, that
+means we can use HTML elements in Markdown, such as the comment element, and
+they won't be affected by a markdown parser. However, if you create an HTML
+element in your markdown file, you cannot use markdown syntax within that
+element's contents. -->
+
+<!-- Markdown also varies in implementation from one parser to a next. This
+guide will attempt to clarify when features are universal or when they are
+specific to a certain parser. -->
+
+<!-- Headers -->
+<!-- You can create HTML elements <h1> through <h6> easily by prepending the
+text you want to be in that element by a number of hashes (#) -->
+# This is an <h1>
+## This is an <h2>
+### This is an <h3>
+#### This is an <h4>
+##### This is an <h5>
+###### This is an <h6>
+
+<!-- Markdown also provides us with two alternative ways of indicating h1 and h2 -->
+This is an h1
+=============
+
+This is an h2
+-------------
+
+<!-- Simple text styles -->
+<!-- Text can be easily styled as italic, bold, or strikethrough using markdown -->
+
+*This text is in italics.*
+_And so is this text._
+
+**This text is in bold.**
+__And so is this text.__
+
+***This text is in both.***
+**_As is this!_**
+*__And this!__*
+
+<!-- In Github Flavored Markdown, which is used to render markdown files on
+Github, we also have: -->
+
+~~This text is rendered with strikethrough.~~
+
+<!-- Paragraphs are a one or multiple adjacent lines of text separated by one or
+multiple blank lines. -->
+
+This is a paragraph. I'm typing in a paragraph isn't this fun?
+
+Now I'm in paragraph 2.
+I'm still in paragraph 2 too!
+
+
+I'm in paragraph three!
+
+<!-- Should you ever want to insert an HTML <br /> tag, you can end a paragraph
+with two or more spaces and then begin a new paragraph. -->
+
+I end with two spaces (highlight me to see them).  
+
+There's a <br /> above me!
+
+<!-- Block quotes are easy and done with the > character. -->
+
+> This is a block quote. You can either
+> manually wrap your lines and put a `>` before every line or you can let your lines get really long and wrap on their own.
+> It doesn't make a difference so long as they start with a `>`.
+
+> You can also use more than one level
+>> of indentation?
+> How neat is that?
+
+<!-- Lists -->
+<!-- Unordered lists can be made using asterisks, pluses, or hyphens -->
+
+* Item
+* Item
+* Another item
+
+or
+
++ Item
++ Item
++ One more item
+
+or 
+
+- Item
+- Item
+- One last item
+
+<!-- Ordered lists are done with a number followed by a period -->
+
+1. Item one
+2. Item two
+3. Item three
+
+<!-- You don't even have to label the items correctly and markdown will still
+render the numbers in order, but this may not be a good idea -->
+
+1. Item one
+1. Item two
+1. Item three
+<!-- (This renders the same as the above example) -->
+
+<!-- You can also use sublists -->
+
+1. Item one
+2. Item two
+3. Item three
+    * Sub-item
+    * Sub-item
+4. Item four
+
+<!-- Code blocks -->
+<!-- You can indicate a code block (which uses the <code> element) by indenting
+a line with four spaces or a tab -->
+
+    This is code
+    So is this
+
+<!-- You can also re-tab (or add an additional four spaces) for indentation
+inside your code -->
+
+    my_array.each do |item|
+        puts item
+    end
+
+<!-- Inline code can be created using the backtick character ` -->
+
+John didn't even know what the `go_to()` function did!
+
+<!-- In Github Flavored Markdown, you can use a special syntax for code -->
+
+\`\`\`ruby <!-- except remove those backslashes when you do this, just ```ruby ! -->
+def foobar
+    puts "Hello world!"
+end
+\`\`\` <!-- here too, no backslashes, just ``` -->
+
+<-- The above text doesn't require indenting, plus Github will use syntax
+highlighting of the language you specify after the ``` -->
+
+<!-- Horizontal rule (<hr />) -->
+<!-- Horizontal rules are easily added with three or more asterisks or hyphens,
+with or without spaces. -->
+
+***
+---
+- - - 
+****************
+
+<!-- Links -->
+<!-- One of the best things about markdown is how easy it is to make links. Put
+the text to display in hard brackets [] followed by the url in parentheses () -->
+
+[Click me!](http://test.com/)
+
+<!-- You can also add a link title using quotes inside the parentheses -->
+
+[Click me!](http://test.com/ "Link to Test.com")
+
+<!-- Relative paths work too. -->
+
+[Go to music](/music/).
+
+<!-- Markdown also supports reference style links -->
+
+[Click this link][link1] for more info about it!
+[Also check out this link][foobar] if you want to.
+
+[link1]: http://test.com/ "Cool!"
+[foobar]: http://foobar.biz/ "Alright!"
+
+<!-- The title can also be in single quotes or in parentheses, or omitted
+entirely. The references can be anywhere in your document and the reference IDs
+can be anything so long as they are unique. -->
+
+<!-- There is also "implicit naming" which lets you use the link text as the id -->
+
+[This][] is a link.
+
+[this]: http://thisisalink.com/
+
+<!-- But it's not that commonly used. -->
+
+<!-- Images -->
+<!-- Images are done the same way as links but with an exclamation point in front! -->
+
+![This is hover-text (alt text) for my image](http://imgur.com/myimage.jpg "An optional title")
+
+<!-- And reference style works as expected -->
+
+![This is the hover-text.][myimage]
+
+[myimage]: relative/urls/cool/image.jpg "if you need a title, it's here"
+
+<!-- Miscellany -->
+<!-- Auto-links -->
+
+<http://testwebsite.com/> is equivalent to
+[http://testwebsite.com/](http://testwebsite.com/)
+
+<!-- Auto-links for emails -->
+
+<foo@bar.com>
+
+<!-- Escaping characters -->
+
+I want to type *this text surrounded by asterisks* but I don't want it to be
+in italics, so I do this: \*this text surrounded by asterisks\*.
+
+<!-- Tables -->
+<!-- Tables are only available in Github Flavored Markdown and are slightly
+cumbersome, but if you really want it: -->
+
+| Col1         | Col2     | Col3          |
+| :----------- | :------: | ------------: |
+| Left-aligned | Centered | Right-aligned |
+| blah         | blah     | blah          |
+
+<!-- or, for the same results -->
+
+Col 1 | Col2 | Col3
+:-- | :-: | --:
+Ugh this is so ugly | make it | stop
+
+<!-- The end! -->
+
+```
+
+For more info, check out John Gruber's official post of syntax [here](http://daringfireball.net/projects/markdown/syntax) and Adam Pritchard's great cheatsheet [here](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).
-- 
cgit v1.2.3


From 1e18c52f615c05343de77edf0ce364b9c3437764 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 13:00:39 +0800
Subject: Updated the file head

---
 zh-cn/markdown-cn.html.markdown | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index 9a863bac..68f2e909 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -2,7 +2,10 @@
 language: markdown
 contributors:
     - ["Dan Turkel", "http://danturkel.com/"]
+translators:
+    - ["Fangzhou Chen", "http://binarythink.net"]
 filename: markdown.md
+lang: zh-cn
 ---
 
 Markdown was created by John Gruber in 2004. It's meant to be an easy to read and write syntax which converts easily to HTML (and now many other formats as well).
-- 
cgit v1.2.3


From 62e5ab350acd1803dea8f52ffd5b437c04cf7f84 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 13:01:14 +0800
Subject: Update markdown-cn.html.markdown

---
 zh-cn/markdown-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index 68f2e909..1e463287 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -3,7 +3,7 @@ language: markdown
 contributors:
     - ["Dan Turkel", "http://danturkel.com/"]
 translators:
-    - ["Fangzhou Chen", "http://binarythink.net"]
+    - ["Fangzhou Chen"]
 filename: markdown.md
 lang: zh-cn
 ---
-- 
cgit v1.2.3


From 821464185ac044a0812584ac794049947d25b736 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 13:24:22 +0800
Subject: 2nd para

---
 zh-cn/markdown-cn.html.markdown | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index 1e463287..f27722ba 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -8,17 +8,16 @@ filename: markdown.md
 lang: zh-cn
 ---
 
-Markdown was created by John Gruber in 2004. It's meant to be an easy to read and write syntax which converts easily to HTML (and now many other formats as well).
+Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的语法结构，并可以便利地转换成HTML（以及其他很多）格式。
 
-Give me as much feedback as you want! / Feel free to fork and pull request!
+欢迎您多多反馈以及分支和请求合并。
 
 
 ```
-<!-- Markdown is a superset of HTML, so any HTML file is valid Markdown, that
-means we can use HTML elements in Markdown, such as the comment element, and
-they won't be affected by a markdown parser. However, if you create an HTML
-element in your markdown file, you cannot use markdown syntax within that
-element's contents. -->
+<!-- Markdown 是HTML的父集，所以任何HTML文件都是有效的Markdown。
+这意味着我们可以在Markdown里使用任何HTML元素，比如注释元素，
+并不会被Markdown解析器所影响。不过如果你在Markdown文件内创建了HTML元素，
+你将无法在HTML元素的内容中使用Markdown语法。-->
 
 <!-- Markdown also varies in implementation from one parser to a next. This
 guide will attempt to clarify when features are universal or when they are
-- 
cgit v1.2.3


From 12b74ada30ef587a85855040f41f2ac5bb09750d Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 15:45:12 +0800
Subject: halfway

---
 zh-cn/markdown-cn.html.markdown | 157 +++++++++++++++++++---------------------
 1 file changed, 74 insertions(+), 83 deletions(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index f27722ba..4f4b4c51 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -19,130 +19,121 @@ Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的
 并不会被Markdown解析器所影响。不过如果你在Markdown文件内创建了HTML元素，
 你将无法在HTML元素的内容中使用Markdown语法。-->
 
-<!-- Markdown also varies in implementation from one parser to a next. This
-guide will attempt to clarify when features are universal or when they are
-specific to a certain parser. -->
-
-<!-- Headers -->
-<!-- You can create HTML elements <h1> through <h6> easily by prepending the
-text you want to be in that element by a number of hashes (#) -->
-# This is an <h1>
-## This is an <h2>
-### This is an <h3>
-#### This is an <h4>
-##### This is an <h5>
-###### This is an <h6>
-
-<!-- Markdown also provides us with two alternative ways of indicating h1 and h2 -->
-This is an h1
+<!-- 在不同的解析器中，Markdown的实现方法有所不同。此教程会指出当某功能是否通用及是否只对某一解析器有效。 -->
+
+<!-- 标头 -->
+<!-- 通过在文本前加上不同数量的hash(#), 你可以创建相对应的 <h1> 到 <h6> HTML元素。 -->
+# 这是一个 <h1>
+## 这是一个 <h2>
+### 这是一个 <h3>
+#### 这是一个 <h4>
+##### 这是一个 <h5>
+###### 这是一个 <h6>
+
+<!-- 对于 <h1> 和 <h2> 元素，Markdown 额外提供了两种添加方式。 -->
+这是一个 h1
 =============
 
-This is an h2
+这是一个 h2
 -------------
 
-<!-- Simple text styles -->
-<!-- Text can be easily styled as italic, bold, or strikethrough using markdown -->
+<!-- 简易文本样式 -->
+<!-- 文本的斜体，粗体，和删除线在Markdown中可以轻易的被实现。-->
 
-*This text is in italics.*
-_And so is this text._
+*此文本为斜体。*
+_此文本也是。_
 
-**This text is in bold.**
-__And so is this text.__
+**此文本为粗体。**
+__此文本也是__
 
-***This text is in both.***
-**_As is this!_**
-*__And this!__*
+***此文本是斜体加粗体。***
+**_或者这样。_**
+*__这个也是！__*
 
-<!-- In Github Flavored Markdown, which is used to render markdown files on
-Github, we also have: -->
+<!-- 在Github采用的Markdown中 -->
 
-~~This text is rendered with strikethrough.~~
+~~此文本为删除线效果。~~
 
-<!-- Paragraphs are a one or multiple adjacent lines of text separated by one or
-multiple blank lines. -->
+<!-- 单个段落由一句或多句邻近的句子组成，这些句子由一个或多个空格分隔。 -->
 
-This is a paragraph. I'm typing in a paragraph isn't this fun?
+这是第一段落. 这句话在同一个段落里，好玩么？
 
-Now I'm in paragraph 2.
-I'm still in paragraph 2 too!
+现在我是第二段落。
+这句话也在第二段落！
 
+这句话在第三段落！
 
-I'm in paragraph three!
+<!-- 如果你插入一个HTML中的<br />标签，你可以在段末加入两个以上的空格，
+然后另起一段。-->
 
-<!-- Should you ever want to insert an HTML <br /> tag, you can end a paragraph
-with two or more spaces and then begin a new paragraph. -->
+此段落结尾有两个空格（选中以显示）。      
 
-I end with two spaces (highlight me to see them).  
+上文有一个 <br /> ！
 
-There's a <br /> above me!
+<!-- 段落引用可由 > 字符轻松实现。 -->
 
-<!-- Block quotes are easy and done with the > character. -->
+> 这是一个段落引用. 你可以
+> 手动断开你的句子，然后在每句句子前面添加 “>” 字符。或者让你的句子变得很长，以至于他们自动得断开。
+> 只要你的文字以“>” 字符开头，两种方式无异。
 
-> This is a block quote. You can either
-> manually wrap your lines and put a `>` before every line or you can let your lines get really long and wrap on their own.
-> It doesn't make a difference so long as they start with a `>`.
+> 你也对文本进行
+>> 多层引用
+> 这多机智啊！
 
-> You can also use more than one level
->> of indentation?
-> How neat is that?
+<!-- 序列 -->
+<!-- 无序序列可由星号，加号或者减号来建立 -->
 
-<!-- Lists -->
-<!-- Unordered lists can be made using asterisks, pluses, or hyphens -->
+* 项目
+* 项目
+* 另一个项目
 
-* Item
-* Item
-* Another item
+或者
 
-or
++ 项目
++ 项目
++ 另一个项目
 
-+ Item
-+ Item
-+ One more item
+或者 
 
-or 
+- 项目
+- 项目
+- 最后一个项目
 
-- Item
-- Item
-- One last item
+<!-- 有序序列可由数字加点来实现 -->
 
-<!-- Ordered lists are done with a number followed by a period -->
+1. 项目一
+2. 项目二
+3. 项目三
 
-1. Item one
-2. Item two
-3. Item three
+<!-- 即使你的标签数字有误，Markdown依旧会呈现出正确的序号，不过这并不是一个好主意-->
 
-<!-- You don't even have to label the items correctly and markdown will still
-render the numbers in order, but this may not be a good idea -->
+1. 项目一
+1. 项目二
+1. 项目三
+<!-- (此段与前例一模一样) -->
 
-1. Item one
-1. Item two
-1. Item three
-<!-- (This renders the same as the above example) -->
+<!-- 你也可以使用子序列 -->
 
-<!-- You can also use sublists -->
+1. 项目一
+2. 项目二
+3. 项目三
+    * 子项目
+    * 子项目
+4. 项目四
 
-1. Item one
-2. Item two
-3. Item three
-    * Sub-item
-    * Sub-item
-4. Item four
-
-<!-- Code blocks -->
-<!-- You can indicate a code block (which uses the <code> element) by indenting
-a line with four spaces or a tab -->
+<!-- 代码段落 -->
+<!-- 代码段落（HTML中<code>标签）可以由缩进四格（spaces）或者一个标签页（tab）实现-->
 
     This is code
     So is this
 
-<!-- You can also re-tab (or add an additional four spaces) for indentation
-inside your code -->
+<!-- 在你的代码中，你仍然使用tab可以进行缩进操作 -->
 
     my_array.each do |item|
         puts item
     end
 
-<!-- Inline code can be created using the backtick character ` -->
+<!-- 内联代码可由反引号 ` 实现 -->
 
 John didn't even know what the `go_to()` function did!
 
-- 
cgit v1.2.3


From e98b62883cd0ef08d72a9da5384df7f5402cb180 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 16:55:29 +0800
Subject: Finally Done

---
 zh-cn/markdown-cn.html.markdown | 115 ++++++++++++++++++++--------------------
 1 file changed, 58 insertions(+), 57 deletions(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index 4f4b4c51..5de5f75b 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -19,10 +19,13 @@ Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的
 并不会被Markdown解析器所影响。不过如果你在Markdown文件内创建了HTML元素，
 你将无法在HTML元素的内容中使用Markdown语法。-->
 
-<!-- 在不同的解析器中，Markdown的实现方法有所不同。此教程会指出当某功能是否通用及是否只对某一解析器有效。 -->
+<!-- 在不同的解析器中，Markdown的实现方法有所不同。
+此教程会指出当某功能是否通用及是否只对某一解析器有效。 -->
 
 <!-- 标头 -->
-<!-- 通过在文本前加上不同数量的hash(#), 你可以创建相对应的 <h1> 到 <h6> HTML元素。 -->
+<!-- 通过在文本前加上不同数量的hash(#), 你可以创建相对应的 <h1> 
+到 <h6> HTML元素。-->
+
 # 这是一个 <h1>
 ## 这是一个 <h2>
 ### 这是一个 <h3>
@@ -54,7 +57,7 @@ __此文本也是__
 
 ~~此文本为删除线效果。~~
 
-<!-- 单个段落由一句或多句邻近的句子组成，这些句子由一个或多个空格分隔。 -->
+<!-- 单个段落由一句或多句邻近的句子组成，这些句子由一个或多个空格分隔。-->
 
 这是第一段落. 这句话在同一个段落里，好玩么？
 
@@ -70,7 +73,7 @@ __此文本也是__
 
 上文有一个 <br /> ！
 
-<!-- 段落引用可由 > 字符轻松实现。 -->
+<!-- 段落引用可由 > 字符轻松实现。-->
 
 > 这是一个段落引用. 你可以
 > 手动断开你的句子，然后在每句句子前面添加 “>” 字符。或者让你的句子变得很长，以至于他们自动得断开。
@@ -105,7 +108,8 @@ __此文本也是__
 2. 项目二
 3. 项目三
 
-<!-- 即使你的标签数字有误，Markdown依旧会呈现出正确的序号，不过这并不是一个好主意-->
+<!-- 即使你的标签数字有误，Markdown依旧会呈现出正确的序号，
+不过这并不是一个好主意-->
 
 1. 项目一
 1. 项目二
@@ -122,7 +126,8 @@ __此文本也是__
 4. 项目四
 
 <!-- 代码段落 -->
-<!-- 代码段落（HTML中<code>标签）可以由缩进四格（spaces）或者一个标签页（tab）实现-->
+<!-- 代码段落（HTML中<code>标签）可以由缩进四格（spaces）
+或者一个标签页（tab）实现-->
 
     This is code
     So is this
@@ -135,105 +140,101 @@ __此文本也是__
 
 <!-- 内联代码可由反引号 ` 实现 -->
 
-John didn't even know what the `go_to()` function did!
+John 甚至不知道 `go_to()` 方程是干嘛的!
 
-<!-- In Github Flavored Markdown, you can use a special syntax for code -->
+<!-- 在Github的 Markdown中，对于代码你可以使用特殊的语法 -->
 
-\`\`\`ruby <!-- except remove those backslashes when you do this, just ```ruby ! -->
+\`\`\`ruby <!-- 插入时记得移除反斜线， 仅留```ruby ！ -->
 def foobar
     puts "Hello world!"
 end
-\`\`\` <!-- here too, no backslashes, just ``` -->
+\`\`\` <!-- 这里也是，移除反斜线，仅留 ``` -->
 
-<-- The above text doesn't require indenting, plus Github will use syntax
-highlighting of the language you specify after the ``` -->
+<!-- 以上代码不需要缩进，而且Github会根据```后表明的语言来进行语法高亮 -->
 
-<!-- Horizontal rule (<hr />) -->
-<!-- Horizontal rules are easily added with three or more asterisks or hyphens,
-with or without spaces. -->
+<!-- 水平线 （<hr />） -->
+<!-- 水平线可由三个或以上的星号或者减号创建，可带可不带空格。 -->
 
 ***
 ---
 - - - 
 ****************
 
-<!-- Links -->
-<!-- One of the best things about markdown is how easy it is to make links. Put
-the text to display in hard brackets [] followed by the url in parentheses () -->
+<!-- 链接 -->
+<!-- Markdown最棒的地方就是简易的链接制作。链接文字放在中括号[]内，
+在随后的括弧()内加入url。-->
 
-[Click me!](http://test.com/)
+[点我点我!](http://test.com/)
 
-<!-- You can also add a link title using quotes inside the parentheses -->
+<!-- 你也可以为链接加入一个标题：在括弧内使用引号 -->
 
-[Click me!](http://test.com/ "Link to Test.com")
+[点我点我!](http://test.com/ "连接到Test.com")
 
-<!-- Relative paths work too. -->
+<!-- 相对路径也可以有 -->
 
-[Go to music](/music/).
+[去 music](/music/).
 
-<!-- Markdown also supports reference style links -->
+<!-- Markdown同样支持引用样式的链接 -->
 
-[Click this link][link1] for more info about it!
-[Also check out this link][foobar] if you want to.
+[点此链接][link1]以获取更多信息！
+[看一看这个链接][foobar] 如果你愿意的话.
 
 [link1]: http://test.com/ "Cool!"
 [foobar]: http://foobar.biz/ "Alright!"
 
-<!-- The title can also be in single quotes or in parentheses, or omitted
-entirely. The references can be anywhere in your document and the reference IDs
-can be anything so long as they are unique. -->
+<!-- 链接的标题可以处于单引号中，括弧中或是被忽略。引用名可以在文档的任意何处，
+并且可以随意命名，只要名称不重复。-->
 
-<!-- There is also "implicit naming" which lets you use the link text as the id -->
+<!-- “隐含式命名” 的功能可以让链接文字作为引用名 -->
 
 [This][] is a link.
 
 [this]: http://thisisalink.com/
 
-<!-- But it's not that commonly used. -->
+<!-- 但这并不常用 -->
 
-<!-- Images -->
-<!-- Images are done the same way as links but with an exclamation point in front! -->
+<!-- 图像 -->
+<!-- 图像与链接相似，只需在前添加一个感叹号 -->
 
-![This is hover-text (alt text) for my image](http://imgur.com/myimage.jpg "An optional title")
+![这是我图像的悬停文本(alt text)](http://imgur.com/myimage.jpg "可选命名")
 
-<!-- And reference style works as expected -->
+<!-- 引用样式也同样起作用 -->
 
-![This is the hover-text.][myimage]
+![这是我的悬停文本.][myimage]
 
-[myimage]: relative/urls/cool/image.jpg "if you need a title, it's here"
+[myimage]: relative/urls/cool/image.jpg "在此输入标题"
 
-<!-- Miscellany -->
-<!-- Auto-links -->
+<!-- 杂项 -->
+<!-- 自动链接 -->
 
-<http://testwebsite.com/> is equivalent to
-[http://testwebsite.com/](http://testwebsite.com/)
+<http://testwebsite.com/> 与
+[http://testwebsite.com/](http://testwebsite.com/) 等同
 
-<!-- Auto-links for emails -->
+<!-- 电子邮件的自动链接 -->
 
 <foo@bar.com>
 
-<!-- Escaping characters -->
+<!-- 转义字符 -->
 
-I want to type *this text surrounded by asterisks* but I don't want it to be
-in italics, so I do this: \*this text surrounded by asterisks\*.
+我希望 *将这段文字置于星号之间* 但是我不希望它被
+斜体化, 所以我就: \*这段置文字于星号之间\*。
 
-<!-- Tables -->
-<!-- Tables are only available in Github Flavored Markdown and are slightly
-cumbersome, but if you really want it: -->
+<!-- 表格 -->
+<!-- 表格只被Github的 Markdown支持，并且有一点笨重，但如果你真的要用的话: -->
 
-| Col1         | Col2     | Col3          |
-| :----------- | :------: | ------------: |
-| Left-aligned | Centered | Right-aligned |
-| blah         | blah     | blah          |
+| 第一列        | 第二列    | 第三列       |
+| :----------   | :------:  | ---------:  |
+| 左对齐        | 居个中    | 右对齐       |
+| 某某某        | 某某某    | 某某某       |
 
-<!-- or, for the same results -->
+<!-- 或者, 同样的 -->
 
-Col 1 | Col2 | Col3
+第一列 | 第二列 | 第三列
 :-- | :-: | --:
-Ugh this is so ugly | make it | stop
+这太丑了 | 药不能 | 停
 
-<!-- The end! -->
+<!-- 结束! -->
 
 ```
 
-For more info, check out John Gruber's official post of syntax [here](http://daringfireball.net/projects/markdown/syntax) and Adam Pritchard's great cheatsheet [here](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).
+更多信息, 请见John Gruber 关于语法的官方帖子[此处](http://daringfireball.net/projects/markdown/syntax)以及 Adam Pritchard 的摘要笔记 [此处](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).
-- 
cgit v1.2.3


From fd010c57e08336d108d979ecad9a82ef30980ed3 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 17:01:22 +0800
Subject: Proofread and checked style

---
 zh-cn/markdown-cn.html.markdown | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index 5de5f75b..f82ebcea 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -1,25 +1,25 @@
 ---
-language: markdown
+language: Markdown
 contributors:
     - ["Dan Turkel", "http://danturkel.com/"]
 translators:
     - ["Fangzhou Chen"]
-filename: markdown.md
+filename: Markdown.md
 lang: zh-cn
 ---
 
-Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的语法结构，并可以便利地转换成HTML（以及其他很多）格式。
+Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的语法结构，并可以便利地转换成 HTML（以及其他很多）格式。
 
 欢迎您多多反馈以及分支和请求合并。
 
 
 ```
-<!-- Markdown 是HTML的父集，所以任何HTML文件都是有效的Markdown。
-这意味着我们可以在Markdown里使用任何HTML元素，比如注释元素，
-并不会被Markdown解析器所影响。不过如果你在Markdown文件内创建了HTML元素，
-你将无法在HTML元素的内容中使用Markdown语法。-->
+<!-- Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown。
+这意味着我们可以在 Markdown 里使用任何 HTML 元素，比如注释元素，
+且不会被 Markdown 解析器所影响。不过如果你在 Markdown 文件内创建了 HTML 元素，
+你将无法在 HTML 元素的内容中使用 Markdown 语法。-->
 
-<!-- 在不同的解析器中，Markdown的实现方法有所不同。
+<!-- 在不同的解析器中，Markdown 的实现方法有所不同。
 此教程会指出当某功能是否通用及是否只对某一解析器有效。 -->
 
 <!-- 标头 -->
@@ -41,7 +41,7 @@ Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的
 -------------
 
 <!-- 简易文本样式 -->
-<!-- 文本的斜体，粗体，和删除线在Markdown中可以轻易的被实现。-->
+<!-- 文本的斜体，粗体，和删除线在 Markdown 中可以轻易的被实现。-->
 
 *此文本为斜体。*
 _此文本也是。_
@@ -53,7 +53,7 @@ __此文本也是__
 **_或者这样。_**
 *__这个也是！__*
 
-<!-- 在Github采用的Markdown中 -->
+<!-- 在 Github 采用的 Markdown 中 -->
 
 ~~此文本为删除线效果。~~
 
@@ -66,7 +66,7 @@ __此文本也是__
 
 这句话在第三段落！
 
-<!-- 如果你插入一个HTML中的<br />标签，你可以在段末加入两个以上的空格，
+<!-- 如果你插入一个 HTML中的<br />标签，你可以在段末加入两个以上的空格，
 然后另起一段。-->
 
 此段落结尾有两个空格（选中以显示）。      
@@ -108,7 +108,7 @@ __此文本也是__
 2. 项目二
 3. 项目三
 
-<!-- 即使你的标签数字有误，Markdown依旧会呈现出正确的序号，
+<!-- 即使你的标签数字有误，Markdown 依旧会呈现出正确的序号，
 不过这并不是一个好主意-->
 
 1. 项目一
@@ -126,7 +126,7 @@ __此文本也是__
 4. 项目四
 
 <!-- 代码段落 -->
-<!-- 代码段落（HTML中<code>标签）可以由缩进四格（spaces）
+<!-- 代码段落（HTML中 <code>标签）可以由缩进四格（spaces）
 或者一个标签页（tab）实现-->
 
     This is code
@@ -150,7 +150,7 @@ def foobar
 end
 \`\`\` <!-- 这里也是，移除反斜线，仅留 ``` -->
 
-<!-- 以上代码不需要缩进，而且Github会根据```后表明的语言来进行语法高亮 -->
+<!-- 以上代码不需要缩进，而且 Github 会根据```后表明的语言来进行语法高亮 -->
 
 <!-- 水平线 （<hr />） -->
 <!-- 水平线可由三个或以上的星号或者减号创建，可带可不带空格。 -->
@@ -161,7 +161,7 @@ end
 ****************
 
 <!-- 链接 -->
-<!-- Markdown最棒的地方就是简易的链接制作。链接文字放在中括号[]内，
+<!-- Markdown 最棒的地方就是简易的链接制作。链接文字放在中括号[]内，
 在随后的括弧()内加入url。-->
 
 [点我点我!](http://test.com/)
@@ -220,10 +220,10 @@ end
 斜体化, 所以我就: \*这段置文字于星号之间\*。
 
 <!-- 表格 -->
-<!-- 表格只被Github的 Markdown支持，并且有一点笨重，但如果你真的要用的话: -->
+<!-- 表格只被 Github 的 Markdown 支持，并且有一点笨重，但如果你真的要用的话: -->
 
 | 第一列        | 第二列    | 第三列       |
-| :----------   | :------:  | ---------:  |
+| :----------   | :------:  | ----------:  |
 | 左对齐        | 居个中    | 右对齐       |
 | 某某某        | 某某某    | 某某某       |
 
@@ -237,4 +237,4 @@ end
 
 ```
 
-更多信息, 请见John Gruber 关于语法的官方帖子[此处](http://daringfireball.net/projects/markdown/syntax)以及 Adam Pritchard 的摘要笔记 [此处](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).
+更多信息, 请见John Gruber 关于语法的官方帖子[此处](http://daringfireball.net/projects/Markdown/syntax)以及 Adam Pritchard 的摘要笔记 [此处](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet).
-- 
cgit v1.2.3


From 3b55d56287ca64e3f8504a6de01d45a305aef90f Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 17:03:38 +0800
Subject: typo correction

---
 zh-cn/markdown-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index f82ebcea..95aef8e2 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -41,7 +41,7 @@ Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的
 -------------
 
 <!-- 简易文本样式 -->
-<!-- 文本的斜体，粗体，和删除线在 Markdown 中可以轻易的被实现。-->
+<!-- 文本的斜体，粗体，和删除线在 Markdown 中可以轻易地被实现。-->
 
 *此文本为斜体。*
 _此文本也是。_
-- 
cgit v1.2.3


From ed8da6c3a70e93958d71e0d4ae79f1ae7f1ab114 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 17:06:11 +0800
Subject: Footnote corrected

---
 zh-cn/markdown-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index 95aef8e2..d0d84d31 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -237,4 +237,4 @@ end
 
 ```
 
-更多信息, 请见John Gruber 关于语法的官方帖子[此处](http://daringfireball.net/projects/Markdown/syntax)以及 Adam Pritchard 的摘要笔记 [此处](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet).
+更多信息, 请于[此处](http://daringfireball.net/projects/Markdown/syntax)参见 John Gruber 关于语法的官方帖子，及于[此处](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet)。 参见 Adam Pritchard 的摘要笔记。
-- 
cgit v1.2.3


From 731026a038c7f9322ade73d3b4fee3c22cb84640 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Mon, 7 Jul 2014 17:13:48 +0800
Subject: Update markdown-cn.html.markdown

---
 zh-cn/markdown-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index d0d84d31..96b0244c 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -237,4 +237,4 @@ end
 
 ```
 
-更多信息, 请于[此处](http://daringfireball.net/projects/Markdown/syntax)参见 John Gruber 关于语法的官方帖子，及于[此处](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet)。 参见 Adam Pritchard 的摘要笔记。
+更多信息, 请于[此处](http://daringfireball.net/projects/Markdown/syntax)参见 John Gruber 关于语法的官方帖子，及于[此处](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet) 参见 Adam Pritchard 的摘要笔记。
-- 
cgit v1.2.3


From d587d9b1c45d545ff9dc7eea99dcb8d649d598f3 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Sat, 26 Jul 2014 01:36:47 +0800
Subject: Changed filename

---
 zh-cn/markdown-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index 96b0244c..58ef2d6d 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -4,7 +4,7 @@ contributors:
     - ["Dan Turkel", "http://danturkel.com/"]
 translators:
     - ["Fangzhou Chen"]
-filename: Markdown.md
+filename: Markdown-cn.md
 lang: zh-cn
 ---
 
-- 
cgit v1.2.3


From 615ee2794184949591f49ff36b3e58c5e166ed39 Mon Sep 17 00:00:00 2001
From: Kevin Fangzhou Chen <kevinchen1219@gmail.com>
Date: Tue, 29 Jul 2014 12:08:24 +0800
Subject: updated the filename into learnmarkdown-cn.md

---
 zh-cn/markdown-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/zh-cn/markdown-cn.html.markdown b/zh-cn/markdown-cn.html.markdown
index 58ef2d6d..975ebcb5 100644
--- a/zh-cn/markdown-cn.html.markdown
+++ b/zh-cn/markdown-cn.html.markdown
@@ -4,7 +4,7 @@ contributors:
     - ["Dan Turkel", "http://danturkel.com/"]
 translators:
     - ["Fangzhou Chen"]
-filename: Markdown-cn.md
+filename: learnmarkdown-cn.md
 lang: zh-cn
 ---
 
-- 
cgit v1.2.3


From 0078b03707eeccf50e5bb1d7230e88b4ce3d36be Mon Sep 17 00:00:00 2001
From: Jean-Christophe Bohin <jc@bohin.net>
Date: Mon, 4 Aug 2014 22:38:53 +0200
Subject: Array initialization disambiguation - fixes #257

simply added proposed comment, which seems fine
---
 go.html.markdown | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/go.html.markdown b/go.html.markdown
index a1be08af..6c4d88bd 100644
--- a/go.html.markdown
+++ b/go.html.markdown
@@ -92,7 +92,8 @@ can include line breaks.` // Same string type.
 
 	// Arrays have size fixed at compile time.
 	var a4 [4]int           // An array of 4 ints, initialized to all 0.
-	a3 := [...]int{3, 1, 5} // An array of 3 ints, initialized as shown.
+	a3 := [...]int{3, 1, 5} // An array initialzed with a fixed size of three
+	//elements, with values 3,1, and 5
 
 	// Slices have dynamic size.  Arrays and slices each have advantages
 	// but use cases for slices are much more common.
-- 
cgit v1.2.3


From c0d49cdb88a41ecea12cc98ca8ee04956b9c0d7b Mon Sep 17 00:00:00 2001
From: Jean-Christophe Bohin <jc@bohin.net>
Date: Thu, 7 Aug 2014 22:37:52 +0200
Subject: Fixing missing space and dot.

---
 go.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/go.html.markdown b/go.html.markdown
index 6c4d88bd..5247ecf8 100644
--- a/go.html.markdown
+++ b/go.html.markdown
@@ -93,7 +93,7 @@ can include line breaks.` // Same string type.
 	// Arrays have size fixed at compile time.
 	var a4 [4]int           // An array of 4 ints, initialized to all 0.
 	a3 := [...]int{3, 1, 5} // An array initialzed with a fixed size of three
-	//elements, with values 3,1, and 5
+	// elements, with values 3, 1, and 5.
 
 	// Slices have dynamic size.  Arrays and slices each have advantages
 	// but use cases for slices are much more common.
-- 
cgit v1.2.3


From b249363a998d08aff750d2722370e648c59cf70f Mon Sep 17 00:00:00 2001
From: Dzianis Dashkevich <dskecse@gmail.com>
Date: Tue, 19 Aug 2014 12:06:52 +0300
Subject: Make style fixes to conform to ruby style guide

Made style fixes to conform to Ruby style guide.
Added a reference to a community-driven Ruby coding style guide.
---
 ruby.html.markdown | 102 ++++++++++++++++++++++++++---------------------------
 1 file changed, 51 insertions(+), 51 deletions(-)

diff --git a/ruby.html.markdown b/ruby.html.markdown
index 962853a2..3c67de2e 100644
--- a/ruby.html.markdown
+++ b/ruby.html.markdown
@@ -9,6 +9,7 @@ contributors:
   - ["Nick LaMuro", "https://github.com/NickLaMuro"]
   - ["Marcos Brizeno", "http://www.about.me/marcosbrizeno"]
   - ["Ariel Krakowski", "http://www.learneroo.com"]
+  - ["Dzianis Dashkevich", "https://github.com/dskecse"]
 
 ---
 
@@ -35,7 +36,7 @@ You shouldn't either
 8 - 1 #=> 7
 10 * 2 #=> 20
 35 / 5 #=> 7
-2 ** 5 #=> 32
+2**5 #=> 32
 
 # Arithmetic is just syntactic sugar
 # for calling a method on an object
@@ -78,14 +79,17 @@ false.class #=> FalseClass
 'I am a string'.class #=> String
 "I am a string too".class #=> String
 
-placeholder = "use string interpolation"
+placeholder = 'use string interpolation'
 "I can #{placeholder} when using double quoted strings"
 #=> "I can use string interpolation when using double quoted strings"
 
+# Prefer single quoted strings to double quoted ones where possible
+# Double quoted strings perform additional inner calculations
+
 # Combine strings, but not with numbers
-"hello " + "world"  #=> "hello world"
-"hello " + 3 #=> TypeError: can't convert Fixnum into String
-"hello " + 3.to_s #=> "hello 3"
+'hello ' + 'world'  #=> "hello world"
+'hello ' + 3 #=> TypeError: can't convert Fixnum into String
+'hello ' + 3.to_s #=> "hello 3"
 
 # print to the output
 puts "I'm printing!"
@@ -130,7 +134,7 @@ array = [1, 2, 3, 4, 5] #=> [1, 2, 3, 4, 5]
 
 # Arrays can contain different types of items
 
-[1, "hello", false] #=> [1, "hello", false]
+[1, 'hello', false] #=> [1, "hello", false]
 
 # Arrays can be indexed
 # From the front
@@ -157,7 +161,7 @@ array << 6 #=> [1, 2, 3, 4, 5, 6]
 
 # Hashes are Ruby's primary dictionary with keys/value pairs.
 # Hashes are denoted with curly braces:
-hash = {'color' => 'green', 'number' => 5}
+hash = { 'color' => 'green', 'number' => 5 }
 
 hash.keys #=> ['color', 'number']
 
@@ -170,7 +174,7 @@ hash['nothing here'] #=> nil
 
 # Since Ruby 1.9, there's a special syntax when using symbols as keys:
 
-new_hash = { defcon: 3, action: true}
+new_hash = { defcon: 3, action: true }
 
 new_hash.keys #=> [:defcon, :action]
 
@@ -180,11 +184,11 @@ new_hash.keys #=> [:defcon, :action]
 # Control structures
 
 if true
-  "if statement"
+  'if statement'
 elsif false
-  "else if, optional"
+  'else if, optional'
 else
-  "else, also optional"
+  'else, also optional'
 end
 
 for counter in 1..5
@@ -216,7 +220,7 @@ end
 #=> iteration 5
 
 # You can also surround blocks in curly brackets:
-(1..5).each {|counter| puts "iteration #{counter}"}
+(1..5).each { |counter| puts "iteration #{counter}" }
 
 # The contents of data structures can also be iterated using each.
 array.each do |element|
@@ -241,32 +245,30 @@ grade = 'B'
 
 case grade
 when 'A'
-  puts "Way to go kiddo"
+  puts 'Way to go kiddo'
 when 'B'
-  puts "Better luck next time"
+  puts 'Better luck next time'
 when 'C'
-  puts "You can do better"
+  puts 'You can do better'
 when 'D'
-  puts "Scraping through"
+  puts 'Scraping through'
 when 'F'
-  puts "You failed!"
+  puts 'You failed!'
 else
-  puts "Alternative grading system, eh?"
+  puts 'Alternative grading system, eh?'
 end
-
 #=> "Better luck next time"
 
 # cases can also use ranges
 grade = 82
 case grade
-    when 90..100
-      puts "Hooray!"
-    when 80...90
-      puts "OK job" 
-    else
-      puts "You failed!"
+when 90..100
+  puts 'Hooray!'
+when 80...90
+  puts 'OK job'
+else
+  puts 'You failed!'
 end
-
 #=> "OK job"
 
 
@@ -284,23 +286,23 @@ double 3 #=> 6
 
 double double 3 #=> 12
 
-def sum(x,y)
+def sum(x, y)
   x + y
 end
 
 # Method arguments are separated by a comma
 sum 3, 4 #=> 7
 
-sum sum(3,4), 5 #=> 12
+sum sum(3, 4), 5 #=> 12
 
 # yield
 # All methods have an implicit, optional block parameter
 # it can be called with the 'yield' keyword
 
 def surround
-  puts "{"
+  puts '{'
   yield
-  puts "}"
+  puts '}'
 end
 
 surround { puts 'hello world' }
@@ -311,25 +313,25 @@ surround { puts 'hello world' }
 
 
 # You can pass a block to a function
-# "&" marks a reference to a passed block 
+# "&" marks a reference to a passed block
 def guests(&block)
- block.call "some_argument" 
+  block.call 'some_argument'
 end
- 
+
 # You can pass a list of arguments, which will be converted into an array
-# That's what splat operator ("*") is for 
+# That's what splat operator ("*") is for
 def guests(*array)
- array.each { |guest| puts "#{guest}" }
+  array.each { |guest| puts guest }
 end
 
 # Define a class with the class keyword
 class Human
 
   # A class variable. It is shared by all instances of this class.
-  @@species = "H. sapiens"
+  @@species = 'H. sapiens'
 
   # Basic initializer
-  def initialize(name, age=0)
+  def initialize(name, age = 0)
     # Assign the argument to the "name" instance variable for the instance
     @name = name
     # If no age given, we will fall back to the default in the arguments list.
@@ -356,20 +358,19 @@ class Human
   # A class method uses self to distinguish from instance methods.
   # It can only be called on the class, not an instance.
   def self.say(msg)
-    puts "#{msg}"
+    puts msg
   end
 
   def species
     @@species
   end
-
 end
 
 
 # Instantiate a class
-jim = Human.new("Jim Halpert")
+jim = Human.new('Jim Halpert')
 
-dwight = Human.new("Dwight K. Schrute")
+dwight = Human.new('Dwight K. Schrute')
 
 # Let's call a couple of methods
 jim.species #=> "H. sapiens"
@@ -380,7 +381,7 @@ dwight.species #=> "H. sapiens"
 dwight.name #=> "Dwight K. Schrute"
 
 # Call the class method
-Human.say("Hi") #=> "Hi"
+Human.say('Hi') #=> "Hi"
 
 # Variable's scopes are defined by the way we name them.
 # Variables that start with $ have global scope
@@ -399,7 +400,7 @@ defined? @@var #=> "class variable"
 Var = "I'm a constant"
 defined? Var #=> "constant"
 
-# Class also is object in ruby. So class can have instance variables.
+# Class is also an object in ruby. So class can have instance variables.
 # Class variable is shared among the class and all of its descendants.
 
 # base class
@@ -415,7 +416,7 @@ class Human
   end
 end
 
-#  derived class
+# derived class
 class Worker < Human
 end
 
@@ -451,8 +452,8 @@ module ModuleExample
   end
 end
 
-# Including modules binds the methods to the object instance
-# Extending modules binds the methods to the class instance
+# Including modules binds their methods to the class instances
+# Extending modules binds their methods to the class itself
 
 class Person
   include ModuleExample
@@ -467,7 +468,7 @@ Person.new.foo # => 'foo'
 Book.foo       # => 'foo'
 Book.new.foo   # => NoMethodError: undefined method `foo'
 
-# Callbacks when including and extending a module are executed
+# Callbacks are executed when including and extending a module
 
 module ConcernExample
   def self.included(base)
@@ -500,9 +501,8 @@ Something.new.qux # => 'qux'
 
 ## Additional resources
 
-- [Learn Ruby by Example with Challenges](http://www.learneroo.com/modules/61/nodes/338) - A variant of this reference with in-browser challenges. 
+- [Learn Ruby by Example with Challenges](http://www.learneroo.com/modules/61/nodes/338) - A variant of this reference with in-browser challenges.
 - [Official Documentation](http://www.ruby-doc.org/core-2.1.1/)
 - [Ruby from other languages](https://www.ruby-lang.org/en/documentation/ruby-from-other-languages/)
-- [Programming Ruby](http://www.amazon.com/Programming-Ruby-1-9-2-0-Programmers/dp/1937785491/) - An older [free addition](http://ruby-doc.com/docs/ProgrammingRuby/) is available online. 
-
-
+- [Programming Ruby](http://www.amazon.com/Programming-Ruby-1-9-2-0-Programmers/dp/1937785491/) - An older [free addition](http://ruby-doc.com/docs/ProgrammingRuby/) is available online.
+- [Ruby Style Guide](https://github.com/bbatsov/ruby-style-guide) - A community-driven Ruby coding style guide.
-- 
cgit v1.2.3


From ddd4db06cabe4371b5cf6802b70995ac3b4a4db6 Mon Sep 17 00:00:00 2001
From: Nicolas Brugneaux <nicolas.brugneaux@gmail.com>
Date: Wed, 20 Aug 2014 02:01:40 +0200
Subject: Added French translation for Javascript

---
 fr-fr/javascript-fr.html.markdown | 508 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 508 insertions(+)
 create mode 100644 fr-fr/javascript-fr.html.markdown

diff --git a/fr-fr/javascript-fr.html.markdown b/fr-fr/javascript-fr.html.markdown
new file mode 100644
index 00000000..598fb6af
--- /dev/null
+++ b/fr-fr/javascript-fr.html.markdown
@@ -0,0 +1,508 @@
+---
+language: javascript
+contributors:
+    - ['Adam Brenecki', 'http://adam.brenecki.id.au']
+    - ['Ariel Krakowski', 'http://www.learneroo.com']
+filename: javascript-fr.js
+translators:
+    - ['@nbrugneaux', 'https://nicolasbrugneaux.me']
+lang: fr-fr
+---
+
+JavaScript a été crée par Brendan Eich, travaillant alors a Netscape, en 1995.
+Le langage avait à l'origine pour but d'être un langage de scripting simple
+pour les sites web, complétant le Java pour des applications web complexes. Mais
+son intégration très proche et simple des pages web, ainsi que le support natif
+des navigateurs a rendu le JavaScript incontournable aujourd'hui tant bien dans 
+le front-end que dans le back-end.
+
+En effet, le JavaScript n'est plus uniquement limité aux navigateurs, grâce à
+Node.JS, un projet qui offre un environnement indépendant dans lequel un 
+interpréteur Javascript, basé sur le célèbre moteur V8 de Google Chrome, 
+peut être utilisé directement côté serveur pour exécuter des programmes écrits
+en JavaScript.
+
+```js
+// Les commentaires sont comme en C. Les commentaires en ligne commencent par 2 slashs,
+/* et les commentaires sur plusieurs lignes commencent avec slash-étoile
+   et finissent avec étoile-slash */
+
+// Toutes les expressions peuvent finir par ;
+doStuff();
+
+// ... mais n'en n'ont pas forcément besoin, les point-virgules sont ajoutés 
+// lors de l’interprétation aux sauts de ligne, sauf exceptions
+doStuff()
+
+// Parce que ces cas peuvent produire des effets inattendus, nous utiliserons
+// des point-virgules dans ce guide.
+
+///////////////////////////////////
+// 1. Nombres, Chaines de caractères et Opérateurs
+
+// JavaScript a un seul type de nombre (qui est un 64-bit IEEE 754 double (décimaux))
+// Comme avec le Lua, ne paniquez pas à cause du manque d'int (entiers): les
+// doubles ont un mantisse de 52 bits, ce qui est assez pour stocker des int jusqu'à
+// 9 x 10¹⁵ exactement.
+3; // = 3
+1.5; // = 1.5
+
+// L'arithmétique de base fonctionne comme vous vous y attendriez
+1 + 1; // = 2
+8 - 1; // = 7
+10 * 2; // = 20
+35 / 5; // = 7
+
+// Ainsi que les divisions non-entières
+5 / 2; // = 2.5
+
+// Les opérations bits à bits fonctionnent aussi, quand vous effectuez une opération
+// bits à bits , votre nombre décimal est converti en entier *jusqu'à* 32 bits.
+1 << 2; // = 4
+
+// Comme en mathématiques, la priorité est donnée aux parenthèses.
+(1 + 3) * 2; // = 8
+
+// Il existe 3 valeurs spéciales pour les nombres:
+Infinity; // le résultat de 1/0 par exemple
+-Infinity; // le résultat de -1/0 par exemple
+NaN; // le résultat de 0/0 par exemple
+
+// Il existe également le type booléen.
+true; // vrai
+false; // faux
+
+// Les chaines de caractères (strings) sont crées avec ' ou ' indifféremment, la seule
+// raison de choisir l'un ou l'autre est la consistance dans votre code.
+'abc';
+'Hello, world';
+
+// La négation utilise le symbole !
+!true; // = false
+!false; // = true
+
+// L'égalité est === ou ==
+// === compare la valeur exacte 2 === '2' // = false
+// == convertit la valeur pour comparer 2 === '2' // = true
+// En général, il vaut mieux utiliser === pour ne pas faire d'erreurs.
+1 === 1; // = true
+2 === 1; // = false
+
+// L'inégalité est !== ou !=, basé sur le même principe qu'avant.
+1 !== 1; // = false
+2 !== 1; // = true
+
+// Plus de comparaisons:
+1 < 10; // = true
+1 > 10; // = false
+2 <= 2; // = true
+2 >= 2; // = true
+
+// Les strings se concatènent avec +
+'Hello ' + 'world!'; // = 'Hello world!'
+
+// et peuvent être comparées avec < et >
+'a' < 'b'; // = true
+
+// Vous pouvez accéder les caractères dans une string avec charAt
+'This is a string'.charAt(0);  // = 'T'
+
+// .. ou utiliser substring pour avoir un plus gros morceau
+'Hello world'.substring(0, 5); // = 'Hello'
+
+// la longueur, length, est une propriété, donc n'utilisez pas de ()
+'Hello'.length; // = 5
+
+// Il y a également null et undefined
+null; // utilisé pour une non-valeur
+undefined; // utilisé pour une valeur actuellement non présente (cependant, 
+           // undefined est aussi une valeur valide)
+
+// false, null, undefined, NaN, 0 and '' sont 'presque-faux' (falsy), tout le reste
+// est 'presque-vrai' (truthy)
+// Notez que 0 est falsy mais '0' est truthy, alors même que 0 == '0' (mais 0 !== '0')
+
+
+///////////////////////////////////
+// 2. Variables, Tableaux et Objets
+
+// Les variables sont déclarées avec le mot clé var. Le typage en JavaScript est 
+// dynamique, donc pas besoin de spécifier le type. L'assignement utilise un seul =.
+var someVar = 5;
+
+// si vous oubliez le mot clé var, vous n'aurez pas d'erreur (sauf en mode strict)
+someOtherVar = 10;
+
+// ... mais la variable sera crée dans l’environnement global, et non l’environnement
+// local dans lequel vous l'avez défini.
+
+// Les variables déclarées et non assignées sont undefined par défaut
+var someThirdVar;
+var someThirdVar = undefined;
+
+// ... sont deux déclarations identiques.
+
+// Il y a des raccourcis pour les opérations mathématiques:
+someVar += 5; // équivalent pour someVar = someVar + 5;
+someVar *= 10; // de même, someVar = someVar * 100;
+someVar++;    // = someVar += 1;
+someVar--;  // = someVar -= 1;
+
+// Les tableaux (Arrays) sont des listes ordonnées de valeurs, de tous types.
+var myArray = ['Hello', 45, true];
+
+// Leurs membres peuvent être accédés en utilisant les crochets
+// Les indices commencent à 0.
+myArray[1]; // = 45
+
+// Les tableaux sont modifiables, ainsi que leurs longueurs
+myArray.push( 'World' );
+myArray.length; // = 4
+
+// Ajout/Modification à un index spécifique
+myArray[3] = 'Hello';
+
+// Les objets JavaScript sont appelés 'dictionnaires' ou 'maps' dans certains autres
+// langages: ils sont une liste non-ordonnée de paires clé-valeur.
+var myObj = {key1: 'Hello', key2: 'World'};
+
+// Les clés sont des strings, mais les ' ou " sont optionels si elles sont des
+// noms valides en JavaScript. Les valeurs peuvent être de n'importe quel type.
+var myObj = {myKey: 'myValue', 'my other key': 4};
+
+// Les attributs d'objets peuvent être accédés avec les crochets
+myObj['my other key']; // = 4
+
+// .. ou avec un point si la clé est un identifiant valide.
+myObj.myKey; // = 'myValue'
+
+// Les objets sont eux aussi modifiables.
+myObj.myThirdKey = true;
+
+// Si vous essayez d'accéder à une valeur non-définie, vous obtiendrez undefined
+myObj.myFourthKey; // = undefined
+
+///////////////////////////////////
+// 3. Logique et structures de contrôle
+
+// La syntaxe de cette section est identique au Java.
+
+// Les si (if) fonctionnent comme vous vous y attendez.
+var count = 1;
+if (count === 3) {
+  // seulement quand count est 3
+}
+else if (count === 4) {
+  // uniquement quand count est 4
+}
+else {
+  // le reste du temps, si ni 3, ni 4. 
+}
+
+// De même pour while.
+while (true) {
+  // Une boucle infinie !
+}
+
+// Les boucles do-while sont pareilles, mais sont exécutées au moins une fois.
+var input
+do {
+  input = getInput();
+} while (!isValid(input))
+
+// La boucle for est la même qu'en C ou en Java:
+// initialisation; condition pour continuer; itération
+for (var i = 0; i < 5; i++){
+    // sera exécutée 5 fois
+}
+
+// && est le "et" logique, || est le "ou" logique
+if (house.size === 'big' && house.colour === 'blue'){
+    house.contains = 'bear';
+}
+if (colour === 'red' || colour === 'blue'){
+    // colour est soit 'red' soit 'blue'
+}
+
+// Les raccourcis && et || sont pratiques pour instancier des valeurs par defaut.
+var name = otherName || 'default';
+
+// Ceci est l'équivalent de
+var name = otherName;
+if (!name){
+  name = 'default';
+}
+
+// Le switch vérifie les égalités avec ===
+// utilisez un "break" à la fin de chaque cas
+// ou les cas suivants seront eux aussi exécutés
+grade = 'B';
+switch (grade) {
+  case 'A':
+    console.log('Great job');
+    break;
+  case 'B':
+    console.log('OK job');
+    break;
+  case 'C':
+    console.log('You can do better');
+    break;
+  default:
+    console.log('Oy vey');
+    break;
+}
+
+
+///////////////////////////////////
+// 4. Fonctions, Scope (Environnement) et Closures
+
+// Les fonctions sont déclarées avec le mot clé function
+function myFunction(thing){
+    return thing.toUpperCase();
+}
+myFunction('foo'); // = 'FOO'
+
+// Les fonctions JavaScript sont des objets de première classe, donc peuvent 
+// être réassignées à d'autres variables et passées en tant que paramètres pour
+// d'autres fonctions
+function myFunction(){
+    // ce code s'exécutera dans 5 secondes
+}
+setTimeout(myFunction, 5000);
+// Note: setTimeout ne fait pas parti du langage, mais les navigateurs ainsi
+// que Node.js le rendent disponible
+
+// Les fonctions n'ont pas nécessairement besoin d'un nom, elles peuvent être 
+// anonymes
+setTimeout(function(){
+    // ce code s'exécutera dans 5 secondes
+}, 5000);
+
+// Le Javascript crée uniquement un scope dans les fonctions, pas dans les 
+// autres blocs.
+if (true){
+    var i = 5;
+}
+i; // = 5 - et non undefined comme vous pourriez vous y attendre
+
+// Cela a mené à un style comment de fonctions anonymes immédiatement exécutée;
+// ou "immediately-executing anonymous functions"
+(function(){
+    var temporary = 5;
+    // Nous pouvons accéder au scope global en assignant à l'objet global,
+    // qui dans les navigateurs est "window". Il est différent dans Node.js.
+    window.permanent = 10;
+})();
+// Cela permet de ne pas avoir de fuites de variables qui polluent
+// l’environnement global.
+temporary; // raises ReferenceError
+permanent; // = 10
+
+// Une des particularité les plus puissantes de Javascript est le système de 
+// closures. Si une fonction est définie dans une autre fonction, alors la 
+// fonction interne aura accès aux variables de la fonction parente, même si
+// celle-ci a déjà finie son exécution.
+function sayHelloInFiveSeconds(name){
+    var prompt = 'Hello, ' + name + '!';
+    // Fonction interne
+    function inner(){
+        alert(prompt);
+    }
+    setTimeout(inner, 5000);
+    // setTimeout is asynchrone, donc la fonction sayHelloInFiveSeconds quittera
+    // immédiatement, et setTimeout appelera inner après.
+}
+sayHelloInFiveSeconds('Adam'); // ouvre un popup avec 'Hello, Adam!' dans 5sec
+
+///////////////////////////////////
+// 5. Encore plus à propos des Objets; Constructeurs and Prototypes
+
+// Les objets peuvent contenir des fonctions.
+var myObj = {
+    myFunc: function(){
+        return 'Hello world!';
+    }
+};
+myObj.myFunc(); // = 'Hello world!'
+
+// Lorsqu'une fonction attachée à un objet est appelée, elle peut accéder à
+// l'objet avec le mot clé this.
+myObj = {
+    myString: 'Hello world!',
+    myFunc: function(){
+        return this.myString;
+    }
+};
+myObj.myFunc(); // = 'Hello world!'
+
+// LA valeur de "this" change de par l'endroit où la fonction est appelée, et 
+// non de l'endroit où elle est définie. Donc elle ne fonctionnera pas si elle
+// est appelée hors du contexte l'objet.
+var myFunc = myObj.myFunc;
+myFunc(); // = undefined
+
+// A l'inverse, une fonction peut être attachée à un objet et y gagner l'accès
+// au travers de "this"
+var myOtherFunc = function(){
+    return this.myString.toUpperCase();
+}
+
+myObj.myOtherFunc = myOtherFunc;
+myObj.myOtherFunc(); // = 'HELLO WORLD!'
+
+// Nous pouvons aussi spécifier un contexte pour une fonction quand elle est 
+// appelée grâce à "call" ou "apply".
+var anotherFunc = function(s){
+    return this.myString + s;
+}
+anotherFunc.call(myObj, ' And Hello Moon!'); // = 'Hello World! And Hello Moon!'
+
+// 'apply' est presque identique, mais prend un tableau comme liste d’arguments.
+
+anotherFunc.apply(myObj, [' And Hello Sun!']); // = 'Hello World! And Hello Sun!'
+
+Math.min(42, 6, 27); // = 6
+Math.min([42, 6, 27]); // = NaN (uh-oh!)
+Math.min.apply(Math, [42, 6, 27]); // = 6
+
+// Mais, "call" and "apply" sont temporaires. Pour lier le contexte de façon
+// permanente, nous pouvons utiliser "bind"
+var boundFunc = anotherFunc.bind(myObj);
+boundFunc(' And Hello Saturn!'); // = 'Hello World! And Hello Saturn!'
+
+// "bind" peut aussi être utilisé pour créer une application partielle de la 
+// fonction (curry)
+var product = function(a, b){ return a * b; }
+var doubler = product.bind(this, 2);
+doubler(8); // = 16
+
+// Lorsque vous appelez une fonction avec le mot clé "new", un nouvel objet est 
+// crée et mis à disposition de la fonction via "this". Ces fonctions sont
+// communément appelées constructeurs.
+var MyConstructor = function(){
+    this.myNumber = 5;
+}
+myNewObj = new MyConstructor(); // = {myNumber: 5}
+myNewObj.myNumber; // = 5
+
+// Chaque objet en Javascript a un "prototype". Quand vous essayez d'accéder à
+// une propriété que n'a pas l'objet, l'interpréteur regarder son prototype.
+
+// Quelque implémentations de JS vous laissent accéder au prototype avec la 
+// propriété "magique" __proto__. Ceci peut être utile, mais n'est pas standard 
+// et ne fonctionne pas dans les navigateurs actuels.
+var myObj = {
+    myString: 'Hello world!'
+};
+var myPrototype = {
+    meaningOfLife: 42,
+    myFunc: function(){
+        return this.myString.toLowerCase()
+    }
+};
+
+myObj.__proto__ = myPrototype;
+myObj.meaningOfLife; // = 42
+myObj.myFunc(); // = 'hello world!'
+
+myPrototype.__proto__ = {
+    myBoolean: true
+};
+myObj.myBoolean; // = true
+
+// Il n'y a pas de copie ici. Chacun des objets stocke une référence à son
+// prototype. Cela veut dire que l'on peut le modifier et cela se répercutera
+// partout.
+myPrototype.meaningOfLife = 43;
+myObj.meaningOfLife; // = 43
+
+// Comme précédemment dit, __proto__ n'est pas standard et ne devrait pas être
+// utilisé. Il y a deux autres moyen de créer un nouvel objet avec un prototype
+// donné.
+
+// Le premier est Object.create, mais c'est assez récent et risque de ne pas
+// fonctionner dans tous les navigateurs.
+var myObj = Object.create(myPrototype);
+myObj.meaningOfLife; // = 43
+
+// Le deuxième moyen, qui marche partout, fonctionne avec les constructeurs.
+// Les constructeurs ont un propriété appelée prototype. Ce n'est *pas* le
+// prototype du constructeur de la fonction elle-même, c'est le prototype que
+// les nouveaux objets crées grâce à ce constructeur avec "new" auront.
+MyConstructor.prototype = {
+    myNumber: 5,
+    getMyNumber: function(){
+        return this.myNumber;
+    }
+};
+var myNewObj2 = new MyConstructor();
+myNewObj2.getMyNumber(); // = 5
+myNewObj2.myNumber = 6
+myNewObj2.getMyNumber(); // = 6
+
+// Les types pré-définis tels que les strings ou nombres ont aussi des
+// constructeurs
+var myNumber = 12;
+var myNumberObj = new Number(12);
+myNumber == myNumberObj; // = true
+
+// ... mais ils ne sont pas exactement équivalent.
+typeof myNumber; // = 'number'
+typeof myNumberObj; // = 'object'
+myNumber === myNumberObj; // = false
+if (0){
+    // 0 est falsy, le code ne fonctionnera pas.
+}
+if (Number(0)){
+    // Parce que Number(0) est truthy, le code fonctionnera
+}
+
+// Cependant, vous pouvez ajouter des fonctionnalités aux types de bases grâce à
+// cette particularité.
+String.prototype.firstCharacter = function(){
+    return this.charAt(0);
+}
+'abc'.firstCharacter(); // = 'a'
+
+// C'est très souvent utilisé pour le "polyfilling", qui implémente des nouvelles
+// fonctionnalités de JavaScript dans de plus anciens environnements, tels que 
+// les vieux navigateurs.
+
+//Par exemple, Object.create est assez récent, mais peut être implémenté grâce à
+// ce polyfill
+if (Object.create === undefined){ // don't overwrite it if it exists
+    Object.create = function(proto){
+        // make a temporary constructor with the right prototype
+        var Constructor = function(){};
+        Constructor.prototype = proto;
+        // then use it to create a new, appropriately-prototyped object
+        return new Constructor();
+    }
+}
+
+## Pour aller plus loin (en anglais)
+
+The [Mozilla Developer
+Network](https://developer.mozilla.org/fr-FR/docs/Web/JavaScript) expose une
+excellente documentation pour le Javascript dans les navigateurs. Et contient 
+également un wiki pour s'entraider.
+
+MDN's [A re-introduction to
+JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)
+recouvre les principaux sujets vus ici. Le guide est délibérément uniquement
+à propos du JavaScript, et ne parle pas des navigateurs; pour cela, dirigez vous 
+plutôt ici :
+[Document Object
+Model](https://developer.mozilla.org/en-US/docs/Using_the_W3C_DOM_Level_1_Core)
+
+[Learn Javascript by Example and with Challenges](http://www.learneroo.com/modules/64/nodes/350) quelques challenges. 
+
+[JavaScript Garden](http://bonsaiden.github.io/JavaScript-Garden/) is an in-depth
+un guide pour vous éviter les faux-amis dans le JavaScript.
+
+[JavaScript: The Definitive Guide](http://www.amazon.com/gp/product/0596805527/) un classique. A lire. 
+
+En addition aux contributeurs de cet article, du contenu provient du 
+"Python tutorial" de Louie Dinh, et de [JS
+Tutorial](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)
+sur le réseau Mozilla.
-- 
cgit v1.2.3


From 1d4e0929ff82d7205b09da2f30b37541464dc029 Mon Sep 17 00:00:00 2001
From: Nicolas Brugneaux <nicolas.brugneaux@gmail.com>
Date: Wed, 20 Aug 2014 02:03:01 +0200
Subject: Update javascript-fr.html.markdown

---
 fr-fr/javascript-fr.html.markdown | 1 +
 1 file changed, 1 insertion(+)

diff --git a/fr-fr/javascript-fr.html.markdown b/fr-fr/javascript-fr.html.markdown
index 598fb6af..1dc4f8db 100644
--- a/fr-fr/javascript-fr.html.markdown
+++ b/fr-fr/javascript-fr.html.markdown
@@ -479,6 +479,7 @@ if (Object.create === undefined){ // don't overwrite it if it exists
         return new Constructor();
     }
 }
+```
 
 ## Pour aller plus loin (en anglais)
 
-- 
cgit v1.2.3


From 1421ef08f5aa7de56a413753d9017693d3b44187 Mon Sep 17 00:00:00 2001
From: Nicolas Brugneaux <nicolas.brugneaux@gmail.com>
Date: Wed, 20 Aug 2014 10:12:21 +0200
Subject: Updated the part that I forgot to translate.

---
 fr-fr/javascript-fr.html.markdown | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/fr-fr/javascript-fr.html.markdown b/fr-fr/javascript-fr.html.markdown
index 1dc4f8db..55f7858c 100644
--- a/fr-fr/javascript-fr.html.markdown
+++ b/fr-fr/javascript-fr.html.markdown
@@ -37,6 +37,7 @@ doStuff()
 // Parce que ces cas peuvent produire des effets inattendus, nous utiliserons
 // des point-virgules dans ce guide.
 
+
 ///////////////////////////////////
 // 1. Nombres, Chaines de caractères et Opérateurs
 
@@ -182,6 +183,7 @@ myObj.myThirdKey = true;
 // Si vous essayez d'accéder à une valeur non-définie, vous obtiendrez undefined
 myObj.myFourthKey; // = undefined
 
+
 ///////////////////////////////////
 // 3. Logique et structures de contrôle
 
@@ -314,6 +316,7 @@ function sayHelloInFiveSeconds(name){
 }
 sayHelloInFiveSeconds('Adam'); // ouvre un popup avec 'Hello, Adam!' dans 5sec
 
+
 ///////////////////////////////////
 // 5. Encore plus à propos des Objets; Constructeurs and Prototypes
 
@@ -470,12 +473,12 @@ String.prototype.firstCharacter = function(){
 
 //Par exemple, Object.create est assez récent, mais peut être implémenté grâce à
 // ce polyfill
-if (Object.create === undefined){ // don't overwrite it if it exists
+if (Object.create === undefined){ // pour ne pas reécrire si la fonction existe déjà
     Object.create = function(proto){
-        // make a temporary constructor with the right prototype
+        // créer un constructeur temporaire avec le bon prototype
         var Constructor = function(){};
         Constructor.prototype = proto;
-        // then use it to create a new, appropriately-prototyped object
+        // puis on utilise "new" pour créer un object avec ce prototype
         return new Constructor();
     }
 }
-- 
cgit v1.2.3


From f6367016949df3576e9cce4b96148da1f867464c Mon Sep 17 00:00:00 2001
From: Nicolas Brugneaux <nicolas.brugneaux@gmail.com>
Date: Wed, 20 Aug 2014 12:10:15 +0200
Subject: =?UTF-8?q?Translatated=20strings=20to=20"chaines=20de=20caract?=
 =?UTF-8?q?=C3=A8res"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 fr-fr/javascript-fr.html.markdown | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/fr-fr/javascript-fr.html.markdown b/fr-fr/javascript-fr.html.markdown
index 55f7858c..9e69a038 100644
--- a/fr-fr/javascript-fr.html.markdown
+++ b/fr-fr/javascript-fr.html.markdown
@@ -73,9 +73,9 @@ NaN; // le résultat de 0/0 par exemple
 true; // vrai
 false; // faux
 
-// Les chaines de caractères (strings) sont crées avec ' ou ' indifféremment, la seule
+// Les chaines de caractères (strings) sont crées avec " ou ' indifféremment, la seule
 // raison de choisir l'un ou l'autre est la consistance dans votre code.
-'abc';
+"abc";
 'Hello, world';
 
 // La négation utilise le symbole !
@@ -99,10 +99,10 @@ false; // faux
 2 <= 2; // = true
 2 >= 2; // = true
 
-// Les strings se concatènent avec +
+// Les chaines de caractères se concatènent avec +
 'Hello ' + 'world!'; // = 'Hello world!'
 
-// et peuvent être comparées avec < et >
+// et peuvent être comparées alphabétiquement avec < et >
 'a' < 'b'; // = true
 
 // Vous pouvez accéder les caractères dans une string avec charAt
@@ -475,10 +475,10 @@ String.prototype.firstCharacter = function(){
 // ce polyfill
 if (Object.create === undefined){ // pour ne pas reécrire si la fonction existe déjà
     Object.create = function(proto){
-        // créer un constructeur temporaire avec le bon prototype
+        // on crée un constructeur temporaire avec le bon prototype
         var Constructor = function(){};
         Constructor.prototype = proto;
-        // puis on utilise "new" pour créer un object avec ce prototype
+        // puis on utilise "new" pour créer un object avec ce même prototype
         return new Constructor();
     }
 }
-- 
cgit v1.2.3


From 7367cd9ae801bf0b8fdcef0ab57212e23057869b Mon Sep 17 00:00:00 2001
From: Nicolas Brugneaux <nicolas.brugneaux@gmail.com>
Date: Wed, 20 Aug 2014 19:08:18 +0200
Subject: Updated according to the review.

---
 fr-fr/javascript-fr.html.markdown | 64 +++++++++++++++++++++++----------------
 1 file changed, 38 insertions(+), 26 deletions(-)

diff --git a/fr-fr/javascript-fr.html.markdown b/fr-fr/javascript-fr.html.markdown
index 9e69a038..21c8b5ae 100644
--- a/fr-fr/javascript-fr.html.markdown
+++ b/fr-fr/javascript-fr.html.markdown
@@ -11,10 +11,11 @@ lang: fr-fr
 
 JavaScript a été crée par Brendan Eich, travaillant alors a Netscape, en 1995.
 Le langage avait à l'origine pour but d'être un langage de scripting simple
-pour les sites web, complétant le Java pour des applications web complexes. Mais
-son intégration très proche et simple des pages web, ainsi que le support natif
-des navigateurs a rendu le JavaScript incontournable aujourd'hui tant bien dans 
-le front-end que dans le back-end.
+pour les sites web, complétant le Java (à ne pas confondre avec JavaScript)
+pour des applications web complexes. Mais son intégration très proche et 
+simple des pages web, ainsi que le support natif des navigateurs a rendu 
+le JavaScript incontournable aujourd'hui tant bien dans le front-end que 
+dans le back-end.
 
 En effet, le JavaScript n'est plus uniquement limité aux navigateurs, grâce à
 Node.JS, un projet qui offre un environnement indépendant dans lequel un 
@@ -23,7 +24,7 @@ peut être utilisé directement côté serveur pour exécuter des programmes éc
 en JavaScript.
 
 ```js
-// Les commentaires sont comme en C. Les commentaires en ligne commencent par 2 slashs,
+// Les commentaires sont comme en C. Les commentaires mono-ligne commencent par 2 slashs,
 /* et les commentaires sur plusieurs lignes commencent avec slash-étoile
    et finissent avec étoile-slash */
 
@@ -42,7 +43,7 @@ doStuff()
 // 1. Nombres, Chaines de caractères et Opérateurs
 
 // JavaScript a un seul type de nombre (qui est un 64-bit IEEE 754 double (décimaux))
-// Comme avec le Lua, ne paniquez pas à cause du manque d'int (entiers): les
+// Comme avec le Lua, ne paniquez pas à cause du manque d'int (entiers) : les
 // doubles ont un mantisse de 52 bits, ce qui est assez pour stocker des int jusqu'à
 // 9 x 10¹⁵ exactement.
 3; // = 3
@@ -58,7 +59,7 @@ doStuff()
 5 / 2; // = 2.5
 
 // Les opérations bits à bits fonctionnent aussi, quand vous effectuez une opération
-// bits à bits , votre nombre décimal est converti en entier *jusqu'à* 32 bits.
+// bits à bits, votre nombre décimal est converti en entier *jusqu'à* 32 bits.
 1 << 2; // = 4
 
 // Comme en mathématiques, la priorité est donnée aux parenthèses.
@@ -73,8 +74,8 @@ NaN; // le résultat de 0/0 par exemple
 true; // vrai
 false; // faux
 
-// Les chaines de caractères (strings) sont crées avec " ou ' indifféremment, la seule
-// raison de choisir l'un ou l'autre est la consistance dans votre code.
+// Les chaines de caractères (strings) sont créees avec " ou ' indifféremment, la seule
+// raison de choisir l'un ou l'autre est la cohérence dans votre code.
 "abc";
 'Hello, world';
 
@@ -85,7 +86,7 @@ false; // faux
 // L'égalité est === ou ==
 // === compare la valeur exacte 2 === '2' // = false
 // == convertit la valeur pour comparer 2 === '2' // = true
-// En général, il vaut mieux utiliser === pour ne pas faire d'erreurs.
+// En général, il vaut mieux utiliser === pour ne pas faire d'erreur.
 1 === 1; // = true
 2 === 1; // = false
 
@@ -93,7 +94,7 @@ false; // faux
 1 !== 1; // = false
 2 !== 1; // = true
 
-// Plus de comparaisons:
+// Plus de comparaisons :
 1 < 10; // = true
 1 > 10; // = false
 2 <= 2; // = true
@@ -108,7 +109,7 @@ false; // faux
 // Vous pouvez accéder les caractères dans une string avec charAt
 'This is a string'.charAt(0);  // = 'T'
 
-// .. ou utiliser substring pour avoir un plus gros morceau
+// ... ou utiliser substring pour avoir un plus gros morceau
 'Hello world'.substring(0, 5); // = 'Hello'
 
 // la longueur, length, est une propriété, donc n'utilisez pas de ()
@@ -164,7 +165,7 @@ myArray.length; // = 4
 myArray[3] = 'Hello';
 
 // Les objets JavaScript sont appelés 'dictionnaires' ou 'maps' dans certains autres
-// langages: ils sont une liste non-ordonnée de paires clé-valeur.
+// langages : ils sont une liste non-ordonnée de paires clé-valeur.
 var myObj = {key1: 'Hello', key2: 'World'};
 
 // Les clés sont des strings, mais les ' ou " sont optionels si elles sont des
@@ -187,8 +188,6 @@ myObj.myFourthKey; // = undefined
 ///////////////////////////////////
 // 3. Logique et structures de contrôle
 
-// La syntaxe de cette section est identique au Java.
-
 // Les si (if) fonctionnent comme vous vous y attendez.
 var count = 1;
 if (count === 3) {
@@ -287,12 +286,14 @@ if (true){
 }
 i; // = 5 - et non undefined comme vous pourriez vous y attendre
 
-// Cela a mené à un style comment de fonctions anonymes immédiatement exécutée;
+// Cela a mené à un style commun de fonctions anonymes immédiatement exécutée;
 // ou "immediately-executing anonymous functions"
 (function(){
     var temporary = 5;
     // Nous pouvons accéder au scope global en assignant à l'objet global,
-    // qui dans les navigateurs est "window". Il est différent dans Node.js.
+    // qui dans les navigateurs est "window". Il est différent dans Node.js,
+    // le scope global sera en fait local au module dans lequel vous 
+    // vous trouvez. http://nodejs.org/api/globals.html
     window.permanent = 10;
 })();
 // Cela permet de ne pas avoir de fuites de variables qui polluent
@@ -300,7 +301,7 @@ i; // = 5 - et non undefined comme vous pourriez vous y attendre
 temporary; // raises ReferenceError
 permanent; // = 10
 
-// Une des particularité les plus puissantes de Javascript est le système de 
+// Une des fonctionnalités les plus puissantes de Javascript est le système de 
 // closures. Si une fonction est définie dans une autre fonction, alors la 
 // fonction interne aura accès aux variables de la fonction parente, même si
 // celle-ci a déjà finie son exécution.
@@ -338,7 +339,7 @@ myObj = {
 };
 myObj.myFunc(); // = 'Hello world!'
 
-// LA valeur de "this" change de par l'endroit où la fonction est appelée, et 
+// La valeur de "this" change de par l'endroit où la fonction est appelée, et 
 // non de l'endroit où elle est définie. Donc elle ne fonctionnera pas si elle
 // est appelée hors du contexte l'objet.
 var myFunc = myObj.myFunc;
@@ -353,8 +354,9 @@ var myOtherFunc = function(){
 myObj.myOtherFunc = myOtherFunc;
 myObj.myOtherFunc(); // = 'HELLO WORLD!'
 
-// Nous pouvons aussi spécifier un contexte pour une fonction quand elle est 
-// appelée grâce à "call" ou "apply".
+// Le contexte correspond à la valeur de "this".
+// Nous pouvons aussi spécifier un contexte, forcer la valeur de "this, 
+// pour une fonction quand elle est appelée grâce à "call" ou "apply".
 var anotherFunc = function(s){
     return this.myString + s;
 }
@@ -368,8 +370,9 @@ Math.min(42, 6, 27); // = 6
 Math.min([42, 6, 27]); // = NaN (uh-oh!)
 Math.min.apply(Math, [42, 6, 27]); // = 6
 
-// Mais, "call" and "apply" sont temporaires. Pour lier le contexte de façon
-// permanente, nous pouvons utiliser "bind"
+// Mais, "call" and "apply" fonctionnenent uniquement au moment de l'appel de la 
+// fonction. Pour lier le contexte de façon permanente, nous pouvons utiliser 
+// "bind" pour garder une référence à la fonction avec ce "this".
 var boundFunc = anotherFunc.bind(myObj);
 boundFunc(' And Hello Saturn!'); // = 'Hello World! And Hello Saturn!'
 
@@ -389,11 +392,11 @@ myNewObj = new MyConstructor(); // = {myNumber: 5}
 myNewObj.myNumber; // = 5
 
 // Chaque objet en Javascript a un "prototype". Quand vous essayez d'accéder à
-// une propriété que n'a pas l'objet, l'interpréteur regarder son prototype.
+// une propriété que l'objet n'a pas, l'interpréteur va regarder son prototype.
 
-// Quelque implémentations de JS vous laissent accéder au prototype avec la 
+// Quelques implémentations de JS vous laissent accéder au prototype avec la 
 // propriété "magique" __proto__. Ceci peut être utile, mais n'est pas standard 
-// et ne fonctionne pas dans les navigateurs actuels.
+// et ne fonctionne pas dans certains des navigateurs actuels.
 var myObj = {
     myString: 'Hello world!'
 };
@@ -413,12 +416,21 @@ myPrototype.__proto__ = {
 };
 myObj.myBoolean; // = true
 
+
+// Pour obtenir le prototype il existe également Object.getPrototypeOf
+Object.getPrototypeOf( myObj ) // = {meaningOfLife: 42, myFunc: function}
+
 // Il n'y a pas de copie ici. Chacun des objets stocke une référence à son
 // prototype. Cela veut dire que l'on peut le modifier et cela se répercutera
 // partout.
 myPrototype.meaningOfLife = 43;
 myObj.meaningOfLife; // = 43
 
+// L'inverse n'est cependant pas vrai. Changer la propriété d'un objet ne change
+// pas la chaine prototypale.
+myObj.lonelyProperty = true;
+myPrototype.lonelyProperty; // = undefined
+
 // Comme précédemment dit, __proto__ n'est pas standard et ne devrait pas être
 // utilisé. Il y a deux autres moyen de créer un nouvel objet avec un prototype
 // donné.
-- 
cgit v1.2.3


From 210d9eba8df66ac7298d4bdea386428fe1a1009f Mon Sep 17 00:00:00 2001
From: Nicolas Brugneaux <nicolas.brugneaux@gmail.com>
Date: Wed, 20 Aug 2014 19:13:53 +0200
Subject: better example.

---
 fr-fr/javascript-fr.html.markdown | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/fr-fr/javascript-fr.html.markdown b/fr-fr/javascript-fr.html.markdown
index 21c8b5ae..dd12d89f 100644
--- a/fr-fr/javascript-fr.html.markdown
+++ b/fr-fr/javascript-fr.html.markdown
@@ -428,8 +428,8 @@ myObj.meaningOfLife; // = 43
 
 // L'inverse n'est cependant pas vrai. Changer la propriété d'un objet ne change
 // pas la chaine prototypale.
-myObj.lonelyProperty = true;
-myPrototype.lonelyProperty; // = undefined
+myObj.meaningOfLife = 42;
+myPrototype.meaningOfLife; // = 43
 
 // Comme précédemment dit, __proto__ n'est pas standard et ne devrait pas être
 // utilisé. Il y a deux autres moyen de créer un nouvel objet avec un prototype
-- 
cgit v1.2.3


From ffd5e7e149cf1da87abce5e56cdf32626eede22a Mon Sep 17 00:00:00 2001
From: Nicolas Brugneaux <nicolas.brugneaux@gmail.com>
Date: Wed, 20 Aug 2014 19:39:19 +0200
Subject: Typo

---
 fr-fr/javascript-fr.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/fr-fr/javascript-fr.html.markdown b/fr-fr/javascript-fr.html.markdown
index dd12d89f..e15f70a3 100644
--- a/fr-fr/javascript-fr.html.markdown
+++ b/fr-fr/javascript-fr.html.markdown
@@ -9,7 +9,7 @@ translators:
 lang: fr-fr
 ---
 
-JavaScript a été crée par Brendan Eich, travaillant alors a Netscape, en 1995.
+JavaScript a été créé par Brendan Eich, travaillant alors a Netscape, en 1995.
 Le langage avait à l'origine pour but d'être un langage de scripting simple
 pour les sites web, complétant le Java (à ne pas confondre avec JavaScript)
 pour des applications web complexes. Mais son intégration très proche et 
-- 
cgit v1.2.3


From d15c9674a9005b544427c206424cc900bda48106 Mon Sep 17 00:00:00 2001
From: Nicolas Brugneaux <nicolas.brugneaux@gmail.com>
Date: Wed, 20 Aug 2014 20:57:40 +0200
Subject: Updated scope part.

---
 fr-fr/javascript-fr.html.markdown | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/fr-fr/javascript-fr.html.markdown b/fr-fr/javascript-fr.html.markdown
index e15f70a3..2e18d0be 100644
--- a/fr-fr/javascript-fr.html.markdown
+++ b/fr-fr/javascript-fr.html.markdown
@@ -135,8 +135,9 @@ var someVar = 5;
 // si vous oubliez le mot clé var, vous n'aurez pas d'erreur (sauf en mode strict)
 someOtherVar = 10;
 
-// ... mais la variable sera crée dans l’environnement global, et non l’environnement
-// local dans lequel vous l'avez défini.
+// ... mais la variable aura une portée globale (plus communément trouvé en tant 
+// que "global scope" en anglais), et non pas une portée limitée à la fonction 
+// dans laquelle vous l'aviez définie.
 
 // Les variables déclarées et non assignées sont undefined par défaut
 var someThirdVar;
@@ -279,8 +280,8 @@ setTimeout(function(){
     // ce code s'exécutera dans 5 secondes
 }, 5000);
 
-// Le Javascript crée uniquement un scope dans les fonctions, pas dans les 
-// autres blocs.
+// Le Javascript crée uniquement un scope, une portée d'action limitée, pour 
+// les fonctions, et pas dans les autres blocs.
 if (true){
     var i = 5;
 }
-- 
cgit v1.2.3


From 291f6f6b22acf7962a180e6e12234aebcb20c5bd Mon Sep 17 00:00:00 2001
From: Levi Bostian <levi.bostian@gmail.com>
Date: Fri, 5 Sep 2014 21:02:38 -0500
Subject: Fix "initialized" typo.

---
 go.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/go.html.markdown b/go.html.markdown
index 758c9ff4..b4c6afff 100644
--- a/go.html.markdown
+++ b/go.html.markdown
@@ -92,7 +92,7 @@ can include line breaks.` // Same string type.
 
 	// Arrays have size fixed at compile time.
 	var a4 [4]int           // An array of 4 ints, initialized to all 0.
-	a3 := [...]int{3, 1, 5} // An array initialzed with a fixed size of three
+	a3 := [...]int{3, 1, 5} // An array initialized with a fixed size of three
 	// elements, with values 3, 1, and 5.
 
 	// Slices have dynamic size. Arrays and slices each have advantages
-- 
cgit v1.2.3