MIIS 2.0.0
Read the full documentation at https://miis.azurewebsites.net/
- Breaking changes from v1.0.x
- New app DLL name:
MIISHandler.dll
instead of the old oneIISMarkdownHandler.dll
. Make sure you delete the old one before updating! You must change the handlers section in yourweb.config
file. Just copy it from the downloaded MISS released files. - Placeholders now use double curly braces (
{{field}}
) instead of just one. Upgrade your templates before updating. - The
Markdown-Template
parameter doesn't exist anymore. Now it uses two independent parameters for the template location and the layout, being much more flexible. See configuration/settings. - the
BaseFolder
field is deprecated. Use~/
instead. - The
BaseFolder
andTemplateBaseFolder
fields do not include a slash/
at the end. This makes the paths more readable. - The
UseMDCaching
andAllowEmojis
parameter's value are"1"
by default (enabled), so you don't need to specifcy them most of the time.
- What's new
- Includes in templates. Now you can reuse any part of your template to define different layouts using the same base code. The include files can include other files too (no circular-references allowed).
- "Fragments". This powerful new concept allows you to define several contents to be located in the same layout to form a single page, even with optional parts.
- Front Matter: Define any parameter in the Front-Matter of a file and use it inside the content or in the current template. Re-define any global parameter or field to be applied differently in any page. For example, you can define something as simple as the title or author of the page, or even change the layout it uses to render itself. Front-Matter values take precedence over values defined globally.
MIIS:
prefix to define global parameters & fields inweb.config
files. To avoid conflict with parameters of the same name in other software you may be using. The use of this prefix is optional but recommended. It'll take precedence over the non-prefixed parameters with the same name in case of conflict.