DocPub is a command line utility for converting a folder structure of markdown files to HTML and uploading the result to Zendesk.
To install the utility, use npm install command:
npm install -g docpubGlobal installation is used for launching commands.
DocPub is configured using a config file. The only supported config file format is JSON.
By default, DocPub looks for the config in the root of documentation folder by docpub.conf name.
If needed, specific config location may be set with --config-path CLI option. Please note, that
this option accepts path to the file, not to the folder, where config is located
The minimal config must include following required options:
username- name of ZenDesk user with documentation publish access rightstoken- Zendesk API access tokenurl- fully qualified URL of yourZenDeskspace
Example:
{
"username": "[email protected]",
"token": "abc123def456ghi789",
"url": "https://example.zendesk.com"
}Please see more about other configuration options and options overriding in config section.
Run the command docpub from the directory that you wish to convert and upload.
This will do the following:
- Convert the contained markdown files to HTML
- Create a new category on Zendesk which contains sections matching the specified path's folder structure
- Upload the HTML for each article into the corresponding section
Note: Alternatively, you can Run docpub -p {path} to run the utility on the specified path.
This utility will convert and upload files for a single Category on the Zendesk Help Center. Before running the utility, the markdown files that you wish to convert and upload must be within a certain folder structure that follows that Category > Section > Article structure of Zendesk. Each folder must also contain a meta.json file that has metadata about the Category, Section, or Article.
See Documentation Folder Structure for specifications on folder structure. See Metadata Format for specifications on the metadata file.
Run npm install to install dependencies. This will also setup the precommit and preversion hooks.
Run npm test to run the tests under the test directory with Mocha.
Tests are divided into unit tests and functional tests, and utilize SinonJS for spies, stubs, and mocks as well as ChaiJS for assertions.
husky is used to provide hooks prior to committing and versioning. This will run linter for commits and linter + all tests for releases. If any of the tests fail to pass or any file doesn't meet the ESLint specifications, you will not be allowed to commit or version.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent