Using this package in a buildout requires having nodejs and npm installed. Once npm is installed, you can enable this theme in a universal installer buildout by taking the following steps:
1) Copy the deploy.cfg
and psu_addons.cfg
files from this repository
into the buildout root directory.
2) Run bin/buildout -c deploy.cfg
3) You should now see the theme respository in src/plonetheme.eeq
. Replace
the cfg files you copied above with symlinks to the cfg files from the
repository::
$ ln -sf src/plonetheme.eeq/deploy.cfg src/plonetheme.eeq/psu_addons.cfg .
Running buildout
will automatically update the theme code and compile the
theme resources. If changes were only made to the theme resources files, you can
clear the theme cache from the theming control panel, otherwise restart the
zeoclients to update the running code.
When running Plone in a development environment, two commands must both be running simultaneously.
/opt/current-plone/zinstance
run bin/instance fg
to serve Plone/opt/current-plone/zinstance/serc/plonetheme.eeq
run grunt watch
to recompile the CSS as changes are madeThese are things that are hard coded into the theme to do certain something if certain conditions are met. The use of these "tricks" is not necessarily obvious, so documenting them here makes sense.
Content Summary Mosiac Tile ^^^^^^^^^^^^^^^^^^^^^^^^^^^
The content summary Mosaic tile provided by jazkarta.tesserae
has been customized to use two different image sizes when rendering the tiles.
Logic:
Referenced item is of type plonetheme.eeq.office
psu_office
image scale.Referenced item has the contentsummary-psu_office
tag applied
psu_office
image scale.Otherwise use psu_tile
image scale.
Initial template: StartBootstrap Business Frontpage
Icons: Font Awesome (fortawesome.github.com/Font-Awesome)
Other: Bootstrap 4 (getbootstrap.com) html5shiv.js (@afarkas @jdalton @jon_neal @rem) jQuery (jquery.com)