update readme: installation with deno, new way of doing directives

Author: djedr

README.md

@@ -20,104 +20,128 @@ It can be used to easily integrate Jevko formats into applications that deal wit
 
 <!-- In the future, JevkoML could also be used directly by various tools, for increased efficiency. -->
 
-## Usage
+## Installation
 
-If Jevko CLI is [installed](#installation-with-deno) you can invoke it as:
+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.
+
+### Install Deno
+
+Jevko CLI has one dependency: [Deno](https://deno.land/).
+
+Fortunately Deno is very nice and [easy to install](https://deno.land/[email protected]/getting_started/installation). 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:
 
 ```
-jevko
+curl -fsSL https://deno.land/x/install/install.sh | sh
 ```
 
-Without arguments, `jevko` will accept input from standard input until you press CTRL+D.
+This one will do the same on Windows, if PowerShell is available:
 
-<!-- todo?: mvp console highlighting? -->
+```
+irm https://deno.land/install.ps1 | iex
+```
 
-You can also provide a path to a file as an argument:
+For more installation options or if you run into any problems, see the official instructions on [deno.land](https://deno.land/[email protected]/getting_started/installation) and on [denoland GitHub](https://github.com/denoland/deno_install).
 
-<!-- get syntax highlighting for vscode -->
+### Install Jevko CLI with Deno
+
+If you have [Deno installed](#install-deno) and Deno's installation root's bin directory (something like `/home/USER/.deno/bin`) [added to `PATH`](#tip-get-a-list-of-directories-in-your-path) then you can use the following command to install `jevko` directly from GitHub master branch:
 
 ```
-jevko filename.jevkoml
+deno install --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/master/jevko.js
 ```
 
-This will convert a file named `filename.jevkoml` into HTML/XML and output the result to standard output.
+Note: if you haven't added Deno's installation root to `PATH`, then `jevko` won't be recognized as a command.
 
-To output to a file instead of the standard output, you can either use the redirect facility of your shell:
+To install a specific version of the Jevko CLI, specify it in the URL in place of master:
 
 ```
-jevko filename.jevkoml > outputfile.html
+deno install --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/v0.1.0/jevko.js
 ```
 
-Or you can put an `/output` directive with the output file name at the top of the input file:
+See the [Jevko CLI GitHub Releases](https://github.com/jevko/jevko-cli/releases) for a list of available versions.
+
+### Alternative: install without editing PATH
+
+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`](#tip-get-a-list-of-directories-in-your-path), by adding the `--root` option to `deno install`. E.g. if your `PATH` contains `~/.local/bin`, then you can run:
 
 ```
-/output [outputfile.html]
+deno install --root ~/.local/ --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/master/jevko.js
 ```
 
-now if you run:
+to install `jevko` under `~/.local/bin`.
+
+### Tip: get a list of directories in your PATH
+
+You can get a list of directories in your `PATH` by running:
 
 ```
-jevko filename.jevkoml
+echo $PATH
 ```
 
-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 `/jevko` directive at the top of the input file:
+This should print something like:
 
 ```
-/jevko [jevkoml]
+/home/USER/.local/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin
 ```
 
-## Dependencies
+## Usage
 
-Jevko CLI has one dependency: [Deno](https://deno.land/).
+If Jevko CLI is [installed](#installation-with-deno) you can invoke it as:
 
-Fortunately Deno is very nice and [easy to install](https://deno.land/[email protected]/getting_started/installation).
+```
+jevko
+```
 
-<!-- I recommend installing it, as it makes installing and managing `jevko` easy and efficient. -->
+Without arguments, `jevko` will accept input from standard input until you press CTRL+D.
 
-## Installation with Deno
+<!-- todo?: mvp console highlighting? -->
 
-These instructions will guide you through using Deno to install `jevko` as a command in your system, so that you can invoke it from anywhere.
+You can also provide a path to a file as an argument:
 
-If you have [Deno installed](#dependencies) and Deno's installation root's bin directory (something like `/home/USER/.deno/bin`) [added to `PATH`](#tip-get-a-list-of-directories-in-your-path) then you can use the following command to install `jevko` directly from GitHub master branch:
+<!-- get syntax highlighting for vscode -->
 
 ```
-deno install --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/master/jevko.js
+jevko filename.jevkoml
 ```
 
-Note: if you haven't added Deno's installation root to `PATH`, then `jevko` won't be recognized as a command.
+This will convert a file named `filename.jevkoml` into HTML/XML and output the result to standard output.
 
-To install a specific version of jevko-cli, specify it in the URL in place of master:
+To output to a file instead of the standard output, you can either use the redirect facility of your shell:
 
 ```
-deno install --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/v0.1.0/jevko.js
+jevko filename.jevkoml > outputfile.html
 ```
 
-### Alternative: install without editing PATH
+Or you can put an `output` directive with the output file name at the top of the input file:
 
-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`](#tip-get-a-list-of-directories-in-your-path), by adding the `--root` option to `deno install`. E.g. if your `PATH` contains `~/.local/bin`, then you can run:
+<!-- todo: describe the new way of doing directives -- probly change name of directives to sth else -->
 
 ```
-deno install --root ~/.local/ --allow-read --allow-write --allow-run https://raw.githubusercontent.com/jevko/jevko-cli/master/jevko.js
+[
+  output [outputfile.html]
+]
 ```
 
-to install `jevko` under `~/.local/bin`.
-
-## Tip: get a list of directories in your PATH
-
-You can get a list of directories in your `PATH` by running:
+now if you run:
 
 ```
-echo $PATH
+jevko filename.jevkoml
 ```
 
-This should print something like:
+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` directive at the top of the input file:
 
 ```
-/home/USER/.local/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin
+[
+  format [jevkoml]
+]
 ```
 
-# Features coming soon
 
+## Features coming soon
+
+<!-- todo: this should be a separate lib (perhaps local to this repo) -->
 * import files as jevkos or text (currently implemented in jevkoml)