A universal document authoring package for Julia.
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:
- built-in live server to view your changes in real-time,
- uses a fully-compliant commonmark parser, CommonMark.jl,
- produces HTML and PDF files natively, no LaTeX dependencies to manage yourself,
- publication-quality PDF generation uses tectonic for self-contained, reproducible builds,
- combine markdown files, Jupyter notebooks, and Julia files for your content,
- supports themes to customise both HTML and PDF output,
- and declarative configuration built on top of Julia's Pkg.jl package manager.
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.