Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Windows quickstart tutorial on CONTRIBUTING.md #330

Merged
merged 1 commit into from
Dec 22, 2017
Merged

Windows quickstart tutorial on CONTRIBUTING.md #330

merged 1 commit into from
Dec 22, 2017

Conversation

kataras
Copy link
Contributor

@kataras kataras commented Dec 21, 2017

Developer notes::Starting a local instance

Windows

  1. Install Ruby: https://rubyinstaller.org/
    • After the installation check the box and type 3 to select the 3rd option
    • Add C:\msys64\usr\bin to PATH env variable
    • Add C:\Ruby24-x64\bin to PATH env variable
  2. Install yarn: https://yarnpkg.com/en/docs/install#windows
  3. Install jekyll via command prompt: gem install jekyll bundler
  4. Install nodejs && npm: https://nodejs.org/en/download/
  5. Install webpack via command prompt: npm install -g webpack
  6. If you have any issues after installing ruby, like HOMEPATH is not defined, then execute the below commands:
SETX HOMEDRIVE %SYSTEMDRIVE% -m
SETX HOMEPATH \Users\%username% -m
SET HOME=%SYSTEMDRIVE%\Users\%USERNAME%
SETX HOME "%HOME%"

Start Jekyll and Webpack

Go wherever the project's files are located and open a new command prompt, execute the below commands:

yarn install
bundle install
SET PORT=4001
yarn run dev

Developer notes::Starting a local instance

### Windows

1. Install **Ruby**: https://rubyinstaller.org/
	* After the installation check the box and type `3` to select the 3rd option
	* Add `C:\msys64\usr\bin` to PATH env variable 
	* Add `C:\Ruby24-x64\bin` to PATH env variable
2. Install **yarn**: https://yarnpkg.com/en/docs/install#windows
3. Install **jekyll** via command prompt: `gem install jekyll bundler`
4. Install **nodejs && npm**: https://nodejs.org/en/download/
4. Install **webpack** via command prompt: `npm install -g webpack`
5. If you have any issues after installing ruby, like `HOMEPATH` is not defined, then execute the below commands:
```bash
SETX HOMEDRIVE %SYSTEMDRIVE% -m
SETX HOMEPATH \Users\%username% -m
SET HOME=%SYSTEMDRIVE%\Users\%USERNAME%
SETX HOME "%HOME%"
```

#### Start Jekyll and Webpack

Go wherever the project's files are located and open a new command prompt, execute the below commands:

```bash
yarn install
bundle install
SET PORT=4001
yarn run dev
```
@rstacruz
Copy link
Owner

Wow! I don't have a Windows machine to try this on so I'll have to trust your judgement on this :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants