- Support Liquid template, templates ending with
.liquid
are considered as using liquid templating language. Liquid containsinclude
tag to support partials, we follow the ruby partials naming convention to have_<partialName>.liquid
as partial template. A custom tagref
, e.g.{% ref file1 %}
is introduced to specify the resource files that current template depends on. - DFM include syntax is updated to use
[!include[<title>](<filepath>)]
syntax - Disable glob pattern in
docfx metadata
command line option as it is to some extent confusing, consider using a-g
option later to re-enable it.
- Rewrite Glob
The syntax of glob is:
**
is called globstar, it matches any number of characters, including/
, as long as it's the only thing in a path part.- If
**
is right behind/
, it is a shortcut for**/*
. *
matches any number of characters, but not/
?
matches 1 characters, but not/
{}
allows for a comma-separated list of "or" expressions, e.g.{a,b}
=>a
andb
!
at the beginning of a pattern will negate the match[...]
matches a range of characters, similar to a RegExp range/
is considered as path separator, while\
is considered as escape character
- Support
fileMetadata
. You can specify different metadata value using glob pattern - Improve overwrite functionality. Now you can overwrite not only summary/remarks, but also descriptions for parameters. You can even add exceptions.
- Now the latest project.json projects are also supported in DNX version.
- Simple code snippet is now supported, syntax is
[!code-REST-i[title](path "optionalTitle")]
- Url is now encoded in markdown link.
- Add section syntax in DFM
- Fix several bugs in DFM
- Update default template: rename css/js file
- Fix several display issue in default template
- Support Static Website Templates
- Schema change to docfx.json