0.2.20 • Published 9 months ago

epitelete v0.2.20

Weekly downloads
-
License
MIT
Repository
github
Last release
9 months ago

Epitelete

Installation

Epitelete is available as an npm package.

npm install epitelete

Usage

Proskomma mode

Uses a proskomma instance to handle PERF documents.

Example

import Epitelete from "epitelete"
import Proskomma from "proskomma";

const proskomma = new Proskomma();
proskomma.loadSuccinctDocSet(succintJson);

const docSetId = "doc_set_id";
const epitelete = new Epitelete({ proskomma, docSetId });

const bookCode = "GEN";
let docPerf = epitelete.readPerf(bookCode);

const sequenceId = docPerf.mainSequence;
const sequence = docPerf.sequences[sequenceId];

//...make changes in sequence

docPerf = epitelete.writePerf(bookCode,sequenceId,sequence);
docPerf = epitelete.undoPerf(bookCode);
docPerf = epitelete.redoPerf(bookCode);

Edit Button

How to

1. Install proskomma:

npm install proskomma

2. Instantiate and set Proskomma:

import Proskomma from "proskomma";

const proskomma = new Proskomma();

proskomma.loadSuccinctDocSet(succintJson);

...

succintJson : ...

3. Instantiate Epitelete:

import Epitelete from "epitelete"

...

const docSetId = "doc_set_id";

const epitelete = new Epitelete({ proskomma, docSetId });

...

4. Get a document:

...

const bookCode = "GEN";

let docPerf = epitelete.readPerf(bookCode);

...

.readPerf(): gets a document from cache or by fetching from the proskomma instance.

docPerf: copy of the document that has been saved in cache. example docPerf content

5. Make changes to some docPerf sequence:

...

const sequenceId = docPerf.mainSequence;

const sequence = docPerf.sequences[sequenceId];

//...make changes in sequence

...

6. Persist changes to epitelete s history:

...

docPerf = epitelete.writePerf(bookCode,sequenceId,sequence);

...

.writePerf(): creates a copy of last saved document, updates it with the changed sequence and saves it in memory.

7. Undo/Redo your changes to docPerf:

...

docPerf = epitelete.undoPerf(bookCode);

docPerf = epitelete.redoPerf(bookCode);

...

.undoPerf(): retrieves the previous changed document from history.

.redoPerf(): retrieves the next changed document from history.

History size can be set at instantiation with the options argument:

const options = { historySize: 5 }

const epitelete = new Epitelete({ proskomma, docSetId, options });

Standalone mode

Uses only given PERF documents.

Example

import Epitelete from "epitelete"

const docSetId = "doc_set_id";
const options = { historySize: 5 };
const epitelete = new Epitelete({ docSetId, options });

const bookCode = "GEN";
const perfJSON = {...}
let docPerf = await epitelete.sideloadPerf(bookCode,perfJSON);

const sequenceId = docPerf.mainSequence;
const sequence = docPerf.sequences[sequenceId];

//...make changes in sequence

docPerf = epitelete.writePerf(bookCode,sequenceId,sequence);
docPerf = epitelete.undoPerf(bookCode);
docPerf = epitelete.redoPerf(bookCode);

Edit Button

How to

1. Instatiate Epilete:

import Epitelete from "epitelete"

...

const docSetId = "doc_set_id";

const epitelete = new Epitelete({ docSetId [,options] });

...

Optionally could set historySize in the options arg.

2. Load a document into memory:

...

docPerf = await epitelete.sideloadPerf(bookCode, perfJSON);

...

perfJSON: externally loaded and parsed documentPerf.

3. Use writePerf,readPerf,undoPerf,redoPerf as shown before.

API

Complete Epitelete API

License

This project is licensed under the MIT.

0.2.20

9 months ago

0.2.20-beta.5

10 months ago

0.2.20-beta.3

10 months ago

0.2.20-beta.4

10 months ago

0.2.20-beta.2

10 months ago

0.2.20-beta.1

11 months ago

0.2.19

12 months ago

0.2.16-rc.1

1 year ago

0.2.18

1 year ago

0.2.16

1 year ago

0.2.15-dev.1

1 year ago

0.2.15

1 year ago

0.2.14

1 year ago

0.2.13

1 year ago

0.2.12

1 year ago

0.2.11

1 year ago

0.2.10

1 year ago

0.2.7

1 year ago

0.2.9

1 year ago

0.2.8

1 year ago

0.2.6

2 years ago

0.2.5

2 years ago

0.2.4

2 years ago

0.2.3

2 years ago

0.2.2

2 years ago

0.2.1

2 years ago

0.2.0

2 years ago

0.1.4

2 years ago

0.1.3

2 years ago

0.1.2

2 years ago

0.1.1

2 years ago

0.1.0

2 years ago

0.0.8

2 years ago

0.0.7

2 years ago

0.0.6

2 years ago

0.0.5

2 years ago

0.0.4

2 years ago

0.0.3

2 years ago

0.0.2

2 years ago

0.0.1

2 years ago