pptx2json's Introduction

pptx2json

Operating Powerpoint file (Microsoft Office 2007 and later) as Office Open XML without external tools, just pure Javascript.
Providing two main functions:

Parse from a PowerPoint file to Json
Parse from a Json to PowerPoint

The images, movies, audio files and so on in a PowerPoint are treated as binary.
This is strongly inspired from pptx-compose.

Installation

$ npm install pptx2json

Usage

Parse a PowerPoint file to Json

const PPTX2Json = require('pptx2json');
const pptx2json = new PPTX2Json();

const json = await pptx2json.toJson('path/to/pptx');

Rebuild a PowerPoint from Json

If you want to get a buffer below:

const PPTX2Json = require('pptx2json');
const pptx2json = new PPTX2Json();

const json = await pptx2json.toJson('path/to/pptx');
:
// return buffer to pptx 
const pptx = await pptx2json.toPPTX(json);

Otherwise want to write a file below:

const PPTX2Json = require('pptx2json');
const pptx2json = new PPTX2Json();

const json = await pptx2json.toJson('path/to/pptx');
:
// write pptx to the path 
await pptx2json.toPPTX(json, {'file': 'path/to/output.pptx'});

Get max id, rid in slides.

const PPTX2Json = require('pptx2json');
const pptx2json = new PPTX2Json();

const json = await pptx2json.toJson(testPPTX);
const ids = pptx2json.getMaxSlideIds(json);
// {'id': 5, 'rid': 3}

Get slideLayoutType Hash.

const PPTX2Json = require('pptx2json');
const pptx2json = new PPTX2Json();

const json = await pptx2json.toJson(testPPTX);
const table = pptx2json.getSlideLayoutTypeHash(json);
// {
//    'title': 'ppt/slideLayouts/slideLayout1.xml',
//    'blank': 'ppt/slideLayouts/slideLayout7.xml'
// }

Dependencies

jszip
xml2js

Reference

pptx2json's People

Contributors

Stargazers

Watchers

pptx2json's Issues

CVE-2023-0842

Version 0.0.8 of PPTX2JSON depends on a vulnerable version of the XML2JS package. A new release needs to be created to update the NPM registry.

https://github.com/advisories/GHSA-776f-qx25-q3cc

@x1- @jotty-mcclure

Wrong arrangement order on slides when creating pptx from json

About

If we create a pptx from json, text, box, images etc arranges are ignored.
Because xml2js creates json <p:spTree><p:sp> as items of Object instead of Array.
But the order of <p:sp> means arrangement of content in the slide.

Recommend Projects

x1- / pptx2json Goto Github PK