highmark-yapp 0.0.330 → 0.0.333
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -13
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Highmark with Yapp listings.
|
|
4
4
|
|
|
5
|
-
This package augments the HTML created with Highmark with [Yapp
|
|
5
|
+
This package augments the HTML created with Highmark with [Yapp](https://github.com/djalbat/yapp) listings.
|
|
6
6
|
The result is much more pleasing to the eye.
|
|
7
7
|
See the Juxtapose site, for example, which makes use of this package:
|
|
8
8
|
|
|
@@ -16,20 +16,23 @@ Using Highmark for creating HTML for websites usually works extremely well and e
|
|
|
16
16
|
- [Installation](#installation)
|
|
17
17
|
- [Example](#example)
|
|
18
18
|
- [Usage](#usage)
|
|
19
|
+
- [Building](#buidling)
|
|
19
20
|
- [Contact](#contact)
|
|
20
21
|
|
|
21
22
|
## Introduction
|
|
22
23
|
|
|
23
24
|
Highmark is a document preparation system inspired by [Markdown](https://en.wikipedia.org/wiki/Markdown) and [TeX](https://en.wikipedia.org/wiki/TeX).
|
|
24
|
-
There are several packages in the distribution
|
|
25
|
-
All of the other packages are likely only of interest to prospective developers.
|
|
25
|
+
There are several packages in the distribution.
|
|
26
26
|
|
|
27
27
|
- [Highmark-CLI](https://github.com/djalbat/highmark-cli) Highmark's CLI tool.
|
|
28
28
|
- [Highmark Yapp](https://github.com/djalbat/highmark-yapp) Highmark with Yapp listings.
|
|
29
29
|
- [Highmark Fonts](https://github.com/djalbat/highmark-fonts) Computer Modern fonts for Highmark.
|
|
30
|
-
- [Highmark Client](https://github.com/djalbat/highmark-
|
|
30
|
+
- [Highmark Client](https://github.com/djalbat/highmark-client) Highmark's bundled client for viewing HTML.
|
|
31
31
|
- [Highmark Markdown](https://github.com/djalbat/highmark-markdown) Highmark's Markdown and Markdown Style languages.
|
|
32
32
|
|
|
33
|
+
Only the CLI tool is needed by end users.
|
|
34
|
+
All of the other packages are likely only of interest to prospective developers.
|
|
35
|
+
|
|
33
36
|
## Installation
|
|
34
37
|
|
|
35
38
|
If you would like to contribute or would simply like to have a look at the code, you can clone the repository with [Git](https://git-scm.com/)...
|
|
@@ -40,7 +43,6 @@ If you would like to contribute or would simply like to have a look at the code,
|
|
|
40
43
|
|
|
41
44
|
npm install
|
|
42
45
|
|
|
43
|
-
|
|
44
46
|
## Example
|
|
45
47
|
|
|
46
48
|
There is a small development server that can be run from within the project's directory with the following command:
|
|
@@ -68,6 +70,7 @@ import { renderYappStyles } from "highmark-yapp";
|
|
|
68
70
|
|
|
69
71
|
renderYappStyles();
|
|
70
72
|
|
|
73
|
+
...
|
|
71
74
|
```
|
|
72
75
|
|
|
73
76
|
Next, to create a node from some Markdown content, use the `nodeFromContent()` utility function:
|
|
@@ -79,7 +82,8 @@ const { nodeFromContent } = markdownUtilities;
|
|
|
79
82
|
|
|
80
83
|
const content = `
|
|
81
84
|
|
|
82
|
-
...
|
|
85
|
+
...
|
|
86
|
+
|
|
83
87
|
`,
|
|
84
88
|
node = nodeFromContent(node);
|
|
85
89
|
|
|
@@ -109,9 +113,8 @@ class Article extends Element {
|
|
|
109
113
|
}
|
|
110
114
|
```
|
|
111
115
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
One way to do this would be to extend this base `Article` class thus:
|
|
116
|
+
Here the `didMount()` method assumes that some content is defined by way of the static `content` property.
|
|
117
|
+
One way to do this would be to extend the `Article` class thus:
|
|
115
118
|
|
|
116
119
|
```
|
|
117
120
|
import Article from "../article";
|
|
@@ -124,13 +127,19 @@ export default class ArchitectureArticle extends Article {
|
|
|
124
127
|
...
|
|
125
128
|
|
|
126
129
|
`;
|
|
127
|
-
|
|
130
|
+
}
|
|
128
131
|
```
|
|
129
132
|
|
|
130
|
-
|
|
131
|
-
This generally makes things
|
|
133
|
+
Note that the usual delimiters for block listings consisting of three backticks have been replaced with three single quotes `'''`.
|
|
134
|
+
This generally makes things easier when working inside string template literals that use backticks for delimiters of course.
|
|
135
|
+
|
|
136
|
+
## Building
|
|
137
|
+
|
|
138
|
+
Automation is done with [npm scripts](https://docs.npmjs.com/misc/scripts), have a look at the `package.json` file. The pertinent commands are:
|
|
139
|
+
|
|
140
|
+
npm run build-debug
|
|
141
|
+
npm run watch-debug
|
|
132
142
|
|
|
133
143
|
## Contact
|
|
134
144
|
|
|
135
145
|
* james.smith@djalbat.com
|
|
136
|
-
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "highmark-yapp",
|
|
3
3
|
"author": "James Smith",
|
|
4
|
-
"version": "0.0.
|
|
4
|
+
"version": "0.0.333",
|
|
5
5
|
"license": "MIT, Anti-996",
|
|
6
6
|
"homepage": "https://github.com/djalbat/highmark-uapp",
|
|
7
7
|
"description": "Highmark with Yapp listings.",
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
},
|
|
12
12
|
"dependencies": {
|
|
13
13
|
"easy": "^17.1.3",
|
|
14
|
-
"highmark-markdown": "^0.0.
|
|
14
|
+
"highmark-markdown": "^0.0.250",
|
|
15
15
|
"yapp": "^5.1.55"
|
|
16
16
|
},
|
|
17
17
|
"devDependencies": {
|