You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ja...@apache.org on 2018/02/28 13:52:34 UTC
[cordova-docs] branch master updated: Updated installation steps
and troubleshooting for dev environment setup of cordova-docs (#794)
This is an automated email from the ASF dual-hosted git repository.
janpio pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
The following commit(s) were added to refs/heads/master by this push:
new e0cd5fa Updated installation steps and troubleshooting for dev environment setup of cordova-docs (#794)
e0cd5fa is described below
commit e0cd5fa8fe9a5f6fd96c189b2f123f266faea153
Author: Gandhirajan <ga...@gmail.com>
AuthorDate: Wed Feb 28 19:22:32 2018 +0530
Updated installation steps and troubleshooting for dev environment setup of cordova-docs (#794)
* added info on git clone and troubleshooting
* minor formatting change
* implemented PR review comments
* implemented PR review comments
---
doc/installing-a-development-environment.md | 33 ++++++++++++++++++++++++++++-
doc/troubleshooting.md | 17 ---------------
2 files changed, 32 insertions(+), 18 deletions(-)
diff --git a/doc/installing-a-development-environment.md b/doc/installing-a-development-environment.md
index fc7c973..48f8a31 100644
--- a/doc/installing-a-development-environment.md
+++ b/doc/installing-a-development-environment.md
@@ -90,11 +90,15 @@ Verify your Node.js installation by running:
node --version
npm --version
+### Local repo setup
+
+Clone the [cordova-docs] GitHub repo to a local folder.
+
### Dependencies
#### Ruby
-Once Ruby and Node.js are installed, install Ruby dependencies by running:
+Once Ruby and Node.js are installed, navigate to local repo folder and install Ruby dependencies by running:
gem install bundler
bundle install --path ./ruby_modules
@@ -131,6 +135,31 @@ Verify your make installation by running:
make --version
+
+### Troubleshooting
+
+#### SSL certificate issue while executing `gem install bundler` on Windows
+
+Try copying the certificate from [GlobalSignRootCerficateAuthority] into `C:\Ruby22\lib\ruby\2.2.0\rubygems\ssl_certs` folder
+
+#### Permission issues during Ruby install
+
+You could try a different method to install Ruby. Checkout [rbenv](https://github.com/sstephenson/rbenv). Instructions:
+
+1. Install rbenv
+
+ brew install rbenv ruby-build
+
+2. Add `eval "$(rbenv init -)"` to the end of your `.bash_profile`:
+
+ echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
+
+3. Install a version of `ruby` and set it to your local version:
+
+ rbenv install 2.0.0-p647
+ rbenv local 2.0.0-p647
+
+
[ruby_linux]: https://www.ruby-lang.org/en/documentation/installation/#package-management-systems
[homebrew]: http://brew.sh/
[linux_node]: https://nodesource.com/blog/nodejs-v012-iojs-and-the-nodesource-linux-repositories#installing-node-js-v0-12
@@ -144,3 +173,5 @@ Verify your make installation by running:
[python_linux]: http://docs.python-guide.org/en/latest/starting/install/linux/
[make_page]: http://gnuwin32.sourceforge.net/packages/make.htm
[make_setup]: http://gnuwin32.sourceforge.net/downlinks/make.php
+[cordova-docs]: https://github.com/apache/cordova-docs
+[GlobalSignRootCerficateAuthority]: https://raw.githubusercontent.com/rubygems/rubygems/master/lib/rubygems/ssl_certs/index.rubygems.org/GlobalSignRootCA.pem
\ No newline at end of file
diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md
index 478f19a..7e76fed 100644
--- a/doc/troubleshooting.md
+++ b/doc/troubleshooting.md
@@ -12,23 +12,6 @@ Run:
gulp clean
-### Permission issues during Ruby install
-
-You could try a different method to install Ruby. Checkout [rbenv](https://github.com/sstephenson/rbenv). Instructions:
-
-1. Install rbenv
-
- brew install rbenv ruby-build
-
-2. Add `eval "$(rbenv init -)"` to the end of your `.bash_profile`:
-
- echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
-
-3. Install a version of `ruby` and set it to your local version:
-
- rbenv install 2.0.0-p647
- rbenv local 2.0.0-p647
-
### Other Problems
Please ask for help on the Slack channel. Join at [slack.cordova.io](http://slack.cordova.io)
\ No newline at end of file
--
To stop receiving notification emails like this one, please contact
janpio@apache.org.
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org