From 46ec1750ad5c949f88ba4745ff8c1eefc59af66d Mon Sep 17 00:00:00 2001 From: Lennart Date: Sat, 6 Oct 2018 20:43:47 +0200 Subject: [PATCH 1/3] feat(docs): Add short note about WSL A short entry about the Windows Subsystem for Linux which makes developing on windows way easier! The official windows docs are linked which are good enough to get started. --- docs/docs/gatsby-on-windows.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/docs/gatsby-on-windows.md b/docs/docs/gatsby-on-windows.md index 9ec2d576e4283..4a9ab4d9c2f87 100644 --- a/docs/docs/gatsby-on-windows.md +++ b/docs/docs/gatsby-on-windows.md @@ -78,3 +78,7 @@ further instructions and contact the `node-gyp`team on ## gatsby-plugin-sharp requires Node x64 Some plugins which depend on native NPM dependencies require the Node x64 build of Node.js. If you're struggling to install gatsby-plugin-sharp, try installing Node x64 and removing `node_modules` and running `npm install`. + +## Windows Subsystem for Linux + +If the installation of dependencies or developing on Windows in general gives you headaches, Windows 10 provides you an great alternative: [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about). It lets you run most command-line tools, utilities, and applications in a GNU/Linux environment directly on Windows, unmodified, without the overhead of a virtual machine. In the above scenario you would download e.g. Ubuntu, open the terminal, [install Node](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions), and run `sudo apt-get install build-essential` in the terminal — and the compilation works way more reliable. From 51850ff54aed3fd4ca653648eab46287e4118e92 Mon Sep 17 00:00:00 2001 From: Lennart Date: Sat, 6 Oct 2018 20:45:49 +0200 Subject: [PATCH 2/3] Typo --- docs/docs/gatsby-on-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/gatsby-on-windows.md b/docs/docs/gatsby-on-windows.md index 4a9ab4d9c2f87..2ece56ec1670d 100644 --- a/docs/docs/gatsby-on-windows.md +++ b/docs/docs/gatsby-on-windows.md @@ -81,4 +81,4 @@ Some plugins which depend on native NPM dependencies require the Node x64 build ## Windows Subsystem for Linux -If the installation of dependencies or developing on Windows in general gives you headaches, Windows 10 provides you an great alternative: [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about). It lets you run most command-line tools, utilities, and applications in a GNU/Linux environment directly on Windows, unmodified, without the overhead of a virtual machine. In the above scenario you would download e.g. Ubuntu, open the terminal, [install Node](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions), and run `sudo apt-get install build-essential` in the terminal — and the compilation works way more reliable. +If the installation of dependencies or developing on Windows in general gives you headaches, Windows 10 provides an great alternative: [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about). It lets you run most command-line tools, utilities, and applications in a GNU/Linux environment directly on Windows, unmodified, without the overhead of a virtual machine. In the above scenario you would download e.g. Ubuntu, open the terminal, [install Node](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions), and run `sudo apt-get install build-essential` in the terminal — and the compilation works way more reliable. From ddd184f3d1964ec189a5126e2c97ed12fea78d47 Mon Sep 17 00:00:00 2001 From: Lennart Date: Mon, 8 Oct 2018 20:03:30 +0200 Subject: [PATCH 3/3] Add note about node_modules --- docs/docs/gatsby-on-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/gatsby-on-windows.md b/docs/docs/gatsby-on-windows.md index 2ece56ec1670d..62ed67173d94b 100644 --- a/docs/docs/gatsby-on-windows.md +++ b/docs/docs/gatsby-on-windows.md @@ -81,4 +81,4 @@ Some plugins which depend on native NPM dependencies require the Node x64 build ## Windows Subsystem for Linux -If the installation of dependencies or developing on Windows in general gives you headaches, Windows 10 provides an great alternative: [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about). It lets you run most command-line tools, utilities, and applications in a GNU/Linux environment directly on Windows, unmodified, without the overhead of a virtual machine. In the above scenario you would download e.g. Ubuntu, open the terminal, [install Node](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions), and run `sudo apt-get install build-essential` in the terminal — and the compilation works way more reliable. +If the installation of dependencies or developing on Windows in general gives you headaches, Windows 10 provides an great alternative: [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about). It lets you run most command-line tools, utilities, and applications in a GNU/Linux environment directly on Windows, unmodified, without the overhead of a virtual machine. In the above scenario you would download e.g. Ubuntu, open the terminal, [install Node](https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions), and run `sudo apt-get install build-essential` in the terminal — and the compilation works way more reliable. Please note that you have to delete any existing `node_modules` folder in your project and re-install the dependencies in your WSL environment.