claferwiki: A wiki-based IDE for literate modeling with Clafer

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.


A wiki-based IDE for literate modeling with Clafer. A Plugin for the Gitit wiki which collects code blocks written in Clafer (.clafer), compiles them, renders into HTML and Dot, and replaces the code blocks with the results.

[Skip to ReadMe]


Versions0.3.5,, 0.3.6,, 0.3.7, 0.3.8, 0.3.9, 0.3.10, 0.4.0, 0.4.1, 0.4.2,, 0.4.3, 0.4.3, 0.4.4, 0.4.5
Dependenciesbase (>= && <5), clafer (==0.4.3), containers (>=, directory (>=, gitit (>=, MissingH (>=, mtl (>=, network (>=, network-uri (>=, process (>=, SHA (>=, split (>=0.2.2), time (>=1.4.2), transformers (>=, transformers-compat (>=0.3 && <0.5), utf8-string (>=0.3.8) [details]
CopyrightMichal Antkiewicz, Chris Walker, Luke Michael Brown
AuthorMichał Antkiewicz, Chris Walker, Luke Michael Brown
MaintainerMichał Antkiewicz <>
Home page
Source repositoryhead: git clone git://
UploadedTue Dec 22 18:51:43 UTC 2015 by mantkiew




Maintainers' corner

For package maintainers and hackage trustees

Readme for claferwiki-0.4.3

[back to package description]



Claferwiki is a wiki system integrated with Clafer compiler. Clafer is a lightweight yet powerful structural modeling language. Claferwiki allows for embedding Clafer model fragments in wiki pages and provides model authoring support including code highlighting, parse and semantic error reporting, hyperlinking from identifier use to its definition, and graphical view rendering. Claferwiki supports informal-to-formal modeling, that is, gradually refining parts of specification in natural language into a Clafer model fragments. Claferwiki supports literate modeling - both the rich text and the model fragments can be freely mixed. Informal-to-formal modeling is important during domain modeling. Also, Claferwiki acts as a collaborative, lightweight, web-based model publishing environment for Clafer. In addition to code highlighting, error reporting, hyperlinking, and graphical view rendering, it also provides model versioning and distributed online/offline editing capabilities as it is based on the Git distributed version control system and the Gitit wiki. Claferwiki is also integrated with other Clafer Web Tools, allowing to open the current page in:

Live demo

Try me! If the demo is down or you encounter a bug, please email Michal Antkiewicz.


Getting the Clafer Wiki

Clafer can be installed either from Hackage or from the source code.

Dependencies for running

Regardless of the installation method, the following are required:

Installation from Hackage

Claferwiki is now available on Hackage and it can be installed using either stack or cabal-install.

Installation using stack

Stack is the only requirement: no other Haskell tooling needs to be installed because stack will automatically install everything that's needed.

  1. stack update
  2. stack install claferwiki

Installation using cabal-install

  1. cabal update
  2. cabal install claferwiki-0.4.3 -fhighlighting -fhttps -fplugins -fnetwork-uri
  3. cd <cabal's lib or share folder> (C:\Users\<user>\AppData\Roaming\cabal\i386-windows-ghc-7.10.2\claferwiki-0.4.3 on Windows or .cabal/share/x86_64-linux-ghc-7.10.2/claferwiki-0.4.3/ on Linux)
    • execute make install to=<target directory>
    • this will copy the wiki files

Important: branches must correspond

All related projects are following the simultaneous release model. The branch master contains releases, whereas the branch develop contains code under development. When building the tools, the branches should match. Releases from branches 'masterare guaranteed to work well together. Development versions from branchesdevelop` should work well together but this might not always be the case.

Installation from source code

  1. In some <source directory> where you want to have the wiki source code
    • execute git clone git://
  2. execute stack update
  3. execute make init
  4. install clafer from source code
  5. execute make
  6. execute make install to=<target directory>
    • this will copy the wiki files
  7. in <target directory>, execute git init to create a git repository for the wiki data
    • NOTE: see repository-path: option in gitit.cnf


Wiki can be configured by editing the gitit.cnf file. See Configuring and customizing gitit.

Installation using stack

Using cabal-install



<a href=""> <img src="" width="30%" alt="Telematics Example, Module Overview"> </a> <a href=""> <img src="" width="30%" alt="Telematics Example, Module Details" > </a>

Using Clafer Wiki

For general usage information for the GitIt wiki see the README. You can insert code blocks with clafer code anywhere in the page as follows: ```clafer <here goes your model fragment> ``` The model overview, including the graph, stats, and download links, can be added as follows: ``` {.clafer .summary} <the contents in this block are ignored> ``` To have the code blocks correctly processed, make sure to add an empty line before and after the code block, even if the code block is the last element on the page.

How it works

Need help?