This directory is a brief example and starter app for Jekyll, ready to deploy on ZEIT Now.
To get started with this project yourself, use the following command from Now CLI:
$ now init jekyll
Alternatively, create a project, and Git repository, with this example template using the ZEIT dashboard.
Once initialized locally, you can use the Jekyll CLI to start a local development server so you can work on your new Jekyll site:
$ jekyll serve
Note: Make sure to install the jekyll and bundler gems with
gem install jekyll bundler
in your terminal, then you can install the dependencies before running your development server for the first time withbundle exec jekyll serve
.
To deploy this application, with Now installed, run the following from your terminal:
$ now
Alternatively, your new Jekyll site can be automatically deployed and aliased using Now for GitHub or Now for GitLab. Pushing these files to a new repository with a now.json
file in the root, and with either Now for GitHub or Now for GitLab configured for that repository, your site will be automatically deployed for every push and pull/merge request, and aliased for every push to the default branch!
This starter project includes:
- A fresh Jekyll app using the Jekyll CLI (with a few edits to provide resources!)
- A pre-defined
build.sh
shell script that installs Ruby throughrbenv
, the dependencies (including Jekyll), then builds the app to the default_site
output directory. - A pre-configured
now.json
file that uses the aforementioned build shell script and deploys the_site
directory when built.
For more resources on how to configure your new Jekyll site to do more with Now or to deploy any other kind of application, see the following:
- New to Now? Get a quick introduction
- Learn the basics of deployment on Now
- Learn how to configure your Now deployments
- Learn how to configure Now Routes for redirects, caching, and more
- Learn how to alias your deployment to a domain or other unique shareable URLs
For more information on Jekyll itself, see their documentation.