Jevko CLI (Command Line Interface).
One jevko command to rule all Jevko formats.
Experimental.
Currently supports .jevkoml, .jevkodata, .jevkocfg.
Can convert the Jevko formats into well-known and well-supported formats (e.g. JSON, HTML, XML and XML-based formats, such as SVG).
Can also convert from JSON to .jevkodata. More conversion options are planned.
Jevko formats are generally much more pleasant to read, write, edit, or generate -- by hand or otherwise.
Jevko CLI manages various different Jevko formats with one command.
It can be used to easily integrate Jevko formats into applications that deal with XML or JSON, providing facilities that can make authoring and maintaining HTML documents, XML or JSON configurations, SVG graphics, and countless XML-based formats much more enjoyable.
These instructions will guide you through installing Deno and then using it to install jevko as a command in your system, so that you can invoke it from anywhere.
Jevko CLI has one dependency: Deno.
Fortunately Deno is very nice and easy to install. Deno is distributed as a single binary executable with no external dependencies.
This command will run Deno's official installation script on Linux or macOS:
curl -fsSL https://deno.land/x/install/install.sh | sh
This one will do the same on Windows, if PowerShell is available:
irm https://deno.land/install.ps1 | iex
For more installation options or if you run into any problems, see the official instructions on deno.land and on denoland GitHub.
If you have Deno installed and Deno's installation root's bin directory (something like /home/USER/.deno/bin) added to PATH then you can use the following command to install jevko directly from GitHub master branch:
deno install --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/master/jevko.js
Note: if you haven't added Deno's installation root to PATH, then jevko won't be recognized as a command.
To install a specific version of the Jevko CLI, specify it in the URL in place of master:
deno install --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/v0.1.0/jevko.js
See the Jevko CLI GitHub Releases for a list of available versions.
If you can't or prefer not to change your PATH, you can alternatively install jevko to a directory that is already in the PATH, by adding the --root option to deno install. E.g. if your PATH contains ~/.local/bin, then you can run:
deno install --root ~/.local/ --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/master/jevko.js
to install jevko under ~/.local/bin.
You can get a list of directories in your PATH by running:
echo $PATH
This should print something like:
/home/USER/.local/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin
If Jevko CLI is installed you can invoke it as:
jevko
Without arguments, jevko will accept input from standard input until you press CTRL+D.
You can also provide a path to a file as an argument:
jevko filename.jevkoml
This will convert a file named filename.jevkoml into HTML/XML and output the result to standard output.
To output to a file instead of the standard output, you can either use the redirect facility of your shell:
jevko filename.jevkoml > outputfile.html
Or you can put an output option with the output file name at the top of the input file:
[
output [outputfile.html]
]
now if you run:
jevko filename.jevkoml
it will output to outputfile.html instead of standard output.
By default, Jevko CLI infers the Jevko format of the input file by extension. You can also specify the format by putting the format option at the top of the input file:
[
format [jevkoml]
]
/import [filename]
/paste [filename]
/paste [path [filename] tag [heredoc tag]]