UNPKG

3.37 kBMarkdownView Raw
1# @sutton-signwriting/unicode8
2
3[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/sutton-signwriting/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
4[![version](https://img.shields.io/npm/v/@sutton-signwriting/unicode8)](https://www.npmjs.com/package/@sutton-signwriting/unicode8)
5[![npm downloads](https://img.shields.io/npm/dm/@sutton-signwriting/unicode8)](https://npm-stat.com/charts.html?package=@sutton-signwriting/unicode8&from=2020-12-06)
6
7<img alt="SignWriting in Unicode 8 (uni8) Mindmap" src="./Unicode8.jpg" width="100%">
8
9@sutton-signwriting/unicode8 is a javascript package for processing SignWriting in Unicode 8 (uni8) characters. See [SignWriting#Unicode](https://en.wikipedia.org/wiki/SignWriting#Unicode) for more information.
10
11This package also supports Formal SignWriting in ASCII (FSW) and SignWriting in Unicode (SWU) character sets. See [draft-slevinski-formal-signwriting](https://tools.ietf.org/id/draft-slevinski-formal-signwriting-07.html) for detailed specification.
12
13> Author: https://SteveSlevinski.me
14> Channel: https://www.youtube.com/channel/UCXu4AXlG0rXFtk_5SzumDow
15> Support: https://www.patreon.com/signwriting
16
17## Useful links
18
19- Source: https://github.com/sutton-signwriting/unicode8
20- Distribution: https://unpkg.com/browse/@sutton-signwriting/unicode8/
21- Documentation: https://sutton-signwriting.github.io/unicode8/
22- Issue Tracker: https://github.com/sutton-signwriting/unicode8/issues
23- Online Discussion: https://gitter.im/sutton-signwriting/community
24
25## Types of files
26The source is written in small ES Modules available in the `src` directory along with the associated tests.
27
28The distribution is available in three flavors. Minified, the whole library is 2 KB in size.
29* .js - Universal Module Definition
30* .cjs - CommonJS
31* .mjs - ES Module
32
33## Installation
34
35### Download and Install with NPM
36
37 npm install @sutton-signwriting/unicode8
38
39## Developer Installation
40
41### Download from GitHub and Install Development Dependencies
42
43 wget https://github.com/sutton-signwriting/unicode8/archive/master.zip
44 unzip master.zip
45 cd unicode8-master
46 npm install
47
48## Usage
49
50### Using in Node
51
52 // import entire library
53 const unicode8 = require('@sutton-signwriting/unicode8');
54
55 // import individual module
56 const unicode8Symbol = require('@sutton-signwriting/unicode8/symbol');
57
58### Using in the Browser
59
60#### Local files
61 // import entire library
62 // available as ssw.unicode8
63 <script src="unicode8.js"></script>
64
65 // import individual module
66 // available as ssw.unicode8.symbol
67 <script src="symbol/symbol.js"></script>
68
69#### Unpkg
70 // import entire library
71 // available as ssw.unicode8
72 <script src="https://unpkg.com/@sutton-signwriting/unicode8@1.1.0"></script>
73
74 // import individual module
75 // available as ssw.unicode8.font
76 <script src="https://unpkg.com/@sutton-signwriting/unicode8@1.1.0/font/font.js"></script>
77
78## License
79MIT
80
81## SignWriting General Interest
82- SignWriting Website: https://signwriting.org/
83- Wikipedia page: https://en.wikipedia.org/wiki/SignWriting
84- Email Discussion: https://www.signwriting.org/forums/swlist/
85- Facebook Group: https://www.facebook.com/groups/SuttonSignWriting/