If you are new to
The easiest way to learn how
- If you haven't already installed
Nift , you can find install instructions here; - Open up a terminal or command prompt/power shell window and enter
nsm commands to get a list of available commands (check out the Nift commands page from the documentation for information aboutNift commands); - On Bitbucket, GitHub or GitLab import (or fork and rename) an existing site repository template from here;
- If you used GitHub for the last step, go in to the imported/forked repository's settings, scroll down to GitHub Pages and set the
source tomaster branch (there may be some delay before your website goes live); - To view the website remotely, open up a browser of your choice and go to:
https://[user/team/organisation/group-name].[bitbucket/github/gitlab].io/repo-name
[user/team/organisation/group-name].[bitbucket/github/gitlab].io
https://[user/team/organisation/group-name].[bitbucket/github/gitlab].io
- Clone the site repository locally using
nsm clone clone-url , eg.:nsm clone https://gitlab.com/nsm-templates/parchment-site.git;
- To view the website locally, open up one of the pages in the
site directory with a browser of your choice; - Try modifying some of the files in the
content directory and runnsm build-updated , then refresh your browser to view the changes (check out the documentation pages for functions giving information about functions you can use and n++ which is the template language being used; - Try modifying some of the files in the template directory and run
nsm build-updated , then refresh your browser to view the changes (check out the template files page from the documentation for information about writing template files); - You can push your changes back to Bitbucket/GitHub/GitLab using
nsm bcp "commit message" (there may be some delay before your changes go live). - Check out the hosting page from the documentation for information about hosting websites. Especially useful is Netlify for custom domains with auto renewing Let's encrypt certificates or Heroku for free hosting of dynamic websites;
- Check out the mathematics page from the documentation for information about $\LaTeX$ support for your webpages using MathJax;
- Check out the code blocks page from the documentation for information about syntax highlighting support for your webpages using Google Code Prettify;
- Check here for all sorts of useful links.