- From: Lachlan Hunt via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 29 Jan 2009 15:54:14 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-author
In directory hutz:/tmp/cvs-serv19083
Modified Files:
Overview.html Overview.src.html
Log Message:
Started filling out Getting Started section, Added examples directory for associated markup examples
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/html-author/Overview.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- Overview.html 29 Jan 2009 14:50:10 -0000 1.21
+++ Overview.html 29 Jan 2009 15:54:11 -0000 1.22
@@ -59,6 +59,7 @@
in depth information for more advanced web developers.</p>
</section>
+<!-- Status -->
<section>
<h2 class="no-num no-toc" id=status>Status of this document</h2>
<p><em>This section describes the status of this document at the time of its
@@ -94,15 +95,17 @@
<a href=http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure>section 6 of the W3C Patent Policy</a>.</p>
</section>
+<!-- Table of Contents -->
<section>
<h2 class="no-num no-toc" id=contents>Table of contents</h2>
<!--begin-toc-->
<ol class=toc>
<li><a href=#introduction><span class=secno>1 </span>Introduction</a></li>
- <li><a href=#introductory-tutorial><span class=secno>2 </span>Introductory Tutorial</a>
+ <li><a href=#getting-started-with-html-5><span class=secno>2 </span>Getting Started with HTML 5</a>
<ol class=toc>
- <li><a href=#understanding-semantics><span class=secno>2.1 </span>Understanding Semantics</a></li></ol></li>
+ <li><a href=#a-basic-document><span class=secno>2.1 </span>A Basic Document</a></li>
+ <li><a href=#understanding-semantics><span class=secno>2.2 </span>Understanding Semantics</a></li></ol></li>
<li><a href=#the-html-and-xhtml-syntax><span class=secno>3 </span>The HTML and XHTML Syntax</a>
<ol class=toc>
<li><a href=#html><span class=secno>3.1 </span>HTML</a></li></ol></li>
@@ -120,6 +123,7 @@
<!--end-toc-->
</section>
+<!-- Introduction -->
<section>
<h2 id=introduction><span class=secno>1 </span>Introduction</h2>
@@ -153,8 +157,9 @@
designed to be used for a range of different use cases.</p>
</section>
+<!-- Tutorial -->
<section>
- <h2 id=introductory-tutorial><span class=secno>2 </span>Introductory Tutorial</h2>
+ <h2 id=getting-started-with-html-5><span class=secno>2 </span>Getting Started with HTML 5</h2>
<p>The most common format for publishing documents on the web and creating
web applications is HTML. From its beginning as a relatively simple
@@ -165,20 +170,31 @@
<p>As the uses of HTML have grown, the demands placed upon it by authors
have increased and the limitations of HTML become more pronounced.
- HTML 5 is attempting to fill these limitations with new features designed
- specifically the address the needs of authors.</p>
+ HTML 5 is represents the next major step in the development of HTML,
+ introducing a wide range of new features into the language. Authors who
+ are familiar with previous versions of HTML are advised to familiarise
+ themselves with <a href=http://www.w3.org/TR/html5-diff/>the
+ differences from HTML 4</a> [HTML4DIFF]</p>
- <p>However, the way the HTML5 specification is written is very much targeted
- towards implementers rather than web designers and developers, making it
- more difficult to read and understand. This document is intended to meet
- the needs of web developers by focussing on document conformance criteria
- and authoring guidelines.</p>
+ <p>This section provides an introductory tutorial to help get you started
+ with HTML, and is suitable for beginners. Experienced authors may choose
+ to skip this section and proceed to the syntax overview and the element
+ reference.</p>
- <p>Authors who are familiar with previous versions of HTML are advised to
- familiarise themselves with <a href=http://www.w3.org/TR/html5-diff/>the differences from HTML 4</a> [HTML4DIFF]</p>
+ <section>
+ <h3 id=a-basic-document><span class=secno>2.1 </span>A Basic Document</h3>
+
+ <p>To begin, we're going to create a very basic HTML document, which
+ will also serve as a useful template for future HTML documents. All
+ HTML documents need to begin with a DOCTYPE.</p>
+
+ <div class="html example">
+ <pre><!DOCTYPE html></pre>
+ </div>
+ </section>
<section>
- <h3 id=understanding-semantics><span class=secno>2.1 </span>Understanding Semantics</h3>
+ <h3 id=understanding-semantics><span class=secno>2.2 </span>Understanding Semantics</h3>
<p>In general, the purpose of writing and publishing a document is to convey
information to the readers. This could be any kind of information, such
@@ -190,9 +206,10 @@
is often grouped into different sections containing a variety of
headings, paragraphs, lists, tables, quotes and various other
typographical structures. All of these structures are important for more
- easily conveying information to the reader and thus authors need a way to
+ easily conveying information to the reader. HTML provides the means to
clearly identify each of these structures in a way that can then be
- easily presented to the user. This is the purpose of markup.</p>
+ easily presented to the user. In essence, this is the purpose of
+ markup, and HTML in particular.</p>
<p>Markup is a machine readable language that describes aspects of a
document such as its structure, semantics and/or style. Some markup
Index: Overview.src.html
===================================================================
RCS file: /sources/public/html5/html-author/Overview.src.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -d -r1.23 -r1.24
--- Overview.src.html 29 Jan 2009 14:50:10 -0000 1.23
+++ Overview.src.html 29 Jan 2009 15:54:12 -0000 1.24
@@ -61,6 +61,7 @@
in depth information for more advanced web developers.</p>
</section>
+<!-- Status -->
<section>
<h1 class="no-num no-toc" id="status">Status of this document</h1>
<p><em>This section describes the status of this document at the time of its
@@ -96,11 +97,13 @@
<a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the W3C Patent Policy</a>.</p>
</section>
+<!-- Table of Contents -->
<section>
<h1 class="no-num no-toc" id="contents">Table of contents</h1>
<!--toc-->
</section>
+<!-- Introduction -->
<section>
<h1>Introduction</h1>
@@ -134,8 +137,9 @@
designed to be used for a range of different use cases.</p>
</section>
+<!-- Tutorial -->
<section>
- <h1>Introductory Tutorial</h1>
+ <h1>Getting Started with HTML 5</h1>
<p>The most common format for publishing documents on the web and creating
web applications is HTML. From its beginning as a relatively simple
@@ -146,17 +150,39 @@
<p>As the uses of HTML have grown, the demands placed upon it by authors
have increased and the limitations of HTML become more pronounced.
- HTML 5 is attempting to fill these limitations with new features designed
- specifically the address the needs of authors.</p>
+ HTML 5 is represents the next major step in the development of HTML,
+ introducing a wide range of new features into the language. Authors who
+ are familiar with previous versions of HTML are advised to familiarise
+ themselves with <a href="http://www.w3.org/TR/html5-diff/">the
+ differences from HTML 4</a> [HTML4DIFF]</p>
- <p>However, the way the HTML5 specification is written is very much targeted
- towards implementers rather than web designers and developers, making it
- more difficult to read and understand. This document is intended to meet
- the needs of web developers by focussing on document conformance criteria
- and authoring guidelines.</p>
+ <p>This section provides an introductory tutorial to help get you started
+ with HTML, and is suitable for beginners. Experienced authors may choose
+ to skip this section and proceed to the syntax overview and the element
+ reference.</p>
- <p>Authors who are familiar with previous versions of HTML are advised to
- familiarise themselves with <a href="http://www.w3.org/TR/html5-diff/">the differences from HTML 4</a> [HTML4DIFF]</p>
+ <section>
+ <h1>A Basic Document</h1>
+
+ <p>To begin, we're going to create a very basic HTML document, which
+ will also serve as a useful template for future HTML documents. Open
+ a text editor and create a new, empty file. I suggest you save the
+ file as <kbd>example01.html</kbd>.</p>
+
+ <p>All HTML documents need to begin with a DOCTYPE. In your text editor,
+ type the following on the first line, and save the file.</p>
+
+ <div class="html example">
+ <pre><!DOCTYPE html></pre>
+ </div>
+
+ <p>It's good practice to get in the habit of always typing that as the
+ first line in all new HTML documents you create. This line is used
+ to indicate that the document is an HTML 5 document</p>
+
+ <p></p>
+
+ </section>
<section>
<h1>Understanding Semantics</h1>
@@ -171,9 +197,10 @@
is often grouped into different sections containing a variety of
headings, paragraphs, lists, tables, quotes and various other
typographical structures. All of these structures are important for more
- easily conveying information to the reader and thus authors need a way to
+ easily conveying information to the reader. HTML provides the means to
clearly identify each of these structures in a way that can then be
- easily presented to the user. This is the purpose of markup.</p>
+ easily presented to the user. In essence, this is the purpose of
+ markup, and HTML in particular.</p>
<p>Markup is a machine readable language that describes aspects of a
document such as its structure, semantics and/or style. Some markup
Received on Thursday, 29 January 2009 15:54:26 UTC