Skip to content

docsifyjs/docsify-cli

This branch is 1 commit ahead of, 1 commit behind master.

Folders and files

NameName
Last commit message
Last commit date
Jun 16, 2024
Jul 28, 2023
Jun 16, 2024
Jul 28, 2023
Nov 20, 2019
Jul 28, 2023
Mar 24, 2017
Mar 13, 2017
Feb 20, 2019
Nov 3, 2020
Mar 13, 2020
Mar 24, 2017
Mar 24, 2017
Mar 12, 2022
Dec 25, 2019
Nov 24, 2016
Jul 28, 2023
Nov 3, 2020
Sep 12, 2024
Sep 12, 2024
Dec 22, 2019

Repository files navigation

docsify

πŸ–Œ docsify cli - A magical documentation generator.

Backers on Open Collective Sponsors on Open Collective npm Github Actions Status Join Discord community and chat about Docsify license npm-total-download npm-monthly-download

Gold Sponsor via Open Collective

Screencast

Screencast

Running a server on localhost with live-reload.

Installation

Install docsify-cli via npm or yarn globally.

npm i docsify-cli -g
# yarn global add docsify-cli

Usage

init command

Use init to generate your docs.

docsify init [path] [--local false] [--theme vue] [--plugins false]

# docsify i [path] [-l false] [-t vue] [--plugins false]

[path] defaults to the current directory. Use relative paths like ./docs (or docs).

  • --local option:
    • Shorthand: -l
    • Type: boolean
    • Default: false
    • Description: Copy docsify files to the docs path, defaults to false using cdn.jsdelivr.net as the content delivery network (CDN). To explicitly set this option to false use --no-local.
  • --theme option:
    • Shorthand: -t
    • Type: string
    • Default: vue
    • Description: Choose a theme, defaults to vue, other choices are buble, dark and pure.
  • --plugins option:
    • Shorthand: -p
    • Type: boolean
    • Default: false
    • Description: Provide a list of plugins to insert as <script> tags to index.html.

serve command

Run a server on localhost with livereload.

docsify serve [path] [--open false] [--port 3000]

# docsify s [path] [-o false] [-p 3000]
  • --open option:
    • Shorthand: -o
    • Type: boolean
    • Default: false
    • Description: Open the docs in the default browser, defaults to false. To explicitly set this option to false use --no-open.
  • --port option:
    • Shorthand: -p
    • Type: number
    • Default: 3000
    • Description: Choose a listen port, defaults to 3000.

generate command

Docsify's generators.

docsify generate [path] [--sidebar _sidebar.md] [--overwrite]

# docsify g [path] [-s _sidebar.md] [-o]
  • --sidebar option:

    • Shorthand: -s
    • Type: string
    • Default: _sidebar.md
    • Description: Generate sidebar file, defaults to _sidebar.md.
  • --overwrite option:

    • Shorthand: -o
    • Type: boolean
    • Default: false
    • Description: Allow overwrite generated files.

Contributing

Please see the Contributing Guidelines

Contribution

Open in Gitpod

License

MIT