https://github.com/davidgilbertson/html-styleguide

https://github.com/davidgilbertson/html-styleguide

Last synced: 13 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/davidgilbertson/html-styleguide
• Owner: davidgilbertson
• Created: 2015-04-13T04:39:34.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2015-04-21T03:12:38.000Z (over 9 years ago)
• Last Synced: 2023-08-04T17:21:31.901Z (over 1 year ago)
• Language: HTML
• Size: 156 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# HTML Styleguide

## Some General Guidelines

 - Each `` and `` start their own header scope, so the top level heading within each will be an `
`.

 - `` tags are for major sections of page content. If in doubt, use a `
`

 - There is no need for `` tags if they only contain a single element (e.g. `
`)

 - Do not use HTML elements for their style (e.g. don't use an `
` tag because it is the size you want).

 - Use the [HTML Outline Chrome extension](https://chrome.google.com/webstore/detail/html5-outliner/afoibpobokebhgfnknfndkgemglggomo?utm_source=chrome-ntp-icon) to ensure that the page is well structured.

 - If something isn't covered in this guide, check out the source for [bbc.com](http://www.bbc.com), [The Guardian](http://www.theguardian.com/au) or the [Boston Globe](http://www.bostonglobe.com). They all have decent site structure.


## Single Article

See the [article.html](article.html) file for a sample structure.

 - A page with a single article should have a single `` tag as the root of the article.

 - If the article itself has structure, define this through the use of header tags. 

## List of Articles

See the [article-list.html](article-list.html) file for a sample structure.

 - A page with a list of articles could be a homepage, tag page, search results page, etc. The page may or may not be broken into sub-sections.

 - Each article should be wrapped in an `` tag with its own `
`.