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

Added Windows instructions to ReadME.md #1

Merged
merged 1 commit into from
Jun 16, 2015

Conversation

scotttd
Copy link
Member

@scotttd scotttd commented Jun 16, 2015

I added the first draft of instructions for installing Jekyll and Git-Pages to the Readme.md. There is still some refinement necessary and some proof reading.

I added the first draft of instructions for installing Jekyll and Git-Pages to the Readme.md
@scotttd scotttd changed the title Added Windows instrcutions to ReadME.md Added Windows instructions to ReadME.md Jun 16, 2015
@pearswj
Copy link
Member

pearswj commented Jun 16, 2015

@scotttd looks like a comprehensive set of instructions! A few initial thoughts...

  • Gosh, installing Python just for pygments is a pain! Had a quick look into it and it seems there is hope, but not just yet...
  • You don't mention installing git and cloning the repo. Just a link to GitHub's help pages would be fine I think.
  • Personally I wouldn't mention Python 3. If you know you need it then you probably don't need these instructions.

I've actually just installed a fresh copy of Windows so I'll run through the instructions and hopefully be able to give you some better feedback :)

sbaer added a commit that referenced this pull request Jun 16, 2015
Added Windows instructions to ReadME.md
@sbaer sbaer merged commit 1c508e3 into gh-pages Jun 16, 2015
@dan-rigdon-bel
Copy link
Member

@pearswj Glad you are watching! @acormier and I still need to update the OS X instructions...
...all of this stuff is very much Proof-Of-Concept so far, but we're really liking the concept.

@sbaer
Copy link
Member

sbaer commented Jun 16, 2015

Do we really need to install pygments? We aren't syntax highlighting code samples from within jekyll. Syntax highlighting is currently achieved through highlight.js on the client

@acormier
Copy link
Member

I think we only needed pygments before with integrated highlight.js.

On Tue, Jun 16, 2015 at 11:06 AM, Steve Baer notifications@github.com
wrote:

Do we really need to install pygments? We aren't syntax highlighting code
samples from within jekyll. Syntax highlighting is currently achieved
through highlight.js on the client


Reply to this email directly or view it on GitHub
#1 (comment)
.

@sbaer
Copy link
Member

sbaer commented Jun 16, 2015

@scotttd since you're already set up with a Windows box, can you try uninstalling python and see if everything still works?

@pearswj
Copy link
Member

pearswj commented Jun 16, 2015

C:\DEV\mcneel\developer-rhino3d-com>jekyll serve
Configuration file: C:/DEV/mcneel/developer-rhino3d-com/_config.yml
            Source: C:/DEV/mcneel/developer-rhino3d-com
       Destination: C:/DEV/mcneel/developer-rhino3d-com/_site
      Generating...
  Liquid Exception: No such file or directory - python C:/Ruby21-x64/lib/ruby/ge
ms/2.1.0/gems/pygments.rb-0.6.3/lib/pygments/mentos.py in _posts/2015-06-04-welc
ome-to-jekyll.markdown
                    done.
  Please add the following to your Gemfile to avoid polling for changes:
    gem 'wdm', '>= 0.1.0' if Gem.win_platform?
 Auto-regeneration: enabled for 'C:/DEV/mcneel/developer-rhino3d-com'
Configuration file: C:/DEV/mcneel/developer-rhino3d-com/_config.yml
    Server address: http://0.0.0.0:4000/developer-rhino3d-com/
  Server running... press ctrl-c to stop.

@pearswj
Copy link
Member

pearswj commented Jun 16, 2015

It appears not to work

@acormier
Copy link
Member

it looks like you have to disable it.
Can you try this?
Disabling Pygments/Rouge

  • Open _config.yml and set highlighter: none.
  • Remove the @import "syntax-highlighting"; rule from your main style
    sheet.
  • Re-serve your Jekyll site from the command-line to register the
    changes made to_config.yml.

from :

http://caiwilliamson.com/web-development/2014/11/20/javascript-syntax-highlighting-in-jekyll.html

On Tue, Jun 16, 2015 at 1:11 PM, Will Pearson notifications@github.com
wrote:

It appears not to work


Reply to this email directly or view it on GitHub
#1 (comment)
.

@pearswj
Copy link
Member

pearswj commented Jun 16, 2015

Darn, I had just installed Python! I'll retrace my steps!

@acormier
Copy link
Member

Thanks for looking into this Will. It's great that you're interested in
this project.

On Tue, Jun 16, 2015 at 1:25 PM, Will Pearson notifications@github.com
wrote:

Darn, I had just installed Python! I'll retrace my steps!


Reply to this email directly or view it on GitHub
#1 (comment)
.

@pearswj
Copy link
Member

pearswj commented Jun 16, 2015

This does the trick! Adding highlighter: none and removing @import "syntax-highlighting" (see css/main.scss line 51).

@pearswj
Copy link
Member

pearswj commented Jun 16, 2015

I'll update index.html

@acormier
Copy link
Member

Great! Thanks Will

On Tue, Jun 16, 2015 at 1:36 PM, Will Pearson notifications@github.com
wrote:

I'll update index.html


Reply to this email directly or view it on GitHub
#1 (comment)
.

@scotttd
Copy link
Member Author

scotttd commented Jun 16, 2015

The problem with not having Python installed and on the path is that Gem Jekyll will not install, because of a Liquid error that it cannot find Python.

@pearswj
Copy link
Member

pearswj commented Jun 16, 2015

I went straight for gem install github-pages as this gem includes jekyll as a dependency. It appears to skip over the error. I'd like to double check that though!

@dan-rigdon-bel
Copy link
Member

Thanks @pearswj !

@scotttd scotttd deleted the scottd-windows-readme-draft branch June 24, 2015 22:57
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.

5 participants