Click the gear icon in the corner.
' }, + encodePng(tall), { width: 200, height: 600 }, { position: 0 }); + const wide = raster.createImage(320, 200, [200, 120, 40, 255]); + store.addStep(guide.guideId, { title: 'Save' }, encodePng(wide), { width: 320, height: 200 }, { position: 1 }); + store.addStep(guide.guideId, { + title: 'Confirm', + descriptionHtml: 'Choose Confirm.
', + textBlocks: [ + { position: 'after-description', level: 'warn', title: 'Check who is asking', descriptionHtml: 'Verify identity.
' }, + { position: 'before-image', level: 'info', title: 'Look here', descriptionHtml: 'The button is at the bottom.
' }, + ], + }, encodePng(wide), { width: 320, height: 200 }, { position: 2 }); + const brands = new BrandingStore(path.join(root, 'settings')); + const profile = brands.save({ name: 'Acme', screenshots }); + return { + root, + ast: buildRenderAst(store, guide.guideId, { now: NOW, branding: brands.resolve(profile.id) }), + plain: buildRenderAst(store, guide.guideId, { now: NOW }), + }; +} + +function pdfPages(file) { + const buf = fs.readFileSync(file); + const text = buf.toString('latin1'); + const out = []; + const re = /\d+ 0 obj\n<< \/Filter \/FlateDecode \/Length (\d+) >>\nstream\n/g; + let m; + while ((m = re.exec(text)) !== null) { + const start = m.index + m[0].length; + out.push(zlib.inflateSync(buf.subarray(start, start + Number(m[1]))).toString('latin1')); + } + return out; +} + +/** Every image drawn on the PDF's pages: { x, y, w, h } in points. */ +function pdfImages(file) { + return pdfPages(file).flatMap((page) => [...page.matchAll(/q ([\d.]+) 0 0 ([\d.]+) ([\d.]+) ([\d.]+) cm \/Im\d+ Do Q/g)] + .map((m) => ({ w: Number(m[1]), h: Number(m[2]), x: Number(m[3]), y: Number(m[4]) }))); +} + +const docxXml = (file) => unzipSync(fs.readFileSync(file)).find((e) => e.name === 'word/document.xml').data.toString('utf8'); + +test('screenshot options: off by default, and invalid values fall back to the defaults', () => { + assert.deepEqual(normalizeProfile({}).screenshots, { align: 'left', border: false, borderColor: '#D0D5DD', layout: 'stacked' }); + assert.deepEqual(normalizeProfile({ screenshots: { align: 'middle', border: 'yes', borderColor: 'red', layout: 'grid' } }).screenshots, + { align: 'left', border: false, borderColor: '#D0D5DD', layout: 'stacked' }); + assert.deepEqual(normalizeProfile({ screenshots: { align: 'center', border: true, borderColor: '#173f7a', layout: 'side-by-side' } }).screenshots, + { align: 'center', border: true, borderColor: '#173F7A', layout: 'side-by-side' }); +}); + +test('screenshot options: a profile with the defaults exports exactly what no options did', (t) => { + const { root, ast } = fixture(t, undefined); + const { ast: explicit } = fixture(t, { align: 'left', border: false, layout: 'stacked' }); + const pdfA = pdfPages(exportPdf(ast, path.join(root, 'a')).file); + const pdfB = pdfPages(exportPdf(explicit, path.join(root, 'b')).file); + assert.deepEqual(pdfA, pdfB); + const doc = docxXml(exportDocx(ast, path.join(root, 'docx')).file); + assert.ok(!doc.includes('Click the gear icon/);
+ assert.equal((html.match(/class="step-split"/g) || []).length, 2, 'only steps with a description are split');
+ const third = html.slice(html.lastIndexOf('class="step-split"'));
+ const media = third.slice(third.indexOf('split-media'), third.indexOf('split-text'));
+ const text = third.slice(third.indexOf('split-text'));
+ assert.ok(media.indexOf('Look here') >= 0 && media.indexOf('Look here') < media.indexOf('