2024-11-13 15:24:41 +01:00
|
|
|
{ lib, ... }:
|
|
|
|
let
|
|
|
|
inherit (lib)
|
|
|
|
mkOption
|
|
|
|
types
|
|
|
|
;
|
|
|
|
in
|
|
|
|
{
|
2024-11-13 15:24:41 +01:00
|
|
|
content-types.document = { name, config, options, link, ... }: {
|
2024-11-13 15:24:41 +01:00
|
|
|
config._module.args.link = config.link;
|
|
|
|
options = {
|
|
|
|
name = mkOption {
|
|
|
|
description = "Symbolic name, used as a human-readable identifier";
|
|
|
|
type = types.str;
|
|
|
|
default = name;
|
|
|
|
};
|
|
|
|
locations = mkOption {
|
|
|
|
description = ''
|
|
|
|
List of historic output locations for the resulting file
|
|
|
|
|
2024-11-13 15:24:41 +01:00
|
|
|
Elements are relative paths to output files, without suffix.
|
|
|
|
The suffix will be added depending on output file type.
|
|
|
|
|
2024-11-13 15:24:41 +01:00
|
|
|
The first element is the canonical location.
|
|
|
|
All other elements are used to create redirects to the canonical location.
|
2024-11-13 15:24:41 +01:00
|
|
|
|
|
|
|
The default entry is the symbolic name of the document.
|
|
|
|
When changing the symbolic name, append the old one to your custom list and use `lib.mkForce` to make sure the default element will be overridden.
|
2024-11-13 15:24:41 +01:00
|
|
|
'';
|
|
|
|
type = with types; nonEmptyListOf str;
|
2024-11-13 15:24:41 +01:00
|
|
|
apply = config.process-locations;
|
2024-11-13 15:24:41 +01:00
|
|
|
example = [ "about/overview" "index" ];
|
|
|
|
default = [ config.name ];
|
2024-11-13 15:24:41 +01:00
|
|
|
};
|
|
|
|
process-locations = mkOption {
|
|
|
|
description = "Function to post-process the output locations of contained document";
|
|
|
|
type = types.functionTo options.locations.type;
|
|
|
|
default = lib.id;
|
2024-11-13 15:24:41 +01:00
|
|
|
};
|
|
|
|
link = mkOption {
|
|
|
|
description = "Helper function for transparent linking to other pages";
|
|
|
|
type = with types; functionTo str;
|
2024-11-13 15:24:41 +01:00
|
|
|
# TODO: we may want links to other representations,
|
|
|
|
# and currently the mapping of output types to output file
|
|
|
|
# names is soft.
|
2024-11-13 15:24:41 +01:00
|
|
|
default = target: with lib; "${relativePath (head config.locations) (head target.locations)}.html";
|
2024-11-13 15:24:41 +01:00
|
|
|
};
|
|
|
|
outputs = mkOption {
|
|
|
|
description = ''
|
|
|
|
Representations of the document in different formats
|
|
|
|
'';
|
|
|
|
type = with types; attrsOf str;
|
|
|
|
};
|
|
|
|
};
|
|
|
|
};
|
|
|
|
}
|