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...
  • 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 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. [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.
  • --help: Show this message and exit.