Skip to content

sbliven/scicat-documentation

 
 

Repository files navigation

SciCatLogo.png

SciCat Metadata Catalogue

Build Status

Why SciCat ?

See the SciCat Home Webpage for an overview of how SciCat can help to manage scientific data.

Structure of Documentation

SciCat documentation is split into the following chapters:

  • User Guide - Users of the system can come here to see screen captures, FAQs and find resources on how to better understand SciCat.
  • Operator Guide - System admins read this part to set up SciCat for their location
  • Ingestor Guide - Instrument responsibles read this to understand how data can ge ingested into SciCat either manually or in an automated fashion
  • Developer Guide - Developers who want to contribute to the project should read this chapter.

Talks

SciCat Project: Data Catalog System (2017) SciCat talk from Luke Gorman on Joint ExPaNDS and PaNOSC Meeting Feb 2020

Building

Docs are built using honkit. This can either be installed locally using npm or run via docker.

Serving documentation with docker

docker compose up -d

This should start the honkit server on http://localhost:4040. Honkit will watch for changes in the source files and automatically re-build them.

Serving the Documentation locally

You can also run the honkit server locally using npm:

npm install
npm run start

Publishing the documentation

The website will be automatically rebuilt after each change to the master branch by a github action.

About

Documentation for SciCat metadata server 📃

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 77.4%
  • CSS 22.6%