This command-line utility creates markdown-based documentation for your Solidity project(s) for the following platforms:

• Ethereum
• Ethereum Classic
• Tron
• Qtum
• Wanchain
• Aeternity
• Counterparty
• Rootstock
• Ubiq
• Monax

sudo npm install solidoc -g

CLI Arguments

1. Path to truffle project (or similar) root.
2. Path to generate documentation to.
3. Do not recompile. Optional, default: false.
4. Language. Optional, default: en.

How to Use Solidoc?

On your project root, run the following command.

solidoc ./ ./docs true

This will generate documentation to the docs directory.

Or edit package.json

  "scripts": {
    "docgen": "solidoc ./ ./docs"
  }

and run

npm run docgen

Note

Do not use recompilation (third argument) if you are using this on a non truffle project.

Alternatively, you can create solidoc.json configuration file in your project root.

{
  "pathToRoot": "./",
  "outputPath": "./docs",
  "noCompilation": true,
  "compiler": "truffle compile",
  "language": "en"
}

and then call solidoc instead of passing any command line argument.

If you wish to change bits and pieces of the documentation generated, place solidoc templates on the following directory:

./.solidoc/templates/

Solidoc Templates

You can also override language literals by copying and editing i18n files on the following path:

./.solidoc/i18n/

• OpenZeppelin Solidity Documentation
• Open Source Vesting Schedule by Binod
• Virtual Rehab Token
• Virtual Rehab Private Sale