Skip to content

Issue #7931 : Add a narrated video series renderer and the orientation episode - #9081

Draft
mattcasters wants to merge 8 commits into
apache:mainfrom
mattcasters:issue-7931
Draft

mattcasters wants to merge 8 commits into
apache:mainfrom
mattcasters:issue-7931

Conversation

@mattcasters

Copy link
Copy Markdown
Contributor

Draft for community feedback on the getting-started YouTube series. Addresses #7931.

This adds a renderer and the first episode, "What Apache Hop is". Nothing is uploaded to YouTube from this pull request.

What is here

  • docs/video-series/ holds the series notes, a pronunciation glossary, and the orientation manifest. The narration is in English, Chinese, Spanish (Mexico), Portuguese (Brazil), French, German, Italian, and Dutch.
  • The stills for that episode are included. Captures do not have to be exactly 1920x1080. The renderer fits each picture into that frame.
  • tools/video-series/render.py checks the manifest, synthesizes the voice-over, holds every scene for the longest language, and writes a 1080p MP4 plus WebVTT captions.

Product words such as Pipeline, Workflow, and Hop GUI stay in English in every language, because those are the words on screen. GUI is pronounced "gooey" through the speech service pronunciation map. The subtitles still show GUI.

Feedback that would help

  • The spoken script for this first episode.
  • Which languages belong in the first set of YouTube tracks.
  • Whether the Dutch track is worth keeping. The speech service documents German (de) and Italian (it). Dutch is sent as nl and is not on the published language list.
  • The shape of the later episodes: installation, pipelines, workflows, execution, projects and environments, version control, and security.

Not in this pull request

Episodes 02 through 08, the rendered MP4s, and the YouTube upload. Generated audio and video stay out of git.


Thank you for your contribution! Follow this checklist to help us incorporate your contribution quickly and easily:

  • Run mvn clean install apache-rat:check to make sure basic checks pass. A more thorough check will be performed on your pull request automatically.
  • If you have a group of commits related to the same change, please squash your commits into one and force push your branch using git rebase -i.
  • Mention the appropriate issue in your description (for example: addresses #123), if applicable.

To make clear that you license your contribution under the Apache License Version 2.0, January 2004
you have to acknowledge this by using the following check-box.

…ntation episode

The renderer turns a manifest, stills, and clips into timed voice-overs
and a 1080p video. The first episode explains what Apache Hop is, with
narration for the YouTube language tracks.
… cues

The second video covers Java 21, the download, and Configure Hop
environment, with narration for the YouTube language tracks. Subtitle
cues are now at most two lines, timed across each scene.
The third video builds a small pipeline in Hop GUI, from a samples
pipeline through a split hop and a preview, with narration for the
YouTube language tracks.
The fourth video builds a workflow that runs the first pipeline and
branches on success and failure, with narration for the YouTube
language tracks.
The fifth video runs the pipeline and the workflow in Hop GUI and with
hop-run, with narration for the YouTube language tracks.
…he join

The sixth video explains projects and environments, with narration for
the YouTube language tracks. A clip longer than the voice-over plays
to the end, and the scene join fades only the short overlap.
…uTube descriptions

The episode tracks the project folder in Git from Hop GUI. descriptions.yaml
holds the title, summary, link labels, and chapter titles for each language,
and the renderer writes one description file per locale.
…escriptions

The episode keeps the password out of the connection and out of Git. The
connection is named crm, and descriptions.yaml holds one description per language.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant