Skip to content

Commit

Permalink
Enforcing 80 char linelength
Browse files Browse the repository at this point in the history
  • Loading branch information
Kyle Mendes committed Oct 28, 2018
1 parent 598fc6d commit f7242c2
Showing 1 changed file with 83 additions and 28 deletions.
111 changes: 83 additions & 28 deletions html.html.markdown
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,33 +7,51 @@ translators:
- ["Robert Steed", "https://github.com/robochat"]
---

HTML stands for HyperText Markup Language.
HTML stands for HyperText Markup Language.

It is a language which allows us to write pages for the world wide web.
It is a markup language, it enables us to write webpages using code to indicate how text and data should be displayed.
In fact, html files are simple text files.
What is this markup? It is a method of organising the page's data by surrounding it with opening tags and closing tags.
This markup serves to give significance to the text that it encloses.
Like other computer languages, HTML has many versions. Here we will talk about HTML5.
It is a markup language, it enables us to write webpages using code to indicate
how text and data should be displayed. In fact, html files are simple text
files.

What is this markup? It is a method of organising the page's data by
surrounding it with opening tags and closing tags. This markup serves to give
significance to the text that it encloses. Like other computer languages, HTML
has many versions. Here we will talk about HTML5.

**NOTE :** You can test the different tags and elements as you progress through the tutorial on a site like [codepen](http://codepen.io/pen/) in order to see their effects, understand how they work and familiarise yourself with the language.
This article is concerned principally with HTML syntax and some useful tips.
**NOTE :** You can test the different tags and elements as you progress through
the tutorial on a site like [codepen](http://codepen.io/pen/) in order to see
their effects, understand how they work and familiarise yourself with the
language. This article is concerned principally with HTML syntax and some
useful tips.


```html
<!-- Comments are enclosed like this line! -->

<!--
Comments
can
span
multiple
lines!
-->

<!-- #################### The Tags #################### -->

<!-- Here is an example HTML file that we are going to analyse. -->


<!doctype html>
<html>
<head>
<title>My Site</title>
</head>
<body>
<h1>Hello, world!</h1>
<a href = "http://codepen.io/anon/pen/xwjLbZ">Come look at what this shows</a>
<a href="http://codepen.io/anon/pen/xwjLbZ">
Come look at what this shows
</a>
<p>This is a paragraph.</p>
<p>This is another paragraph.</p>
<ul>
Expand All @@ -44,7 +62,9 @@ This article is concerned principally with HTML syntax and some useful tips.
</body>
</html>

<!-- An HTML file always starts by indicating to the browser that the page is HTML. -->
<!--
An HTML file always starts by indicating to the browser that the page is HTML.
-->
<!doctype html>

<!-- After this, it starts by opening an <html> tag. -->
Expand All @@ -58,24 +78,46 @@ This article is concerned principally with HTML syntax and some useful tips.
<!-- Inside (between the opening and closing tags <html></html>), we find: -->

<!-- A header defined by <head> (it must be closed with </head>). -->
<!-- The header contains some description and additional information which are not displayed; this is metadata. -->
<!--
The header contains some description and additional information which are not
displayed; this is metadata.
-->

<head>
<title>My Site</title><!-- The tag <title> indicates to the browser the title to show in browser window's title bar and tab name. -->
<!--
The tag <title> indicates to the browser the title to show in browser
window's title bar and tab name.
-->
<title>My Site</title>
</head>

<!-- After the <head> section, we find the tag - <body> -->
<!-- Until this point, nothing described will show up in the browser window. -->
<!-- We must fill the body with the content to be displayed. -->

<body>
<h1>Hello, world!</h1> <!-- The h1 tag creates a title. -->
<!-- There are also subtitles to <h1> from the most important (h2) to the most precise (h6). -->
<a href = "http://codepen.io/anon/pen/xwjLbZ">Come look at what this shows</a> <!-- a hyperlink to the url given by the attribute href="" -->
<p>This is a paragraph.</p> <!-- The tag <p> lets us include text in the html page. -->
<!-- The h1 tag creates a title. -->
<h1>Hello, world!</h1>
<!--
There are also subtitles to <h1> from the most important (h2) to the most
precise (h6).
-->

<!-- a hyperlink to the url given by the attribute href="" -->
<a href="http://codepen.io/anon/pen/xwjLbZ">
Come look at what this shows
</a>

<!-- The tag <p> lets us include text in the html page. -->
<p>This is a paragraph.</p>
<p>This is another paragraph.</p>
<ul> <!-- The tag <ul> creates a bullet list. -->
<!-- To have a numbered list instead we would use <ol> giving 1. for the first element, 2. for the second, etc. -->

<!-- The tag <ul> creates a bullet list. -->
<!--
To have a numbered list instead we would use <ol> giving 1. for the first
element, 2. for the second, etc.
-->
<ul>
<li>This is an item in a non-enumerated list (bullet list)</li>
<li>This is another item</li>
<li>And this is the last item on the list</li>
Expand All @@ -86,21 +128,33 @@ This article is concerned principally with HTML syntax and some useful tips.

<!-- But it is possible to add many additional types of HTML tags. -->

<!-- To insert an image. -->
<img src="http://i.imgur.com/XWG0O.gif"/> <!-- The source of the image is indicated using the attribute src="" -->
<!-- The source can be an URL or even path to a file on your computer. -->
<!-- The <img /> tag is used to insert an image. -->
<!--
The source of the image is indicated using the attribute src=""
The source can be an URL or even path to a file on your computer.
-->
<img src="http://i.imgur.com/XWG0O.gif"/>

<!-- It is also possible to create a table. -->

<table> <!-- We open a <table> element. -->
<tr> <!-- <tr> allows us to create a row. -->
<th>First Header</th> <!-- <th> allows us to give a title to a table column. -->
<!-- We open a <table> element. -->
<table>

<!-- <tr> allows us to create a row. -->
<tr>

<!-- <th> allows us to give a title to a table column. -->
<th>First Header</th>
<th>Second Header</th>
</tr>

<tr>
<td>first row, first column</td> <!-- <td> allows us to create a table cell. -->

<!-- <td> allows us to create a table cell. -->
<td>first row, first column</td>
<td>first row, second column</td>
</tr>

<tr>
<td>second row, first column</td>
<td>second row, second column</td>
Expand All @@ -111,9 +165,10 @@ This article is concerned principally with HTML syntax and some useful tips.

## Usage

HTML is written in files ending with `.html` or `.htm`. The mime type is `text/html`.
HTML is written in files ending with `.html` or `.htm`. The mime type is
`text/html`.

## To Learn More
## To Learn More

* [wikipedia](https://en.wikipedia.org/wiki/HTML)
* [HTML tutorial](https://developer.mozilla.org/en-US/docs/Web/HTML)
Expand Down

0 comments on commit f7242c2

Please sign in to comment.