lima: Haskell -> Markdown and Literate Haskell <-> Markdown converter

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.

[maintain] [Publish]

See README here or on GitHub


[Skip to Readme]

Properties

Versions 0.1.0.0, 0.1.0.0, 0.1.0.1, 0.1.0.2, 0.1.0.3, 0.1.0.4, 0.1.0.5, 0.1.0.6, 0.2.0.0, 0.2.1.0, 0.2.1.1, 0.2.1.2, 0.2.1.3, 0.3.0.0
Change log CHANGELOG.md
Dependencies aeson, base (>=4 && <5), data-default, lima, optparse-applicative, yaml [details]
License MIT
Author Fabian Schneider
Maintainer Danila Danko
Category Productivity
Bug tracker https://github.com/deemp/flakes/issues
Source repo head: git clone https://github.com/deemp/flakes/tree/main/lima#readme
Uploaded by deemp at 2023-01-31T13:39:12Z

Modules

[Index] [Quick Jump]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


Readme for lima-0.1.0.0

[back to package description]

lima

Convert between

It is possible to make conversion abide the roundtrip property. In other words, make conversions file.lhs -> file.lhs.md -> file.lhs.md.lhs or file.hs -> file.hs.md -> file.hs.md.hs and get file.lhs = file.lhs.md.lhs and file.hs = file.hs.md.hs in terms of their contents.

Alternatives

Conversion

file.hs -> file.hs.md

Examples

Rules for .hs -> .md conversion:

file.lhs -> file.lhs.md -> file.lhs.md.lhs

Examples:

As .lhs doesn't support # (heading) or > (quotation start) at a line beginning, one should write # and > instead.

If you'd like to provide some code in a .lhs, follow these rules:

Command-line tool

cabal

  1. Clone this repo and install lima.

    git clone https://github.com/deemp/flakes
    cd flakes/lima
    cabal update
    cabal install .
    

nix

  1. Install Nix

  2. Get lima on PATH.

    nix flake lock github:deemp/flakes
    nix shell github:deemp/flakes?dir=lima
    lima --help
    

Windows

To install the executable on Windows, if you can't convince cabal to use --bindir-method=copy you can build the project locally and copy the built executeable to C:/Users/username/AppData/Roaming/cabal/bin and ensure that this directory is in your PATH.

Contribute

Clone this repo and enter lima

git clone https://github.com/deemp/flakes
cd flakes/lima

cabal

Build as usually

cabal update
cabal build

nix

  1. Install Nix. Optionally, learn more about Nix.

  2. Run a devshell and build lima:

    nix develop nix-dev/
    cabal build
    
  3. Optionally, start VSCodium:

    nix run nix-dev/#writeSettings
    nix run nix-dev/#codium .
    
  4. Open a Haskell file there, hower over a term and wait until HLS shows the hints.

  5. Troubleshoot if necessary.