gemini

Gemini documentation

• Services
• Datasets

The files below have been converted but have not been altered to work using the new workflow. Consequently internal links will go to the agi website and there may be other errors.

• 1037-uk-gemini-standard-and-inspire-implementing-rules
• 1048-uk-gemini-encoding-guidance
• 1049-metadata-guidelines-for-geospatial-data-resources-part-2
• 1051-uk-gemini-v2-2-specification-for-discovery-metadata-for-geospatial-resources
• 1052-metadata-guidelines-for-geospatial-data-resources-part-1
• 1053-common-metadata-errors-uk-location-discovery-metadata-service
• 1054-operational-guide
• 1055-uk-gemini-major-changes-since-1-0
• 1056-glossary
• 1046-xml-element-order
• 1250-element-summary

Links above this are to the GitHub pages published in https://agiorguk.github.io/gemini/

Services and Datasets workflow

• These files are generated from include files, one per element, in the docs/partials folder.
• The xml snippets are in the docs/snippets folder.
• The naming convention for the element files is {element name in lower case without spaces}.asciidoc
• The naming convention for the xml snippets is {optional dataset or service prefix}-{element name in lower case without spaces}-{optional specific example}.xml

Where content differs between datasets and services, an asciidoctor conditional pre-processor is used to determine which content to use, based on the command-line attribute -a variant-dataset or -a variant-service.

To generate using the asciidoctor docker container, use the -a parameter, from the docs folder:

docker run --rm -v $(pwd):/documents/ asciidoctor/docker-asciidoctor asciidoctor -a docinfo1 -T templates -E slim -a variant-dataset *.adoc *.asciidoc

Then repeat for services:

docker run --rm -v $(pwd):/documents/ asciidoctor/docker-asciidoctor asciidoctor -a docinfo1 -T templates -E slim -a variant-service *.adoc *.asciidoc

Styling

All files share a common attributes file, which indicates the basic attributes to be used when processing. This includes a linked reference to the asciidoc html stylesheet rather than the default embedding. Work has begun to integrate the styling from Gemini.css into asciidoctor.css but this is far from complete.