Deploying a Jekyll project
If you haven’t already, the first thing you’ll want to is install Surge using npm:
npm install -g surge
Now you have what you need to qucikly get your Jekyll site online.
Create a new Jekyll site
First, find and existing Jekyll project you have, or create a new project from your terminal:
Create a new Jekyll site in the current directory
jekyll new ./
You can now visit it in your browser using the
jekyll serve command:
Server address: http://localhost:4000/
Server running... press ctrl-c to stop.
Now you have the basic starter site running.
<figure class="figure--aside figure--browser figure--breakout" title="localhost:4000"> <!-- --> <iframe async defer src="https://jekyll-example.surge.sh" height="500"></iframe> <figcaption>The default Jekyll project, running locally and nearly ready to deploy.</figcaption> </figure>
Compiling your Jekyll site
Now, your source code has been flattened into a
_site/ directory. These will get be re-built each time you run
jekyll build—they’re also the files you’ll want to publish to the web.
Deploying your Jekyll site
You can publish the
_site/ directory to the web with the following command:
You’ll be prompted to login or signup if you haven’t already. Then, you’ll be given a random subdomain. You can override this with something of your choosing, like
<pre class="figure--breakout"><code>surge _site/
project path: ~/Sites/jekyll-project/_site domain: (random-suggestion.surge.sh) example-jekyll.surge.sh</code></pre>
<figure class="figure--aside"> <figcaption>Building and publishing the default Jekyll project using Surge..</figcaption> </figure>
After hitting enter, you should get a message confirming your site is online:
Success! Project is published and running at example-jekyll.surge.sh
Nice work, your site is now online.