Add stack.yaml

[xdg-ninja.git] / README.md

diff --git a/README.md b/README.md
index e0166d74ca9b7d536b85dbfa1a46b3b461e83dbc..54f19adee13d251064586c2c1703d2dda1005d31 100644 (file)
--- a/README.md
+++ b/README.md
@@ -5,9 +5,29 @@
 
 A shell script which checks your _$HOME_ for unwanted files and directories.
 
 
 A shell script which checks your _$HOME_ for unwanted files and directories.
 

+<p align="center">
+  <img src="https://s8.gifyu.com/images/Peek-2022-05-13-16-07.gif" width="500"/>
+</p>
+

 When it encounters a file it knows about, it will tell you whether it's possible to move this file to an appropriate location, and how to do it.
 
 When it encounters a file it knows about, it will tell you whether it's possible to move this file to an appropriate location, and how to do it.
 

-Currently, a subset of the [arch wiki page on XDG_BASE_DIR](https://wiki.archlinux.org/title/XDG_Base_Directory) is implemented as configurations.
+The configurations are from the [arch wiki page on XDG_BASE_DIR](https://wiki.archlinux.org/title/XDG_Base_Directory), [antidot](https://github.com/doron-cohen/antidot) (thanks to Scr0nch for writing a conversion tool), and contributed by other users.
+
+## Running
+
+Clone the repository somewhere, then run the _./xdg-ninja.sh_ script.
+
+This will run every test in the default configuration.
+
+## Dependencies
+
+- your favorite POSIX-compliant shell ([bash](https://repology.org/project/bash/packages), [zsh](https://repology.org/project/zsh/packages), [dash](https://repology.org/project/dash-shell/packages), ...)
+- [jq](https://repology.org/project/jq/packages) for parsing the json files
+
+### Optional
+
+- [glow](https://repology.org/project/glow/packages) for rendering markdown in the terminal ([bat](https://repology.org/project/bat-cat/packages), [pygmentize](https://repology.org/project/pygments/versions) or [highlight](https://repology.org/project/highlight/packages) can be used as fallback, but glow's output is clearer and therefore glow is recommended)
+- [cabal](https://repology.org/project/cabal/packages) for compiling the helper program for creating configurations

 
 ## Configuration
 
 
 ## Configuration
 


@@ -23,17 +43,13 @@ Files in this directory can have any name, but using the name of the program is
 
 ### Automatically Generating Configuration
 
 
 ### Automatically Generating Configuration
 

-You need _haskell_ and _cabal_ installed.
+You need _haskell_ and _cabal_ installed. (To be clear, this is just for a tool that will help you automatically generate the config files, you still only need your shell to run the tests)

 
 Run the following command:
 
 Run the following command:

-```bash
-cabal build
+```sh
+cabal run xdgnj add

 ```
 
 ```
 

-You should now have a binary which you can run. You'll find it in somewhere in _dist-newstyle/build_, for example in _dist-newstyle/build/x86_64-linux/ghc-9.0.2/add-program-0.1.0.0/x/add-program/build/add-program/add-program_.
-
-Execute this binary in this directory. It will guide you through the process.
-

 ### Manually
 
 We're going to use _git_ as an example.
 ### Manually
 
 We're going to use _git_ as an example.


@@ -43,13 +59,13 @@ It puts the file _.gitconfig_ into _$HOME.
 Luckily, the XDG spec is supported by git, so we can simply move the file to _XDG_CONFIG_HOME/git/config_.
 
 We can use that last sentence as our instructions. In this case, there are no newlines, so escaping this string for use in json is trivial, however, this is how you should generally approach it:
 Luckily, the XDG spec is supported by git, so we can simply move the file to _XDG_CONFIG_HOME/git/config_.
 
 We can use that last sentence as our instructions. In this case, there are no newlines, so escaping this string for use in json is trivial, however, this is how you should generally approach it:

-```bash
+```sh

 echo "Luckily, the XDG spec is supported by git, so we can simply move the file to _XDG_CONFIG_HOME/git/config_." | jq -aRs .
 ```
 
 Let's see what the output of this command looks like for something a little more sophisticated.
 Here's an example file:
 echo "Luckily, the XDG spec is supported by git, so we can simply move the file to _XDG_CONFIG_HOME/git/config_." | jq -aRs .
 ```
 
 Let's see what the output of this command looks like for something a little more sophisticated.
 Here's an example file:

-```bash
+```sh

 cat example.md
 ```
 ```
 cat example.md
 ```
 ```


@@ -58,7 +74,7 @@ Currently not fixable.
 _(But you can probably just delete the dir)_
 ```
 Here's what catting this file to the _jq_ command produces:
 _(But you can probably just delete the dir)_
 ```
 Here's what catting this file to the _jq_ command produces:

-```bash
+```sh

 cat example.md | jq -aRs .
 ```
 ```
 cat example.md | jq -aRs .
 ```
 ```