Crear un plugin de PolyPDF | Guía para desarrolladores
Agregue los símbolos de su oficina a PolyPDF. Sin código, sin mercado, sin cola de aprobación.
Aplicación actual: PolyPDF 1.5.2 (compilación 24) · Formato del paquete: PolyPDF 1.3.1+ · La instalación y ejecución de complementos requiere PolyPDF Pro en 1.4.1+
Si su equipo estampa la misma flecha norte, triángulo de revisión o etiqueta de habitación en cada hoja, puede empaquetar ese conjunto usted mismo y entregárselo a sus colegas como un solo archivo. Se necesita un editor de texto, una herramienta de dibujo y Node. Crear un paquete es gratis; La instalación, ejecución y edición del contenido del complemento en la aplicación actual requiere PolyPDF Pro.
Un complemento son datos, no un programa.
- Un complemento PolyPDF es una carpeta firmada de ilustraciones y JSON. No hay ningún punto de entrada de JavaScript y nunca se ejecuta nada en el paquete.
- Su paquete proporciona un catálogo de símbolos, el diseño SVG correspondiente y un formulario descrito en JSON. PolyPDF procesa el formulario, ejecuta su propio generador y agrega el resultado al dibujo como anotaciones ordinarias en un solo paso que se puede deshacer.
- El intercambio es deliberado: usted renuncia al comportamiento arbitrario y, a cambio, su complemento no puede filtrar los dibujos de un cliente, no puede dañar su aplicación y no necesita un proceso de revisión antes de que alguien pueda instalarlo de manera segura.
Lo que la gente construye con él.
- Flechas de norte coincidentes con el norte verdadero de una hoja, triángulos de revisión, etiquetas de habitaciones y equipos, marcadores de detalles, símbolos de soldadura, símbolos ADA y de seguridad contra incendios, llamadas de servicios públicos: el conjunto de símbolos estándar propio de una oficina, estampado en el tamaño de impresión correcto cada vez.
- Los símbolos se colocan en un tamaño en pulgadas, mantienen las proporciones dibujadas, giran y pueden llevar un título: debajo para una flecha norte, dentro de la forma para un número de revisión o un número de habitación.
- Una vez colocadas, son anotaciones normales: seleccionables, móviles, modificables, exportables y siguen ahí si el complemento se desactiva o elimina posteriormente.
Lo que un complemento nunca puede hacer
- Ejecutar código. Sin JavaScript, sin WASM, sin biblioteca nativa.
- Llegar a la red. Nunca se aceptan solicitudes de ningún tipo: las obras de arte que llevan una referencia externa se rechazan en el momento de la instalación, precisamente para que un símbolo no pueda llamar a casa cuando se abre una hoja.
- Lea sus documentos. A un complemento se le indica el tamaño de la página, la rotación y dónde hizo clic. Ni el texto, ni las anotaciones, ni el nombre del archivo, ni los bytes del PDF.
- Toque sus archivos, vea los detalles de su licencia, cambie una anotación existente o guarde cualquier cosa.
- Esto es arquitectónico, no una política que prometemos aplicar: no existe una API para nada de esto.
lo que escribes
Un complemento es una carpeta. El manifiesto describe qué es y qué agrega al menú Herramientas; el catálogo enumera sus símbolos y sus tamaños impresos; los activos son archivos SVG simples.
my-plugin/ manifest.json identity, permissions, commands, the form data/symbols.json each symbol: id, label, artwork, size in inches assets/*.svg the artwork icons/icon.png optional, 256 x 256
como lo construyes
Un archivo, sin dependencias, Nodo 18 o posterior. Valida todo el paquete antes de escribir algo (diseño, manifiesto, nombres de permisos, su catálogo y si su obra de arte es aceptable) y nombra el archivo y la solución para cualquier problema.
curl -O https://www.polypdf.com/plugins/polypdf-plugin-pack.mjs node polypdf-plugin-pack.mjs keygen --out ~/.polypdf-keys node polypdf-plugin-pack.mjs pack my-plugin --key ~/.polypdf-keys/polypdf-plugin-key.pem
Luego instálelo en PolyPDF: Complementos… ▸ Instalar desde archivo.
Sobre esa firma
Usted firma con una clave que genera y PolyPDF tiene cuidado con lo que eso significa, tanto para usted como para las personas a las que envía el archivo.
- Confirma que el paquete no ha sido modificado desde que lo creó y fija su complemento en su clave: se rechaza una actualización firmada por cualquier otra persona.
- Una firma no es una revisión o aprobación de PolyPDF. Los complementos que se incluyen dentro de PolyPDF están firmados por PolyPDF; un complemento que usted mismo firma es un nivel separado y claramente etiquetado.
- Cualquiera que instale su complemento ve primero una pantalla de consentimiento: lo que puede hacer en lenguaje sencillo, la huella digital de su clave y la suma de verificación del paquete. Su fila en el Administrador de complementos dice Instalado desde un archivo durante el tiempo que esté instalado.
- Haga una copia de seguridad de su clave privada. Debido a que las instalaciones están ancladas a ella, una clave perdida significa que sus usuarios deben desinstalarla antes de poder realizar su próxima versión.
La guía completa
La referencia completa (cada campo del manifiesto, el formato del paquete, las reglas de diseño, control de versiones, distribución y una sección de solución de problemas) se envía con PolyPDF en docs/plugins/PLUGIN-AUTHORING.md, junto con un complemento de ejemplo funcional que puede crear e instalar en aproximadamente un minuto.
No hay mercado. Un archivo de complemento es la distribución: colóquelo en su intranet, en un comunicado o en un correo electrónico. Publique su suma de verificación y su huella digital clave junto a la descarga y cualquiera podrá verificar que obtuvo su archivo y no el de otra persona.
Preguntas
Si el tiempo de ejecución no puede expresar la tarea de dibujo que tiene en mente, dígalo en lugar de solucionarlo: los nuevos tiempos de ejecución se incluyen con la aplicación, y saber lo que la gente realmente necesita es cómo se elige el siguiente.