Skip to content

Latest commit

 

History

History
35 lines (25 loc) · 1.64 KB

API.md

File metadata and controls

35 lines (25 loc) · 1.64 KB

Table of contents


API namespace for quickdoc.

(quickdoc opts)

Generate API docs. Options:

  • :github/repo - a link like https://github.com/borkdude/quickdoc
  • :git/branch - branch name for source links, default to "main"
  • :source-uri - source link template. Supports {row}, {end-row}, {col}, {end-col}, {filename}, {branch}, {path}, {repo}.
  • :outfile - file where API docs are written, or falsey if you don't need a file. Defaults to "API.md"
  • :source-paths - sources that are scanned for vars. Defaults to ["src"].
  • :toc - generate table of contents. Defaults to true.
  • :var-links - generate links to vars within the same namespace. Defauls to true.
  • :var-pattern - detecting vars for linking, either :backticks (default) or :wikilinks (double brackets)
  • :overrides - overrides in the form {namespace {:no-doc true var {:no-doc true :doc ...}}}
  • :filename-add-prefix - add a prefix to the filename for source links.
  • :filename-remove-prefix - remove a prefix from the filename for source links.
  • :filename-fn - transformation of filename before it is rendered to markdown, e.g. for source links.

Returns a map containing the generated markdown string under the key :markdown.
source