-
Notifications
You must be signed in to change notification settings - Fork 52
Expand file tree
/
Copy pathREADME.md.tmpl
More file actions
79 lines (61 loc) · 2.88 KB
/
Copy pathREADME.md.tmpl
File metadata and controls
79 lines (61 loc) · 2.88 KB
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# ASCII input mode
<!-- https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections#creating-a-collapsed-section -->
GoAT implements a subset, and some extensions, of the ASCII diagram generation function of the browser-side Javascript in [Markdeep](http://casual-effects.com/markdeep/).
If ASCII-mode is selected on the command line (the default),
all characters that affect drawing lie within the ASCII set.
Certain Unicode graphical characters e.g. MIDDLE DOT may however be useful, and
in at least some on-screen fonts, conform to the constant pixel-dimension standard of the ASCII range.
CJK characters on the other hand are typically wider than 2:1.
Non-standard width characters are not in general composable on the left-right axis within a plain-text
drawing, because the remainder of the line of text to their right is pushed out of alignment
with rows above and below.
## Example Graphics
Here are some snippets of
GoAT-formatted text
and the SVG each can generate.
The SVG you see below was linked to by
inline Markdown image references
([howto](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images),
[spec](https://github.github.com/gfm/#images)) from
GoAT's [README.md](README.md), then finally rendered to HTML ```<img>``` elements by Github's Markdown processor
### Trees -- mid-range color value
Setting a foreground color in the middle of the possible range of value or luminance
is one way to work around a limitation of certain browsers e.g. Safari.
Safari does not support inheritance of
the [`color-scheme`](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
CSS property by
`goat`'s output `<svg>` element
from within an enclosing `<img>` element such as are generated by Markdown.
### Overlaps
<!-- XX If GFM could merely "#include" other input files upon HTML generation,
following the usual mode of included images, could templating perhaps be dropped?
E.g.
[CANNOT #include ]({{.examples_DIR}}/overlaps.txt)
-->
```
{{.examples_overlaps_txt}}
```
---
### Line Decorations
```
{{.examples_line_decorations_txt}}
```
---
### Dot Grids
```
{{.examples_dot_grids_txt}}
```
Note that '·' above is not ASCII, but rather Unicode, the MIDDLE DOT character, encoded with UTF-8.
### "Complicated"
```
{{.examples_complicated_txt}}
```
---
### "Complicated" redux, styled in motley
### More [examples](./examples)