mirror of
https://github.com/24eme/signaturepdf
synced 2024-05-29 12:03:11 +02:00
150c25c10e
Add a new host for signaturepdf
197 lines
6.8 KiB
Markdown
197 lines
6.8 KiB
Markdown
[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0) [![État de la traduction](https://hosted.weblate.org/widget/signature-pdf/application/svg-badge.svg)](https://hosted.weblate.org/engage/signature-pdf/)
|
|
# PDF Signature
|
|
|
|
Free web software for signing, organizing, editing metadatas or compressing PDFs.
|
|
|
|
## Instances
|
|
List of instances where you can use this software:
|
|
- [pdf.24eme.fr](https://pdf.24eme.fr)
|
|
- [pdf.libreon.fr](https://pdf.libreon.fr)
|
|
- [pdf.hostux.net](https://pdf.hostux.net)
|
|
- [pdf.nebulae.co](https://pdf.nebulae.co)
|
|
- [pdf.kaosx.cf](https://pdf.kaosx.cf)
|
|
- [pdf.ti-nuage.fr](https://pdf.ti-nuage.fr)
|
|
- [pdf.cemea.org](https://pdf.cemea.org)
|
|
- [pdf.spirio.fr](https://pdf.spirio.fr)
|
|
|
|
_Feel free to add yours through an issue or a pull request._
|
|
|
|
## License
|
|
Open-source software under the AGPL V3 license.
|
|
|
|
## Table of Contents
|
|
|
|
- [Installation](#installation)
|
|
- [Configuration](#configuration)
|
|
- [Enabling and Configuring Multi-Signature Mode](#enabling-and-configuring-multi-signature-mode)
|
|
- [Disabling the Organize Mode](#disabling-the-organize-mode)
|
|
- [Hiding or Modifying the Demo PDF Link](#hiding-or-modifying-the-demo-pdf-link)
|
|
- [Default Fields for Metadata Editing](#default-fields-for-metadata-editing)
|
|
- [Update](#update)
|
|
- [Tests](#tests)
|
|
- [Libraries Used](#libraries-used)
|
|
- [Contributions](#contributions)
|
|
- [Translation](#translation)
|
|
- [Contributors](#contributors)
|
|
- [Fundings](#fundings)
|
|
- [Screenshots](#screenshots)
|
|
- [Signature feature](#signature-feature)
|
|
- [Organizing feature](#organizing-feature)
|
|
- [Metadata feature](#metadata-feature)
|
|
- [Compression feature](#compression-feature)
|
|
|
|
|
|
## Installation
|
|
|
|
- [Debian/Ubuntu](installation.md#debian)
|
|
- [Docker](installation.md#docker)
|
|
- [Linux Alpine](installation.md#alpine)
|
|
|
|
## Configuration
|
|
|
|
### Enabling and Configuring Multi-Signature Mode
|
|
|
|
This mode allows multiple people to sign a PDF, but it requires that the PDFs be stored on the server.
|
|
|
|
It is not mandatory to enable this mode for the application to work; it is an option.
|
|
|
|
Create the `config/config.ini` file
|
|
|
|
```
|
|
cp config/config.ini{.example,}
|
|
```
|
|
|
|
In the `config/config.ini` file, configure the `PDF_STORAGE_PATH` variable with the path where uploaded PDF files can be stored:
|
|
|
|
```
|
|
PDF_STORAGE_PATH=/path/to/folder
|
|
```
|
|
|
|
Create this folder:
|
|
|
|
```
|
|
mkdir /path/to/folder
|
|
```
|
|
|
|
The web server should have write permissions on this folder.
|
|
|
|
For example, for Apache:
|
|
|
|
```
|
|
chown www-data /path/to/folder/to/store/pdf
|
|
```
|
|
|
|
### Disabling the Organize Mode
|
|
|
|
To disable the Organize mode, add `DISABLE_ORGANIZATION=true` to the
|
|
`config/config.ini` file.
|
|
|
|
### Hiding or Modifying the Demo PDF Link
|
|
|
|
To hide the demo PDF link, add `PDF_DEMO_LINK=false` to the
|
|
`config/config.ini` file.
|
|
|
|
### Default Fields for Metadata Editing
|
|
|
|
In the `config/config.ini` file, you can add as many fields as you want with the HTML input type (text, date, number, email, etc.) that will be preloaded for each PDF.
|
|
|
|
```
|
|
METADATA_DEFAULT_FIELDS[field1].type = "text"
|
|
METADATA_DEFAULT_FIELDS[field2].type = "text"
|
|
METADATA_DEFAULT_FIELDS[field3].type = "date"
|
|
METADATA_DEFAULT_FIELDS[field4].type = "number"
|
|
```
|
|
|
|
## Update
|
|
|
|
The latest stable version is on the `master` branch. To update, simply fetch the latest changes:
|
|
|
|
```
|
|
git pull -r
|
|
```
|
|
|
|
## Tests
|
|
|
|
To run functional tests:
|
|
|
|
```
|
|
make test
|
|
```
|
|
|
|
The tests are performed using `puppeteer` and `jest`.
|
|
|
|
To run the tests and view the browser (in debug mode):
|
|
|
|
```
|
|
DEBUG=1 make test
|
|
```
|
|
|
|
## Libraries Used
|
|
|
|
- **Fat-Free** PHP micro framework: https://github.com/bcosca/fatfree (GPLv3)
|
|
- **Bootstrap** HTML, CSS, and JavaScript framework: https://getbootstrap.com/ (MIT)
|
|
- **PDF.js** JavaScript library for rendering PDFs in an HTML canvas: https://github.com/mozilla/pdf.js (Apache-2.0)
|
|
- **Fabric.js** JavaScript library for manipulating an HTML canvas: https://github.com/fabricjs/fabric.js (MIT)
|
|
- **PDFtk** PDF manipulation tools (GPL)
|
|
- **librsvg** SVG manipulation tools: https://gitlab.gnome.org/GNOME/librsvg (LGPL-2+)
|
|
- **potrace** Bitmap to vector image conversion tools: http://potrace.sourceforge.net/ (GPLv2)
|
|
- **OpenType.js** Tools for converting text and its font into paths: https://github.com/opentypejs/opentype.js (MIT)
|
|
- **ImageMagick** Image manipulation toolset: https://imagemagick.org/ (Apache-2.0)
|
|
- **Caveat** Handwriting-style font: https://github.com/googlefonts/caveat (OFL-1.1)
|
|
- **PDF-LIB** JavaScript library for PDF manipulation used for writing metadata: https://pdf-lib.js.org/ (MIT)
|
|
- **Ghostscript** GPL Ghostscript is a software suite for processing PostScript and PDF file formats (GPLv3)
|
|
|
|
For testing:
|
|
|
|
- **Jest** JavaScript Testing Framework: https://jestjs.io/ (MIT)
|
|
- **Puppeteer** Node.js library for controlling a web browser: https://github.com/puppeteer/puppeteer (Apache-2.0)
|
|
|
|
## Contributions
|
|
|
|
### Translation
|
|
|
|
To update the translation, simply execute `make` that will update the `.pot` file,
|
|
which will merge the `.po` files which then will allow to create updated `.mo` files.
|
|
|
|
[![État de la traduction](https://hosted.weblate.org/widget/signature-pdf/application/multi-green.svg)](https://hosted.weblate.org/engage/signature-pdf/)
|
|
|
|
### Contributors
|
|
|
|
These people are the authors of the code of this software :
|
|
|
|
Vincent LAURENT (24ème), Jean-Baptiste Le Metayer (24ème), Xavier Garnier (Logilab), Simon Chabot (Logilab), Tangui Morlier (24ème), Gabriel POMA (24ème), Tanguy Le Faucheur (24ème), Étienne Deparis, battosai30
|
|
|
|
### Fundings
|
|
|
|
- 1 365 € excl. taxes from the company Logilab for the development of the shared signature feature
|
|
- 1 950 € excl. taxes from the company Logilab for the development of the metadata editing feature
|
|
- 100 € excl. taxes donations from the company Spirkop
|
|
- 100 € excl. taxes donations from the company PDG IT
|
|
- 1 040 € excl. taxes from the foundation NLNet pour software internationalization
|
|
|
|
The development of the software was primarily done during the working hours of 24ème employees.
|
|
|
|
## Screenshots
|
|
|
|
### Signature feature
|
|
|
|
![image](https://github.com/24eme/signaturepdf/assets/71143205/c3e8b8d2-3f94-45a3-a8fd-143077443337)
|
|
![image](https://github.com/24eme/signaturepdf/assets/71143205/4deeb6fb-caa9-4365-895e-d22177a6ec3b)
|
|
|
|
|
|
### Organizing feature
|
|
|
|
![image](https://github.com/24eme/signaturepdf/assets/71143205/800c45a4-4c4c-42d5-b09b-c81cfcc0e6e0)
|
|
![image](https://github.com/24eme/signaturepdf/assets/71143205/a008d765-3a74-4ab4-b2bc-4af6c81575fe)
|
|
|
|
|
|
### Metadata feature
|
|
|
|
![image](https://github.com/24eme/signaturepdf/assets/71143205/f543d665-0ab0-4d2b-8be1-39238879bd6c)
|
|
![image](https://github.com/24eme/signaturepdf/assets/71143205/1f195bae-4af3-4d7b-9e31-3acd7552c2eb)
|
|
|
|
|
|
### Compression feature
|
|
|
|
![image](https://github.com/24eme/signaturepdf/assets/71143205/7d0e93a3-5567-4545-9c43-033b9028b036)
|