Asciidoctor on cygwin

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
8 messages Options
Reply | Threaded
Open this post in threaded view
|

Asciidoctor on cygwin

wolandscat
Hi

I just tried to install Asciidoctor under cygwin 64 on a Windows 8 machine using 'gem install asciidoctor'. The installation appeared to finish normally, but I have no idea where it installed, and if I type 'asciidoctor' at the prompt, it's not known. $PATH doesn't appear to contain anything that looks like an Asciidoctor location.

I don't normally work with Ruby, so have no idea where to look for what has been installed. Can anyone point me to the basic steps to getting Asciidoctor working in this environment?

TIA
Reply | Threaded
Open this post in threaded view
|

Re: Asciidoctor on cygwin

ggrossetie
Hi,

I don't really know why the asciidoctor command is not on your path but  you can use the command `gem environment` to know where the gems are installed: http://stackoverflow.com/questions/19072070/how-can-i-find-where-gem-files-are-installed

Then find you can browse to the bin directory inside the asciidoctor gem and execute the asciidoctor command: https://github.com/asciidoctor/asciidoctor/blob/master/bin/asciidoctor


Guillaume

Reply | Threaded
Open this post in threaded view
|

Re: Asciidoctor on cygwin

wolandscat
Thanks. I figured out how to use gem list -d regex, and found it in ~/.gem/ruby/gems/asciidoctor-1.5.1/bin. Is that a normal place for Ruby things to install?

If I try to execute it, I get this:

$ .gem/ruby/gems/asciidoctor-1.5.1/bin/asciidoctor
/usr/share/rubygems/rubygems/core_ext/kernel_require.rb:54:in `require': cannot load such file -- .gem/ruby/gems/asciidoctor-1.5.1/bin/../lib/asciidoctor (LoadError)
        from /usr/share/rubygems/rubygems/core_ext/kernel_require.rb:54:in `require'
        from .gem/ruby/gems/asciidoctor-1.5.1/bin/asciidoctor:5:in `<main>'

Now if I look at what is in ..../bin/../lib, it has:

$ ls -Fx .gem/ruby/gems/asciidoctor-1.5.1/lib
asciidoctor/  asciidoctor.rb

Which is presumably what the script in bin is looking for. There seems something basic wrong here, but I have no idea what. Has anyone tested asciidoctor under cygwin?

thanks

Reply | Threaded
Open this post in threaded view
|

Re: Asciidoctor on cygwin

mojavelinux
Administrator
I haven't tested it myself, but a quick Google search reveals that installing gems should "just work". Thus, it's strange that you are seeing this behavior.

There are a few things to try. First, you can check the value of the GEM_HOME environment variable. It should point to the Ruby installation, not to your home directory. You can force installation into the Ruby install directory (/usr/share/rubygems) using:

 $ gem install --no-user-install asciidoctor

Perhaps that will work. You can also specify the bin directory using the -n flag. That would be more of a last resort.

I would focus on getting a RubyGem installed in Cygwin, not necessarily focused on Asciidoctor. If you can get the RubyGem environment to do the right thing, Asciidoctor will no doubt install flawlessly.

If and when you figure it out, this would certainly be a good thing to document.

-Dan

On Mon, Oct 27, 2014 at 5:34 PM, wolandscat [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Thanks. I figured out how to use gem list -d regex, and found it in ~/.gem/ruby/gems/asciidoctor-1.5.1/bin. Is that a normal place for Ruby things to install?

If I try to execute it, I get this:

$ .gem/ruby/gems/asciidoctor-1.5.1/bin/asciidoctor
/usr/share/rubygems/rubygems/core_ext/kernel_require.rb:54:in `require': cannot load such file -- .gem/ruby/gems/asciidoctor-1.5.1/bin/../lib/asciidoctor (LoadError)
        from /usr/share/rubygems/rubygems/core_ext/kernel_require.rb:54:in `require'
        from .gem/ruby/gems/asciidoctor-1.5.1/bin/asciidoctor:5:in `<main>'

Now if I look at what is in ..../bin/../lib, it has:

$ ls -Fx .gem/ruby/gems/asciidoctor-1.5.1/lib
asciidoctor/  asciidoctor.rb

Which is presumably what the script in bin is looking for. There seems something basic wrong here, but I have no idea what. Has anyone tested asciidoctor under cygwin?

thanks




If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Asciidoctor-on-cygwin-tp2374p2378.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Reply | Threaded
Open this post in threaded view
|

Re: Asciidoctor on cygwin

Andreas
Hello friends. I have exactly the same problem - using Ruby the first time and running in a lot of strange problems on Cygwin.

Sometimes packages are not tested under Cygwin, which is a pitty because there are so many Windows machines out there... but in most cases you can solve the problems on your own. Ruby, however, seems to be very special. No chance. But finally I found this forum, so there's light!

This is what I get:

Narayanananda ~ [0]!521 09:26:55
 > asciidoctor
/usr/share/rubygems/rubygems/dependency.rb:313:in `to_specs': Could not find 'asciidoctor' (>= 0) among 49 total gem(s) (Gem::LoadError)
Checked in 'GEM_PATH=/cygdrive/c/Users/Lenovo/.gem/ruby:/usr/share/gems:/usr/local/share/gems', execute `gem env` for more information
	from /usr/share/rubygems/rubygems/dependency.rb:322:in `to_spec'
	from /usr/share/rubygems/rubygems/core_ext/kernel_gem.rb:58:in `gem'
	from /usr/local/bin/asciidoctor:22:in `<main>'
Here is my path:

Narayanananda ~ [0]!522 09:27:02
 > echo $PATH
/cygdrive/c/Users/Lenovo/bin:/usr/local/bin:/usr/bin:/usr/bin:/cygdrive/c/Program Files/Common Files/...
 > which asciidoctor
/usr/local/bin/asciidoctor

So asciidoctor is on the path, and I can't understand we it is not happy. I had this problem on another machine and found the tip to create a ~/.gemrc file. Here it is:

gemhome: /usr/local
This allowed me to install asciidoctor in the first place (yes, it says /usr/local to make it install into /usr/local/bin).

Narayanananda ~ [0]!524 09:29:19
 > gem environment
RubyGems Environment:
  - RUBYGEMS VERSION: 2.4.1
  - RUBY VERSION: 2.0.0 (2014-10-27 patchlevel 594) [i386-cygwin]
  - INSTALLATION DIRECTORY: /usr/local
  - RUBY EXECUTABLE: /usr/bin/ruby.exe
  - EXECUTABLE DIRECTORY: /usr/local/bin
  - SPEC CACHE DIRECTORY: /cygdrive/c/Users/Lenovo/.gem/specs
  - SYSTEM CONFIGURATION DIRECTORY: /etc
  - RUBYGEMS PLATFORMS:
    - ruby
    - x86-cygwin
  - GEM PATHS:
     - /usr/local
     - /cygdrive/c/Users/Lenovo/.gem/ruby
     - /usr/share/gems
     - /usr/local/share/gems
  - GEM CONFIGURATION:
     - :update_sources => true
     - :verbose => true
     - :backtrace => false
     - :bulk_threshold => 1000
     - "gemhome" => "/usr/local"
  - REMOTE SOURCES:
     - https://rubygems.org/
  - SHELL PATH:
     - /cygdrive/c/Users/Lenovo/bin
     - /usr/local/bin
     - /usr/bin
     - /usr/bin
     - /cygdrive/c/Program Files/Common Files/Microsoft Shared/Windows Live
     - /cygdrive/c/Program Files (x86)/Common Files/Microsoft Shared/Windows Live
     - /cygdrive/c/Program Files (x86)/Intel/iCLS Client
     - /cygdrive/c/Program Files/Intel/iCLS Client
     - /cygdrive/c/Windows/system32
     - /cygdrive/c/Windows
     - /cygdrive/c/Windows/System32/Wbem
     - /cygdrive/c/Windows/System32/WindowsPowerShell/v1.0
     - /cygdrive/c/Program Files/ThinkPad/Bluetooth Software
     - /cygdrive/c/Program Files/ThinkPad/Bluetooth Software/syswow64
     - /cygdrive/c/Program Files/Intel/Intel(R) Management Engine Components/DAL
     - /cygdrive/c/Program Files/Intel/Intel(R) Management Engine Components/IPT
     - /cygdrive/c/Program Files (x86)/Intel/Intel(R) Management Engine Components/DAL
     - /cygdrive/c/Program Files (x86)/Intel/Intel(R) Management Engine Components/IPT
     - /cygdrive/c/Program Files (x86)/Intel/OpenCL SDK/2.0/bin/x86
     - /cygdrive/c/Program Files (x86)/Intel/OpenCL SDK/2.0/bin/x64
     - /cygdrive/c/Program Files/Common Files/Lenovo
     - /cygdrive/c/Program Files (x86)/Common Files/Ulead Systems/MPEG
     - /cygdrive/c/Program Files (x86)/Windows Live/Shared
     - /cygdrive/c/SWTOOLS/ReadyApps
     - /cygdrive/c/Program Files (x86)/Common Files/Lenovo
     - /cygdrive/c/Program Files (x86)/Common Files/Adobe/AGL
     - /cygdrive/c/Program Files (x86)/Microsoft SQL Server/100/Tools/Binn
     - /cygdrive/c/Program Files/Microsoft SQL Server/100/Tools/Binn
     - /cygdrive/c/Program Files/Microsoft SQL Server/100/DTS/Binn
     - /cygdrive/h/usr/wbin
     - /cygdrive/c/Program Files/Intel/WiFi/bin
     - /cygdrive/c/Program Files/Common Files/Intel/WirelessCommon
     - /cygdrive/c/Program Files (x86)/QuickTime/QTSystem
     - /cygdrive/c/Program Files/Intel/WiFi/bin
     - /cygdrive/c/Program Files/Common Files/Intel/WirelessCommon

So this is all I can post :-) Hopefully there's a solution. There seems to be an asciidoctor implementation for Java (AsciidoctorJ). Should I use that? ActuallyI like asciidoctor to be a part of Cygwin, because all my text processing utilities are there.

Happy Christmas & Peace to the world.
Reply | Threaded
Open this post in threaded view
|

Re: Asciidoctor on cygwin

mojavelinux
Administrator
Andreas,

I definitely want to ensure Asciidoctor can be run successfully on Cygwin. I have a Windows box, so I'll spin it up and see what I can find.

In theory, Asciidoctor should "just work" when running on Cygwin if Ruby works. My hunch is that the error has to do with the Ruby setup and is not specific to Asciidoctor.

We do test on Windows {1}...but not on Cygwin. If you are familiar with a continuous integration environment that allows us to test with Cygwin (or you know how to get Cygwin to run on AppVeyor), I'd be glad to run tests in a Cygwin environment on each commit.

Out of curiosity, are you able to run other gems that have a command-line interface in your Cygwin environment? One example you could test is haml.

Cheers,

-Dan

:1: https://ci.appveyor.com/project/asciidoctor/asciidoctor

On Thu, Dec 25, 2014 at 1:37 AM, Andreas [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hello friends. I have exactly the same problem - using Ruby the first time and running in a lot of strange problems on Cygwin.

Sometimes packages are not tested under Cygwin, which is a pitty because there are so many Windows machines out there... but in most cases you can solve the problems on your own. Ruby, however, seems to be very special. No chance. But finally I found this forum, so there's light!

This is what I get:

Narayanananda ~ [0]!521 09:26:55
 > asciidoctor
/usr/share/rubygems/rubygems/dependency.rb:313:in `to_specs': Could not find 'asciidoctor' (>= 0) among 49 total gem(s) (Gem::LoadError)
Checked in 'GEM_PATH=/cygdrive/c/Users/Lenovo/.gem/ruby:/usr/share/gems:/usr/local/share/gems', execute `gem env` for more information
	from /usr/share/rubygems/rubygems/dependency.rb:322:in `to_spec'
	from /usr/share/rubygems/rubygems/core_ext/kernel_gem.rb:58:in `gem'
	from /usr/local/bin/asciidoctor:22:in `<main>'
Here is my path:

Narayanananda ~ [0]!522 09:27:02
 > echo $PATH
/cygdrive/c/Users/Lenovo/bin:/usr/local/bin:/usr/bin:/usr/bin:/cygdrive/c/Program Files/Common Files/...
 > which asciidoctor
/usr/local/bin/asciidoctor

So asciidoctor is on the path, and I can't understand we it is not happy. I had this problem on another machine and found the tip to create a ~/.gemrc file. Here it is:

gemhome: /usr/local
This allowed me to install asciidoctor in the first place (yes, it says /usr/local to make it install into /usr/local/bin).

Narayanananda ~ [0]!524 09:29:19
 > gem environment
RubyGems Environment:
  - RUBYGEMS VERSION: 2.4.1
  - RUBY VERSION: 2.0.0 (2014-10-27 patchlevel 594) [i386-cygwin]
  - INSTALLATION DIRECTORY: /usr/local
  - RUBY EXECUTABLE: /usr/bin/ruby.exe
  - EXECUTABLE DIRECTORY: /usr/local/bin
  - SPEC CACHE DIRECTORY: /cygdrive/c/Users/Lenovo/.gem/specs
  - SYSTEM CONFIGURATION DIRECTORY: /etc
  - RUBYGEMS PLATFORMS:
    - ruby
    - x86-cygwin
  - GEM PATHS:
     - /usr/local
     - /cygdrive/c/Users/Lenovo/.gem/ruby
     - /usr/share/gems
     - /usr/local/share/gems
  - GEM CONFIGURATION:
     - :update_sources => true
     - :verbose => true
     - :backtrace => false
     - :bulk_threshold => 1000
     - "gemhome" => "/usr/local"
  - REMOTE SOURCES:
     - https://rubygems.org/
  - SHELL PATH:
     - /cygdrive/c/Users/Lenovo/bin
     - /usr/local/bin
     - /usr/bin
     - /usr/bin
     - /cygdrive/c/Program Files/Common Files/Microsoft Shared/Windows Live
     - /cygdrive/c/Program Files (x86)/Common Files/Microsoft Shared/Windows Live
     - /cygdrive/c/Program Files (x86)/Intel/iCLS Client
     - /cygdrive/c/Program Files/Intel/iCLS Client
     - /cygdrive/c/Windows/system32
     - /cygdrive/c/Windows
     - /cygdrive/c/Windows/System32/Wbem
     - /cygdrive/c/Windows/System32/WindowsPowerShell/v1.0
     - /cygdrive/c/Program Files/ThinkPad/Bluetooth Software
     - /cygdrive/c/Program Files/ThinkPad/Bluetooth Software/syswow64
     - /cygdrive/c/Program Files/Intel/Intel(R) Management Engine Components/DAL
     - /cygdrive/c/Program Files/Intel/Intel(R) Management Engine Components/IPT
     - /cygdrive/c/Program Files (x86)/Intel/Intel(R) Management Engine Components/DAL
     - /cygdrive/c/Program Files (x86)/Intel/Intel(R) Management Engine Components/IPT
     - /cygdrive/c/Program Files (x86)/Intel/OpenCL SDK/2.0/bin/x86
     - /cygdrive/c/Program Files (x86)/Intel/OpenCL SDK/2.0/bin/x64
     - /cygdrive/c/Program Files/Common Files/Lenovo
     - /cygdrive/c/Program Files (x86)/Common Files/Ulead Systems/MPEG
     - /cygdrive/c/Program Files (x86)/Windows Live/Shared
     - /cygdrive/c/SWTOOLS/ReadyApps
     - /cygdrive/c/Program Files (x86)/Common Files/Lenovo
     - /cygdrive/c/Program Files (x86)/Common Files/Adobe/AGL
     - /cygdrive/c/Program Files (x86)/Microsoft SQL Server/100/Tools/Binn
     - /cygdrive/c/Program Files/Microsoft SQL Server/100/Tools/Binn
     - /cygdrive/c/Program Files/Microsoft SQL Server/100/DTS/Binn
     - /cygdrive/h/usr/wbin
     - /cygdrive/c/Program Files/Intel/WiFi/bin
     - /cygdrive/c/Program Files/Common Files/Intel/WirelessCommon
     - /cygdrive/c/Program Files (x86)/QuickTime/QTSystem
     - /cygdrive/c/Program Files/Intel/WiFi/bin
     - /cygdrive/c/Program Files/Common Files/Intel/WirelessCommon

So this is all I can post :-) Hopefully there's a solution. There seems to be an asciidoctor implementation for Java (AsciidoctorJ). Should I use that? ActuallyI like asciidoctor to be a part of Cygwin, because all my text processing utilities are there.

Happy Christmas & Peace to the world.


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Asciidoctor-on-cygwin-tp2374p2616.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Reply | Threaded
Open this post in threaded view
|

Re: Asciidoctor on cygwin

mojavelinux
Administrator
In reply to this post by Andreas
> There seems to be an asciidoctor implementation for Java (AsciidoctorJ). Should I use that?

I'm confident that will work, though I won't say it's your only option.

You can get the distribution zip {1}, extract it and run the asciidoctorj command found in the bin directory.

We're also exploring a cli for Asciidoctor.js {2}.

Cheers,

-Dan

On Sat, Dec 27, 2014 at 5:04 AM, Dan Allen <[hidden email]> wrote:
Andreas,

I definitely want to ensure Asciidoctor can be run successfully on Cygwin. I have a Windows box, so I'll spin it up and see what I can find.

In theory, Asciidoctor should "just work" when running on Cygwin if Ruby works. My hunch is that the error has to do with the Ruby setup and is not specific to Asciidoctor.

We do test on Windows {1}...but not on Cygwin. If you are familiar with a continuous integration environment that allows us to test with Cygwin (or you know how to get Cygwin to run on AppVeyor), I'd be glad to run tests in a Cygwin environment on each commit.

Out of curiosity, are you able to run other gems that have a command-line interface in your Cygwin environment? One example you could test is haml.

Cheers,

-Dan

:1: https://ci.appveyor.com/project/asciidoctor/asciidoctor

On Thu, Dec 25, 2014 at 1:37 AM, Andreas [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hello friends. I have exactly the same problem - using Ruby the first time and running in a lot of strange problems on Cygwin.

Sometimes packages are not tested under Cygwin, which is a pitty because there are so many Windows machines out there... but in most cases you can solve the problems on your own. Ruby, however, seems to be very special. No chance. But finally I found this forum, so there's light!

This is what I get:

Narayanananda ~ [0]!521 09:26:55
 > asciidoctor
/usr/share/rubygems/rubygems/dependency.rb:313:in `to_specs': Could not find 'asciidoctor' (>= 0) among 49 total gem(s) (Gem::LoadError)
Checked in 'GEM_PATH=/cygdrive/c/Users/Lenovo/.gem/ruby:/usr/share/gems:/usr/local/share/gems', execute `gem env` for more information
	from /usr/share/rubygems/rubygems/dependency.rb:322:in `to_spec'
	from /usr/share/rubygems/rubygems/core_ext/kernel_gem.rb:58:in `gem'
	from /usr/local/bin/asciidoctor:22:in `<main>'
Here is my path:

Narayanananda ~ [0]!522 09:27:02
 > echo $PATH
/cygdrive/c/Users/Lenovo/bin:/usr/local/bin:/usr/bin:/usr/bin:/cygdrive/c/Program Files/Common Files/...
 > which asciidoctor
/usr/local/bin/asciidoctor

So asciidoctor is on the path, and I can't understand we it is not happy. I had this problem on another machine and found the tip to create a ~/.gemrc file. Here it is:

gemhome: /usr/local
This allowed me to install asciidoctor in the first place (yes, it says /usr/local to make it install into /usr/local/bin).

Narayanananda ~ [0]!524 09:29:19
 > gem environment
RubyGems Environment:
  - RUBYGEMS VERSION: 2.4.1
  - RUBY VERSION: 2.0.0 (2014-10-27 patchlevel 594) [i386-cygwin]
  - INSTALLATION DIRECTORY: /usr/local
  - RUBY EXECUTABLE: /usr/bin/ruby.exe
  - EXECUTABLE DIRECTORY: /usr/local/bin
  - SPEC CACHE DIRECTORY: /cygdrive/c/Users/Lenovo/.gem/specs
  - SYSTEM CONFIGURATION DIRECTORY: /etc
  - RUBYGEMS PLATFORMS:
    - ruby
    - x86-cygwin
  - GEM PATHS:
     - /usr/local
     - /cygdrive/c/Users/Lenovo/.gem/ruby
     - /usr/share/gems
     - /usr/local/share/gems
  - GEM CONFIGURATION:
     - :update_sources => true
     - :verbose => true
     - :backtrace => false
     - :bulk_threshold => 1000
     - "gemhome" => "/usr/local"
  - REMOTE SOURCES:
     - https://rubygems.org/
  - SHELL PATH:
     - /cygdrive/c/Users/Lenovo/bin
     - /usr/local/bin
     - /usr/bin
     - /usr/bin
     - /cygdrive/c/Program Files/Common Files/Microsoft Shared/Windows Live
     - /cygdrive/c/Program Files (x86)/Common Files/Microsoft Shared/Windows Live
     - /cygdrive/c/Program Files (x86)/Intel/iCLS Client
     - /cygdrive/c/Program Files/Intel/iCLS Client
     - /cygdrive/c/Windows/system32
     - /cygdrive/c/Windows
     - /cygdrive/c/Windows/System32/Wbem
     - /cygdrive/c/Windows/System32/WindowsPowerShell/v1.0
     - /cygdrive/c/Program Files/ThinkPad/Bluetooth Software
     - /cygdrive/c/Program Files/ThinkPad/Bluetooth Software/syswow64
     - /cygdrive/c/Program Files/Intel/Intel(R) Management Engine Components/DAL
     - /cygdrive/c/Program Files/Intel/Intel(R) Management Engine Components/IPT
     - /cygdrive/c/Program Files (x86)/Intel/Intel(R) Management Engine Components/DAL
     - /cygdrive/c/Program Files (x86)/Intel/Intel(R) Management Engine Components/IPT
     - /cygdrive/c/Program Files (x86)/Intel/OpenCL SDK/2.0/bin/x86
     - /cygdrive/c/Program Files (x86)/Intel/OpenCL SDK/2.0/bin/x64
     - /cygdrive/c/Program Files/Common Files/Lenovo
     - /cygdrive/c/Program Files (x86)/Common Files/Ulead Systems/MPEG
     - /cygdrive/c/Program Files (x86)/Windows Live/Shared
     - /cygdrive/c/SWTOOLS/ReadyApps
     - /cygdrive/c/Program Files (x86)/Common Files/Lenovo
     - /cygdrive/c/Program Files (x86)/Common Files/Adobe/AGL
     - /cygdrive/c/Program Files (x86)/Microsoft SQL Server/100/Tools/Binn
     - /cygdrive/c/Program Files/Microsoft SQL Server/100/Tools/Binn
     - /cygdrive/c/Program Files/Microsoft SQL Server/100/DTS/Binn
     - /cygdrive/h/usr/wbin
     - /cygdrive/c/Program Files/Intel/WiFi/bin
     - /cygdrive/c/Program Files/Common Files/Intel/WirelessCommon
     - /cygdrive/c/Program Files (x86)/QuickTime/QTSystem
     - /cygdrive/c/Program Files/Intel/WiFi/bin
     - /cygdrive/c/Program Files/Common Files/Intel/WirelessCommon

So this is all I can post :-) Hopefully there's a solution. There seems to be an asciidoctor implementation for Java (AsciidoctorJ). Should I use that? ActuallyI like asciidoctor to be a part of Cygwin, because all my text processing utilities are there.

Happy Christmas & Peace to the world.


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Asciidoctor-on-cygwin-tp2374p2616.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--



--
Reply | Threaded
Open this post in threaded view
|

Re: Asciidoctor on cygwin

mojavelinux
Administrator
In reply to this post by Andreas
I was able to use successfully install and use Asciidoctor from Cygwin.

Here are the steps I took, from scratch.

. Installed Cygwin (64-bit) on Windows 8
  - Selected packages: ruby, rubygems

. Opened a Cygwin terminal

. Installed the asciidoctor gem using:

  $ gem install asciidoctor

  - The gem content installed to ~/.gem/ruby/gems/asciidoctor-1.5.2
  - The executables installed to ~/bin

. Created a sample AsciiDoc file named test.adoc in the home directory

. Ran the asciidoctor command on the sample file

  $ ./bin/asciidoctor test.adoc

If you add ~/bin to your PATH, then you can invoke the asciidoctor command from any directory.

- - -

I strongly urge you to use RVM to manage your Ruby installation instead of relying on the system. It has native support for Cygwin! {1} RVM makes managing Ruby and RubyGems very easy (and much more sensible than the default behavior).

You can find instructions for using RVM on the project site (rvm.io). (Ignore the part about pgp).

I hope that helps!

-Dan

:1: Make sure you copy the Cygwin setup exe to /usr/bin so that RVM knows where to find it.