{"_id":"@benhall-1/pptxgenjs","name":"@benhall-1/pptxgenjs","dist-tags":{"latest":"3.13.0"},"versions":{"3.13.0":{"name":"@benhall-1/pptxgenjs","version":"3.13.0","author":{"name":"Brent Ely","url":"https://github.com/benhall-1/"},"description":"Create JavaScript PowerPoint Presentations","homepage":"https://gitbrent.github.io/PptxGenJS/","license":"MIT","main":"dist/pptxgen.cjs.js","module":"dist/pptxgen.es.js","types":"types","scripts":{"build":"rollup -c","start":"gulp","ship":"gulp ship","defs":"gulp reactTestDefs","watch":"rollup -cw","doctoc":"./node_modules/doctoc/doctoc.js README.md"},"browser":{"express":false,"fs":false,"https":false,"image-size":false,"os":false,"path":false},"dependencies":{"@types/node":"^18.7.3","https":"^1.0.0","image-size":"^1.0.0","jszip":"^3.7.1"},"devDependencies":{"@rollup/plugin-commonjs":"^21.0.2","@rollup/plugin-node-resolve":"^13.0.5","doctoc":"^2.0.1","express":"^4.17.1","gulp":"^4.0.2","gulp-concat":"^2.6.1","gulp-delete-lines":"0.0.7","gulp-ignore":"^3.0.0","gulp-insert":"^0.5.0","gulp-sourcemaps":"^3.0.0","gulp-uglify":"^3.0.2","rollup":"^2.57.0","rollup-plugin-typescript2":"^0.31.2","tslib":"^2.3.1","typescript":"^4.4.3"},"repository":{"type":"git","url":"git+https://github.com/gitbrent/PptxGenJS.git"},"keywords":["html-to-powerpoint","javascript-create-powerpoint","javascript-create-pptx","javascript-generate-pptx","javascript-powerpoint","javascript-powerpoint-charts","javascript-pptx","js-create-powerpoint","js-create-pptx","js-generate-powerpoint","js-powerpoint","js-powerpoint-library","js-powerpoint-pptx","react-powerpoint","typescript-powerpoint"],"bugs":{"url":"https://github.com/gitbrent/PptxGenJS/issues"},"gitHead":"1d392549eee0b2cf0567aace8dfecac33d13121d","_id":"@benhall-1/pptxgenjs@3.13.0","_nodeVersion":"16.17.0","_npmVersion":"8.15.0","dist":{"integrity":"sha512-3RKayy90Z/5R2Yzay+2fkIcyE7fzCql91y3uWXtQ/KLRGpNx71qCXksTo6e6nzxoKlBAR7dmaUwdktxojMqpsg==","shasum":"05a8f0429c1bfed1f4e559a6a3cf746b778feb7a","tarball":"https://registry.npmjs.org/@benhall-1/pptxgenjs/-/pptxgenjs-3.13.0.tgz","fileCount":11,"unpackedSize":2278517,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDsmgu0bsyGPQpc8TZAhonfSjZ/U+38CrnUki8oR4z+WQIhAJ5txzuc1oLOm7xp01cbjH4JZAs1VVPn6VZsDHElS2oD"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjA4BSACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmqeyQ/+PVg/tOyuHQuZ5YxOGjwrFewV93c5o5ys9mcArbe3tQ2XPo4C\r\nAuneSTPUXaPkyxpvmcn8RW7l72fWDajwOA/P0iek8yJQy3utN6LMr+gxKKX6\r\npC9WoZjHqnybHMyAgzHOuVTUJvbTl2VBNbEs0kSlPWwirz1kEbtr0BbXyWAd\r\n8hwtKIAfN4CM1vn2aHMrzpom71LllP6JGWVBMO0LXr7phLtuBa2qh+ZkEz9e\r\nLOOgl/+ZCEniM3heUXjArl5aotAJFkyH0vZx0XJ6V0tFSQYHSw/X6HF/Lgd1\r\nH9YIAJW1SyIgJAmFBQTOZQQIXr2D+ualJxFufJDKA9mjZLGABU1C2ZPNvCBa\r\nDgfpySB2DE3u8ZIZQG5BPhB/IlL/fnVX15xcVnYUA9y8oNnWQ+Jj0VAwr9IV\r\nbZqiZ+PYAy/nIfaeo0l0MT7jDvaLYd6F5l3xUf6bjI0E41gaziVvYowZ24b0\r\nR4RqXw0efXE/OepPI6gnhXNmENHPTZOp32inD5JQyJAKHwkEuqOYr3R8COzV\r\nQ7Gq10bhVZqBIwiNggDE75FpdtCYNZKGaxElWcFPCsGKh4GFqL83PM8w3OJ7\r\n0AS/tJjUNdy93IwYLMhQuTDQQXNoQ9PTPCxqScqFyjTkiI6t5nhKFMI23mC1\r\nmc/Eo1TAdw2THNF9nLowK8wpcnLvpbRGScY=\r\n=RuZg\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"benhall-1","email":"github@benh.codes"},"directories":{},"maintainers":[{"name":"benhall-1","email":"github@benh.codes"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/pptxgenjs_3.13.0_1661173842160_0.27767175176718784"},"_hasShrinkwrap":false}},"time":{"created":"2022-08-22T13:10:42.069Z","3.13.0":"2022-08-22T13:10:42.365Z","modified":"2022-08-22T13:10:42.504Z"},"maintainers":[{"name":"benhall-1","email":"github@benh.codes"}],"description":"Create JavaScript PowerPoint Presentations","homepage":"https://gitbrent.github.io/PptxGenJS/","keywords":["html-to-powerpoint","javascript-create-powerpoint","javascript-create-pptx","javascript-generate-pptx","javascript-powerpoint","javascript-powerpoint-charts","javascript-pptx","js-create-powerpoint","js-create-pptx","js-generate-powerpoint","js-powerpoint","js-powerpoint-library","js-powerpoint-pptx","react-powerpoint","typescript-powerpoint"],"repository":{"type":"git","url":"git+https://github.com/gitbrent/PptxGenJS.git"},"author":{"name":"Brent Ely","url":"https://github.com/benhall-1/"},"bugs":{"url":"https://github.com/gitbrent/PptxGenJS/issues"},"license":"MIT","readme":"<h1 align=\"center\">PptxGenJS</h1>\n<h5 align=\"center\">\n  Create JavaScript PowerPoint Presentations\n</h5>\n<p align=\"center\">\n  <a href=\"https://github.com/gitbrent/PptxGenJS/\">\n    <img alt=\"PptxGenJS Sample Slides\" title=\"PptxGenJS Sample Slides\" src=\"https://raw.githubusercontent.com/gitbrent/PptxGenJS/gh-pages/img/readme_banner.png\"/>\n  </a>\n</p>\n<br/>\n\n[![Known Vulnerabilities](https://snyk.io/test/npm/pptxgenjs/badge.svg)](https://snyk.io/test/npm/pptxgenjs) [![npm downloads](https://img.shields.io/npm/dm/pptxgenjs.svg)](https://www.npmjs.com/package/pptxgenjs) [![jsdelivr downloads](https://data.jsdelivr.com/v1/package/gh/gitbrent/pptxgenjs/badge)](https://www.jsdelivr.com/package/gh/gitbrent/pptxgenjs) [![typescripts definitions](https://img.shields.io/npm/types/pptxgenjs)](https://img.shields.io/npm/types/pptxgenjs)\n\n# Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [Introduction](#introduction)\n- [Features](#features)\n\t- [Works Everywhere](#works-everywhere)\n\t- [Full Featured](#full-featured)\n\t- [Simple and Powerful](#simple-and-powerful)\n\t- [Export Your Way](#export-your-way)\n\t- [HTML to PowerPoint](#html-to-powerpoint)\n- [Live Demos](#live-demos)\n- [Installation](#installation)\n\t- [Npm](#npm)\n\t- [Yarn](#yarn)\n\t- [CDN](#cdn)\n\t- [Download](#download)\n\t- [Additional Builds](#additional-builds)\n- [Documentation](#documentation)\n\t- [Quick Start Guide](#quick-start-guide)\n\t\t- [Angular/React, ES6, TypeScript](#angularreact-es6-typescript)\n\t\t- [Script/Web Browser](#scriptweb-browser)\n\t- [Library API](#library-api)\n\t- [HTML-to-PowerPoint Feature](#html-to-powerpoint-feature)\n- [Library Ports](#library-ports)\n- [Issues / Suggestions](#issues--suggestions)\n- [Need Help?](#need-help)\n- [Contributors](#contributors)\n- [Sponsor Us](#sponsor-us)\n- [License](#license)\n\n# Introduction\n\nThis library creates Open Office XML (OOXML) Presentations which are compatible with Microsoft PowerPoint, Apple Keynote, and other applications.\n\n# Features\n\n## Works Everywhere\n\n- Every modern desktop and mobile browser is supported\n- Integrates with Node, Angular, React, and Electron\n- Compatible with PowerPoint, Keynote, and more\n\n## Full Featured\n\n- All major object types are available (charts, shapes, tables, etc.)\n- Master Slides for academic/corporate branding\n- SVG images, animated gifs, YouTube videos, RTL text, and Asian fonts\n\n## Simple and Powerful\n\n- The absolute easiest PowerPoint library to use\n- Learn as you code will full typescript definitions included\n- Tons of demo code comes included (over 75 slides of features)\n\n## Export Your Way\n\n- Exports files direct to client browsers with proper MIME-type\n- Other export formats available: base64, blob, stream, etc.\n- Presentation compression options and more\n\n## HTML to PowerPoint\n\n- Includes powerful [HTML-to-PowerPoint](#html-to-powerpoint-feature) feature to transform HTML tables into presentations with a single line of code\n\n# Live Demos\n\nVisit the demos page to create a simple presentation to see how easy it is to use pptxgenjs, or check out the complete demo which showcases every available feature.\n\n- [PptxGenJS Demos](https://gitbrent.github.io/PptxGenJS/demos/)\n\n# Installation\n\n## Npm\n\n[PptxGenJS NPM Home](https://www.npmjs.com/package/pptxgenjs)\n\n```bash\nnpm install pptxgenjs --save\n```\n\n## Yarn\n\n```bash\nyarn add pptxgenjs\n```\n\n## CDN\n\n[jsDelivr Home](https://www.jsdelivr.com/package/gh/gitbrent/pptxgenjs)\n\nBundle: Modern Browsers and IE11\n\n```html\n<script src=\"https://cdn.jsdelivr.net/gh/gitbrent/pptxgenjs@3.11.0/dist/pptxgen.bundle.js\"></script>\n```\n\nMin files: Modern Browsers\n\n```html\n<script src=\"https://cdn.jsdelivr.net/gh/gitbrent/pptxgenjs@3.11.0/libs/jszip.min.js\"></script>\n<script src=\"https://cdn.jsdelivr.net/gh/gitbrent/pptxgenjs@3.11.0/dist/pptxgen.min.js\"></script>\n```\n\n## Download\n\n[GitHub Latest Release](https://github.com/gitbrent/PptxGenJS/releases/latest)\n\nBundle: Modern Browsers\n\n- Use the bundle for IE11 support\n\n```html\n<script src=\"PptxGenJS/dist/pptxgen.bundle.js\"></script>\n```\n\nMin files: Modern Browsers\n\n```html\n<script src=\"PptxGenJS/libs/jszip.min.js\"></script>\n<script src=\"PptxGenJS/dist/pptxgen.min.js\"></script>\n```\n\n## Additional Builds\n\n- CommonJS: `dist/pptxgen.cjs.js`\n- ES Module: `dist/pptxgen.es.js`\n\n---\n\n# Documentation\n\n## Quick Start Guide\n\nPptxGenJS PowerPoint presentations are created via JavaScript by following 4 basic steps:\n\n### Angular/React, ES6, TypeScript\n\n```typescript\nimport pptxgen from \"pptxgenjs\";\n\n// 1. Create a new Presentation\nlet pres = new pptxgen();\n\n// 2. Add a Slide\nlet slide = pres.addSlide();\n\n// 3. Add one or more objects (Tables, Shapes, Images, Text and Media) to the Slide\nlet textboxText = \"Hello World from PptxGenJS!\";\nlet textboxOpts = { x: 1, y: 1, color: \"363636\" };\nslide.addText(textboxText, textboxOpts);\n\n// 4. Save the Presentation\npres.writeFile();\n```\n\n### Script/Web Browser\n\n```javascript\n// 1. Create a new Presentation\nlet pres = new PptxGenJS();\n\n// 2. Add a Slide\nlet slide = pres.addSlide();\n\n// 3. Add one or more objects (Tables, Shapes, Images, Text and Media) to the Slide\nlet textboxText = \"Hello World from PptxGenJS!\";\nlet textboxOpts = { x: 1, y: 1, color: \"363636\" };\nslide.addText(textboxText, textboxOpts);\n\n// 4. Save the Presentation\npres.writeFile();\n```\n\nThat's really all there is to it!\n\n---\n\n## Library API\n\nFull documentation and code examples are available\n\n- [Creating a Presentation](https://gitbrent.github.io/PptxGenJS/docs/usage-pres-create/)\n- [Presentation Options](https://gitbrent.github.io/PptxGenJS/docs/usage-pres-options/)\n- [Adding a Slide](https://gitbrent.github.io/PptxGenJS/docs/usage-add-slide/)\n- [Slide Options](https://gitbrent.github.io/PptxGenJS/docs/usage-slide-options/)\n- [Saving a Presentation](https://gitbrent.github.io/PptxGenJS/docs/usage-saving/)\n- [Master Slides](https://gitbrent.github.io/PptxGenJS/docs/masters/)\n- [Adding Charts](https://gitbrent.github.io/PptxGenJS/docs/api-charts/)\n- [Adding Images](https://gitbrent.github.io/PptxGenJS/docs/api-images/)\n- [Adding Media](https://gitbrent.github.io/PptxGenJS/docs/api-media/)\n- [Adding Shapes](https://gitbrent.github.io/PptxGenJS/docs/api-shapes/)\n- [Adding Tables](https://gitbrent.github.io/PptxGenJS/docs/api-tables/)\n- [Adding Text](https://gitbrent.github.io/PptxGenJS/docs/api-text/)\n- [Speaker Notes](https://gitbrent.github.io/PptxGenJS/docs/speaker-notes/)\n- [Using Scheme Colors](https://gitbrent.github.io/PptxGenJS/docs/shapes-and-schemes/)\n- [Integration with Other Libraries](https://gitbrent.github.io/PptxGenJS/docs/integration/)\n\n---\n\n## HTML-to-PowerPoint Feature\n\nEasily convert HTML tables to PowerPoint presentations in a single call.\n\n```javascript\nlet pptx = new PptxGenJS();\npptx.tableToSlides(\"tableElementId\");\npptx.writeFile({ fileName: \"html2pptx-demo.pptx\" });\n```\n\nLearn more:\n\n- [HTML-to-PowerPoint Docs/Demo](https://gitbrent.github.io/PptxGenJS/html2pptx/)\n\n---\n\n# Library Ports\n\nReact: [react-pptx](https://github.com/wyozi/react-pptx) - thanks to [Joonas](https://github.com/wyozi)!\n\n---\n\n# Issues / Suggestions\n\nPlease file issues or suggestions on the [issues page on github](https://github.com/gitbrent/PptxGenJS/issues/new), or even better, [submit a pull request](https://github.com/gitbrent/PptxGenJS/pulls). Feedback is always welcome!\n\nWhen reporting issues, please include a code snippet or a link demonstrating the problem.\nHere is a small [jsFiddle](https://jsfiddle.net/gitbrent/L1uctxm0/) that is already configured and uses the latest PptxGenJS code.\n\n---\n\n# Need Help?\n\nSometimes implementing a new library can be a difficult task and the slightest mistake will keep something from working. We've all been there!\n\nIf you are having issues getting a presentation to generate, check out the code in the `demos` directory. There\nare demos for both client browsers, node and react that contain working examples of every available library feature.\n\n- Use a pre-configured jsFiddle to test with: [PptxGenJS Fiddle](https://jsfiddle.net/gitbrent/L1uctxm0/)\n- [View questions tagged `PptxGenJS` on StackOverflow](https://stackoverflow.com/questions/tagged/pptxgenjs?sort=votes&pageSize=50). If you can't find your question, [ask it yourself](https://stackoverflow.com/questions/ask?tags=PptxGenJS) - be sure to tag it `PptxGenJS`.\n\n---\n\n# Contributors\n\nThank you to everyone for the issues, contributions and suggestions! ❤️\n\nSpecial Thanks:\n\n- [Dzmitry Dulko](https://github.com/DzmitryDulko) - Getting the project published on NPM\n- [Michal Kacerovský](https://github.com/kajda90) - New Master Slide Layouts and Chart expertise\n- [Connor Bowman](https://github.com/conbow) - Adding Placeholders\n- [Reima Frgos](https://github.com/ReimaFrgos) - Multiple chart and general functionality patches\n- [Matt King](https://github.com/kyrrigle) - Chart expertise\n- [Mike Wilcox](https://github.com/clubajax) - Chart expertise\n- [Joonas](https://github.com/wyozi) - React port\n\nPowerPoint shape definitions and some XML code via [Officegen Project](https://github.com/Ziv-Barber/officegen)\n\n---\n\n# Sponsor Us\n\nIf you find this library useful, please consider sponsoring us through a [donation](https://gitbrent.github.io/PptxGenJS/sponsor/)\n\n---\n\n# License\n\nCopyright &copy; 2015-present [Brent Ely](https://github.com/gitbrent/PptxGenJS)\n\n[MIT](https://github.com/gitbrent/PptxGenJS/blob/master/LICENSE)\n","readmeFilename":"README.md"}