Guides for SE student projects »

Using Netlify

The sections below explains how to use Netlify in a project.

Setting up

1. Go to https://www.netlify.com/ and click Sign Up. Next, click GITHUB SIGN IN, enter your GitHub account details and authorize netlify.

2. After logging in, click New site from Git.

3. You will then be brought to the setup page. Click GitHub to link your repository to Netlify.

   • Depending on whether you are the owner of the repository, you can either grant or request access to Netlify so that it can access your repository and build your documentation.
     
   • After granting or requesting access to your repository, click Authorize netlify.

4. Pick your repository from the list.

5. Fill out the details as follows and then click Deploy site.

   • Branch to deploy: select master branch
   • If using Jekyll for project documentation:
     • Build command: cd docs && bundle install && bundle exec jekyll build
     • Publish directory: docs/_site
   • If using MarkBind for project documentation:
     • Build Command: cd docs && npm i markbind-cli -g && markbind build --baseUrl
     • Publish directory: docs/_site
   For both Jekyll and MarkBind, omit the cd docs && and docs/ from the build command and the publish directory respectively if the documentation is in the root (i.e., not inside the docs folder).

6. Once Netlify has completed building your project, you can now:

   • View your main branch’s deployed documentation on the site name given by Netlify (customizable as shown below).
     
   • Preview the updated documentation whenever a pull request is made by clicking the Details hyperlink next to the Netlify test status.
     

Changing the site name

If you don’t like the site name given by Netlify, you can change it as follows:

1. Click on Settings.

2. Then click Change site name and fill in your desired site name.