Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 51 additions & 7 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
24 changes: 24 additions & 0 deletions blog/2026-11-08-png-to-pdf-free-online/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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';

<span className="png-pdf-guide-marker" hidden />

Expand All @@ -17,6 +19,12 @@ This guide walks through choosing images, arranging pages and saving the result.

<!-- truncate -->

## Watch a complete conversion

Follow along with **Try an example** in the converter. This walkthrough drags the parrot above the coastal picture, chooses **A4** with **10 mm** margins, and opens the downloaded PDF in Chrome's PDF viewer. Select **Choose PNG files** when you are ready to use your own images.

<PngPdfVideo topic="convert" showWatchLink />

## 1. Choose your PNG images

Open the [PNG to PDF converter](https://phcode.dev/tools/png-to-pdf.html), select **Choose PNG files**, and pick one or more still PNG images from your device. On a computer, you can also drop PNG files into the converter or paste PNG images from the clipboard.
Expand All @@ -38,6 +46,13 @@ Each image becomes one PDF page. The order of the cards is the order of the page

The card's action buttons retain their own actions. You can remove an unwanted image without restarting the whole batch.

<figure className="png-pdf-figure">
<a href="/tutorials/media/png-to-pdf-page-order.png" aria-label="Open full-size screenshot of the page order controls">
<img src="/tutorials/media/png-to-pdf-page-order.png" width="1088" height="691" loading="lazy" decoding="async" alt="Two sample PNGs appear as Page 1 and Page 2, each with Move up, Move down and Remove buttons." />
</a>
<figcaption>Drag the second card above the first to change the page order. Start from its preview, filename, or empty space; the buttons are separate actions.</figcaption>
</figure>

## 3. Choose paper and background settings

The settings affect every page, with automatic orientation determined separately for each image when a paper size is selected.
Expand All @@ -59,8 +74,17 @@ The page previews show orientation, margins and image placement. They use smalle

Select **Create PDF** and keep the browser tab open while it works. When the PDF is ready, select **Download PDF** to save it to your device. Open that downloaded file to check page order, readability and appearance before printing or sharing it.

Each picture is a separate page; your PDF viewer may show the pages one below another. If you keep **Fit to image**, the pages follow your images' dimensions instead of the A4 paper shown in the video.

Changing the page order or settings after creation requires creating the PDF again. Your original PNG files stay on your device.

<figure className="png-pdf-figure">
<a href="/tutorials/media/png-to-pdf-download-ready.png" aria-label="Open full-size screenshot of the finished conversion">
<img src="/tutorials/media/png-to-pdf-download-ready.png" width="1088" height="691" loading="lazy" decoding="async" alt="The parrot is now Page 1 and the coastal picture is Page 2. A4 and 10 mm margins are selected, and Download PDF is available." />
</a>
<figcaption>After Create PDF finishes, Download PDF saves the result. Open the saved file to check both pages.</figcaption>
</figure>

## How many images can you combine?

All of these limits apply together:
Expand Down
18 changes: 18 additions & 0 deletions blog/2026-11-08-png-to-pdf-quality/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,14 @@
slug: how-to-convert-png-to-pdf-without-losing-quality
title: "PNG to PDF Quality: Pixels, Color and Print Size"
description: "Understand PNG-to-PDF image quality: original pixels, bit depth, color profiles, transparency, stored print resolution and paper-size settings."
image: /tutorials/media/png-to-pdf-settings-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';

<span className="png-pdf-guide-marker" hidden />

Expand Down Expand Up @@ -53,8 +55,17 @@ These are arithmetic examples, not a guarantee that a particular image meets a p

Changing paper size does not create more detail. A larger placement spreads the same pixels over a larger area; a smaller placement brings them closer together.

<figure className="png-pdf-figure">
<img src="/tutorials/media/png-to-pdf-print-size.svg" width="880" height="408" loading="lazy" decoding="async" alt="The same 2400-pixel image provides 300 pixels per inch at 8 inches wide, or 200 pixels per inch at 12 inches wide." />
<figcaption>The longer line represents a wider print of the same image. Its pixel count has not increased.</figcaption>
</figure>

## Choose a page size for the intended use

The walkthrough starts with the converter's landscape sample already added. It shows the paper, margin and transparency choices, then shows the downloaded PDF in Chrome's PDF viewer. To follow along, choose **Try an example** in the [converter](https://phcode.dev/tools/png-to-pdf.html) and remove the coastal picture, leaving the parrot.

<PngPdfVideo topic="settings" showWatchLink />

### Fit to image

Use **Fit to image** when you want each PDF page sized from that image's pixel dimensions and stored print resolution. The tool uses the PNG's resolution information, falling back to valid EXIF resolution and then to 96 pixels per inch when no resolution is available. Selected margins add space around the image.
Expand All @@ -75,6 +86,13 @@ Choose **Transparent** to retain transparent image areas, or **White** to place

PDF readers usually display transparent pages on white. A white-looking page in a reader therefore does not, by itself, tell you whether image transparency was flattened. Check the downloaded PDF in the application where you intend to use it.

<figure className="png-pdf-figure">
<a href="/tutorials/media/png-to-pdf-a4-transparent.png" aria-label="Open full-size screenshot of the paper and transparency settings">
<img src="/tutorials/media/png-to-pdf-a4-transparent.png" width="1088" height="506" loading="lazy" decoding="async" alt="The converter shows A4, Automatic orientation, 10 mm margins and Transparent selected, alongside the landscape parrot preview." />
</a>
<figcaption>Use the preview to check placement and margins. Check the downloaded PDF for fine detail and its appearance in your intended viewer.</figcaption>
</figure>

## Check the downloaded PDF, not just the preview

The converter's small previews show page layout. They are not a full-resolution proof of fine detail or color.
Expand Down
77 changes: 73 additions & 4 deletions scripts/tutorial-media-manifest.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"captured_at": "2026-11-11",
"captured_at": "2026-11-12",
"product": "Phoenix Code for the web",
"product_url": "https://web.phcode.dev/",
"projects": {
Expand Down Expand Up @@ -50,7 +50,10 @@
"system_file_picker_recorded": false,
"duration_seconds": 26,
"duration_limit_seconds": 30,
"frame_size": [1120, 800],
"frame_size": [
1120,
800
],
"caption_placement": "Above the screen recording, clear of player controls"
},
{
Expand All @@ -62,7 +65,10 @@
"system_file_picker_recorded": false,
"duration_seconds": 28,
"duration_limit_seconds": 30,
"frame_size": [1120, 800],
"frame_size": [
1120,
800
],
"caption_placement": "Above the screen recording, clear of player controls"
},
{
Expand All @@ -74,8 +80,71 @@
"system_file_picker_recorded": false,
"duration_seconds": 24,
"duration_limit_seconds": 30,
"frame_size": [1120, 800],
"frame_size": [
1120,
800
],
"caption_placement": "Above the screen recording, clear of player controls"
},
{
"file": "static/tutorials/media/png-to-pdf-convert.mp4",
"product": "Phoenix Code PNG to PDF Converter",
"product_url": "https://phcode.dev/tools/png-to-pdf.html",
"project": "Built-in PNG-to-PDF examples",
"workflow": "Drag and drop two sample PNGs into page order, choose A4 with automatic orientation and 10 mm margins, then create and download the PDF. Check both saved pages in Chrome's PDF viewer.",
"captured_at": "2026-11-12T03:21:35.247Z",
"on_screen_instructions": true,
"highlighted_controls": true,
"system_file_picker_recorded": false,
"duration_seconds": 19.966667,
"duration_limit_seconds": 30,
"frame_size": [
1000,
860
],
"caption_placement": "Instruction strip above the converter or PDF viewer, clear of the controls",
"verification": [
"Downloaded PDF contains 2 pages",
"Landscape source remains 480 by 320 pixels in the PDF",
"Native dropdown choices captured from the actual browser",
"Captions aligned to visible instruction changes in the final encoded video",
"No browser page errors during recording",
"Pointer press, drag and release reorder the actual cards from 1,2 to 2,1 without Move up buttons",
"Downloaded PDF order is landscape parrot, then portrait coastal picture",
"Downloaded PDF opened in the Chromium PDF viewer; recorded file matches the download byte for byte",
"Actual continuous scroll changes the PDF viewer page indicator from 1 of 2 to 2 of 2"
],
"presentation": "Real converter interface and native menus, followed by the actual downloaded file opened in the Chromium PDF viewer; original page layout preserved",
"result_captured_at": "2026-11-12T05:43:48.021Z"
},
{
"file": "static/tutorials/media/png-to-pdf-settings.mp4",
"product": "Phoenix Code PNG to PDF Converter",
"product_url": "https://phcode.dev/tools/png-to-pdf.html",
"project": "Built-in PNG-to-PDF examples",
"workflow": "Choose A4, 10 mm margins and transparent image areas using the converter menus. Create and download the PDF, then check the saved landscape page in Chrome's PDF viewer.",
"captured_at": "2026-11-12T03:22:50.609Z",
"on_screen_instructions": true,
"highlighted_controls": true,
"system_file_picker_recorded": false,
"duration_seconds": 11.433333,
"duration_limit_seconds": 30,
"frame_size": [
1000,
640
],
"caption_placement": "Instruction strip above the converter or PDF viewer, clear of the controls",
"verification": [
"Downloaded PDF contains 1 page",
"Landscape source remains 480 by 320 pixels in the PDF",
"Native dropdown choices captured from the actual browser",
"Captions aligned to visible instruction changes in the final encoded video",
"No browser page errors during recording",
"Transparent source retains an alpha mask in the downloaded PDF",
"Downloaded PDF opened in the Chromium PDF viewer; recorded file matches the download byte for byte"
],
"presentation": "Real converter interface and native menus, followed by the actual downloaded file opened in the Chromium PDF viewer; original page layout preserved",
"result_captured_at": "2026-11-12T05:45:27.346Z"
}
],
"sample_photo": {
Expand Down
Loading
Loading