Vídeo explicativo
Trabalhe a partir da raiz do repositório com uv run. O README.md contém os comandos e formatos de arquivo; o EDITORIAL.md é o padrão. Esta é a ordem de trabalho e onde estão os pontos de verificação do usuário.
0. A conversa, onde um vídeo começa
Os vídeos surgem do que o proprietário pensa, testado, não de uma lista de tópicos. Antes de qualquer pesquisa, entreviste-o.
- Uma ou duas perguntas por vez, em conversa simples e curta: o proprietário responde por ditado, e cinco de uma vez eram muitas para responder ou manter o fio. Ao longo das rodadas, misture os tipos: perguntas abertas ("o que cada lado está protegendo?"), quizzes que ele responde antes de você procurar a resposta ("qual parcela você diria?"), testes de aço ("apresente o caso do outro lado de modo que eles concordariam"), e iscas: a objeção mais forte ao que ele acabou de dizer, colocada de forma direta. Siga a resposta que te surpreendeu, não a próxima pergunta de uma lista.
- Os palpites errados do proprietário podem aparecer na tela: ele concordou com isso. Mas um número é um palpite dele apenas se ele o ofereceu como palpite. Um número dentro de um exemplo ("digamos que eles gastem 70% em contas...") é uma ilustração: registre-o como tal, nunca pontue ou mostre como palpite, e pergunte quando não estiver claro qual dos dois era.
- Escute a afirmação por trás da resposta: uma tese que pode estar errada, uma distinção que ele insiste em fazer, uma história dele mesmo. Esses são vídeos. Um tópico ("aborto") não é uma ideia; "os dois lados estão respondendo perguntas diferentes" é uma.
- Mantenha as palavras dele. Salve as respostas na íntegra e datadas em
notes/<tópico>.md, que o git ignora: as notas são brutas e privadas, e o roteiro é a forma publicada. Marque seus próprios resumos como seus. - Classifique o que ele disse pelo que o roteiro precisará. O que pode ser verificado vira pesquisa, depois batidas de
fact,estimateouview. O que é dele viraopinionouspeculation. Esclareça palavras carregadas de significado antes que avancem ("engenhado": por quem, e como saberíamos?), e diga a ele claramente quando as fontes não sustentam algo que ele acredita. - Pare quando houver uma tese, três ou quatro movimentos que a sustentam, e a objeção mais forte a ela. Reproduza isso em poucas linhas e obtenha um sim antes de pesquisar.
O proprietário quer como as coisas funcionam agora. De onde algo veio é uma breve digressão dentro de um vídeo, não o vídeo.
1. Pesquisa, antes de qualquer roteiro
- Estabeleça a pergunta que o vídeo responde em uma frase, e as três ou quatro coisas que um espectador deve ser capaz de dizer depois.
- Construa uma ficha de fatos: uma afirmação por linha, cada uma com uma fonte que foi buscada e lida nesta sessão e a passagem que a sustenta. Mantenha as fontes em
videos/NOME/sources.tomldesde o primeiro dia (uma pasta com apenas esse arquivo é um vídeo sendo pesquisado, ou pausado) e as afirmações emnotes/NOME.md. Pesquisar em um subagente é aceitável, mas diga a ele para retornar citações literais e marcar o que não conseguiu sustentar; nunca aceite uma URL que ele não abriu. - Para um tópico controverso, colete o caso de cada lado a partir de seus próprios defensores mais fortes, e anote quais discordâncias são sobre fatos e quais são sobre valores.
- Escreva o que as fontes NÃO sustentam. Versões populares de uma história são frequentemente mais arrumadas do que a evidência.
2. Roteiro (ponto de verificação: o usuário o aprova)
python -m explainers.new NOME(preenche em torno de umsources.tomlque já existe), depoisscript.md.- Um vídeo dura de 12 a 25 minutos: cerca de 2.100 a 4.400 palavras no ritmo de leitura do proprietário (cerca de 175 palavras por minuto com as pausas). Dê a ele seções que o espectador possa sentir a transição, cada uma com sua própria pergunta.
- Uma ideia por batida, uma batida por respiração: 15 a 40 palavras. Escreva para o ouvido: frases curtas, a palavra importante por último, números arredondados para o que um ouvinte consegue reter, sem colchetes ou abreviações.
- Abra com a pergunta ou a surpresa, não com uma saudação. Cada seção deve deixar o espectador querendo a próxima.
- Rotule pelo que a frase promete, não pelo quão certo você se sente. Divida uma batida que mistura tipos. Um roteiro que é principalmente
facteviewcom algumas batidasopinionclaramente marcadas é o objetivo;checkimprime a divisão. - Não escreva a
opiniondo canal sobre uma questão controversa você mesmo. Deixe uma lacuna marcada, ou rascunhe uma e diga claramente que é um rascunho para o usuário aceitar, alterar ou cortar. - Coloque uma nota
>sob cada seção dizendo o que está na tela. Toda batida precisa de uma imagem que mude pelo menos a cada cinco segundos ou mais. python -m explainers.check videos/NOME --urlsdeve passar. Mostre ao usuário o roteiro com a divisão e a lista de fontes.
3. Voz (ponto de verificação: o usuário a grava)
- Rascunhe com a voz sintética:
python -m explainers.narrate videos/NOME. Corrija as palavras que ela adivinhou emsay.txt. Adicionepausea uma batida quando sua imagem precisar de tempo para ser assimilada. As imagens podem ser construídas e o roteiro finalizado neste rascunho. - Quando a redação estiver finalizada, o usuário a grava em um terminal próprio:
python -m explainers.record videos/NOMEmostra cada batida, grava e verifica a tomada quanto ao nível e às palavras do roteiro.--roomgrava a sala vazia uma vez, para os intervalos. Depoisnarratenovamente: ele usa uma tomada onde houver uma nova. As imagens permanecem em suas palavras, já que as deixa são procuradas por palavra, mas as batidas mudam de duração: executesweepe veja uma folha de contato antes de renderizar. - O usuário não precisa ler palavra por palavra. Onde uma tomada se desvia do roteiro,
recordmostra a diferença e, se ele a mantiver, reescreve a batida em script.md para o que ele disse. Portanto, faça commit do roteiro antes de ele gravar e, depois, leiagit diffdele: corrija a ortografia e pontuação das novas palavras (isso não torna uma tomada obsoleta) e, para cadafact,estimateouviewalterado, leia a citação da fonte em comparação com as novas palavras. Se não as sustentar mais, avise o usuário: a batida é lida novamente ou reetiquetada, não deixada passar. - Reformular você mesmo uma batida gravada custa ao usuário uma nova leitura. Agrupe tais alterações e pergunte primeiro.
--audition VOICE ...compara vozes sintéticas para o rascunho; a linhavoice:do roteiro escolhe uma.
4. Imagens
- Comece a partir do
video.pydo modelo e substitua cena por cena. Uma cena por seção é a granularidade usual; corte entre elas comtheme.scenes. - Um vídeo acontece em um cenário (
explainers/sets.py): até agora uma sala de aula com uma tela de projetor, que foi o que o proprietário pediu. Desenhe um gráfico, um cartão ou uma figura como um slide, uma imagem de 1920x1080, e entregue ao cenário: o mesmo slide está na tela no plano geral e preenche o quadro quando a câmera se aproxima (sets.shotspara os movimentos). Aproxime quando o slide precisar ser lido, afaste quando o apresentador tiver algo a fazer, e desligue o projetor (on) quando o apresentador der um passo à frente com uma opinião. Coloque o título da seção no quadro (chalk) e dê à etiqueta umplatepara que seja legível sobre o ambiente. As notas>de um roteiro dizem "Amplo" ou "Projetor". Outros cenários virão: mantenha um slide livre do ambiente. - Pendure cada movimento em uma deixa:
N.at(batida, palavra). Nunca digite um tempo em segundos. - O apresentador é pequeno e de lado enquanto algo é explicado, e grande quando fala por si mesmo (abertura, opinião, fechamento). Ele olha e aponta para o que está sendo falado.
- Gráficos, gráficos e qualquer coisa matemática vão em um
Insertdo manim. Todo o resto é Skia. - Os lados de um argumento são
theme.SIDE_A/theme.SIDE_B. Um conjunto de dados que um gráfico desenha é salvo nodata/do vídeo com sua origem e data. - Loop:
previewuma seção, veja a folha, corrija, repita;sweepantes de cada renderização.
5. Renderizar e entregar (ponto de verificação: o usuário assiste)
python -m explainers.render videos/NOME --fresh, depoispython -m explainers.describe videos/NOME.- Relate o que foi verificado e o que não foi, qualquer batida cujo rótulo foi uma decisão subjetiva, e qualquer coisa que a voz diga de forma estranha.