A transform that adapts html files generated with jsdoc to be rendered in a github wiki or readme.
As part of that it converts all source code indicators to point to the relevant file inside your github repository.
npm install jsdoc-githubify
This transform is compatible with the following tools:
wicked is using this transform to adapt html files generated by jsdoc in order to generate API wiki pages for your project.
It uses mutiny to run the transform.
Transforms the piped jsdoc generated html to make it usable on github, i.e. in a Readme or wiki
The resulting html has the following transformations:
- all code sample links are redirected point to gihub repo blob
- wrap in div.jsdoc-githubify for styling
The github blob url is derived from the remote of the github repository in the current directory and the currently checked out branch is used. You can override these with the following environment vars:
JSDOC_GITHUBIFY_REMOTEJSDOC_GITHUBIFY_BRANCH
@name gitifyTransform @function params:
- file String filename ignored by this transform
returns:
TransformStream into which to pipe the html string generated by jsdoc
MIT