jekyll / jekyll-docs

Offline usage documentation for Jekyll. Requires Jekyll 3 and above.
https://rubygems.org/gems/jekyll-docs
MIT License
39 stars 13 forks source link

Jekyll docs --version doesn't display current version #20

Closed DirtyF closed 6 years ago

DirtyF commented 7 years ago
$ jekyll docs --help
jekyll docs -- Start a local server for the Jekyll documentation

Usage:

  jekyll docs [options]

Options:
 -P [PORT], --port [PORT]  Port to listen on.
        -h, --help         Show this message
        -v, --version      Print the name and version
        -t, --trace        Show the full backtrace when an error occurs
        -s, --source [DIR]  Source directory (defaults to ./)
        -d, --destination [DIR]  Destination directory (defaults to ./_site)
            --safe         Safe mode (defaults to false)
        -p, --plugins PLUGINS_DIR1[,PLUGINS_DIR2[,...]]  Plugins directory (defaults to ./_plugins)
            --layouts DIR  Layouts directory (defaults to ./_layouts)
            --profile      Generate a Liquid rendering profile
        -h, --help         Show this message
        -v, --version      Print the name and version
        -t, --trace        Show the full backtrace when an error occurs

$ jekyll docs -v
docs

Edit: looks like this option isn't implemented.

crush-157 commented 7 years ago

Just installed jekyll and jekyll docs.

I see the above behaviour:

ewan@starbug:~$ jekyll docs --version
docs

But also, (and more seriously) I can't get at docs at all:

ewan@starbug:~$ jekyll docs
You must install the 'jekyll-docs' gem version = 3.6.2 to use the 'jekyll docs' command.

ewan@starbug:~$ jekyll _3.6.2_ docs
You must install the 'jekyll-docs' gem version = 3.6.2 to use the 'jekyll docs' command.

But this is the version I have installed:

ewan@starbug:~$ gem list jekyll

*** LOCAL GEMS ***

jekyll (3.6.2)
jekyll-docs (3.6.2)
jekyll-sass-converter (1.5.0)
jekyll-watch (1.5.0)

I'm running Ruby 2.4.1 on Debian Stretch.

DirtyF commented 7 years ago
$ gem list docs

*** LOCAL GEMS ***

jekyll-docs (3.6.2.0)

Please make sure you have latest patched version and that you're not running jekyll docs in a folder with a Gemfile.

crush-157 commented 7 years ago

Uninstalled and reinstalled, but no difference in behaviour (see below).

Do I need to build locally rather than just run gem install?

ewan@starbug:~$ gem list docs

*** LOCAL GEMS ***

jekyll-docs (3.6.2)
ewan@starbug:~$ gem uninstall jekyll-docs
Successfully uninstalled jekyll-docs-3.6.2
ewan@starbug:~$ gem install jekyll-docs -v 3.6.2.0
Fetching: jekyll-docs-3.6.2.gem (100%)
Successfully installed jekyll-docs-3.6.2
Parsing documentation for jekyll-docs-3.6.2
Installing ri documentation for jekyll-docs-3.6.2
Done installing documentation for jekyll-docs after 1 seconds
1 gem installed
ewan@starbug:~$ jekyll docs
You must install the 'jekyll-docs' gem version = 3.6.2 to use the 'jekyll docs' command.
ewan@starbug:~$ ls -al Gemfile
ls: cannot access 'Gemfile': No such file or directory
ewan@starbug:~$