mirror of
https://github.com/h5bp/html5-boilerplate.git
synced 2026-01-07 22:04:06 -05:00
Remove normalize.css and Optimize head tag order. (#3034)
This commit is contained in:
J Rob Gant
38
.github/CONTRIBUTING.md
vendored
38
.github/CONTRIBUTING.md
vendored
@@ -25,11 +25,6 @@ restrictions:
|
||||
- Please **do not** derail or troll issues. Keep the discussion on topic and
|
||||
respect the opinions of others.
|
||||
|
||||
- Please **do not** open issues or pull requests regarding the code in
|
||||
[`.htaccess`](https://github.com/h5bp/server-configs-apache),
|
||||
[`Normalize.css`](https://github.com/necolas/normalize.css) (open them in
|
||||
their respective repositories).
|
||||
|
||||
<a name="bugs"></a>
|
||||
|
||||
## Bug reports
|
||||
@@ -126,25 +121,50 @@ included in the project:
|
||||
git checkout -b <topic-branch-name>
|
||||
```
|
||||
|
||||
4. Commit your changes in logical chunks. Please adhere to these [git commit
|
||||
4. Install locked dependencies:
|
||||
|
||||
```bash
|
||||
npm ci
|
||||
```
|
||||
|
||||
Ensure that your `node` and `npm` versions are compatible with the `engines`
|
||||
specification in `package.json`.
|
||||
|
||||
5. Commit your changes in logical chunks. Please adhere to these [git commit
|
||||
message guidelines](https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html)
|
||||
or your code is unlikely be merged into the main project. Use Git's
|
||||
[interactive rebase](https://help.github.com/articles/about-git-rebase/)
|
||||
feature to tidy up your commits before making them public.
|
||||
|
||||
5. Locally merge (or rebase) the upstream development branch into your topic branch:
|
||||
6. Locally merge (or rebase) the upstream development branch into your topic branch:
|
||||
|
||||
```bash
|
||||
git pull [--rebase] upstream main
|
||||
```
|
||||
|
||||
6. Push your topic branch up to your fork:
|
||||
7. Update any applicable test cases and run tests:
|
||||
|
||||
```bash
|
||||
npm run test
|
||||
```
|
||||
|
||||
Tests must cover changes and pass to be accepted.
|
||||
|
||||
8. Run build and commit changes to dist:
|
||||
|
||||
```bash
|
||||
npm run build
|
||||
git add dist/
|
||||
git commit
|
||||
```
|
||||
|
||||
9. Push your topic branch up to your fork:
|
||||
|
||||
```bash
|
||||
git push origin <topic-branch-name>
|
||||
```
|
||||
|
||||
7. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
|
||||
10. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/)
|
||||
with a clear title and description.
|
||||
|
||||
**IMPORTANT**: By submitting a patch, you agree to allow the project
|
||||
|
||||
7
.github/SUPPORT.md
vendored
7
.github/SUPPORT.md
vendored
@@ -1,8 +1,5 @@
|
||||
# Support
|
||||
|
||||
For personal support requests with HTML5 Boilerplate please use Stack Overflow
|
||||
([`html5boilerplate`](https://stackoverflow.com/questions/tagged/html5boilerplate) tag).
|
||||
|
||||
Please check the respective repository/website for support regarding the code in
|
||||
[`.htaccess`](https://github.com/h5bp/server-configs-apache),
|
||||
[`Normalize.css`](https://github.com/necolas/normalize.css).
|
||||
([`html5boilerplate`](https://stackoverflow.com/questions/tagged/html5boilerplate)
|
||||
tag).
|
||||
|
||||
8
dist/index.html
vendored
8
dist/index.html
vendored
@@ -3,9 +3,10 @@
|
||||
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title></title>
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title></title>
|
||||
<link rel="stylesheet" href="css/style.css">
|
||||
<meta name="description" content="">
|
||||
|
||||
<meta property="og:title" content="">
|
||||
<meta property="og:type" content="">
|
||||
@@ -16,9 +17,6 @@
|
||||
<link rel="icon" href="/icon.svg" type="image/svg+xml">
|
||||
<link rel="apple-touch-icon" href="icon.png">
|
||||
|
||||
<link rel="stylesheet" href="css/normalize.css">
|
||||
<link rel="stylesheet" href="css/style.css">
|
||||
|
||||
<link rel="manifest" href="site.webmanifest">
|
||||
<meta name="theme-color" content="#fafafa">
|
||||
</head>
|
||||
|
||||
26
docs/css.md
26
docs/css.md
@@ -5,30 +5,11 @@ table of contents](TOC.md)
|
||||
|
||||
HTML5 Boilerplate's CSS includes:
|
||||
|
||||
- [Normalize.css](#normalizecss)
|
||||
- [style.css](#stylecss)
|
||||
|
||||
## Normalize.css
|
||||
|
||||
In order to make browsers render all elements more consistently and in line with
|
||||
modern standards, we include Normalize.css — a modern, HTML5-ready alternative
|
||||
to CSS resets.
|
||||
|
||||
As opposed to CSS resets, Normalize.css:
|
||||
|
||||
- targets only the styles that need normalizing
|
||||
- preserves useful browser defaults rather than erasing them
|
||||
- corrects bugs and common browser inconsistencies
|
||||
- improves usability with subtle improvements
|
||||
- doesn't clutter the debugging tools
|
||||
- has better documentation
|
||||
|
||||
For more information about Normalize.css, please refer to its [project
|
||||
page](https://necolas.github.io/normalize.css/).
|
||||
|
||||
## style.css
|
||||
|
||||
Several base styles are included that build upon `Normalize.css`. These styles:
|
||||
Several base styles are included. These styles:
|
||||
|
||||
- provide basic typography settings that improve text readability
|
||||
- protect against unwanted `text-shadow` during text highlighting
|
||||
@@ -38,7 +19,4 @@ Several base styles are included that build upon `Normalize.css`. These styles:
|
||||
- and more...
|
||||
|
||||
These styles are included in
|
||||
[style.css](https://github.com/h5bp/html5-boilerplate/blob/main/dist/css/style.css)
|
||||
using [main.css](https://github.com/h5bp/main.css) project.
|
||||
See the main.css [documentation](https://github.com/h5bp/main.css/blob/main/README.md#features)
|
||||
for a full discussion of these styles.
|
||||
[style.css](https://github.com/h5bp/html5-boilerplate/blob/main/dist/css/style.css).
|
||||
|
||||
@@ -30,7 +30,6 @@ A basic HTML5 Boilerplate site initially looks something like this:
|
||||
```
|
||||
.
|
||||
├── css
|
||||
│ ├── normalize.css
|
||||
│ └── style.css
|
||||
├── doc
|
||||
├── img
|
||||
|
||||
@@ -39,7 +39,8 @@
|
||||
"strip-json-comments": "^5.0.1"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=14"
|
||||
"node": ">=16",
|
||||
"npm": ">=8"
|
||||
},
|
||||
"h5bp-configs": {
|
||||
"directories": {
|
||||
|
||||
@@ -3,9 +3,10 @@
|
||||
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<title></title>
|
||||
<meta name="description" content="">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title></title>
|
||||
<link rel="stylesheet" href="css/style.css">
|
||||
<meta name="description" content="">
|
||||
|
||||
<meta property="og:title" content="">
|
||||
<meta property="og:type" content="">
|
||||
@@ -16,9 +17,6 @@
|
||||
<link rel="icon" href="/icon.svg" type="image/svg+xml">
|
||||
<link rel="apple-touch-icon" href="icon.png">
|
||||
|
||||
<link rel="stylesheet" href="css/normalize.css">
|
||||
<link rel="stylesheet" href="css/style.css">
|
||||
|
||||
<link rel="manifest" href="site.webmanifest">
|
||||
<meta name="theme-color" content="#fafafa">
|
||||
</head>
|
||||
|
||||
Reference in New Issue
Block a user