Skip to content
This repository has been archived by the owner on Oct 29, 2024. It is now read-only.

A toolset for Reason / OCaml related documentation generation

License

Notifications You must be signed in to change notification settings

rescript-association/doc-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

doc-tools

A toolset for Reason / OCaml related documentation generation

Requirements

  1. Clone Bucklescript somewhere on your machine (for example at ~/projects/bucklescript).
  2. Follow the build instructions in CONTRIBUTING.md in the Bucklescript repository.
  3. Install esy with npm install -g esy.

Generate documentation from Bucklescript modules

Make sure you followed all the steps in the Requirements section first. Once that is done, you can build the bs-doc tool (this is a temporary name).

$ esy

And finally, run the tool to generate the documentation artefacts (e.g. JSON):

$ esy x -- bs-doc --output=_output --bs-project-dir=~/projects/bucklescript

This will generate JSON and odoc files in the _output folder. When regenerating the files, make sure to remove the previously created files.

For additional configuration options see:

$ esy x -- bs-doc --help

Working on JSON generator

Currently the JSON generation is implemented in a forked version of odoc.

To work with the JSON generator, clone the forked version of odoc on your machine and build it with esy esy @ocaml-4.06.

To use the modified version of odoc, you can update the package.json file in this repository to link to the cloned odoc folder.

About

A toolset for Reason / OCaml related documentation generation

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages