Gatsby: Gatsby on Linux documentation

Created on 20 Feb 2018  路  8Comments  路  Source: gatsbyjs/gatsby

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

documentation

Most helpful comment

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

All 8 comments

This one started? Up my alley and I could help

鉂わ笍馃檹 @igolden Yay! (and no, only what's in #4127)

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

@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.

Hey @m-allanson thanks 馃憤

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

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 :)

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

We did this 馃憤

Was this page helpful?
0 / 5 - 0 ratings

Related issues

benstr picture benstr  路  3Comments

ferMartz picture ferMartz  路  3Comments

dustinhorton picture dustinhorton  路  3Comments

jimfilippou picture jimfilippou  路  3Comments

timbrandin picture timbrandin  路  3Comments