Fixes mdo#59: Document lang attribute

mdo · mdo · commit ea3770d2dc98 · 2014-03-22T15:41:24.000-07:00
diff --git a/_includes/html/lang.html b/_includes/html/lang.html
@@ -0,0 +1,3 @@
+<html lang="en-us">
+  <!-- ... -->
+</html>
diff --git a/index.html b/index.html
@@ -12,6 +12,7 @@ <h4><a href="#html">HTML</a></h4>
     <ul>
       <li><a href="#html-syntax">Syntax</a></li>
       <li><a href="#html-doctype">HTML5 doctype</a></li>
+      <li><a href="#html-lang">Language attribute</a></li>
       <li><a href="#html-encoding">Character encoding</a></li>
       <li><a href="#html-style-script">CSS and JavaScript includes</a></li>
       <li><a href="#html-practicality">Practicality over purity</a></li>
@@ -84,6 +85,21 @@ <h3>HTML5 doctype</h3>
   </div>
 </div>
 
+<div class="section" id="html-lang">
+  <div class="col">
+    <h3>Language attribute</h3>
+    <p>From the HTML5 spec:</p>
+    <blockquote>
+      <p>Authors are encouraged to specify a lang attribute on the root html element, giving the document's language. This aids speech synthesis tools to determine what pronunciations to use, translation tools to determine what rules to use, and so forth.</p>
+    </blockquote>
+    <p>Read more about the <code>lang</code> attribute <a href="http://www.w3.org/html/wg/drafts/html/master/semantics.html#the-html-element">in the spec</a>.</p>
+    <p>Head to Sitepoint for a <a href="http://reference.sitepoint.com/html/lang-codes">list of language codes</a>.</p>
+  </div>
+  <div class="col">
+    {% highlight html %}{% include html/lang.html %}{% endhighlight %}
+  </div>
+</div>
+
 <div class="section" id="html-encoding">
   <div class="col">
     <h3>Character encoding</h3>

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+<html lang="en-us">`
	`2`	`+ <!-- ... -->`
	`3`	`+</html>`