polaris.analysis.site.generate_site

polaris.analysis.site.generate_site(published, output_path, simulation_name, provenance=None)[source]

Generate the static site over the products that have been published

The site is a landing page of gallery groups, plus one page of thumbnails per gallery. It is rendered from the merged manifest alone, so that a facet added later, a richer presentation, or a different visual design costs nothing anywhere else: no step, no manifest fragment already written, and no published path has to change.

The pages have their CSS inlined and no JavaScript, so a page costs one request and its images, and works the same from a local filesystem and from a web portal.

Parameters:

  • published (list of dict) – The merged manifest, as publish() returned it

  • output_path (str) – The root of the staging tree, where the pages are written

  • simulation_name (str) – The name of the simulation that was analyzed, shown on every page

  • provenance (dict, optional) – Labels and values recording what produced the results, shown in the footer of every page. By default, the provenance of the Polaris that is running, from polaris.provenance.get_summary().

Returns:

filenames (list of str) – The pages that were written, the landing page first