Skip to content

nbdev_mkdocs¤

Usage:

$ nbdev_mkdocs [OPTIONS] COMMAND [ARGS]...

Options:

  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • delete-pre-release-docs: Deletes deployed pre-release documentation...
  • docs: Prepares files in 'mkdocs/docs' and then...
  • docstring: Command for adding docstrings to classes...
  • new: Creates files in 'mkdocs' subdirectory...
  • prepare: Runs tests and prepares files in...
  • preview: Prepares files in 'mkdocs/docs' and then...
  • readme: Updates the README.md file from the...
  • social-image: Command for generating a custom social...

nbdev_mkdocs delete-pre-release-docs¤

Deletes deployed pre-release documentation versions.

Usage:

$ nbdev_mkdocs delete-pre-release-docs [OPTIONS]

Options:

  • --help: Show this message and exit.

nbdev_mkdocs docs¤

Prepares files in 'mkdocs/docs' and then runs 'mkdocs build' command on them.

Usage:

$ nbdev_mkdocs docs [OPTIONS]

Options:

  • --root-path TEXT: Project's root path. [default: .]
  • --help: Show this message and exit.

nbdev_mkdocs docstring¤

Command for adding docstrings to classes and methods that don't have one using docstring-gen library.

Usage:

$ nbdev_mkdocs docstring [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • generate: Add docstring to classes and methods that...

nbdev_mkdocs docstring generate¤

Add docstring to classes and methods that don't have one using docstring-gen library.

Usage:

$ nbdev_mkdocs docstring generate [OPTIONS]

Options:

  • -p, --path TEXT: The path to the directory containing Jupyter notebooks. If None, then the "nbs_path" from the settings.ini will be used.
  • --include-auto-gen-txt / --no-include-auto-gen-txt: If set to True, a note indicating that the docstring was autogenerated by docstring-gen library will be added to the end. [default: include-auto-gen-txt]
  • -f, --force-recreate-auto-generated: If set to True, the autogenerated docstrings from the previous runs will be replaced with the new one.
  • --model TEXT: The name of the OpenAI model that will be used to generate docstrings. [default: gpt-3.5-turbo]
  • --temperature FLOAT RANGE: Setting the temperature close to zero produces better results, whereas higher temperatures produce more complex, and sometimes irrelevant docstrings. [default: 0.2; 0.0<=x<=2.0]
  • --max-tokens INTEGER: The maximum number of tokens to be used when generating a docstring for a function or class. Please note that a higher number will deplete your token quota faster. [default: 250]
  • --top-p FLOAT RANGE: You can also specify a top-P value from 0-1 to achieve similar results to changing the temperature. According to the Open AI documentation, it is generally recommended to change either this or the temperature but not both. [default: 1.0; 0.0<=x<=1.0]
  • --n INTEGER: The number of docstrings to be generated for each function or class, with the best one being added to the source code. Please note that a higher number will deplete your token quota faster. [default: 3]
  • --help: Show this message and exit.

nbdev_mkdocs new¤

Creates files in 'mkdocs' subdirectory needed for other 'nbdev_mkdocs' subcommands.

Usage:

$ nbdev_mkdocs new [OPTIONS]

Options:

  • --root-path TEXT: [default: .]
  • --help: Show this message and exit.

nbdev_mkdocs prepare¤

Runs tests and prepares files in 'mkdocs/docs' and then runs 'mkdocs build' command on them.

Usage:

$ nbdev_mkdocs prepare [OPTIONS]

Options:

  • --root-path TEXT: [default: .]
  • --help: Show this message and exit.

nbdev_mkdocs preview¤

Prepares files in 'mkdocs/docs' and then runs 'mkdocs serve' command on them.

Usage:

$ nbdev_mkdocs preview [OPTIONS]

Options:

  • --root-path TEXT: path under which mkdocs directory will be created [default: .]
  • --use-relative-doc-links / --use-host-doc-links: If set to --use-relative-doc-links, relative links are added to symbol references in generated documentation. If set to --use-host-doc-links, the value set in doc_host in settings.ini is added to symbol references in generated documentation. [default: use-relative-doc-links]
  • --port INTEGER: port to use [default: 4000]
  • --help: Show this message and exit.

nbdev_mkdocs readme¤

Updates the README.md file from the 'readme_nb' notebook. Unless explicitly changed in the settings.ini file, the 'readme_nb' points to the 'index.ipynb' notebook in the 'nbs_path' directory.

Usage:

$ nbdev_mkdocs readme [OPTIONS]

Options:

  • --help: Show this message and exit.

nbdev_mkdocs social-image¤

Command for generating a custom social share image.

Usage:

$ nbdev_mkdocs social-image [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • generate: Generate a custom social share image.

nbdev_mkdocs social-image generate¤

Generate a custom social share image.

Usage:

$ nbdev_mkdocs social-image generate [OPTIONS]

Options:

  • --root-path TEXT: Project's root path. [default: .]
  • --generator [file|dall_e]: Generator to use to create the social image. Valid options are: 'file' and 'dall_e'. Choose 'file' if you want to use an existing image from your local machine in the social share image. [default: file]
  • --prompt TEXT: The prompt to use for generating the image. Please pass this option only when using 'dall_e' as the generator. [default: Cute animal wearing hoodie sitting in high chair in purple room, browsing computer, 3d render]
  • --image-path TEXT: Image file path to use in the social share image. Use images with a 1:1 aspect ratio and at least 512x512 pixels for the best results. If None, then the default image will be used. Please pass this option only when using 'file' as the generator.
  • --help: Show this message and exit.