create-config

create-config

Create a config based on a given build setup.

Runs the build script on given repository (either locally or a hosted one), infers the required resources (CSS / JS / Md extensions) as well as metadata and creates a MkDocs config file.

Further info here: https://phil65.github.io/mkdocs-mknodes/CLI/

mknodes create-config [OPTIONS]

--repo-url, -r

Repository URL of the target package. Can be remote or local.

--build-fn, -b

Path to the build script. (form: path.to.module:function )

--theme, -t

Default: material Theme to use for the build. Overrides config setting.

-u, --use-directory-urls

Default: True Flag Use directory-style URLs.

--verbose, -v

Flag Enable verbose output. (DEBUG level)

--quiet, -q

Flag Suppress output during build.

--help

Flag Show this message and exit.

Page info

Code for this page

@nav.route.page("create-config", icon="folder-wrench")
def _(page: mk.MkPage):
    page += mk.MkCliDoc(CLI_PATH, prog_name="create-config")

Resources

Resources(css=[],
          markdown_extensions={'attr_list': {},
                               'md_in_html': {},
                               'pymdownx.emoji': {'emoji_generator': <function to_svg at 0x7f6e52627c40>,
                                                  'emoji_index': <function twemoji at 0x7f6e52627b00>},
                               'pymdownx.magiclink': {'repo': 'mkdocs_mknodes',
                                                      'repo_url_shorthand': True,
                                                      'user': 'phil65'}},
          plugins=[],
          js=[],
          assets=[Asset('materialbadge_31c4bf6.css')],
          packages=[])

Metadata

created:
  source_filename: /home/runner/work/mkdocs-mknodes/mkdocs-mknodes/mkdocs_mknodes/manual/cli_section.py
  source_function: null
  source_line_no: 26
icon: material/folder-wrench
template: CLI/create_config.html
title: create-config