flake.parts-website

This module is used to build the flake.parts website.

Refer to the Generate Documentation guide for more information.

Its interface is subject to change but moves slowly and changes should be simple.

Installation

To use these options, add to your flake inputs:

flake.parts-website.url = "github:hercules-ci/flake.parts-website";

and inside the mkFlake:

imports = [
  inputs.flake.parts-website.flakeModules.empty-site
];

Run nix flake lock and you're set.

Options

perSystem.render.inputs

Which modules to render.

Type: attribute set of (submodule)

Declared by:

perSystem.render.inputs.<name>.attributePath

Flake output attribute path to import.

Type: list of string

Default:

[
  "flakeModule"
]

Example:

[
  "flakeModules"
  "default"
]

Declared by:

perSystem.render.inputs.<name>.baseUrl

URL prefix for source location links.

Type: string

Declared by:

perSystem.render.inputs.<name>.filterTransformOptions

Function to customize the set of options to render for this input.

This is mostly for overriding the default behavior, which excludes the options of the flake-parts module itself, unless it’s the flake-parts core itself that’s being rendered.

Type: unspecified value

Default: <function, args: {baseUrl, coreOptDecls, sourceName, sourcePath}>

Declared by:

perSystem.render.inputs.<name>.fixupAnchorsBaseUrl

Replace same-page links without opt- prefix with this prefix.

Type: null or string

Default: null

Declared by:

perSystem.render.inputs.<name>.flake

A flake.

Type: raw value

Default: inputs.${name}

Declared by:

perSystem.render.inputs.<name>.flakeRef

Flake reference string that refers to the flake to import, used in the generated text for the installation instructions, see installation.

Type: string

Default: Determined from config.baseUrl.

Declared by:

perSystem.render.inputs.<name>.getModules

Get the modules to render.

Type: function that evaluates to a(n) list of raw value

Default: Derived from config.attributePath, <name>

Declared by:

perSystem.render.inputs.<name>.installation

Installation paragraph between installation and options.

Type: string

Default: Generated

Declared by:

perSystem.render.inputs.<name>.installationDeclareInput

Whether to show how to declare the input.

Type: boolean

Default: true

Declared by:

perSystem.render.inputs.<name>.intro

Introductory paragraph between title and installation.

Type: string

Declared by:

perSystem.render.inputs.<name>.isEmpty

Whether this input is empty, ie has no documented options.

Normally this is indicative of a inaccurate tracking of declaration sources, or declaring options in perSystem.config instead of mkPerSystemOption.

If your module really has no options of its own (ie only imports and config), set this to true.

Type: boolean

Default: false

Declared by:

perSystem.render.inputs.<name>.menu.enable

Whether to add this page to the navigation menu.

Modules in the flake-parts repo disable this, as they’re hardcoded into the menu.

Type: boolean

Default: true

Declared by:

perSystem.render.inputs.<name>.menu.title

Title of the menu entry.

Type: string

Default: "‹name›"

Declared by:

perSystem.render.inputs.<name>.preface

Stuff between the title and the options.

Type: string

Default: intro followed by installation

Declared by:

perSystem.render.inputs.<name>.rendered

A package containing the generated documentation page.

Type: package (read only)

Declared by:

perSystem.render.inputs.<name>.separateEval

Whether to include this in the main evaluation.

By default, all modules are evaluated together, except ones that enable this option.

Type: boolean

Default: false

Declared by:

perSystem.render.inputs.<name>.sourceName

Name by which the source is shown in the list of declarations.

Type: string

Default: "‹name›"

Declared by:

perSystem.render.inputs.<name>.sourcePath

Source path in which the modules are contained.

Type: path

Default: config.flake.outPath

Declared by:

perSystem.render.inputs.<name>.title

Title of the markdown page.

Type: string

Default: "‹name›"

Declared by:

perSystem.render.officialFlakeInputs

The inputs from the flake.parts-website flake.

This supplements the inputs module argument when the rendering module is used in a different flake.

Type: raw value (read only)

Declared by: