Publish.jl

A universal document authoring package for Julia.

Documentation (stable) Documentation (dev) Build Status codecov

Disclaimer

Currently this package should be regarded as experimental — a proving ground for new features for the Julia documentation ecosystem rather than a mature and proven piece of software. If you need a solution that will definitely work, look at Documenter.jl instead.

This is a package for Julia that provides a general framework for writing prose — technical documentation is its focus, though it is general enough to be applied to any kind of written document.

Some standout features:

Publish can scale from single pages all the way to large cross-referenced multi-project documents.

To jump straight in and begin using Publish run the following in your Julia REPL:

pkg> add Publish

julia> using Publish

julia> serve(Publish)
✓ LiveServer listening on http://localhost:8000/ ...
  (use CTRL+C to shut down)

The above will install Publish, import it, and then start up a local web-server for Publish’s own documentation — the content you’re reading right now. Open the link in your web browser and then continue on to the next section, Getting Started.