If you are interested in learning more about the language itself there is a good guild for that at the official pug website. In this post I am going to be focusing on the use of the node.js npm package without any additional framework being used like express. However I have wrote a post in which I write more about using pug js with express.js
As with most projects like this I set up a test folder, and install the package with npm.
One that is done I made a basic.js file that will be a hello world sort type js file that uses the project, that looks like this:
In this basic example I am using pugs render method that accepts a string of pug text, and returns plain old html.
With pug the first few characters are interpreted as a tag, and a return is considered an end of the tag. Tags can also be nested by placing a return right after writing the first tag.
For a more compleate overview of the laguage it might be a good idea to check out the site on pug.
Storing pug as an external file should have the *.pug extension, in addition reading pug files is a pretty straightforward process of just using the pug.readFile method.
I made a readfile.js file that I placed in the root of my test_pug project folder like this.
I also made a pugfiles folder in the project, and made some *.pug files to read. One of the files I made is called full.pug which looks like this:
So then I can call my readfile script from the command line and get the rendered html of a pug file just like this:
which will give me this html from full.pug