Skip to content

dbrattli/sphinxcontrib-fsharp

 
 

Repository files navigation

sphinxcontrib-fsharp is a Sphinx (1.6.3+) extension to document F# libraries. It provides a Sphinx domain for F# and autodoc-like directives to generate documentation from source code (not ported to F# yet).

It's licensed under the MIT license. It's available on the Python package index. Its documentation and its source code are on GitHub.

Questions? Remarks? Bugs? Want to contribute? Open an issue!

Status

sphinxcontrib-fsharp is a fork of spinxcontrib-ocaml and still highly experimental. Interfaces may be changed unannounced. We welcome all contributions so please feel free to submit PRs.

Quick start

Install both packages:

$ pip3 install sphinxcontrib-fsharp

Enable and configure the Sphinx extension in your conf.py file:

extensions.append("sphinxcontrib.fsharp")
primary_domain = "fsharp"  # Optional
fsharp_source_directories = ["src"]
fsharp_findlib_packages = ["batteries", "js_of_fsharp"]

And document your module (in an .rst file):

.. autoocamlmodule:: MyModule

About

Sphinx extension to document F# libraries

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 57.5%
  • JavaScript 20.3%
  • OCaml 11.5%
  • CSS 5.5%
  • Python 4.8%
  • Shell 0.4%