Gatsby on Linux documentation

[m-allanson]

Create a "Setup Gatsby on Linux" page similar to the Windows docs.

From #4127:

• incorporate @KyleAMathews comments about mentioning native compilation + Python preqrequisites.
• And @brainwipe's docs (listed below):

Prerequisites

Starters may use npm plugins that require native node extensions. For those to build, you will need to install build-essential from your package source.

For example, on Debian/Ubuntu:

sudo apt-get install build-essential

[igolden]

This one started? Up my alley and I could help

[fk]

❤️🙏 @igolden Yay! (and no, only what's in #4127)

[spences10]

I'm checking for Windows Documentation using Windows Subsystem Linux (WSL) if there isn't any in the works I'd like to contribute what I have done for my own personal documentation.

Let me know if I need to raise an issue 👍

Just for info for those that are not aware WSL has been available in Windows 10 via the Windows Store since the Fall Creators Update there will be a very large portion of developers that could use this instead of the song and dance you have to go through installing windows-build-tools and then maybe Visual Studio Community 2015 and Python.

It's basically the Linux install, the documentation goes over using n in place of nvm as nvm is known to slow bash startup on WSL I point to using n-install to get the latest version of node without any permission errors like you get with the official install of node, which isn't sudo apt get node as that installs node legacy @~v4

[m-allanson]

@spences10 Good idea @spences10 - I think this could make a good section to add to a Gatsby on Linux docs page. Pointing out differences specific to using WSL vs a more traditional flavour of Linux.

Note that sharp (used by gatsby-plugin-sharp) now ships with prebuilt binaries for common platforms, so it's much less common for a platform's build tools to be required for Gatsby projects.

[spences10]

Hey @m-allanson thanks 👍

Is there anything you'd like me to contribute or do you have this on your list?

[m-allanson]

I'd love if you wanted to create a Gatsby on Linux docs page? Similar to the Gatsby on Windows page. Even if it's some placeholder content followed by your WSL content that would be great.

The WSL section could cover installing Node correctly along with the build tools. I'd skip anything from your own documentation that veers towards personal preferences :)

[spences10]

Sure, I'll put something together in a PR, thanks 👍

[KyleAMathews]

We did this 👍