---
created:
  source_filename: /home/runner/work/mkdocs-mknodes/mkdocs-mknodes/.venv/lib/python3.13/site-packages/anyenv/async_run.py
  source_function: run_sync.<locals>.wrapper
  source_line_no: 52
icon: material/folder-wrench
title: 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/

``` {.python }
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
<span class="md-typeset mdx-badge">
  <span class="mdx-badge__icon">:mdi-flag:</span>
  <span class="mdx-badge__text">Flag</span>
</span>
Use directory-style URLs.


### `--verbose`, `-v`

<span class="md-typeset mdx-badge">
  <span class="mdx-badge__icon">:mdi-flag:</span>
  <span class="mdx-badge__text">Flag</span>
</span>
Enable verbose output. (`DEBUG` level)


### `--quiet`, `-q`

<span class="md-typeset mdx-badge">
  <span class="mdx-badge__icon">:mdi-flag:</span>
  <span class="mdx-badge__text">Flag</span>
</span>
Suppress output during build.


### `--help`

<span class="md-typeset mdx-badge">
  <span class="mdx-badge__icon">:mdi-flag:</span>
  <span class="mdx-badge__text">Flag</span>
</span>
Show this message and exit.