Hello World!
some content
and some more
It's a great language
``` ## Actual HTML ```htmlIt's a great language
``` ## Additional Comments ================================================ FILE: .github/workflows/rollingversions.yml ================================================ name: Release on: push: branches: - master repository_dispatch: types: [rollingversions_publish_approved] jobs: test: runs-on: ubuntu-latest strategy: matrix: node-version: [10.x, 12.x, 14.x] steps: - uses: actions/checkout@v2 - name: Use Node.js ${{ matrix.node-version }} uses: actions/setup-node@v1 with: node-version: ${{ matrix.node-version }} - run: yarn install --frozen-lockfile - run: yarn prettier:check - run: yarn test publish-canary: runs-on: ubuntu-latest if: ${{ github.event_name == 'push' }} needs: test steps: - uses: actions/checkout@v2 - uses: actions/setup-node@v1 with: node-version: 24.x registry-url: 'https://registry.npmjs.org' - run: yarn install --frozen-lockfile - run: yarn build - run: npx rollingversions publish --canary $GITHUB_RUN_NUMBER env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} publish: runs-on: ubuntu-latest if: ${{ github.event_name == 'repository_dispatch' }} needs: test steps: - uses: actions/checkout@v2 - uses: actions/setup-node@v1 with: node-version: 24.x registry-url: 'https://registry.npmjs.org' - run: yarn install --frozen-lockfile - run: yarn build - run: npx rollingversions publish env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} permissions: id-token: write contents: write ================================================ FILE: .github/workflows/test.yml ================================================ name: Test on: pull_request: branches: - master jobs: test: runs-on: ubuntu-latest strategy: matrix: node-version: [10.x, 12.x, 14.x] steps: - uses: actions/checkout@v2 - name: Use Node.js ${{ matrix.node-version }} uses: actions/setup-node@v1 with: node-version: ${{ matrix.node-version }} - run: yarn install --frozen-lockfile - run: yarn prettier:check - run: yarn test ================================================ FILE: .gitignore ================================================ .DS_Store .idea .vscode testing node_modules lib-cov coverage cov-pt* *.seed *.log *.csv *.dat *.out *.patch *.pid *.gz **/test/output* **/test/temp .release.json package-lock.json scripts/tsconfig.json packages/pug-error/lib ================================================ FILE: .prettierrc.js ================================================ module.exports = { bracketSpacing: false, singleQuote: true, trailingComma: 'all', overrides: [ { files: '*.js', options: { parser: 'babel', trailingComma: 'es5', }, }, ], }; ================================================ FILE: README.md ================================================
# Pug
Full documentation is at [pugjs.org](https://pugjs.org/)
Pug is a high-performance template engine heavily influenced by [Haml](http://haml.info/)
and implemented with JavaScript for [Node.js](http://nodejs.org) and browsers. For bug reports,
feature requests and questions, [open an issue](https://github.com/pugjs/pug/issues/new).
For discussion join the [chat room](https://gitter.im/pugjs/pug).
You can test drive Pug online [here](https://pugjs.org/).
[Professionally supported pug is now available](https://tidelift.com/subscription/pkg/npm-pug?utm_source=npm-pug&utm_medium=referral&utm_campaign=readme)
[](https://github.com/pugjs/pug/actions?query=workflow%3ATest+branch%3Amaster)
[](https://rollingversions.com/pugjs/pug)
[](https://www.npmjs.com/package/pug)
[](https://gitter.im/pugjs/pug?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## Packages
Package Name | Version
-------------|--------
pug | [](https://www.npmjs.com/package/pug)
pug-attrs | [](https://www.npmjs.com/package/pug-attrs)
pug-code-gen | [](https://www.npmjs.com/package/pug-code-gen)
pug-error | [](https://www.npmjs.com/package/pug-error)
pug-filters | [](https://www.npmjs.com/package/pug-filters)
pug-lexer | [](https://www.npmjs.com/package/pug-lexer)
pug-linker | [](https://www.npmjs.com/package/pug-linker)
pug-load | [](https://www.npmjs.com/package/pug-load)
pug-parser | [](https://www.npmjs.com/package/pug-parser)
pug-runtime | [](https://www.npmjs.com/package/pug-runtime)
pug-strip-comments | [](https://www.npmjs.com/package/pug-strip-comments)
pug-walk | [](https://www.npmjs.com/package/pug-walk)
## Rename from "Jade"
This project was formerly known as "Jade". However, it was revealed to us that "Jade" is a registered trademark; as a result, a rename was needed. After some discussion among the maintainers, **"Pug"** was chosen as the new name for this project. As of version 2, "pug" is the official package name.
If your package or app currently uses `jade`, don't worry: we have secured permissions to continue to occupy that package name, although all new versions will be released under `pug`.
Before the renaming, work had already begun on “Jade 2.0.0”. Therefore, the rename to Pug coincided with the major version bump. As a result, upgrading from Jade to Pug will be the same process as upgrading any other package with a major version bump.
The syntax of Pug has several differences, deprecations, and removals compared to its predecessor. These differences are documented in [#2305](https://github.com/pugjs/pug/issues/2305).
The website and documentation for Pug are still being updated. But if you are new to Pug, you should get started with the new syntax and install the Pug package from npm.
## Installation
### Package
To use Pug in your own JavaScript projects:
```bash
$ npm install pug
```
### Command Line
After installing the latest version of [Node.js](http://nodejs.org), install with:
```bash
$ npm install pug-cli -g
```
and run with
```bash
$ pug --help
```
## Syntax
Pug is a clean, whitespace sensitive syntax for writing HTML. Here is a simple example:
```pug
doctype html
html(lang="en")
head
title= pageTitle
script(type='text/javascript').
if (foo) bar(1 + 5);
body
h1 Pug - node template engine
#container.col
if youAreUsingPug
p You are amazing
else
p Get on it!
p.
Pug is a terse and simple templating language with a
strong focus on performance and powerful features.
```
Pug transforms the above to:
```html
You are amazing
Pug is a terse and simple templating language with a strong focus on performance and powerful features.
## Sponsors
Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/pug#sponsor)]
## License
MIT
================================================
FILE: SECURITY.md
================================================
# Security Policy
## Supported Versions
| Version | Supported |
| -------- | ------------------ |
| ^3.0.1 | :white_check_mark: |
| <3.0.1 | :x: |
## Reporting a Vulnerability
To report a security vulnerability, please use the
[Tidelift security contact](https://tidelift.com/security).
Tidelift will coordinate the fix and disclosure.
================================================
FILE: package.json
================================================
{
"name": "pug-monorepo",
"private": true,
"@rollingversions/ignore": true,
"workspaces": [
"packages/*"
],
"devDependencies": {
"coveralls": "3.0.9",
"jest": "^26.0.1",
"prettier": "1.19.1",
"typescript": "^4.1.2",
"wsrun": "^5.2.0"
},
"repository": {
"type": "git",
"url": "https://github.com/pugjs/pug.git"
},
"scripts": {
"prettier:check": "prettier --ignore-path .gitignore --list-different './**/*.js'",
"format": "prettier --ignore-path .gitignore --write './**/*.js'",
"build": "node scripts/prebuild && wsrun --stages --exclude-missing --fast-exit --collect-logs build && tsc --build scripts",
"pretest": "yarn build",
"test": "jest",
"coverage": "jest --coverage",
"coveralls": "jest --coverage --coverageReporters=text-lcov | coveralls",
"watch": "jest --watch"
},
"jest": {
"testEnvironment": "node",
"snapshotSerializers": [
"./scripts/filename-serializer.js",
"./scripts/prettier-javascript-serializer.js",
"./scripts/buffer-serializer.js"
]
},
"license": "MIT"
}
================================================
FILE: packages/pug/History.md
================================================
1.11.0 / 2015-06-12
==================
* Added block code support ([@alephyud](https://github.com/alephyud))
* Improved runtime performance of mixins significantly ([Andreas Lubbe](https://github.com/alubbe))
* Improved runtime performance of pug's string escaping ([Andreas Lubbe](https://github.com/alubbe)) and ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Better line number counting for pipeless text ([@alephyud](https://github.com/alephyud))
1.10.0 / 2015-05-25
==================
* Now supports jstransformers, which allows improved handling of embedded languages such as Coffee-Script, and deprecated Transformers support in filters - to be removed in 2.0.0 ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* CLI: added a flag to keep directory hierarchy when a directory is specified - this behavior will be the default in 2.0.0 ([@TimothyGu](https://github.com/TimothyGu))
* disabled 'compileDebug' flag by default when used with express in production mode ([Andreas Lubbe](https://github.com/alubbe))
* Fixed a memory leak on modern versions of Chrome as well as node 0.12 and iojs ([Andreas Lubbe](https://github.com/alubbe))
* update website ([@GarthDB](https://github.com/GarthDB))
1.9.2 / 2015-01-18
==================
* Do not ignore some parser errors for mismatched parenthesis ([@TimothyGu](https://github.com/TimothyGu))
* Warn for `:` that is not followed by a space ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix #1794 (a bizzare bug with a certain combination of inheritance, mixins and &attributes) ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Add `compileClientWithDependenciesTracked` ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Support comments in `case` blocks ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix blocks in nested mixins ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Lots more documentation ([@enlore](https://github.com/enlore))
* Fix watching in CLI ([@pavel](https://github.com/pavel))
1.9.1 / 2015-01-17
==================
* Clean up path/fs functions in CLI as we no longer support node@0.6 ([@TimothyGu](https://github.com/TimothyGu))
* Update commander ([@TimothyGu](https://github.com/TimothyGu))
* Document `cache` and `parser` options ([@TimothyGu](https://github.com/TimothyGu))
* Fix bug in 1.9.0 where we read the file if cache was enabled, even if a string was provided ([@TimothyGu](https://github.com/TimothyGu))
* Fix year in changelog ([@tomByrer](https://github.com/tomByrer))
1.9.0 / 2015-01-13
==================
* Fix `--watch` sometimes dying when there were file-system errors ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix `--watch` by using `fs.watchFile` correctly ([@TimothyGu](https://github.com/TimothyGu))
* Fix errors with using the CLI to compile from stdin
* Better looking badges ([@TimothyGu](https://github.com/TimothyGu))
* Added `--extension` to CLI([@nicocedron](https://github.com/nicocedron) and [@TimothyGu](https://github.com/TimothyGu))
* Refactor and improve internal cache handling ([@TimothyGu](https://github.com/TimothyGu))
* Loads more tests ([@TimothyGu](https://github.com/TimothyGu))
1.8.2 / 2014-12-16
==================
* Use `-` as the default filename when using stdin on CLI ([@TimothyGu](https://github.com/TimothyGu))
* Prevent some compiler errors being silenced ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove use of non-standard `string.trimLeft()` ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix bug in CLI when no name was provided for child template ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove dependency on monocle (hopefully fixing installation on 0.8) ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Add gitter chat room ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.8.1 / 2014-11-30
==================
* Fix corner case when the pretty option was passed a non-string truthy value ([@TimothyGu](https://github.com/TimothyGu))
* Warn when `lexer` is given as an option ([@TimothyGu](https://github.com/TimothyGu))
* Update dependencies ([@TimothyGu](https://github.com/TimothyGu))
1.8.0 / 2014-11-28
==================
* Fix empty text-only block ([@rlidwka](https://github.com/rlidwka))
* Warn about future change to ISO 8601 style dates ([@TimothyGu](https://github.com/TimothyGu) and [@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Add warnings when data-attributes contain ampersands ([@TimothyGu](https://github.com/TimothyGu))
* Allow custom pretty indentation ([@bfred-it](https://github.com/bfred-it))
* Add support for an object in the style attribute ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Add support for an object in the class attribute ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Ignore fs module in browser builds ([@sokra](https://github.com/sokra))
* Update dependencies ([@hildjj](https://github.com/hildjj))
* Check mixin arguments are valid JavaScript expressions ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove symlink ([@slang800](https://github.com/slang800))
1.7.0 / 2014-09-17
==================
* Add Doctype option on command line ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Support ES6 style rest args in mixins ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix support for unicode newlines (\u2028, \u2029) ([@rlidwka](https://github.com/rlidwka))
* Expose `globals` option from the `with` module ([@sokra](https://github.com/sokra))
* Lots of new documentation ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.6.0 / 2014-08-31
==================
* Allow optional white space after `+` when calling a mixin ([@char101](https://github.com/char101))
* Use void-elements module to replace internal self-closing list ([@hemanth](https://github.com/hemanth))
* Fix a warning that eroniously warned for un-used blocks if in an extending template from an include (Reported by [@Dissimulazione](https://github.com/Dissimulazione))
* Fix mixins not working at end of file ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix error reporting when mixin block was followed by blank lines ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.5.0 / 2014-07-23
==================
* Added compileFile API ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix line number in un-used blocks warning ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix a warning that eroniously warned for un-used blocks if they were under another block (Reported by [@pesho](https://github.com/pesho))
1.4.2 / 2014-07-16
==================
* Fix a warning that eroniously warned for un-used blocks if they were under a "Code" element (Reported by [@narirou](https://github.com/narirou))
1.4.1 / 2014-07-16
==================
* Fix an error that sometimes resulted in 'unexpected token "pipless-text"' being erroniously thrown (Reported by [@Artazor](https://github.com/Artazor) and [@thenitai](https://github.com/thenitai))
1.4.0 / 2014-07-15
==================
* Fix CLI so it keeps watching when errors occur ([@AndrewTsao](https://github.com/AndrewTsao))
* Support custom names for client side templates ([@ForbesLindesay](http://www.forbeslindesay.co.uk/) and [@dscape](https://github.com/dscape))
* Allow whitepsace other than "space" before attributes passed to mixins (N.B. there is a small chance this could be a breaking change for you) ([@regular](https://github.com/regular))
* Track dependencies so file watchers can be more clever ([@ForbesLindesay](http://www.forbeslindesay.co.uk/) and [@sdether](https://github.com/sdether))
* Allow passing options to filtered includes ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix bugs with indentation in filters ([@ForbesLindesay](http://www.forbeslindesay.co.uk/) and [@lackac](https://github.com/lackac))
* Warn on block names that are never used ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.3.1 / 2014-04-04
==================
* Fix error with tags in xml that are self-closing in html ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix error message for inline tags with content ([@hiddentao](https://github.com/hiddentao))
1.3.0 / 2014-03-02
==================
* Fix a bug where sometimes mixins were removed by an optimisation even though they were being called ([@ForbesLindesay](http://www.forbeslindesay.co.uk/), reported by [@leider](https://github.com/leider))
* Updated with to support automatically detecting when a value is "global" and removed redundant `options.globals` option ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Improve warnings for tags with multiple attributes ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Deprecate (with a warning) `node.clone`, `block.replace`, `attrs.removeAttribute`, `attrs.getAttribute` - these are all internal APIs for the AST ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.2.0 / 2014-02-26
==================
* Use variables instead of properties of pug, improving performance and reliability with nested templates ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Support compiling templates from stdin via a user typing ([@yorkie](https://github.com/yorkie))
* Lazily add mixins ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix case fall-through ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Earlier errors for `when` without `case` and `else` without `if` ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Allow `if`/`else` etc. to not have a block.
* Remove lib-cov legacy to make browserify work better ([@silver83](https://github.com/silver83))
* Add and improve test coverage using istanbul ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.1.5 / 2014-01-19
==================
* Add filename to and fix line numbers for missing space before text warning (@ijin82)
* Fix filenames for some error reporting in extends/includes (@doublerebel)
* Fix a corner case where a mixin was called with `&attributes` but no other attributes and a block that was supposed to be fixed in 1.1.4 ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.1.4 / 2014-01-09
==================
* Fix a corner case where a mixin was called with `&attributes` but no other attributes and a block ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.1.3 / 2014-01-09
==================
* Fix failure of npm prepublish not running
1.1.2 / 2014-01-09
==================
* Fix same interaction of `&attributes` with `false` `null` or `undefined` but combined with dynamic attributes ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.1.1 / 2014-01-09
==================
* Fix a bug when `&attributes` is combined with static attributes that evaluate to `false` or `null` or `undefined` ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.1.0 / 2014-01-07
==================
* Fix class merging to work as documented ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Throw an error when the same attribute is duplicated multiple times ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Move more errors into the parser/lexer so they have more info about line numbers ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Support mixin blocks at the end of files ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.0.2 / 2013-12-31
==================
* Fix a bug when `&attributes` is combined with dynamic attributes ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.0.1 / 2013-12-29
==================
* Allow self closing tags to contian whitespace ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Allow tags to have a single white space after them ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Support text bodies of tags that begin with `//` rather than treating them as comments ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
1.0.0 / 2013-12-22
==================
* No longer support node@0.8 ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix error reporting in layouts & includes ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Allow a list of 'globals' to be passed as an array at compile time & don't automatically expose all globals ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Escape apostrophes in data attributes (@qualiabyte)
* Fix mixin/block interaction ([@ForbesLindesay](http://www.forbeslindesay.co.uk/) & [@paulyoung](https://github.com/paulyoung))
* Ignore trailing space after mixin declaration ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Make literal `.` work as expected ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove implicit text only for script/style ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Stop parsing comments and remove support for conditional comments ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Make filtering includes explicit ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove special assignment syntax ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove `!!!` shortcut for `doctype` ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove `5` shorcut for `html` doctype ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove `colons` option from the distant past ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Add a sepatate `compileClient` and `compileFileClient` to replace the `client` option ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove polyfills for supporting old browsers ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Allow interpolation for mixin names ([@jeromew](https://github.com/jeromew)
* Use `node.type` instead of `node.constructor.name` so it can be minified ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Allow hyphens in filter names ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Throw an error if a self closing tag has content ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Support inline tags ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Replace `attributes` magic attribute with `&attributes(attributes)` ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove automatic tag wrapping for filters, you can just put the tags in yourself now ([@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Remove whitespace from tags nested inside pre tags ([@markdalgleish](http://markdalgleish.com))
0.35.0 / 2013-08-21
===================
* Add support for space separated attributes (thanks to [@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Add earlier errors for invalid JavaScript expressions (thanks to [@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* Fix parsing files with UTF8 BOMs when they are includes or parent/layout templates (thanks to [@kiinoo](https://github.com/kiinoo))
0.34.1 / 2013-07-26
===================
* fix render file not working when called with callback (reported by [@xieren58](https://github.com/xieren58))
0.34.0 / 2013-07-26
===================
* callbacks only called once for async methods even if they throw (reported by [@davidcornu](https://github.com/davidcornu))
* HTML comments are pretty printed better (thanks to [@eddiemonge](https://github.com/eddiemonge))
* callbacks are optional and leaving them out results in synchronous operation (thanks to [@ForbesLindesay](http://www.forbeslindesay.co.uk/))
* empty filter nodes are now permitted (thanks to [@coderanger](https://github.com/coderanger))
* overhaul website and documentation (thanks to [@ForbesLindesay](http://www.forbeslindesay.co.uk/)), much more of this to come.
0.33.0 / 2013-07-12
===================
* Hugely more powerful error reporting (especially with `compileDebug` set explicitly to `true`)
* Add a warning for tags with multiple attributes
* be strict about requiring newlines after tags to fix some odd corner cases
* fix escaping of class to allow it to be unescaped (thanks to [@christiangenco](https://github.com/christiangenco))
0.32.0 / 2013-06-28
===================
* remove `pug.version` and fix `pug --version`
* add file name and line number to deprecation warnings
* use constantinople for better constant detection
* update `with` for a massive performance upgrade at compile time
0.31.2 / 2013-06-07
===================
* fix overzealous deprecation warnings
0.31.1 / 2013-05-31
===================
* fix line endings for executable command
* fix `locals` variable being undefined
* fix an obscure bug that could occur if multiple mixins interact badly (see [substack/lexical-scope#13](https://github.com/substack/lexical-scope/issues/13))
0.31.0 / 2013-05-30
==================
* deprecate implicit text-only `script` and `style` tags
* make `with` at compile time using `lexical-scope`
* add `options.parser` that behaves exactly like `options.compiler`
* add "component.json" for component (runtime) support
* removed `hasOwnProperty` check in each loops
* removed .min files from the repository (people can just generate these themselves)
* use browserify to compile client side libraries
* fix buggy block extending should now be fixed
* fix preserve case of custom doctypes
* fix regexps in attributes sometimes not being accepted
* fix allow `$` sign in each loop variable names
* fix mixins with buffered code on the same line
* fix separate class names by ` ` rather than `,` (was sometimes incorrect)
0.30.0 / 2013-04-25
==================
* add support for 'include' and 'extends' to use paths relative to basedir
* fix accidental calling of functions in iteration block. Closes #986
* fix: skip rethrow on client
* fix each/else prefixed with `-`
* fix multi-block prepend/append
* swap -o and -O, set -o to --out
0.29.0 / 2013-04-16
==================
* add "monocle" for watcher that actually works...
* fix interpolation in blocks of text
* fix attribute interpolation
* move filters to an external library
* fix JavaScript escaping corner cases
0.28.2 / 2013-03-04
==================
* wtf coffeescript is not a dep
0.28.1 / 2013-01-10
==================
* add passing of filename to include filters
* fix wrong new lines for include filters
0.28.0 / 2013-01-08
==================
* add .css and .js "filters". re #438
* add include filters. Closes #283
* fix "class:" within attribute escaping
* removing ast filters
* things I can't read:
* 反馈地址
* 样式
* 联系
* 初稿，翻译完
* 接受大鸟的建议
* 头晕，翻译一点点
* 到过滤器翻译完毕
* 翻译一部分
* 中文翻译单独放
* 特性部分
* 再翻
* 翻译一点点
0.27.7 / 2012-11-05
==================
* fix each/else clause for enumerated objects
* fix #764 (incorrect line number for error messages)
* fix double-escaping of interpolated js slashes. Closes #784
0.27.6 / 2012-10-05
==================
* Included templates can not override blocks of their parent. Closes #699
0.27.5 / 2012-09-24
==================
* fix attr interpolation escaping. Closes #771
0.27.4 / 2012-09-18
==================
* fix include yields. Closes #770
0.27.3 / 2012-09-18
==================
* fix escaping of interpolation. Closes #769
* loosen "mkdirp" version restriction [TooTallNate]
0.27.2 / 2012-08-07
==================
* Revert "fixing string interpolation escaping #731", problems reported
0.27.1 / 2012-08-06
==================
* fix attribute interpolation escaping #731
* fix string interpolation escaping #731
0.27.0 / 2012-07-26
==================
* added ability to pass in json file to `--obj`
* add preliminary `each` `else` support. Closes #716
* fix doctype bug overlooked in #712
* fix stripping of utf-8 BOMs
0.26.3 / 2012-06-25
==================
* Update version of commander that supports node v0.8.
0.26.2 / 2012-06-22
==================
* Added --options alias of --obj
* Added reserved word conflict prevention in Google's Closure Compiler
* Added tag interpolation. Closes #657
* Allow the compiled client to use it's own pug util functions [3rd-Eden]
* Fixed `attrs()` escape bug [caseywebdev]
0.26.1 / 2012-05-27
==================
* Changed default doctype to __html5__
* Performance: statically compile attrs when possible [chowey]
* Fixed some class attribute merging cases
* Fixed so `block` doesn't consume `blockquotes` tag [chowey]
* Fixed backslashes in text nodes [chowey]
* Fixed / in text. Closes #638
0.26.0 / 2012-05-04
==================
* Added package.json __component__ support
* Added explicit self-closing tag support. Closes #605
* Added `block` statement
* Added mixin tag-like behaviour [chowey]
* Fixed mixins with extends [chowey]
0.25.0 / 2012-04-18
==================
* Added preliminary mixin block support. Closes #310
* Fixed whitespace handling in various situations [chowey]
* Fixed indentation in various situations [chowey]
0.24.0 / 2012-04-12
==================
* Fixed unescaped attribute compilation
* Fixed pretty-printing of text-only tags (__Warning__: this may affect rendering) [chowey]
0.23.0 / 2012-04-11
==================
* Added data-attr json stringification support. Closes #572
* Added unescaped attr support. Closes #198
* Fixed #1070, reverted mixin function statements
* Fixed pug.1 typo
0.22.1 / 2012-04-04
==================
* Fixed source tags. now self-closing. Closes #308
* Fixed: escape backslashes in coffeescript filter
0.22.0 / 2012-03-22
==================
* Added pug manpage (`man pug` after installation for docs)
* Added `-D, --no-debug` to pug(1)
* Added `-p, --pretty` to pug(1)
* Added `-c, --client` option to pug(1)
* Fixed `-o { client: true }` with stdin
* Fixed: skip blank lines in lexer (unless within pipeless text). Closes #399
0.21.0 / 2012-03-10
==================
* Added new input/output test suite using Mocha's string diffing
* Added alias `extend` -> `extends`. Closes #527 [guillermo]
* Fixed include escapes. Closes #513
* Fixed block-expansion with .foo and #foo short-hands. Closes #498
0.20.3 / 2012-02-16
==================
* Changed: pass `.filename` to filters only
0.20.2 / 2012-02-16
==================
* Fixed `:stylus` import capabilities, pass .filename
0.20.1 / 2012-02-02
==================
* Fixed Block#includeBlock() with textOnly blocks
0.20.0 / 2011-12-28
==================
* Added a browser example
* Added `yield` for block `include`s
* Changed: replaced internal `__` var with `__pug` [chrisleishman]
* Fixed two globals. Closes #433
0.19.0 / 2011-12-02
==================
* Added block `append` / `prepend` support. Closes #355
* Added link in readme to pug-mode for Emacs
* Added link to python implementation
0.18.0 / 2011-11-21
==================
* Changed: only ['script', 'style'] are text-only. Closes #398'
0.17.0 / 2011-11-10
==================
* pug.renderFile() is back! (for express 3.x)
* Fixed `Object.keys()` failover bug
0.16.4 / 2011-10-24
==================
* Fixed a test due to reserved keyword
* Fixed: commander 0.1.x dep for 0.5.x
0.16.3 / 2011-10-24
==================
* Added: allow leading space for conditional comments
* Added quick implementation of a switch statement
* Fixed parens in mixin args. Closes #380
* Fixed: include files with a .pug extension as pug files
0.16.2 / 2011-09-30
==================
* Fixed include regression. Closes #354
0.16.1 / 2011-09-29
==================
* Fixed unexpected `else` bug when compileDebug: false
* Fixed attr state issue for balancing pairs. Closes #353
0.16.0 / 2011-09-26
==================
* Added `include` block support. Closes #303
* Added template inheritance via `block` and `extends`. Closes #242
* Added 'type="text/css"' to the style tags generated by filters.
* Added 'uglifyjs' as an explicit devDependency.
* Added -p, --path
# Pug
Full documentation is at [pugjs.org](https://pugjs.org/)
Pug is a high performance template engine heavily influenced by [Haml](http://haml.info/)
and implemented with JavaScript for [Node.js](http://nodejs.org) and browsers. For bug reports,
feature requests and questions, [open an issue](https://github.com/pugjs/pug/issues/new).
For discussion join the [chat room](https://gitter.im/pugjs/pug).
You can test drive Pug online [here](https://pugjs.org/).
[](https://travis-ci.org/pugjs/pug)
[](https://coveralls.io/r/pugjs/pug?branch=master)
[](https://david-dm.org/pugjs/pug?path=packages/pug)
[](https://david-dm.org/pugjs/pug?path=packages/pug&type=dev)
[](https://www.npmjs.com/package/pug)
[](https://gitter.im/pugjs/pug?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## Rename from "Jade"
This project was formerly known as "Jade." However, it has been revealed to us that "Jade" is a registered trademark, and as a result a rename is needed. After some discussion among the maintainers, **"Pug"** has been chosen as the new name for this project. The next major version will carry "pug" as the package name.
If your package or app currently uses `jade`, don't worry: we have secured permissions to continue to occupy that package name, although all new versions will be released under `pug`.
Before the renaming, we had already begun working on an incompatible Jade 2.0.0. We have then made it so that this new major version bump will coincide with the rename to Pug. Therefore, upgrading from Jade to Pug will be the same process as upgrading any other package with a major version bump. Currently, Pug 2.0.0 is still under beta stage, and there are several syntactic differences we have deprecated and removed. Such differences are documented at [#2305](https://github.com/pugjs/pug/issues/2305).
The website and documentation for Pug are still being updated, but if you are new to Pug, you should get started with the new syntax and install the Pug package on npm.
## Installation
### Package
via npm:
```bash
$ npm install pug
```
### Command Line
After installing the latest version of [Node.js](http://nodejs.org/), install with:
```bash
$ npm install pug-cli -g
```
and run with
```bash
$ pug --help
```
## Syntax
Pug is a clean, whitespace sensitive syntax for writing html. Here is a simple example:
```pug
doctype html
html(lang="en")
head
title= pageTitle
script(type='text/javascript').
if (foo) bar(1 + 5)
body
h1 Pug - node template engine
#container.col
if youAreUsingPug
p You are amazing
else
p Get on it!
p.
Pug is a terse and simple templating language with a
strong focus on performance and powerful features.
```
becomes
```html
You are amazing
Pug is a terse and simple templating language with a strong focus on performance and powerful features.
:)
================================================ FILE: packages/pug/test/cases/auxiliary/window.pug ================================================ .window a(href='#').close Close block window-content ================================================ FILE: packages/pug/test/cases/auxiliary/yield-nested.pug ================================================ html head title body h1 Page #content #content-wrapper yield #footer stuff ================================================ FILE: packages/pug/test/cases/basic.html ================================================baz
================================================ FILE: packages/pug/test/cases/block-expansion.pug ================================================ ul li: a(href='#') foo li: a(href='#') bar p baz ================================================ FILE: packages/pug/test/cases/block-expansion.shorthands.html ================================================Try to define yourself by what you do, and you’ll burnout every time. You are. That is enough. I rest in that.
ajax contents
================================================ FILE: packages/pug/test/cases/blocks-in-if.pug ================================================ //- see https://github.com/pugjs/pug/issues/1589 -var ajax = true -if( ajax ) //- return only contents if ajax requests block contents p ajax contents -else //- return all html doctype html html head meta( charset='utf8' ) title sample body block contents p all contetns ================================================ FILE: packages/pug/test/cases/case-blocks.html ================================================you have a friend
================================================ FILE: packages/pug/test/cases/case-blocks.pug ================================================ html body - var friends = 1 case friends when 0 p you have no friends when 1 p you have a friend default p you have #{friends} friends ================================================ FILE: packages/pug/test/cases/case.html ================================================you have a friend
you have very few friends
Friend is a string
================================================ FILE: packages/pug/test/cases/case.pug ================================================ html body - var friends = 1 case friends when 0: p you have no friends when 1: p you have a friend default: p you have #{friends} friends - var friends = 0 case friends when 0 when 1 p you have very few friends default p you have #{friends} friends - var friend = 'Tim:G' case friend when 'Tim:G': p Friend is a string when {tim: 'g'}: p Friend is an object ================================================ FILE: packages/pug/test/cases/classes-empty.html ================================================ ================================================ FILE: packages/pug/test/cases/classes-empty.pug ================================================ a(class='') a(class=null) a(class=undefined) ================================================ FILE: packages/pug/test/cases/classes.html ================================================ ================================================ FILE: packages/pug/test/cases/classes.pug ================================================ a(class=['foo', 'bar', 'baz']) a.foo(class='bar').baz a.foo-bar_baz a(class={foo: true, bar: false, baz: true}) ================================================ FILE: packages/pug/test/cases/code.conditionals.html ================================================foo
foo
foo
bar
baz
bar
yay
================================================ FILE: packages/pug/test/cases/code.conditionals.pug ================================================ - if (true) p foo - else p bar - if (true) { p foo - } else { p bar - } if true p foo p bar p baz else p bar unless true p foo else p bar if 'nested' if 'works' p yay //- allow empty blocks if false else .bar if true .bar else .bing if false .bing else if false .bar else .foo ================================================ FILE: packages/pug/test/cases/code.escape.html ================================================<script>
================================================ FILE: packages/pug/test/cases/escape-chars.pug ================================================ script. var re = /\d+/; ================================================ FILE: packages/pug/test/cases/escape-test.html ================================================
BEGINhtml
body
pre
include:custom(opt='val' num=2) filters.include.custom.pug
END
================================================
FILE: packages/pug/test/cases/filters.include.custom.pug
================================================
html
body
pre
include:custom(opt='val' num=2) filters.include.custom.pug
================================================
FILE: packages/pug/test/cases/filters.include.html
================================================
Just some markdown tests.
With new line.
================================================ FILE: packages/pug/test/cases/filters.include.pug ================================================ html body include:markdown-it some.md script include:coffee-script(minify=true) include-filter-coffee.coffee script include:coffee-script(minify=false) include-filter-coffee.coffee ================================================ FILE: packages/pug/test/cases/filters.inline.html ================================================before after
================================================ FILE: packages/pug/test/cases/filters.inline.pug ================================================ p before #[:cdata inside] after ================================================ FILE: packages/pug/test/cases/filters.less.html ================================================ ================================================ FILE: packages/pug/test/cases/filters.less.pug ================================================ html head style(type="text/css") :less @pad: 15px; body { padding: @pad; } ================================================ FILE: packages/pug/test/cases/filters.markdown.html ================================================This is some awesome markdown whoop.
================================================ FILE: packages/pug/test/cases/filters.markdown.pug ================================================ html body :markdown This is _some_ awesome **markdown** whoop. ================================================ FILE: packages/pug/test/cases/filters.nested.html ================================================ ================================================ FILE: packages/pug/test/cases/filters.nested.pug ================================================ script :cdata:uglify-js (function() { console.log('test') })() script :cdata:uglify-js:coffee-script (-> console.log 'test' )() ================================================ FILE: packages/pug/test/cases/filters.stylus.html ================================================ ================================================ FILE: packages/pug/test/cases/filters.stylus.pug ================================================ html head style(type="text/css") :stylus body padding: 50px body ================================================ FILE: packages/pug/test/cases/html.html ================================================You can embed html as well.
Even as the body of a block expansion.
================================================ FILE: packages/pug/test/cases/html.pug ================================================ - var version = 1449104952939The message is "hello world"
================================================ FILE: packages/pug/test/cases/include-only-text.pug ================================================ html body p include include-only-text-body.pug em hello world ================================================ FILE: packages/pug/test/cases/include-with-text-head.html ================================================ ================================================ FILE: packages/pug/test/cases/include-with-text-head.pug ================================================ head script(type='text/javascript'). alert('hello world'); ================================================ FILE: packages/pug/test/cases/include-with-text.html ================================================ ================================================ FILE: packages/pug/test/cases/include-with-text.pug ================================================ html include include-with-text-head.pug script(src='/caustic.js') script(src='/app.js') ================================================ FILE: packages/pug/test/cases/include.script.html ================================================ ================================================ FILE: packages/pug/test/cases/include.script.pug ================================================ script#pet-template(type='text/x-template') include auxiliary/pet.pug ================================================ FILE: packages/pug/test/cases/include.yield.nested.html ================================================some content
and some more
var x = '\n here is some \n new lined text';
bar
:)
================================================ FILE: packages/pug/test/cases/includes.pug ================================================ include auxiliary/mixins.pug +foo body include auxiliary/smile.html include auxiliary/escapes.html script(type="text/javascript") include:verbatim auxiliary/includable.js ================================================ FILE: packages/pug/test/cases/inheritance.alert-dialog.html ================================================I'm an alert!
Some content
================================================ FILE: packages/pug/test/cases/inheritance.extend.include.html ================================================Some content
================================================ FILE: packages/pug/test/cases/inheritance.extend.include.pug ================================================ extend auxiliary/layout.include.pug block head script(src='jquery.js') block content h2 Page p Some content block window-content h2 Awesome p Now we can extend included blocks! ================================================ FILE: packages/pug/test/cases/inheritance.extend.mixins.block.html ================================================Hello World!
Foo bar baz!
================================================ FILE: packages/pug/test/cases/inheritance.extend.mixins.pug ================================================ extend auxiliary/layout.pug mixin article(title) if title h1= title block block content +article("The meaning of life") p Foo bar baz! ================================================ FILE: packages/pug/test/cases/inheritance.extend.pug ================================================ extend auxiliary/layout.pug block head script(src='jquery.js') block content h2 Page p Some content ================================================ FILE: packages/pug/test/cases/inheritance.extend.recursive.html ================================================Some content
================================================ FILE: packages/pug/test/cases/inheritance.extend.whitespace.pug ================================================ extend auxiliary/layout.pug block head script(src='jquery.js') block content h2 Page p Some content ================================================ FILE: packages/pug/test/cases/inheritance.html ================================================Some content
================================================ FILE: packages/pug/test/cases/inheritance.pug ================================================ extends auxiliary/layout.pug block head script(src='jquery.js') block content h2 Page p Some content ================================================ FILE: packages/pug/test/cases/inline-tag.html ================================================bing foo bong
bing foo [foo] bong
bing foo [foo] bong
#[strong escaped] #[escaped
================================================ FILE: packages/pug/test/cases/inline-tag.pug ================================================ p bing #[strong foo] bong p. bing #[strong foo] #[strong= '[foo]'] #[- var foo = 'foo]'] bong p | bing | #[strong foo] | #[strong= '[foo]'] | #[- var foo = 'foo]'] | bong p. \#[strong escaped] \#[#[strong escaped] ================================================ FILE: packages/pug/test/cases/intepolated-elements.html ================================================Some text with inline link
================================================ FILE: packages/pug/test/cases/intepolated-elements.pug ================================================ p #[a.rho(href='#', class='rho--modifier') with inline link] p Some text #[a.rho(href='#', class='rho--modifier')] p Some text #[a.rho(href='#', class='rho--modifier') with inline link] ================================================ FILE: packages/pug/test/cases/interpolated-mixin.html ================================================This also works http://www.bing.com so hurrah for Pug
================================================ FILE: packages/pug/test/cases/interpolated-mixin.pug ================================================ mixin linkit(url) a(href=url)= url p This also works #[+linkit('http://www.bing.com')] so hurrah for Pug ================================================ FILE: packages/pug/test/cases/interpolation.escape.html ================================================Last prepend must appear at top
Something prepended to content
Something appended to content
Last append must be most last
================================================ FILE: packages/pug/test/cases/layout.multi.append.prepend.block.pug ================================================ extends ../fixtures/multi-append-prepend-block/redefine.pug append content p.first.append Something appended to content prepend content p.first.prepend Something prepended to content append content p.last.append Last append must be most last prepend content p.last.prepend Last prepend must appear at top append head script(src='jquery.js') prepend head script(src='foo.js') ================================================ FILE: packages/pug/test/cases/layout.prepend.html ================================================ ================================================ FILE: packages/pug/test/cases/layout.prepend.pug ================================================ extends ../fixtures/prepend/app-layout.pug block prepend head script(src='foo.js') script(src='bar.js') ================================================ FILE: packages/pug/test/cases/layout.prepend.without-block.html ================================================ ================================================ FILE: packages/pug/test/cases/layout.prepend.without-block.pug ================================================ extends ../fixtures/prepend-without-block/app-layout.pug prepend head script(src='foo.js') script(src='bar.js') ================================================ FILE: packages/pug/test/cases/mixin-at-end-of-file.html ================================================ ================================================ FILE: packages/pug/test/cases/mixin-at-end-of-file.pug ================================================ include ./auxiliary/mixin-at-end-of-file.pug +slide() p some awesome content ================================================ FILE: packages/pug/test/cases/mixin-block-with-space.html ================================================bar
================================================ FILE: packages/pug/test/cases/mixin-via-include.pug ================================================ //- regression test for https://github.com/pugjs/pug/issues/1435 include ../fixtures/mixin-include.pug +bang ================================================ FILE: packages/pug/test/cases/mixin.attrs.html ================================================Some important content.
Even more important content.
Last content.
1
2
3
4
================================================ FILE: packages/pug/test/cases/mixin.attrs.pug ================================================ mixin centered(title) div.centered(id=attributes.id) - if (title) h1(class=attributes.class)= title block - if (attributes.href) .footer a(href=attributes.href) Back mixin main(title) div.stretch +centered(title).highlight&attributes(attributes) block mixin bottom div.bottom&attributes(attributes) block body +centered#First Hello World +centered('Section 1')#Second p Some important content. +centered('Section 2')#Third.foo(href='menu.html', class='bar') p Even more important content. +main('Section 3')(href='#') p Last content. +bottom.foo(class='bar', name='end', id='Last', data-attr='baz') p Some final words. +bottom(class=['class1', 'class2']) mixin foo div.thing(attr1='foo', attr2='bar')&attributes(attributes) - var val = 'I'm article foo
I'm a much longer text-only article, but you can still inline html tags in me if you want.
one
two
three
Two
Three
Two
Three
Two
Three
Two
Three
Two
Three
Two
Three
Two
Three
Two
Three
================================================ FILE: packages/pug/test/cases/mixin.merge.pug ================================================ mixin foo p.bar&attributes(attributes) One p.baz.quux&attributes(attributes) Two p&attributes(attributes) Three p.bar&attributes(attributes)(class="baz") Four body +foo.hello +foo#world +foo.hello#world +foo.hello.world +foo(class="hello") +foo.hello(class="world") +foo +foo&attributes({class: "hello"}) ================================================ FILE: packages/pug/test/cases/mixins-unused.html ================================================ ================================================ FILE: packages/pug/test/cases/mixins-unused.pug ================================================ mixin never-called .wtf This isn't something we ever want to output body ================================================ FILE: packages/pug/test/cases/mixins.html ================================================code sample
what is going on================================================ FILE: packages/pug/test/cases/pipeless-tag.pug ================================================ pre. what is #{'going'} #[| #{'on'}] ================================================ FILE: packages/pug/test/cases/pre.html ================================================
foo bar baz
foo
bar
baz"foo"
'foo'
================================================ FILE: packages/pug/test/cases/quotes.pug ================================================ p "foo" p 'foo' ================================================ FILE: packages/pug/test/cases/regression.1794.html ================================================ ================================================ FILE: packages/pug/test/cases/regression.1794.pug ================================================ extends ./auxiliary/1794-extends.pug block content include ./auxiliary/1794-include.pug ================================================ FILE: packages/pug/test/cases/regression.784.html ================================================value
value
herefoo bar baz
foo bar baz
foo bar bazfoo
bar
baz
.
foo
bar
baz
.
foo
bar
baz
.
================================================
FILE: packages/pug/test/cases/text.pug
================================================
option(value='') -- (selected) --
p
p.
p
| foo
| bar
|
|
| baz
p.
foo
bar
baz
.
.
foo
bar
baz
pre
| foo
| bar
| baz
| .
pre.
foo
bar
baz
.
.
foo
bar
baz
.
================================================
FILE: packages/pug/test/cases/utf8bom.html
================================================
"foo"
================================================ FILE: packages/pug/test/cases/utf8bom.pug ================================================ p "foo" ================================================ FILE: packages/pug/test/cases/vars.html ================================================ ================================================ FILE: packages/pug/test/cases/vars.pug ================================================ - var foo = 'bar' - var list = [1,2,3] a(class=list, id=foo) ================================================ FILE: packages/pug/test/cases/while.html ================================================Look at twiddle-dee-dee
'; const output = pug.render(input, {plugins: [{lex}]}); expect(output).toEqual(expected); }); ================================================ FILE: packages/pug/test/pug.test.js ================================================ 'use strict'; var assert = require('assert'); var fs = require('fs'); var path = require('path'); var pug = require('../'); var perfTest = fs.readFileSync(__dirname + '/fixtures/perf.pug', 'utf8'); try { fs.mkdirSync(__dirname + '/temp'); } catch (ex) { if (ex.code !== 'EEXIST') { throw ex; } } describe('pug', function() { describe('unit tests with .render()', function() { it('should support doctypes', function() { assert.equal( '', pug.render('doctype xml') ); assert.equal('', pug.render('doctype html')); assert.equal('', pug.render('doctype foo bar baz')); assert.equal('', pug.render('doctype html')); assert.equal('', pug.render('doctype', {doctype: 'html'})); assert.equal( '', pug.render('doctype html', {doctype: 'xml'}) ); assert.equal('', pug.render('html')); assert.equal( '', pug.render('html', {doctype: 'html'}) ); assert.equal( '', pug.render('doctype html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN') ); }); it('should support Buffers', function() { assert.equal('foo
', pug.render(Buffer.from('p foo'))); }); it('should support line endings', function() { var src = ['p', 'div', 'img']; var html = ['', '', ''foo'
", pug.render("p 'foo'")); assert.equal("'foo'
", pug.render("p\n | 'foo'")); assert.equal( '', pug.render("- var path = 'foo';\na(href='/' + path)") ); }); it('should support block-expansion', function() { assert.equal( 'foo\n\nbar
', pug.render('p.\n foo\n\n bar')); assert.equal( 'foo\n\n\n\nbar
', pug.render('p.\n foo\n\n\n\n bar') ); assert.equal( 'foo\n bar\nfoo
', pug.render('p.\n foo\n bar\n foo') ); assert.equal( '', pug.render('script.\n s.parentNode.insertBefore(g,s)\n') ); assert.equal( '', pug.render('script.\n s.parentNode.insertBefore(g,s)') ); }); it('should support tag text', function() { assert.equal('some random text
', pug.render('p some random text')); assert.equal( 'clickGoogle.
', pug.render('p\n | click\n a Google\n | .') ); assert.equal('(parens)
', pug.render('p (parens)')); assert.equal( '(parens)
', pug.render('p(foo="bar") (parens)') ); assert.equal( '', pug.render('option(value="") -- (optional) foo --') ); }); it('should support tag text block', function() { assert.equal( 'foo \nbar \nbaz
', pug.render('p\n | foo \n | bar \n | baz') ); assert.equal( '', pug.render('label\n | Password:\n input') ); assert.equal( '', pug.render('label Password:\n input') ); }); it('should support tag text interpolation', function() { assert.equal( 'yo, pug is cool', pug.render('| yo, #{name} is cool\n', {name: 'pug'}) ); assert.equal( 'yo, pug is cool
', pug.render('p yo, #{name} is cool', {name: 'pug'}) ); assert.equal( 'yo, pug is cool', pug.render('| yo, #{name || "pug"} is cool', {name: null}) ); assert.equal( "yo, 'pug' is cool", pug.render('| yo, #{name || "\'pug\'"} is cool', {name: null}) ); assert.equal( 'foo <script> bar', pug.render('| foo #{code} bar', {code: '', '', '', ].join(''); assert.equal(html, pug.render(str)); }); it('should support comments', function() { // Regular var str = ['//foo', 'p bar'].join('\n'); var html = ['', 'bar
'].join(''); assert.equal(html, pug.render(str)); // Between tags var str = ['p foo', '// bar ', 'p baz'].join('\n'); var html = ['foo
', '', 'baz
'].join(''); assert.equal(html, pug.render(str)); // Quotes var str = "", js = "// script(src: '/js/validate.js') "; assert.equal(str, pug.render(js)); }); it('should support unbuffered comments', function() { var str = ['//- foo', 'p bar'].join('\n'); var html = ['bar
'].join(''); assert.equal(html, pug.render(str)); var str = ['p foo', '//- bar ', 'p baz'].join('\n'); var html = ['foo
', 'baz
'].join(''); assert.equal(html, pug.render(str)); }); it('should support literal html', function() { assert.equal( '', pug.render('') ); }); it('should support code', function() { assert.equal('test', pug.render('!= "test"')); assert.equal('test', pug.render('= "test"')); assert.equal('test', pug.render('- var foo = "test"\n=foo')); assert.equal( 'footestbar', pug.render('- var foo = "test"\n| foo\nem= foo\n| bar') ); assert.equal( 'test
This
is regular, javascript