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

Add beginnings of a walkthrough, styled with Pixyll theme using Jekyll #3

Open
wants to merge 11 commits into
base: gh-pages
Choose a base branch
from

Conversation

laughinghan
Copy link

See it live: https://laughinghan.github.io/mvsf/walkthrough.html

So far as I know there's no affect on the main visualization, so feel free to merge this in even though it's still work-in-progress

First, did the Gemfile stuff from the official GitHub instructions:
https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/#step-2-install-jekyll-using-bundler

Then, rather than `jekyll new .` like those instructions recommend,
which creates a whole scaffolded directory structure and files and stuff
that we don't want, instead copied the minimal set of files (well, the
entire _sass/ folder, but other than that, the minimal set of files)
from [johnotander/pixyll] to make

    jekyll serve && open http://localhost:4000/see-pixyll-in-action.html

work and display with the right styles/the Pixyll theme.

[johnotander/pixyll]: johnotander/pixyll@dca7f12
Gets rid of this message during `jekyll serve`:

        Pagination: Pagination is enabled, but I couldn't find an index.html page to use as the pagination template. Skipping pagination.
Based on https://jekyllrb.com/docs/configuration/#default-configuration
except for Sass, which isn't documented there, but is documented at
https://jekyllrb.com/docs/assets/#sassscss

Except for _posts/, which isn't configurable, but it turns out we don't
need it at all!

Note that at first I tried setting `source: _jekyll`, but then Jekyll
couldn't find index.html, so I tried to symlink _jekyll/index.html to
../index.html, but it turns out that for security reasons Jekyll only
supports symlinks within site.source:
jekyll/jekyll#4710
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.

1 participant