scratchfoundation/scratch-extension-docs
Archived
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
[Deprecated] Sample code for Scratch 2.0 hardware and web extensions.
This repository has been archived on 2025-05-04. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
17 commits 2 branches 0 tags 540 KiB
Find a file
Chris Willis-Ford f00d330570 Fixed some markdown mistakes
2014-08-01 20:07:12 -07:00
_layouts Converted site to use Jekyll 2014-08-01 20:03:01 -07:00
images Create gh-pages branch via GitHub 2014-07-31 12:40:38 -07:00
stylesheets Create gh-pages branch via GitHub 2014-05-15 21:11:16 -04:00
.gitignore Converted site to use Jekyll 2014-08-01 20:03:01 -07:00
_config.yml Converted site to use Jekyll 2014-08-01 20:03:01 -07:00
Gemfile Converted site to use Jekyll 2014-08-01 20:03:01 -07:00
Gemfile.lock Converted site to use Jekyll 2014-08-01 20:03:01 -07:00
index.md Converted site to use Jekyll 2014-08-01 20:03:01 -07:00
README.md Fixed some markdown mistakes 2014-08-01 20:07:12 -07:00

README.md

See Using Jekyll with Pages for help with editing this content.

Quick start

  1. Verify that you have Ruby (version 1.9.3 or 2.0.0)
  2. Run gem install bundler
  3. Clone this repository and switch to the gh-pages branch
  4. In your cloned repository, run bundle install
  5. Run bundle exec jekyll serve to preview your site at http://localhost:4000

Windows users

Jekyll isn't really designed with Windows in mind, but it's not too hard to get it working with Cygwin. Follow the 'Installing Jekyll' steps on the GitHub help page above after installing Cygwin with the following packages. If you get errors from the bundle install step, you're probably missing a package -- most likely, a *-devel library package. If it's not listed below, please add it!

Required Cygwin packages:

  • ruby (version 1.9.3 or 2.0.0)
  • gcc-core
  • libcrypt-devel
  • libiconv-devel
  • libffi-devel
  • make
  • patch
  • pkg-config

Even with all the required packages, Jekyll on Windows doesn't seem to like running in --watch mode. This might be fixed by downgrading the listen package, but doing so means downgrading many other packages and potentially breaking compatibility.

If you get "permission denied" related to conftest.exe while running bundle install, you may need to temporarily disable your virus protection. Remember to turn it on again after installation!

If Jekyll fails to build your site, you may need to provide a "fixed" version of your COMSPEC environment variable. The easiest way to do that is:

export COMSPEC=`cygpath -u "$COMSPEC"`

You can either run that command in your shell yourself, add it to .bashrc, or add it to a shell script that (for example) runs bundle exec jekyll serve for you.