hiccup-cli

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #typescript #llm #go #android #machine-learning #docker #macos #cli #ios #mcp #open-source

(★ 49)

Command line tool / Emacs plugin to convert HTML to Hiccup syntax.

hiccup-cli Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Hiccup-cli

Command line tool / Emacs (and Vim) plugin to convert HTML to Hiccup syntax.

## Installation

### Install hiccup-cli

Download hiccup-cli from the [releases page](https://github.com/kwrooijen/hiccup-cli/releases).

### Emacs

The Emacs package can be installed through [melpa](https://melpa.org/):

```
M-x package-install hiccup-cli
```

## Usage

| Function                    |
|-----------------------------|
| hiccup-cli-paste-as-hiccup  |
| hiccup-cli-region-as-hiccup |
| hiccup-cli-yank-as-hiccup   |

Use `hiccup-cli-region-as-hiccup` to transform the selected HTML to Hiccup syntax

![hiccup region replace](https://raw.githubusercontent.com/kwrooijen/hiccup-cli/master/assets/hiccup-region-replace.gif)

Use `hiccup-cli-yank-as-hiccup` or `hiccup-cli-paste-as-hiccup` to paste HTML as Hiccup from either your kill-ring or clipboard

![hiccup yank](https://raw.githubusercontent.com/kwrooijen/hiccup-cli/master/assets/hiccup-yank.gif)

## Vim integration

### Installation and configuration

1. Download the hiccup-cli binary from [here](https://github.com/kwrooijen/hiccup-cli/releases).
2. Add hiccup-cli to your `$PATH`
3. Because the hiccup-cli does not support reading from stdin, we need to configure it with a bash script called `html2hiccup`.

``` bash html2hiccup
#!/usr/bin/env bash

middle="$(mktemp)"
while IFS= read -r line; do
    echo "$line" >> "$middle"
done

hiccup-cli --html-file "$middle"
```

4. Add `html2hiccup` to your `$PATH`

[vim reference with external command](https://learnvim.irian.to/basics/external_commands#filtering-texts)

### Vim Screenshots
![before](https://user-images.githubusercontent.com/3061798/252752003-925c2cf0-0787-497e-9ba3-a7a8ca88c41f.png)
![after](https://user-images.githubusercontent.com/3061798/252752021-df4478db-4a25-468b-9cb1-2c1ff8aed82d.png)

## Development

### Building hiccup-cli

Make sure you have GraalVM installed.

```bash
git clone git@github.com:kwrooije/hiccup-cli
cd hiccup-cli
lein native-image
sudo cp target/hiccup-cli-0.1.0-SNAPSHOT /usr/local/bin/hiccup-cli
```

## Author / License

Released under the [MIT License] by [Kevin William van Rooijen].

[Kevin William van Rooijen]: https://twitter.com/kwrooijen

[MIT License]: https://github.com/kwrooijen/gungnir/blob/master/LICENSE

hiccup-cli

hiccup-cli Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

hiccup-cli

hiccup-cli Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README