#PUG TEMPLATE EXAMPLES HOW TO#
#PUG TEMPLATE EXAMPLES INSTALL#
#PUG TEMPLATE EXAMPLES CODE#
#PUG TEMPLATE EXAMPLES DOWNLOAD#

html tells Pug to output its HTML in the html directory and the -P option prettifies the output. Note: in the above command, the -w option stands for watch, the dot tells Pug to watch everything in the current directory, -o. Rendered /home/jim/Desktop/pug-examples/html/index.html You should see something like the following: watching index.pug To kick this off, open a terminal in the pug-examples directory and enter this: pug -w. When it detects any, it will take the contents of index.pug and render it as HTML in the html directory.

#PUG TEMPLATE EXAMPLES CODE#

The way this is going to work is that we’ll write our Pug code in index.pug and have the pug-cli watch this file for changes. Windows users would do echo.> index.pug to achieve the same thing. Note: the touch command is Linux/macOS specific. Then create a further directory called html and a file called index.pug: mkdir -p pug-examples/html Create a new directory named pug-examples and change into it. Now that we’ve got Pug installed, let’s try it out. This will allow you to enter Pug code into the HTML pane and see the result appear in real time.Īs an added bonus, you can click on the down arrow in the HTML pane and select View Compiled HTML to see the markup that Pug has generated. Simply create a new pen, then select Settings > HTML and choose Pug as your preprocessor. If you’d like to follow along with the simpler examples in this tutorial, you can also run them in various online code playgrounds.ĬodePen, for example, has Pug support baked right in. Syntax highlighting will make it much easier to work with Pug files, especially those of any length.

#PUG TEMPLATE EXAMPLES INSTALL#

To remedy this, one can install the Sublime Pug package: I’m currently using Sublime Text 3 and, out of the box, this is what a. If your editor doesn’t offer syntax highlighting for Pug, it’d be a good idea to look for an extension to add this functionality. This will output the version of Pug and the version of the CLI that you have installed.Īt the time of writing, this was as follows: $ pug -version You can check that the install process ran correctly by typing pug -version into a terminal. Once Node and npm are installed on your system, you can install the pug-cli package like so: npm i -g pug-cli You can check out our tutorial “ Installing Multiple Versions of Node.js Using nvm” for a more in-depth guide. It will also negate a bunch of potential permissions errors. I would recommend using a version manager where possible, as this will allow you to install different Node versions and switch between them at will.

#PUG TEMPLATE EXAMPLES DOWNLOAD#

Either head on over to the project’s home page and download the correct binaries for your system, or use a version manager such as nvm. There’s a couple options for installing Node/npm. Finally, we’ll explore a couple of Pug’s more advanced features by building a simple Node/Express project which uses Pug as its template engine.īefore we can get to writing some Pug, we’ll need to install Node, npm (which comes bundled with Node) and the pug-cli package. We’ll start by installing it from npm, go over its basic syntax and then look at several examples of using JavaScript in Pug.

#PUG TEMPLATE EXAMPLES HOW TO#

In this guide, I’ll demonstrate how to get up and running with Pug.

Pug makes it easy both to write reusable HTML, as well as to render data pulled from a database or API. It compiles to HTML and has a simplified syntax, which can make you more productive and your code more readable. Pug is a template engine for Node and for the browser. This can be a nightmare to debug and to maintain. HTML is also static, which means that if you want to display dynamic data (fetched from an API, for example), you invariably end up with a mishmash of HTML stings inside JavaScript. This is where the Pug HTML preprocessor comes in. And while this is not the most difficult task, it can often feel a little boring or repetitive. As web designers or developers, we likely all have to write our fair share of HTML.

Pug template examples