gbif / tech-docs

This is an integrated technical documentation site for GBIF.org
https://techdocs.gbif.org
0 stars 2 forks source link

Revise the GBIF theme #3

Closed timrobertson100 closed 1 year ago

timrobertson100 commented 3 years ago

The existing theme is a copy of the LiskIO one as described at the top of the theme readme.

This contains some very quick hacks(!) to get it to appear similar to the GBIF.org site.

The theme needs to be something that we can easily maintain, so we may wish to start from scratch or use the original Antora theme from which the Lisk one was derived.

Please keep the built artifact in github as it is referenced in the antora playbook

MortenHofft commented 3 years ago

I've created a branch https://github.com/gbif/tech-docs/tree/theme with basic styling and search using the library mentioned in https://github.com/gbif/tech-docs/issues/4

Build with docker run -u $(id -u) -v $PWD:/antora:Z --rm -t ggrossetie/antora-lunr --cache-dir=./.cache/antora antora-playbook.yml

MattBlissett commented 1 year ago

I moved the theme to https://github.com/gbif/tech-docs-theme and configured a build in Jenkins: https://builds.gbif.org/job/tech-docs-theme/

NB the built artifact is retrieved directly from Jenkins.