Skip to content
/ lazy_rest Public
forked from Varriount/lazy_rest

Simple rst (reStructuredText) HTML generation from Nim or C with some extras

License

Notifications You must be signed in to change notification settings

Araq/lazy_rest

 
 

Repository files navigation

Lazy reST readme

Lazy reST is a Nimrod module providing a spin-off higher level API over Nimrod's rstgen module. The main reasons for this spin-off are:

  • Incompatible, but easier and safer to use API.
  • Explicit C API support for embedding.
  • Embeds Prism for code syntax highlighting of more languages.
  • Drops explicit support for LaTeX.
  • All the latest features supported on the latest stable Nimrod compiler.

On top of the library code, the lazy_rest_badger.exe program shows how to use the library and provides a simple practical rst to html command line tool.

Changes

This is development version 0.2.3. For a list of changes see the docs/changes.rst file.

License

MIT license.

Usage

If you are a Nimrod programmer read the Nimrod usage guide which includes installation steps. C programmers can read the C usage guide which unfortunately requires you to read the Nimrod version too anyway.

Information on how errors are handled is available in the separate Lazy reST error handling document.

All documentation should be available online at http://gradha.github.io/lazy_rest/.

The lazy_rest_badger.exe binary has its own manual in docs/lazy_rest_badger_usage.rst, but running the program with the --help switch should show enough help to get you going.

Git branches

This project uses the git-flow branching model with reversed defaults. Stable releases are tracked in the stable branch. Development happens in the default master branch.

Feedback

You can send me feedback through github's issue tracker. I also take a look from time to time to Nimrod's forums where you can talk to other nimrod programmers.

About

Simple rst (reStructuredText) HTML generation from Nim or C with some extras

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Nim 86.2%
  • C 8.3%
  • Objective-C 3.0%
  • Java 1.7%
  • CSS 0.8%