astefanutti / decktape

PDF exporter for HTML presentations
MIT License
2.19k stars 176 forks source link

installation on windows #145

Closed akakeronos closed 6 years ago

akakeronos commented 6 years ago

I tried to install decktape on my computer running windows 10 (sorry:)) and the instructions displayed on the README file did not work.

I finally managed to install it running the following command

 npm i -g --production windows-build-tools
 npm install --global node-gyp
 npm install --global node-pre-gyp
 npm i hummus --save
 npm install -g --unsafe-perm decktape

In case this helps

Thanks for this great piece of software

astefanutti commented 6 years ago

Thanks for the instructions. I'll add these to an FAQ or troubleshooting section.

thom4parisot commented 6 years ago

By looking at the hummus.js repo, it looks like that's where the node-gyp and node-pre-gyp deps are located.

I suspect a clean install of decktape for Windows could evolve to this:

npm i -g --production windows-build-tools
npm install -g --unsafe-perm decktape

I'm unsure wether --unsafe-perm (aka "runs as root") is necessary or not—I guess necessary to run build scripts and stuff.

@akakeronos did you install Node on Windows with the official installer?

akakeronos commented 6 years ago

Yes I did. I installed the 5.6.0 version

astefanutti commented 6 years ago

@oncletom I agree this should be condensed. I may find the time to test it, otherwise I'd be inclined to document your condensed instructions and get feedback.

thom4parisot commented 6 years ago

Okay! I installed a Windows10 VM on macOS (thanks iectrl) to dig this a bit further.

On a fresh Win10 machine, the install step is two-fold.

  1. Open a Powershell prompt in Run as administrator to install Visual Studio Build Tools and Python 2.7 :
npm i -g --production windows-build-tools
  1. Open a Node prompt or regular Powershell prompt to install decktape as usual:
npm i -g decktape

Thanks @akakeronos — I've learned about windows-build-tools (easiest way to install Node build tools in a Node fashion for Windows) and about the --unsafe-perm flag :-)

astefanutti commented 6 years ago

@oncletom @akakeronos thanks! I wish everybody would contribute as you've done 😉!

akakeronos commented 6 years ago

Thanks for this great piece of software !

astefanutti commented 6 years ago

I've just added these instructions to the FAQ with c062d1f2405ee367d0439c791db6cfc86a7e6c91.

Let me know if you have any comments and thanks again for getting the bottom line.

astefanutti commented 6 years ago

Thanks for this great piece of software !

@akakeronos you may want to ⭐️ the project to show support 😉!

akakeronos commented 6 years ago

Will do! ;)