VIVO-1500: Write "Simple Theming"

[chenejac]

Mike Conlon (Migrated from VIVO-1500) said:

Need one or more pages in the "Preparing for Production" section that discuss simple theming:

• modify site info (no theming required)
• create a simple theme modify header to add logo modify CSS to add colors ** modify footer "About VIVO" and "Support" links

This page will refer to material in Building VIVO in Three Tiers (that page will likely be renamed)

[chenejac]

Mike Conlon said:

Draft in progress here:  https://wiki.duraspace.org/display/VIVODOC110x/Simple+Theming

Comments welcome!

[chenejac]

Mike Conlon said:

Also created https://wiki.duraspace.org/display/VIVODOC110x/Adding+Site+Information

since this is in the same vein – getting ready for production.  And its not theming, but provides localization info.

[chenejac]

Mike Conlon said:

Complete draft in place

Still to do:  Add detail regarding how to edit stylesheet

[chenejac]

Mike Conlon said:

See https://wiki.duraspace.org/display/VIVODOC110x/Simple+Theming

Requesting reviews from @roflinn and @gneissone.  Please leave comments here in the JIRA regarding anything you'd like to see added or changed.  I have tried to keep things simple for new comers – this page is positioned early in the documentation.  It references more detailed pages.  I have focused on "simple theming" – logo, colors.  I have used the techniques to theme a site for Duraspace.  See attached.  I don't have permission to make this public, and the logo is botched, I shrunk their logo with some primitive software.  But you get the idea.  The technique described works.  It's an "as is" description – theming VIVO 1.10 as it is.

[chenejac]

Benjamin Gross said:

I don't know if we should be instructing people to edit files in ./vivo/installer/webapp/target/. I believe mvn install would deploy the files to tomcat, but mvn clean install would erase them. 

If you're looking for the simplest way to make changes, why not edit files directly in tomcat, ./tomcat/webapps/vivo? 

[chenejac]

Mike Conlon said:

Yup.  The method describes "works" but mvn clean install  erases.  

I think the preferred solution is to have a documented way to manage customizations and describe this method as a customization and do whatever the customization page says.  I'll be working on that next, and perhaps this JIRA should stay open until we have a way of describing builds with customizations.

I've linked this JIRA to the JIRA documenting builds with customizations.

[chenejac]

Andrew Woods said:

Pending completion of: https://wiki.duraspace.org/display/VIVODOC110x/Preserving+Customizations+During+Build

[chenejac]

This issue depends on #3041