Skip to content

Commit e71b461

Browse files
committed
initial commit
0 parents  commit e71b461

File tree

3 files changed

+89
-0
lines changed

3 files changed

+89
-0
lines changed

CONTRIBUTING.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Contributing to WebViewer UI
2+
3+
## Issues
4+
1. Check existing issues (open/closed) to avoid duplicates.
5+
2. Be clear about what the problem is.
6+
3. Make sure to paste error output or logs.
7+
4. Code snapshot or demos on online code editor will be very helpful.
8+
9+
## Pull requests
10+
1. Fork the repository.
11+
2. Create a branch from `master`.
12+
3. Update the source code using style guides described below.
13+
4. Lint your code with `npm run lint`.
14+
5. Commit and push the changes with descriptive messages.
15+
6. Create a pull request to `master`.
16+
17+
\* Please note that all pull requests should be tied to an issue, and all but the most trivial pull requests should be discussed before hand.
18+
19+
## Style guides
20+
- Tab indentation (size of 2 spaces).
21+
- `'` instead of `"`.
22+
- Curly braces for block statements.
23+
- 1TBS brace style.
24+
- Semicolon at the end of each statement.
25+
- Object shorthand for ES6.
26+
- Parenthesis around arrow function argument.
27+
- Minimum line breaks.
28+
- No `use strict`.

LICENSE

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
Copyright 2018 PDFTron Systems Inc. All rights reserved.
2+
WebViewer React UI project/codebase or any derived works is only permitted in solutions with an active commercial PDFTron WebViewer license. For exact licensing terms please refer to your commercial WebViewer license. For use in other scenario, please contact sales@pdftron.com

README.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# WebViewer UI
2+
3+
WebViewer UI sits on top of [WebViewer](https://pdftron.com/webviewer), a powerful JavaScript-based PDF Library that's part of the [PDFTron PDF SDK](https://pdftron.com). Built in React, WebViewer UI provides a slick out-of-the-box responsive UI that interacts with the core library to view, annotate and manipulate PDFs that can be embedded into any web project.
4+
5+
![WebViewer UI](./assets/webviewer-ui.png)
6+
7+
This repo is specifically designed for any users interested in advanced customizations. With the source code access, it gives developers full control to customize & style the UI, build custom controls & logic, integrate into workflows, or build a UI from scratch.
8+
9+
## Initial setup
10+
11+
To work with this repo, you must download the latest WebViewer and link it to this repo.
12+
13+
1. Download [WebViewer](https://pdftron.com/webviewer).
14+
2. Follow steps from [forking WebViewer](https://pdftron.com/documentation/web/guides/advanced-customization/forking-and-setting-up-the-sync).
15+
16+
Now you can navigate to `WebViewer/lib/ui` and run the commands to install, run and build.
17+
18+
## Install
19+
20+
```
21+
npm install
22+
```
23+
24+
## Run
25+
26+
```
27+
npm start
28+
```
29+
30+
## Build
31+
32+
```
33+
npm run build
34+
```
35+
36+
## Project structure
37+
38+
```
39+
src/
40+
apis/ - APIs exposed in myWebViewer.getInstance()
41+
components/ - React components
42+
constants/ - JavaScript or CSS constants
43+
core/ - APIs from the Core
44+
event-listeners/ - Listeners for the Core events
45+
helpers/ - Reused functions
46+
redux/ - Redux files for state managing
47+
```
48+
49+
## API documentation
50+
51+
See [API documentation](https://pdftron.com/documentation/web/guides/ui/apis).
52+
53+
## Contributing
54+
55+
See [contributing](./CONTRIBUTING.md).
56+
57+
## License
58+
59+
See [license](./LICENSE).

0 commit comments

Comments
 (0)