From e70b0b3c3767e39e1e1fda310a979e8d6fb53dc9 Mon Sep 17 00:00:00 2001 From: m93a Date: Mon, 12 Aug 2013 15:08:02 +0200 Subject: [PATCH 1/6] Update html:meta, split html:link and html:a to html:alter, html:include, html:link and html:anch Closes #13 Closes #5 --- README.md | 89 +++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 74 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index db16ab9..cb44961 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ Now, without further adieu, let me introduce you to HTML6. ### Section 2 - The Concept -HTML6 is conceptually HTML with XML like namespaces. If you don't know XML, or don't know what XML namespaces are they're basically a way to allow you to use the same tag without it conflicting with a different tag. You've probably actually seen one before in the XHTML DOCTYPE: `xmlns:xhtml="http://www.w3.org/1999/xhtml"` +HTML6 is conceptually HTML with XML like namespaces. If you don't know XML, or don't know what XML namespaces are, they're basically a way to allow you to use the same tag without it conflicting with a different tag. You've probably actually seen one before in the XHTML DOCTYPE: `xmlns:xhtml="http://www.w3.org/1999/xhtml"` In HTML6 we take advantage of this ingenious concept by giving us freedom to use whatever tag we want by the W3C reserving namespaces and not tags. The W3C would basically reserve the right to all namespaces, and each namespace they reserve will trigger a different HTML API. @@ -136,8 +136,13 @@ _Example:_ This is a bit different then the current HTML version. Meta data in HTML6 can be anything. Unlike HTML now, there are no required or non-standard meta types. It's used to store content for you as a developer, or for other sites as a way to grab information such as a page description. -_Example:_ +_Normative:_ +This tag has to be a descendant of `html:head` and takes the following attributes: + +- `type`: What type of information is under `value`, eg. `author`, `description` or `generator`; there can be multiple types, separated by `,`. +- `value`: The information itself. +_Example:_ ```xml @@ -148,23 +153,50 @@ _Example:_ ``` -##### `` +##### `` -This links external documents and scripts such as CSS, JavaScript, RSS, favicons, etc. to the current document. Equivalent to the current `` tag. This tag takes the following attributes: +This links document's alternatives in other formats, eg. PDF, RTF, RSS or Atom feed. It's similar to the current HTML `link` tag. +_Normative:_ +This tag has to be a descendant of `html:head` and takes the following attributes: + +- `title`: The name of the alternative document. - `charset`: The character encoding such as "UTF-8". -- `href`: The link to the source file. -- `media`: The type of device the item should run on, for example, "mobile" or "tablet". +- `href`: The link to the source file, can be relative or absolute. +- `media`: The type of device the item should run on, eg. `mobile` or `tablet`. - `type`: The MIME type of the document, for example, `text/javascript`. -_Example:_ +_Example:_ +```xml + + + + HTML6 Spec Version 0.1 + + + +``` + +##### `` + +This links external files that should be included in the document such as HTML snippets, CSS templates of JS scripts. It's similar to the current HTML `link` tag. + +_Normative:_ +This tag takes the following attributes: + +- `rel`: The type of the document, eg. `stylesheet`, `script`, `snippet`, `favicon`. +- `charset`: The character encoding such as "UTF-8". +- `href`: The link to the source file, can be relative or absolute. +- `media`: The type of device the item should run on, for example, "mobile" or "tablet". +- `type`: The MIME type of the document, eg. `text/javascript`. +_Example:_ ```xml HTML6 Spec Version 0.1 - + ``` @@ -187,15 +219,40 @@ _Example:_ ``` -##### `` +##### `` -This tag represents either an anchor on the page, or a link to another web page. Equivalent to the current `` tag. The `` tag takes one required attribute which is the `href` which directs the anchor or link where to go. For an anchor you'd use the syntax `#id-of-element-to-link-to` and for a link to another web page you'd simply insert the link like `http://google.com`. +This tag represents a link to another web page. It's similar to the current `` tag. -Attributes available to the `` tag are: +_Normative:_ +Attributes available to this tag are: -- `href` -- `name` -- `target` (can be `blank`, `parent`, `top` or `self`) +- `href`: The link to the target document, can be relative or absolute. +- `target`: Which window will open the document (can be `blank`, `parent`, `top` or `self`, default is `self`). **This attribute is obsolete**. +- `newwindow`: Boolean attribute saying that link will be opened in a new window (equivalent to `target=blank`). + +_Example:_ + +```xml + + + + HTML6 Spec Version 0.1 + + + Go to google.com! + + +``` + +##### `` + +This tag represents an anchor on the page. It's similar to the current `` tag. + +_Normative:_ +Attributes available to this tag are: + +- `for`: Reference to a tag on the page using CSS selector. If selector matches multiple tags, browser should jump to the first of them and order the user to browse through them. +- `margin`: When the user clicks on the anchor, this attribute defines the space between the top of the tag and the edge of the browser's navigation bar. _Example:_ @@ -206,7 +263,9 @@ _Example:_ HTML6 Spec Version 0.1 - Go to google.com! +

This is a top of this page

+ This is a really long text about some really stupid things. + Go to the top of this page! ``` From 0d47a41af1f00cdb5d38b408989657cc465889ff Mon Sep 17 00:00:00 2001 From: m93a Date: Mon, 12 Aug 2013 17:42:43 +0200 Subject: [PATCH 2/6] Changing `html:include/@href` to `html:include/@src` - it's not a reference, it's path to the source. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cb44961..aa54560 100644 --- a/README.md +++ b/README.md @@ -186,7 +186,7 @@ This tag takes the following attributes: - `rel`: The type of the document, eg. `stylesheet`, `script`, `snippet`, `favicon`. - `charset`: The character encoding such as "UTF-8". -- `href`: The link to the source file, can be relative or absolute. +- `src`: The link to the source file, can be relative or absolute. - `media`: The type of device the item should run on, for example, "mobile" or "tablet". - `type`: The MIME type of the document, eg. `text/javascript`. From 9c7ea30cd7135a3990e78c0e3d8e1f10f571e23a Mon Sep 17 00:00:00 2001 From: m93a Date: Mon, 12 Aug 2013 19:47:51 +0200 Subject: [PATCH 3/6] Change image location to the current OscarGodson's HTML6.md --- README.md => _includes/HTML6.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename README.md => _includes/HTML6.md (99%) diff --git a/README.md b/_includes/HTML6.md similarity index 99% rename from README.md rename to _includes/HTML6.md index aa54560..9d7ced1 100644 --- a/README.md +++ b/_includes/HTML6.md @@ -1,6 +1,6 @@ # HTML6 -![HTML6](malay.jpg) +![HTML6](http://html6spec.com/malay.jpg) ## The Spec That Brings Us Freedom From d6711b00b8f857d99eebc389258145aca9147da8 Mon Sep 17 00:00:00 2001 From: m93a Date: Thu, 19 Sep 2013 19:38:48 +0200 Subject: [PATCH 4/6] Rollback to html:a (merge html:link and html:anch) As OscarGodson said: You could make this into it's own PR and ask people how they like it, but I don't see any benefit to this over just allowing a/link. In both cases it makes semantic sense. If we had a link element it'd mean link to this page, and this section. You'd also need links like http://someothersite.com/#foo to work anyway so making them totally different links seems confusing. --- _includes/HTML6.md | 38 ++++++++------------------------------ 1 file changed, 8 insertions(+), 30 deletions(-) diff --git a/_includes/HTML6.md b/_includes/HTML6.md index 9d7ced1..543dd47 100644 --- a/_includes/HTML6.md +++ b/_includes/HTML6.md @@ -219,14 +219,15 @@ _Example:_ ``` -##### `` +##### `` -This tag represents a link to another web page. It's similar to the current `` tag. +This tag represents a link to another web page or an anchor. It's similar to the current `` tag. _Normative:_ Attributes available to this tag are: -- `href`: The link to the target document, can be relative or absolute. +- `href`: The link to the target document (can be relative or absolute) or a hashtag and element id (like this: `#some-foo-element`). +- `for`: CSS selector for when you need to make an anchor to an element with no id (always links to the first match). - `target`: Which window will open the document (can be `blank`, `parent`, `top` or `self`, default is `self`). **This attribute is obsolete**. - `newwindow`: Boolean attribute saying that link will be opened in a new window (equivalent to `target=blank`). @@ -239,33 +240,10 @@ _Example:_ HTML6 Spec Version 0.1 - Go to google.com! - - -``` - -##### `` - -This tag represents an anchor on the page. It's similar to the current `` tag. - -_Normative:_ -Attributes available to this tag are: - -- `for`: Reference to a tag on the page using CSS selector. If selector matches multiple tags, browser should jump to the first of them and order the user to browse through them. -- `margin`: When the user clicks on the anchor, this attribute defines the space between the top of the tag and the edge of the browser's navigation bar. - -_Example:_ - -```xml - - - - HTML6 Spec Version 0.1 - - -

This is a top of this page

- This is a really long text about some really stupid things. - Go to the top of this page! +

MyPage

+ Go to google.com! + Back to the top + Back to the top alternative ``` From 5e444319fef3f03d24aa7e5ff897f455ab0ca137 Mon Sep 17 00:00:00 2001 From: m93a Date: Wed, 9 Oct 2013 16:14:26 +0200 Subject: [PATCH 5/6] Correcting a misspell. --- _includes/HTML6.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_includes/HTML6.md b/_includes/HTML6.md index 543dd47..e7bc82f 100644 --- a/_includes/HTML6.md +++ b/_includes/HTML6.md @@ -179,7 +179,7 @@ _Example:_ ##### `` -This links external files that should be included in the document such as HTML snippets, CSS templates of JS scripts. It's similar to the current HTML `link` tag. +This links external files that should be included in the document such as HTML snippets, CSS templates or JS scripts. It's similar to the current HTML `link` tag. _Normative:_ This tag takes the following attributes: From f9e838e398c53b5884bf950142c792b2fbd30e80 Mon Sep 17 00:00:00 2001 From: m93a Date: Sat, 15 Feb 2014 21:25:35 +0100 Subject: [PATCH 6/6] fixed @risenomore True story :) --- _includes/HTML6.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_includes/HTML6.md b/_includes/HTML6.md index e7bc82f..0aa7400 100644 --- a/_includes/HTML6.md +++ b/_includes/HTML6.md @@ -104,7 +104,7 @@ _Example:_ ``` ##### `` -This begins an HTML's head. Equivelent to the current `` tag. The tag contains data that isn't actually displayed (aside from the `` which is displayed in the browser's windows). Rather, it's purpose is to get data and scripts that affect the display of the content in the ``. These scripts and other sources include things like JavaScript, CSS, RSS feeds, etc. +This begins an HTML's head. Equivelent to the current `` tag. The tag contains data that isn't actually displayed (aside from the `` which is displayed in the browser's windows). Rather, it's purpose is to get data and scripts that affect the display of the content in the ``. These scripts and other sources include things like JavaScript, CSS, RSS feeds, etc. _Example:_