Instruct user to use npx in home page

[Flimm]

This command fails on some systems:

npm install -g @11ty/eleventy

For instance, on Ubuntu 20.04 LTS, it fails with this error message:

npm ERR! Error: EACCES: permission denied, access '/usr/local/lib'

These are instructions on how to start quickly... Let's use npx the way it was intended to be used. This matches documentation in other places.

[binyamin]

@Flimm On ubuntu, you should probably use sudo

[Flimm]

Even on Ubuntu, you might be using a user account without sudo privileges. I like my pull request better, as it works for all operating systems, whether the user is an administrator or not, and it matches documentation in other places. The only requirement is that Node is installed.

[binyamin]

Good point

[Ryuno-Ki]

I'd advise against global installation of Node packages. Imagine, you want to use different versions in different projects?
You can't! Instead, install it locally and either define a NPM run-script or add it to PATH.

For example, on Ubuntu, you could create a directory $HOME/bin, install Node packages there locally and add $HOME/bin/node_modules/.bin to $PATH.

[Flimm]

I'd advise against global installation of Node packages. Imagine, you want to use different versions in different projects?
You can't! Instead, install it locally and either define a NPM run-script or add it to PATH.

Just to be clear: the current instructions on the home page do advise global installation, but the fix in this pull request does not. I agree that global installation is bad, which is why I removed that in the pull request.

My pull request allows you to install different versions for different projects, without having to define an NPM run-script or add it to the PATH. This is because npx looks in node_modules for the package before it looks anywhere else, and the instructions as written in the pull request instruct the user to run npm install @11ty/eleventy first. This matches other eleventy documentation.

[Ryuno-Ki]

My comment was aimed at @binyamin :-)

Thanks for your effort, @Flimm :-)

[zachleat]

Ooh I like this change a lot.

I do wonder if these npm WARNs would be confusing to people though:

npm WARN saveError ENOENT: no such file or directory, open '/Users/zachleat/Temp/eleventy-test-npx/package.json'
npm notice created a lockfile as package-lock.json. You should commit this file.
npm WARN enoent ENOENT: no such file or directory, open '/Users/zachleat/Temp/eleventy-test-npx/package.json'
npm WARN eleventy-test-npx No description
npm WARN eleventy-test-npx No repository field.
npm WARN eleventy-test-npx No README data
npm WARN eleventy-test-npx No license field.

[tannerdolby]

If you run npm init -y and generate a default package.json before running the install will the same npm WARN errors be thrown?

[zachleat]

Finally coming back to this one—super on board, seems like the npm stuff has been smoothed out a bit too. Here’s what I see running this now:

~/Temp/eleventy-website-797 ᐅ npx @11ty/eleventy
Need to install the following packages:
  @11ty/eleventy
Ok to proceed? (y) y
npm WARN deprecated debug@4.1.1: Debug versions >=3.2.0 <3.2.7 || >=4 <4.3.1 have a low-severity ReDos regression when used in a Node.js environment. It is recommended you upgrade to 3.2.7 or 4.3.1. (https://github.com/visionmedia/debug/issues/797)
npm WARN deprecated debug@4.1.1: Debug versions >=3.2.0 <3.2.7 || >=4 <4.3.1 have a low-severity ReDos regression when used in a Node.js environment. It is recommended you upgrade to 3.2.7 or 4.3.1. (https://github.com/visionmedia/debug/issues/797)
npm WARN deprecated debug@4.1.1: Debug versions >=3.2.0 <3.2.7 || >=4 <4.3.1 have a low-severity ReDos regression when used in a Node.js environment. It is recommended you upgrade to 3.2.7 or 4.3.1. (https://github.com/visionmedia/debug/issues/797)
[11ty] Writing _site/test/index.html from ./test.md (liquid)
[11ty] Wrote 1 file in 0.03 seconds (v1.0.0)

Those warnings are from browser-sync (and notably also happen on global installation too). Follow along for those at 11ty/eleventy#2213

[zachleat]

🚢🛳⛴🚀📦