The landing page of eScriptorium is customizable to fit the requirements of projects instances in term of advertising funding institutions and allow the adding of some additional information. The goal is not to make it the project's home page and as such the amount of modifications is limited.
Three areas of the page are customizable:
- The heading section, right below the black bar, is fully exchangeable.
- The icons section
- The footer section
Since maintaining a full blown CMS in eScriptorium stack would require too much work for too little gain the way to customize is to write html directly into specific templates.
Copy the example homepage directory:
$ cd app/ $ cp -r homepage_example homepage
Make modifications to the 3 templates (additional_heading.html, additional_icons.html, additional_footer.html).
One can add any additional asset like images to the directory, they will be picked up automatically by the static file finder.
Enable the feature through an environment variable and pass the templates to the docker container with a docker volume, in your docker-compose.override.yml file, uncomment this part:
web: &web restart: always ### to customize the homepage, uncomment this environment: - CUSTOM_HOME=True volumes: - $PWD/app/homepage
Restart the web service:
$ docker-compose restart web