Initial Setup

Dependencies

Hugo - Minumum version: v0.81.0

This version introduced the ability to add CSS classes to Markdown code blocks, a feature that has been used in the content. e.g.

A paragraph of text.
{.css-class}

Node.js and PostCSS

PostCSS and associated plugins are used to process the CSS during Hugo builds. Node.js will need to be installed per your operating system. And PostCSS installed as a global module:

npm install -g postcss-cli

Once the your have the working copy of the site checked out install node modules:

cd themes/jalview
npm install

Running Hugo

Running hugo server will generate the site and set up a local server at http://localhost:1313 but adding some extra command line flags can be helpful:

hugo server --navigateToChanged --gc

--navigateToChanged will causes the browser to display the page being edited. --gc tells Hugo to clean up unused resources.

If you are editing the templates or stylesheets you may also need --disableFastRender to have any changes rendered (this increases build time however):

hugo server --disableFastRender --navigateToChanged --gc