Reference

This section provides some reference information related to the default metadata of contents and assets, as well as the full documentation of the hastysite min Module.

Default Content and Asset Metadata

The following table lists all the default metadata properties available for contents and assets, and also after which build phase they become available.

Note

You can define your own custom metadata for contents in a header section delimited by five dashes, at the start of each content file.

Property	Content	Asset
id
path
ext
type
title	^1
content-type	^1
date	^(1,2)
timestamp	^(1,2)
contents	^3	^3

¹ This property is defined for all page and post contents created using the default page and post commands.
² This property is defined for all post contents created using the default post command.
³ This property must be added to contents and assets before they can be written to the output folder. This can be done implicitly using symbols provided with the hastysite min module.

hastysite min Module

This min module can be imported in the rules.min file or in any script file and can be used to perform common operations such as ready and writing files, and interact with HastySite data at build time.

assets

∅ ⇒ (meta_*)

Returns a quotation of metadata dictionaries (meta_*) containing the metadata of each asset file.

clean-output

∅ ⇒ ∅

Deletes all the contents of the output directory.

clean-temp

∅ ⇒ ∅

Deletes all the contents of the temp directory.

∅ ⇒ (meta_*)

Returns a quotation of metadata dictionaries (meta_*) containing the metadata of each content file.

input-fread

meta ⇒ string

Reads the contents of the file identified by the metadata dictionary meta (such as those returned by the contents and assets parameters).

Note that:

The source directory is determined by the value of the type metadata property.
The path within the source directory is determined by the value of the path metadata property.

markdown

string₁ dict ⇒ string₂

Converts the HastyScribe Markdown string string₁ into the HTML fragment string₂, using the properties of dict as custom fields (accessible therefore via HastyScribe’s {{$<field-name>}} syntax).

mustache

string₁ dict ⇒ string₂

Renders mustache template string₁ into string₂, using dictionary dict as context.

Note

string₁ is the path to the mustache template file, relative to the templates directory and without .mustache.

output

∅ ⇒ string

Returns the full path to the output directory.

output-cp

meta ⇒ ∅

Copies a file from the source directory (contents or assets depending on its type) to the output directory.

Note that:

The source directory is determined by the value of the type metadata property.
The path within the source directory is determined by the value of the path metadata property.
The destination path within the output directory is determined by the value of concatenation of the id and ext metadata properties.
The contents of the file are retrieved from the contents metadata property (in case of contents) or the contents of the original file (in case of assets).

output-fwrite

meta ⇒ ∅

Writes the contents of the file identified by the metadata dictionary meta (such as those returned by the contents and assets parameters).

Note that:

The destination path within the output directory is determined by the value of concatenation of the id and ext metadata properties.
The contents of the file are retrieved from the contents metadata property (in case of contents) or the contents of the original file (in case of assets).

postprocess

∅ ⇒ ∅

Starts the postprocessing phase of the build.

preprocess

∅ ⇒ ∅

Starts the preprocessing phase of the build.

preprocess-css

string₁ ⇒ string₂

Pre-process CSS contents within string₁, i.e.:

Pseudo-SCSS partial imports. Partial CSS files must start with an underscore and be placed in the css-partials directory (set in your settings.json, or assets/styles if not specified).
CSS variable declarations

Returns the resulting CSS code string₂.

For example, the following CSS code in two different files:

_vars.css:

:root {
   --standard-gray: #cccccc;
}

style.css:

@import 'vars';
.note {
  background-color: var(--standard-gray);  
}

Will be converted into the following:

:root {
  --standard-gray: #cccccc;
}

.note {
  background-color: #cccccc;  
}

Limitation

Only basic support for CSS variables is provided, e.g. no fallback values are supported.

process-rules

∅ ⇒ ∅

Starts the processing phase of the build, and interprets the rules.min file.

settings

∅ ⇒ dict

Returns a dictionary dict containing all the settings defined in the settings.json file.