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.