unable to install on macOS 10.12

[appsird]

I spent several hours trying to install on above release, to no avail. unable to install Ruby, etc. has anyone been successful in this release. seems most directories cannot be written even with sudo

[chuckhoupt]

There are several ways to install Ruby. I currently use the Homebrew package which doesn't require sudo. The current versions are Ruby 2.4.1p111 and Jekyll 3.5.2.

[appsird]

I receive hundreds of errors when attempting:

brew install ruby

see below for a portion:

[image: Inline image 1]

On Mon, Aug 21, 2017 at 9:27 AM, Chuck Houpt notifications@github.com wrote:

There are several ways to install Ruby. I currently use the Homebrew package https://www.ruby-lang.org/en/documentation/installation/#homebrew which doesn't require sudo. The current versions are Ruby 2.4.1p111 and Jekyll 3.5.2.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/chuckhoupt/jekyll-apple-help/issues/17#issuecomment-323791557, or mute the thread https://github.com/notifications/unsubscribe-auth/AIFFGcYXmmCTfO60LT6K55n5XCodIAmjks5saa_1gaJpZM4O8qWz .

[appsird]

[appsird]

Also attempted as stated:

sudo rm -fr /usr/local/share/doc/homebrew

Then,

brew update

which stated:

Already up-to-date.

Tried the original 'new install ruby' and received same errors

[chuckhoupt]

Looks like you may have a non-homebrew copy of OpenSSL installed in /usr/local, or possibly the copy was installed as another user (root, etc)? You might check what brew doctor reports.

[appsird]

Not much interesting here.

If looks like you produced a nice setup for Help generation.

I previously had another account on this computer under a different name, and that account is now deleted. possibly it was installed under that user. Though I though using sudo would override and allow install - appears not.

__

brew doctor

Please note that these warnings are just used to help the Homebrew maintainers

with debugging if you file an issue. If everything you use Homebrew for is

working fine: please don't worry and just ignore them. Thanks!

Warning: You have unlinked kegs in your Cellar

Leaving kegs unlinked can lead to build-trouble and cause brews that depend on

those kegs to fail to run properly once built. Run brew link on these:

autoconf

pkg-config

rbenv

ruby-build

Warning: Some directories in your path end in a slash.

Directories in your path should not end in a slash. This can break other

doctor checks. The following directories should be edited:

./

On Tue, Aug 22, 2017 at 8:38 AM, Chuck Houpt notifications@github.com wrote:

Looks like you may have a non-homebrew copy of OpenSSL installed in /usr/local, or possibly the copy was installed as another user (root, etc)? You might check what brew doctor reports.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/chuckhoupt/jekyll-apple-help/issues/17#issuecomment-324065889, or mute the thread https://github.com/notifications/unsubscribe-auth/AIFFGdHD_saO-CzJiQREMweNOwwJzkQZks5savX-gaJpZM4O8qWz .

[appsird]

I noticed the openssl files were created with user 'admin'. My account was already an admin account, though I created a new account user 'admin' with admin capabilities. I could then install Ruby without issues.

What is the easiest/best means to install Jekyll

[appsird]

before I continue with the install, does it work for Xcode 8 and Xcode 9?

[appsird]

I installed Jekyll and was able to download and compile the sample MyApp and display the help page. Thanks. Seems I have it working, now for the details of my help.

[chuckhoupt]

I haven't tested with Xcode 9, but it sounds like you've got it working.

[appsird]

I was able to compile and run your sample app with Xcode 8 and Xcode 9 beta.

Though, integrating the same into my app is proving a challenge. I believe because my app name has spaces within the name, and/or because the bundle is .net.appsird....

I will attempt once more, though several hours on this thus far and coming up empty.

On Tue, Aug 22, 2017 at 12:50 PM, Chuck Houpt notifications@github.com wrote:

I haven't tested with Xcode 9, but it sounds like you've got it working.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/chuckhoupt/jekyll-apple-help/issues/17#issuecomment-324132772, or mute the thread https://github.com/notifications/unsubscribe-auth/AIFFGZHXDgx1S9pPSOgPHUAHPdiSbwBKks5sazDrgaJpZM4O8qWz .

[appsird]

I have spent three days on this, somewhat embarrassing at this stage. Again, I can compile and run your sample app in Xcode 8 and Xcode 9 without issues

Attached is a sample project called Blobber where I integrated as per your instructions. Though when selecting the Help receive an error message "The selected topic is currently unavailable". Would appreciate if you could explain where I am going wrong here.

Blobber.zip

[appsird]

I figured out my error.

For anyone else, this step:

Add product MyAppHelp.help to app target (via File Inspector)

implies you need to set the target for the MyAppHelp as per picture below. note Target Membership for the App while is checked while MyAppHelp.help is selected.