Enforcing 80 char linelength

This commit is contained in:
Kyle Mendes 2018-10-28 12:15:17 -05:00
parent 598fc6d0a6
commit f7242c2e6c

View File

@ -7,25 +7,41 @@ translators:
- ["Robert Steed", "https://github.com/robochat"] - ["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.
**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. It is a language which allows us to write pages for the world wide web.
This article is concerned principally with HTML syntax and some useful tips. 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.
```html ```html
<!-- Comments are enclosed like this line! --> <!-- Comments are enclosed like this line! -->
<!--
Comments
can
span
multiple
lines!
-->
<!-- #################### The Tags #################### --> <!-- #################### The Tags #################### -->
<!-- Here is an example HTML file that we are going to analyse. --> <!-- Here is an example HTML file that we are going to analyse. -->
<!doctype html> <!doctype html>
<html> <html>
<head> <head>
@ -33,7 +49,9 @@ This article is concerned principally with HTML syntax and some useful tips.
</head> </head>
<body> <body>
<h1>Hello, world!</h1> <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 a paragraph.</p>
<p>This is another paragraph.</p> <p>This is another paragraph.</p>
<ul> <ul>
@ -44,7 +62,9 @@ This article is concerned principally with HTML syntax and some useful tips.
</body> </body>
</html> </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> <!doctype html>
<!-- After this, it starts by opening an <html> tag. --> <!-- After this, it starts by opening an <html> tag. -->
@ -58,10 +78,17 @@ This article is concerned principally with HTML syntax and some useful tips.
<!-- Inside (between the opening and closing tags <html></html>), we find: --> <!-- Inside (between the opening and closing tags <html></html>), we find: -->
<!-- A header defined by <head> (it must be closed with </head>). --> <!-- 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> <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> </head>
<!-- After the <head> section, we find the tag - <body> --> <!-- After the <head> section, we find the tag - <body> -->
@ -69,13 +96,28 @@ This article is concerned principally with HTML syntax and some useful tips.
<!-- We must fill the body with the content to be displayed. --> <!-- We must fill the body with the content to be displayed. -->
<body> <body>
<h1>Hello, world!</h1> <!-- The h1 tag creates a title. --> <!-- The h1 tag creates a title. -->
<!-- There are also subtitles to <h1> from the most important (h2) to the most precise (h6). --> <h1>Hello, world!</h1>
<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. --> 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> <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 an item in a non-enumerated list (bullet list)</li>
<li>This is another item</li> <li>This is another item</li>
<li>And this is the last item on the list</li> <li>And this is the last item on the list</li>
@ -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. --> <!-- But it is possible to add many additional types of HTML tags. -->
<!-- To insert an image. --> <!-- The <img /> tag is used 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 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. --> <!-- It is also possible to create a table. -->
<table> <!-- We open a <table> element. --> <!-- We open a <table> element. -->
<tr> <!-- <tr> allows us to create a row. --> <table>
<th>First Header</th> <!-- <th> allows us to give a title to a table column. -->
<!-- <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> <th>Second Header</th>
</tr> </tr>
<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> <td>first row, second column</td>
</tr> </tr>
<tr> <tr>
<td>second row, first column</td> <td>second row, first column</td>
<td>second row, second column</td> <td>second row, second column</td>
@ -111,9 +165,10 @@ This article is concerned principally with HTML syntax and some useful tips.
## Usage ## 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) * [wikipedia](https://en.wikipedia.org/wiki/HTML)
* [HTML tutorial](https://developer.mozilla.org/en-US/docs/Web/HTML) * [HTML tutorial](https://developer.mozilla.org/en-US/docs/Web/HTML)