From cd6b484d24b638f08221ff1388564d8369d37126 Mon Sep 17 00:00:00 2001 From: metamuffin Date: Thu, 25 Jan 2024 18:08:18 +0100 Subject: add some mdbook documentation --- doc/import/README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 doc/import/README.md (limited to 'doc/import/README.md') diff --git a/doc/import/README.md b/doc/import/README.md new file mode 100644 index 0000000..d4e014c --- /dev/null +++ b/doc/import/README.md @@ -0,0 +1,20 @@ +# Jellything's Import System + +In normal operation, jellything serves all metadata from only the database. + +Whenever you want to change this metadata, you initiate a Reimport from the +admin panel. This will follow the import instructions in _library\_path_ and +regenerate that part of the database from scratch. + +## The Import Procedure + +_library\_path_ is scanned recursively to locate all files that match `*.yaml` +(YAML import options) or `*.jelly` (JSON import options). Each of these files +contains a key `id` that specifies which node is primarily affected and an array +`sources` which lists metadata providers. When all these files have been +evaluated, each node's children are traversed recursively to generate their +paths. The imported libraries structure is a directed acyclic graph (DAG) - +nodes can have multiple parents. + +The Sources are applied in-order to that node with decreasing priority. This +process merges all aquired metadata into single nodes. -- cgit v1.2.3-70-g09d2