refactor(Documentation): Convert gifs to mp4s #3638
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
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.