|
1 |
| -= README = |
2 |
| -:guides: http://tldp.org/guides.html |
3 |
| -:license: https://github.com/pmarinov/bash-scripting-guide/blob/master/LICENSE.txt |
4 |
| -:pollen: https://docs.racket-lang.org/pollen/index.html |
| 1 | +# README |
| 2 | +:license: |
| 3 | +:pollen: |
5 | 4 |
|
6 | 5 | *Advanced Bash-Scripting Guide*
|
7 | 6 | (New Edition based on Pollen)
|
8 | 7 |
|
9 |
| -Advanced Bash-Scripting Guide in HTML: + |
| 8 | +Advanced Bash-Scripting Guide in HTML: |
10 | 9 | https://hangar118.sdf.org/p/bash-scripting-guide/
|
11 | 10 |
|
12 |
| -Home page: + |
13 |
| -https://hangar118.sdf.org/p/bash-scripting-guide-home/ |
| 11 | +Home page: https://hangar118.sdf.org/p/bash-scripting-guide-home/ |
14 | 12 |
|
15 |
| -== About == |
| 13 | +# About |
16 | 14 |
|
17 |
| -The _Advanced Bash-Scripting Guide_ is a book written by Mendel Cooper |
18 |
| -and part of The Linux Documentation Project, page |
19 |
| -{guides}[Guides]. *This is a fork* of the original work which itself |
20 |
| -had been (since 2014) dedicated to the *Public Domain*. |
| 15 | +The *Advanced Bash-Scripting Guide* is a book written by Mendel Cooper |
| 16 | +and part of The Linux Documentation Project (see |
| 17 | +[Guides](http://tldp.org/guides.html)). **This is a fork** of the |
| 18 | +original work which itself had been (since 2014) dedicated to the |
| 19 | +**Public Domain**. |
21 | 20 |
|
22 | 21 | Motivation for the new edition:
|
23 | 22 |
|
24 | 23 | * To produce a modern-looking HTML format
|
25 | 24 | * To produce a GNU Info format, readable inside Emacs
|
26 |
| -* To use Pollen as a publishing system, see {pollen}["Pollen: the book |
27 |
| - is a program"] |
| 25 | +* To use Pollen as a publishing system, see ["Pollen: the book |
| 26 | + is a program"](https://docs.racket-lang.org/pollen/index.html) |
28 | 27 | * To invite contributions by hosting on GitHub
|
29 | 28 |
|
30 | 29 | == How to build ==
|
31 | 30 |
|
32 | 31 | Use `apt` to install `racket`:
|
33 | 32 |
|
34 |
| -.... |
| 33 | +``` |
35 | 34 | $ apt install racket
|
36 | 35 |
|
37 | 36 | $ racket --version
|
38 |
| -.... |
| 37 | +``` |
39 | 38 |
|
40 | 39 | Racket v7.0 is minimum
|
41 | 40 |
|
42 | 41 | Use `raco pkg` to install Pollen:
|
43 | 42 |
|
44 |
| -.... |
| 43 | +``` |
45 | 44 | $ raco pkg install pollen
|
46 |
| -.... |
| 45 | +``` |
47 | 46 |
|
48 | 47 | Installs in `~/.racket/7.2/pkgs`
|
49 | 48 |
|
50 | 49 | To read the documentation:
|
51 | 50 |
|
52 |
| -.... |
| 51 | +``` |
53 | 52 | $ raco docs pollen
|
54 |
| -.... |
| 53 | +``` |
55 | 54 |
|
56 | 55 | Also the book "Pollen: the book is a program" is at:
|
57 | 56 | `~/.racket/7.2/pkgs/pollen/pollen/doc/pollen/index.html`
|
58 | 57 |
|
59 | 58 | One more package:
|
60 | 59 |
|
61 |
| -.... |
| 60 | +``` |
62 | 61 | $ raco pkg install debug
|
63 |
| -.... |
| 62 | +``` |
64 | 63 |
|
65 | 64 | Install `makeinfo`
|
66 | 65 |
|
67 |
| -.... |
| 66 | +``` |
68 | 67 | $ apt install texinfo
|
69 |
| -.... |
| 68 | +``` |
70 | 69 |
|
71 | 70 | Now build the project via `make`:
|
72 | 71 |
|
73 |
| -.... |
| 72 | +``` |
74 | 73 | $ make all
|
75 |
| -.... |
| 74 | +``` |
76 | 75 |
|
77 | 76 | TODO: Describe output folders
|
78 | 77 |
|
79 | 78 | == License ==
|
80 | 79 |
|
81 |
| -Public Domain, see {license}[LICENSE.txt] |
| 80 | +Public Domain, see |
| 81 | +[LICENSE.txt](https://github.com/pmarinov/bash-scripting-guide/blob/master/LICENSE.txt) |
82 | 82 |
|
83 | 83 | == Changelog ==
|
84 | 84 |
|
|
0 commit comments