Metadata-Version: 2.4
Name: pdfstudio
Version: 1.0.0
Summary: Studio PDF WYSIWYG : conversion, édition et filigrane
Author: Klaghmari Group
License: MIT
Project-URL: Homepage, https://gitlab.com/klaghmari-group/pdfstudio
Project-URL: Documentation, https://gitlab.com/klaghmari-group/pdfstudio/-/blob/main/docs/index.md
Project-URL: Repository, https://gitlab.com/klaghmari-group/pdfstudio
Keywords: pdf,wysiwyg,watermark,html,editor
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: Editors
Classifier: Topic :: Office/Business
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.110
Requires-Dist: uvicorn[standard]>=0.27
Requires-Dist: pymupdf>=1.23
Requires-Dist: pydantic>=2.5
Requires-Dist: python-multipart>=0.0.9
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: httpx>=0.26; extra == "dev"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.6; extra == "docs"
Requires-Dist: mkdocs-material>=9.5; extra == "docs"
Requires-Dist: mkdocstrings[python]>=0.25; extra == "docs"

# PDF Studio

Studio web pour travailler sur des PDF en mode WYSIWYG. Le document est converti en HTML fidèle, modifiable directement dans le navigateur, puis exporté en HTML ou PDF. Un filigrane personnalisable peut être ajouté ou retiré à tout moment.

## Fonctionnalités

- Import de PDF par glisser-déposer ou sélection de fichier
- Conversion en HTML avec mise en page conservée (texte, images, tracés vectoriels)
- Édition directe du texte dans la page
- Filigrane configurable : texte, angle, taille, opacité
- Export HTML ou PDF du résultat final

## Prérequis

- Python 3.10 ou plus récent
- Chrome ou Chromium (requis uniquement pour l'export PDF)

## Installation

```bash
git clone https://gitlab.com/klaghmari-group/pdfstudio.git
cd pdfstudio
pip install -e .
```

Avec les outils de développement :

```bash
pip install -e ".[dev]"
```

## Lancement

```bash
pdfstudio
```

Le studio est accessible sur [http://127.0.0.1:8787](http://127.0.0.1:8787).

Options utiles :

```bash
pdfstudio --port 9000 --no-browser
pdfstudio --chrome-path /usr/bin/chromium
```

Équivalent via le module Python :

```bash
python -m pdfstudio serve --host 127.0.0.1 --port 8787
```

## Utilisation rapide

1. Ouvrir le studio dans le navigateur.
2. Charger un PDF.
3. Modifier le texte en cliquant directement sur la page.
4. Ajuster le filigrane dans le panneau latéral si nécessaire.
5. Télécharger le document en HTML ou PDF.

## Documentation

La documentation complète se trouve dans le dossier `docs/`. Pour générer le site web :

```bash
pip install -e ".[docs]"
mkdocs serve
```

Puis ouvrir [http://127.0.0.1:8000](http://127.0.0.1:8000).

## Tests

```bash
pytest
```

## Structure du projet

```text
pdfstudio/
├── docs/              # Documentation Markdown (MkDocs)
├── src/pdfstudio/     # Code source du package
│   ├── app.py         # Serveur FastAPI
│   ├── converter.py   # Conversion PDF → HTML
│   ├── export.py      # Export PDF via Chrome
│   └── static/        # Interface web
└── tests/
```

## Licence

MIT
