X-Git-Url: http://git.squeep.com/?p=squeep-html-template-helper;a=blobdiff_plain;f=README.md;h=c6f92261925b04abe67a34bbce9b18906a51364d;hp=66d16fd19dcee2f060d972d0944fce7192cec45f;hb=HEAD;hpb=4ab85bf22ece77cccd4e92435208bca5858816f6 diff --git a/README.md b/README.md index 66d16fd..68f91ea 100644 --- a/README.md +++ b/README.md @@ -4,28 +4,28 @@ Simplistic helpers for rendering HTML and boilerplate. Specific to Squeep Framework Applications, this module has strong opinions and makes many assumptions. +Expects `/static/theme.css` and `/static/custom.css` to exist. + ## API -`htmlPage(pagePathLevel, ctx, options, main = [])` +- `initContext(ctx)` +- `htmlPage(pagePathLevel, ctx, options, main = [])` +- `dateOrNot(date, otherwise)` +- `dateFormat(date, pInf nInf, otherwise)` +- `timeElement(date, options)` +- `secondsToPeriod(seconds)` +- `indented(intent, list)` +- `UL(items, indent, attributes, itemAttributesGenerator)` +- `OL(items, indent, attributes, itemAttributesGenerator)` +- `LI(item, indent, attributes)` ### Context -The context is referenced for authenticated user information, as well as messaging. - -- `ctx.session.authenticatedIdentifier` -- `ctx.session.authenticatedProfile` - -If either of these are present, a navigation link is added to the page header allowing the user to log out. -The link will point relatively to `/admin/logout`. - -- `ctx.url` - -If present, added as a query parameter (`r`, for redirect) to the logout link. - - `ctx.errors` - `ctx.notifications` Lists of errors and notices to show at top of page, before main content. +`initContext` will create the arrays. ### Options @@ -40,3 +40,7 @@ Lists of errors and notices to show at top of page, before main content. - `options.notificationHeading` - h2 for notice section - `options.notificationContent` - additional information included ahead of list of notices - `options.` + +## Tests + +`LintHtml` class is a simple wrapper around `html-validate` package which can report issues with generated html strings.