Skip to content

refactor(Documentation): Convert gifs to mp4s #3638

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

jconley88
Copy link

Motivation

I wanted to review the jekyll documentation but I found it difficult to read. The gif screencasts are helpful, but don't meet accessibility guidelines. They detract from learning due to the auto-play and looping, and are inconsistent with similar style screencasts formatted as video.

Implementation

I converted all jekyll/images/*.gif files to mp4 with:

ffmpeg -i filename.gif -movflags faststart -pix_fmt yuv420p -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" filename.mp4

retaining the same dimensions and quality while reducing file size. I chose to keep the width for all videos at 100% for consistency. This causes some slight stretching/blurring for videos on the rails add on page when on large screens. Some of the original gifs were only 640px wide out of ~740px full width.

Automated Tests

N/A

Manual Tests

I reviewed every affected markdown file to ensure nothing else inadvertently changed. I reviewed and verified every mp4.

Thank you

I appreciate your time on this project, thank you.

@jconley88 jconley88 requested a review from a team as a code owner July 1, 2025 17:54
Copy link

graphite-app bot commented Jul 1, 2025

How to use the Graphite Merge Queue

Add the label graphite-merge to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

@jconley88
Copy link
Author

I have signed the CLA!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant