chore(deps-dev): bump js-yaml from 4.1.0 to 4.1.1 (#3328)

Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 4.1.0 to 4.1.1.
- [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md)
- [Commits](https://github.com/nodeca/js-yaml/compare/4.1.0...4.1.1)

---
updated-dependencies:
- dependency-name: js-yaml
  dependency-version: 4.1.1
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.cspell.json

@@ -0,0 +1,20 @@
+{
+  "version": "0.2",
+  "words": [
+    "codeql",
+    "devdeps",
+    "FOUC",
+    "lighttpd",
+    "mkdir",
+    "modernizr",
+    "robotstxt",
+    "vuejs",
+    "cpina"
+  ],
+  "language": "en,en-GB,en-US",
+  "allowCompoundWords": true,
+  "files": ["**/*.md"],
+  "ignoreRegExpList": ["\\_\\w+", "\\#\\w+"],
+  "ignorePaths": [".cspell.json"],
+  "useGitignore": true
+}

.eslintrc.js

@@ -1,17 +0,0 @@
-module.exports = {
-  env: {
-    browser: true,
-    es6: true,
-    mocha: true
-  },
-  plugins: ["mocha"],
-  extends: "eslint:recommended",
-  parserOptions: {
-    sourceType: "module"
-  },
-  rules: {
-    indent: ["error", 2],
-    quotes: ["error", "single"],
-    semi: ["error", "always"]
-  }
-};

.gitattributes

@@ -16,13 +16,8 @@
 *.js    text eol=lf
 *.json  text eol=lf
 *.md    text eol=lf
+*.mjs   text eol=lf
 *.sh    text eol=lf
 *.txt   text eol=lf
 *.xml   text eol=lf
-
-# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-# Exclude the `.htaccess` file from GitHub's language statistics
-# https://github.com/github/linguist#using-gitattributes
-
-dist/.htaccess linguist-vendored
+*.yml   text eol=lf

.github/CODE_OF_CONDUCT.md

@@ -8,19 +8,19 @@ In the interest of fostering an open and welcoming environment, we as contributo
 
 Examples of behavior that contributes to creating a positive environment include:
 
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
 
 Examples of unacceptable behavior by participants include:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a professional setting
+- The use of sexualized language or imagery and unwelcome sexual attention or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
 
 ## Our Responsibilities
 

.github/CONTRIBUTING.md

@@ -12,7 +12,6 @@ the developers managing and developing this open source project. In return,
 they should reciprocate that respect in addressing your issue or assessing
 patches and features.
 
-
 ## Using the issue tracker
 
 The [issue tracker](https://github.com/h5bp/html5-boilerplate/issues) is
@@ -20,21 +19,14 @@ the preferred channel for [bug reports](#bugs), [features requests](#features)
 and [submitting pull requests](#pull-requests), but please respect the following
 restrictions:
 
-* Please **do not** use the issue tracker for personal support requests (use
+- Please **do not** use the issue tracker for personal support requests (use
   [Stack Overflow](https://stackoverflow.com/questions/tagged/html5boilerplate)).
 
-* Please **do not** derail or troll issues. Keep the discussion on topic and
+- 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),
-  [`jQuery`](https://github.com/jquery/jquery/),
-  [`Modernizr`](https://github.com/Modernizr/Modernizr) or
-  [`Normalize.css`](https://github.com/necolas/normalize.css) (open them in
-  their respective repositories).
-
-
 <a name="bugs"></a>
+
 ## Bug reports
 
 A bug is a _demonstrable problem_ that is caused by the code in the repository.
@@ -46,7 +38,7 @@ Guidelines for bug reports:
    reported.
 
 2. **Check if the issue has been fixed** &mdash; try to reproduce it using the
-   latest `master` or development branch in the repository.
+   latest `main` or development branch in the repository.
 
 3. **Isolate the problem** &mdash; ideally create a [reduced test
    case](https://css-tricks.com/reduced-test-cases/) and a live example.
@@ -75,17 +67,17 @@ Example:
 > causing the bug, and potential solutions (and your opinions on their
 > merits).
 
-
 <a name="features"></a>
+
 ## Feature requests
 
 Feature requests are welcome. But take a moment to find out whether your idea
-fits with the scope and aims of the project. It's up to *you* to make a strong
+fits with the scope and aims of the project. It's up to _you_ to make a strong
 case to convince the project's developers of the merits of this feature. Please
 provide as much detail and context as possible.
 
-
 <a name="pull-requests"></a>
+
 ## Pull requests
 
 Good pull requests - patches, improvements, new features - are a fantastic
@@ -118,8 +110,8 @@ included in the project:
 2. If you cloned a while ago, get the latest changes from upstream:
 
    ```bash
-   git checkout master
-   git pull upstream master
+   git checkout main
+   git pull upstream main
    ```
 
 3. Create a new topic branch (off the main project development branch) to
@@ -129,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 master
+   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

.github/ISSUE_TEMPLATE.md

@@ -1,74 +0,0 @@
-**I'm submitting a ...**
-<!-- (check one with "x") -->
-- [ ] bug report
-- [ ] feature request
-- [ ] other (Please do not submit support requests here (below))
-
-## Notes:
-
-* Please **do not** use the issue tracker for personal support requests (use
-  [Stack Overflow](https://stackoverflow.com/questions/tagged/html5boilerplate)).
-
-* 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),
-  [`jQuery`](https://github.com/jquery/jquery/),
-  [`Modernizr`](https://github.com/Modernizr/Modernizr) or
-  [`Normalize.css`](https://github.com/necolas/normalize.css) (open them in
-  their respective repositories).
-
-## Bug reports
-
-A bug is a _demonstrable problem_ that is caused by the code in the repository.
-Good bug reports are extremely helpful - thank you!
-
-Guidelines for bug reports:
-
-1. **Use the GitHub issue search** &mdash; check if the issue has already been
-   reported.
-
-   We have a long history of sometimes _very_ detailed discussion of every line of code
-   in the project. We want discussion, so it might still warrant an issue. It
-   just helps to get the (sometimes extensive) context.
-
-2. **Check if the issue has been fixed** &mdash; try to reproduce it using the
-   latest `master` or development branch in the repository.
-
-3. **Isolate the problem** &mdash; ideally create a [reduced test
-   case](https://css-tricks.com/reduced-test-cases/) and a live example.
-
-A good bug report shouldn't leave others needing to chase you up for more
-information. Please try to be as detailed as possible in your report. What is
-your environment? What steps will reproduce the issue? What browser(s) and OS
-experience the problem? What would you expect to be the outcome? All these
-details will help people to fix any potential bugs.
-
-Example:
-
-> Short and descriptive example bug report title
->
-> A summary of the issue and the browser/OS environment in which it occurs. If
-> suitable, include the steps required to reproduce the bug.
->
-> 1. This is the first step
-> 2. This is the second step
-> 3. Further steps, etc.
->
-> `<url>` - a link to the reduced test case
->
-> Any other information you want to share that is relevant to the issue being
-> reported. This might include the lines of code that you have identified as
-> causing the bug, and potential solutions (and your opinions on their
-> merits).
-
-
-## Feature requests
-
-Feature requests are welcome. But take a moment to find out whether your idea
-fits with the scope and aims of the project. It's up to *you* to make a strong
-case to convince the project's developers of the merits of this feature. Please
-provide as much detail and context as possible.
-
-

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,61 @@
+name: Report a bug
+description: Tell us about a bug or issue you may have identified in HTML5 Boilerplate.
+title: "Provide a general summary of the issue"
+labels: [bug]
+assignees: "-"
+body:
+  - type: checkboxes
+    attributes:
+      label: Prerequisites
+      description: Take a couple minutes to help our maintainers work faster.
+      options:
+        - label: I have [searched](https://github.com/h5bp/html5-boilerplate/issues?utf8=%E2%9C%93&q=is%3Aissue) for duplicate or closed issues
+          required: true
+        - label: I have read the [contributing guidelines](https://github.com/h5bp/html5-boilerplate/blob/main/.github/CONTRIBUTING.md)
+          required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: Describe the issue
+      description: Provide a summary of the issue and what you expected to happen, including specific steps to reproduce.
+    validations:
+      required: true
+  - type: textarea
+    id: reduced-test-case
+    attributes:
+      label: Reduced test cases
+      description: Include links [reduced test case](https://css-tricks.com/reduced-test-cases/) links.
+    validations:
+      required: false
+  - type: dropdown
+    id: os
+    attributes:
+      label: What operating system(s) are you seeing the problem on?
+      multiple: true
+      options:
+        - Windows
+        - macOS
+        - Android
+        - iOS
+        - Linux
+    validations:
+      required: true
+  - type: dropdown
+    id: browser
+    attributes:
+      label: What browser(s) are you seeing the problem on?
+      multiple: true
+      options:
+        - Chrome
+        - Safari
+        - Firefox
+        - Microsoft Edge
+        - Opera
+        - Development Environment
+  - type: input
+    id: version
+    attributes:
+      label: What version of HTML% Boilerplate are you using?
+      placeholder: "e.g., v8.0.0 or v7.1.0"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Ask the community
+    url: https://github.com/h5bp/html5-boilerplate/discussions/new
+    about: Ask and discuss questions with other HTML5 Boilerplate community members.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,29 @@
+name: Feature request
+description: Suggest new or updated features to include in HTML5 Boilerplate.
+title: "Suggest a new feature"
+labels: [feature]
+assignees: []
+body:
+  - type: checkboxes
+    attributes:
+      label: Prerequisites
+      description: Take a couple minutes to help our maintainers work faster.
+      options:
+        - label: I have [searched](https://github.com/h5bp/html5-boilerplate/issues?utf8=%E2%9C%93&q=is%3Aissue) for duplicate or closed issues
+          required: true
+        - label: I have read the [contributing guidelines](https://github.com/h5bp/html5-boilerplate/blob/main/.github/CONTRIBUTING.md)
+          required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: Provide detailed information for what we should add, including relevant links to prior art, screenshots, or live demos whenever possible.
+    validations:
+      required: true
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation and context
+      description: Tell us why this change is needed or helpful, and what problems it may help solve.
+    validations:
+      required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,16 +1,20 @@
 ## Types of changes
+
 <!--- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
+
 - [ ] Bug fix (non-breaking change which fixes an issue)
 - [ ] New feature (non-breaking change which adds functionality)
 - [ ] Breaking change (fix or feature that would cause existing functionality to change)
 
 ## Checklist:
+
 <!--- Go over all the following points, and put an `x` in all the boxes that apply. -->
 <!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! -->
+
 - [ ] My code follows the code style of this project.
 - [ ] My change requires a change to the documentation.
 - [ ] I have updated the documentation accordingly.
-- [ ] I have read the **CONTRIBUTING** document.
+- [ ] I have read the **[CONTRIBUTING](https://github.com/h5bp/html5-boilerplate/blob/main/.github/CONTRIBUTING.md)** document.
 - [ ] I have added tests to cover my changes.
 - [ ] All new and existing tests passed.
 

.github/SUPPORT.md

@@ -1,10 +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),
-  [`jQuery`](https://jquery.org/support/),
-  [`Modernizr`](https://modernizr.com/) or
-  [`Normalize.css`](https://github.com/necolas/normalize.css).
+([`html5boilerplate`](https://stackoverflow.com/questions/tagged/html5boilerplate)
+tag).

.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: "/"
+    schedule:
+      interval: monthly
+    versioning-strategy: increase
+  - package-ecosystem: npm
+    directory: "/src/"
+    schedule:
+      interval: monthly
+    versioning-strategy: increase
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: monthly

.github/workflows/build-dist.yml

@@ -0,0 +1,47 @@
+name: Build and PR dist changes
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  build-and-pr-dist:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        with:
+          node-version: "lts/*"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+
+      - name: Check for dist changes
+        id: git-diff
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git add dist
+          if git diff --cached --quiet; then
+            echo "changed=false" >> $GITHUB_OUTPUT
+          else
+            echo "changed=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create Pull Request for dist changes
+        if: steps.git-diff.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          commit-message: "chore(dist): update dist folder after build"
+          title: "chore(dist): update dist folder after build"
+          body: "This PR updates the dist folder with the latest build output."
+          branch: update-dist-after-build
+          add-paths: dist

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,36 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches:
+      - main
+      - "!dependabot/**"
+  pull_request:
+    branches:
+      - main
+      - "!dependabot/**"
+  workflow_dispatch:
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@3599b3baa15b485a2e49ef411a7a4bb2452e7f93 # v3.30.5
+        with:
+          languages: "javascript"
+          queries: +security-and-quality
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@3599b3baa15b485a2e49ef411a7a4bb2452e7f93 # v3.30.5

.github/workflows/dependency-review.yml

@@ -0,0 +1,17 @@
+name: "Dependency Review"
+on: [pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Checkout Repository"
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: "Dependency Review"
+        uses: actions/dependency-review-action@595b5aeba73380359d98a5e087f648dbb0edce1b # v4.7.3

.github/workflows/ossf-scorecard.yml

@@ -0,0 +1,43 @@
+name: Scorecard supply-chain security
+on:
+  branch_protection_rule:
+  schedule:
+    - cron: '27 12 * * 2'
+  push:
+    branches: [ "main" ]
+
+permissions: read-all
+
+jobs:
+  analysis:
+    name: Scorecard analysis
+    runs-on: ubuntu-latest
+    if: github.event.repository.default_branch == github.ref_name || github.event_name == 'pull_request'
+    permissions:
+      security-events: write
+      id-token: write
+
+    steps:
+      - name: "Checkout code"
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: "Run analysis"
+        uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3
+        with:
+          results_file: results.sarif
+          results_format: sarif
+          publish_results: true
+
+      - name: "Upload artifact"
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: SARIF file
+          path: results.sarif
+          retention-days: 5
+
+      - name: "Upload to code-scanning"
+        uses: github/codeql-action/upload-sarif@3599b3baa15b485a2e49ef411a7a4bb2452e7f93 # v3.30.5
+        with:
+          sarif_file: results.sarif

.github/workflows/publish.yml

@@ -1,26 +1,33 @@
-name: publish
+name: Publish
 
 on:
   push:
     tags:
-    - 'v*'
+      - "v*"
+
+permissions:
+  contents: read
 
 jobs:
   build:
+    permissions:
+      contents: write # for actions/create-release to create a release
     name: Upload Release Asset
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
       - name: Get tag
         id: get_version
-        run: echo ::set-output name=VERSION::$(echo $GITHUB_REF | cut -d / -f 3)
-      - name: Create Zip Folder  
+        run: echo VERSION=$(echo $GITHUB_REF | cut -d / -f 3) >> "$GITHUB_OUTPUT"
+      - name: Create Zip Folder
         working-directory: dist
-        run: zip -r ../html5-boilerplate_${{ steps.get_version.outputs.VERSION }}.zip ./ 
+        run: zip -r ../html5-boilerplate_${{ steps.get_version.outputs.VERSION }}.zip ./
       - name: Create Release
         id: create_release
-        uses: actions/create-release@v1
+        uses: actions/create-release@0cb9c9b65d5d1901c1f53e5e66eaf4afd303e70e # v1.1.4
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
@@ -29,8 +36,8 @@ jobs:
           draft: false
           prerelease: false
       - name: Upload Release Asset
-        id: upload-release-asset 
-        uses: actions/upload-release-asset@v1
+        id: upload-release-asset
+        uses: actions/upload-release-asset@e8f9f06c4b078e705bd2ea027f0926603fc9b4d5 # v1.0.2
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
@@ -39,9 +46,9 @@ jobs:
           asset_name: html5-boilerplate_${{ steps.get_version.outputs.VERSION }}.zip
           asset_content_type: application/zip
       - name: Setup Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
         with:
-          node-version: 12
+          node-version: 20
           registry-url: https://registry.npmjs.org/
       - name: publish npm
         run: npm publish

.github/workflows/push-to-template.yml

@@ -0,0 +1,45 @@
+name: Push to template repository
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Get npm cache directory
+        id: npm-cache
+        run: |
+          echo "dir=$(npm config get cache)" >> "$GITHUB_OUTPUT"
+      - uses: actions/cache@v3
+        with:
+          path: ${{ steps.npm-cache.outputs.dir }}
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+      - name: Setup Node.js
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        with:
+          node-version: "lts/*"
+      - name: Install dependencies
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Pushes to another repository
+        uses: cpina/github-action-push-to-another-repository@main
+        env:
+          API_TOKEN_GITHUB: ${{ secrets.API_TOKEN_GITHUB }}
+        with:
+          source-directory: "dist"
+          destination-github-username: "h5bp"
+          destination-repository-name: "html5-boilerplate-template"
+          user-name: "roblarsen"
+          user-email: rob@htmlcssjavascript.com
+          commit-message: "The latest and greatest from HTML5 Boilerplate"

.github/workflows/spellcheck.yml

@@ -0,0 +1,23 @@
+name: "Check spelling"
+on: # rebuild any PRs and main branch changes
+  push:
+    branches-ignore:
+      - "dependabot/**"
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  spellcheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - uses: streetsidesoftware/cspell-action@dcd03dc3e8a59ec2e360d0c62db517baa0b4bb6d # v7.2.0
+        with:
+          inline: warning
+          strict: false
+          incremental_files_only: true

.github/workflows/test.yml

@@ -0,0 +1,41 @@
+name: Build status
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        node-version:
+          - 20
+          - 22
+          - 24
+        os: [ubuntu-latest, windows-latest]
+
+    steps:
+      - name: Get npm cache directory
+        id: npm-cache
+        run: |
+          echo "dir=$(npm config get cache)" >> "$GITHUB_OUTPUT"
+      - uses: actions/cache@2f8e54208210a422b2efd51efaa6bd6d7ca8920f # v3.4.3
+        with:
+          path: ${{ steps.npm-cache.outputs.dir }}
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+      - name: Run tests ${{ matrix.node-version }}
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm ci
+      - run: npm test

.gitignore

@@ -1,2 +1,6 @@
+**/.DS_Store
 archive
 node_modules
+packages
+dist/package-lock.json
+src/package-lock.json

.npmrc

@@ -0,0 +1,2 @@
+lockfile-version = 3
+registry = "https://registry.npmjs.org/"

.prettierignore

@@ -0,0 +1 @@
+dist/

.prettierrc.json

@@ -0,0 +1,13 @@
+{
+  "bracketSameLine": true,
+  "embeddedLanguageFormatting": "off",
+  "singleQuote": true,
+  "overrides": [
+    {
+      "files": "**/*.yml",
+      "options": {
+        "singleQuote": false
+      }
+    }
+  ]
+}

.travis.yml

@@ -1,14 +0,0 @@
-# For more information about the configurations used
-# in this file, please see the Travis CI documentation:
-# https://docs.travis-ci.com
-
-git:
-  depth: 10
-
-language: node_js
-
-node_js:
-  - 10
-
-dist: trusty
-sudo: false

.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "editorconfig.editorconfig",
+    "esbenp.prettier-vscode",
+    "streetsidesoftware.code-spell-checker"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "[javascript][typescript][json][jsonc][markdown][yaml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true
+  },
+  "[javascript][typescript]": {
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": "explicit"
+    }
+  },
+  "eslint.validate": ["javascript", "typescript"],
+  "editor.formatOnSave": true,
+  "editor.renderWhitespace": "all",
+  "files.trimTrailingWhitespace": true
+}

CHANGELOG.md

@@ -1,374 +1,403 @@
 # Changelog
 
+## 9.0.1 (April 11, 2024)
+
+- Fixed tests on Windows, adds Windows Testing Action [#3110](https://github.com/h5bp/html5-boilerplate/pull/3110)
+- Add og:image:alt for accessibility [#3066](https://github.com/h5bp/html5-boilerplate/pull/3066)
+- Upgrade to Gulp 5 [#3100](https://github.com/h5bp/html5-boilerplate/pull/3100) [#3105](https://github.com/h5bp/html5-boilerplate/pull/3105)
+- ci: Use GITHUB_OUTPUT envvar instead of set-output command [#3068](https://github.com/h5bp/html5-boilerplate/pull/3068)
+- Readme and Changelog updates [#3055](https://github.com/h5bp/html5-boilerplate/pull/3055) [#3057](https://github.com/h5bp/html5-boilerplate/pull/3057) [#3064](https://github.com/h5bp/html5-boilerplate/pull/3064)
+
+## 9.0.0 (December 6, 2023)
+
+- Removing tile images [#3023](https://github.com/h5bp/html5-boilerplate/pull/3023)
+- Add Prettier [#3011](https://github.com/h5bp/html5-boilerplate/pull/3011)
+- Remove Modernizr [#3002](https://github.com/h5bp/html5-boilerplate/issues/3002)
+- Drop Normalize.css [#2960](https://github.com/h5bp/html5-boilerplate/pull/2960)
+- Create WebPack build to ship with the project [#2650](https://github.com/h5bp/html5-boilerplate/issues/2650)
+- Sets package to private by default [#2888](https://github.com/h5bp/html5-boilerplate/pull/2888)
+- Removes Babel and upgrades our gulpfile to use ES Modules [#2831](https://github.com/h5bp/html5-boilerplate/pull/2831)
+- Farewell Internet Explorer! [#2773](https://github.com/h5bp/html5-boilerplate/issues/2773)
+- Remove apache-server-configs/.htaccess [#2779](https://github.com/h5bp/html5-boilerplate/pull/2779)
+- Moving docs out of src and dist [#2655](https://github.com/h5bp/html5-boilerplate/pull/2655)
+- Replace Parcel with Webpack [#2641](https://github.com/h5bp/html5-boilerplate/pull/2641)
+- Add SVG Favicon [#2554](https://github.com/h5bp/html5-boilerplate/issues/2554)
+- Remove Google Analytics [#2547](https://github.com/h5bp/html5-boilerplate/issues/2547)
+- Rename master branch to main [#2583](https://github.com/h5bp/html5-boilerplate/issues/2583)
+- Remove humans.txt [#2584](https://github.com/h5bp/html5-boilerplate/pull/2584)
+- Add a template repository [#2391](https://github.com/h5bp/html5-boilerplate/pull/2391)
+- Remove plugins js [#2346](https://github.com/h5bp/html5-boilerplate/pull/2346)
+- Rename CSS file [#2342](https://github.com/h5bp/html5-boilerplate/pull/2342) and JS file [#2341](https://github.com/h5bp/html5-boilerplate/pull/2341)
+
 ## 8.0.0 (June 04, 2020)
 
-* Add a sample package.json with basic Parcel commands ([#2227](https://github.com/h5bp/html5-boilerplate/pull/2229)), ([231e047](https://github.com/h5bp/html5-boilerplate/commit/231e047d270316b454156dc261e6e04da660e2a2))
-* Add sample Open Graph metadata ([#2235](https://github.com/h5bp/html5-boilerplate/pull/2235))
-* Update Modernizr to 3.11.2 ([84ae9cc](https://github.com/h5bp/html5-boilerplate/commit/84ae9cc91188bea4edb8ec91e2a25a2a7f7837a6))
-* Remove jQuery ([#2225](https://github.com/h5bp/html5-boilerplate/pull/2225))
-* Set anonymizeIp to true in Google Analytics snippet ([#2219](https://github.com/h5bp/html5-boilerplate/pull/2219))
-* Update main.css to 2.1.0 ([#2234](https://github.com/h5bp/html5-boilerplate/pull/2234))
-* Remove Browser Upgrade Prompt ([23c4112](https://github.com/h5bp/html5-boilerplate/commit/23c4112db067262c715ebad861ec892c29c3cdaa))
-* Create new publish action ([#2260](https://github.com/h5bp/html5-boilerplate/pull/2260)), ([#2241](https://github.com/h5bp/html5-boilerplate/pull/2241))
-* Docs updates ([#2251](https://github.com/h5bp/html5-boilerplate/pull/2251)), ([#2253](https://github.com/h5bp/html5-boilerplate/pull/2253)), ([#2245](https://github.com/h5bp/html5-boilerplate/pull/2245)), ([#2220](https://github.com/h5bp/html5-boilerplate/pull/2220)), ([#2263](https://github.com/h5bp/html5-boilerplate/pull/2263)), ([#2262](https://github.com/h5bp/html5-boilerplate/pull/2262))
+- Add a sample package.json with basic Parcel commands ([#2227](https://github.com/h5bp/html5-boilerplate/pull/2229)), ([231e047](https://github.com/h5bp/html5-boilerplate/commit/231e047d270316b454156dc261e6e04da660e2a2))
+- Add sample Open Graph metadata ([#2235](https://github.com/h5bp/html5-boilerplate/pull/2235))
+- Update Modernizr to 3.11.2 ([84ae9cc](https://github.com/h5bp/html5-boilerplate/commit/84ae9cc91188bea4edb8ec91e2a25a2a7f7837a6))
+- Remove jQuery ([#2225](https://github.com/h5bp/html5-boilerplate/pull/2225))
+- Set anonymizeIp to true in Google Analytics snippet ([#2219](https://github.com/h5bp/html5-boilerplate/pull/2219))
+- Update main.css to 2.1.0 ([#2234](https://github.com/h5bp/html5-boilerplate/pull/2234))
+- Remove Browser Upgrade Prompt ([23c4112](https://github.com/h5bp/html5-boilerplate/commit/23c4112db067262c715ebad861ec892c29c3cdaa))
+- Create new publish action ([#2260](https://github.com/h5bp/html5-boilerplate/pull/2260)), ([#2241](https://github.com/h5bp/html5-boilerplate/pull/2241))
+- Docs updates ([#2251](https://github.com/h5bp/html5-boilerplate/pull/2251)), ([#2253](https://github.com/h5bp/html5-boilerplate/pull/2253)), ([#2245](https://github.com/h5bp/html5-boilerplate/pull/2245)), ([#2220](https://github.com/h5bp/html5-boilerplate/pull/2220)), ([#2263](https://github.com/h5bp/html5-boilerplate/pull/2263)), ([#2262](https://github.com/h5bp/html5-boilerplate/pull/2262))
 
 ## 7.3.0 (November 19, 2019)
 
-* Update Modernizr to 3.8 ([2b2bb45](https://github.com/h5bp/html5-boilerplate/commit/2b2bb453916b4b09a6f0929340290dc2505f7ce9))
-* Update to Gulp 4 ([#2151](https://github.com/h5bp/html5-boilerplate/pull/2151))
-* Update package.json ([#2162](https://github.com/h5bp/html5-boilerplate/pull/#2162)) and enable package-lock.json ([abe2087](https://github.com/h5bp/html5-boilerplate/commit/abe20877fdb569c84aa0a1f8ae12c51c51e41250)),([#2145](https://github.com/h5bp/html5-boilerplate/pull/#2145))
-* Remove redundant rules from .editorconfig ([#2157](https://github.com/h5bp/html5-boilerplate/pull/2157))
-* Small docs maintenance updates ([#2155](https://github.com/h5bp/html5-boilerplate/pull/2155)), ([#2164](https://github.com/h5bp/html5-boilerplate/pull/2164)), ([#2165](https://github.com/h5bp/html5-boilerplate/pull/2165)), ([#2167](https://github.com/h5bp/html5-boilerplate/pull/2167)) & ([#2168](https://github.com/h5bp/html5-boilerplate/pull/2168))
-* Bump lowest supported version of node to 8.x ([#2142](https://github.com/h5bp/html5-boilerplate/pull/2142))
-* Remove .jscsrc config and remove gulp-jscs from package.json ([#2153](https://github.com/h5bp/html5-boilerplate/pull/2153))
+- Update Modernizr to 3.8 ([2b2bb45](https://github.com/h5bp/html5-boilerplate/commit/2b2bb453916b4b09a6f0929340290dc2505f7ce9))
+- Update to Gulp 4 ([#2151](https://github.com/h5bp/html5-boilerplate/pull/2151))
+- Update package.json ([#2162](https://github.com/h5bp/html5-boilerplate/pull/#2162)) and enable package-lock.json ([abe2087](https://github.com/h5bp/html5-boilerplate/commit/abe20877fdb569c84aa0a1f8ae12c51c51e41250)),([#2145](https://github.com/h5bp/html5-boilerplate/pull/#2145))
+- Remove redundant rules from .editorconfig ([#2157](https://github.com/h5bp/html5-boilerplate/pull/2157))
+- Small docs maintenance updates ([#2155](https://github.com/h5bp/html5-boilerplate/pull/2155)), ([#2164](https://github.com/h5bp/html5-boilerplate/pull/2164)), ([#2165](https://github.com/h5bp/html5-boilerplate/pull/2165)), ([#2167](https://github.com/h5bp/html5-boilerplate/pull/2167)) & ([#2168](https://github.com/h5bp/html5-boilerplate/pull/2168))
+- Bump lowest supported version of node to 8.x ([#2142](https://github.com/h5bp/html5-boilerplate/pull/2142))
+- Remove .jscsrc config and remove gulp-jscs from package.json ([#2153](https://github.com/h5bp/html5-boilerplate/pull/2153))
 
 ## 7.2.0 (June 4, 2019)
 
-* Remove `defer` from Google Analytics snippet ([#2132](https://github.com/h5bp/html5-boilerplate/pull/2132))
-* Update jQuery to v3.4.1 ([#2126](https://github.com/h5bp/html5-boilerplate/pull/2126))
-* Update Apache Server Configs to 3.2.1 ([#2128](https://github.com/h5bp/html5-boilerplate/pull/2128))
-* Update main.css to v2.0.0 ([#2135](https://github.com/h5bp/html5-boilerplate/pull/2135))
-* Docs updates ([#2122](https://github.com/h5bp/html5-boilerplate/pull/2122)), ([#2125](https://github.com/h5bp/html5-boilerplate/pull/2125)), ([#2134](https://github.com/h5bp/html5-boilerplate/pull/2134)), ([#2137](https://github.com/h5bp/html5-boilerplate/pull/2137)), ([#2138](https://github.com/h5bp/html5-boilerplate/pull/2138))
+- Remove `defer` from Google Analytics snippet ([#2132](https://github.com/h5bp/html5-boilerplate/pull/2132))
+- Update jQuery to v3.4.1 ([#2126](https://github.com/h5bp/html5-boilerplate/pull/2126))
+- Update Apache Server Configs to 3.2.1 ([#2128](https://github.com/h5bp/html5-boilerplate/pull/2128))
+- Update main.css to v2.0.0 ([#2135](https://github.com/h5bp/html5-boilerplate/pull/2135))
+- Docs updates ([#2122](https://github.com/h5bp/html5-boilerplate/pull/2122)), ([#2125](https://github.com/h5bp/html5-boilerplate/pull/2125)), ([#2134](https://github.com/h5bp/html5-boilerplate/pull/2134)), ([#2137](https://github.com/h5bp/html5-boilerplate/pull/2137)), ([#2138](https://github.com/h5bp/html5-boilerplate/pull/2138))
 
 ## 7.1.0 (March 18, 2019)
 
-* Update Modernizr to 3.7.1 ([#2121](https://github.com/h5bp/html5-boilerplate/pull/2121))
-* Update Analytics docs and snippet ([#2118](https://github.com/h5bp/html5-boilerplate/pull/2118))
-* Minor docs updates ([#2115](https://github.com/h5bp/html5-boilerplate/pull/2115))
-* Minor devdeps updates ([#2114](https://github.com/h5bp/html5-boilerplate/pull/2114))
-* More succinct way of writing the IE conditional statement ([#2113](https://github.com/h5bp/html5-boilerplate/pull/2113))
+- Update Modernizr to 3.7.1 ([#2121](https://github.com/h5bp/html5-boilerplate/pull/2121))
+- Update Analytics docs and snippet ([#2118](https://github.com/h5bp/html5-boilerplate/pull/2118))
+- Minor docs updates ([#2115](https://github.com/h5bp/html5-boilerplate/pull/2115))
+- Minor devdeps updates ([#2114](https://github.com/h5bp/html5-boilerplate/pull/2114))
+- More succinct way of writing the IE conditional statement ([#2113](https://github.com/h5bp/html5-boilerplate/pull/2113))
 
 ## 7.0.1 (February 11, 2019)
 
-* Bumps main.css to current version ([#2112](https://github.com/h5bp/html5-boilerplate/pull/2112))
+- Bumps main.css to current version ([#2112](https://github.com/h5bp/html5-boilerplate/pull/2112))
 
 ## 7.0.0 (February 8, 2019)
 
-* Drop support for IE9/IE10 (usage of these versions is tiny and Microsoft officially ended support back in 2016. ([#2074](https://github.com/h5bp/html5-boilerplate/pull/2074))
-* Move the CSS to a separate repo ([#2066](https://github.com/h5bp/html5-boilerplate/pull/2066))
-* Add theme-color meta tag to index.html ([#2074](https://github.com/h5bp/html5-boilerplate/pull/2074))
-* Add 'install with yarn' steps to README ([#2063](https://github.com/h5bp/html5-boilerplate/pull/2063))
-* Improved Webmanifest ([#2060](https://github.com/h5bp/html5-boilerplate/pull/2060))
-* Upgrade Normalize to 8.0.1 ([#2104](https://github.com/h5bp/html5-boilerplate/pull/2104))
-* Update .htaccess ([#2110](https://github.com/h5bp/html5-boilerplate/pull/2110))
-* Remove instances of `shrink-to-fit=no` ([#2103](https://github.com/h5bp/html5-boilerplate/pull/2103))
-* Removes "display": "standalone" from manifest ([#2096](https://github.com/h5bp/html5-boilerplate/pull/2096))
-* Big Docs update - Fixed links, removed IE9/IE10 specific info, made touch icons section more concise, add details on security.txt and more tidying up ([#2074](https://github.com/h5bp/html5-boilerplate/pull/2031), [#2065](https://github.com/h5bp/html5-boilerplate/pull/2065), [#2062](https://github.com/h5bp/html5-boilerplate/pull/2062))
+- Drop support for IE9/IE10 (usage of these versions is tiny and Microsoft officially ended support back in 2016). ([#2074](https://github.com/h5bp/html5-boilerplate/pull/2074))
+- Move the CSS to a separate repo ([#2066](https://github.com/h5bp/html5-boilerplate/pull/2066))
+- Add theme-color meta tag to index.html ([#2074](https://github.com/h5bp/html5-boilerplate/pull/2074))
+- Add 'install with yarn' steps to README ([#2063](https://github.com/h5bp/html5-boilerplate/pull/2063))
+- Improved Webmanifest ([#2060](https://github.com/h5bp/html5-boilerplate/pull/2060))
+- Upgrade Normalize to 8.0.1 ([#2104](https://github.com/h5bp/html5-boilerplate/pull/2104))
+- Update .htaccess ([#2110](https://github.com/h5bp/html5-boilerplate/pull/2110))
+- Remove instances of `shrink-to-fit=no` ([#2103](https://github.com/h5bp/html5-boilerplate/pull/2103))
+- Removes "display": "standalone" from manifest ([#2096](https://github.com/h5bp/html5-boilerplate/pull/2096))
+- Big Docs update - Fixed links, removed IE9/IE10 specific info, made touch icons section more concise, add details on security.txt and more tidying up ([#2074](https://github.com/h5bp/html5-boilerplate/pull/2031), [#2065](https://github.com/h5bp/html5-boilerplate/pull/2065), [#2062](https://github.com/h5bp/html5-boilerplate/pull/2062))
 
 ## 6.1.0 (May 1, 2018)
 
-* [Update Apache Server Configs to `v3.0.0`.](https://github.com/h5bp/html5-boilerplate/pull/2042)
-* Migrate to eslint ([#2037](https://github.com/h5bp/html5-boilerplate/pull/2037))
-* Update to jQuery 3.3.1 ([#2018](https://github.com/h5bp/html5-boilerplate/pull/2018))
-* Update to Modernizr v3.6 and Normalize v8 ([#2028](https://github.com/h5bp/html5-boilerplate/pull/2028))
-* Update Dev Dependencies ([#2032](https://github.com/h5bp/html5-boilerplate/pull/2032)) ([#2017](https://github.com/h5bp/html5-boilerplate/pull/2017)) ([#2010](https://github.com/h5bp/html5-boilerplate/pull/2010)) ([#2009](https://github.com/h5bp/html5-boilerplate/pull/2009))
-* Replace 'node-sri' with 'ssri' ([#2031](https://github.com/h5bp/html5-boilerplate/pull/2031))
-* Add .babelrc and .prettierrc to .gitattributes ([#2030](https://github.com/h5bp/html5-boilerplate/pull/2030))
-* Update .htaccess ([#2003](https://github.com/h5bp/html5-boilerplate/pull/2003))
-* Fixed JSHint errors ([#1994](https://github.com/h5bp/html5-boilerplate/pull/1994))
-* Add CODE_OF_CONDUCT.md ([#2011](https://github.com/h5bp/html5-boilerplate/pull/2011))
-* Update Documentation ([#2029](https://github.com/h5bp/html5-boilerplate/pull/2029)) ([#2015](https://github.com/h5bp/html5-boilerplate/pull/2015)) ([#2007](https://github.com/h5bp/html5-boilerplate/pull/2007)) ([#2006](https://github.com/h5bp/html5-boilerplate/pull/2006)) ([#1996](https://github.com/h5bp/html5-boilerplate/pull/1996))
+- [Update Apache Server Configs to `v3.0.0`.](https://github.com/h5bp/html5-boilerplate/pull/2042)
+- Migrate to eslint ([#2037](https://github.com/h5bp/html5-boilerplate/pull/2037))
+- Update to jQuery 3.3.1 ([#2018](https://github.com/h5bp/html5-boilerplate/pull/2018))
+- Update to Modernizr v3.6 and Normalize v8 ([#2028](https://github.com/h5bp/html5-boilerplate/pull/2028))
+- Update Dev Dependencies ([#2032](https://github.com/h5bp/html5-boilerplate/pull/2032)) ([#2017](https://github.com/h5bp/html5-boilerplate/pull/2017)) ([#2010](https://github.com/h5bp/html5-boilerplate/pull/2010)) ([#2009](https://github.com/h5bp/html5-boilerplate/pull/2009))
+- Replace 'node-sri' with 'ssri' ([#2031](https://github.com/h5bp/html5-boilerplate/pull/2031))
+- Add .babelrc and .prettierrc to .gitattributes ([#2030](https://github.com/h5bp/html5-boilerplate/pull/2030))
+- Update .htaccess ([#2003](https://github.com/h5bp/html5-boilerplate/pull/2003))
+- Fixed JSHint errors ([#1994](https://github.com/h5bp/html5-boilerplate/pull/1994))
+- Add CODE_OF_CONDUCT.md ([#2011](https://github.com/h5bp/html5-boilerplate/pull/2011))
+- Update Documentation ([#2029](https://github.com/h5bp/html5-boilerplate/pull/2029)) ([#2015](https://github.com/h5bp/html5-boilerplate/pull/2015)) ([#2007](https://github.com/h5bp/html5-boilerplate/pull/2007)) ([#2006](https://github.com/h5bp/html5-boilerplate/pull/2006)) ([#1996](https://github.com/h5bp/html5-boilerplate/pull/1996))
 
 ## 6.0.1 (August 20, 2017)
 
-* Reverts .visuallyhidden (see [#1985](https://github.com/h5bp/html5-boilerplate/issues/1985))
+- Reverts .visuallyhidden (see [#1985](https://github.com/h5bp/html5-boilerplate/issues/1985))
 
 ## 6.0.0 (August 17, 2017)
 
-* Fix Bug: .visuallyhidden on macOS VO fixes #1985 ([#1989](https://github.com/h5bp/html5-boilerplate/pull/1989))
-* Adds web app manifest file ([#1963](https://github.com/h5bp/html5-boilerplate/pull/1963))
-* Update to jQuery 3.2.1 ([#1942](https://github.com/h5bp/html5-boilerplate/pull/1942))
-* Improve ::selection documentation which became confusing after c7057be ([#1955](https://github.com/h5bp/html5-boilerplate/pull/1955))
-* refactor(html): update browsehappy to https instead of http ([#1952](https://github.com/h5bp/html5-boilerplate/pull/1952))
-* Fix links to CONTRIBUTING.md ([#1951](https://github.com/h5bp/html5-boilerplate/pull/1951))
-* Adds .github folder and contents Fixes ([#1948](https://github.com/h5bp/html5-boilerplate/pull/1948))
-* Modernizr 3, modernizr.config and ([#1940](https://github.com/h5bp/html5-boilerplate/pull/1940))
-* Housekeeping by @coliff (#1968 #1969 #1965 #1964 #1958 #1957 #1956)
-* Update .gitattributes for Web Projects ([#1935](https://github.com/h5bp/html5-boilerplate/pull/1935))
-* Add the link for useful .gitignore templates ([#1936](https://github.com/h5bp/html5-boilerplate/pull/1936))
-* Node plumbing updated ([#1925](https://github.com/h5bp/html5-boilerplate/pull/1925)) ([#1928](https://github.com/h5bp/html5-boilerplate/pull/1928)) ([#1931](https://github.com/h5bp/html5-boilerplate/pull/1931))
-* Use es2015 syntax in mocha tests ([#1788](https://github.com/h5bp/html5-boilerplate/pull/1788))
-* Scope :first-letter selector for print styles ([#1904](https://github.com/h5bp/html5-boilerplate/pull/1904))
-* Add SRI Hash for jQuery ([#1904](https://github.com/h5bp/html5-boilerplate/pull/1904))
-* Update .jshintrc ([#1903](https://github.com/h5bp/html5-boilerplate/pull/1903))
-* Improve accessibility with visuallyhidden content ([#1900](https://github.com/h5bp/html5-boilerplate/pull/1900))
-* Tell users that IE 8 and 9 are outdated
+- Fix Bug: .visuallyhidden on macOS VO fixes #1985 ([#1989](https://github.com/h5bp/html5-boilerplate/pull/1989))
+- Adds web app manifest file ([#1963](https://github.com/h5bp/html5-boilerplate/pull/1963))
+- Update to jQuery 3.2.1 ([#1942](https://github.com/h5bp/html5-boilerplate/pull/1942))
+- Improve ::selection documentation which became confusing after c7057be ([#1955](https://github.com/h5bp/html5-boilerplate/pull/1955))
+- refactor(html): update browsehappy to https instead of http ([#1952](https://github.com/h5bp/html5-boilerplate/pull/1952))
+- Fix links to CONTRIBUTING.md ([#1951](https://github.com/h5bp/html5-boilerplate/pull/1951))
+- Adds .github folder and contents Fixes ([#1948](https://github.com/h5bp/html5-boilerplate/pull/1948))
+- Modernizr 3, modernizr.config and ([#1940](https://github.com/h5bp/html5-boilerplate/pull/1940))
+- Housekeeping by @coliff (#1968 #1969 #1965 #1964 #1958 #1957 #1956)
+- Update .gitattributes for Web Projects ([#1935](https://github.com/h5bp/html5-boilerplate/pull/1935))
+- Add the link for useful .gitignore templates ([#1936](https://github.com/h5bp/html5-boilerplate/pull/1936))
+- Node plumbing updated ([#1925](https://github.com/h5bp/html5-boilerplate/pull/1925)) ([#1928](https://github.com/h5bp/html5-boilerplate/pull/1928)) ([#1931](https://github.com/h5bp/html5-boilerplate/pull/1931))
+- Use es2015 syntax in mocha tests ([#1788](https://github.com/h5bp/html5-boilerplate/pull/1788))
+- Scope :first-letter selector for print styles ([#1904](https://github.com/h5bp/html5-boilerplate/pull/1904))
+- Add SRI Hash for jQuery ([#1904](https://github.com/h5bp/html5-boilerplate/pull/1904))
+- Update .jshintrc ([#1903](https://github.com/h5bp/html5-boilerplate/pull/1903))
+- Improve accessibility with visuallyhidden content ([#1900](https://github.com/h5bp/html5-boilerplate/pull/1900))
+- Tell users that IE 8 and 9 are outdated
   ([#1747](https://github.com/h5bp/html5-boilerplate/issues/1747)).
-* Removed IE8 Support (upgrades jQuery and normalize.css to latest)
+- Removed IE8 Support (upgrades jQuery and normalize.css to latest)
   ([#1524](https://github.com/h5bp/html5-boilerplate/issues/1524)).
-* Fix print styles for Internet Explorer 11
+- Fix print styles for Internet Explorer 11
   ([#1799](https://github.com/h5bp/html5-boilerplate/issues/1799)).
-* Update doc links to https
+- Update doc links to https
   ([#1889](https://github.com/h5bp/html5-boilerplate/issues/1889)).
-* Delete crossdomain.xml
+- Delete crossdomain.xml
   ([#1881](https://github.com/h5bp/html5-boilerplate/issues/1881)).
-* Adds pre-wrap to PRE
+- Adds pre-wrap to PRE
   ([#1742](https://github.com/h5bp/html5-boilerplate/issues/1742)).
-* Change license format to SPDX format
+- Change license format to SPDX format
   ([#1814](https://github.com/h5bp/html5-boilerplate/pull/1814)).
-* Simplify the Google Analytics snippet using `async` & `defer` ([#1660](https://github.com/h5bp/html5-boilerplate/pull/1660#issuecomment-89285678)).
+- Simplify the Google Analytics snippet using `async` & `defer` ([#1660](https://github.com/h5bp/html5-boilerplate/pull/1660#issuecomment-89285678)).
 
 ## 5.3.0 (January 12, 2016)
 
-* Update jQuery to `v1.12.0`.
-* Fetch `jQuery` from jQuery's CDN instead of Google's
+- Update jQuery to `v1.12.0`.
+- Fetch `jQuery` from jQuery's CDN instead of Google's
   ([#1737](https://github.com/h5bp/html5-boilerplate/issues/1737),
   [#1739](https://github.com/h5bp/html5-boilerplate/issues/1739)).
-* Change print color for `:first-letter` and `:first-line`
+- Change print color for `:first-letter` and `:first-line`
   pseudo-elements
   ([#1715](https://github.com/h5bp/html5-boilerplate/pull/1715)).
 
 ## 5.2.0 (May 1, 2015)
 
-* Update jQuery to `v1.11.3`
+- Update jQuery to `v1.11.3`
   ([#1699](https://github.com/h5bp/html5-boilerplate/issues/1699)).
-* Deprecate protocol-relative URLs
+- Deprecate protocol-relative URLs
   ([#1694](https://github.com/h5bp/html5-boilerplate/issues/1694)).
-* Update high resolution media query
+- Update high resolution media query
   ([#1474](https://github.com/h5bp/html5-boilerplate/issues/1474)).
-* Update Apache Server Configs to `v2.14.0`.
+- Update Apache Server Configs to `v2.14.0`.
 
 ## 5.1.0 (April 1, 2015)
 
-* Update Normalize.css to `v3.0.3`.
-* Use `https://` in the Google Universal Analytics snippet
+- Update Normalize.css to `v3.0.3`.
+- Use `https://` in the Google Universal Analytics snippet
   ([eee759b](https://github.com/h5bp/html5-boilerplate/commit/eee759bfe175e850bbc8e4ad0682ec4fe4bd05d6)).
-* Remove the `visibility: hidden` declaration from `.hidden`
+- Remove the `visibility: hidden` declaration from `.hidden`
   ([#1663](https://github.com/h5bp/html5-boilerplate/issues/1663)).
-* Use `<meta http-equiv="x-ua-compatible" content="ie=edge">`<br>
+- Use `<meta http-equiv="x-ua-compatible" content="ie=edge">`<br>
   instead of `<meta http-equiv="X-UA-Compatible" content="IE=edge">`
   ([#1656](https://github.com/h5bp/html5-boilerplate/issues/1656)).
-* Update Apache Server Configs to `v2.13.0`.
+- Update Apache Server Configs to `v2.13.0`.
 
 ## 5.0.0 (February 1, 2015)
 
-* Update to jQuery 1.11.2.
-* Update Apache Server Configs to v2.11.0.
-* Rename Apple touch icon to `apple-touch-icon.png` and add
+- Update to jQuery 1.11.2.
+- Update Apache Server Configs to v2.11.0.
+- Rename Apple touch icon to `apple-touch-icon.png` and add
   `<link>` in `index.html`
   ([#1622](https://github.com/h5bp/html5-boilerplate/issues/1622)).
-* Add vertical centering for `iframe`
+- Add vertical centering for `iframe`
   ([#1613](https://github.com/h5bp/html5-boilerplate/issues/1613)).
-* Change the outdated browser prompt classname to `browserupgrade`
+- Change the outdated browser prompt classname to `browserupgrade`
   ([#1608](https://github.com/h5bp/html5-boilerplate/issues/1608)).
-* Update to Normalize.css 3.0.2.
+- Update to Normalize.css 3.0.2.
   ([#1050](https://github.com/h5bp/html5-boilerplate/issues/1050)).
-* Update `apple-touch-icon-precomposed.png` and the _"Apple touch
+- Update `apple-touch-icon-precomposed.png` and the _"Apple touch
   icons"_ related documentation
   ([#1599](https://github.com/h5bp/html5-boilerplate/pull/1599)).
-* Add pseudo-elements to universal selector in print media query
+- Add pseudo-elements to universal selector in print media query
   ([#1585](https://github.com/h5bp/html5-boilerplate/pull/1585)).
-* Update to Modernizr 2.8.3.
-* Remove need to readjust margins in `404.html`
+- Update to Modernizr 2.8.3.
+- Remove need to readjust margins in `404.html`
   ([#1567](https://github.com/h5bp/html5-boilerplate/pull/1567)).
-* Add `/.editorconfig` file
+- Add `/.editorconfig` file
   ([#1561](https://github.com/h5bp/html5-boilerplate/issues/1561),
   [#1564](https://github.com/h5bp/html5-boilerplate/issues/1564)).
-* Add `auto` to the Google Universal Analytics tracker create method
+- Add `auto` to the Google Universal Analytics tracker create method
   ([#1562](https://github.com/h5bp/html5-boilerplate/issues/1562)).
-* Add `timeline` and `timelineEnd` to the list of `console` methods
+- Add `timeline` and `timelineEnd` to the list of `console` methods
   ([#1559](https://github.com/h5bp/html5-boilerplate/issues/1559)).
-* Add `lang=""` to `<html>`
+- Add `lang=""` to `<html>`
   ([#1542](https://github.com/h5bp/html5-boilerplate/issues/1542)).
-* Use `<!doctype html>` instead of `<!DOCTYPE html>`
+- Use `<!doctype html>` instead of `<!DOCTYPE html>`
   ([#1522](https://github.com/h5bp/html5-boilerplate/issues/1522)).
-* Add `/browserconfig.xml` file and tile images
+- Add `/browserconfig.xml` file and tile images
   ([#1481](https://github.com/h5bp/html5-boilerplate/issues/1481)).
-* Add `Disallow:` to `robots.txt`
+- Add `Disallow:` to `robots.txt`
   ([#1487](https://github.com/h5bp/html5-boilerplate/issues/1487)).
-* Remove default foreground color from form elements
+- Remove default foreground color from form elements
   ([#1390](https://github.com/h5bp/html5-boilerplate/issues/1390)).
-* Remove default margin from print styles
+- Remove default margin from print styles
   ([#1477](https://github.com/h5bp/html5-boilerplate/issues/1477)).
-* Remove image replacement helper class `.ir`
+- Remove image replacement helper class `.ir`
   ([#1472](https://github.com/h5bp/html5-boilerplate/issues/1472),
   [#1475](https://github.com/h5bp/html5-boilerplate/issues/1475)).
-* Add vertical centering for `svg`
+- Add vertical centering for `svg`
   ([#1453](https://github.com/h5bp/html5-boilerplate/issues/1453)).
-* Redesign 404 page
+- Redesign 404 page
   ([#1443](https://github.com/h5bp/html5-boilerplate/pull/1443)).
-* Remove IE 6/7 hacks from `main.css`
+- Remove IE 6/7 hacks from `main.css`
   ([#1050](https://github.com/h5bp/html5-boilerplate/issues/1050)).
-* Remove IE conditional classes
+- Remove IE conditional classes
   ([#1187](https://github.com/h5bp/html5-boilerplate/issues/1187),
   [#1290](https://github.com/h5bp/html5-boilerplate/issues/1290)).
 
 ## 4.3.0 (September 10, 2013)
 
-* Use one `apple-touch-icon` instead of six
+- Use one `apple-touch-icon` instead of six
   ([#1367](https://github.com/h5bp/html5-boilerplate/issues/1367)).
-* Move font-related declarations from `body` to `html`
+- Move font-related declarations from `body` to `html`
   ([#1411](https://github.com/h5bp/html5-boilerplate/issues/1411)).
-* Update to Apache Server Configs 1.1.0.
-* Add `initial-scale=1` to the viewport `meta`
+- Update to Apache Server Configs 1.1.0.
+- Add `initial-scale=1` to the viewport `meta`
   ([#1398](https://github.com/h5bp/html5-boilerplate/pull/1398)).
-* Vertical centering for audio, canvas and video-tags
+- Vertical centering for audio, canvas and video-tags
   ([#1326](https://github.com/h5bp/html5-boilerplate/issues/1326)).
-* Remove Google Chrome Frame related code
+- Remove Google Chrome Frame related code
   ([#1379](https://github.com/h5bp/html5-boilerplate/pull/1379),
   [#1396](https://github.com/h5bp/html5-boilerplate/pull/1396)).
-* Update to Google Universal Analytics
+- Update to Google Universal Analytics
   ([#1347](https://github.com/h5bp/html5-boilerplate/issues/1347)).
-* Update to jQuery 1.10.2.
-* Update to Normalize.css 1.1.3.
+- Update to jQuery 1.10.2.
+- Update to Normalize.css 1.1.3.
 
 ## 4.2.0 (April 8, 2013)
 
-* Remove Google Analytics protocol check
+- Remove Google Analytics protocol check
   ([#1319](https://github.com/h5bp/html5-boilerplate/pull/1319)).
-* Update to Normalize.css 1.1.1.
-* Update Apache configurations to include the latest changes in the
+- Update to Normalize.css 1.1.1.
+- Update Apache configurations to include the latest changes in the
   canonical [`.htaccess`](https://github.com/h5bp/server-configs-apache)
   file.
-* Use a protocol relative URL for the 404 template script.
-* Update to jQuery 1.9.1.
+- Use a protocol relative URL for the 404 template script.
+- Update to jQuery 1.9.1.
 
 ## 4.1.0 (January 21, 2013)
 
-* Update to Normalize.css 1.1.0.
-* Update to jQuery 1.9.0.
+- Update to Normalize.css 1.1.0.
+- Update to jQuery 1.9.0.
 
 ## 4.0.3 (January 12, 2013)
 
-* Use 32x32 favicon.ico
+- Use 32x32 favicon.ico
   ([#1286](https://github.com/h5bp/html5-boilerplate/pull/1286)).
-* Remove named function expression in plugins.js
+- Remove named function expression in plugins.js
   ([#1280](https://github.com/h5bp/html5-boilerplate/pull/1280)).
-* Adjust CSS image-replacement code
+- Adjust CSS image-replacement code
   ([#1239](https://github.com/h5bp/html5-boilerplate/issues/1239)).
-* Update HiDPI example media query
+- Update HiDPI example media query
   ([#1127](https://github.com/h5bp/html5-boilerplate/issues/1127)).
 
 ## 4.0.2 (December 9, 2012)
 
-* Update placeholder icons.
-* Update to Normalize.css 1.0.2.
-* Update to jQuery 1.8.3.
+- Update placeholder icons.
+- Update to Normalize.css 1.0.2.
+- Update to jQuery 1.8.3.
 
 ## 4.0.1 (October 20, 2012)
 
-* Further improvements to `console` method stubbing
+- Further improvements to `console` method stubbing
   ([#1206](https://github.com/h5bp/html5-boilerplate/issues/1206),
   [#1229](https://github.com/h5bp/html5-boilerplate/pull/1229)).
-* Update to jQuery 1.8.2.
-* Update to Modernizr 2.6.2.
-* Minor additions to the documentation.
+- Update to jQuery 1.8.2.
+- Update to Modernizr 2.6.2.
+- Minor additions to the documentation.
 
 ## 4.0.0 (August 28, 2012)
 
-* Improve the Apache compression configuration
+- Improve the Apache compression configuration
   ([#1012](https://github.com/h5bp/html5-boilerplate/issues/1012),
   [#1173](https://github.com/h5bp/html5-boilerplate/issues/1173)).
-* Add a HiDPI example media query
+- Add a HiDPI example media query
   ([#1127](https://github.com/h5bp/html5-boilerplate/issues/1127)).
-* Add bundled docs
+- Add bundled docs
   ([#1154](https://github.com/h5bp/html5-boilerplate/issues/1154)).
-* Add MIT license
+- Add MIT license
   ([#1139](https://github.com/h5bp/html5-boilerplate/issues/1139)).
-* Update to Normalize.css 1.0.1.
-* Separate Normalize.css from the rest of the CSS
+- Update to Normalize.css 1.0.1.
+- Separate Normalize.css from the rest of the CSS
   ([#1160](https://github.com/h5bp/html5-boilerplate/issues/1160)).
-* Improve `console.log` protection
+- Improve `console.log` protection
   ([#1107](https://github.com/h5bp/html5-boilerplate/issues/1107)).
-* Replace hot pink text selection color with a neutral color.
-* Change image replacement technique
+- Replace hot pink text selection color with a neutral color.
+- Change image replacement technique
   ([#1149](https://github.com/h5bp/html5-boilerplate/issues/1149)).
-* Code format and consistency changes
+- Code format and consistency changes
   ([#1112](https://github.com/h5bp/html5-boilerplate/issues/1112)).
-* Rename CSS file and rename JS files and subdirectories.
-* Update to jQuery 1.8
+- Rename CSS file and rename JS files and subdirectories.
+- Update to jQuery 1.8
   ([#1161](https://github.com/h5bp/html5-boilerplate/issues/1161)).
-* Update to Modernizr 2.6.1
+- Update to Modernizr 2.6.1
   ([#1086](https://github.com/h5bp/html5-boilerplate/issues/1086)).
-* Remove uncompressed jQuery
+- Remove uncompressed jQuery
   ([#1153](https://github.com/h5bp/html5-boilerplate/issues/1153)).
-* Remove superfluous inline comments
+- Remove superfluous inline comments
   ([#1150](https://github.com/h5bp/html5-boilerplate/issues/1150)).
 
 ## 3.0.2 (February 19, 2012)
 
-* Update to Modernizr 2.5.3.
+- Update to Modernizr 2.5.3.
 
 ## 3.0.1 (February 08, 2012)
 
-* Update to Modernizr 2.5.2 (includes html5shiv 3.3).
+- Update to Modernizr 2.5.2 (includes html5shiv 3.3).
 
 ## 3.0.0 (February 06, 2012)
 
-* Improvements to `.htaccess`.
-* Improve 404 design.
-* Simplify JS folder structure.
-* Change `html` IE class names changed to target ranges rather than
+- Improvements to `.htaccess`.
+- Improve 404 design.
+- Simplify JS folder structure.
+- Change `html` IE class names changed to target ranges rather than
   specific versions of IE.
-* Update CSS to include latest normalize.css changes and better
+- Update CSS to include latest normalize.css changes and better
   typographic defaults
   ([#825](https://github.com/h5bp/html5-boilerplate/issues/825)).
-* Update to Modernizr 2.5 (includes yepnope 1.5 and html5shiv 3.2).
-* Update to jQuery 1.7.1.
-* Revert to async snippet for the Google Analytics script.
-* Remove the ant build script
+- Update to Modernizr 2.5 (includes yepnope 1.5 and html5shiv 3.2).
+- Update to jQuery 1.7.1.
+- Revert to async snippet for the Google Analytics script.
+- Remove the ant build script
   ([#826](https://github.com/h5bp/html5-boilerplate/issues/826)).
-* Remove Respond.js
+- Remove Respond.js
   ([#816](https://github.com/h5bp/html5-boilerplate/issues/816)).
-* Remove the `demo/` directory
+- Remove the `demo/` directory
   ([#808](https://github.com/h5bp/html5-boilerplate/issues/808)).
-* Remove the `test/` directory
+- Remove the `test/` directory
   ([#808](https://github.com/h5bp/html5-boilerplate/issues/808)).
-* Remove Google Chrome Frame script for IE6 users; replace with links
+- Remove Google Chrome Frame script for IE6 users; replace with links
   to Chrome Frame and options for alternative browsers.
-* Remove `initial-scale=1` from the viewport `meta`
+- Remove `initial-scale=1` from the viewport `meta`
   ([#824](https://github.com/h5bp/html5-boilerplate/issues/824)).
-* Remove `defer` from all scripts to avoid legacy IE bugs.
-* Remove explicit Site Speed tracking for Google Analytics. It's now
+- Remove `defer` from all scripts to avoid legacy IE bugs.
+- Remove explicit Site Speed tracking for Google Analytics. It's now
   enabled by default.
 
 ## 2.0.0 (August 10, 2011)
 
-* Change starting CSS to be based on normalize.css instead of reset.css
+- Change starting CSS to be based on normalize.css instead of reset.css
   ([#500](https://github.com/h5bp/html5-boilerplate/issues/500)).
-* Add Respond.js media query polyfill.
-* Add Google Chrome Frame script prompt for IE6 users.
-* Simplify the `html` conditional comments for modern browsers and add
+- Add Respond.js media query polyfill.
+- Add Google Chrome Frame script prompt for IE6 users.
+- Simplify the `html` conditional comments for modern browsers and add
   an `oldie` class.
-* Update clearfix to use "micro clearfix".
-* Add placeholder CSS MQs for mobile-first approach.
-* Add `textarea { resize: vertical; }` to only allow vertical resizing.
-* Add `img { max-width: 100%; }` to the print styles; prevents images
+- Update clearfix to use "micro clearfix".
+- Add placeholder CSS MQs for mobile-first approach.
+- Add `textarea { resize: vertical; }` to only allow vertical resizing.
+- Add `img { max-width: 100%; }` to the print styles; prevents images
   being truncated.
-* Add Site Speed tracking for Google Analytics.
-* Update to jQuery 1.6.2 (and use minified by default).
-* Update to Modernizr 2.0 Complete, Production minified (includes
+- Add Site Speed tracking for Google Analytics.
+- Update to jQuery 1.6.2 (and use minified by default).
+- Update to Modernizr 2.0 Complete, Production minified (includes
   yepnope, html5shiv, and Respond.js).
-* Use `Modernizr.load()` to load the Google Analytics script.
-* Much faster build process.
-* Add build script options for CSSLint, JSLint, JSHint tools.
-* Build script now compresses all images in subfolders.
-* Build script now versions files by SHA hash.
-* Many `.htaccess` improvements including: disable directory browsing,
+- Use `Modernizr.load()` to load the Google Analytics script.
+- Much faster build process.
+- Add build script options for CSSLint, JSLint, JSHint tools.
+- Build script now compresses all images in subfolders.
+- Build script now versions files by SHA hash.
+- Many `.htaccess` improvements including: disable directory browsing,
   improved support for all versions of Apache, more robust and extensive
   HTTP compression rules.
-* Remove `handheld.css` as it has very poor device support.
-* Remove touch-icon `link` elements from the HTML and include improved
+- Remove `handheld.css` as it has very poor device support.
+- Remove touch-icon `link` elements from the HTML and include improved
   touch-icon support.
-* Remove the cache-busting query parameters from files references in
+- Remove the cache-busting query parameters from files references in
   the HTML.
-* Remove IE6 PNGFix.
+- Remove IE6 PNGFix.
 
 ## 1.0.0 (March 21, 2011)
 
-* Rewrite build script to make it more customizable and flexible.
-* Add a humans.txt.
-* Numerous `.htaccess` improvements (including inline documentation).
-* Move the alternative server configurations to the H5BP server configs
+- Rewrite build script to make it more customizable and flexible.
+- Add a humans.txt.
+- Numerous `.htaccess` improvements (including inline documentation).
+- Move the alternative server configurations to the H5BP server configs
   repo.
-* Use a protocol-relative url to reference jQuery and prevent mixed
+- Use a protocol-relative url to reference jQuery and prevent mixed
   content warnings.
-* Optimize the Google Analytics snippet.
-* Use Eric Meyer's recent CSS reset update and the HTML5 Doctor reset.
-* More robust `sub`/`sup` CSS styles.
-* Add keyboard `.focusable` helper class that extends `.visuallyhidden`.
-* Print styles no longer print hash or JavaScript links.
-* Add a print reset for IE's proprietary filters.
-* Remove IE9-specific conditional class on the `html` element.
-* Remove margins from lists within `nav` elements.
-* Remove YUI profiling.
+- Optimize the Google Analytics snippet.
+- Use Eric Meyer's recent CSS reset update and the HTML5 Doctor reset.
+- More robust `sub`/`sup` CSS styles.
+- Add keyboard `.focusable` helper class that extends `.visuallyhidden`.
+- Print styles no longer print hash or JavaScript links.
+- Add a print reset for IE's proprietary filters.
+- Remove IE9-specific conditional class on the `html` element.
+- Remove margins from lists within `nav` elements.
+- Remove YUI profiling.

README.md

@@ -1,8 +1,7 @@
 # [HTML5 Boilerplate](https://html5boilerplate.com/)
 
-[![LICENSE](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://github.com/h5bp/html5-boilerplate/blob/master/LICENSE.txt)
-[![Build Status](https://travis-ci.org/h5bp/html5-boilerplate.svg)](https://travis-ci.org/h5bp/html5-boilerplate)
-[![devDependency Status](https://david-dm.org/h5bp/html5-boilerplate/dev-status.svg)](https://david-dm.org/h5bp/html5-boilerplate#info=devDependencies)
+[![Build status](https://github.com/h5bp/html5-boilerplate/workflows/Build%20status/badge.svg)](https://github.com/h5bp/html5-boilerplate/actions?query=workflow%3A%22Build+status%22+branch%3Amain)
+[![LICENSE](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://github.com/h5bp/html5-boilerplate/blob/main/LICENSE.txt)
 [![NPM Downloads](https://img.shields.io/npm/dt/html5-boilerplate.svg)](https://www.npmjs.com/package/html5-boilerplate)
 [![github-stars-image](https://img.shields.io/github/stars/h5bp/html5-boilerplate.svg?label=github%20stars)](https://github.com/h5bp/html5-boilerplate)
 
@@ -14,19 +13,63 @@ community knowledge. It does not impose a specific development
 philosophy or framework, so you're free to architect your code in the
 way that you want.
 
-* Homepage: [https://html5boilerplate.com/](https://html5boilerplate.com/)
-* Source: [https://github.com/h5bp/html5-boilerplate](https://github.com/h5bp/html5-boilerplate)
-* Twitter: [@h5bp](https://twitter.com/h5bp)
+- [Homepage](https://html5boilerplate.com/)
+- [Source Code](https://github.com/h5bp/html5-boilerplate)
 
-## Quick start
+## About This Repository
+
+This repository is where HTML5-Boilerplate is authored. Some of the tools,
+files and processes that you see here are solely for the _production_ of
+HTML5 Boilerplate and are not _part_ of HTML5 Boilerplate. For one example, the
+[gulpfile.mjs](https://github.com/h5bp/html5-boilerplate/blob/main/gulpfile.mjs)
+script is used to _build_ the project. It's not part of the project itself.
+
+The project we publish is represented by the contents of the `/dist/`
+folder. Everything else in this repository is used to author the project.
+
+Think of it this way, in the same way that you don't clone [vuejs/core](https://github.com/vuejs/core)
+to create a Vue.js app, you don't need to clone this repository to start a new
+site or app based on HTML5 Boilerplate.
+
+So, if you're looking for a quick start template to build a website or
+application, look at the options in the
+[Quick Start](https://github.com/h5bp/html5-boilerplate#quick-start) section of this document.
+
+If you want to help us _improve_ HTML5 Boilerplate then you can start with the documentation [here](.github/CONTRIBUTING.md), which includes steps to clone this repo in order to get it set up for development.
+
+## Quick Start
 
 Choose one of the following options:
 
-* Download the latest stable release from
-  [html5boilerplate.com](https://html5boilerplate.com/). This zip file is a
+- Using the [create-html5-boilerplate](https://github.com/h5bp/create-html5-boilerplate)
+  script, instantly fetch the latest npm published package (or any version
+  available on npm) with `npx`, `npm init` or `yarn create` without having to
+  install any dependencies. Running the following `npx` command installs the
+  latest version into a folder called `new-site`
+
+  ```bash
+  npx create-html5-boilerplate new-site
+  cd new-site
+  npm install
+  npm run start
+  ```
+
+- Using our new [Template Repository](https://github.com/h5bp/html5-boilerplate-template)
+  create a new GitHub repository based on the latest code from the main branch of HTML5
+  Boilerplate.
+
+- Install with [npm](https://www.npmjs.com/): `npm install html5-boilerplate`
+  or [yarn](https://yarnpkg.com/): `yarn add html5-boilerplate`. The resulting
+  `node_modules/html5-boilerplate/dist` folder represents the latest version of
+  the project for end users. Depending on what you want to use and how you want
+  to use it, you may have to copy and paste the contents of that folder into
+  your project directory.
+
+- Download the latest stable release from
+  [here](https://github.com/h5bp/html5-boilerplate/releases/download/v9.0.0/html5-boilerplate_v9.0.0.zip). This zip file is a
   snapshot of the `dist` folder. On Windows, Mac and from the file manager on
   Linux unzipping this folder will output to a folder named something like
-  `html5-boilerplate_v7.3.0`. From the command line will need to create a
+  `html5-boilerplate_v9.0.0`. From the command-line, you will need to create a
   folder and unzip the contents into that folder.
 
   ```bash
@@ -34,75 +77,31 @@ Choose one of the following options:
   unzip html5-boilerplate*.zip -d html5-boilerplate
   ```
 
-* Clone the git repo — `git clone
-  https://github.com/h5bp/html5-boilerplate.git` - and checkout the
-  [tagged release](https://github.com/h5bp/html5-boilerplate/releases)
-  you'd like to use. The `dist` folder represents the latest version of the
-  project for end users.
-
-* Install with [npm](https://www.npmjs.com/): `npm install html5-boilerplate`
-  or [yarn](https://yarnpkg.com/): `yarn add html5-boilerplate`. The resulting
-  `node_modules/html5-boilerplate/dist` folder represents the latest version of
-  the project for end users. Depending on what you want to use and how you want
-  to use it, you may have to copy and paste the contents of that folder into
-  your project directory.
-
-* Using our new [create-html5-boilerplate](https://github.com/h5bp/create-html5-boilerplate)
-  project, instantly fetch the latest npm published package (or any version
-  available on npm) with `npx`, `npm init` or `yarn create` without having to
-  install any dependencies. Running the following `npx` command installs the
-  latest version into a folder called `new-site`
-
-  ```
-  npx create-html5-boilerplate new-site
-  cd new-site
-  npm install
-  npm start
-  ```
-
 ## Features
 
-* A finely-tuned starter template. Reap the benefits of 10 years of analysis,
+- A finely-tuned starter template: Reap the benefits of 10 years of analysis,
   research and experimentation by over 200 contributors.
-* Designed with progressive enhancement in mind.
-* Includes:
-  * [`Normalize.css`](https://necolas.github.com/normalize.css/)
-    for CSS normalizations and common bug fixes
-  * A custom build of [`Modernizr`](https://modernizr.com/) for feature
-    detection
-  * [`Apache Server Configs`](https://github.com/h5bp/server-configs-apache)
-    that improve the web site's performance and security
-* Placeholder Open Graph elements and attributes.
-* An example package.json file with [Parcel](https://parceljs.org/) commands
-  built in to jumpstart application development
-* Placeholder CSS Media Queries.
-* Useful CSS helper classes.
-* Default print styles, performance optimized.
-* An optimized version of the Google Universal Analytics snippet.
-* Protection against any stray `console` statements causing JavaScript
-  errors in older browsers.
-* "Delete-key friendly." Easy to strip out parts you don't need.
-* Extensive documentation.
+- Designed with progressive enhancement in mind.
+- Includes:
+  - Placeholder Open Graph elements and attributes.
+  - An example package.json file with [WebPack](https://webpack.js.org/) commands
+    built in to jumpstart application development.
+  - Placeholder CSS Media Queries.
+  - Useful CSS helper classes.
+  - Default print styles, performance optimized.
+  - "Delete-key friendly." Easy to strip out parts you don't need.
+  - Extensive documentation.
 
-## Browser support
+## Browser Support
 
-* Chrome *(latest 2)*
-* Edge *(latest 2)*
-* Firefox *(latest 2)*
-* Internet Explorer 11
-* Opera *(latest 2)*
-* Safari *(latest 2)*
+HTML5-Boilerplate supports the latest, stable releases of all major browsers.
 
-*This doesn't mean that HTML5 Boilerplate cannot be used in older browsers,
-just that we'll ensure compatibility with the ones mentioned above.*
-
-If you need legacy browser support you can use [HTML5 Boilerplate v6](https://github.com/h5bp/html5-boilerplate/releases/tag/6.1.0) (IE9/IE10)
-or [HTML5 Boilerplate v5](https://github.com/h5bp/html5-boilerplate/releases/tag/5.3.0)
-(IE 8). They are no longer actively developed.
+Check the `default` configuration from [Browserslist](https://browsersl.ist/#q=defaults)
+for more details on browsers and versions covered.
 
 ## Documentation
 
-Take a look at the [documentation table of contents](dist/doc/TOC.md). This
+Take a look at the [documentation table of contents](docs/TOC.md). This
 documentation is bundled with the project which makes it available for offline
 reading and provides a useful starting point for any documentation you want to
 write about your project.
@@ -110,12 +109,12 @@ write about your project.
 ## Contributing
 
 Hundreds of developers have helped to make the HTML5 Boilerplate. Anyone is
-welcome to [contribute](.github/CONTRIBUTING.md), however, if you decide to get
+welcome to [contribute](.github/CONTRIBUTING.md). However, if you decide to get
 involved, please take a moment to review the [guidelines](.github/CONTRIBUTING.md):
 
-* [Bug reports](.github/CONTRIBUTING.md#bugs)
-* [Feature requests](.github/CONTRIBUTING.md#features)
-* [Pull requests](.github/CONTRIBUTING.md#pull-requests)
+- [Bug reports](.github/CONTRIBUTING.md#bugs)
+- [Feature requests](.github/CONTRIBUTING.md#features)
+- [Pull requests](.github/CONTRIBUTING.md#pull-requests)
 
 ## License
 

dist/.editorconfig

@@ -4,6 +4,7 @@ root = true
 
 [*]
 charset = utf-8
+end_of_line = lf
 indent_size = 2
 indent_style = space
 insert_final_newline = true

dist/browserconfig.xml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Please read: https://msdn.microsoft.com/en-us/library/ie/dn455106.aspx -->
-<browserconfig>
-  <msapplication>
-    <tile>
-      <square70x70logo src="tile.png"/>
-      <square150x150logo src="tile.png"/>
-      <wide310x150logo src="tile-wide.png"/>
-      <square310x310logo src="tile.png"/>
-    </tile>
-  </msapplication>
-</browserconfig>

dist/css/normalize.css

@@ -1,349 +0,0 @@
-/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */
-
-/* Document
-   ========================================================================== */
-
-/**
- * 1. Correct the line height in all browsers.
- * 2. Prevent adjustments of font size after orientation changes in iOS.
- */
-
-html {
-  line-height: 1.15; /* 1 */
-  -webkit-text-size-adjust: 100%; /* 2 */
-}
-
-/* Sections
-   ========================================================================== */
-
-/**
- * Remove the margin in all browsers.
- */
-
-body {
-  margin: 0;
-}
-
-/**
- * Render the `main` element consistently in IE.
- */
-
-main {
-  display: block;
-}
-
-/**
- * Correct the font size and margin on `h1` elements within `section` and
- * `article` contexts in Chrome, Firefox, and Safari.
- */
-
-h1 {
-  font-size: 2em;
-  margin: 0.67em 0;
-}
-
-/* Grouping content
-   ========================================================================== */
-
-/**
- * 1. Add the correct box sizing in Firefox.
- * 2. Show the overflow in Edge and IE.
- */
-
-hr {
-  box-sizing: content-box; /* 1 */
-  height: 0; /* 1 */
-  overflow: visible; /* 2 */
-}
-
-/**
- * 1. Correct the inheritance and scaling of font size in all browsers.
- * 2. Correct the odd `em` font sizing in all browsers.
- */
-
-pre {
-  font-family: monospace, monospace; /* 1 */
-  font-size: 1em; /* 2 */
-}
-
-/* Text-level semantics
-   ========================================================================== */
-
-/**
- * Remove the gray background on active links in IE 10.
- */
-
-a {
-  background-color: transparent;
-}
-
-/**
- * 1. Remove the bottom border in Chrome 57-
- * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.
- */
-
-abbr[title] {
-  border-bottom: none; /* 1 */
-  text-decoration: underline; /* 2 */
-  text-decoration: underline dotted; /* 2 */
-}
-
-/**
- * Add the correct font weight in Chrome, Edge, and Safari.
- */
-
-b,
-strong {
-  font-weight: bolder;
-}
-
-/**
- * 1. Correct the inheritance and scaling of font size in all browsers.
- * 2. Correct the odd `em` font sizing in all browsers.
- */
-
-code,
-kbd,
-samp {
-  font-family: monospace, monospace; /* 1 */
-  font-size: 1em; /* 2 */
-}
-
-/**
- * Add the correct font size in all browsers.
- */
-
-small {
-  font-size: 80%;
-}
-
-/**
- * Prevent `sub` and `sup` elements from affecting the line height in
- * all browsers.
- */
-
-sub,
-sup {
-  font-size: 75%;
-  line-height: 0;
-  position: relative;
-  vertical-align: baseline;
-}
-
-sub {
-  bottom: -0.25em;
-}
-
-sup {
-  top: -0.5em;
-}
-
-/* Embedded content
-   ========================================================================== */
-
-/**
- * Remove the border on images inside links in IE 10.
- */
-
-img {
-  border-style: none;
-}
-
-/* Forms
-   ========================================================================== */
-
-/**
- * 1. Change the font styles in all browsers.
- * 2. Remove the margin in Firefox and Safari.
- */
-
-button,
-input,
-optgroup,
-select,
-textarea {
-  font-family: inherit; /* 1 */
-  font-size: 100%; /* 1 */
-  line-height: 1.15; /* 1 */
-  margin: 0; /* 2 */
-}
-
-/**
- * Show the overflow in IE.
- * 1. Show the overflow in Edge.
- */
-
-button,
-input { /* 1 */
-  overflow: visible;
-}
-
-/**
- * Remove the inheritance of text transform in Edge, Firefox, and IE.
- * 1. Remove the inheritance of text transform in Firefox.
- */
-
-button,
-select { /* 1 */
-  text-transform: none;
-}
-
-/**
- * Correct the inability to style clickable types in iOS and Safari.
- */
-
-button,
-[type="button"],
-[type="reset"],
-[type="submit"] {
-  -webkit-appearance: button;
-}
-
-/**
- * Remove the inner border and padding in Firefox.
- */
-
-button::-moz-focus-inner,
-[type="button"]::-moz-focus-inner,
-[type="reset"]::-moz-focus-inner,
-[type="submit"]::-moz-focus-inner {
-  border-style: none;
-  padding: 0;
-}
-
-/**
- * Restore the focus styles unset by the previous rule.
- */
-
-button:-moz-focusring,
-[type="button"]:-moz-focusring,
-[type="reset"]:-moz-focusring,
-[type="submit"]:-moz-focusring {
-  outline: 1px dotted ButtonText;
-}
-
-/**
- * Correct the padding in Firefox.
- */
-
-fieldset {
-  padding: 0.35em 0.75em 0.625em;
-}
-
-/**
- * 1. Correct the text wrapping in Edge and IE.
- * 2. Correct the color inheritance from `fieldset` elements in IE.
- * 3. Remove the padding so developers are not caught out when they zero out
- *    `fieldset` elements in all browsers.
- */
-
-legend {
-  box-sizing: border-box; /* 1 */
-  color: inherit; /* 2 */
-  display: table; /* 1 */
-  max-width: 100%; /* 1 */
-  padding: 0; /* 3 */
-  white-space: normal; /* 1 */
-}
-
-/**
- * Add the correct vertical alignment in Chrome, Firefox, and Opera.
- */
-
-progress {
-  vertical-align: baseline;
-}
-
-/**
- * Remove the default vertical scrollbar in IE 10+.
- */
-
-textarea {
-  overflow: auto;
-}
-
-/**
- * 1. Add the correct box sizing in IE 10.
- * 2. Remove the padding in IE 10.
- */
-
-[type="checkbox"],
-[type="radio"] {
-  box-sizing: border-box; /* 1 */
-  padding: 0; /* 2 */
-}
-
-/**
- * Correct the cursor style of increment and decrement buttons in Chrome.
- */
-
-[type="number"]::-webkit-inner-spin-button,
-[type="number"]::-webkit-outer-spin-button {
-  height: auto;
-}
-
-/**
- * 1. Correct the odd appearance in Chrome and Safari.
- * 2. Correct the outline style in Safari.
- */
-
-[type="search"] {
-  -webkit-appearance: textfield; /* 1 */
-  outline-offset: -2px; /* 2 */
-}
-
-/**
- * Remove the inner padding in Chrome and Safari on macOS.
- */
-
-[type="search"]::-webkit-search-decoration {
-  -webkit-appearance: none;
-}
-
-/**
- * 1. Correct the inability to style clickable types in iOS and Safari.
- * 2. Change font properties to `inherit` in Safari.
- */
-
-::-webkit-file-upload-button {
-  -webkit-appearance: button; /* 1 */
-  font: inherit; /* 2 */
-}
-
-/* Interactive
-   ========================================================================== */
-
-/*
- * Add the correct display in Edge, IE 10+, and Firefox.
- */
-
-details {
-  display: block;
-}
-
-/*
- * Add the correct display in all browsers.
- */
-
-summary {
-  display: list-item;
-}
-
-/* Misc
-   ========================================================================== */
-
-/**
- * Add the correct display in IE 10+.
- */
-
-template {
-  display: none;
-}
-
-/**
- * Add the correct display in IE 10.
- */
-
-[hidden] {
-  display: none;
-}

dist/css/style.css

@@ -1,6 +1,6 @@
-/*! HTML5 Boilerplate v8.0.0 | MIT License | https://html5boilerplate.com/ */
+/*! HTML5 Boilerplate v9.0.1 | MIT License | https://html5boilerplate.com/ */
 
-/* main.css 2.1.0 | MIT License | https://github.com/h5bp/main.css#readme */
+/* main.css 3.0.0 | MIT License | https://github.com/h5bp/main.css#readme */
 /*
  * What follows is the result of much research on cross-browser styling.
  * Credit left inline and big thanks to Nicolas Gallagher, Jonathan Neal,
@@ -21,9 +21,6 @@ html {
  * Remove text-shadow in selection highlight:
  * https://twitter.com/miketaylr/status/12228805301
  *
- * Vendor-prefixed and regular ::selection selectors cannot be combined:
- * https://stackoverflow.com/a/16982510/7133471
- *
  * Customize the background color to match your design.
  */
 
@@ -109,7 +106,7 @@ textarea {
  *    https://medium.com/@jessebeach/beware-smushed-off-screen-accessible-text-5952a4c2cbfe
  */
 
-.sr-only {
+.visually-hidden {
   border: 0;
   clip: rect(0, 0, 0, 0);
   height: 1px;
@@ -123,13 +120,13 @@ textarea {
 }
 
 /*
- * Extends the .sr-only class to allow the element
+ * Extends the .visually-hidden class to allow the element
  * to be focusable when navigated to via the keyboard:
  * https://www.drupal.org/node/897638
  */
 
-.sr-only.focusable:active,
-.sr-only.focusable:focus {
+.visually-hidden.focusable:active,
+.visually-hidden.focusable:focus {
   clip: auto;
   height: auto;
   margin: 0;
@@ -150,18 +147,13 @@ textarea {
 /*
  * Clearfix: contain floats
  *
- * For modern browsers
- * 1. The space content is one way to avoid an Opera bug when the
- *    `contenteditable` attribute is included anywhere else in the document.
- *    Otherwise it causes space to appear at the top and bottom of elements
- *    that receive the `clearfix` class.
- * 2. The use of `table` rather than `block` is only necessary if using
- *    `:before` to contain the top-margins of child elements.
+ * The use of `table` rather than `block` is only necessary if using
+ * `::before` to contain the top-margins of child elements.
  */
 
 .clearfix::before,
 .clearfix::after {
-  content: " ";
+  content: "";
   display: table;
 }
 
@@ -235,14 +227,6 @@ textarea {
     page-break-inside: avoid;
   }
 
-  /*
-   * Printing Tables:
-   * https://web.archive.org/web/20180815150934/http://css-discuss.incutio.com/wiki/Printing_Tables
-   */
-  thead {
-    display: table-header-group;
-  }
-
   tr,
   img {
     page-break-inside: avoid;

dist/doc/TOC.md

@@ -1,37 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/)
-
-## Getting started
-
-* [Usage](usage.md) — Overview of the project contents.
-* [FAQ](faq.md) — Frequently asked questions along with their answers.
-
-## HTML5 Boilerplate core
-
-* [HTML](html.md) — Guide to the default HTML.
-* [CSS](css.md) — Guide to the default CSS.
-* [JavaScript](js.md) — Guide to the default JavaScript.
-* [Everything else](misc.md).
-
-## Development
-
-* [Extending and customizing HTML5 Boilerplate](extend.md) — Going further with
-  the boilerplate.
-
-## Related projects
-
-The [H5BP organization](https://github.com/h5bp) maintains several projects that
-complement HTML5 Boilerplate, projects that can help you improve different
-aspects of your website/web app (e.g.: the performance, security, etc.).
-
-* [Server Configs](https://github.com/h5bp/server-configs) — Fast and smart
-  configurations for web servers such as Apache and Nginx.
-  * [Apache](https://github.com/h5bp/server-configs-apache)
-  * [Google App Engine (GAE)](https://github.com/h5bp/server-configs-gae)
-  * [Internet Information Services
-    (IIS)](https://github.com/h5bp/server-configs-iis)
-  * [lighttpd](https://github.com/h5bp/server-configs-lighttpd)
-  * [Nginx](https://github.com/h5bp/server-configs-nginx)
-  * [Node.js](https://github.com/h5bp/server-configs-node)
-* [Front-end Developer Interview Questions](https://github.com/h5bp/Front-end-Developer-Interview-Questions)
-* [create-html5-boilerplate](https://github.com/h5bp/create-html5-boilerplate) — Quick start HTML5 Boilerplate development
-* [main.css](https://github.com/h5bp/main.css) — the main.css file included with HTML5 Boilerplate

dist/doc/css.md

@@ -1,44 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# The CSS
-
-HTML5 Boilerplate's CSS includes:
-
-* [Normalize.css](#normalizecss)
-* [main.css](#maincss)
-
-## 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/).
-
-## main.css
-
-Several base styles are included that build upon `Normalize.css`. These styles:
-
-* provide basic typography settings that improve text readability
-* protect against unwanted `text-shadow` during text highlighting
-* tweak the default alignment of some elements (e.g.: `img`, `video`,
-  `fieldset`, `textarea`)
-* style the prompt that is displayed to users using an outdated browser
-* and more...
-
-These styles are included in
-[main.css](https://github.com/h5bp/html5-boilerplate/blob/master/dist/css/main.css).
-See the [main.css](https://github.com/h5bp/main.css) project
-[documentation](https://github.com/h5bp/main.css/blob/master/README.md#features)
-for a full discussion of these styles.

dist/doc/extend.md

@@ -1,605 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com) | [Documentation
-table of contents](TOC.md)
-
-# Extend and customise HTML5 Boilerplate
-
-Here is some useful advice for how you can make your project with HTML5
-Boilerplate even better. We don't want to include it all by default, as not
-everything fits with everyone's needs.
-
-* [App Stores](#app-stores)
-* [DNS prefetching](#dns-prefetching)
-* [Google Universal Analytics](#google-universal-analytics)
-* [Internet Explorer](#internet-explorer)
-* [Miscellaneous](#miscellaneous)
-* [News Feeds](#news-feeds)
-* [Search](#search)
-* [Social Networks](#social-networks)
-* [URLs](#urls)
-* [Web Apps](#web-apps)
-* [security.txt](#security.txt)
-
-## App Stores
-
-### Smart App Banners in iOS 6+ Safari
-
-Stop bothering everyone with gross modals advertising your entry in the App
-Store. Including the following [meta
-tag](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/PromotingAppswithAppBanners/PromotingAppswithAppBanners.html)
-will unobtrusively give the user the option to download your iOS app, or open it
-with some data about the user's current state on the website.
-
-```html
-<meta name="apple-itunes-app" content="app-id=APP_ID,app-argument=SOME_TEXT">
-```
-
-## DNS prefetching
-
-In short, DNS Prefetching is a method of informing the browser of domain names
-referenced on a site so that the client can resolve the DNS for those hosts,
-cache them, and when it comes time to use them, have a faster turn around on the
-request.
-
-### Implicit prefetches
-
-There is a lot of prefetching done for you automatically by the browser. When
-the browser encounters an anchor in your html that does not share the same
-domain name as the current location the browser requests, from the client OS,
-the IP address for this new domain. The client first checks its cache and then,
-lacking a cached copy, makes a request from a DNS server. These requests happen
-in the background and are not meant to block the rendering of the page.
-
-The goal of this is that when the foreign IP address is finally needed it will
-already be in the client cache and will not block the loading of the foreign
-content. Fewer requests result in faster page load times. The perception of this
-is increased on a mobile platform where DNS latency can be greater.
-
-### Explicit prefetches
-
-Typically the browser only scans the HTML for foreign domains. If you have
-resources that are outside of your HTML (a javascript request to a remote server
-or a CDN that hosts content that may not be present on every page of your site,
-for example) then you can queue up a domain name to be prefetched.
-
-```html
-<link rel="dns-prefetch" href="//example.com">
-<link rel="dns-prefetch" href="https://ajax.googleapis.com">
-```
-
-You can use as many of these as you need, but it's best if they are all
-immediately after the [Meta
-Charset](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta#attr-charset)
-element (which should go right at the top of the `head`), so the browser can act
-on them ASAP.
-
-#### Common Prefetch Links
-
-Amazon S3:
-
-```html
-<link rel="dns-prefetch" href="//s3.amazonaws.com">
-```
-
-Google APIs:
-
-```html
-<link rel="dns-prefetch" href="https://ajax.googleapis.com">
-```
-
-Microsoft Ajax Content Delivery Network:
-
-```html
-<link rel="dns-prefetch" href="//ajax.microsoft.com">
-<link rel="dns-prefetch" href="//ajax.aspnetcdn.com">
-```
-
-### Further reading about DNS prefetching
-
-* https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-DNS-Prefetch-Control
-* https://dev.chromium.org/developers/design-documents/dns-prefetching
-* https://docs.microsoft.com/en-us/archive/blogs/ie/internet-explorer-9-network-performance-improvements
-
-## Google Universal Analytics
-
-### More tracking settings
-
-The [optimized Google Universal Analytics
-snippet](https://mathiasbynens.be/notes/async-analytics-snippet#universal-analytics)
-included with HTML5 Boilerplate includes something like this:
-
-```js
-ga('create', 'UA-XXXXX-X', 'auto'); ga('send', 'pageview');
-```
-
-To customize further, see Google's [Advanced
-Setup](https://developers.google.com/analytics/devguides/collection/analyticsjs/),
-[Pageview](https://developers.google.com/analytics/devguides/collection/analyticsjs/pages),
-and
-[Event](https://developers.google.com/analytics/devguides/collection/analyticsjs/events)
-Docs.
-
-### Track jQuery AJAX requests in Google Analytics
-
-An article by @JangoSteve explains how to [track jQuery AJAX requests in Google
-Analytics](https://www.alfajango.com/blog/track-jquery-ajax-requests-in-google-analytics/).
-
-Add this to `plugins.js`:
-
-```js
-/*
- * Log all jQuery AJAX requests to Google Analytics
- * See: https://www.alfajango.com/blog/track-jquery-ajax-requests-in-google-analytics/
- */
-if (typeof ga !== "undefined" && ga !== null) {
-    $(document).ajaxSend(function(event, xhr, settings){
-        ga('send', 'pageview', settings.url);
-    });
-}
-```
-
-### Track JavaScript errors in Google Analytics
-
-Add this function after `ga` is defined:
-
-```js
-(function(window){
-    var undefined,
-        link = function (href) {
-            var a = window.document.createElement('a');
-            a.href = href;
-            return a;
-        };
-    window.onerror = function (message, file, line, column) {
-        var host = link(file).hostname;
-        ga('send', {
-          'hitType': 'event',
-          'eventCategory': (host == window.location.hostname || host == undefined || host == '' ? '' : 'external ') + 'error',
-          'eventAction': message,
-          'eventLabel': (file + ' LINE: ' + line + (column ? ' COLUMN: ' + column : '')).trim(),
-          'nonInteraction': 1
-        });
-    };
-}(window));
-```
-
-### Track page scroll
-
-Add this function after `ga` is defined. Note, the following snippet requires jQuery.
-
-```js
-$(function(){
-    var isDuplicateScrollEvent,
-        scrollTimeStart = new Date,
-        $window = $(window),
-        $document = $(document),
-        scrollPercent;
-
-    $window.scroll(function() {
-        scrollPercent = Math.round(100 * ($window.height() + $window.scrollTop())/$document.height());
-        if (scrollPercent > 90 && !isDuplicateScrollEvent) { //page scrolled to 90%
-            isDuplicateScrollEvent = 1;
-            ga('send', 'event', 'scroll',
-                'Window: ' + $window.height() + 'px; Document: ' + $document.height() + 'px; Time: ' + Math.round((new Date - scrollTimeStart )/1000,1) + 's'
-            );
-        }
-    });
-});
-```
-
-## Internet Explorer
-
-### IE Pinned Sites
-
-Enabling your application for pinning will allow IE users to add it to their
-Windows Taskbar and Start Menu. This comes with a range of new tools that you
-can easily configure with the elements below. See more [documentation on IE
-Pinned
-Sites](https://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/samples/gg491731(v%3dvs.85)).
-
-### Name the Pinned Site for Windows
-
-Without this rule, Windows will use the page title as the name for your
-application.
-
-```html
-<meta name="application-name" content="Sample Title">
-```
-
-### Give your Pinned Site a tooltip
-
-You know — a tooltip. A little textbox that appears when the user holds their
-mouse over your Pinned Site's icon.
-
-```html
-<meta name="msapplication-tooltip" content="A description of what this site does.">
-```
-
-### Set a default page for your Pinned Site
-
-If the site should go to a specific URL when it is pinned (such as the
-homepage), enter it here. One idea is to send it to a special URL so you can
-track the number of pinned users, like so:
-`https://www.example.com/index.html?pinned=true`
-
-```html
-<meta name="msapplication-starturl" content="https://www.example.com/index.html?pinned=true">
-```
-
-### Recolor IE's controls manually for a Pinned Site
-
-IE will automatically use the overall color of your Pinned Site's favicon to
-shade its browser buttons. UNLESS you give it another color here. Only use named
-colors (`red`) or hex colors (`#ff0000`).
-
-```html
-<meta name="msapplication-navbutton-color" content="#ff0000">
-```
-
-### Manually set the window size of a Pinned Site
-
-If the site should open at a certain window size once pinned, you can specify
-the dimensions here. It only supports static pixel dimensions. 800x600 minimum.
-
-```html
-<meta name="msapplication-window" content="width=800;height=600">
-```
-
-### Jump List "Tasks" for Pinned Sites
-
-Add Jump List Tasks that will appear when the Pinned Site's icon gets a
-right-click. Each Task goes to the specified URL, and gets its own mini icon
-(essentially a favicon, a 16x16 .ICO). You can add as many of these as you need.
-
-```html
-<meta name="msapplication-task" content="name=Task 1;action-uri=http://host/Page1.html;icon-uri=http://host/icon1.ico">
-<meta name="msapplication-task" content="name=Task 2;action-uri=http://microsoft.com/Page2.html;icon-uri=http://host/icon2.ico">
-```
-
-### (Windows 8) High quality visuals for Pinned Sites
-
-Windows 8 adds the ability for you to provide a PNG tile image and specify the
-tile's background color. [Full details on the IE
-blog](https://docs.microsoft.com/en-us/archive/blogs/ie/high-quality-visuals-for-pinned-sites-in-windows-8).
-
-* Create a 144x144 image of your site icon, filling all of the canvas, and using
-  a transparent background.
-* Save this image as a 32-bit PNG and optimize it without reducing colour-depth.
-  It can be named whatever you want (e.g. `metro-tile.png`).
-* To reference the tile and its color, add the HTML `meta` elements described in
-  the IE Blog post.
-
-### (Windows 8) Badges for Pinned Sites
-
-IE will poll an XML document for badge information to display on your app's tile
-in the Start screen. The user will be able to receive these badge updates even
-when your app isn't actively running. The badge's value can be a number, or one
-of a predefined list of glyphs.
-
-* [Tutorial on IEBlog with link to badge XML
-schema](https://docs.microsoft.com/en-us/archive/blogs/ie/pinned-sites-in-windows-8)
-* [Available badge
-  values](https://docs.microsoft.com/en-us/uwp/schemas/tiles/badgeschema/element-badge)
-
-```html
-<meta name="msapplication-badge" value="frequency=NUMBER_IN_MINUTES;polling-uri=https://www.example.com/path/to/file.xml">
-```
-
-## Search
-
-### Direct search spiders to your sitemap
-
-After creating a [sitemap](https://www.sitemaps.org/protocol.html)
-
-Submit it to search engine tool:
-* [Google](https://www.google.com/webmasters/tools/sitemap-list)
-* [Bing](https://www.bing.com/toolbox/webmaster)
-* [Yandex](https://webmaster.yandex.com/)
-* [Baidu](https://zhanzhang.baidu.com/) OR Insert the following line anywhere in
-  your robots.txt file, specifying the path to your sitemap:
-```
-Sitemap: https://example.com/sitemap_location.xml
-```
-
-### Hide pages from search engines
-
-According to Heather Champ, former community manager at Flickr, you should not
-allow search engines to index your "Contact Us" or "Complaints" page if you
-value your sanity. This is an HTML-centric way of achieving that.
-
-```html
-<meta name="robots" content="noindex">
-```
-
-**_WARNING:_** DO NOT INCLUDE ON PAGES THAT SHOULD APPEAR IN SEARCH ENGINES.
-
-### Firefox and IE Search Plugins
-
-Sites with in-site search functionality should be strongly considered for a
-browser search plugin. A "search plugin" is an XML file which defines how your
-plugin behaves in the browser. [How to make a browser search
-plugin](https://www.google.com/search?ie=UTF-8&q=how+to+make+browser+search+plugin).
-
-```html
-<link rel="search" title="" type="application/opensearchdescription+xml" href="">
-```
-
-
-## Miscellaneous
-
-* Use
-  [polyfills](https://github.com/Modernizr/Modernizr/wiki/HTML5-Cross-browser-Polyfills).
-
-* Use [Microformats](http://microformats.org/wiki/Main_Page) (via
-  [microdata](http://microformats.org/wiki/microdata)) for optimum search
-  results
-  [visibility](https://webmasters.googleblog.com/2009/05/introducing-rich-snippets.html).
-
-* If you want to disable the translation prompt in Chrome or block Google
-  Translate from translating your web page, use [`<meta name="google"
-  content="notranslate">`](https://support.google.com/webmasters/answer/79812).
-  To disable translation for a particular section of the web page, add
-  [`class="notranslate"`](https://support.google.com/translate/?hl=en#2641276).
-
-* If you want to disable the automatic detection and formatting of possible
-  phone numbers in Safari on iOS, use [`<meta name="format-detection"
-  content="telephone=no">`](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html).
-
-* Avoid development/stage websites "leaking" into SERPs (search engine results
-  page) by [implementing X-Robots-tag
-  headers](https://github.com/h5bp/html5-boilerplate/issues/804).
-
-
-## News Feeds
-
-### RSS
-
-Have an RSS feed? Link to it here. Want to [learn how to write an RSS feed from
-scratch](https://www.rssboard.org/rss-specification)?
-
-```html
-<link rel="alternate" type="application/rss+xml" title="RSS" href="/rss.xml">
-```
-
-### Atom
-
-Atom is similar to RSS, and you might prefer to use it instead of or in addition
-to it. [See what Atom's all
-about](https://en.wikipedia.org/wiki/Atom_(Web_standard)).
-
-```html
-<link rel="alternate" type="application/atom+xml" title="Atom" href="/atom.xml">
-```
-
-### Pingbacks
-
-Your server may be notified when another site links to yours. The href attribute
-should contain the location of your pingback service.
-
-```html
-<link rel="pingback" href="">
-```
-
-* High-level explanation:
-  https://codex.wordpress.org/Introduction_to_Blogging#Pingbacks
-* Step-by-step example case:
-  https://www.hixie.ch/specs/pingback/pingback-1.0#TOC5
-* PHP pingback service:
-  https://web.archive.org/web/20131211032834/http://blog.perplexedlabs.com/2009/07/15/xmlrpc-pingbacks-using-php/
-
-
-
-## Social Networks
-
-### Facebook Open Graph data
-
-You can control the information that Facebook and others display when users
-share your site. Below are just the most basic data points you might need. For
-specific content types (including "website"), see [Facebook's built-in Open
-Graph content
-templates](https://developers.facebook.com/docs/sharing/opengraph/using-objects).
-Take full advantage of Facebook's support for complex data and activity by
-following the [Open Graph
-tutorial](https://developers.facebook.com/docs/sharing/webmasters/getting-started).
-
-For a reference of Open Graph's markup and properties, you may check [Facebook's
-Open Graph Protocol reference](https://ogp.me). Finally, you can validate your
-markup with the [Facebook Object
-Debugger](https://developers.facebook.com/tools/debug/) (needs registration to
-Facebook).
-
-```html
-<meta property="fb:app_id" content="123456789">
-<meta property="og:url" content="https://www.example.com/path/to/page.html">
-<meta property="og:type" content="website">
-<meta property="og:title" content="">
-<meta property="og:image" content="https://www.example.com/path/to/image.jpg">
-<meta property="og:description" content="">
-<meta property="og:site_name" content="">
-<meta property="article:author" content="">
-```
-
-### Twitter Cards
-
-Twitter provides a snippet specification that serves a similar purpose to Open
-Graph. In fact, Twitter will use Open Graph when Cards is not available. You can
-read more about the various snippet formats in the
-[official Twitter Cards
-documentation](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/overview/abouts-cards),
-and you can validate your markup with the [Card
-validator](https://cards-dev.twitter.com/validator) (needs registration to
-Twitter).
-
-```html
-<meta name="twitter:card" content="summary">
-<meta name="twitter:site" content="@site_account">
-<meta name="twitter:creator" content="@individual_account">
-<meta name="twitter:url" content="https://www.example.com/path/to/page.html">
-<meta name="twitter:title" content="">
-<meta name="twitter:description" content="">
-<meta name="twitter:image" content="https://www.example.com/path/to/image.jpg">
-```
-
-### Schema.org
-
-Google also provides a snippet specification that serves a similar purpose to
-Facebook's Open Graph or Twitter Cards. This metadata is a subset of
-[schema.org's microdata vocabulary](https://schema.org/), which covers many
-other schemas that can describe the content of your pages to search engines. For
-this reason, this metadata is more generic for SEO, notably for Google's
-search-engine, although this vocabulary is also used by Microsoft, Pinterest and
-Yandex.
-
-You can validate your markup with the [Structured Data Testing
-Tool](https://search.google.com/structured-data/testing-tool). Also, please
-note that this markup requires to add attributes to your top `html` tag.
-
-```html
-<html class="no-js" lang="" itemscope itemtype="https://schema.org/Article">
-  <head>
-
-    <link rel="author" href="">
-    <link rel="publisher" href="">
-    <meta itemprop="name" content="">
-    <meta itemprop="description" content="">
-    <meta itemprop="image" content="">
-```
-
-## URLs
-
-### Canonical URL
-
-Signal to search engines and others "Use this URL for this page!" Useful when
-parameters after a `#` or `?` is used to control the display state of a page.
-`https://www.example.com/cart.html?shopping-cart-open=true` can be indexed as
-the cleaner, more accurate `https://www.example.com/cart.html`.
-
-```html
-<link rel="canonical" href="">
-```
-
-### Separate mobile URLs
-
-If you use separate URLs for desktop and mobile users, you should consider
-helping search engine algorithms better understand the configuration on your web
-site.
-
-This can be done by adding the following annotations in your HTML pages:
-
-* on the desktop page, add the `link rel="alternate"` tag pointing to the
-  corresponding mobile URL, e.g.:
-
-  `<link rel="alternate" media="only screen and (max-width: 640px)"
-  href="https://m.example.com/page.html" >`
-
-* on the mobile page, add the `link rel="canonical"` tag pointing to the
-  corresponding desktop URL, e.g.:
-
-  `<link rel="canonical" href="https://www.example.com/page.html">`
-
-For more information please see:
-
-* https://developers.google.com/search/mobile-sites/mobile-seo/separate-urls
-
-
-## Web Apps
-
-There are a couple of meta tags that provide information about a web app when
-added to the Home Screen on iOS:
-
-* Adding `apple-mobile-web-app-capable` will make your web app chrome-less and
-  provide the default iOS app view. You can control the color scheme of the
-  default view by adding `apple-mobile-web-app-status-bar-style`.
-
-```html
-<meta name="apple-mobile-web-app-capable" content="yes">
-<meta name="apple-mobile-web-app-status-bar-style" content="black">
-```
-
-* You can use `apple-mobile-web-app-title` to add a specific sites name for the
-  Home Screen icon.
-
-```html
-<meta name="apple-mobile-web-app-title" content="">
-```
-
-For further information please read the [official
-documentation](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html)
-on Apple's site.
-
-
-### Apple Touch Icons
-
-Apple touch icons are used as icons when a user adds your webapp to the home
-screen of an iOS devices.
-
-Though the dimensions of the icon can vary between iOS devices and versions one
-`180×180px` touch icon named `icon.png` and including the following in the
-`<head>` of the page is enough:
-
-```html
-<link rel="apple-touch-icon" href="icon.png">
-```
-
-For a more comprehensive overview, please refer to Mathias' [article on Touch
-Icons](https://mathiasbynens.be/notes/touch-icons).
-
-
-### Apple Touch Startup Image
-
-Apart from that it is possible to add start-up screens for web apps on iOS. This
-basically works by defining `apple-touch-startup-image` with an according link
-to the image. Since iOS devices have different screen resolutions it maybe
-necessary to add media queries to detect which image to load. Here is an example
-for an iPhone:
-
-```html
-<link rel="apple-touch-startup-image" media="(max-device-width: 480px) and (-webkit-min-device-pixel-ratio: 2)" href="img/startup.png">
-```
-
-
-### Chrome Mobile web apps
-
-Chrome Mobile has a specific meta tag for making apps [installable to the
-homescreen](https://developer.chrome.com/multidevice/android/installtohomescreen)
-which tries to be a more generic replacement to Apple's proprietary meta tag:
-
-```html
-<meta name="mobile-web-app-capable" content="yes">
-```
-
-Same applies to the touch icons:
-
-```html
-<link rel="icon" sizes="192x192" href="highres-icon.png">
-```
-
-### Theme Color
-
-You can add the [`theme-color` meta
-extension](https://html.spec.whatwg.org/multipage/semantics.html#meta-theme-color)
-in the `<head>` of your pages to suggest the color that browsers and OSes should
-use if they customize the display of individual pages in their UIs with varying
-colors.
-
-```html
-<meta name="theme-color" content="#ff69b4">
-```
-
-The `content` attribute extension can take any valid CSS color.
-
-Currently, the `theme-color` meta extension is supported by [Chrome 39+ for
-Android
-Lollipop](https://developers.google.com/web/updates/2014/11/Support-for-theme-color-in-Chrome-39-for-Android).
-
-
-## security.txt
-
-When security risks in web services are discovered by users they often lack the
-channels to disclose them properly. As a result, security issues may be left
-unreported.
-
-Security.txt defines a standard to help organizations define the process for
-users to disclose security vulnerabilities securely. Include a text file on your
-server at `.well-known/security.txt` with the relevant contact details.
-
-Check [https://securitytxt.org/](https://securitytxt.org/) for more details.

dist/doc/faq.md

@@ -1,42 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# Frequently asked questions
-
-* [Why is the Google Analytics code at the bottom? Google recommends it be
-  placed in the
-  `<head>`.](#why-is-the-google-analytics-code-at-the-bottom-google-recommends-it-be-placed-in-the-head)
-* [Do I need to upgrade my site each time a new version of HTML5 Boilerplate is
-  released?](#do-i-need-to-upgrade-my-site-each-time-a-new-version-of-html5-boilerplate-is-released)
-* [Where can I get help with support
-  questions?](#where-can-i-get-help-with-support-questions)
-
----
-
-## Why is the Google Analytics code at the bottom? Google recommends it be placed in the `<head>`.
-
-The main advantage of placing it in the `<head>` is that you will track the
-user's `pageview` even if they leave the page before it has been fully loaded.
-
-Here's a handy quote from [Mathias
-Bynens](https://mathiasbynens.be/notes/async-analytics-snippet#comment-50) about
-our placement choice.
->I should point out that it’s Google — not me — recommending to place this
-script before all other scripts in the document. The only real advantage is to
-catch a pageView call if your page fails to load completely (for example, if the
-user aborts loading, or quickly closes the page, etc.). Personally, I wouldn’t
-count that as a page view, so I actually prefer to place this script at the
-bottom, after all other scripts. This keeps all the scripts together and
-reinforces that scripts at the bottom are the right move. (Usually I concatenate
-and minify all my scripts into one .js file — the GA snippet being the suffix.)
-
-## Do I need to upgrade my site each time a new version of HTML5 Boilerplate is released?
-
-No, just as you don't normally replace the foundation of a house once it was
-built. However, there is nothing stopping you from trying to work in the latest
-changes, but you'll have to assess the costs/benefits of doing so.
-
-## Where can I get help with support questions?
-
-Please ask for help on
-[StackOverflow](https://stackoverflow.com/questions/tagged/html5boilerplate).

dist/doc/html.md

@@ -1,253 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# The HTML
-
-By default, HTML5 Boilerplate provides two `html` pages:
-
-* [`index.html`](#indexhtml) - a default HTML skeleton that should form the
-  basis of all pages on your website
-* `404.html` - a placeholder 404 error page
-
-## `index.html`
-
-### The `no-js` Class
-
-The `no-js` class is provided in order to allow you to more easily and
-explicitly add custom styles based on whether JavaScript is disabled (`.no-js`)
-or enabled (`.js`). Using this technique also helps [avoid the
-FOUC](https://www.paulirish.com/2009/avoiding-the-fouc-v3/).
-
-### Language Attribute
-
-Please consider specifying the language of your content by adding a
-[value](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry)
-to the `lang` attribute in the `<html>` as in this example:
-
-```html
-<html class="no-js" lang="en">
-```
-
-### The order of the `<title>` and `<meta>` tags
-
-The charset declaration (`<meta charset="utf-8">`) must be included completely
-within the [first 1024 bytes of the
-document](https://html.spec.whatwg.org/multipage/semantics.html#charset)
-and should be specified as early as possible (before any content that could be
-controlled by an attacker, such as a `<title>` element) in order to avoid a
-potential [encoding-related security
-issue](https://code.google.com/archive/p/doctype-mirror/wikis/ArticleUtf7.wiki)
-in Internet Explorer
-
-### Meta Description
-
-The `description` meta tag provides a short description of the page. In some
-situations this description is used as a part of the snippet shown in the search
-results.
-
-```html
-<meta name="description" content="This is a description">
-```
-
-Google's [Create good meta
-descriptions](https://support.google.com/webmasters/answer/35624?hl=en#meta-descriptions)
-documentation has useful tips on creating an effective description.
-
-### Mobile Viewport
-
-There are a few different options that you can use with the [`viewport` meta
-tag](https://docs.google.com/present/view?id=dkx3qtm_22dxsrgcf4 "Viewport and
-Media Queries - The Complete Idiot's Guide"). You can find out more in [the MDN
-Web
-Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Mobile/Viewport_meta_tag).
-HTML5 Boilerplate comes with a simple setup that strikes a good balance for
-general use cases.
-
-```html
-<meta name="viewport" content="width=device-width, initial-scale=1">
-```
-
-If you want to take advantage of edge-to-edge displays of iPhone X/XS/XR you
-can do so with additional viewport parameters. [Check the WebKit
-blog](https://webkit.org/blog/7929/designing-websites-for-iphone-x/) for
-details.
-
-### Open Graph Metadata
-
-The [Open Graph Protocol](https://ogp.me/) allows you to define the way your
-site is presented when referenced on third party sites and applications
-(Facebook, Twitter, LinkedIn). The protocol provides a series of meta elements
-that define the details of your site. The required attributes define the title,
-preview image, URL, and [type](https://ogp.me/#types) (e.g., video, music,
-website, article).
-
-``` html
-<meta property="og:title" content="">
-<meta property="og:type" content="">
-<meta property="og:url" content="">
-<meta property="og:image" content="">
-```
-
-In addition to these four attributes there are many more attributes you can use
-to add more richness to the description of your site. This just represents the
-most basic implementation.
-
-To see a working example, the following is the open graph metadata for the HTML5
-Boilerplate site. In addition to the required fields we add `og:description` to
-describe the site in more detail.
-
-``` html
-<meta name="og:url" content="https://html5boilerplate.com/">
-<meta name="og:title" content="HTML5 ★ BOILERPLATE">
-<meta name="og:type" content="website">
-<meta name="og:description" content="The web’s most popular front-end template which helps you build fast, robust, and adaptable web apps or sites.">
-<meta name="og:image" content="https://html5boilerplate.com/icon.png">
-```
-
-### Web App Manifest
-
-HTML5 Boilerplate includes a simple web app manifest file.
-
-The web app manifest is a simple JSON file that allows you to control how your
-app appears on a device's home screen, what it looks like when it launches in
-that context and what happens when it is launched. This allows for much greater`
-control over the UI of a saved site or web app on a mobile device.
-
-It's linked to from the HTML as follows:
-
-```html
-<link rel="manifest" href="site.webmanifest">
-```
-
-Our
-[site.webmanifest](https://github.com/h5bp/html5-boilerplate/blob/master/src/site.webmanifest)
-contains a very skeletal "app" definition, just to show the basic usage. You
-should fill this file out with [more information about your site or
-application](https://developer.mozilla.org/en-US/docs/Web/Manifest)
-
-### Favicons and Touch Icon
-
-The shortcut icons should be put in the root directory of your site.
-`favicon.ico` is automatically picked up by browsers if it's placed in the root.
-HTML5 Boilerplate comes with a default set of icons (include favicon and one
-Apple Touch Icon) that you can use as a baseline to create your own.
-
-Please refer to the more detailed description in the [Extend section](extend.md)
-of these docs.
-
-### The Content Area
-
-The central part of the boilerplate template is pretty much empty. This is
-intentional, in order to make the boilerplate suitable for both web page and web
-app development.
-
-### Modernizr
-
-HTML5 Boilerplate uses a custom build of Modernizr.
-
-[Modernizr](https://modernizr.com/) is a JavaScript library which adds classes
-to the `html` element based on the results of feature test and which ensures
-that all browsers can make use of HTML5 elements (as it includes the HTML5
-Shiv). This allows you to target parts of your CSS and JavaScript based on the
-features supported by a browser.
-
-Starting with version 3 Modernizr can be customized using the
-[modernizr-config.json](https://github.com/h5bp/html5-boilerplate/blob/master/modernizr-config.json)
-and the [Modernizr command line
-utility](https://www.npmjs.com/package/modernizr-cli).
-
-### What About Polyfills?
-
-If you need to include
-[polyfills](https://remysharp.com/2010/10/08/what-is-a-polyfill) in your
-project, you must make sure those load before any other JavaScript. If you're
-using a polyfill CDN service, like [polyfill.io](https://polyfill.io/v3/), just put
-it before the other scripts in the bottom of the page:
-
-```html
-    <script src="js/vendor/modernizr-3.10.0.min.js"></script>
-    <script src="https://polyfill.io/v3/polyfill.min.js"></script>
-    <script src="js/plugins.js"></script>
-    <script src="js/main.js"></script>
-</body>
-```
-
-If you like to just include the polyfills yourself, you could include them in
-`js/plugins.js`. When you have a bunch of polyfills to load in, you could also
-create a `polyfills.js` file in the `js/vendor` directory or include the files
-individually and combine them using a build tool. Always ensure that the
-polyfills are all loaded before any other JavaScript.
-
-There are some misconceptions about Modernizr and polyfills. It's important to
-understand that Modernizr just handles feature checking, not polyfilling itself.
-The only thing Modernizr does regarding polyfills is that the team maintains [a
-huge list of cross Browser
-polyfills](https://github.com/Modernizr/Modernizr/wiki/HTML5-Cross-Browser-Polyfills).
-
-### jQuery
-
-As of v8.0.0 we no longer include jQuery by default. Web development has
-changed a lot since we started this project and while many millions of sites
-still use jQuery there are many sites and applications that don't. 10 years ago
-jQuery _was_ JavaScript for most developers. That's not the case any more so
-we've made the decision to remove jQuery from the project.
-
-If you're interested in including it, you can easily install jQuery using the
-following command:
-
-```
-npm install jQuery
-```
-
-You can then copy the minified file into the `vendor` folder and add jQuery
-to the `index.html` manually.
-
-To load jQuery from a CDN with a local fallback you can use the following:
-
-``` html
-<script src="https://code.jquery.com/jquery-3.5.1.min.js"  integrity="sha256-9/aliU8dGd2tb6OSsuzixeV4y/faTqgFtohetphbbj0=" crossorigin="anonymous"></script>
-<script>window.jQuery || document.write('<script src="js/vendor/jquery-3.5.1.min.js"><\/script>')</script>
-```
-
-### Google Universal Analytics Tracking Code
-
-Finally, an optimized version of the Google Universal Analytics tracking code is
-included.
-
-We use `analytics.js` rather than the newer `gtag.js` as [it's faster and
-supports tasks and
-plugins](https://github.com/philipwalton/analyticsjs-boilerplate/issues/19#issuecomment-333714370)
-
-Starting with version 8.0.0 we, by default, [anonymize IP
-addresses](https://support.google.com/analytics/answer/2763052). By
-default Google Analytics records the full IP address of a user visiting the
-site, but that full IP address is never available to the Google Analytics
-property admin. By anonymizing the IP address you can make your site more
-GDPR-compliant as a full IP address can be defined as PII (personally
-identifiable information.)
-
-The beacon transport mechanism is used to send all hits [which saves HTTP
-requests and improves
-performance](https://philipwalton.com/articles/the-google-analytics-setup-i-use-on-every-site-i-build/#loading-analytics.js).
-
-Google recommends that this script be placed at the top of the page. Factors to
-consider: if you place this script at the top of the page, you’ll be able to
-count users who don’t fully load the page, and you’ll incur the max number of
-simultaneous connections of the browser.
-
-Please be aware that while Google [states that it is fully GDPR compliant](https://privacy.google.com/businesses/compliance/),
-it is still possible to use analytics to violate GDPR.
-
-Further information:
-
-* [Introduction to
-  Analytics.js](https://developers.google.com/analytics/devguides/collection/analyticsjs/)
-* [Google Analytics Demos & Tools](https://ga-dev-tools.appspot.com/)
-* [Privacy Controls in Google Analytics](https://support.google.com/analytics/answer/9019185)
-
-**N.B.** The Google Analytics snippet is included by default mainly because
-Google Analytics is [currently one of the most popular tracking
-solutions](https://trends.builtwith.com/analytics/Google-Analytics) out there.
-However, its usage isn't set in stone, and you SHOULD consider exploring the
-[alternatives](https://en.wikipedia.org/wiki/List_of_web_analytics_software) and
-use whatever suits your needs best.

dist/doc/js.md

@@ -1,35 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# The JavaScript
-
-Information about the default JavaScript included in the project.
-
-## main.js
-
-This file can be used to contain or reference your site/app JavaScript code. If
-you're working on something more advanced you might replace this file entirely.
-That's cool.
-
-## plugins.js
-
-This file can be used to contain all your plugins, such as jQuery plugins and
-other 3rd party scripts for a simple site.
-
-One approach is to put jQuery plugins inside of a `(function($){ ...})(jQuery);`
-closure to make sure they're in the jQuery namespace safety blanket. Read more
-about [jQuery plugin authoring](https://learn.jquery.com/plugins/).
-
-By default the `plugins.js` file contains a small script to avoid `console`
-errors in browsers that lack a `console`. The script will make sure that, if a
-console method isn't available, that method will have the value of empty
-function, thus, preventing the browser from throwing an error.
-
-## vendor
-
-This directory can be used to contain all 3rd party library code.
-
-Our custom build of the Modernizr library is included by
-default. You may wish to create your own [custom Modernizr build with the online
-builder](https://modernizr.com/download/) or [command line
-tool](https://modernizr.com/docs#command-line-config).

dist/doc/misc.md

@@ -1,203 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# Miscellaneous
-
-* [.gitignore](#gitignore)
-* [.editorconfig](#editorconfig)
-* [Server Configuration](#server-configuration)
-* [robots.txt](#robotstxt)
-* [humans.txt](#humanstxt)
-* [browserconfig.xml](#browserconfigxml)
-* [package.json](#packagejson)
-
---
-
-## .gitignore
-
-HTML5 Boilerplate includes a basic project-level `.gitignore`. This should
-primarily be used to avoid certain project-level files and directories from
-being kept under source control. Different development-environments will
-benefit from different collections of ignores.
-
-OS-specific and editor-specific files should be ignored using a "global
-ignore" that applies to all repositories on your system.
-
-For example, add the following to your `~/.gitconfig`, where the `.gitignore`
-in your HOME directory contains the files and directories you'd like to
-globally ignore:
-
-```gitignore
-[core]
-    excludesfile = ~/.gitignore
-```
-
-* More on global ignores: [https://help.github.com/articles/ignoring-files/](https://help.github.com/en/github/using-git/ignoring-files)
-* Comprehensive set of ignores on GitHub: https://github.com/github/gitignore
-
-## .editorconfig
-
-The `.editorconfig` file is provided in order to encourage and help you and
-your team define and maintain consistent coding styles between different
-editors and IDEs.
-
-By default, `.editorconfig` includes some basic
-[properties](https://editorconfig.org/#supported-properties) that reflect the
-coding styles from the files provided by default, but you can easily change
-them to better suit your needs.
-
-In order for your editor/IDE to apply the
-[properties](https://editorconfig.org/#supported-properties) from the
-`.editorconfig` file, you may need to [install a
-plugin]( https://editorconfig.org/#download).
-
-__N.B.__ If you aren't using the server configurations provided by HTML5
-Boilerplate, we highly encourage you to configure your server to block
-access to `.editorconfig` files, as they can disclose sensitive information!
-
-For more details, please refer to the [EditorConfig
-project](https://editorconfig.org/).
-
-## Server Configuration
-
-H5BP includes a [`.htaccess`](#htaccess) file for the [Apache HTTP
-server](https://httpd.apache.org/docs/). If you are not using Apache
-as your web server, then you are encouraged to download a
-[server configuration](https://github.com/h5bp/server-configs) that
-corresponds to your web server and environment.
-
-A `.htaccess` (hypertext access) file is an [Apache HTTP server
-configuration file](https://github.com/h5bp/server-configs-apache).
-The `.htaccess` file is mostly used for:
-
-* Rewriting URLs
-* Controlling cache
-* Authentication
-* Server-side includes
-* Redirects
-* Gzipping
-
-If you have access to the main server configuration file (usually called
-`httpd.conf`), you should add the logic from the `.htaccess` file in, for
-example, a `<Directory>` section in the main configuration file. This is usually
-the recommended way, as using .htaccess files slows down Apache!
-
-To enable Apache modules locally, please see [the Apache modules documentation](https://github.com/h5bp/server-configs-apache#enable-apache-httpd-modules)
-
-In the repo the `.htaccess` is used for:
-
-* Allowing cross-origin access to web fonts
-* CORS header for images when browsers request it
-* Enable `404.html` as 404 error document
-* Making the website experience better for IE users better
-* Media UTF-8 as character encoding for `text/html` and `text/plain`
-* Enabling the rewrite URLs engine
-* Forcing or removing the `www.` at the begin of a URL
-* It blocks access to directories without a default document
-* It blocks access to files that can expose sensitive information.
-* It reduces MIME type security risks
-* It forces compressing (gzipping)
-* It tells the browser whether they should request a specific file from the
-  server or whether they should grab it from the browser's cache
-
-When using `.htaccess` we recommend reading all inline comments (the rules after
-a `#`) in the file once. There is a bunch of optional stuff in it.
-
-If you want to know more about the `.htaccess` file check out the
-[Apache HTTP server docs](https://httpd.apache.org/docs/) or more
-specifically the [htaccess
-section](https://httpd.apache.org/docs/current/howto/htaccess.html).
-
-Notice that the original repo for the `.htaccess` file is [this
-one](https://github.com/h5bp/server-configs-apache).
-
-## robots.txt
-
-The `robots.txt` file is used to give instructions to web robots on what can
-be crawled from the website.
-
-By default, the file provided by this project includes the next two lines:
-
-* `User-agent: *` -  the following rules apply to all web robots
-* `Disallow:` - everything on the website is allowed to be crawled
-
-If you want to disallow certain pages you will need to specify the path in a
-`Disallow` directive (e.g.: `Disallow: /path`) or, if you want to disallow
-crawling of all content, use `Disallow: /`.
-
-The `/robots.txt` file is not intended for access control, so don't try to
-use it as such. Think of it as a "No Entry" sign, rather than a locked door.
-URLs disallowed by the `robots.txt` file might still be indexed without being
-crawled, and the content from within the `robots.txt` file can be viewed by
-anyone, potentially disclosing the location of your private content! So, if
-you want to block access to private content, use proper authentication instead.
-
-For more information about `robots.txt`, please see:
-
-* [robotstxt.org](https://www.robotstxt.org/)
-* [How Google handles the `robots.txt` file](https://developers.google.com/search/reference/robots_txt)
-
-## humans.txt
-
-The `humans.txt` file is used to provide information about people involved with
-the website.
-
-The provided file contains three sections:
-
-* `TEAM` - this is intended to list the group of people responsible for the website
-* `THANKS` - this is intended to list the group of people that have contributed
-  to the website
-* `TECHNOLOGY COLOPHON` - the section lists technologies used to make the website
-
-For more information about `humans.txt`, please see: http://humanstxt.org/
-
-## browserconfig.xml
-
-The `browserconfig.xml` file is used to customize the tile displayed when users
-pin your site to the Windows 8.1 start screen. In there you can define custom
-tile colors, custom images or even [live tiles](https://docs.microsoft.com/previous-versions/windows/internet-explorer/ie-developer/samples/dn455106(v=vs.85)).
-
-By default, the file points to 2 placeholder tile images:
-
-* `tile.png` (558x558px): used for `Small`, `Medium` and `Large` tiles.
-  This image resizes automatically when necessary.
-* `tile-wide.png` (558x270px): user for `Wide` tiles.
-
-Notice that IE11 uses the same images when adding a site to the `favorites`.
-
-For more in-depth information about the `browserconfig.xml` file, please
-see [MSDN](https://docs.microsoft.com/previous-versions/windows/internet-explorer/ie-developer/platform-apis/dn320426(v=vs.85)).
-
-## package.json
-
-`package.json` is used to define attributes of your site or application for
-use in modern JavaScript development. [The full documentation is available](https://docs.npmjs.com/files/package.json)
-if you're interested. The fields we provide are as follows:
-
-* `title` - the title of your project. If you expect to publish your application
-  to npm, then the name needs to follow [certain guidelines](https://docs.npmjs.com/files/package.json#name)
-  and be unique.
-* `version` - indicates the version of your site application using semantic
-  versioning ([semver](https://docs.npmjs.com/misc/semver))
-* `description` - describes your site.
-* `scripts` - is a JavaScript object containing commands that can be run in a
-  node environment. There are many [built-in keys](https://docs.npmjs.com/misc/scripts)
-  related to the package lifecycle that node understands automatically. You can
-  also define custom scripts for use with your application development. We
-  provide three custom scripts that work with Parcel to get you up and running
-  quickly with a bundler for your assets and a simple development server.
-
-  * `start` builds your site and starts a server
-  * `build` builds your `index.html` using Parcel
-  * `dev` serves your `index.html` with a simple development server
-
-* `keywords` - an array of keywords used to discover your app in the npm
-  registry
-* `author` - defines the author of a package. There is also an alternative
-  [contributors](https://docs.npmjs.com/files/package.json#people-fields-author-contributors)
-  field if there's more than one author.
-* `license` - the license for your application. Must conform to
-  [specific rules](https://docs.npmjs.com/files/package.json#license)
-* `devDependencies` - development dependencies for your package. In our case
-  it's a single dependency, Parcel, which we use to bundle files and run a
-  simple web server.

dist/doc/usage.md

@@ -1,136 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# Usage
-
-The most basic usage of HTML5 Boilerplate is to create a static site or simple
-app. Once you've downloaded or cloned the project, that process looks something
-like this:
-
-1. Set up the basic structure of the site.
-2. Add some content, style, and functionality.
-3. Run your site locally to see how it looks.
-4. Deploy your site.
-
-Cool, right? _It is_. That said, the smart defaults, baseline elements, default
-attribute values and various other utilities that HTML5 Boilerplate offers can
-serve as the foundation for whatever you're interested in building.
-
-Even the basic use-case of a simple static site can be enhanced by manipulating
-the code through an automated build process. Moving up in complexity HTML5
-Boilerplate can be integrated with whatever front-end framework, CMS or
-e-commerce platform you're working with. Mix-and-match to your heart's content.
-Use what you need (toss it in a blender if you need to) and discard the rest.
-HTML5 Boilerplate is a starting point, not a destination.
-
-## Basic structure
-
-A basic HTML5 Boilerplate site initially looks something like this:
-
-```
-.
-├── css
-│   ├── main.css
-│   └── normalize.css
-├── doc
-├── img
-├── js
-│   ├── main.js
-│   ├── plugins.js
-│   └── vendor
-│       └── modernizr.min.js
-├── .editorconfig
-├── .htaccess
-├── 404.html
-├── browserconfig.xml
-├── favicon.ico
-├── humans.txt
-├── icon.png
-├── index.html
-├── package.json
-├── robots.txt
-├── site.webmanifest
-├── tile.png
-└── tile-wide.png
-```
-
-What follows is a general overview of each major part and how to use them.
-
-### css
-
-This directory should contain all your project's CSS files. It includes some
-initial CSS to help get you started from a solid foundation. [About the
-CSS](css.md).
-
-### doc
-
-This directory contains all the HTML5 Boilerplate documentation. You can use it
-as the location and basis for your own project's documentation.
-
-### js
-
-This directory should contain all your project's JS files. Libraries, plugins,
-and custom code can all be included here. It includes some initial JS to help
-get you started. [About the JavaScript](js.md).
-
-### .htaccess
-
-The default web server configs are for Apache. For more information, please
-refer to the [Apache Server Configs
-repository](https://github.com/h5bp/server-configs-apache).
-
-Host your site on a server other than Apache? You're likely to find the
-corresponding server configs project listed in our [Server
-Configs](https://github.com/h5bp/server-configs/blob/master/README.md)
-repository.
-
-### 404.html
-
-A helpful custom 404 to get you started.
-
-### browserconfig.xml
-
-This file contains all settings regarding custom tiles for IE11 and Edge.
-
-For more info on this topic, please refer to [Microsoft's
-Docs](https://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/dn320426(v=vs.85)).
-
-### .editorconfig
-
-The `.editorconfig` file is provided in order to encourage and help you and your
-team to maintain consistent coding styles between different editors and IDEs.
-[Read more about the `.editorconfig` file](misc.md#editorconfig).
-
-### index.html
-
-This is the default HTML skeleton that should form the basis of all pages on
-your site. If you are using a server-side templating framework, then you will
-need to integrate this starting HTML with your setup.
-
-Make sure that you update the URLs for the referenced CSS and JavaScript if you
-modify the directory structure at all.
-
-If you are using Google Universal Analytics, make sure that you edit the
-corresponding snippet at the bottom to include your analytics ID.
-
-### humans.txt
-
-Edit this file to include the team that worked on your site/app, and the
-technology powering it.
-
-### package.json
-
-Edit this file to describe your application, add dependencies, scripts and
-other properties related to node based development and the npm registry
-
-### robots.txt
-
-Edit this file to include any pages you need hidden from search engines.
-
-### Icons
-
-Replace the default `favicon.ico`, `tile.png`, `tile-wide.png` and Apple Touch
-Icon with your own.
-
-If you want to use different Apple Touch Icons for different resolutions please
-refer to the [according documentation](extend.md#apple-touch-icons).

dist/humans.txt

@@ -1,15 +0,0 @@
-# humanstxt.org/
-# The humans responsible & technology colophon
-
-# TEAM
-
-    <name> -- <role> -- <twitter>
-
-# THANKS
-
-    <name>
-
-# TECHNOLOGY COLOPHON
-
-    CSS3, HTML5
-    Apache Server Configs, jQuery, Modernizr, Normalize.css

dist/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" viewBox="0 0 192 192"><path fill="#e08524" d="M75.3 73.4H18.4l45.3 34.3L48.3 163l46.1-32.3 48.2 34.6-16.9-58.3 44.9-33.6H115l-20.5-55-19.2 55z"/><path d="m96.7 18.8 18.2 8.2 16.5 44.3h-15.1L96.7 18.8zm-47 146 18.7 9.9 42.6-29.9-16.5-11.4-44.8 31.4zm79.1-56.8 17.4 9.4 18.6 60.1-19.7-11.3-16.3-58.2z"/><path d="m173.1 74.3 17.8 9.2-44.7 34-17.4-9.4 44.3-33.8z"/></svg>

dist/index.html

@@ -1,24 +1,24 @@
 <!doctype html>
-<html class="no-js" lang="">
+<html lang="">
 
 <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="">
   <meta property="og:url" content="">
   <meta property="og:image" content="">
+  <meta property="og:image:alt" content="">
+
+  <link rel="icon" href="/favicon.ico" sizes="any">
+  <link rel="icon" href="/icon.svg" type="image/svg+xml">
+  <link rel="apple-touch-icon" href="icon.png">
 
   <link rel="manifest" href="site.webmanifest">
-  <link rel="apple-touch-icon" href="icon.png">
-  <!-- Place favicon.ico in the root directory -->
-
-  <link rel="stylesheet" href="css/normalize.css">
-  <link rel="stylesheet" href="css/main.css">
-
   <meta name="theme-color" content="#fafafa">
 </head>
 
@@ -26,16 +26,8 @@
 
   <!-- Add your site or application content here -->
   <p>Hello world! This is HTML5 Boilerplate.</p>
-  <script src="js/vendor/modernizr-3.11.2.min.js"></script>
-  <script src="js/plugins.js"></script>
-  <script src="js/main.js"></script>
+  <script src="js/app.js"></script>
 
-  <!-- Google Analytics: change UA-XXXXX-Y to be your site's ID. -->
-  <script>
-    window.ga = function () { ga.q.push(arguments) }; ga.q = []; ga.l = +new Date;
-    ga('create', 'UA-XXXXX-Y', 'auto'); ga('set', 'anonymizeIp', true); ga('set', 'transport', 'beacon'); ga('send', 'pageview')
-  </script>
-  <script src="https://www.google-analytics.com/analytics.js" async></script>
 </body>
 
 </html>

dist/js/plugins.js

@@ -1,24 +0,0 @@
-// Avoid `console` errors in browsers that lack a console.
-(function() {
-  var method;
-  var noop = function () {};
-  var methods = [
-    'assert', 'clear', 'count', 'debug', 'dir', 'dirxml', 'error',
-    'exception', 'group', 'groupCollapsed', 'groupEnd', 'info', 'log',
-    'markTimeline', 'profile', 'profileEnd', 'table', 'time', 'timeEnd',
-    'timeline', 'timelineEnd', 'timeStamp', 'trace', 'warn'
-  ];
-  var length = methods.length;
-  var console = (window.console = window.console || {});
-
-  while (length--) {
-    method = methods[length];
-
-    // Only stub undefined methods.
-    if (!console[method]) {
-      console[method] = noop;
-    }
-  }
-}());
-
-// Place any jQuery/helper plugins in here.

dist/package.json

@@ -2,16 +2,23 @@
   "name": " ",
   "version": "0.0.1",
   "description": "",
-  "keywords": "",
+  "private": true,
+  "keywords": [
+    ""
+  ],
   "license": "",
   "author": "",
   "scripts": {
-    "build": "parcel build index.html",
-    "dev": "parcel index.html --open",
-    "start": "npm run build && npm run dev",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "webpack serve --open --config webpack.config.dev.js",
+    "build": "webpack --config webpack.config.prod.js"
   },
   "devDependencies": {
-    "parcel-bundler": "^1.12.4"
+    "copy-webpack-plugin": "^13.0.1",
+    "html-webpack-plugin": "^5.6.4",
+    "webpack": "^5.101.3",
+    "webpack-cli": "^6.0.1",
+    "webpack-dev-server": "^5.2.2",
+    "webpack-merge": "^6.0.1"
   }
 }

dist/robots.txt

@@ -1,4 +1,4 @@
-# www.robotstxt.org/
+# https://www.robotstxt.org/
 
 # Allow crawling of all content
 User-agent: *

dist/webpack.common.js

@@ -0,0 +1,12 @@
+const path = require('path');
+
+module.exports = {
+  entry: {
+    app: './js/app.js',
+  },
+  output: {
+    path: path.resolve(__dirname, 'dist'),
+    clean: true,
+    filename: './js/app.js',
+  },
+};

dist/webpack.config.dev.js

@@ -0,0 +1,13 @@
+const { merge } = require('webpack-merge');
+const common = require('./webpack.common.js');
+
+module.exports = merge(common, {
+  mode: 'development',
+  devtool: 'inline-source-map',
+  devServer: {
+    liveReload: true,
+    hot: true,
+    open: true,
+    static: ['./'],
+  },
+});

dist/webpack.config.prod.js

@@ -0,0 +1,26 @@
+const { merge } = require('webpack-merge');
+const common = require('./webpack.common.js');
+const HtmlWebpackPlugin = require('html-webpack-plugin');
+const CopyPlugin = require('copy-webpack-plugin');
+
+module.exports = merge(common, {
+  mode: 'production',
+  plugins: [
+    new HtmlWebpackPlugin({
+      template: './index.html',
+    }),
+    new CopyPlugin({
+      patterns: [
+        { from: 'img', to: 'img' },
+        { from: 'css', to: 'css' },
+        { from: 'js/vendor', to: 'js/vendor' },
+        { from: 'icon.svg', to: 'icon.svg' },
+        { from: 'favicon.ico', to: 'favicon.ico' },
+        { from: 'robots.txt', to: 'robots.txt' },
+        { from: 'icon.png', to: 'icon.png' },
+        { from: '404.html', to: '404.html' },
+        { from: 'site.webmanifest', to: 'site.webmanifest' },
+      ],
+    }),
+  ],
+});

docs/TOC.md

@@ -0,0 +1,37 @@
+[HTML5 Boilerplate homepage](https://html5boilerplate.com/)
+
+## Getting started
+
+- [Usage](usage.md) — Overview of the project contents.
+- [FAQ](faq.md) — Frequently asked questions along with their answers.
+
+## HTML5 Boilerplate core
+
+- [HTML](html.md) — Guide to the default HTML.
+- [CSS](css.md) — Guide to the default CSS.
+- [JavaScript](js.md) — Guide to the default JavaScript.
+- [Everything else](misc.md).
+
+## Development
+
+- [Extending and customizing HTML5 Boilerplate](extend.md) — Going further with
+  the boilerplate.
+
+## Related projects
+
+The [H5BP organization](https://github.com/h5bp) maintains several projects that
+complement HTML5 Boilerplate, projects that can help you improve different
+aspects of your website/web app (e.g.: the performance, security, etc.).
+
+- [Server Configs](https://github.com/h5bp/server-configs) — Fast and smart
+  configurations for web servers such as Apache and Nginx.
+  - [Apache](https://github.com/h5bp/server-configs-apache)
+  - [Google App Engine (GAE)](https://github.com/h5bp/server-configs-gae)
+  - [Internet Information Services
+    (IIS)](https://github.com/h5bp/server-configs-iis)
+  - [lighttpd](https://github.com/h5bp/server-configs-lighttpd)
+  - [Nginx](https://github.com/h5bp/server-configs-nginx)
+  - [Node.js](https://github.com/h5bp/server-configs-node)
+- [Front-end Developer Interview Questions](https://github.com/h5bp/Front-end-Developer-Interview-Questions)
+- [create-html5-boilerplate](https://github.com/h5bp/create-html5-boilerplate) — Quick start HTML5 Boilerplate development.
+- [main.css](https://github.com/h5bp/main.css) — the main.css file included (as style.css) with HTML5 Boilerplate.

docs/about-this-repo.md

@@ -0,0 +1,115 @@
+# About This Repo
+
+This document outlines the configuration of this repo as well as the basic
+process we use to manage the project. As GitHub has matured as a platform
+and HTML5 Boilerplate has matured as a project there are a lot of lessons
+to be learned from the way we run the show here.
+
+## GitHub configuration
+
+This section will go through the way we configure the repo in GitHub.
+Open source projects get the full power of the platform and as a project
+we like to experiment with new GitHub features. Our current configuration
+might help you figure out some things you want to do in your own projects.
+
+### General Configuration
+
+This section outlines the basic configuration options we use.
+
+- We have a stub of a Wiki still, so we have wikis turned on. The most
+  interesting page that remains is a history of the project written several
+  years ago.
+- We use the Issues feature heavily. We don't yet have Issue Templates set
+  up, but we do have adding them as an issue, so we'll take advantage of them
+  at some point.
+- Discussions are enabled, but they haven't been very useful so far.
+
+### Pull Requests
+
+The most visible portion of our configuration is the way we handle pull
+requests. At the most basic level, we require pull requests to add code
+to the repo and require a review to merge code. In addition we run several
+code quality checks on every pull request to make sure we're not introducing
+anything we don't want into the codebase.
+
+We take advantage of the "draft" feature for PRs. This way we have visibility
+throughout the life of the PR.
+
+Let's take a look at how we configure our `main` branch.
+
+#### `main`
+
+`main` is the default branch and is our only protected branch. We use feature
+branches to add features and/or fix issues in the codebase. Other project
+configurations might require a long-running, similarly protected, `development`
+branch but for us the single protected `main` branch is enough for our
+purposes.
+
+Our branch protection rules are as follows:
+
+- We require a pull request (PR) with one approving reviewer to merge code
+- In addition to the PR and approving reviewer, we require three status checks
+  to pass before code can be merged
+  _ Build with Node 20
+  _ Build with Node 22
+  _ Build with Node 24
+- We _allow_ force pushes for project admins. While force pushes can create
+  some head scratching moments for people who have cloned the repo and update
+  before and after the force push, the ability to clean up the `HEAD` of a
+  public branch like this in an emergency is useful.
+
+#### GitHub Actions and Other Checks That Run on `main`
+
+- We run a simple _build status_ check. This is the most basic test you can run
+  and is absolutely vital. If you can't build your project you're in trouble.
+  Currently we're testing against Node 16 and 18.
+- We take advantage of our access to _CodeQL analysis_ Free for research and
+  open source don't you know :) We don't have a ton of surface area to cover,
+  but it's nice to have this powerful code scanning tool available to us.
+- We run a _dependency review_ scan to see if any newly added dependencies add
+  known security flaws. This is important for even us, but for a project that
+  uses a larger number of third party dependencies, this sort of check is vital.
+- We also run a CodeQL scans to check for security issues and problems.
+- We push any changes to `main` to our [HTML5\-Boilerplate Template Repo](https://github.com/h5bp/html5-boilerplate-template)
+
+Since we've talked about some of our Actions, let's look at the full configuration
+of our `.github` folder.
+
+### .github Folder
+
+- workflows
+  - `build-dist.yml` is currently broken. We can't push to `main` without a
+    code review, so this task is blocked. What I would like, (are you there,
+    GitHub, it's me, Rob) is to allow Actions to bypass branch protection
+    rules. I think we'll have to basically write a mini-bot that opens a PR
+    whenever there are changes to `main` and then pushes to the same branch
+    until the PR is closed. In some ways that will be better as it will be less
+    noisy in terms of bot pushes to main.
+  - `codeql-analysis.yml` controls our CodeQL action. We use the defaults. If
+    you're building something with more JavaScript footprint, you can tweak
+    the settings for this job.
+  - `dependency-review.yml` does what it says on the tin- it tests newly
+    introduced dependencies for vulnerabilities.
+  - `publish.yml` is the action that publishes all the various versions of
+    the project. When we create a new tag and push it to GitHub, this script
+    publishes our npm package and creates a GitHub release and attaches a zip
+    file of our `dist` folder.
+  - `push-to-template.yml` pushes the `HEAD` of `main` to our template repo
+  - `spellcheck.yml` automatically checks markdown files for typos with cSpell.
+  - `test.yml` runs our test suite on Ubuntu.
+  - `test-windows.yml` runs our test suite on Windows.
+- `CODE_OF_CONDUCT.md` is our Code of Conduct, based on
+  [Contributor Covenant.](https://www.contributor-covenant.org/)
+- `CONTRIBUTING.md` contains our contribution guidelines.
+- `ISSUE_TEMPLATE.md` is our new issue boilerplate.
+- `PULL_REQUEST_TEMPLATE.md` is our new PR boilerplate.
+- `SUPPORT.md` points people to different (non-HTML5-Boilerplate) support
+  resources
+- `dependabot.yml` is our Dependabot configuration. We do `npm`, monthly on
+  two separate `package.json` files, one in `src` and one in project root.
+
+---
+
+That covers most of the interesting GitHub features and functionality that we
+use. We're going to continue to keep this document up to date as we change
+things or new GitHub features.

docs/css.md

@@ -0,0 +1,22 @@
+[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
+table of contents](TOC.md)
+
+# The CSS
+
+HTML5 Boilerplate's CSS includes:
+
+- [style.css](#stylecss)
+
+## style.css
+
+Several base styles are included. These styles:
+
+- provide basic typography settings that improve text readability
+- protect against unwanted `text-shadow` during text highlighting
+- tweak the default alignment of some elements (e.g.: `img`, `video`,
+  `fieldset`, `textarea`)
+- style the prompt that is displayed to users using an outdated browser
+- and more...
+
+These styles are included in
+[style.css](https://github.com/h5bp/html5-boilerplate/blob/main/dist/css/style.css).

docs/extend.md

@@ -0,0 +1,363 @@
+[HTML5 Boilerplate homepage](https://html5boilerplate.com) | [Documentation
+table of contents](TOC.md)
+
+# Extend and customize HTML5 Boilerplate
+
+Here is some useful advice for how you can make your project with HTML5
+Boilerplate even better. We don't want to include it all by default, as not
+everything fits with everyone's needs.
+
+- [Server Configuration](#server-configuration)
+- [App Stores](#app-stores)
+- [DNS prefetching](#dns-prefetching)
+- [Miscellaneous](#miscellaneous)
+- [News Feeds](#news-feeds)
+- [Search](#search)
+- [Social Networks](#social-networks)
+- [URLs](#urls)
+- [Web Apps](#web-apps)
+- [security.txt](#securitytxt)
+
+## Server Configuration
+
+We no longer include a [`.htaccess`](#htaccess) file for the [Apache HTTP
+server](https://httpd.apache.org/docs/) in HTML5 Boilerplate by default, however if you are
+using a web server, then we encourage you to checkout out the [server configuration](https://github.com/h5bp/server-configs)
+that corresponds to your web server and environment.
+
+These repos offer a collection of configuration snippets that can help your server improve the
+website's performance and security, while also ensuring that resources are served with the
+correct content-type and are accessible, if needed, even cross-domain.
+
+## App Stores
+
+### Smart App Banners in iOS 6+ Safari
+
+Stop bothering everyone with gross modals advertising your entry in the App
+Store. Including the following [meta
+tag](https://developer.apple.com/documentation/webkit/promoting_apps_with_smart_app_banners)
+will unobtrusively give the user the option to download your iOS app, or open it
+with some data about the user's current state on the website.
+
+```html
+<meta name="apple-itunes-app" content="app-id=APP_ID,app-argument=SOME_TEXT">
+```
+
+## DNS prefetching
+
+In short, DNS Prefetching is a method of informing the browser of domain names
+referenced on a site so that the client can resolve the DNS for those hosts,
+cache them, and when it comes time to use them, have a faster turn around on the
+request.
+
+### Implicit prefetches
+
+There is a lot of prefetching done for you automatically by the browser. When
+the browser encounters an anchor in your HTML that does not share the same
+domain name as the current location the browser requests, from the client OS,
+the IP address for this new domain. The client first checks its cache and then,
+lacking a cached copy, makes a request from a DNS server. These requests happen
+in the background and are not meant to block the rendering of the page.
+
+The goal of this is that when the foreign IP address is finally needed it will
+already be in the client cache and will not block the loading of the foreign
+content. Fewer requests result in faster page load times. The perception of this
+is increased on a mobile platform where DNS latency can be greater.
+
+### Explicit prefetches
+
+Typically the browser only scans the HTML for foreign domains. If you have
+resources that are outside of your HTML (a JavaScript request to a remote server
+or a CDN that hosts content that may not be present on every page of your site,
+for example) then you can queue up a domain name to be prefetched.
+
+```html
+<link rel="dns-prefetch" href="//example.com">
+<link rel="dns-prefetch" href="https://ajax.googleapis.com">
+```
+
+You can use as many of these as you need, but it's best if they are all
+immediately after the [Meta
+Charset](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta#attr-charset)
+element (which should go right at the top of the `head`), so the browser can act
+on them ASAP.
+
+### Further reading about DNS prefetching
+
+- https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-DNS-Prefetch-Control
+- https://dev.chromium.org/developers/design-documents/dns-prefetching
+
+## Search
+
+### Direct search spiders to your sitemap
+
+After creating a [sitemap](https://www.sitemaps.org/protocol.html)
+
+Submit it to search engine tool:
+
+- [Google](https://www.google.com/webmasters/tools/sitemap-list)
+- [Bing](https://www.bing.com/toolbox/webmaster)
+- [Yandex](https://webmaster.yandex.com/)
+- [Baidu](https://zhanzhang.baidu.com/) OR Insert the following line anywhere in
+  your robots.txt file, specifying the path to your sitemap:
+
+```
+Sitemap: https://example.com/sitemap_location.xml
+```
+
+### Hide pages from search engines
+
+According to Heather Champ, former community manager at Flickr, you should not
+allow search engines to index your "Contact Us" or "Complaints" page if you
+value your sanity. This is an HTML-centric way of achieving that.
+
+```html
+<meta name="robots" content="noindex">
+```
+
+**_WARNING:_** DO NOT INCLUDE ON PAGES THAT SHOULD APPEAR IN SEARCH ENGINES.
+
+### Search Plugins
+
+Sites with in-site search functionality should be strongly considered for a
+browser search plugin. A "search plugin" is an XML file which defines how your
+plugin behaves in the browser. [How to make a browser search
+plugin](https://developer.mozilla.org/en-US/docs/Web/OpenSearch).
+
+```html
+<link rel="search" title="" type="application/opensearchdescription+xml" href="">
+```
+
+## Miscellaneous
+
+- Use [Microformats](https://microformats.org/wiki/Main_Page) (via
+  [microdata](https://microformats.org/wiki/microdata)) for optimum search
+  results
+  [visibility](https://developers.google.com/search/blog/2009/05/introducing-rich-snippets).
+
+- If you want to disable the translation prompt in Chrome or block Google
+  Translate from translating your web page, use [`<meta name="google"
+content="notranslate">`](https://developers.google.com/search/docs/crawling-indexing/special-tags).
+  To disable translation for a particular section of the web page, add
+  [`class="notranslate"`](https://support.google.com/translate/?hl=en#2641276).
+
+- If you want to disable the automatic detection and formatting of possible
+  phone numbers in Safari on iOS, use [`<meta name="format-detection"
+content="telephone=no">`](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html).
+
+- Avoid development/stage websites "leaking" into SERPs (search engine results
+  page) by [implementing X-Robots-tag
+  headers](https://github.com/h5bp/html5-boilerplate/issues/804).
+
+- Apply JavaScript-dependent CSS styles using [the `scripting` media
+  feature](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/scripting).
+  Use `@media (scripting: none) { ... }` to target browsers with JavaScript
+  disabled, or `@media (scripting: enabled) { ... }` to target browsers with
+  JavaScript enabled. Using this technique also helps [avoid the
+  FOUC](https://www.paulirish.com/2009/avoiding-the-fouc-v3/).
+
+## News Feeds
+
+### RSS
+
+Have an RSS feed? Link to it here. Want to [learn how to write an RSS feed from
+scratch](https://www.rssboard.org/rss-specification)?
+
+```html
+<link rel="alternate" type="application/rss+xml" title="RSS" href="/rss.xml">
+```
+
+### Atom
+
+Atom is similar to RSS, and you might prefer to use it instead of or in addition
+to it. [See what Atom's all
+about](<https://en.wikipedia.org/wiki/Atom_(Web_standard)>).
+
+```html
+<link rel="alternate" type="application/atom+xml" title="Atom" href="/atom.xml">
+```
+
+### Pingbacks
+
+Your server may be notified when another site links to yours. The href attribute
+should contain the location of your pingback service.
+
+```html
+<link rel="pingback" href="">
+```
+
+- High-level explanation:
+  https://codex.wordpress.org/Introduction_to_Blogging#Pingbacks
+- Step-by-step example case:
+  https://www.hixie.ch/specs/pingback/pingback-1.0#TOC5
+- PHP pingback service:
+  https://web.archive.org/web/20131211032834/http://blog.perplexedlabs.com/2009/07/15/xmlrpc-pingbacks-using-php/
+
+## Social Networks
+
+### Facebook Open Graph data
+
+You can control the information that Facebook and others display when users
+share your site. Below are just the most basic data points you might need. For
+specific content types (including "website"), see [Facebook's built-in Open
+Graph content
+templates](https://developers.facebook.com/docs/sharing/opengraph/using-objects).
+Take full advantage of Facebook's support for complex data and activity by
+following the [Open Graph
+tutorial](https://developers.facebook.com/docs/sharing/webmasters/getting-started).
+
+For a reference of Open Graph's markup and properties, you may check [Facebook's
+Open Graph Protocol reference](https://ogp.me). Finally, you can validate your
+markup with the [Facebook Object
+Debugger](https://developers.facebook.com/tools/debug/) (needs registration to
+Facebook).
+
+```html
+<meta property="fb:app_id" content="123456789">
+<meta property="og:url" content="https://www.example.com/path/to/page.html">
+<meta property="og:type" content="website">
+<meta property="og:title" content="">
+<meta property="og:image" content="https://www.example.com/path/to/image.jpg">
+<!-- Empty for decorative images. -->
+<meta property="og:image:alt" content="Example image depicting...">
+<meta property="og:description" content="">
+<meta property="og:site_name" content="">
+<meta property="article:author" content="">
+```
+
+### Twitter Cards
+
+Twitter provides a snippet specification that serves a similar purpose to Open
+Graph. In fact, Twitter will use Open Graph when Cards is not available. You can
+read more about the various snippet formats in the
+[official Twitter Cards
+documentation](https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/abouts-cards).
+
+```html
+<meta name="twitter:card" content="summary">
+<meta name="twitter:site" content="@site_account">
+<meta name="twitter:creator" content="@individual_account">
+<meta name="twitter:url" content="https://www.example.com/path/to/page.html">
+<meta name="twitter:title" content="">
+<meta name="twitter:description" content="">
+<meta name="twitter:image" content="https://www.example.com/path/to/image.jpg">
+```
+
+### Schema.org
+
+Google also provides a snippet specification that serves a similar purpose to
+Facebook's Open Graph or Twitter Cards. This metadata is a subset of
+[schema.org's microdata vocabulary](https://schema.org/), which covers many
+other schemas that can describe the content of your pages to search engines. For
+this reason, this metadata is more generic for SEO, notably for Google's
+search-engine, although this vocabulary is also used by Microsoft, Pinterest and
+Yandex.
+
+You can validate your markup with the [Structured Data Testing
+Tool](https://developers.google.com/search/docs/appearance/structured-data). Also, please
+note that this markup requires to add attributes to your top `html` tag.
+
+```html
+<html lang="" itemscope itemtype="https://schema.org/Article">
+  <head>
+
+    <link rel="author" href="">
+    <link rel="publisher" href="">
+    <meta itemprop="name" content="">
+    <meta itemprop="description" content="">
+    <meta itemprop="image" content="">
+```
+
+## URLs
+
+### Canonical URL
+
+Signal to search engines and others "Use this URL for this page!" Useful when
+parameters after a `#` or `?` is used to control the display state of a page.
+`https://www.example.com/cart.html?shopping-cart-open=true` can be indexed as
+the cleaner, more accurate `https://www.example.com/cart.html`.
+
+```html
+<link rel="canonical" href="">
+```
+
+## Web Apps
+
+There are a couple of meta tags that provide information about a web app when
+added to the Home Screen on iOS:
+
+- Adding `apple-mobile-web-app-capable` will make your web app chrome-less and
+  provide the default iOS app view. You can control the color scheme of the
+  default view by adding `apple-mobile-web-app-status-bar-style`.
+
+```html
+<meta name="apple-mobile-web-app-capable" content="yes">
+<meta name="apple-mobile-web-app-status-bar-style" content="black">
+```
+
+- You can use `apple-mobile-web-app-title` to add a specific sites name for the
+  Home Screen icon.
+
+```html
+<meta name="apple-mobile-web-app-title" content="">
+```
+
+For further information please read the [official
+documentation](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html)
+on Apple's site.
+
+### Apple Touch Icons
+
+Apple touch icons are used as icons when a user adds your webapp to the home
+screen of an iOS devices.
+
+Though the dimensions of the icon can vary between iOS devices and versions one
+`180×180px` touch icon named `icon.png` and including the following in the
+`<head>` of the page is enough:
+
+```html
+<link rel="apple-touch-icon" href="icon.png">
+```
+
+For a more comprehensive overview, please refer to Mathias' [article on Touch
+Icons](https://mathiasbynens.be/notes/touch-icons).
+
+### Apple Touch Startup Image
+
+Apart from that it is possible to add start-up screens for web apps on iOS. This
+basically works by defining `apple-touch-startup-image` with an according link
+to the image. Since iOS devices have different screen resolutions it maybe
+necessary to add media queries to detect which image to load. Here is an example
+for an iPhone:
+
+```html
+<link rel="apple-touch-startup-image" media="(max-device-width: 480px) and (-webkit-min-device-pixel-ratio: 2)" href="img/startup.png">
+```
+
+### Theme Color
+
+You can add the [`theme-color` meta
+extension](https://html.spec.whatwg.org/multipage/semantics.html#meta-theme-color)
+in the `<head>` of your pages to suggest the color that browsers and OSes should
+use if they customize the display of individual pages in their UIs with varying
+colors.
+
+```html
+<meta name="theme-color" content="#ff69b4">
+```
+
+The `content` attribute extension can take any valid CSS color.
+
+For browser support details, refer to [Can I Use](https://caniuse.com/meta-theme-color).
+
+### security.txt
+
+When security risks in web services are discovered by users they often lack the
+channels to disclose them properly. As a result, security issues may be left
+unreported.
+
+Security.txt defines a standard to help organizations define the process for
+users to disclose security vulnerabilities securely. Include a text file on your
+server at `.well-known/security.txt` with the relevant contact details.
+
+Check [https://securitytxt.org/](https://securitytxt.org/) for more details.

docs/faq.md

@@ -0,0 +1,15 @@
+[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
+table of contents](TOC.md)
+
+# Frequently asked questions
+
+## Do I need to upgrade my site each time a new version of HTML5 Boilerplate is released?
+
+No, just as you don't normally replace the foundation of a house once it was
+built. However, there is nothing stopping you from trying to work in the latest
+changes, but you'll have to assess the costs/benefits of doing so.
+
+## Where can I get help with support questions?
+
+Please ask for help on
+[Stack Overflow](https://stackoverflow.com/questions/tagged/html5boilerplate).

docs/html.md

@@ -0,0 +1,132 @@
+[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
+table of contents](TOC.md)
+
+# The HTML
+
+By default, HTML5 Boilerplate provides two `html` pages:
+
+- [`index.html`](#indexhtml) - a default HTML skeleton that should form the
+  basis of all pages on your website
+- `404.html` - a placeholder 404 error page
+
+## `index.html`
+
+### Language Attribute
+
+Please consider specifying the language of your content by adding a
+[value](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry)
+to the `lang` attribute in the `<html>` as in this example:
+
+```html
+<html lang="en">
+```
+
+### The order of the `<title>` and `<meta>` tags
+
+The charset declaration (`<meta charset="utf-8">`) must be included completely
+within the
+[first 1024 bytes of the document](https://html.spec.whatwg.org/multipage/semantics.html#charset)
+and should be specified as early as possible.
+
+### Meta Description
+
+The `description` meta tag provides a short description of the page. In some
+situations this description is used as a part of the snippet shown in the search
+results.
+
+```html
+<meta name="description" content="This is a description">
+```
+
+Google's
+[Create good meta descriptions](https://support.google.com/webmasters/answer/35624?hl=en#meta-descriptions)
+documentation has useful tips on creating an effective description.
+
+### Mobile Viewport
+
+There are a few different options that you can use with the
+[`viewport` meta tag](https://docs.google.com/present/view?id=dkx3qtm_22dxsrgcf4 "Viewport and Media Queries - The Complete Idiot's Guide").
+You can find out more in [
+the MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag).
+HTML5 Boilerplate comes with a simple setup that strikes a good balance for general use cases.
+
+```html
+<meta name="viewport" content="width=device-width, initial-scale=1">
+```
+
+If you want to take advantage of edge-to-edge displays of iPhone X/XS/XR you
+can do so with additional viewport parameters.
+[Check the WebKit blog](https://webkit.org/blog/7929/designing-websites-for-iphone-x/) for
+details.
+
+### Open Graph Metadata
+
+The [Open Graph Protocol](https://ogp.me) allows you to define the way your
+site is presented when referenced on third party sites and applications
+(Facebook, Twitter, LinkedIn). The protocol provides a series of meta elements
+that define the details of your site. The required attributes define the title,
+preview image, URL, and [type](https://ogp.me/#types) (e.g., video, music,
+website, article).
+
+```html
+<meta property="og:title" content="">
+<meta property="og:type" content="">
+<meta property="og:url" content="">
+<meta property="og:image" content="">
+<meta property="og:image:alt" content="">
+```
+
+In addition to these four attributes there are many more attributes you can use
+to add more richness to the description of your site. This just represents the
+most basic implementation.
+
+To see a working example, the following is the open graph metadata for the HTML5
+Boilerplate site. In addition to the required fields we add `og:description` to
+describe the site in more detail.
+
+```html
+<meta property="og:url" content="https://html5boilerplate.com/">
+<meta property="og:title" content="HTML5 ★ BOILERPLATE">
+<meta property="og:type" content="website">
+<meta property="og:description" content="The web’s most popular front-end template which helps you build fast, robust, and adaptable web apps or sites.">
+<meta property="og:image" content="https://html5boilerplate.com/icon.png">
+<!-- Empty for decorative images. -->
+<meta property="og:image:alt" content="">
+```
+
+### Web App Manifest
+
+HTML5 Boilerplate includes a simple web app manifest file.
+
+The web app manifest is a simple JSON file that allows you to control how your
+app appears on a device's home screen, what it looks like when it launches in
+that context and what happens when it is launched. This allows for much greater
+control over the UI of a saved site or web app on a mobile device.
+
+It's linked to from the HTML as follows:
+
+```html
+<link rel="manifest" href="site.webmanifest">
+```
+
+Our
+[site.webmanifest](https://github.com/h5bp/html5-boilerplate/blob/main/src/site.webmanifest)
+contains a very skeletal "app" definition, just to show the basic usage. You
+should fill this file out with
+[more information about your site or application](https://developer.mozilla.org/en-US/docs/Web/Manifest)
+
+### Favicons and Touch Icon
+
+The shortcut icons should be put in the root directory of your site.
+`favicon.ico` is automatically picked up by browsers if it's placed in the root.
+HTML5 Boilerplate comes with a default set of icons (include favicon and one
+Apple Touch Icon) that you can use as a baseline to create your own.
+
+Please refer to the more detailed description in the [Extend section](extend.md)
+of these docs.
+
+### The Content Area
+
+The central part of the boilerplate template is pretty much empty. This is
+intentional, in order to make the boilerplate suitable for both web page and web
+app development.

docs/js.md

@@ -0,0 +1,16 @@
+[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
+table of contents](TOC.md)
+
+# The JavaScript
+
+Information about the default JavaScript included in the project.
+
+## app.js
+
+This file can be used to contain or reference your site/app JavaScript code. If
+you're working on something more advanced you might replace this file entirely.
+That's cool.
+
+## vendor
+
+This directory can be used to contain all third-party library code.

docs/misc.md

@@ -0,0 +1,113 @@
+[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
+table of contents](TOC.md)
+
+# Miscellaneous
+
+- [.gitignore](#gitignore)
+- [.editorconfig](#editorconfig)
+- [robots.txt](#robotstxt)
+- [package.json](#packagejson)
+
+--
+
+## .gitignore
+
+HTML5 Boilerplate includes a basic project-level `.gitignore`. This should
+primarily be used to avoid certain project-level files and directories from
+being kept under source control. Different development-environments will
+benefit from different collections of ignores.
+
+OS-specific and editor-specific files should be ignored using a "global
+ignore" that applies to all repositories on your system.
+
+For example, add the following to your `~/.gitconfig`, where the `.gitignore`
+in your HOME directory contains the files and directories you'd like to
+globally ignore:
+
+```gitignore
+[core]
+    excludesfile = ~/.gitignore
+```
+
+- More on global ignores: [https://help.github.com/articles/ignoring-files/](https://help.github.com/en/github/using-git/ignoring-files)
+- Comprehensive set of ignores on GitHub: https://github.com/github/gitignore
+
+## .editorconfig
+
+The `.editorconfig` file is provided in order to encourage and help you and
+your team define and maintain consistent coding styles between different
+editors and IDEs.
+
+By default, `.editorconfig` includes some basic
+[properties](https://editorconfig.org/#supported-properties) that reflect the
+coding styles from the files provided by default, but you can easily change
+them to better suit your needs.
+
+In order for your editor/IDE to apply the
+[properties](https://editorconfig.org/#supported-properties) from the
+`.editorconfig` file, you may need to [install a
+plugin](https://editorconfig.org/#download).
+
+**N.B.** If you aren't using the server configurations provided by HTML5
+Boilerplate, we highly encourage you to configure your server to block
+access to `.editorconfig` files, as they can disclose sensitive information!
+
+For more details, please refer to the [EditorConfig
+project](https://editorconfig.org/).
+
+## robots.txt
+
+The `robots.txt` file is used to give instructions to web robots on what can
+be crawled from the website.
+
+By default, the file provided by this project includes the next two lines:
+
+- `User-agent: *` - the following rules apply to all web robots
+- `Disallow:` - everything on the website is allowed to be crawled
+
+If you want to disallow certain pages you will need to specify the path in a
+`Disallow` directive (e.g.: `Disallow: /path`) or, if you want to disallow
+crawling of all content, use `Disallow: /`.
+
+The `/robots.txt` file is not intended for access control, so don't try to
+use it as such. Think of it as a "No Entry" sign, rather than a locked door.
+URLs disallowed by the `robots.txt` file might still be indexed without being
+crawled, and the content from within the `robots.txt` file can be viewed by
+anyone, potentially disclosing the location of your private content! So, if
+you want to block access to private content, use proper authentication instead.
+
+For more information about `robots.txt`, please see:
+
+- [robotstxt.org](https://www.robotstxt.org/)
+- [How Google handles the `robots.txt` file](https://developers.google.com/search/reference/robots_txt)
+
+## package.json
+
+`package.json` is used to define attributes of your site or application for
+use in modern JavaScript development. [The full documentation is available](https://docs.npmjs.com/files/package.json)
+if you're interested. The fields we provide are as follows:
+
+- `title` - the title of your project. If you expect to publish your application
+  to npm, then the name needs to follow [certain guidelines](https://docs.npmjs.com/files/package.json#name)
+  and be unique.
+- `version` - indicates the version of your site application using semantic
+  versioning ([SemVer](https://semver.org/))
+- `description` - describes your site.
+- `scripts` - is a JavaScript object containing commands that can be run in a
+  node environment. There are many [built-in keys](https://docs.npmjs.com/misc/scripts)
+  related to the package lifecycle that node understands automatically. You can
+  also define custom scripts for use with your application development. We
+  provide three custom scripts that work with webpack to get you up and running
+  quickly with a bundler for your assets and a simple development server.
+
+  - `start` serves your `index.html` with a simple development server
+
+- `keywords` - an array of keywords used to discover your app in the npm
+  registry
+- `author` - defines the author of a package. There is also an alternative
+  [contributors](https://docs.npmjs.com/files/package.json#people-fields-author-contributors)
+  field if there's more than one author.
+- `license` - the license for your application. Must conform to
+  [specific rules](https://docs.npmjs.com/files/package.json#license)
+- `devDependencies` - development dependencies for your package. In our case
+  we have several dependencies used by webpack, which we use as a simple development server.

docs/usage.md

@@ -30,28 +30,24 @@ A basic HTML5 Boilerplate site initially looks something like this:
 ```
 .
 ├── css
-│   ├── main.css
-│   └── normalize.css
+│   └── style.css
 ├── doc
 ├── img
 ├── js
-│   ├── main.js
-│   ├── plugins.js
-│   └── vendor
-│       └── modernizr.min.js
+│   ├── app.js
+    └── vendor
 ├── .editorconfig
-├── .htaccess
 ├── 404.html
-├── browserconfig.xml
 ├── favicon.ico
-├── humans.txt
 ├── icon.png
+├── icon.svg
 ├── index.html
 ├── package.json
 ├── robots.txt
 ├── site.webmanifest
-├── tile.png
-└── tile-wide.png
+└── webpack.common.js
+└── webpack.config.dev.js
+└── webpack.config.prod.js
 ```
 
 What follows is a general overview of each major part and how to use them.
@@ -73,28 +69,10 @@ This directory should contain all your project's JS files. Libraries, plugins,
 and custom code can all be included here. It includes some initial JS to help
 get you started. [About the JavaScript](js.md).
 
-### .htaccess
-
-The default web server configs are for Apache. For more information, please
-refer to the [Apache Server Configs
-repository](https://github.com/h5bp/server-configs-apache).
-
-Host your site on a server other than Apache? You're likely to find the
-corresponding server configs project listed in our [Server
-Configs](https://github.com/h5bp/server-configs/blob/master/README.md)
-repository.
-
 ### 404.html
 
 A helpful custom 404 to get you started.
 
-### browserconfig.xml
-
-This file contains all settings regarding custom tiles for IE11 and Edge.
-
-For more info on this topic, please refer to [Microsoft's
-Docs](https://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/dn320426(v=vs.85)).
-
 ### .editorconfig
 
 The `.editorconfig` file is provided in order to encourage and help you and your
@@ -110,14 +88,6 @@ need to integrate this starting HTML with your setup.
 Make sure that you update the URLs for the referenced CSS and JavaScript if you
 modify the directory structure at all.
 
-If you are using Google Universal Analytics, make sure that you edit the
-corresponding snippet at the bottom to include your analytics ID.
-
-### humans.txt
-
-Edit this file to include the team that worked on your site/app, and the
-technology powering it.
-
 ### package.json
 
 Edit this file to describe your application, add dependencies, scripts and
@@ -129,8 +99,62 @@ Edit this file to include any pages you need hidden from search engines.
 
 ### Icons
 
-Replace the default `favicon.ico`, `tile.png`, `tile-wide.png` and Apple Touch
-Icon with your own.
+Replace the default `favicon.ico` and Apple Touch Icon with your own.
 
 If you want to use different Apple Touch Icons for different resolutions please
 refer to the [according documentation](extend.md#apple-touch-icons).
+
+### Webpack
+
+The project contains a simple [webpack](https://webpack.js.org/) configuration.
+
+To get started developing a site with a development server, run the following
+commands from within the `/dist/` folder in the project's repo or within the
+root folder of the dowloaded project files, the folder created by `npm install`
+or the project folder created by running [create\-html5\-boilerplate](https://github.com/h5bp/create-html5-boilerplate)
+
+```
+npm install
+npm run start
+```
+
+This will start a Webpack development server with hot reloading of edited files.
+
+To package a site for production run
+
+```
+npm run build
+```
+
+This command will bundle up the site's JavaScript and copy over static assets to
+the newly created `dist` folder.
+
+There are three files:
+
+#### webpack.common.js
+
+Both the production and development scripts inherit from this common script.
+
+#### webpack.config.dev.js
+
+This development configuration defines the behavior of development server.
+
+#### webpack.config.prod.js
+
+This production configuration defines the behavior of the production build.
+
+It copies the following files and folders to the dist folder:
+
+- css
+- img
+- js/vendor
+- 404.html
+- favicon.ico
+- icon.png
+- icon.svg
+- index.html
+- robots.txt
+- site.webmanifest
+
+`js/vendor` is copied over in order to allow you to use unprocessed JS files
+in addition to the files bundled based on the project's entry point `app.js.`

eslint.config.mjs

@@ -0,0 +1,30 @@
+import globals from 'globals';
+import js from '@eslint/js';
+import mocha from 'eslint-plugin-mocha';
+import { defineConfig } from 'eslint/config';
+
+export default defineConfig([
+  {
+    files: ['**/*.js'],
+    plugins: {
+      js,
+      mocha,
+    },
+    languageOptions: {
+      ecmaVersion: 2020,
+      sourceType: 'module',
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.mocha,
+      },
+    },
+    extends: ['js/recommended'],
+    rules: {
+      // Your custom rules
+      indent: ['error', 2],
+      quotes: ['error', 'single'],
+      semi: ['error', 'always'],
+    },
+  },
+]);

gulpfile.babel.js

@@ -1,179 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-
-import gulp from 'gulp';
-
-// Load all gulp plugins automatically
-// and attach them to the `plugins` object
-import plugins from 'gulp-load-plugins';
-
-import archiver from 'archiver';
-import glob from 'glob';
-import del from 'del';
-import modernizr from 'modernizr';
-
-import pkg from './package.json';
-import modernizrConfig from './modernizr-config.json';
-
-const dirs = pkg['h5bp-configs'].directories;
-
-// ---------------------------------------------------------------------
-// | Helper tasks                                                      |
-// ---------------------------------------------------------------------
-
-gulp.task('archive:create_archive_dir', (done) => {
-  fs.mkdirSync(path.resolve(dirs.archive), '0755');
-  done();
-});
-
-gulp.task('archive:zip', (done) => {
-  const archiveName = path.resolve(dirs.archive, `${pkg.name}_v${pkg.version}.zip`);
-  const zip = archiver('zip');
-  const files = glob.sync('**/*.*', {
-    'cwd': dirs.dist,
-    'ignore': [
-      '**/node_modules/**',
-      'package-lock.json',
-      '**/dist/**',
-      '**/.cache/**',
-    ],
-    'dot': true // include hidden files
-  });
-  const output = fs.createWriteStream(archiveName);
-
-  zip.on('error', (error) => {
-    done();
-    throw error;
-  });
-
-  output.on('close', done);
-
-  files.forEach((file) => {
-    const filePath = path.resolve(dirs.dist, file);
-
-    // `zip.bulk` does not maintain the file
-    // permissions, so we need to add files individually
-    zip.append(fs.createReadStream(filePath), {
-      'name': file,
-      'mode': fs.statSync(filePath).mode
-    });
-  });
-
-  zip.pipe(output);
-  zip.finalize();
-  done();
-});
-
-gulp.task('clean', (done) => {
-  del([
-    dirs.archive,
-    dirs.dist
-  ]).then(() => {
-    done();
-  });
-});
-
-gulp.task('copy:.htaccess', () =>
-  gulp.src('node_modules/apache-server-configs/dist/.htaccess')
-    .pipe(plugins().replace(/# ErrorDocument/g, 'ErrorDocument'))
-    .pipe(gulp.dest(dirs.dist))
-);
-
-gulp.task('copy:index.html', () => {
-
-  let modernizrVersion = pkg.devDependencies.modernizr;
-
-  return gulp.src(`${dirs.src}/index.html`)
-    .pipe(plugins().replace(/{{MODERNIZR_VERSION}}/g, modernizrVersion))
-    .pipe(gulp.dest(dirs.dist));
-});
-
-gulp.task('copy:license', () =>
-  gulp.src('LICENSE.txt')
-    .pipe(gulp.dest(dirs.dist))
-);
-
-gulp.task('copy:main.css', () => {
-  const banner = `/*! HTML5 Boilerplate v${pkg.version} | ${pkg.license} License | ${pkg.homepage} */\n\n`;
-
-  return gulp.src('node_modules/main.css/dist/main.css')
-    .pipe(plugins().header(banner))
-    .pipe(plugins().autoprefixer({
-      cascade: false
-    }))
-    .pipe(gulp.dest(`${dirs.dist}/css`));
-});
-
-gulp.task('copy:misc', () =>
-  gulp.src([
-    // Copy all files
-    `${dirs.src}/**/*`,
-
-    // Exclude the following files
-    // (other tasks will handle the copying of these files)
-    `!${dirs.src}/css/main.css`,
-    `!${dirs.src}/index.html`
-  ], {
-    // Include hidden files by default
-    dot: true
-  }).pipe(gulp.dest(dirs.dist))
-);
-
-gulp.task('copy:normalize', () =>
-  gulp.src('node_modules/normalize.css/normalize.css')
-    .pipe(gulp.dest(`${dirs.dist}/css`))
-);
-
-gulp.task('modernizr', (done) => {
-  // TODO: rework this flow instead of just reacting to the fact that the jQuery step is gone
-  if (!fs.existsSync(`${dirs.dist}/js/vendor/`)){
-    fs.mkdirSync(`${dirs.dist}/js/vendor/`);
-  } 
-  
-  modernizr.build(modernizrConfig, (code) => {
-    fs.writeFile(`${dirs.dist}/js/vendor/modernizr-${pkg.devDependencies.modernizr}.min.js`, code, done);
-  });
-});
-
-gulp.task('lint:js', () =>
-  gulp.src([
-    `${dirs.src}/js/*.js`,
-    `${dirs.test}/*.js`
-  ]).pipe(plugins().eslint())
-    .pipe(plugins().eslint.failOnError())
-);
-
-// ---------------------------------------------------------------------
-// | Main tasks                                                        |
-// ---------------------------------------------------------------------
-gulp.task(
-  'copy',
-  gulp.series(
-    'copy:.htaccess',
-    'copy:index.html',
-    'copy:license',
-    'copy:main.css',
-    'copy:misc',
-    'copy:normalize'
-  )
-);
-
-gulp.task(
-  'build',
-  gulp.series(
-    gulp.parallel('clean', 'lint:js'),
-    'copy',
-    'modernizr'
-  )
-);
-
-gulp.task(
-  'archive',
-  gulp.series(
-    'build',
-    'archive:create_archive_dir',
-    'archive:zip'
-  )
-);
-
-gulp.task('default', gulp.series('build'));

gulpfile.mjs

@@ -0,0 +1,143 @@
+import fs from 'fs';
+import path from 'path';
+import gulp from 'gulp';
+import gulpAutoPrefixer from 'gulp-autoprefixer';
+import gulpEslint from 'gulp-eslint-new';
+import gulpHeader from 'gulp-header';
+import gulpRename from 'gulp-rename';
+import archiver from 'archiver';
+import { globSync } from 'glob';
+import { deleteSync } from 'del';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('./package.json');
+
+const dirs = pkg['h5bp-configs'].directories;
+
+// ---------------------------------------------------------------------
+// | Helper tasks                                                      |
+// ---------------------------------------------------------------------
+
+gulp.task('archive:create_archive_dir', (done) => {
+  fs.mkdirSync(path.resolve(dirs.archive), '0755');
+  done();
+});
+
+gulp.task('archive:zip', (done) => {
+  const archiveName = path.resolve(
+    dirs.archive,
+    `${pkg.name}_v${pkg.version}.zip`,
+  );
+  const zip = archiver('zip');
+  const files = globSync('**/*.*', {
+    cwd: dirs.dist,
+    ignore: [
+      '**/node_modules/**',
+      'package-lock.json',
+      '**/dist/**',
+      '**/.cache/**',
+    ],
+    dot: true, // include hidden files
+  });
+  const output = fs.createWriteStream(archiveName);
+
+  zip.on('error', (error) => {
+    done();
+    throw error;
+  });
+
+  output.on('close', done);
+
+  files.forEach((file) => {
+    const filePath = path.resolve(dirs.dist, file);
+
+    // `zip.bulk` does not maintain the file
+    // permissions, so we need to add files individually
+    zip.append(fs.createReadStream(filePath), {
+      name: file,
+      mode: fs.statSync(filePath).mode,
+    });
+  });
+
+  zip.pipe(output);
+  zip.finalize();
+  done();
+});
+
+gulp.task('clean', (done) => {
+  deleteSync([dirs.archive, dirs.dist]);
+  done();
+});
+
+gulp.task('copy:index.html', () => {
+  return gulp.src(`${dirs.src}/index.html`).pipe(gulp.dest(dirs.dist));
+});
+
+gulp.task('copy:license', () =>
+  gulp.src('LICENSE.txt').pipe(gulp.dest(dirs.dist)),
+);
+
+gulp.task('copy:style', () => {
+  const banner = `/*! HTML5 Boilerplate v${pkg.version} | ${pkg.license} License | ${pkg.homepage} */\n\n`;
+
+  return gulp
+    .src('node_modules/main.css/dist/main.css')
+    .pipe(gulpHeader(banner))
+    .pipe(
+      gulpAutoPrefixer({
+        cascade: false,
+      }),
+    )
+    .pipe(
+      gulpRename({
+        basename: 'style',
+      }),
+    )
+    .pipe(gulp.dest(`${dirs.dist}/css`));
+});
+
+gulp.task('copy:misc', () =>
+  gulp
+    .src(
+      [
+        // Copy all files
+        `${dirs.src}/**/*`,
+
+        // Exclude the following files
+        // (other tasks will handle the copying of these files)
+        `!${dirs.src}/css/main.css`,
+        `!${dirs.src}/index.html`,
+        `!**/.DS_Store`,
+      ],
+      {
+        encoding: false,
+        // Include hidden files by default
+        dot: true,
+      },
+    )
+    .pipe(gulp.dest(dirs.dist)),
+);
+
+gulp.task('lint:js', () =>
+  gulp
+    .src([`${dirs.src}/js/*.js`, `${dirs.src}/*.js`, `${dirs.test}/*.mjs`])
+    .pipe(gulpEslint())
+    .pipe(gulpEslint.failOnError()),
+);
+
+// ---------------------------------------------------------------------
+// | Main tasks                                                        |
+// ---------------------------------------------------------------------
+gulp.task(
+  'copy',
+  gulp.series('copy:index.html', 'copy:license', 'copy:style', 'copy:misc'),
+);
+
+gulp.task('build', gulp.series(gulp.parallel('clean', 'lint:js'), 'copy'));
+
+gulp.task(
+  'archive',
+  gulp.series('build', 'archive:create_archive_dir', 'archive:zip'),
+);
+
+gulp.task('default', gulp.series('build'));

modernizr-config.json

@@ -1,30 +0,0 @@
-{
-  "minify": true,
-  "options": [
-    "domPrefixes",
-    "prefixes",
-    "addTest",
-    "hasEvent",
-    "mq",
-    "prefixedCSSValue",
-    "testAllProps",
-    "testProp",
-    "testStyles",
-    "setClasses"
-  ],
-  "feature-detects": [
-    "test/custom-elements",
-    "test/history",
-    "test/pointerevents",
-    "test/postmessage",
-    "test/webgl",
-    "test/websockets",
-    "test/css/animations",
-    "test/css/columns",
-    "test/css/flexbox",
-    "test/elem/picture",
-    "test/img/sizes",
-    "test/img/srcset",
-    "test/workers/webworkers"
-  ]
-}

package.json

@@ -1,65 +1,56 @@
 {
   "name": "html5-boilerplate",
-  "version": "8.0.0",
-  "homepage": "https://html5boilerplate.com/",
-  "license": "MIT",
+  "version": "9.0.1",
   "description": "A professional front-end template for building fast, robust, and adaptable web apps or sites.",
   "keywords": [
     "h5bp",
     "template",
     "front-end"
   ],
+  "homepage": "https://html5boilerplate.com/",
+  "bugs": {
+    "url": "https://github.com/h5bp/html5-boilerplate/issues"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/h5bp/html5-boilerplate.git"
   },
-  "bugs": {
-    "url": "https://github.com/h5bp/html5-boilerplate/issues"
-  },
+  "license": "MIT",
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE.txt",
+    "package.json",
+    "dist/",
+    "README.md"
+  ],
   "scripts": {
     "build": "gulp build",
-    "test": "gulp archive && mocha --require @babel/register --reporter spec --timeout 5000"
+    "prettier": "prettier --write ./**/*.{js,json,md,mjs,yml}",
+    "test": "gulp archive && mocha --reporter spec --timeout 5000"
   },
   "devDependencies": {
-    "@babel/core": "^7.10.2",
-    "@babel/preset-env": "^7.10.2",
-    "@babel/register": "^7.10.1",
-    "apache-server-configs": "^4.0.0",
-    "archiver": "^4.0.1",
-    "del": "^5.1.0",
-    "eslint": "^7.1.0",
-    "eslint-config-recommended": "^4.1.0",
-    "eslint-plugin-mocha": "^7.0.1",
-    "glob": "^7.1.6",
-    "gulp": "^4.0.2",
-    "gulp-autoprefixer": "^7.0.1",
-    "gulp-eslint": "^6.0.0",
+    "@eslint/js": "^9.35.0",
+    "archiver": "^7.0.1",
+    "del": "^8.0.1",
+    "eslint": "^9.35.0",
+    "eslint-plugin-mocha": "^11.1.0",
+    "glob": "^11.1.0",
+    "globals": "^16.4.0",
+    "gulp": "^5.0.1",
+    "gulp-autoprefixer": "^9.0.0",
+    "gulp-eslint-new": "^2.4.0",
     "gulp-header": "^2.0.9",
-    "gulp-load-plugins": "^2.0.3",
-    "gulp-rename": "^2.0.0",
-    "gulp-replace": "^1.0.0",
-    "main.css": "2.1.0",
-    "mocha": "^7.2.0",
-    "modernizr": "3.11.2",
-    "normalize.css": "8.0.1",
-    "strip-json-comments": "^3.1.0"
+    "gulp-rename": "^2.1.0",
+    "main.css": "3.0.0",
+    "mocha": "^11.7.2",
+    "prettier": "3.6.2"
   },
   "engines": {
-    "node": ">=10",
-    "npm": ">=3"
+    "node": ">=20"
   },
-  "babel": {
-    "presets": [
-      "@babel/preset-env"
-    ]
+  "volta": {
+    "node": "20.19.1"
   },
-  "browserslist": [
-    "> 0.5%",
-    "last 2 versions",
-    "Firefox ESR",
-    "not dead",
-    "IE 11"
-  ],
   "h5bp-configs": {
     "directories": {
       "archive": "archive",
@@ -67,14 +58,5 @@
       "src": "src",
       "test": "test"
     }
-  },
-  "files": [
-    "CHANGELOG.md",
-    "LICENSE.txt",
-    "package.json",
-    "dist/",
-    "modernizr-config.json",
-    "README.md"
-  ],
-  "dependencies": {}
+  }
 }

src/.editorconfig

@@ -4,6 +4,7 @@ root = true
 
 [*]
 charset = utf-8
+end_of_line = lf
 indent_size = 2
 indent_style = space
 insert_final_newline = true

src/browserconfig.xml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Please read: https://msdn.microsoft.com/en-us/library/ie/dn455106.aspx -->
-<browserconfig>
-  <msapplication>
-    <tile>
-      <square70x70logo src="tile.png"/>
-      <square150x150logo src="tile.png"/>
-      <wide310x150logo src="tile-wide.png"/>
-      <square310x310logo src="tile.png"/>
-    </tile>
-  </msapplication>
-</browserconfig>

src/doc/TOC.md

@@ -1,37 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/)
-
-## Getting started
-
-* [Usage](usage.md) — Overview of the project contents.
-* [FAQ](faq.md) — Frequently asked questions along with their answers.
-
-## HTML5 Boilerplate core
-
-* [HTML](html.md) — Guide to the default HTML.
-* [CSS](css.md) — Guide to the default CSS.
-* [JavaScript](js.md) — Guide to the default JavaScript.
-* [Everything else](misc.md).
-
-## Development
-
-* [Extending and customizing HTML5 Boilerplate](extend.md) — Going further with
-  the boilerplate.
-
-## Related projects
-
-The [H5BP organization](https://github.com/h5bp) maintains several projects that
-complement HTML5 Boilerplate, projects that can help you improve different
-aspects of your website/web app (e.g.: the performance, security, etc.).
-
-* [Server Configs](https://github.com/h5bp/server-configs) — Fast and smart
-  configurations for web servers such as Apache and Nginx.
-  * [Apache](https://github.com/h5bp/server-configs-apache)
-  * [Google App Engine (GAE)](https://github.com/h5bp/server-configs-gae)
-  * [Internet Information Services
-    (IIS)](https://github.com/h5bp/server-configs-iis)
-  * [lighttpd](https://github.com/h5bp/server-configs-lighttpd)
-  * [Nginx](https://github.com/h5bp/server-configs-nginx)
-  * [Node.js](https://github.com/h5bp/server-configs-node)
-* [Front-end Developer Interview Questions](https://github.com/h5bp/Front-end-Developer-Interview-Questions)
-* [create-html5-boilerplate](https://github.com/h5bp/create-html5-boilerplate) — Quick start HTML5 Boilerplate development
-* [main.css](https://github.com/h5bp/main.css) — the main.css file included with HTML5 Boilerplate

src/doc/css.md

@@ -1,44 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# The CSS
-
-HTML5 Boilerplate's CSS includes:
-
-* [Normalize.css](#normalizecss)
-* [main.css](#maincss)
-
-## 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/).
-
-## main.css
-
-Several base styles are included that build upon `Normalize.css`. These styles:
-
-* provide basic typography settings that improve text readability
-* protect against unwanted `text-shadow` during text highlighting
-* tweak the default alignment of some elements (e.g.: `img`, `video`,
-  `fieldset`, `textarea`)
-* style the prompt that is displayed to users using an outdated browser
-* and more...
-
-These styles are included in
-[main.css](https://github.com/h5bp/html5-boilerplate/blob/master/dist/css/main.css).
-See the [main.css](https://github.com/h5bp/main.css) project
-[documentation](https://github.com/h5bp/main.css/blob/master/README.md#features)
-for a full discussion of these styles.

src/doc/extend.md

@@ -1,605 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com) | [Documentation
-table of contents](TOC.md)
-
-# Extend and customise HTML5 Boilerplate
-
-Here is some useful advice for how you can make your project with HTML5
-Boilerplate even better. We don't want to include it all by default, as not
-everything fits with everyone's needs.
-
-* [App Stores](#app-stores)
-* [DNS prefetching](#dns-prefetching)
-* [Google Universal Analytics](#google-universal-analytics)
-* [Internet Explorer](#internet-explorer)
-* [Miscellaneous](#miscellaneous)
-* [News Feeds](#news-feeds)
-* [Search](#search)
-* [Social Networks](#social-networks)
-* [URLs](#urls)
-* [Web Apps](#web-apps)
-* [security.txt](#security.txt)
-
-## App Stores
-
-### Smart App Banners in iOS 6+ Safari
-
-Stop bothering everyone with gross modals advertising your entry in the App
-Store. Including the following [meta
-tag](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/PromotingAppswithAppBanners/PromotingAppswithAppBanners.html)
-will unobtrusively give the user the option to download your iOS app, or open it
-with some data about the user's current state on the website.
-
-```html
-<meta name="apple-itunes-app" content="app-id=APP_ID,app-argument=SOME_TEXT">
-```
-
-## DNS prefetching
-
-In short, DNS Prefetching is a method of informing the browser of domain names
-referenced on a site so that the client can resolve the DNS for those hosts,
-cache them, and when it comes time to use them, have a faster turn around on the
-request.
-
-### Implicit prefetches
-
-There is a lot of prefetching done for you automatically by the browser. When
-the browser encounters an anchor in your html that does not share the same
-domain name as the current location the browser requests, from the client OS,
-the IP address for this new domain. The client first checks its cache and then,
-lacking a cached copy, makes a request from a DNS server. These requests happen
-in the background and are not meant to block the rendering of the page.
-
-The goal of this is that when the foreign IP address is finally needed it will
-already be in the client cache and will not block the loading of the foreign
-content. Fewer requests result in faster page load times. The perception of this
-is increased on a mobile platform where DNS latency can be greater.
-
-### Explicit prefetches
-
-Typically the browser only scans the HTML for foreign domains. If you have
-resources that are outside of your HTML (a javascript request to a remote server
-or a CDN that hosts content that may not be present on every page of your site,
-for example) then you can queue up a domain name to be prefetched.
-
-```html
-<link rel="dns-prefetch" href="//example.com">
-<link rel="dns-prefetch" href="https://ajax.googleapis.com">
-```
-
-You can use as many of these as you need, but it's best if they are all
-immediately after the [Meta
-Charset](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta#attr-charset)
-element (which should go right at the top of the `head`), so the browser can act
-on them ASAP.
-
-#### Common Prefetch Links
-
-Amazon S3:
-
-```html
-<link rel="dns-prefetch" href="//s3.amazonaws.com">
-```
-
-Google APIs:
-
-```html
-<link rel="dns-prefetch" href="https://ajax.googleapis.com">
-```
-
-Microsoft Ajax Content Delivery Network:
-
-```html
-<link rel="dns-prefetch" href="//ajax.microsoft.com">
-<link rel="dns-prefetch" href="//ajax.aspnetcdn.com">
-```
-
-### Further reading about DNS prefetching
-
-* https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-DNS-Prefetch-Control
-* https://dev.chromium.org/developers/design-documents/dns-prefetching
-* https://docs.microsoft.com/en-us/archive/blogs/ie/internet-explorer-9-network-performance-improvements
-
-## Google Universal Analytics
-
-### More tracking settings
-
-The [optimized Google Universal Analytics
-snippet](https://mathiasbynens.be/notes/async-analytics-snippet#universal-analytics)
-included with HTML5 Boilerplate includes something like this:
-
-```js
-ga('create', 'UA-XXXXX-X', 'auto'); ga('send', 'pageview');
-```
-
-To customize further, see Google's [Advanced
-Setup](https://developers.google.com/analytics/devguides/collection/analyticsjs/),
-[Pageview](https://developers.google.com/analytics/devguides/collection/analyticsjs/pages),
-and
-[Event](https://developers.google.com/analytics/devguides/collection/analyticsjs/events)
-Docs.
-
-### Track jQuery AJAX requests in Google Analytics
-
-An article by @JangoSteve explains how to [track jQuery AJAX requests in Google
-Analytics](https://www.alfajango.com/blog/track-jquery-ajax-requests-in-google-analytics/).
-
-Add this to `plugins.js`:
-
-```js
-/*
- * Log all jQuery AJAX requests to Google Analytics
- * See: https://www.alfajango.com/blog/track-jquery-ajax-requests-in-google-analytics/
- */
-if (typeof ga !== "undefined" && ga !== null) {
-    $(document).ajaxSend(function(event, xhr, settings){
-        ga('send', 'pageview', settings.url);
-    });
-}
-```
-
-### Track JavaScript errors in Google Analytics
-
-Add this function after `ga` is defined:
-
-```js
-(function(window){
-    var undefined,
-        link = function (href) {
-            var a = window.document.createElement('a');
-            a.href = href;
-            return a;
-        };
-    window.onerror = function (message, file, line, column) {
-        var host = link(file).hostname;
-        ga('send', {
-          'hitType': 'event',
-          'eventCategory': (host == window.location.hostname || host == undefined || host == '' ? '' : 'external ') + 'error',
-          'eventAction': message,
-          'eventLabel': (file + ' LINE: ' + line + (column ? ' COLUMN: ' + column : '')).trim(),
-          'nonInteraction': 1
-        });
-    };
-}(window));
-```
-
-### Track page scroll
-
-Add this function after `ga` is defined. Note, the following snippet requires jQuery.
-
-```js
-$(function(){
-    var isDuplicateScrollEvent,
-        scrollTimeStart = new Date,
-        $window = $(window),
-        $document = $(document),
-        scrollPercent;
-
-    $window.scroll(function() {
-        scrollPercent = Math.round(100 * ($window.height() + $window.scrollTop())/$document.height());
-        if (scrollPercent > 90 && !isDuplicateScrollEvent) { //page scrolled to 90%
-            isDuplicateScrollEvent = 1;
-            ga('send', 'event', 'scroll',
-                'Window: ' + $window.height() + 'px; Document: ' + $document.height() + 'px; Time: ' + Math.round((new Date - scrollTimeStart )/1000,1) + 's'
-            );
-        }
-    });
-});
-```
-
-## Internet Explorer
-
-### IE Pinned Sites
-
-Enabling your application for pinning will allow IE users to add it to their
-Windows Taskbar and Start Menu. This comes with a range of new tools that you
-can easily configure with the elements below. See more [documentation on IE
-Pinned
-Sites](https://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/samples/gg491731(v%3dvs.85)).
-
-### Name the Pinned Site for Windows
-
-Without this rule, Windows will use the page title as the name for your
-application.
-
-```html
-<meta name="application-name" content="Sample Title">
-```
-
-### Give your Pinned Site a tooltip
-
-You know — a tooltip. A little textbox that appears when the user holds their
-mouse over your Pinned Site's icon.
-
-```html
-<meta name="msapplication-tooltip" content="A description of what this site does.">
-```
-
-### Set a default page for your Pinned Site
-
-If the site should go to a specific URL when it is pinned (such as the
-homepage), enter it here. One idea is to send it to a special URL so you can
-track the number of pinned users, like so:
-`https://www.example.com/index.html?pinned=true`
-
-```html
-<meta name="msapplication-starturl" content="https://www.example.com/index.html?pinned=true">
-```
-
-### Recolor IE's controls manually for a Pinned Site
-
-IE will automatically use the overall color of your Pinned Site's favicon to
-shade its browser buttons. UNLESS you give it another color here. Only use named
-colors (`red`) or hex colors (`#ff0000`).
-
-```html
-<meta name="msapplication-navbutton-color" content="#ff0000">
-```
-
-### Manually set the window size of a Pinned Site
-
-If the site should open at a certain window size once pinned, you can specify
-the dimensions here. It only supports static pixel dimensions. 800x600 minimum.
-
-```html
-<meta name="msapplication-window" content="width=800;height=600">
-```
-
-### Jump List "Tasks" for Pinned Sites
-
-Add Jump List Tasks that will appear when the Pinned Site's icon gets a
-right-click. Each Task goes to the specified URL, and gets its own mini icon
-(essentially a favicon, a 16x16 .ICO). You can add as many of these as you need.
-
-```html
-<meta name="msapplication-task" content="name=Task 1;action-uri=http://host/Page1.html;icon-uri=http://host/icon1.ico">
-<meta name="msapplication-task" content="name=Task 2;action-uri=http://microsoft.com/Page2.html;icon-uri=http://host/icon2.ico">
-```
-
-### (Windows 8) High quality visuals for Pinned Sites
-
-Windows 8 adds the ability for you to provide a PNG tile image and specify the
-tile's background color. [Full details on the IE
-blog](https://docs.microsoft.com/en-us/archive/blogs/ie/high-quality-visuals-for-pinned-sites-in-windows-8).
-
-* Create a 144x144 image of your site icon, filling all of the canvas, and using
-  a transparent background.
-* Save this image as a 32-bit PNG and optimize it without reducing colour-depth.
-  It can be named whatever you want (e.g. `metro-tile.png`).
-* To reference the tile and its color, add the HTML `meta` elements described in
-  the IE Blog post.
-
-### (Windows 8) Badges for Pinned Sites
-
-IE will poll an XML document for badge information to display on your app's tile
-in the Start screen. The user will be able to receive these badge updates even
-when your app isn't actively running. The badge's value can be a number, or one
-of a predefined list of glyphs.
-
-* [Tutorial on IEBlog with link to badge XML
-schema](https://docs.microsoft.com/en-us/archive/blogs/ie/pinned-sites-in-windows-8)
-* [Available badge
-  values](https://docs.microsoft.com/en-us/uwp/schemas/tiles/badgeschema/element-badge)
-
-```html
-<meta name="msapplication-badge" value="frequency=NUMBER_IN_MINUTES;polling-uri=https://www.example.com/path/to/file.xml">
-```
-
-## Search
-
-### Direct search spiders to your sitemap
-
-After creating a [sitemap](https://www.sitemaps.org/protocol.html)
-
-Submit it to search engine tool:
-* [Google](https://www.google.com/webmasters/tools/sitemap-list)
-* [Bing](https://www.bing.com/toolbox/webmaster)
-* [Yandex](https://webmaster.yandex.com/)
-* [Baidu](https://zhanzhang.baidu.com/) OR Insert the following line anywhere in
-  your robots.txt file, specifying the path to your sitemap:
-```
-Sitemap: https://example.com/sitemap_location.xml
-```
-
-### Hide pages from search engines
-
-According to Heather Champ, former community manager at Flickr, you should not
-allow search engines to index your "Contact Us" or "Complaints" page if you
-value your sanity. This is an HTML-centric way of achieving that.
-
-```html
-<meta name="robots" content="noindex">
-```
-
-**_WARNING:_** DO NOT INCLUDE ON PAGES THAT SHOULD APPEAR IN SEARCH ENGINES.
-
-### Firefox and IE Search Plugins
-
-Sites with in-site search functionality should be strongly considered for a
-browser search plugin. A "search plugin" is an XML file which defines how your
-plugin behaves in the browser. [How to make a browser search
-plugin](https://www.google.com/search?ie=UTF-8&q=how+to+make+browser+search+plugin).
-
-```html
-<link rel="search" title="" type="application/opensearchdescription+xml" href="">
-```
-
-
-## Miscellaneous
-
-* Use
-  [polyfills](https://github.com/Modernizr/Modernizr/wiki/HTML5-Cross-browser-Polyfills).
-
-* Use [Microformats](http://microformats.org/wiki/Main_Page) (via
-  [microdata](http://microformats.org/wiki/microdata)) for optimum search
-  results
-  [visibility](https://webmasters.googleblog.com/2009/05/introducing-rich-snippets.html).
-
-* If you want to disable the translation prompt in Chrome or block Google
-  Translate from translating your web page, use [`<meta name="google"
-  content="notranslate">`](https://support.google.com/webmasters/answer/79812).
-  To disable translation for a particular section of the web page, add
-  [`class="notranslate"`](https://support.google.com/translate/?hl=en#2641276).
-
-* If you want to disable the automatic detection and formatting of possible
-  phone numbers in Safari on iOS, use [`<meta name="format-detection"
-  content="telephone=no">`](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html).
-
-* Avoid development/stage websites "leaking" into SERPs (search engine results
-  page) by [implementing X-Robots-tag
-  headers](https://github.com/h5bp/html5-boilerplate/issues/804).
-
-
-## News Feeds
-
-### RSS
-
-Have an RSS feed? Link to it here. Want to [learn how to write an RSS feed from
-scratch](https://www.rssboard.org/rss-specification)?
-
-```html
-<link rel="alternate" type="application/rss+xml" title="RSS" href="/rss.xml">
-```
-
-### Atom
-
-Atom is similar to RSS, and you might prefer to use it instead of or in addition
-to it. [See what Atom's all
-about](https://en.wikipedia.org/wiki/Atom_(Web_standard)).
-
-```html
-<link rel="alternate" type="application/atom+xml" title="Atom" href="/atom.xml">
-```
-
-### Pingbacks
-
-Your server may be notified when another site links to yours. The href attribute
-should contain the location of your pingback service.
-
-```html
-<link rel="pingback" href="">
-```
-
-* High-level explanation:
-  https://codex.wordpress.org/Introduction_to_Blogging#Pingbacks
-* Step-by-step example case:
-  https://www.hixie.ch/specs/pingback/pingback-1.0#TOC5
-* PHP pingback service:
-  https://web.archive.org/web/20131211032834/http://blog.perplexedlabs.com/2009/07/15/xmlrpc-pingbacks-using-php/
-
-
-
-## Social Networks
-
-### Facebook Open Graph data
-
-You can control the information that Facebook and others display when users
-share your site. Below are just the most basic data points you might need. For
-specific content types (including "website"), see [Facebook's built-in Open
-Graph content
-templates](https://developers.facebook.com/docs/sharing/opengraph/using-objects).
-Take full advantage of Facebook's support for complex data and activity by
-following the [Open Graph
-tutorial](https://developers.facebook.com/docs/sharing/webmasters/getting-started).
-
-For a reference of Open Graph's markup and properties, you may check [Facebook's
-Open Graph Protocol reference](https://ogp.me). Finally, you can validate your
-markup with the [Facebook Object
-Debugger](https://developers.facebook.com/tools/debug/) (needs registration to
-Facebook).
-
-```html
-<meta property="fb:app_id" content="123456789">
-<meta property="og:url" content="https://www.example.com/path/to/page.html">
-<meta property="og:type" content="website">
-<meta property="og:title" content="">
-<meta property="og:image" content="https://www.example.com/path/to/image.jpg">
-<meta property="og:description" content="">
-<meta property="og:site_name" content="">
-<meta property="article:author" content="">
-```
-
-### Twitter Cards
-
-Twitter provides a snippet specification that serves a similar purpose to Open
-Graph. In fact, Twitter will use Open Graph when Cards is not available. You can
-read more about the various snippet formats in the
-[official Twitter Cards
-documentation](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/overview/abouts-cards),
-and you can validate your markup with the [Card
-validator](https://cards-dev.twitter.com/validator) (needs registration to
-Twitter).
-
-```html
-<meta name="twitter:card" content="summary">
-<meta name="twitter:site" content="@site_account">
-<meta name="twitter:creator" content="@individual_account">
-<meta name="twitter:url" content="https://www.example.com/path/to/page.html">
-<meta name="twitter:title" content="">
-<meta name="twitter:description" content="">
-<meta name="twitter:image" content="https://www.example.com/path/to/image.jpg">
-```
-
-### Schema.org
-
-Google also provides a snippet specification that serves a similar purpose to
-Facebook's Open Graph or Twitter Cards. This metadata is a subset of
-[schema.org's microdata vocabulary](https://schema.org/), which covers many
-other schemas that can describe the content of your pages to search engines. For
-this reason, this metadata is more generic for SEO, notably for Google's
-search-engine, although this vocabulary is also used by Microsoft, Pinterest and
-Yandex.
-
-You can validate your markup with the [Structured Data Testing
-Tool](https://search.google.com/structured-data/testing-tool). Also, please
-note that this markup requires to add attributes to your top `html` tag.
-
-```html
-<html class="no-js" lang="" itemscope itemtype="https://schema.org/Article">
-  <head>
-
-    <link rel="author" href="">
-    <link rel="publisher" href="">
-    <meta itemprop="name" content="">
-    <meta itemprop="description" content="">
-    <meta itemprop="image" content="">
-```
-
-## URLs
-
-### Canonical URL
-
-Signal to search engines and others "Use this URL for this page!" Useful when
-parameters after a `#` or `?` is used to control the display state of a page.
-`https://www.example.com/cart.html?shopping-cart-open=true` can be indexed as
-the cleaner, more accurate `https://www.example.com/cart.html`.
-
-```html
-<link rel="canonical" href="">
-```
-
-### Separate mobile URLs
-
-If you use separate URLs for desktop and mobile users, you should consider
-helping search engine algorithms better understand the configuration on your web
-site.
-
-This can be done by adding the following annotations in your HTML pages:
-
-* on the desktop page, add the `link rel="alternate"` tag pointing to the
-  corresponding mobile URL, e.g.:
-
-  `<link rel="alternate" media="only screen and (max-width: 640px)"
-  href="https://m.example.com/page.html" >`
-
-* on the mobile page, add the `link rel="canonical"` tag pointing to the
-  corresponding desktop URL, e.g.:
-
-  `<link rel="canonical" href="https://www.example.com/page.html">`
-
-For more information please see:
-
-* https://developers.google.com/search/mobile-sites/mobile-seo/separate-urls
-
-
-## Web Apps
-
-There are a couple of meta tags that provide information about a web app when
-added to the Home Screen on iOS:
-
-* Adding `apple-mobile-web-app-capable` will make your web app chrome-less and
-  provide the default iOS app view. You can control the color scheme of the
-  default view by adding `apple-mobile-web-app-status-bar-style`.
-
-```html
-<meta name="apple-mobile-web-app-capable" content="yes">
-<meta name="apple-mobile-web-app-status-bar-style" content="black">
-```
-
-* You can use `apple-mobile-web-app-title` to add a specific sites name for the
-  Home Screen icon.
-
-```html
-<meta name="apple-mobile-web-app-title" content="">
-```
-
-For further information please read the [official
-documentation](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html)
-on Apple's site.
-
-
-### Apple Touch Icons
-
-Apple touch icons are used as icons when a user adds your webapp to the home
-screen of an iOS devices.
-
-Though the dimensions of the icon can vary between iOS devices and versions one
-`180×180px` touch icon named `icon.png` and including the following in the
-`<head>` of the page is enough:
-
-```html
-<link rel="apple-touch-icon" href="icon.png">
-```
-
-For a more comprehensive overview, please refer to Mathias' [article on Touch
-Icons](https://mathiasbynens.be/notes/touch-icons).
-
-
-### Apple Touch Startup Image
-
-Apart from that it is possible to add start-up screens for web apps on iOS. This
-basically works by defining `apple-touch-startup-image` with an according link
-to the image. Since iOS devices have different screen resolutions it maybe
-necessary to add media queries to detect which image to load. Here is an example
-for an iPhone:
-
-```html
-<link rel="apple-touch-startup-image" media="(max-device-width: 480px) and (-webkit-min-device-pixel-ratio: 2)" href="img/startup.png">
-```
-
-
-### Chrome Mobile web apps
-
-Chrome Mobile has a specific meta tag for making apps [installable to the
-homescreen](https://developer.chrome.com/multidevice/android/installtohomescreen)
-which tries to be a more generic replacement to Apple's proprietary meta tag:
-
-```html
-<meta name="mobile-web-app-capable" content="yes">
-```
-
-Same applies to the touch icons:
-
-```html
-<link rel="icon" sizes="192x192" href="highres-icon.png">
-```
-
-### Theme Color
-
-You can add the [`theme-color` meta
-extension](https://html.spec.whatwg.org/multipage/semantics.html#meta-theme-color)
-in the `<head>` of your pages to suggest the color that browsers and OSes should
-use if they customize the display of individual pages in their UIs with varying
-colors.
-
-```html
-<meta name="theme-color" content="#ff69b4">
-```
-
-The `content` attribute extension can take any valid CSS color.
-
-Currently, the `theme-color` meta extension is supported by [Chrome 39+ for
-Android
-Lollipop](https://developers.google.com/web/updates/2014/11/Support-for-theme-color-in-Chrome-39-for-Android).
-
-
-## security.txt
-
-When security risks in web services are discovered by users they often lack the
-channels to disclose them properly. As a result, security issues may be left
-unreported.
-
-Security.txt defines a standard to help organizations define the process for
-users to disclose security vulnerabilities securely. Include a text file on your
-server at `.well-known/security.txt` with the relevant contact details.
-
-Check [https://securitytxt.org/](https://securitytxt.org/) for more details.

src/doc/faq.md

@@ -1,42 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# Frequently asked questions
-
-* [Why is the Google Analytics code at the bottom? Google recommends it be
-  placed in the
-  `<head>`.](#why-is-the-google-analytics-code-at-the-bottom-google-recommends-it-be-placed-in-the-head)
-* [Do I need to upgrade my site each time a new version of HTML5 Boilerplate is
-  released?](#do-i-need-to-upgrade-my-site-each-time-a-new-version-of-html5-boilerplate-is-released)
-* [Where can I get help with support
-  questions?](#where-can-i-get-help-with-support-questions)
-
----
-
-## Why is the Google Analytics code at the bottom? Google recommends it be placed in the `<head>`.
-
-The main advantage of placing it in the `<head>` is that you will track the
-user's `pageview` even if they leave the page before it has been fully loaded.
-
-Here's a handy quote from [Mathias
-Bynens](https://mathiasbynens.be/notes/async-analytics-snippet#comment-50) about
-our placement choice.
->I should point out that it’s Google — not me — recommending to place this
-script before all other scripts in the document. The only real advantage is to
-catch a pageView call if your page fails to load completely (for example, if the
-user aborts loading, or quickly closes the page, etc.). Personally, I wouldn’t
-count that as a page view, so I actually prefer to place this script at the
-bottom, after all other scripts. This keeps all the scripts together and
-reinforces that scripts at the bottom are the right move. (Usually I concatenate
-and minify all my scripts into one .js file — the GA snippet being the suffix.)
-
-## Do I need to upgrade my site each time a new version of HTML5 Boilerplate is released?
-
-No, just as you don't normally replace the foundation of a house once it was
-built. However, there is nothing stopping you from trying to work in the latest
-changes, but you'll have to assess the costs/benefits of doing so.
-
-## Where can I get help with support questions?
-
-Please ask for help on
-[StackOverflow](https://stackoverflow.com/questions/tagged/html5boilerplate).

src/doc/html.md

@@ -1,253 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# The HTML
-
-By default, HTML5 Boilerplate provides two `html` pages:
-
-* [`index.html`](#indexhtml) - a default HTML skeleton that should form the
-  basis of all pages on your website
-* `404.html` - a placeholder 404 error page
-
-## `index.html`
-
-### The `no-js` Class
-
-The `no-js` class is provided in order to allow you to more easily and
-explicitly add custom styles based on whether JavaScript is disabled (`.no-js`)
-or enabled (`.js`). Using this technique also helps [avoid the
-FOUC](https://www.paulirish.com/2009/avoiding-the-fouc-v3/).
-
-### Language Attribute
-
-Please consider specifying the language of your content by adding a
-[value](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry)
-to the `lang` attribute in the `<html>` as in this example:
-
-```html
-<html class="no-js" lang="en">
-```
-
-### The order of the `<title>` and `<meta>` tags
-
-The charset declaration (`<meta charset="utf-8">`) must be included completely
-within the [first 1024 bytes of the
-document](https://html.spec.whatwg.org/multipage/semantics.html#charset)
-and should be specified as early as possible (before any content that could be
-controlled by an attacker, such as a `<title>` element) in order to avoid a
-potential [encoding-related security
-issue](https://code.google.com/archive/p/doctype-mirror/wikis/ArticleUtf7.wiki)
-in Internet Explorer
-
-### Meta Description
-
-The `description` meta tag provides a short description of the page. In some
-situations this description is used as a part of the snippet shown in the search
-results.
-
-```html
-<meta name="description" content="This is a description">
-```
-
-Google's [Create good meta
-descriptions](https://support.google.com/webmasters/answer/35624?hl=en#meta-descriptions)
-documentation has useful tips on creating an effective description.
-
-### Mobile Viewport
-
-There are a few different options that you can use with the [`viewport` meta
-tag](https://docs.google.com/present/view?id=dkx3qtm_22dxsrgcf4 "Viewport and
-Media Queries - The Complete Idiot's Guide"). You can find out more in [the MDN
-Web
-Docs](https://developer.mozilla.org/en-US/docs/Mozilla/Mobile/Viewport_meta_tag).
-HTML5 Boilerplate comes with a simple setup that strikes a good balance for
-general use cases.
-
-```html
-<meta name="viewport" content="width=device-width, initial-scale=1">
-```
-
-If you want to take advantage of edge-to-edge displays of iPhone X/XS/XR you
-can do so with additional viewport parameters. [Check the WebKit
-blog](https://webkit.org/blog/7929/designing-websites-for-iphone-x/) for
-details.
-
-### Open Graph Metadata
-
-The [Open Graph Protocol](https://ogp.me/) allows you to define the way your
-site is presented when referenced on third party sites and applications
-(Facebook, Twitter, LinkedIn). The protocol provides a series of meta elements
-that define the details of your site. The required attributes define the title,
-preview image, URL, and [type](https://ogp.me/#types) (e.g., video, music,
-website, article).
-
-``` html
-<meta property="og:title" content="">
-<meta property="og:type" content="">
-<meta property="og:url" content="">
-<meta property="og:image" content="">
-```
-
-In addition to these four attributes there are many more attributes you can use
-to add more richness to the description of your site. This just represents the
-most basic implementation.
-
-To see a working example, the following is the open graph metadata for the HTML5
-Boilerplate site. In addition to the required fields we add `og:description` to
-describe the site in more detail.
-
-``` html
-<meta name="og:url" content="https://html5boilerplate.com/">
-<meta name="og:title" content="HTML5 ★ BOILERPLATE">
-<meta name="og:type" content="website">
-<meta name="og:description" content="The web’s most popular front-end template which helps you build fast, robust, and adaptable web apps or sites.">
-<meta name="og:image" content="https://html5boilerplate.com/icon.png">
-```
-
-### Web App Manifest
-
-HTML5 Boilerplate includes a simple web app manifest file.
-
-The web app manifest is a simple JSON file that allows you to control how your
-app appears on a device's home screen, what it looks like when it launches in
-that context and what happens when it is launched. This allows for much greater`
-control over the UI of a saved site or web app on a mobile device.
-
-It's linked to from the HTML as follows:
-
-```html
-<link rel="manifest" href="site.webmanifest">
-```
-
-Our
-[site.webmanifest](https://github.com/h5bp/html5-boilerplate/blob/master/src/site.webmanifest)
-contains a very skeletal "app" definition, just to show the basic usage. You
-should fill this file out with [more information about your site or
-application](https://developer.mozilla.org/en-US/docs/Web/Manifest)
-
-### Favicons and Touch Icon
-
-The shortcut icons should be put in the root directory of your site.
-`favicon.ico` is automatically picked up by browsers if it's placed in the root.
-HTML5 Boilerplate comes with a default set of icons (include favicon and one
-Apple Touch Icon) that you can use as a baseline to create your own.
-
-Please refer to the more detailed description in the [Extend section](extend.md)
-of these docs.
-
-### The Content Area
-
-The central part of the boilerplate template is pretty much empty. This is
-intentional, in order to make the boilerplate suitable for both web page and web
-app development.
-
-### Modernizr
-
-HTML5 Boilerplate uses a custom build of Modernizr.
-
-[Modernizr](https://modernizr.com/) is a JavaScript library which adds classes
-to the `html` element based on the results of feature test and which ensures
-that all browsers can make use of HTML5 elements (as it includes the HTML5
-Shiv). This allows you to target parts of your CSS and JavaScript based on the
-features supported by a browser.
-
-Starting with version 3 Modernizr can be customized using the
-[modernizr-config.json](https://github.com/h5bp/html5-boilerplate/blob/master/modernizr-config.json)
-and the [Modernizr command line
-utility](https://www.npmjs.com/package/modernizr-cli).
-
-### What About Polyfills?
-
-If you need to include
-[polyfills](https://remysharp.com/2010/10/08/what-is-a-polyfill) in your
-project, you must make sure those load before any other JavaScript. If you're
-using a polyfill CDN service, like [polyfill.io](https://polyfill.io/v3/), just put
-it before the other scripts in the bottom of the page:
-
-```html
-    <script src="js/vendor/modernizr-3.10.0.min.js"></script>
-    <script src="https://polyfill.io/v3/polyfill.min.js"></script>
-    <script src="js/plugins.js"></script>
-    <script src="js/main.js"></script>
-</body>
-```
-
-If you like to just include the polyfills yourself, you could include them in
-`js/plugins.js`. When you have a bunch of polyfills to load in, you could also
-create a `polyfills.js` file in the `js/vendor` directory or include the files
-individually and combine them using a build tool. Always ensure that the
-polyfills are all loaded before any other JavaScript.
-
-There are some misconceptions about Modernizr and polyfills. It's important to
-understand that Modernizr just handles feature checking, not polyfilling itself.
-The only thing Modernizr does regarding polyfills is that the team maintains [a
-huge list of cross Browser
-polyfills](https://github.com/Modernizr/Modernizr/wiki/HTML5-Cross-Browser-Polyfills).
-
-### jQuery
-
-As of v8.0.0 we no longer include jQuery by default. Web development has
-changed a lot since we started this project and while many millions of sites
-still use jQuery there are many sites and applications that don't. 10 years ago
-jQuery _was_ JavaScript for most developers. That's not the case any more so
-we've made the decision to remove jQuery from the project.
-
-If you're interested in including it, you can easily install jQuery using the
-following command:
-
-```
-npm install jQuery
-```
-
-You can then copy the minified file into the `vendor` folder and add jQuery
-to the `index.html` manually.
-
-To load jQuery from a CDN with a local fallback you can use the following:
-
-``` html
-<script src="https://code.jquery.com/jquery-3.5.1.min.js"  integrity="sha256-9/aliU8dGd2tb6OSsuzixeV4y/faTqgFtohetphbbj0=" crossorigin="anonymous"></script>
-<script>window.jQuery || document.write('<script src="js/vendor/jquery-3.5.1.min.js"><\/script>')</script>
-```
-
-### Google Universal Analytics Tracking Code
-
-Finally, an optimized version of the Google Universal Analytics tracking code is
-included.
-
-We use `analytics.js` rather than the newer `gtag.js` as [it's faster and
-supports tasks and
-plugins](https://github.com/philipwalton/analyticsjs-boilerplate/issues/19#issuecomment-333714370)
-
-Starting with version 8.0.0 we, by default, [anonymize IP
-addresses](https://support.google.com/analytics/answer/2763052). By
-default Google Analytics records the full IP address of a user visiting the
-site, but that full IP address is never available to the Google Analytics
-property admin. By anonymizing the IP address you can make your site more
-GDPR-compliant as a full IP address can be defined as PII (personally
-identifiable information.)
-
-The beacon transport mechanism is used to send all hits [which saves HTTP
-requests and improves
-performance](https://philipwalton.com/articles/the-google-analytics-setup-i-use-on-every-site-i-build/#loading-analytics.js).
-
-Google recommends that this script be placed at the top of the page. Factors to
-consider: if you place this script at the top of the page, you’ll be able to
-count users who don’t fully load the page, and you’ll incur the max number of
-simultaneous connections of the browser.
-
-Please be aware that while Google [states that it is fully GDPR compliant](https://privacy.google.com/businesses/compliance/),
-it is still possible to use analytics to violate GDPR.
-
-Further information:
-
-* [Introduction to
-  Analytics.js](https://developers.google.com/analytics/devguides/collection/analyticsjs/)
-* [Google Analytics Demos & Tools](https://ga-dev-tools.appspot.com/)
-* [Privacy Controls in Google Analytics](https://support.google.com/analytics/answer/9019185)
-
-**N.B.** The Google Analytics snippet is included by default mainly because
-Google Analytics is [currently one of the most popular tracking
-solutions](https://trends.builtwith.com/analytics/Google-Analytics) out there.
-However, its usage isn't set in stone, and you SHOULD consider exploring the
-[alternatives](https://en.wikipedia.org/wiki/List_of_web_analytics_software) and
-use whatever suits your needs best.

src/doc/js.md

@@ -1,35 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# The JavaScript
-
-Information about the default JavaScript included in the project.
-
-## main.js
-
-This file can be used to contain or reference your site/app JavaScript code. If
-you're working on something more advanced you might replace this file entirely.
-That's cool.
-
-## plugins.js
-
-This file can be used to contain all your plugins, such as jQuery plugins and
-other 3rd party scripts for a simple site.
-
-One approach is to put jQuery plugins inside of a `(function($){ ...})(jQuery);`
-closure to make sure they're in the jQuery namespace safety blanket. Read more
-about [jQuery plugin authoring](https://learn.jquery.com/plugins/).
-
-By default the `plugins.js` file contains a small script to avoid `console`
-errors in browsers that lack a `console`. The script will make sure that, if a
-console method isn't available, that method will have the value of empty
-function, thus, preventing the browser from throwing an error.
-
-## vendor
-
-This directory can be used to contain all 3rd party library code.
-
-Our custom build of the Modernizr library is included by
-default. You may wish to create your own [custom Modernizr build with the online
-builder](https://modernizr.com/download/) or [command line
-tool](https://modernizr.com/docs#command-line-config).

src/doc/misc.md

@@ -1,203 +0,0 @@
-[HTML5 Boilerplate homepage](https://html5boilerplate.com/) | [Documentation
-table of contents](TOC.md)
-
-# Miscellaneous
-
-* [.gitignore](#gitignore)
-* [.editorconfig](#editorconfig)
-* [Server Configuration](#server-configuration)
-* [robots.txt](#robotstxt)
-* [humans.txt](#humanstxt)
-* [browserconfig.xml](#browserconfigxml)
-* [package.json](#packagejson)
-
---
-
-## .gitignore
-
-HTML5 Boilerplate includes a basic project-level `.gitignore`. This should
-primarily be used to avoid certain project-level files and directories from
-being kept under source control. Different development-environments will
-benefit from different collections of ignores.
-
-OS-specific and editor-specific files should be ignored using a "global
-ignore" that applies to all repositories on your system.
-
-For example, add the following to your `~/.gitconfig`, where the `.gitignore`
-in your HOME directory contains the files and directories you'd like to
-globally ignore:
-
-```gitignore
-[core]
-    excludesfile = ~/.gitignore
-```
-
-* More on global ignores: [https://help.github.com/articles/ignoring-files/](https://help.github.com/en/github/using-git/ignoring-files)
-* Comprehensive set of ignores on GitHub: https://github.com/github/gitignore
-
-## .editorconfig
-
-The `.editorconfig` file is provided in order to encourage and help you and
-your team define and maintain consistent coding styles between different
-editors and IDEs.
-
-By default, `.editorconfig` includes some basic
-[properties](https://editorconfig.org/#supported-properties) that reflect the
-coding styles from the files provided by default, but you can easily change
-them to better suit your needs.
-
-In order for your editor/IDE to apply the
-[properties](https://editorconfig.org/#supported-properties) from the
-`.editorconfig` file, you may need to [install a
-plugin]( https://editorconfig.org/#download).
-
-__N.B.__ If you aren't using the server configurations provided by HTML5
-Boilerplate, we highly encourage you to configure your server to block
-access to `.editorconfig` files, as they can disclose sensitive information!
-
-For more details, please refer to the [EditorConfig
-project](https://editorconfig.org/).
-
-## Server Configuration
-
-H5BP includes a [`.htaccess`](#htaccess) file for the [Apache HTTP
-server](https://httpd.apache.org/docs/). If you are not using Apache
-as your web server, then you are encouraged to download a
-[server configuration](https://github.com/h5bp/server-configs) that
-corresponds to your web server and environment.
-
-A `.htaccess` (hypertext access) file is an [Apache HTTP server
-configuration file](https://github.com/h5bp/server-configs-apache).
-The `.htaccess` file is mostly used for:
-
-* Rewriting URLs
-* Controlling cache
-* Authentication
-* Server-side includes
-* Redirects
-* Gzipping
-
-If you have access to the main server configuration file (usually called
-`httpd.conf`), you should add the logic from the `.htaccess` file in, for
-example, a `<Directory>` section in the main configuration file. This is usually
-the recommended way, as using .htaccess files slows down Apache!
-
-To enable Apache modules locally, please see [the Apache modules documentation](https://github.com/h5bp/server-configs-apache#enable-apache-httpd-modules)
-
-In the repo the `.htaccess` is used for:
-
-* Allowing cross-origin access to web fonts
-* CORS header for images when browsers request it
-* Enable `404.html` as 404 error document
-* Making the website experience better for IE users better
-* Media UTF-8 as character encoding for `text/html` and `text/plain`
-* Enabling the rewrite URLs engine
-* Forcing or removing the `www.` at the begin of a URL
-* It blocks access to directories without a default document
-* It blocks access to files that can expose sensitive information.
-* It reduces MIME type security risks
-* It forces compressing (gzipping)
-* It tells the browser whether they should request a specific file from the
-  server or whether they should grab it from the browser's cache
-
-When using `.htaccess` we recommend reading all inline comments (the rules after
-a `#`) in the file once. There is a bunch of optional stuff in it.
-
-If you want to know more about the `.htaccess` file check out the
-[Apache HTTP server docs](https://httpd.apache.org/docs/) or more
-specifically the [htaccess
-section](https://httpd.apache.org/docs/current/howto/htaccess.html).
-
-Notice that the original repo for the `.htaccess` file is [this
-one](https://github.com/h5bp/server-configs-apache).
-
-## robots.txt
-
-The `robots.txt` file is used to give instructions to web robots on what can
-be crawled from the website.
-
-By default, the file provided by this project includes the next two lines:
-
-* `User-agent: *` -  the following rules apply to all web robots
-* `Disallow:` - everything on the website is allowed to be crawled
-
-If you want to disallow certain pages you will need to specify the path in a
-`Disallow` directive (e.g.: `Disallow: /path`) or, if you want to disallow
-crawling of all content, use `Disallow: /`.
-
-The `/robots.txt` file is not intended for access control, so don't try to
-use it as such. Think of it as a "No Entry" sign, rather than a locked door.
-URLs disallowed by the `robots.txt` file might still be indexed without being
-crawled, and the content from within the `robots.txt` file can be viewed by
-anyone, potentially disclosing the location of your private content! So, if
-you want to block access to private content, use proper authentication instead.
-
-For more information about `robots.txt`, please see:
-
-* [robotstxt.org](https://www.robotstxt.org/)
-* [How Google handles the `robots.txt` file](https://developers.google.com/search/reference/robots_txt)
-
-## humans.txt
-
-The `humans.txt` file is used to provide information about people involved with
-the website.
-
-The provided file contains three sections:
-
-* `TEAM` - this is intended to list the group of people responsible for the website
-* `THANKS` - this is intended to list the group of people that have contributed
-  to the website
-* `TECHNOLOGY COLOPHON` - the section lists technologies used to make the website
-
-For more information about `humans.txt`, please see: http://humanstxt.org/
-
-## browserconfig.xml
-
-The `browserconfig.xml` file is used to customize the tile displayed when users
-pin your site to the Windows 8.1 start screen. In there you can define custom
-tile colors, custom images or even [live tiles](https://docs.microsoft.com/previous-versions/windows/internet-explorer/ie-developer/samples/dn455106(v=vs.85)).
-
-By default, the file points to 2 placeholder tile images:
-
-* `tile.png` (558x558px): used for `Small`, `Medium` and `Large` tiles.
-  This image resizes automatically when necessary.
-* `tile-wide.png` (558x270px): user for `Wide` tiles.
-
-Notice that IE11 uses the same images when adding a site to the `favorites`.
-
-For more in-depth information about the `browserconfig.xml` file, please
-see [MSDN](https://docs.microsoft.com/previous-versions/windows/internet-explorer/ie-developer/platform-apis/dn320426(v=vs.85)).
-
-## package.json
-
-`package.json` is used to define attributes of your site or application for
-use in modern JavaScript development. [The full documentation is available](https://docs.npmjs.com/files/package.json)
-if you're interested. The fields we provide are as follows:
-
-* `title` - the title of your project. If you expect to publish your application
-  to npm, then the name needs to follow [certain guidelines](https://docs.npmjs.com/files/package.json#name)
-  and be unique.
-* `version` - indicates the version of your site application using semantic
-  versioning ([semver](https://docs.npmjs.com/misc/semver))
-* `description` - describes your site.
-* `scripts` - is a JavaScript object containing commands that can be run in a
-  node environment. There are many [built-in keys](https://docs.npmjs.com/misc/scripts)
-  related to the package lifecycle that node understands automatically. You can
-  also define custom scripts for use with your application development. We
-  provide three custom scripts that work with Parcel to get you up and running
-  quickly with a bundler for your assets and a simple development server.
-
-  * `start` builds your site and starts a server
-  * `build` builds your `index.html` using Parcel
-  * `dev` serves your `index.html` with a simple development server
-
-* `keywords` - an array of keywords used to discover your app in the npm
-  registry
-* `author` - defines the author of a package. There is also an alternative
-  [contributors](https://docs.npmjs.com/files/package.json#people-fields-author-contributors)
-  field if there's more than one author.
-* `license` - the license for your application. Must conform to
-  [specific rules](https://docs.npmjs.com/files/package.json#license)
-* `devDependencies` - development dependencies for your package. In our case
-  it's a single dependency, Parcel, which we use to bundle files and run a
-  simple web server.

src/humans.txt

@@ -1,15 +0,0 @@
-# humanstxt.org/
-# The humans responsible & technology colophon
-
-# TEAM
-
-    <name> -- <role> -- <twitter>
-
-# THANKS
-
-    <name>
-
-# TECHNOLOGY COLOPHON
-
-    CSS3, HTML5
-    Apache Server Configs, jQuery, Modernizr, Normalize.css

src/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" viewBox="0 0 192 192"><path fill="#e08524" d="M75.3 73.4H18.4l45.3 34.3L48.3 163l46.1-32.3 48.2 34.6-16.9-58.3 44.9-33.6H115l-20.5-55-19.2 55z"/><path d="m96.7 18.8 18.2 8.2 16.5 44.3h-15.1L96.7 18.8zm-47 146 18.7 9.9 42.6-29.9-16.5-11.4-44.8 31.4zm79.1-56.8 17.4 9.4 18.6 60.1-19.7-11.3-16.3-58.2z"/><path d="m173.1 74.3 17.8 9.2-44.7 34-17.4-9.4 44.3-33.8z"/></svg>

src/index.html

@@ -1,24 +1,24 @@
 <!doctype html>
-<html class="no-js" lang="">
+<html lang="">
 
 <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="">
   <meta property="og:url" content="">
   <meta property="og:image" content="">
+  <meta property="og:image:alt" content="">
+
+  <link rel="icon" href="/favicon.ico" sizes="any">
+  <link rel="icon" href="/icon.svg" type="image/svg+xml">
+  <link rel="apple-touch-icon" href="icon.png">
 
   <link rel="manifest" href="site.webmanifest">
-  <link rel="apple-touch-icon" href="icon.png">
-  <!-- Place favicon.ico in the root directory -->
-
-  <link rel="stylesheet" href="css/normalize.css">
-  <link rel="stylesheet" href="css/main.css">
-
   <meta name="theme-color" content="#fafafa">
 </head>
 
@@ -26,16 +26,8 @@
 
   <!-- Add your site or application content here -->
   <p>Hello world! This is HTML5 Boilerplate.</p>
-  <script src="js/vendor/modernizr-{{MODERNIZR_VERSION}}.min.js"></script>
-  <script src="js/plugins.js"></script>
-  <script src="js/main.js"></script>
+  <script src="js/app.js"></script>
 
-  <!-- Google Analytics: change UA-XXXXX-Y to be your site's ID. -->
-  <script>
-    window.ga = function () { ga.q.push(arguments) }; ga.q = []; ga.l = +new Date;
-    ga('create', 'UA-XXXXX-Y', 'auto'); ga('set', 'anonymizeIp', true); ga('set', 'transport', 'beacon'); ga('send', 'pageview')
-  </script>
-  <script src="https://www.google-analytics.com/analytics.js" async></script>
 </body>
 
 </html>

src/js/plugins.js

@@ -1,24 +0,0 @@
-// Avoid `console` errors in browsers that lack a console.
-(function() {
-  var method;
-  var noop = function () {};
-  var methods = [
-    'assert', 'clear', 'count', 'debug', 'dir', 'dirxml', 'error',
-    'exception', 'group', 'groupCollapsed', 'groupEnd', 'info', 'log',
-    'markTimeline', 'profile', 'profileEnd', 'table', 'time', 'timeEnd',
-    'timeline', 'timelineEnd', 'timeStamp', 'trace', 'warn'
-  ];
-  var length = methods.length;
-  var console = (window.console = window.console || {});
-
-  while (length--) {
-    method = methods[length];
-
-    // Only stub undefined methods.
-    if (!console[method]) {
-      console[method] = noop;
-    }
-  }
-}());
-
-// Place any jQuery/helper plugins in here.

src/package.json

@@ -2,16 +2,23 @@
   "name": " ",
   "version": "0.0.1",
   "description": "",
-  "keywords": "",
+  "private": true,
+  "keywords": [
+    ""
+  ],
   "license": "",
   "author": "",
   "scripts": {
-    "build": "parcel build index.html",
-    "dev": "parcel index.html --open",
-    "start": "npm run build && npm run dev",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "webpack serve --open --config webpack.config.dev.js",
+    "build": "webpack --config webpack.config.prod.js"
   },
   "devDependencies": {
-    "parcel-bundler": "^1.12.4"
+    "copy-webpack-plugin": "^13.0.1",
+    "html-webpack-plugin": "^5.6.4",
+    "webpack": "^5.101.3",
+    "webpack-cli": "^6.0.1",
+    "webpack-dev-server": "^5.2.2",
+    "webpack-merge": "^6.0.1"
   }
 }

src/robots.txt

@@ -1,4 +1,4 @@
-# www.robotstxt.org/
+# https://www.robotstxt.org/
 
 # Allow crawling of all content
 User-agent: *

src/webpack.common.js

@@ -0,0 +1,12 @@
+const path = require('path');
+
+module.exports = {
+  entry: {
+    app: './js/app.js',
+  },
+  output: {
+    path: path.resolve(__dirname, 'dist'),
+    clean: true,
+    filename: './js/app.js',
+  },
+};

src/webpack.config.dev.js

@@ -0,0 +1,13 @@
+const { merge } = require('webpack-merge');
+const common = require('./webpack.common.js');
+
+module.exports = merge(common, {
+  mode: 'development',
+  devtool: 'inline-source-map',
+  devServer: {
+    liveReload: true,
+    hot: true,
+    open: true,
+    static: ['./'],
+  },
+});

src/webpack.config.prod.js

@@ -0,0 +1,26 @@
+const { merge } = require('webpack-merge');
+const common = require('./webpack.common.js');
+const HtmlWebpackPlugin = require('html-webpack-plugin');
+const CopyPlugin = require('copy-webpack-plugin');
+
+module.exports = merge(common, {
+  mode: 'production',
+  plugins: [
+    new HtmlWebpackPlugin({
+      template: './index.html',
+    }),
+    new CopyPlugin({
+      patterns: [
+        { from: 'img', to: 'img' },
+        { from: 'css', to: 'css' },
+        { from: 'js/vendor', to: 'js/vendor' },
+        { from: 'icon.svg', to: 'icon.svg' },
+        { from: 'favicon.ico', to: 'favicon.ico' },
+        { from: 'robots.txt', to: 'robots.txt' },
+        { from: 'icon.png', to: 'icon.png' },
+        { from: '404.html', to: '404.html' },
+        { from: 'site.webmanifest', to: 'site.webmanifest' },
+      ],
+    }),
+  ],
+});

test/file_content.mjs

@@ -1,29 +1,25 @@
 import assert from 'assert';
 import fs from 'fs';
 import path from 'path';
-
-import pkg from './../package.json';
-
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
 const dirs = pkg['h5bp-configs'].directories;
 
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
 function checkString(file, string, done) {
-
   let character = '';
   let matchFound = false;
   let matchedPositions = 0;
-  const readStream = fs.createReadStream(file, {'encoding': 'utf8'});
+  const readStream = fs.createReadStream(file, { encoding: 'utf8' });
 
   readStream.on('close', done);
   readStream.on('error', done);
   readStream.on('readable', function () {
-
     // Read file until the string is found
     // or the whole file has been read
-    while (matchFound !== true &&
-                (character = readStream.read(1)) !== null) {
-
+    while (matchFound !== true && (character = readStream.read(1)) !== null) {
       if (character === string.charAt(matchedPositions)) {
         matchedPositions += 1;
       } else {
@@ -33,41 +29,24 @@ function checkString(file, string, done) {
       if (matchedPositions === string.length) {
         matchFound = true;
       }
-
     }
 
     assert.equal(true, matchFound);
     this.close();
-
   });
-
 }
 
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
 function runTests() {
-
   const dir = dirs.dist;
 
   describe(`Test if the files from the "${dir}" directory have the expected content`, () => {
-
-    it('".htaccess" should have the "ErrorDocument..." line uncommented', (done) => {
-      const string = '\n\nErrorDocument 404 /404.html\n\n';
-      checkString(path.resolve(dir, '.htaccess'), string, done);
-    });
-
-    it('"index.html" should contain the correct Modernizr version in the local URL', (done) => {
-      const string = `js/vendor/modernizr-${pkg.devDependencies.modernizr}.min.js`;
-      checkString(path.resolve(dir, 'index.html'), string, done);
-    });
-
-    it('"main.css" should contain a custom banner', function (done) {
+    it('"style.css" should contain a custom banner', function (done) {
       const string = `/*! HTML5 Boilerplate v${pkg.version} | ${pkg.license} License | ${pkg.homepage} */\n`;
-      checkString(path.resolve(dir, 'css/main.css'), string, done);
+      checkString(path.resolve(dir, 'css/style.css'), string, done);
     });
-
   });
-
 }
 
 runTests();

test/file_existence.mjs

@@ -1,92 +1,74 @@
 import assert from 'assert';
 import fs from 'fs';
 import path from 'path';
-import glob from 'glob';
-
-import pkg  from './../package.json';
-
+import { globSync } from 'glob';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
 const dirs = pkg['h5bp-configs'].directories;
 
-const expectedFilesInArchiveDir = [
-  `${pkg.name}_v${pkg.version}.zip`
-];
+const expectedFilesInArchiveDir = [`${pkg.name}_v${pkg.version}.zip`];
 
 const expectedFilesInDistDir = [
-
   '.editorconfig',
   '.gitattributes',
   '.gitignore',
-  '.htaccess',
   '404.html',
   'package.json',
-  'browserconfig.xml',
+
+  'webpack.common.js',
+  'webpack.config.dev.js',
+  'webpack.config.prod.js',
 
   'css/', // for directories, a `/` character
   // should be included at the end
-  'css/main.css',
-  'css/normalize.css',
-
-  'doc/',
-  'doc/TOC.md',
-  'doc/css.md',
-  'doc/extend.md',
-  'doc/faq.md',
-  'doc/html.md',
-  'doc/js.md',
-  'doc/misc.md',
-  'doc/usage.md',
+  'css/style.css',
 
   'favicon.ico',
-  'humans.txt',
 
   'icon.png',
+  'icon.svg',
 
   'img/',
-  'img/.gitignore',
+  'img/.gitkeep',
 
   'index.html',
 
   'js/',
-  'js/main.js',
-  'js/plugins.js',
+  'js/app.js',
   'js/vendor/',
-  `js/vendor/modernizr-${pkg.devDependencies.modernizr}.min.js`,
-
+  'js/vendor/.gitkeep',
   'LICENSE.txt',
   'robots.txt',
   'site.webmanifest',
-  'tile-wide.png',
-  'tile.png'
-
 ];
 
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
 function checkFiles(directory, expectedFiles) {
-
   // Get the list of files from the specified directory
-  const files = glob.sync('**/*', {
-    'cwd': directory,
-    'ignore': [
+  const files = globSync('**/*', {
+    cwd: directory,
+    ignore: [
       '**/node_modules/**',
       'package-lock.json',
       '**/dist/**',
       '**/.cache/**',
     ],
-    'dot': true,      // include hidden files
-    'mark': true      // add a `/` character to directory matches
+    dot: true, // include hidden files
+    mark: true, // add a `/` character to directory matches,
+    posix: true, //https://github.com/isaacs/node-glob/issues/467
   });
 
   // Check if all expected files are present in the
   // specified directory, and are of the expected type
   expectedFiles.forEach((file) => {
-
     let ok = false;
-    const expectedFileType = (file.slice(-1) !== '/' ? 'regular file' : 'directory');
+    const expectedFileType =
+      file.slice(-1) !== '/' ? 'regular file' : 'directory';
 
     // If file exists
     if (files.indexOf(file) !== -1) {
-
       // Check if the file is of the correct type
       if (file.slice(-1) !== '/') {
         // Check if the file is really a regular file
@@ -95,35 +77,32 @@ function checkFiles(directory, expectedFiles) {
         // Check if the file is a directory
         // (Since glob adds the `/` character to directory matches,
         // we can simply check if the `/` character is present)
-        ok = (files[files.indexOf(file)].slice(-1) === '/');
+        ok = files[files.indexOf(file)].slice(-1) === '/';
       }
-
     }
 
-    it(`"${file}" should be present and it should be a ${expectedFileType}`, () =>{
+    it(`"${file}" should be present and it should be a ${expectedFileType}`, () => {
       assert.equal(true, ok);
     });
-
   });
 
   // List all files that should be NOT
   // be present in the specified directory
-  (files.filter((file) => {
-    return expectedFiles.indexOf(file) === -1;
-  })).forEach((file) => {
-    it(`"${file}" should NOT be present`, () => {
-      assert(false);
+  files
+    .filter((file) => {
+      return expectedFiles.indexOf(file) === -1;
+    })
+    .forEach((file) => {
+      it(`"${file}" should NOT be present`, () => {
+        assert(false);
+      });
     });
-  });
-
 }
 
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
 function runTests() {
-
   describe('Test if all the expected files, and only them, are present in the build directories', () => {
-
     describe(dirs.archive, () => {
       checkFiles(dirs.archive, expectedFilesInArchiveDir);
     });
@@ -131,9 +110,7 @@ function runTests() {
     describe(dirs.dist, () => {
       checkFiles(dirs.dist, expectedFilesInDistDir);
     });
-
   });
-
 }
 
 runTests();