mirror of
https://github.com/Frooodle/Stirling-PDF.git
synced 2024-12-21 19:08:24 +01:00
143 lines
4.7 KiB
Markdown
143 lines
4.7 KiB
Markdown
# StirlingPDF rewrite
|
|
|
|
This is the development repository for the new StirlingPDF backend. With the power of JS, WASM & GO this will provide almost all functionality SPDF can do currently directly on the client. For automation purposes this will still provide an API to automate your workflows.
|
|
|
|
## Try the new API!
|
|
|
|
[](https://documenter.getpostman.com/view/30633786/2s9YRB1Wto)
|
|
|
|
## Understanding Workflows
|
|
|
|
Workflows define how to apply operations to a PDF, including their order and relations with eachother.
|
|
|
|
Workflows can be created via the web-ui and then exported or, if you want to brag a bit, you can create the JSON object yourself.
|
|
|
|
### Basics
|
|
|
|
To create your own, you have to understand a few key features first. You can also look at more examples our github repository.
|
|
|
|
```json
|
|
{
|
|
"outputOptions": {
|
|
"zip": false
|
|
},
|
|
"operations": [
|
|
{
|
|
"type": "extract",
|
|
"values": {
|
|
"pagesToExtractArray": [0, 2]
|
|
},
|
|
"operations": []
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
The workflow above will extract the first (p\[0\]) and third (p\[2\]) page of the document.
|
|
|
|
You can also nest workflows like this:
|
|
|
|
```json
|
|
{
|
|
"outputOptions": {
|
|
"zip": false
|
|
},
|
|
"operations": [
|
|
{
|
|
"type": "extract",
|
|
"values": {
|
|
"pagesToExtractArray": [0, 2]
|
|
},
|
|
"operations": [
|
|
{
|
|
"type": "impose",
|
|
"values": {
|
|
"nup": 2, // 2 pages of the input document will be put on one page of the output document.
|
|
"format": "A4L" // A4L -> The page size of the Ouput will be an A4 in Landscape. You can also use other paper formats and "P" for portrait output.
|
|
},
|
|
"operations": []
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
If you look at it closely, you will see that the extract operation has another nested operation of the type impose. This workflow will produce a PDF with the 1st and 2nd page of the input on one single page.
|
|
|
|
### Advanced
|
|
|
|
If that is not enought for you usecase, there is also the possibility to connect operations with eachother.
|
|
|
|
You can also do different operations to produce two different output PDFs from one input.
|
|
|
|
If you are interested in learning about this, take a look at the Example workflows provided in the repository, ask on the discord, or wait for me to finish this documentation.
|
|
|
|
## Features
|
|
|
|
### Rewrite Roadmap
|
|
|
|
* [x] Client side PDF-Manipulation
|
|
* [x] Workflows
|
|
* [ ] Feature equivalent with S-PDF v1
|
|
* [ ] Stateful UI
|
|
* [ ] Node based editing of Workflows
|
|
* [ ] Propper auth using passportjs
|
|
|
|
### Functions
|
|
|
|
Current functions of spdf and their progress in this repo.
|
|
|
|
| Status | Feature | Description |
|
|
| ------ | ---------------------- | ----------- |
|
|
| ✔️ | Merge | |
|
|
| ✔️ | Split | |
|
|
| ✔️ | Rotate | |
|
|
| ✔️ | Multi-Page-Layout | |
|
|
| ✔️ | Adjust page size/scale | |
|
|
| 🚧 | Organize | |
|
|
| 🚧 | Change Metadata | |
|
|
| ❌ | Add Watermark | |
|
|
|
|
| Status | Feature | Description |
|
|
| ------ | --------------------------- | ----------- |
|
|
| ❌ | Remove Pages | |
|
|
| ❌ | Remove Blank Pages | |
|
|
| ❌ | Detect/Split Scanned photos | |
|
|
|
|
| Status | Feature | Description |
|
|
| ------ | ------------ | ----------- |
|
|
| ❌ | Repair | |
|
|
| ❌ | Compress | |
|
|
| ❌ | Flatten | |
|
|
| ❌ | Compare/Diff | |
|
|
|
|
| Status | Feature | Description |
|
|
| ------ | --------------------- | ----------- |
|
|
| ❌ | Sign | |
|
|
| ❌ | Sign with Certificate | |
|
|
| ❌ | Add Password | |
|
|
| ❌ | Remove Password | |
|
|
| ❌ | Change Permissions | |
|
|
|
|
| Status | Feature | Description |
|
|
| ------ | -------------- | ----------- |
|
|
| ❌ | Image to PDF | |
|
|
| ❌ | Add image | |
|
|
| ❌ | Extract Images | |
|
|
| ❌ | PDF to Image | |
|
|
| ❌ | OCR | |
|
|
|
|
| Status | Feature | Description |
|
|
| ------ | ------------------- | ----------- |
|
|
| ❌ | Convert file to PDF | |
|
|
| ❌ | PDF to Text/RTF | |
|
|
| ❌ | PDF to HTML | |
|
|
| ❌ | PDF to XML | |
|
|
|
|
✔️: Done, 🚧: Started Developement, ❌: Planned Feature
|
|
|
|
## Contribute
|
|
|
|
For initial instructions look at [CONTRIBUTE.md](./CONTRIBUTE.md)
|