Skip to content

Commit 48b5332

Browse files
🤖 docs: Upgrade.
1 parent a8f8ce2 commit 48b5332

File tree

8 files changed

+176
-2
lines changed

8 files changed

+176
-2
lines changed

.esdoc.json

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
{
2+
"source": "./src",
3+
"destination": "./gh-pages",
4+
"debug": false,
5+
"index": "./README.md",
6+
"package": "./package.json",
7+
"plugins": [
8+
{
9+
"name": "esdoc-standard-plugin",
10+
"option": {
11+
"accessor": {
12+
"access": ["public", "protected", "private"],
13+
"autoPrivate": true
14+
},
15+
"brand": {
16+
"title": "@aureooms/js-operator"
17+
},
18+
"test": {
19+
"type": "ava",
20+
"source": "./test/src"
21+
},
22+
"manual": {
23+
"files":[
24+
"./doc/manual/overview.md",
25+
"./doc/manual/installation.md",
26+
"./doc/manual/usage.md",
27+
"./doc/manual/example.md"
28+
]
29+
}
30+
}
31+
},
32+
{
33+
"name": "esdoc-inject-style-plugin",
34+
"option": {
35+
"enable": true,
36+
"styles": ["./doc/css/style.css"]
37+
}
38+
},
39+
{
40+
"name": "esdoc-inject-script-plugin",
41+
"option": {
42+
"enable": true,
43+
"scripts": ["./doc/scripts/header.js"]
44+
}
45+
}
46+
]
47+
}

doc/css/style.css

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
h1,
2+
h2,
3+
.navigation,
4+
.layout-container > header,
5+
footer
6+
{
7+
border: none;
8+
}
9+
10+
.project-name {
11+
color: #FC913A;
12+
font-weight: bold;
13+
}
14+
15+
.layout-container > header > a.repo-url-github {
16+
font-size: inherit;
17+
display: inline;
18+
background: none;
19+
vertical-align: inherit;
20+
}
21+
22+
.search-box img {
23+
display: none;
24+
}
25+
26+
.search-box::before{
27+
content: "search";
28+
}
29+
30+
.search-input-edge {
31+
height: 0px;
32+
}
33+
34+
.search-result {
35+
width: 300px;
36+
margin-left: 42px;
37+
box-shadow: 1px 1px 13px rgba(0,0,0,0.2);
38+
}
39+
40+
.search-input {
41+
visibility: visible;
42+
}
43+
44+
.search-result li.search-separator {
45+
text-transform: capitalize;
46+
background-color: #ccc;
47+
}
48+
49+
span[data-ice="signature"] > span {
50+
/*font-weight: bold;*/
51+
font-style: italic;
52+
}

doc/manual/example.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Examples
2+
3+
> More examples in [the test files](https://github.com/make-github-pseudonymous-again/js-operator/tree/main/test/src).

doc/manual/installation.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Installation
2+
3+
Can be managed using
4+
[yarn](https://yarnpkg.com/en/docs),
5+
[npm](https://docs.npmjs.com),
6+
or [jspm](https://jspm.org/docs).
7+
8+
9+
### yarn
10+
```terminal
11+
yarn add @aureooms/js-operator
12+
```
13+
14+
### npm
15+
```terminal
16+
npm install @aureooms/js-operator --save
17+
```
18+
19+
### jspm
20+
```terminal
21+
jspm install npm:@aureooms/js-operator
22+
```

doc/manual/overview.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# Overview

doc/manual/usage.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Usage
2+
3+
> :warning: Depending on your environment, the code may require
4+
> `regeneratorRuntime` to be defined, for instance by importing
5+
> [regenerator-runtime/runtime](https://www.npmjs.com/package/regenerator-runtime).
6+
7+
First, require the polyfill at the entry point of your application
8+
```js
9+
require( 'regenerator-runtime/runtime' ) ;
10+
// or
11+
import 'regenerator-runtime/runtime.js' ;
12+
```
13+
14+
Then, import the library where needed
15+
```js
16+
const operator = require( '@aureooms/js-operator' ) ;
17+
// or
18+
import * as operator from '@aureooms/js-operator' ;
19+
```

doc/scripts/header.js

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
const domReady = function (callback) {
2+
const state = document.readyState;
3+
if (state === 'interactive' || state === 'complete') {
4+
callback();
5+
} else {
6+
document.addEventListener('DOMContentLoaded', callback);
7+
}
8+
};
9+
10+
domReady(() => {
11+
const projectname = document.createElement('a');
12+
projectname.classList.add('project-name');
13+
projectname.text = 'make-github-pseudonymous-again/js-operator';
14+
projectname.href = './index.html';
15+
16+
const header = document.querySelector('header');
17+
header.insertBefore(projectname, header.firstChild);
18+
19+
const testlink = document.querySelector('header > a[data-ice="testLink"]');
20+
testlink.href = 'https://app.codecov.io/gh/make-github-pseudonymous-again/js-operator';
21+
testlink.target = '_BLANK';
22+
23+
const searchBox = document.querySelector('.search-box');
24+
const input = document.querySelector('.search-input');
25+
26+
// Active search box when focus on searchBox.
27+
input.addEventListener('focus', () => {
28+
searchBox.classList.add('active');
29+
});
30+
});

package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,9 +28,9 @@
2828
"version": "1.0.2",
2929
"author": "aureooms",
3030
"scripts": {
31-
"doc": "./node_modules/.bin/groc",
3231
"build": "./node_modules/.bin/aureooms-node-package-build",
33-
"test": "./node_modules/.bin/aureooms-node-package-test"
32+
"test": "./node_modules/.bin/aureooms-node-package-test",
33+
"esdoc": null
3434
},
3535
"license": "AGPL-3.0",
3636
"name": "@aureooms/js-operator",

0 commit comments

Comments
 (0)