aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 27c9795ab8023b437dffae380790de6e92bc3762 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
ariketa: bash example code quickloader for presentations
========================================================

Instructions
------------

- Create an array of examples for ariteka by editing 'config/examples.sh'.

- Source ariketa.sh to your Bash session:
```
source ariketa.sh
```

- View *USAGE* file for usage information.


usage
-----
    To load ariketa, source it into the bash session you wish to use for the
    presentation:
        # load examples from ariketa/config/examples.sh
        source ariketa.sh

        # load example file specified as argument
        source ariketa.sh filename.sh

    When an example is displayed, it may be edited like any command line and
    executed normally by pressing enter.  Use the following key bindings to
    navigate through your examples:

        alt-H:     display this USAGE text

        alt-w:     load previous example
        alt-e:     load next example
        alt-a:     reload current example
        alt-h:     display current example with syntax highlighting

        alt-W:     load previous example without clearing the screen
        alt-E:     load next example without clearing the screen
        alt-A:     reload current example without clearing the screen

        alt-s:     side by side diff of previous and current example
        alt-S:     side by side diff of prev/cur examples with highlighting
        alt-P:     toggle between ariketa PS2 header and original setting

configuration
-------------
    To load examples into ariketa, edit the 'examples.sh' file in the
    'config' directory.  This file should be a sourceable bash script which
    creates an indexed array named '_examples', whose elements have values
    beginning with a tag, delineated from the example itself by a ':' character
    followed by a newline.  An sample config is located in
    'config/examples.sh.sample'.