Skip to content

MIIS 2.0.0

Compare
Choose a tag to compare
@jmalarcon jmalarcon released this 06 Mar 19:52
· 160 commits to master since this release

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 one IISMarkdownHandler.dll. Make sure you delete the old one before updating! You must change the handlers section in your web.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 and TemplateBaseFolder fields do not include a slash / at the end. This makes the paths more readable.
  • The UseMDCaching and AllowEmojis 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 in web.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.