From f5864ba0b5941e41957ca4d7f6f541c7ed369889 Mon Sep 17 00:00:00 2001 From: Charly Abraham Date: Thu, 12 Nov 2026 12:11:11 +0530 Subject: [PATCH] docs: add illustrated PNG-to-PDF guides and videos --- CONTRIBUTING.md | 58 +++++++++++-- README.md | 2 +- .../index.md | 24 ++++++ blog/2026-11-08-png-to-pdf-quality/index.md | 18 ++++ scripts/tutorial-media-manifest.json | 77 +++++++++++++++++- scripts/verify-tutorials.cjs | 23 ++++-- src/components/Video/ImageTutorialVideo.js | 26 +----- src/components/Video/ImageWatchPage.js | 39 +-------- src/components/Video/PngPdfVideo.js | 7 ++ src/components/Video/RecordedVideo.js | 28 +++++++ src/components/Video/VideoWatchPage.js | 39 +++++++++ ...e.module.css => VideoWatchPage.module.css} | 0 src/css/png-pdf-guides.css | 17 ++++ src/data/png-pdf-videos.json | 56 +++++++++++++ src/pages/videos/convert-png-to-pdf.js | 7 ++ src/pages/videos/png-to-pdf-page-settings.js | 7 ++ .../media/png-to-pdf-a4-transparent.png | Bin 0 -> 48523 bytes .../media/png-to-pdf-convert-poster.png | Bin 0 -> 103263 bytes static/tutorials/media/png-to-pdf-convert.mp4 | Bin 0 -> 2564682 bytes static/tutorials/media/png-to-pdf-convert.vtt | 25 ++++++ .../media/png-to-pdf-download-ready.png | Bin 0 -> 86095 bytes .../tutorials/media/png-to-pdf-page-order.png | Bin 0 -> 91718 bytes .../tutorials/media/png-to-pdf-print-size.svg | 16 ++++ .../media/png-to-pdf-settings-poster.png | Bin 0 -> 59308 bytes .../tutorials/media/png-to-pdf-settings.mp4 | Bin 0 -> 290530 bytes .../tutorials/media/png-to-pdf-settings.vtt | 19 +++++ 26 files changed, 407 insertions(+), 81 deletions(-) create mode 100644 src/components/Video/PngPdfVideo.js create mode 100644 src/components/Video/RecordedVideo.js create mode 100644 src/components/Video/VideoWatchPage.js rename src/components/Video/{ImageWatchPage.module.css => VideoWatchPage.module.css} (100%) create mode 100644 src/data/png-pdf-videos.json create mode 100644 src/pages/videos/convert-png-to-pdf.js create mode 100644 src/pages/videos/png-to-pdf-page-settings.js create mode 100644 static/tutorials/media/png-to-pdf-a4-transparent.png create mode 100644 static/tutorials/media/png-to-pdf-convert-poster.png create mode 100644 static/tutorials/media/png-to-pdf-convert.mp4 create mode 100644 static/tutorials/media/png-to-pdf-convert.vtt create mode 100644 static/tutorials/media/png-to-pdf-download-ready.png create mode 100644 static/tutorials/media/png-to-pdf-page-order.png create mode 100644 static/tutorials/media/png-to-pdf-print-size.svg create mode 100644 static/tutorials/media/png-to-pdf-settings-poster.png create mode 100644 static/tutorials/media/png-to-pdf-settings.mp4 create mode 100644 static/tutorials/media/png-to-pdf-settings.vtt diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index eaae8e491..2158366ec 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -62,23 +62,67 @@ indexing. See [Google's video indexing report documentation](https://support.goo context, a link back to the relevant article edition, and expandable on-screen instructions. Keep the article and watch page at their own canonical URLs. +## Plan and pace the recording + +Write a short sequence before recording: the task, each input, the visible +response, and the finished result. Rehearse the real interface first. A duration +limit is a ceiling, not time to fill with a stationary screen. + +- Keep the action and its result together. For drag and drop, show the press, + movement, drop target, release, and changed order. Do not substitute a button + click or edit away the middle of the gesture. +- Show how a setting is chosen and leave its selected value visible briefly. + Do not make values change while the cursor points somewhere else. +- Use one short instruction and one relevant visual cue at a time. Position + guidance near the action without covering labels, menus, or the drop target. + In silent clips, long text competes with watching the interface. +- Remove setup, hesitation, and waiting that teaches nothing. Keep enough time + to read the instruction and recognize the response; do not speed through a + gesture or chain several unexplained changes to meet a duration target. +- Use a tighter crop when a control would otherwise be unreadable, retaining + enough context to locate it. Avoid decorative zooms and constant cursor motion. +- Finish on the actual result. For a conversion, inspect and show the downloaded + file, with an explicit label when cutting from the app to a result preview. + Record the file in a real viewer and preserve its page layout. Identify the + viewer when its appearance matters, and state the settings that affect the + result. A custom side-by-side arrangement of separate PDF pages can mislead + readers about what they will see when opening the download. +- Review the final cut at normal speed and at the article's display size. Check + that a newcomer can identify the input and expected result at every step. + Re-time captions after editing, and keep pause, replay, and seeking available. + +These are our production choices informed by the following research; none of +these studies establishes an optimal duration for a sub-30-second silent clip: + +| Research | Finding and scope | Application here | +| --- | --- | --- | +| [Mayer & Moreno (2003), *Educational Psychologist*](https://doi.org/10.1207/S15326985EP3801_6) | Their multimedia-learning research describes limited processing capacity and benefits from removing irrelevant material and aligning explanations with visuals. | Short instructions, a focused capture, and guidance aligned with the current action. | +| [Rodemer et al. (2022), *Applied Cognitive Psychology*](https://doi.org/10.1002/acp.3973) | Timed signals improved attention and retention in an eye-tracking experiment with 28 chemistry students; this was not a software-tutorial trial. | Use selective, synchronized highlights as a design hypothesis, not a promise of improved learning. | +| [Gold, Zacks & Flores (2017), *Cognitive Research*](https://doi.org/10.1186/s41235-016-0043-2) | Cues at meaningful event boundaries supported memory for everyday activities. | Place cuts and instruction changes between completed actions, preserving each gesture. | +| [Garrett (2021), *British Journal of Educational Technology*](https://doi.org/10.1111/bjet.13000) | Imposed segmentation did not improve transfer or reduce cognitive load in the tested Excel tutorial; viewers used pause and rewind. | Preserve viewer control and purposeful short holds; avoid automatic long pauses at every step. | +| [Guo, Kim & Rubin (2014), ACM Learning at Scale](https://doi.org/10.1145/2556325.2566239) | This observational study of 6.9 million MOOC viewing sessions measured engagement proxies, not mastery; tutorial and lecture viewing differed. | Do not treat watch time, speed, or a specific clip length as proof that readers can perform the task. | + ## Files to use as the reference -The image tutorial is the existing example: +The image tutorial and PNG-to-PDF blog guides share the same player and watch-page layout: | File | Responsibility | | --- | --- | | [TutorialVideo.js](src/components/Video/TutorialVideo.js) | Shared playback behavior and `VideoObject` generated from the actual media URLs. | +| [RecordedVideo.js](src/components/Video/RecordedVideo.js) | Shared recording player and small **Open video →** action for any guide. | | [image-tutorial-videos.json](src/data/image-tutorial-videos.json) | Shared recording details, metadata, watch and guide paths, and on-screen instructions for both image editions. | -| [ImageTutorialVideo.js](src/components/Video/ImageTutorialVideo.js) | Reuses the same recording in the article and watch page; `showWatchLink` adds **Open video →** in the article. | -| [ImageWatchPage.js](src/components/Video/ImageWatchPage.js) and [its styles](src/components/Video/ImageWatchPage.module.css) | Watch-page layout, metadata, return link, transcript, and responsive presentation. | +| [png-pdf-videos.json](src/data/png-pdf-videos.json) | Recording details for the conversion and page-settings blog walkthroughs. | +| [ImageTutorialVideo.js](src/components/Video/ImageTutorialVideo.js) and [PngPdfVideo.js](src/components/Video/PngPdfVideo.js) | Thin article components that choose a recording; `showWatchLink` adds **Open video →**. | +| [VideoWatchPage.js](src/components/Video/VideoWatchPage.js) and [its styles](src/components/Video/VideoWatchPage.module.css) | Shared watch-page layout, metadata, return link, transcript, and responsive presentation. | | [Pro route](src/pages/videos/add-image-phoenix-pro.js) and [Community route](src/pages/videos/add-image-phoenix-community.js) | Separate `/videos/...` pages, one recording per page. | +| [PNG conversion route](src/pages/videos/convert-png-to-pdf.js) and [page-settings route](src/pages/videos/png-to-pdf-page-settings.js) | The same watch-page pattern linked to blog guides. | | [tutorial-media-manifest.json](scripts/tutorial-media-manifest.json) | Capture provenance, project, measured duration, and any requested duration limit. | | [verify-tutorials.cjs](scripts/verify-tutorials.cjs) | Checks the built tutorial pages, media, watch pages, and publication metadata. | -These `Image...` components and data are specific to the image tutorial. For a -different topic, adapt or generalize the pattern with appropriate names and -verification coverage. Do not put unrelated recordings into the image registry. +Keep each topic's recordings in its own data file. Reuse `RecordedVideo` and +`VideoWatchPage` with that data and add verification coverage. The `Image...` +wrappers remain specific to the image tutorial; do not put unrelated recordings +into its registry. ## Adding a recording and watch page @@ -108,7 +152,7 @@ verification coverage. Do not put unrelated recordings into the image registry. guide or edition. Confirm that the watch page has its own canonical URL and appears in the generated sitemap, with no indexing or crawl block. 6. Extend `scripts/verify-tutorials.cjs` for the new article and watch route. Its - `GUIDES` list and image-watch-page checks are explicit; it does not + `GUIDES`, `BLOGS`, and `WATCH_VIDEOS` lists are explicit; it does not automatically discover every new video page. Keep verification code in JavaScript and preserve the checks for shared metadata, links, captions, publication dates, and a single visible watch-page player. diff --git a/README.md b/README.md index 1240c2514..84dbbd14e 100644 --- a/README.md +++ b/README.md @@ -55,7 +55,7 @@ Before adding or changing a video, read the [video contributor notes](CONTRIBUTING.md#adding-or-updating-tutorial-videos) for the recording, article, watch-page, and metadata workflow. -Run these checks before releasing tutorial changes. They use JavaScript and +Run these checks before releasing tutorial or blog-media changes. They use JavaScript and require Node.js, Git, and the dependencies installed by `npm ci`. ```sh diff --git a/blog/2026-11-08-png-to-pdf-free-online/index.md b/blog/2026-11-08-png-to-pdf-free-online/index.md index d32f6824e..a55679d67 100644 --- a/blog/2026-11-08-png-to-pdf-free-online/index.md +++ b/blog/2026-11-08-png-to-pdf-free-online/index.md @@ -2,12 +2,14 @@ slug: how-to-convert-png-to-pdf-free-online title: "How to Convert PNG to PDF for Free Online" description: "Combine PNG images into one PDF in your browser. Arrange pages, choose paper settings and download without uploading your images or creating an account." +image: /tutorials/media/png-to-pdf-convert-poster.png date: 2026-11-08T06:00:00+05:30 authors: [charly] tags: [Tools, PDF] --- import '@site/src/css/png-pdf-guides.css'; +import PngPdfVideo from '@site/src/components/Video/PngPdfVideo';