Notoriously Pedantic Magistrate
    Wondering what’s next for npm?Check out our public roadmap! »

    r2-testapp-js
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.7 • Public • Published

    NodeJS / TypeScript Readium-2 "test app"

    Electron / NodeJS implementation (written in TypeScript) of a test app for the Readium2 architecture ( https://github.com/readium/architecture/ ).

    License

    Build status

    NPM David Travis

    Changelog

    Downloadable executables

    Please note that this application is a test bed for Readium2 components, this is not aimed at end-users. This is not a full reading system, just a basic reader interface. Notably, this application lacks a local bookshelf, and a feed explorer for remote publications (OPDS).

    The pre-releases application installers/executables labelled "continuous test build" are generated automatically by TravisCI ( https://travis-ci.org/readium/r2-testapp-js ).

    https://github.com/readium/r2-testapp-js/releases

    Prerequisites

    1. https://nodejs.org NodeJS >= 8, NPM >= 5 (check with command line node --version and npm --version)
    2. OPTIONAL: https://yarnpkg.com Yarn >= 1.0 (check with command line yarn --version)

    GitHub repository

    https://github.com/readium/r2-testapp-js

    There is no github.io site for this project (no gh-pages branch).

    NPM package

    https://www.npmjs.com/package/r2-testapp-js

    Command line install:

    npm install r2-testapp-js OR yarn add r2-testapp-js

    ...or manually add in your package.json:

      "dependencies"{
        "r2-testapp-js": "latest"
      }

    The JavaScript code distributed in the NPM package is usable as-is (no transpilation required), as it is automatically-generated from the TypeScript source.

    Several ECMAScript flavours are provided out-of-the-box: ES5, ES6-2015, ES7-2016, ES8-2017:

    https://unpkg.com/r2-testapp-js/dist/

    (alternatively, GitHub mirror with semantic-versioning release tags: https://github.com/edrlab/r2-testapp-js-dist/tree/develop/dist/ )

    The JavaScript code is not bundled, and it uses require() statement for imports (NodeJS style).

    More information about NodeJS compatibility:

    http://node.green

    Note that web-browser Javascript is currently not supported (only NodeJS runtimes).

    The type definitions (aka "typings") are included as *.d.ts files in ./node_modules/r2-testapp-js/dist/**, so this package can be used directly in a TypeScript project.

    Dependencies

    https://david-dm.org/readium/r2-testapp-js

    A package-lock.json is provided (modern NPM replacement for npm-shrinkwrap.json).

    A yarn.lock file is currently not provided at the root of the source tree.

    Continuous Integration

    https://travis-ci.org/readium/r2-testapp-js

    TravisCI builds are triggered automatically at every Git "push" in the develop branch.

    Version(s), Git revision(s)

    NPM package (latest published):

    https://unpkg.com/r2-testapp-js/dist/gitrev.json

    Alternatively, GitHub mirror with semantic-versioning release tags:

    https://raw.githack.com/edrlab/r2-testapp-js-dist/develop/dist/gitrev.json

    Developer quick start

    Command line steps (NPM, but similar with YARN):

    1. cd r2-testapp-js
    2. git status (please ensure there are no local changes, especially in package-lock.json and the dependency versions in package.json)
    3. rm -rf node_modules (to start from a clean slate)
    4. npm install, or alternatively npm ci (both commands initialize the node_modules tree of package dependencies, based on the strict package-lock.json definition)
    5. npm run build:all (invoke the main build script: clean, lint, compile)
    6. ls dist (that's the build output which gets published as NPM package)
    7. npm run electron (use the menu to open bundled EPUBs, or to choose arbitrary publications from the filesystem)
    8. npm run electron PATH_TO_PACKED_OR_EXPLODED_EPUB_FILE_OR_URI (gets added to the graphical menu, for re-use later)

    Documentation

    See:

    https://github.com/readium/r2-navigator-js/blob/develop/README.md#documentation

    https://github.com/readium/r2-streamer-js/blob/develop/README.md#documentation

    https://github.com/readium/r2-opds-js/blob/develop/README.md#documentation

    https://github.com/readium/r2-shared-js/blob/develop/README.md#documentation

    https://github.com/readium/r2-lcp-js/blob/develop/README.md#documentation

    https://github.com/readium/r2-utils-js/blob/develop/README.md#documentation

    Install

    npm i r2-testapp-js

    DownloadsWeekly Downloads

    109

    Version

    1.0.7

    License

    BSD-3-Clause

    Unpacked Size

    8.57 MB

    Total Files

    388

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar