~/

ESL compare and contrast grade 3 teaching examples vocabulary conversation questions

~/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c

python - <<'PY' from pypdf import PdfReader p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260920-WA0005.pdf' r=PdfReader(p) print('PAGES',len(r.pages)) for i,page in enumerate(r.pages): text=page.extract_text() or '' print('\n--- PAGE',i+1,'---\n',text[:12000]) PY

mkdir -p "/tmp/workspace/esl-compare-handbook/assets" "/tmp/workspace/esl-compare-handbook/output" "/tmp/workspace/esl-compare-handbook/src" && python - <<'PY' import fitz p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260920-WA0005.pdf' doc=fitz.open(p) for i,page in enumerate(doc): pix=page.get_pixmap(matrix=fitz.Matrix(2,2), alpha=False) pix.save(f'/tmp/workspace/esl-compare-handbook/assets/source_page_{i+1}.png') PY ls -lh "/tmp/workspace/esl-compare-handbook/assets"

python - <<'PY' import importlib.util for x in ['pdf2image','wand','PIL','pymupdf','PyMuPDF','ocrmypdf','cv2']: print(x,importlib.util.find_spec(x)) from pypdf import PdfReader p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260920-WA0005.pdf' r=PdfReader(p) for n,page in enumerate(r.pages,1): print('page',n,'images',len(list(page.images))) for j,im in enumerate(page.images): out=f'/tmp/workspace/esl-compare-handbook/assets/p{n}_{j}_{im.name}' with open(out,'wb') as f:f.write(im.data) print(out, len(im.data)) PY ls -lh "/tmp/workspace/esl-compare-handbook/assets"

python - <<'PY' from PIL import Image import pytesseract, os for f in ['/tmp/workspace/esl-compare-handbook/assets/p1_0_Im0.jpg','/tmp/workspace/esl-compare-handbook/assets/p2_0_Im0.jpg']: im=Image.open(f) print(f, im.size) try: print(pytesseract.image_to_string(im)[:10000]) except Exception as e: print(type(e).__name__,e) PY

which tesseract || true; python - <<'PY' from PIL import Image for f in ['/tmp/workspace/esl-compare-handbook/assets/p1_0_Im0.jpg','/tmp/workspace/esl-compare-handbook/assets/p2_0_Im0.jpg']: im=Image.open(f); print(f,im.size,im.mode) PY

python - <<'PY' from PIL import Image for i in [1,2]: im=Image.open(f'/tmp/workspace/esl-compare-handbook/assets/p{i}_0_Im0.jpg') im.thumbnail((768,992)) im.save(f'/tmp/workspace/esl-compare-handbook/assets/preview_{i}.png') PY

python - <<'PY' import importlib.util for x in ['easyocr','keras_ocr','transformers','rapidocr_onnxruntime','paddleocr','surya']: print(x, bool(importlib.util.find_spec(x))) PY

Inspect the attached PDF at /tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260920-WA0005.pdf. It appears scanned/images. Extract and report every readable word, vocabulary item, examples, and main learning material. You may inspect embedded image files or use any tools. Return a concise structured content inventory only, no file creation.

~/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c

python - <<'PY' from pypdf import PdfReader p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260920-WA0005.pdf' r=PdfReader(p) print('pages',len(r.pages), 'meta',r.metadata) for i,x in enumerate(r.pages): print(i+1, repr(x.extract_text()[:1000] if x.extract_text() else ''), 'images',len(list(x.images))) PY python - <<'PY' import fitz, os p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260920-WA0005.pdf'; out='/tmp/pdfinspect' os.makedirs(out,exist_ok=True) d=fitz.open(p) for i,page in enumerate(d): pix=page.get_pixmap(matrix=fitz.Matrix(2.5,2.5), alpha=False) fn=f'{out}/page-{i+1}.png'; pix.save(fn) print(fn, pix.width,pix.height) PY ls -lh /tmp/pdfinspect

python - <<'PY' from pypdf import PdfReader import os p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260920-WA0005.pdf'; out='/tmp/pdfinspect' os.makedirs(out,exist_ok=True) r=PdfReader(p) for n,page in enumerate(r.pages,1): for j,img in enumerate(page.images,1): ext=img.name.rsplit('.',1)[-1] fn=f'{out}/page-{n}-img-{j}.{ext}' open(fn,'wb').write(img.data) print(fn,len(img.data)) PY python - <<'PY' import importlib.util for x in ['PIL','pytesseract','cv2','pdf2image','wand','pymupdf']: print(x,importlib.util.find_spec(x)) PY file /tmp/pdfinspect/*; ls -lh /tmp/pdfinspect

which tesseract || true; python - <<'PY' import importlib.util for x in ['easyocr','keras_ocr','rapidocr_onnxruntime','paddleocr','transformers','torch']: print(x, bool(importlib.util.find_spec(x))) PY python - <<'PY' from PIL import Image for f in ['/tmp/pdfinspect/page-1-img-1.jpg','/tmp/pdfinspect/page-2-img-1.jpg']: im=Image.open(f); print(f,im.size) # upscale fixed im.resize((im.width*2,im.height*2)).save(f+'.png') PY ls -lh /tmp/pdfinspect

python - <<'PY' from PIL import Image,ImageEnhance,ImageFilter import os out='/tmp/pdfcrops';os.makedirs(out,exist_ok=True) for pg in (1,2): im=Image.open(f'/tmp/pdfinspect/page-{pg}-img-1.jpg') # sections as full width blocks sequential top/down upscaled for j in range(4): cr=im.crop((0,j*496,1536,min((j+1)*496,1984))).resize((3072,992)) cr.save(f'{out}/p{pg}_{j+1}.jpg',quality=95) PY ls -lh /tmp/pdfcrops

pip install --quiet rapidocr_onnxruntime && python - <<'PY' from rapidocr_onnxruntime import RapidOCR ocr=RapidOCR() for p in ['/tmp/pdfinspect/page-1-img-1.jpg','/tmp/pdfinspect/page-2-img-1.jpg']: result, elapse=ocr(p) print('\n###',p,elapse) for row in result or []: print(row[1],row[2]) PY

python - <<'PY' from rapidocr_onnxruntime import RapidOCR from PIL import Image,ImageEnhance,ImageFilter ocr=RapidOCR() for pg in (1,2): im=Image.open(f'/tmp/pdfinspect/page-{pg}-img-1.jpg').resize((4608,5952)) im=ImageEnhance.Contrast(im).enhance(1.4) f=f'/tmp/pdfinspect/x{pg}.png';im.save(f) r,_=ocr(f) print('\n### PAGE',pg) for x in r or []: print(x[1]) PY

fc-match 'DejaVu Sans' | head -1; cat > "/tmp/workspace/esl-compare-handbook/src/create_handbook.py" <<'PY' from reportlab.lib.pagesizes import A4 from reportlab.lib import colors from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle from reportlab.lib.enums import TA_CENTER, TA_LEFT from reportlab.lib.units import cm from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, Table, TableStyle, PageBreak, KeepTogether from reportlab.pdfbase import pdfmetrics from reportlab.pdfbase.ttfonts import TTFont from reportlab.pdfgen import canvas from reportlab.lib.colors import HexColor OUT='/tmp/workspace/esl-compare-handbook/output/Compare_and_Contrast_ESL_Handbook_EN_RU.pdf' FONT='/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf' FONTB='/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf' pdfmetrics.registerFont(TTFont('DV',FONT)); pdfmetrics.registerFont(TTFont('DVB',FONTB)) NAVY=HexColor('#183B5B'); TEAL=HexColor('#1B9AAA'); SKY=HexColor('#DDF4F5'); YELLOW=HexColor('#FFD166'); CORAL=HexColor('#EF6F6C'); PURPLE=HexColor('#7158A6'); PALE=HexColor('#F8FAFC'); GREEN=HexColor('#DFF3E4'); PINK=HexColor('#FCE4EC'); GRAY=HexColor('#475569') styles=getSampleStyleSheet() styles.add(ParagraphStyle(name='TitleX',fontName='DVB',fontSize=29,leading=34,textColor=NAVY,alignment=TA_CENTER,spaceAfter=10)) styles.add(ParagraphStyle(name='SubX',fontName='DV',fontSize=13,leading=18,textColor=GRAY,alignment=TA_CENTER)) styles.add(ParagraphStyle(name='H1X',fontName='DVB',fontSize=21,leading=25,textColor=NAVY,spaceAfter=8)) styles.add(ParagraphStyle(name='H2X',fontName='DVB',fontSize=14,leading=18,textColor=PURPLE,spaceBefore=7,spaceAfter=4)) styles.add(ParagraphStyle(name='BodyX',fontName='DV',fontSize=10.5,leading=14.5,textColor=NAVY)) styles.add(ParagraphStyle(name='SmallX',fontName='DV',fontSize=8.8,leading=11.5,textColor=GRAY)) styles.add(ParagraphStyle(name='RusX',fontName='DV',fontSize=9.2,leading=12,textColor=PURPLE)) styles.add(ParagraphStyle(name='CenterX',fontName='DVB',fontSize=13,leading=17,textColor=NAVY,alignment=TA_CENTER)) def P(t,style='BodyX'): return Paragraph(t,styles[style]) def box(title, eng, rus, bg=SKY): data=[[P(title,'H2X')],[P(eng)],[P('<b>Русский:</b> '+rus,'RusX')]] t=Table(data,colWidths=[17.5*cm]); t.setStyle(TableStyle([('BACKGROUND',(0,0),(-1,-1),bg),('BOX',(0,0),(-1,-1),0.6,HexColor('#B5C7D8')),('LEFTPADDING',(0,0),(-1,-1),10),('RIGHTPADDING',(0,0),(-1,-1),10),('TOPPADDING',(0,0),(-1,-1),5),('BOTTOMPADDING',(0,0),(-1,-1),5)])) return t def footer(c,doc): c.saveState(); c.setFillColor(NAVY); c.rect(0,0,A4[0],0.48*cm,stroke=0,fill=1) c.setFont('DV',8); c.setFillColor(colors.white); c.drawString(1.4*cm,0.16*cm,'Unit 2: Animal Adventures | English + Русский') c.drawRightString(A4[0]-1.4*cm,0.16*cm,f'{doc.page}') c.restoreState() doc=SimpleDocTemplate(OUT,pagesize=A4,rightMargin=1.55*cm,leftMargin=1.55*cm,topMargin=1.35*cm,bottomMargin=1.15*cm) story=[] # cover story += [Spacer(1,1.5*cm),P('COMPARE &amp; CONTRAST','TitleX'),P('СРАВНИВАЕМ И НАХОДИМ РАЗЛИЧИЯ','SubX'),Spacer(1,.45*cm)] cover=Table([[P('Easy English Handbook<br/><font size="12">for ESL Grade 3</font>','CenterX'),P('🐦 &nbsp; 🐱<br/><font size="12">Leo, Lily, Hugo &amp; Ivan</font>','CenterX')]],colWidths=[8.7*cm,8.7*cm],rowHeights=[3.1*cm]) cover.setStyle(TableStyle([('BACKGROUND',(0,0),(0,0),SKY),('BACKGROUND',(1,0),(1,0),YELLOW),('BOX',(0,0),(-1,-1),1,NAVY),('VALIGN',(0,0),(-1,-1),'MIDDLE'),('LEFTPADDING',(0,0),(-1,-1),10),('RIGHTPADDING',(0,0),(-1,-1),10)])) story += [cover,Spacer(1,.75*cm),box('What you will learn','• Animal words from the story<br/>• How to compare: tell what is the same<br/>• How to contrast: tell what is different<br/>• How to answer 20 simple questions','• Слова о животных из истории<br/>• Как сравнивать: говорить, что одинаково<br/>• Как находить различия: говорить, что разное<br/>• Как отвечать на 20 простых вопросов',GREEN),Spacer(1,.65*cm),P('<b>Remember:</b> Good readers look for things that are the same and things that are different.','CenterX'),Spacer(1,.1*cm),P('<b>Помни:</b> Хорошие читатели находят то, что одинаково, и то, что отличается.','SubX'),PageBreak()] # vocab pages vocab=[('berries','small, sweet fruit, for example strawberries.','ягоды - маленькие сладкие фрукты, например клубника.'),('hunt','to look for and catch food.','охотиться - искать и ловить еду.'),('worm','a long, thin animal that lives in the ground.','червь - длинное тонкое животное, которое живёт в земле.'),('escape','to get away from a place or danger.','убежать, спастись - уйти от места или опасности.'),('creep','to move very slowly and quietly.','красться - двигаться очень медленно и тихо.'),('fight','to hit or try to hurt someone or something.','драться - бить или пытаться причинить вред кому-то или чему-то.'),('peck','to hit food with a bird’s beak.','клевать - ударять по еде клювом.'),('pinecone','the brown, woody part that grows on a pine tree.','сосновая шишка - коричневая твёрдая часть, которая растёт на сосне.'),('squawk','to make a loud, rough bird sound.','громко кричать (о птице) - издавать громкий резкий звук.')] story += [P('1. Animal Word Bank','H1X'),P('Say each word. Read the meaning. Then use the example sentence.','BodyX'),P('Произнеси каждое слово. Прочитай значение. Затем используй пример.','RusX'),Spacer(1,.22*cm)] examples=['Birds eat berries.','Foxes hunt for food.','A worm lives underground.','The bird can escape from the open window.','Cats creep quietly.'] for (w,e,r),ex in zip(vocab[:5],examples): t=Table([[P('<b>'+w+'</b>','H2X'),P(e+'<br/><font color="#7158A6">Русский: '+r+'</font>','BodyX'),P('<i>Example:</i> '+ex+'<br/><font color="#7158A6">Пример: '+{'Birds eat berries.':'Птицы едят ягоды.','Foxes hunt for food.':'Лисы охотятся за едой.','A worm lives underground.':'Червь живёт под землёй.','The bird can escape from the open window.':'Птица может улететь через открытое окно.','Cats creep quietly.':'Кошки тихо крадутся.'}[ex]+'</font>','SmallX')]],colWidths=[3*cm,8.0*cm,6.5*cm]) t.setStyle(TableStyle([('BACKGROUND',(0,0),(0,-1),YELLOW),('BACKGROUND',(1,0),(-1,-1),PALE),('GRID',(0,0),(-1,-1),.35,HexColor('#CBD5E1')),('VALIGN',(0,0),(-1,-1),'MIDDLE'),('LEFTPADDING',(0,0),(-1,-1),7),('RIGHTPADDING',(0,0),(-1,-1),7),('TOPPADDING',(0,0),(-1,-1),6),('BOTTOMPADDING',(0,0),(-1,-1),6)])) story += [t,Spacer(1,.15*cm)] story += [PageBreak(),P('1. Animal Word Bank, continued','H1X'),Spacer(1,.15*cm)] examples2=['The dog and cat fight.','The bird pecks at its food.','A pinecone grows on a pine tree.','Parrots can squawk loudly.'] rusEx=['Собака и кошка дерутся.','Птица клюёт свою еду.','Сосновая шишка растёт на сосне.','Попугаи могут громко кричать.'] for (w,e,r),ex,rx in zip(vocab[5:],examples2,rusEx): t=Table([[P('<b>'+w+'</b>','H2X'),P(e+'<br/><font color="#7158A6">Русский: '+r+'</font>','BodyX'),P('<i>Example:</i> '+ex+'<br/><font color="#7158A6">Пример: '+rx+'</font>','SmallX')]],colWidths=[3*cm,8.0*cm,6.5*cm]) t.setStyle(TableStyle([('BACKGROUND',(0,0),(0,-1),CORAL),('BACKGROUND',(1,0),(-1,-1),PALE),('GRID',(0,0),(-1,-1),.35,HexColor('#CBD5E1')),('VALIGN',(0,0),(-1,-1),'MIDDLE'),('LEFTPADDING',(0,0),(-1,-1),7),('RIGHTPADDING',(0,0),(-1,-1),7),('TOPPADDING',(0,0),(-1,-1),7),('BOTTOMPADDING',(0,0),(-1,-1),7)])) story += [t,Spacer(1,.22*cm)] story += [box('Quick practice','A bird can <b>peck</b> at berries. A cat can <b>creep</b> quietly. A bird may <b>escape</b> from danger.','Птица может <b>клевать</b> ягоды. Кошка может тихо <b>красться</b>. Птица может <b>спастись</b> от опасности.',PINK),PageBreak()] # method story += [P('2. Compare and Contrast','H1X'),box('Compare = Same','When we <b>compare</b>, we tell how two things are the same.<br/><b>Signal words:</b> both, same, like, also','Когда мы <b>сравниваем</b>, мы говорим, чем две вещи похожи.<br/><b>Слова-подсказки:</b> both (оба), same (одинаковый), like (как), also (тоже)',GREEN),Spacer(1,.32*cm),box('Contrast = Different','When we <b>contrast</b>, we tell how two things are different.<br/><b>Signal words:</b> but, different, while, however','Когда мы <b>находим различия</b>, мы говорим, чем две вещи отличаются.<br/><b>Слова-подсказки:</b> but (но), different (разный), while (в то время как), however (однако)',PINK),Spacer(1,.32*cm),P('Easy Steps','H2X')] steps=[('1. Look','Look at two people, animals, or things.','Посмотри на двух людей, животных или предметы.'),('2. Ask','What is the same? What is different?','Что одинаково? Что отличается?'),('3. Sort','Put same facts in the middle. Put different facts on the sides.','Положи одинаковые факты в середину. Разные факты - по сторонам.'),('4. Say','Make a sentence with both or but.','Составь предложение с both (оба) или but (но).')] for a,b,c in steps: story += [Table([[P(a,'H2X'),P(b+'<br/><font color="#7158A6">Русский: '+c+'</font>','BodyX')]],colWidths=[2.4*cm,15.1*cm],style=[('BACKGROUND',(0,0),(0,0),YELLOW),('BACKGROUND',(1,0),(1,0),SKY),('BOX',(0,0),(-1,-1),.4,HexColor('#B5C7D8')),('VALIGN',(0,0),(-1,-1),'MIDDLE'),('LEFTPADDING',(0,0),(-1,-1),8),('RIGHTPADDING',(0,0),(-1,-1),8),('TOPPADDING',(0,0),(-1,-1),5),('BOTTOMPADDING',(0,0),(-1,-1),5)]),Spacer(1,.13*cm)] story += [Spacer(1,.1*cm),box('Helpful sentence frames','• Both ___ and ___ are ___.<br/>• ___ is ___, but ___ is ___.<br/>• ___ has ___, while ___ has ___.','• И ___, и ___ являются ___.<br/>• ___ является ___, но ___ является ___.<br/>• У ___ есть ___, в то время как у ___ есть ___.',SKY),PageBreak()] # text example story += [P('3. Our Story Example','H1X'),P('Read slowly. Then find the same and different facts.','BodyX'),P('Читай медленно. Затем найди одинаковые и разные факты.','RusX'),Spacer(1,.18*cm)] quote='Hugo and Ivan are ten years old. Hugo lives in a big house in the country and Ivan lives in a small apartment in the city. They both have pets. Hugo has a big dog and Ivan has a small goldfish.' story += [box('Read','“'+quote+'”','«Хьюго и Ивану по десять лет. Хьюго живёт в большом доме за городом, а Иван живёт в маленькой квартире в городе. У них обоих есть домашние животные. У Хьюго большая собака, а у Ивана маленькая золотая рыбка.»',SKY),Spacer(1,.3*cm)] data=[[P('HUGO','CenterX'),P('BOTH<br/>ОБА','CenterX'),P('IVAN','CenterX')],[P('big house<br/>in the country<br/><font color="#7158A6">большой дом<br/>за городом</font>','BodyX'),P('ten years old<br/>have pets<br/><font color="#7158A6">десять лет<br/>есть питомцы</font>','BodyX'),P('small apartment<br/>in the city<br/><font color="#7158A6">маленькая квартира<br/>в городе</font>','BodyX')],[P('big dog<br/><font color="#7158A6">большая собака</font>','BodyX'),P('','BodyX'),P('small goldfish<br/><font color="#7158A6">маленькая золотая рыбка</font>','BodyX')]] t=Table(data,colWidths=[5.8*cm]*3,rowHeights=[1.1*cm,3.0*cm,1.45*cm]);t.setStyle(TableStyle([('BACKGROUND',(0,0),(0,0),CORAL),('BACKGROUND',(1,0),(1,0),YELLOW),('BACKGROUND',(2,0),(2,0),TEAL),('BACKGROUND',(0,1),(0,-1),PINK),('BACKGROUND',(1,1),(1,-1),GREEN),('BACKGROUND',(2,1),(2,-1),SKY),('GRID',(0,0),(-1,-1),.7,NAVY),('VALIGN',(0,0),(-1,-1),'MIDDLE'),('ALIGN',(0,0),(-1,0),'CENTER'),('LEFTPADDING',(0,0),(-1,-1),8),('RIGHTPADDING',(0,0),(-1,-1),8),('TOPPADDING',(0,0),(-1,-1),6),('BOTTOMPADDING',(0,0),(-1,-1),6)])) story += [t,Spacer(1,.28*cm),box('Say it!','<b>Compare:</b> Hugo and Ivan are both ten years old. They both have pets.<br/><b>Contrast:</b> Hugo has a big dog, but Ivan has a small goldfish.','<b>Сравнение:</b> Хьюго и Ивану обоим по десять лет. У них обоих есть питомцы.<br/><b>Различие:</b> У Хьюго большая собака, но у Ивана маленькая золотая рыбка.',YELLOW),PageBreak()] # practice story += [P('4. Mini Practice','H1X'),P('Use the animal words. Read each pair. Say one same fact and one different fact.','BodyX'),P('Используй слова о животных. Прочитай каждую пару. Скажи один одинаковый и один разный факт.','RusX'),Spacer(1,.2*cm)] practice=[('Cat and bird','Both are animals.','A cat can creep quietly, but a bird can squawk loudly.','И кошка, и птица - животные.','Кошка может тихо красться, но птица может громко кричать.'),('Dog and goldfish','Both can be pets.','A dog is big, but a goldfish is small.','И собака, и золотая рыбка могут быть питомцами.','Собака большая, но золотая рыбка маленькая.'),('Bird and worm','Both are animals.','A bird can peck, but a worm lives underground.','И птица, и червь - животные.','Птица может клевать, но червь живёт под землёй.')] for title,same,diff,rs,rd in practice: story += [box(title,'<b>Same:</b> '+same+'<br/><b>Different:</b> '+diff,'<b>Одинаковое:</b> '+rs+'<br/><b>Разное:</b> '+rd, PINK if title=='Cat and bird' else (GREEN if title=='Dog and goldfish' else SKY)),Spacer(1,.22*cm)] story += [P('Your turn','H2X'),box('Try this','Compare a pinecone and a berry. Think: What is the same? What is different?<br/><b>Possible answer:</b> Both come from nature. A pinecone is hard, but a berry is soft and sweet.','Сравни шишку и ягоду. Подумай: Что одинаково? Что отличается?<br/><b>Возможный ответ:</b> И то, и другое встречается в природе. Шишка твёрдая, но ягода мягкая и сладкая.',YELLOW),PageBreak()] # conversation pages qs=[ ('What are berries?','Berries are small, sweet fruits.','Что такое ягоды?','Ягоды - это маленькие сладкие фрукты.'), ('What does a bird do with its beak?','A bird pecks at its food with its beak.','Что птица делает своим клювом?','Птица клюёт еду своим клювом.'), ('Where does a worm live?','A worm lives in the ground.','Где живёт червь?','Червь живёт в земле.'), ('Why do some animals hunt?','They hunt to find food.','Почему некоторые животные охотятся?','Они охотятся, чтобы найти еду.'), ('Can a cat creep quietly?','Yes, a cat can creep very quietly.','Может ли кошка тихо красться?','Да, кошка может очень тихо красться.'), ('What can a bird do when it is in danger?','It can escape from danger.','Что птица может сделать, когда она в опасности?','Она может спастись от опасности.'), ('What grows on a pine tree?','A pinecone grows on a pine tree.','Что растёт на сосне?','На сосне растёт шишка.'), ('What sound can a parrot make?','A parrot can squawk loudly.','Какой звук может издавать попугай?','Попугай может громко кричать.'), ('Do a dog and a cat sometimes fight?','Yes, they can fight.','Собака и кошка иногда дерутся?','Да, они могут драться.'), ('What is one way a cat and a bird are the same?','Both a cat and a bird are animals.','Чем кошка и птица похожи?','И кошка, и птица - животные.'), ('What is one way a cat and a bird are different?','A cat can creep, but a bird can squawk.','Чем кошка и птица отличаются?','Кошка может красться, но птица может громко кричать.'), ('How old are Hugo and Ivan?','Hugo and Ivan are both ten years old.','Сколько лет Хьюго и Ивану?','Хьюго и Ивану обоим по десять лет.'), ('Where does Hugo live?','Hugo lives in a big house in the country.','Где живёт Хьюго?','Хьюго живёт в большом доме за городом.'), ('Where does Ivan live?','Ivan lives in a small apartment in the city.','Где живёт Иван?','Иван живёт в маленькой квартире в городе.'), ('What is the same about Hugo and Ivan?','They both have pets.','Что одинаково у Хьюго и Ивана?','У них обоих есть домашние животные.'), ('What pet does Hugo have?','Hugo has a big dog.','Какой питомец у Хьюго?','У Хьюго большая собака.'), ('What pet does Ivan have?','Ivan has a small goldfish.','Какой питомец у Ивана?','У Ивана маленькая золотая рыбка.'), ('How are Hugo’s and Ivan’s homes different?','Hugo has a big house, but Ivan has a small apartment.','Чем дома Хьюго и Ивана отличаются?','У Хьюго большой дом, но у Ивана маленькая квартира.'), ('How are Hugo’s and Ivan’s pets different?','Hugo has a big dog, but Ivan has a small goldfish.','Чем питомцы Хьюго и Ивана отличаются?','У Хьюго большая собака, но у Ивана маленькая золотая рыбка.'), ('Which words help us compare and contrast?','Both helps us compare. But helps us contrast.','Какие слова помогают нам сравнивать и находить различия?','Both помогает сравнивать. But помогает находить различия.')] for pg, group in enumerate([qs[:10],qs[10:]],1): story += [P(f'5. Conversation Practice ({"1-10" if pg==1 else "11-20"})','H1X'),P('Read the question. Cover the answer. Then answer aloud.','BodyX'),P('Прочитай вопрос. Закрой ответ. Затем ответь вслух.','RusX'),Spacer(1,.13*cm)] rows=[] for i,(q,a,rq,ra) in enumerate(group, (1 if pg==1 else 11)): content=P(f'<b>{i}. Q:</b> {q}<br/><font color="#7158A6"><b>Вопрос:</b> {rq}</font><br/><b>A:</b> {a}<br/><font color="#7158A6"><b>Ответ:</b> {ra}</font>','SmallX') rows.append([content]) t=Table(rows,colWidths=[17.5*cm]) t.setStyle(TableStyle([('BACKGROUND',(0,0),(-1,-1),PALE),('BACKGROUND',(0,0),(-1,0),SKY),('GRID',(0,0),(-1,-1),.4,HexColor('#CBD5E1')),('LEFTPADDING',(0,0),(-1,-1),9),('RIGHTPADDING',(0,0),(-1,-1),9),('TOPPADDING',(0,0),(-1,-1),4.5),('BOTTOMPADDING',(0,0),(-1,-1),4.5),('VALIGN',(0,0),(-1,-1),'MIDDLE')])) story += [t] if pg==1: story += [PageBreak()] # end a=box('Well done!','Now you can use <b>both</b> to say what is the same and <b>but</b> to say what is different.','Теперь ты можешь использовать <b>both</b>, чтобы сказать, что одинаково, и <b>but</b>, чтобы сказать, что отличается.',GREEN) story += [Spacer(1,.25*cm),a] doc.build(story,onFirstPage=footer,onLaterPages=footer) print(OUT) PY python "/tmp/workspace/esl-compare-handbook/src/create_handbook.py" ls -lh "/tmp/workspace/esl-compare-handbook/output/Compare_and_Contrast_ESL_Handbook_EN_RU.pdf"

fc-match -f '%{file}\n' 'Noto Sans:style=Regular' | head -1; fc-match -f '%{file}\n' 'Noto Sans:style=Bold' | head -1

python - <<'PY' p='/tmp/workspace/esl-compare-handbook/src/create_handbook.py' s=open(p).read() s=s.replace("FONT='/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf'\nFONTB='/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf'", "FONT='/usr/share/fonts/google-noto-vf/NotoSans[wght].ttf'\nFONTB='/usr/share/fonts/google-noto-vf/NotoSans[wght].ttf'") open(p,'w').write(s) PY python "/tmp/workspace/esl-compare-handbook/src/create_handbook.py" python - <<'PY' from pypdf import PdfReader p='/tmp/workspace/esl-compare-handbook/output/Compare_and_Contrast_ESL_Handbook_EN_RU.pdf' r=PdfReader(p) print('pages=',len(r.pages),'size=',__import__('os').path.getsize(p)) for i,pg in enumerate(r.pages): t=pg.extract_text() or '' print(i+1,len(t),t[:55].replace('\n',' | ')) PY

~/

ESL vocabulary teaching daily life example sentences best practices young learners

~/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c

mkdir -p "/tmp/workspace/esl-vocabulary-handbook/assets" "/tmp/workspace/esl-vocabulary-handbook/src" "/tmp/workspace/esl-vocabulary-handbook/output"; python - <<'PY' from pypdf import PdfReader p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260920-WA0011 (1).pdf' r=PdfReader(p) print('PAGES:',len(r.pages)) for i,page in enumerate(r.pages,1): print('\n--- PAGE',i,'TEXT ---\n', (page.extract_text() or '')[:8000]) print('IMAGES',len(list(page.images))) for j,im in enumerate(page.images): out=f'/tmp/workspace/esl-vocabulary-handbook/assets/page_{i}_img_{j}_{im.name}' open(out,'wb').write(im.data) print(out) PY ls -lh "/tmp/workspace/esl-vocabulary-handbook/assets"

cat > "/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py" <<'PY' from reportlab.lib.pagesizes import A4 from reportlab.lib import colors from reportlab.lib.colors import HexColor from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle from reportlab.lib.enums import TA_CENTER from reportlab.lib.units import cm from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, Table, TableStyle, PageBreak, KeepTogether from reportlab.pdfbase import pdfmetrics from reportlab.pdfbase.ttfonts import TTFont from reportlab.lib.utils import ImageReader from reportlab.pdfgen import canvas import os BASE='/tmp/workspace/esl-vocabulary-handbook' OUT=BASE+'/output/Love_and_Relationships_Vocabulary_Handbook_EN_RU.pdf' FONT='/usr/share/fonts/google-noto-vf/NotoSans[wght].ttf' pdfmetrics.registerFont(TTFont('Noto',FONT)); pdfmetrics.registerFont(TTFont('NotoBold',FONT)) NAVY=HexColor('#12355B'); BLUE=HexColor('#1F78B4'); LIGHTBLUE=HexColor('#E5F4FE'); TEAL=HexColor('#14A6A6'); YELLOW=HexColor('#FFE28A'); CORAL=HexColor('#F9C6C2'); LAV=HexColor('#EEE8FF'); MINT=HexColor('#E0F4E9'); INK=HexColor('#263B50'); PALE=HexColor('#F8FBFD') S=getSampleStyleSheet() def style(name,size,lead,color=INK,bold=False,align=None,space=0): S.add(ParagraphStyle(name=name,fontName='NotoBold' if bold else 'Noto',fontSize=size,leading=lead,textColor=color,alignment=align or 0,spaceAfter=space)) style('Title',27,33,NAVY,True,TA_CENTER,10);style('Sub',12,16,BLUE,False,TA_CENTER);style('H1',20,25,NAVY,True,None,7);style('H2',13,16,BLUE,True,None,4);style('Body',9.7,13.1,INK);style('Rus',9,12.3,HexColor('#5D3C91'));style('Tiny',8.25,10.7,INK);style('Center',13,16,NAVY,True,TA_CENTER) def P(x,s='Body'): return Paragraph(x,S[s]) def footer(c,doc): c.saveState();c.setFillColor(NAVY);c.rect(0,0,A4[0],.45*cm,stroke=0,fill=1);c.setFillColor(colors.white);c.setFont('Noto',7.5);c.drawString(1.35*cm,.14*cm,'Love & Relationships: Vocabulary Handbook | English + Русский');c.drawRightString(A4[0]-1.35*cm,.14*cm,str(doc.page));c.restoreState() def callout(title,en,ru,bg=LIGHTBLUE): t=Table([[P(title,'H2')],[P(en,'Body')],[P('<b>Русский:</b> '+ru,'Rus')]],colWidths=[17.5*cm]) t.setStyle(TableStyle([('BACKGROUND',(0,0),(-1,-1),bg),('BOX',(0,0),(-1,-1),.6,HexColor('#ACC7DD')),('LEFTPADDING',(0,0),(-1,-1),9),('RIGHTPADDING',(0,0),(-1,-1),9),('TOPPADDING',(0,0),(-1,-1),5),('BOTTOMPADDING',(0,0),(-1,-1),5)]));return t def term_card(term,meaning,ru,examples,bg=LIGHTBLUE): ex='<br/>'.join([f'<b>{i+1}.</b> {e}<br/><font color="#5D3C91">{r}</font>' for i,(e,r) in enumerate(examples)]) data=[[P(term,'H2')],[P('<b>Meaning:</b> '+meaning+'<br/><font color="#5D3C91"><b>Перевод:</b> '+ru+'</font>','Body')],[P('<b>Daily-life examples</b><br/>'+ex,'Tiny')]] t=Table(data,colWidths=[17.5*cm]);t.setStyle(TableStyle([('BACKGROUND',(0,0),(-1,0),bg),('BACKGROUND',(0,1),(-1,-1),PALE),('BOX',(0,0),(-1,-1),.55,HexColor('#B6CCDA')),('LEFTPADDING',(0,0),(-1,-1),8),('RIGHTPADDING',(0,0),(-1,-1),8),('TOPPADDING',(0,0),(-1,-1),4),('BOTTOMPADDING',(0,0),(-1,-1),4)]));return t # vocabulary: two blue boxes inferred as speaking phrases and grammar phrasal verbs A=[ ('go through rough times','to experience a difficult period.','переживать трудные времена.', [('My family went through rough times last year.','Моя семья переживала трудные времена в прошлом году.'),('Friends can help you go through rough times.','Друзья могут помочь тебе пережить трудные времена.'),('Every team goes through rough times sometimes.','Каждая команда иногда переживает трудные времена.')]), ('cling on to the dream','to keep hoping for something strongly, even when it is difficult.','держаться за мечту; продолжать сильно надеяться.', [('She clings on to the dream of becoming a doctor.','Она держится за мечту стать врачом.'),('He clung on to the dream of visiting London.','Он держался за мечту посетить Лондон.'),('Do not cling on to a dream that makes you unhappy.','Не держись за мечту, которая делает тебя несчастным.')]), ('step in and guide us','to become involved and give help or direction.','вмешаться и направить нас; прийти на помощь и дать совет.', [('The teacher stepped in and guided the group.','Учитель вмешался и направил группу.'),('My aunt stepped in to help us choose a hotel.','Моя тётя вмешалась, чтобы помочь нам выбрать отель.'),('A coach can step in when players disagree.','Тренер может вмешаться, когда игроки не согласны.')]), ('narrow down users’ choices','to reduce many options to a smaller number.','сузить выбор пользователей.', [('The menu helps us narrow down our choices.','Меню помогает нам сузить выбор.'),('We narrowed down the schools to three.','Мы сузили выбор школ до трёх.'),('This list narrows down the best buses.','Этот список сужает выбор лучших автобусов.')]), ('carry out scans','to perform medical or technical scans.','проводить сканирование.', [('Doctors carried out scans at the hospital.','Врачи провели сканирование в больнице.'),('The clinic will carry out scans tomorrow.','Клиника проведёт сканирование завтра.'),('Scientists carry out brain scans for research.','Учёные проводят сканирование мозга для исследования.')]), ('parts of the brain lit up','areas of the brain became active in a scan.','участки мозга активировались.', [('When she heard music, parts of her brain lit up.','Когда она услышала музыку, участки её мозга активировались.'),('The scan showed that parts of the brain lit up.','Сканирование показало, что участки мозга активировались.'),('Different parts of the brain light up during reading.','Разные участки мозга активируются во время чтения.')]), ('boil down to our willingness','to have one main cause: whether we are ready to do something.','сводиться к нашей готовности.', [('Success may boil down to our willingness to practise.','Успех может сводиться к нашей готовности практиковаться.'),('It boils down to your willingness to listen.','Всё сводится к твоей готовности слушать.'),('The choice boils down to our willingness to change.','Выбор сводится к нашей готовности меняться.')]), ('talk through the issue','to discuss a problem carefully until it is understood or solved.','обсудить проблему подробно.', [('Let’s talk through the issue after class.','Давай обсудим проблему после урока.'),('They talked through the issue calmly.','Они спокойно обсудили проблему.'),('We can talk through the issue with Mum.','Мы можем обсудить проблему с мамой.')]),] B=[ ('account for','to explain or be the reason for something.','объяснять; составлять часть чего-либо.', [('Bad weather accounts for the delay.','Плохая погода объясняет задержку.'),('Food accounts for most of our budget.','Еда составляет большую часть нашего бюджета.'),('How do you account for this mistake?','Как ты объяснишь эту ошибку?')]), ('agree on','to have the same opinion about a plan or decision.','договориться о; прийти к согласию.', [('We agreed on a time to meet.','Мы договорились о времени встречи.'),('The family agreed on a movie.','Семья договорилась, какой фильм посмотреть.'),('Can we agree on the rules?','Можем ли мы договориться о правилах?')]), ('back up','to support someone or save a copy of information.','поддерживать; создавать резервную копию.', [('I will back you up in the meeting.','Я поддержу тебя на встрече.'),('Please back up your photos.','Пожалуйста, создай резервную копию фотографий.'),('Her friends backed her up.','Её друзья поддержали её.')]), ('call off','to cancel something planned.','отменить.', [('They called off the picnic because of rain.','Они отменили пикник из-за дождя.'),('The school called off the game.','Школа отменила игру.'),('We had to call off our visit.','Нам пришлось отменить наш визит.')]), ('cater for','to provide what a person or group needs.','учитывать потребности; обслуживать.', [('This café caters for children.','Это кафе учитывает потребности детей.'),('The course caters for beginners.','Курс подходит для начинающих.'),('The hotel caters for families.','Отель обслуживает семьи.')]), ('come between','to cause trouble between people or separate them.','встать между; испортить отношения.', [('Do not let a small problem come between friends.','Не позволяй маленькой проблеме встать между друзьями.'),('Money can come between family members.','Деньги могут испортить отношения между членами семьи.'),('A misunderstanding came between them.','Недоразумение встало между ними.')]), ('draw on','to use something such as knowledge, support, or experience.','использовать; опираться на.', [('Draw on your notes for the test.','Используй свои заметки для теста.'),('She drew on her experience.','Она опиралась на свой опыт.'),('We draw on our friends for support.','Мы опираемся на друзей для поддержки.')]), ('fend for','to take care of yourself without help.','заботиться о себе самостоятельно.', [('He can fend for himself now.','Он теперь может заботиться о себе сам.'),('Children slowly learn to fend for themselves.','Дети постепенно учатся заботиться о себе сами.'),('I learned to fend for myself at college.','Я научился заботиться о себе сам в колледже.')]), ('get into','to become involved in or interested in something.','ввязываться; заинтересоваться.', [('She got into a long conversation.','Она увлеклась долгим разговором.'),('Do not get into an argument online.','Не ввязывайся в спор в интернете.'),('He got into reading last summer.','Прошлым летом он увлёкся чтением.')]), ('go through with','to do something that you had planned, especially something difficult.','довести до конца; осуществить.', [('She went through with the plan.','Она осуществила план.'),('Are you ready to go through with it?','Ты готов довести это до конца?'),('He did not go through with the move.','Он не осуществил переезд.')]), ('keep from','to prevent someone from doing something.','удерживать от; не давать.', [('Rain kept us from playing outside.','Дождь не дал нам играть на улице.'),('Nothing can keep her from learning.','Ничто не может удержать её от учёбы.'),('The noise kept me from sleeping.','Шум не дал мне уснуть.')]), ('move on','to continue with life or start a new stage.','двигаться дальше.', [('After the mistake, move on and try again.','После ошибки двигайся дальше и попробуй снова.'),('It is time to move on to the next task.','Пора перейти к следующему заданию.'),('She moved on after the argument.','Она пошла дальше после ссоры.')]), ('read up on','to read a lot in order to learn about a topic.','почитать, чтобы узнать больше о.', [('I read up on the city before our trip.','Я почитал о городе перед нашей поездкой.'),('Read up on the rules first.','Сначала почитай о правилах.'),('She is reading up on healthy food.','Она читает о здоровой еде.')]), ('see through','to support someone during a difficult time.','поддержать и помочь пережить трудный период.', [('My friends saw me through a hard week.','Мои друзья помогли мне пережить трудную неделю.'),('Her family saw her through the illness.','Её семья помогла ей пережить болезнь.'),('This job saw him through university.','Эта работа помогла ему закончить университет.')]), ('split up','to end a romantic relationship or separate into parts.','расстаться; разделиться.', [('The two friends split up after the concert.','Два друга разошлись после концерта.'),('The group split up to find the teacher.','Группа разделилась, чтобы найти учителя.'),('The couple decided to split up.','Пара решила расстаться.')] ] article=[ ('Fred and Doreen Wilson are not your average husband and wife. In fact, having just celebrated their 75th wedding anniversary, they may well enjoy the nation’s longest-lasting marriage. Fred says there is no great secret: they get on well, respect each other, and each has their own source of happiness. They do their own things to keep life fresh. He says that during rough times, changing partners rarely leaves people better off.','Фред и Дорин Уилсон - не обычные муж и жена. Они только что отметили 75-ю годовщину свадьбы и, возможно, состоят в самом долгом браке в стране. Фред говорит, что большого секрета нет: они хорошо ладят, уважают друг друга, и у каждого есть свой источник счастья. Они занимаются своими делами, чтобы жизнь оставалась свежей. Он считает, что в трудные времена смена партнёра редко делает людей счастливее.'), ('In many countries, four out of ten marriages end in divorce. Devotion, patience and perseverance can seem old-fashioned, but people still hold on to the dream of finding a life partner. Long relationships may also matter because marital breakdown can have social and financial costs.','Во многих странах четыре из десяти браков заканчиваются разводом. Преданность, терпение и настойчивость могут казаться старомодными, но люди всё ещё держатся за мечту найти спутника жизни. Долгие отношения также важны, потому что распад брака может иметь социальные и финансовые последствия.'), ('Science and technology are increasingly used to guide people in finding a partner. Free dating apps let people match with a swipe, but their results in finding a long-term partner are hit and miss. Paid sites use detailed questionnaires and algorithms to narrow down users’ choices.','Наука и технологии всё чаще помогают людям найти партнёра. Бесплатные приложения для знакомств позволяют людям совпадать одним движением пальца, но их результаты в поиске долгосрочного партнёра непредсказуемы. Платные сайты используют подробные анкеты и алгоритмы, чтобы сузить выбор пользователей.'), ('Other researchers question whether people really know what they want. In speed-dating research, people’s stated preferences were different from the people they actually chose to date.','Другие исследователи сомневаются, действительно ли люди знают, чего хотят. В исследовании быстрых свиданий заявленные предпочтения людей отличались от людей, с которыми они действительно решили встречаться.'), ('Neuroscientists carried out scans on people deeply in love. When they saw pictures of a beloved person, areas linked to reward, desire, euphoria and addiction lit up. An area linked to fear became less active, so people may drop their guard and become blind to a partner’s faults. When they focused on faults, the love activity tapered off.','Нейробиологи провели сканирование людей, которые были глубоко влюблены. Когда они видели фотографии любимого человека, активировались области, связанные с наградой, желанием, эйфорией и зависимостью. Область, связанная со страхом, становилась менее активной, поэтому люди могут терять бдительность и не замечать недостатков партнёра. Когда они сосредотачивались на недостатках, активность любви снижалась.'), ('Falling in love may boil down to a willingness to see good in people, but experiences and circumstances also matter. A date can fail because bad weather creates a bad mood. Some researchers say love should be built, not simply found.','Влюблённость может сводиться к готовности видеть в людях хорошее, но опыт и обстоятельства тоже важны. Свидание может не получиться, потому что плохая погода создаёт плохое настроение. Некоторые исследователи говорят, что любовь нужно строить, а не просто находить.'), ('Social scientists study long-lasting couples. Such couples show desire and respect, talk through problems without making them personal, and do not try to solve problems by text message. They celebrate good news, have activities together, keep their own friendships, and find happiness within themselves. The article says research offers insights, but it cannot answer every question about love, marriage and separation.','Социологи изучают пары с долгими отношениями. Такие пары проявляют желание и уважение, подробно обсуждают проблемы, не переходя на личности, и не пытаются решать проблемы через сообщения. Они празднуют хорошие новости, занимаются чем-то вместе, сохраняют собственные дружеские связи и находят счастье в себе. В статье говорится, что исследования дают полезные идеи, но не могут ответить на все вопросы о любви, браке и расставании.')] doc=SimpleDocTemplate(OUT,pagesize=A4,leftMargin=1.55*cm,rightMargin=1.55*cm,topMargin=1.3*cm,bottomMargin=1.1*cm) story=[Spacer(1,1.05*cm),P('LOVE &amp; RELATIONSHIPS','Title'),P('VOCABULARY HANDBOOK','Title'),P('English meanings, Russian translations, and daily-life examples','Sub'),P('Значения на английском, перевод на русский и примеры из повседневной жизни','Sub'),Spacer(1,.5*cm)] cover=Table([[P('BLUE BOX 1<br/><font size="11">Key phrases from the reading lesson</font>','Center'),P('BLUE BOX 2<br/><font size="11">Phrasal verbs for relationships</font>','Center')]],colWidths=[8.75*cm,8.75*cm],rowHeights=[3*cm]);cover.setStyle(TableStyle([('BACKGROUND',(0,0),(0,0),LIGHTBLUE),('BACKGROUND',(1,0),(1,0),LAV),('BOX',(0,0),(-1,-1),1,NAVY),('VALIGN',(0,0),(-1,-1),'MIDDLE')])) story += [cover,Spacer(1,.55*cm),callout('How to use this handbook','Read the phrase, learn the meaning, and say the three examples aloud. Use one sentence about your own life.','Прочитай фразу, выучи значение и произнеси вслух три примера. Используй одно предложение о своей жизни.',MINT),Spacer(1,.5*cm),P('Source material: “Can Science Cure Our Heartache?”','Center'),P('Материал: «Может ли наука вылечить нашу душевную боль?»','Sub'),PageBreak()] for title,items,color in [('1. Blue Box 1: Key Reading Phrases',A,LIGHTBLUE),('2. Blue Box 2: Phrasal Verbs',B,LAV)]: story += [P(title,'H1'),P('Meaning in English, Russian translation, and three practical examples for each item.','Body'),Spacer(1,.14*cm)] for idx,x in enumerate(items): story += [term_card(*x,bg=color),Spacer(1,.14*cm)] # page break strategically after around 3 cards through built-in flow allows splitting story += [PageBreak()] # Remove trailing blank? okay story += [P('3. Article: Easy Meaning + Russian Translation','H1'),P('The article text is rewritten in clear English. The Russian translation is directly under each part.','Body'),P('Текст статьи пересказан простым английским языком. Русский перевод находится сразу под каждой частью.','Rus'),Spacer(1,.18*cm)] for i,(en,ru) in enumerate(article,1): story += [callout(f'Article part {i}',en,ru, LIGHTBLUE if i%2 else MINT),Spacer(1,.18*cm)] story += [PageBreak(),P('4. Review and Speak','H1'),callout('Say these sentences about your life','1. I can <b>go through rough times</b> with support from my family.<br/>2. I can <b>talk through an issue</b> calmly.<br/>3. I can <b>agree on</b> a plan with my friends.<br/>4. I can <b>draw on</b> my experience.<br/>5. After a mistake, I can <b>move on</b>.','1. Я могу <b>переживать трудные времена</b> при поддержке семьи.<br/>2. Я могу спокойно <b>обсудить проблему</b>.<br/>3. Я могу <b>договориться о</b> плане с друзьями.<br/>4. Я могу <b>опираться на</b> свой опыт.<br/>5. После ошибки я могу <b>двигаться дальше</b>.',YELLOW),Spacer(1,.3*cm),callout('Quick reminder','Phrasal verbs are common in everyday English. Learn them as complete phrases: <b>agree on a plan</b>, <b>call off a visit</b>, <b>read up on a topic</b>.','Фразовые глаголы часто встречаются в повседневном английском. Учи их как целые фразы: <b>agree on a plan</b>, <b>call off a visit</b>, <b>read up on a topic</b>.',CORAL)] doc.build(story,onFirstPage=footer,onLaterPages=footer) print(OUT) PY python "/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py" python - <<'PY' from pypdf import PdfReader import os p='/tmp/workspace/esl-vocabulary-handbook/output/Love_and_Relationships_Vocabulary_Handbook_EN_RU.pdf' r=PdfReader(p);print('Pages',len(r.pages),'Bytes',os.path.getsize(p)) for i,pg in enumerate(r.pages): tx=pg.extract_text() or '' print(i+1,len(tx),tx[:60].replace('\n',' | ')) PY

python - <<'PY' p='/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py' for n,l in enumerate(open(p),1): if 55<=n<=60: print(n,repr(l)) PY

~/esl-vocabulary-handbook/src/create_handbook.py

python "/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py" && python - <<'PY' from pypdf import PdfReader import os p='/tmp/workspace/esl-vocabulary-handbook/output/Love_and_Relationships_Vocabulary_Handbook_EN_RU.pdf' r=PdfReader(p); print('pages',len(r.pages),'bytes',os.path.getsize(p)) for i,pg in enumerate(r.pages,1): tx=pg.extract_text() or '' print(i,len(tx),tx[:75].replace('\n',' | ')) PY

python - <<'PY' p='/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py' s=open(p).read() for a,b in [('Title','XTitle'),('Sub','XSub')]: s=s.replace("style('"+a+"'", "style('"+b+"'") s=s.replace("'"+a+"')", "'"+b+"')") open(p,'w').write(s) PY python "/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py" && python - <<'PY' from pypdf import PdfReader import os p='/tmp/workspace/esl-vocabulary-handbook/output/Love_and_Relationships_Vocabulary_Handbook_EN_RU.pdf' r=PdfReader(p); print('pages',len(r.pages),'bytes',os.path.getsize(p)) for i,pg in enumerate(r.pages,1): tx=pg.extract_text() or '' print(i,len(tx),tx[:70].replace('\n',' | ')) PY

python - <<'PY' from pypdf import PdfReader p='/tmp/workspace/esl-vocabulary-handbook/output/Love_and_Relationships_Vocabulary_Handbook_EN_RU.pdf' r=PdfReader(p) for i in [6,7,8,9]: print('\n--PAGE',i,'--') print((r.pages[i-1].extract_text() or '')[:3000]) PY

~/esl-vocabulary-handbook/src/create_handbook.py

rm -f "/tmp/workspace/esl-vocabulary-handbook/output/Love_and_Relationships_Vocabulary_Handbook_EN_RU.pdf"; python "/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py" && python - <<'PY' from pypdf import PdfReader import os p='/tmp/workspace/esl-vocabulary-handbook/output/Love_and_Relationships_Vocabulary_Handbook_EN_RU.pdf' r=PdfReader(p) print('pages',len(r.pages),'bytes',os.path.getsize(p)) for i,pg in enumerate(r.pages,1): t=pg.extract_text() or '' print(f'{i}: {len(t)} chars | {t[:65].replace(chr(10)," | ")}') PY

~/

Can Science Cure Our Heartache article love science lesson

~/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c

python - <<'PY' from pypdf import PdfReader p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260922-WA0000.pdf' r=PdfReader(p) print('pages',len(r.pages)) for i,p in enumerate(r.pages,1): t=p.extract_text() or '' print('\nPAGE',i,'\n',t[:6000]) PY

cp "/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py" "/tmp/workspace/esl-vocabulary-handbook/src/create_revised_handbook.py" && python - <<'PY' p='/tmp/workspace/esl-vocabulary-handbook/src/create_revised_handbook.py' s=open(p).read() s=s.replace("OUT=BASE+'/output/Love_and_Relationships_Vocabulary_Handbook_EN_RU.pdf'", "OUT=BASE+'/output/Can_Science_Cure_Our_Heartache_EN_RU_Revised.pdf'") # Replace cover title/subtitle in full existing generated script s=s.replace("P('LOVE &amp; RELATIONSHIPS','XTitle'),P('VOCABULARY HANDBOOK','XTitle'),P('English meanings, Russian translations, and daily-life examples','XSub'),P('Значения на английском, перевод на русский и примеры из повседневной жизни','XSub')", "P('CAN SCIENCE CURE OUR HEARTACHE?','XTitle'),P('МОЖЕТ ЛИ НАУКА ИЗЛЕЧИТЬ НАШУ ДУШЕВНУЮ БОЛЬ?','XSub'),P('Vocabulary handbook: English meanings, Russian translations, and daily-life examples','XSub'),P('Справочник по лексике: значения на английском, перевод на русский и примеры из повседневной жизни','XSub')") # remove blue-box title headings and their explanatory subtitle from loop, but preserve cards and all translations. old="for title,items,color in [('1. Blue Box 1: Key Reading Phrases',A,LIGHTBLUE),('2. Blue Box 2: Phrasal Verbs',B,LAV)]:\n story += [P(title,'H1'),P('Meaning in English, Russian translation, and three practical examples for each item.','Body'),Spacer(1,.14*cm)]" new="for title,items,color in [('first vocabulary set',A,LIGHTBLUE),('second vocabulary set',B,LAV)]:\n story += [Spacer(1,.08*cm)]" assert old in s s=s.replace(old,new) # Change footer title for coherence s=s.replace("'Love & Relationships: Vocabulary Handbook | English + Русский'", "'Can Science Cure Our Heartache? | English + Русский'") # cover blue labels are also removed, swapped for gentle topic visual rather than blue-box headings s=s.replace("P('BLUE BOX 1<br/><font size=\"11\">Key phrases from the reading lesson</font>','Center'),P('BLUE BOX 2<br/><font size=\"11\">Phrasal verbs for relationships</font>','Center')", "P('Useful phrases<br/><font size=\"11\">Meanings + three daily-life examples</font>','Center'),P('Phrasal verbs<br/><font size=\"11\">Meanings + three daily-life examples</font>','Center')") # Update source line s=s.replace("P('Source material: “Can Science Cure Our Heartache?”','Center'),P('Материал: «Может ли наука вылечить нашу душевную боль?»','XSub')", "P('Can Science Cure Our Heartache?','Center'),P('Может ли наука излечить нашу душевную боль?','XSub')") open(p,'w').write(s) PY python "/tmp/workspace/esl-vocabulary-handbook/src/create_revised_handbook.py" python - <<'PY' from pypdf import PdfReader from pathlib import Path p=Path('/tmp/workspace/esl-vocabulary-handbook/output/Can_Science_Cure_Our_Heartache_EN_RU_Revised.pdf') r=PdfReader(str(p)) print('exists',p.exists(),'pages',len(r.pages),'bytes',p.stat().st_size) txt='\n'.join(pg.extract_text() or '' for pg in r.pages) for phrase in ['Blue Box 1','Blue Box 2','CAN SCIENCE CURE OUR HEARTACHE?','МОЖЕТ ЛИ НАУКА ИЗЛЕЧИТЬ НАШУ ДУШЕВНУЮ БОЛЬ?','переживать трудные времена']: print(phrase, phrase in txt) PY

~/

British English text to speech voice slow speech MP3 offline Python edge-tts

~/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c

mkdir -p "/tmp/workspace/heartache-audio/src" "/tmp/workspace/heartache-audio/output"; python - <<'PY' from pypdf import PdfReader p='/tmp/workspace/attachments/79bbcb79-445c-4cc4-8654-3e7cfb97079c/DOC-20260922-WA0003.pdf' r=PdfReader(p) print('PAGES',len(r.pages)) for i,page in enumerate(r.pages,1): print('\n--- PAGE',i,'---') print((page.extract_text() or '')[:12000]) PY

python - <<'PY' import importlib.util for x in ['edge_tts','pydub']: print(x, bool(importlib.util.find_spec(x))) PY which ffmpeg || true python - <<'PY' import ast p='/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py' t=ast.parse(open(p,encoding='utf-8').read()) for n in t.body: if isinstance(n,ast.Assign) and any(isinstance(x,ast.Name) and x.id in ('A','B') for x in n.targets): vals=ast.literal_eval(n.value) print('items',len(vals),vals[0][0],vals[-1][0]) PY

pip install --user edge-tts

mkdir -p "/tmp/workspace/heartache-audio/deps" && pip install --target "/tmp/workspace/heartache-audio/deps" edge-tts

cat > "/tmp/workspace/heartache-audio/src/generate_audio.py" <<'PY' import sys, os, ast, asyncio, shutil sys.path.insert(0, '/tmp/workspace/heartache-audio/deps') import edge_tts SRC='/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py' OUT='/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Slow.mp3' TMP='/tmp/workspace/heartache-audio/tmp' os.makedirs(TMP,exist_ok=True) # Retrieve exact bilingual vocabulary plus examples used in the handbook source. tree=ast.parse(open(SRC,encoding='utf-8').read()) sets=[] for node in tree.body: if isinstance(node,ast.Assign) and any(isinstance(x,ast.Name) and x.id in {'A','B'} for x in node.targets): sets.extend(ast.literal_eval(node.value)) def clean(s): return s.replace('’', "'").replace('–','-') def eng_script(i,term,meaning,ru,examples): lines=[f'Item {i}.', term+'.', 'Meaning in English.', meaning, 'Daily life examples.'] for j,(e,r) in enumerate(examples,1): lines += [f'Example {j}.',clean(e)] return '\n'.join(lines) def ru_script(i,term,meaning,ru,examples): lines=[f'Пункт {i}.', f'Выражение: {term}.', 'Перевод.', ru, 'Примеры из повседневной жизни.'] for j,(e,r) in enumerate(examples,1): lines += [f'Пример {j}.',r] return '\n'.join(lines) async def say(text, voice, path): # Deliberately slow, clear pace for language learners. c=edge_tts.Communicate(text, voice=voice, rate='-18%', pitch='+0Hz', volume='+0%') await c.save(path) async def main(): files=[] intro_en="Can science cure our heartache? Vocabulary practice. Listen carefully. For each expression, you will hear the English phrase, the English meaning, and three daily life examples. Then you will hear the Russian translation and the Russian versions of the examples. The British English speech is slow and clear." intro_ru="Может ли наука излечить нашу душевную боль? Практика лексики. Для каждого выражения вы услышите английскую фразу, объяснение на английском и три примера из повседневной жизни. Затем вы услышите перевод на русский язык и русские версии примеров." await say(intro_en,'en-GB-SoniaNeural',f'{TMP}/000_en.mp3'); files.append(f'{TMP}/000_en.mp3') await say(intro_ru,'ru-RU-SvetlanaNeural',f'{TMP}/001_ru.mp3'); files.append(f'{TMP}/001_ru.mp3') n=2 for i,item in enumerate(sets,1): term,meaning,ru,examples=item ep=f'{TMP}/{n:03d}_en.mp3'; rp=f'{TMP}/{n+1:03d}_ru.mp3' await say(eng_script(i,term,meaning,ru,examples),'en-GB-SoniaNeural',ep) await say(ru_script(i,term,meaning,ru,examples),'ru-RU-SvetlanaNeural',rp) files += [ep,rp]; n+=2 print(f'completed {i}/{len(sets)}: {term}', flush=True) ending_en='End of vocabulary practice. You can replay the audio and repeat each example aloud.' ending_ru='Конец практики лексики. Вы можете прослушать аудио ещё раз и повторить каждый пример вслух.' ep=f'{TMP}/{n:03d}_en.mp3';rp=f'{TMP}/{n+1:03d}_ru.mp3' await say(ending_en,'en-GB-SoniaNeural',ep);await say(ending_ru,'ru-RU-SvetlanaNeural',rp);files +=[ep,rp] # Sequential MPEG streams are universally accepted by common MP3 players. with open(OUT,'wb') as out: for f in files: with open(f,'rb') as inp: shutil.copyfileobj(inp,out) print(OUT) asyncio.run(main()) PY python "/tmp/workspace/heartache-audio/src/generate_audio.py" ls -lh "/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Slow.mp3"

python - <<'PY' p='/tmp/workspace/heartache-audio/src/generate_audio.py' s=open(p).read() s=s.replace("async def say(text, voice, path):\n # Deliberately slow, clear pace for language learners.\n c=edge_tts.Communicate(text, voice=voice, rate='-18%', pitch='+0Hz', volume='+0%')\n await c.save(path)", "async def say(text, voice, path):\n # Deliberately slow, clear pace for language learners. Resume any segment already made.\n if os.path.exists(path) and os.path.getsize(path) > 500:\n return\n c=edge_tts.Communicate(text, voice=voice, rate='-18%', pitch='+0Hz', volume='+0%')\n await c.save(path)") s=s.replace(" await say(eng_script(i,term,meaning,ru,examples),'en-GB-SoniaNeural',ep)\n await say(ru_script(i,term,meaning,ru,examples),'ru-RU-SvetlanaNeural',rp)", " await asyncio.gather(say(eng_script(i,term,meaning,ru,examples),'en-GB-SoniaNeural',ep), say(ru_script(i,term,meaning,ru,examples),'ru-RU-SvetlanaNeural',rp))") s=s.replace(" await say(ending_en,'en-GB-SoniaNeural',ep);await say(ending_ru,'ru-RU-SvetlanaNeural',rp);files +=[ep,rp]", " await asyncio.gather(say(ending_en,'en-GB-SoniaNeural',ep),say(ending_ru,'ru-RU-SvetlanaNeural',rp));files +=[ep,rp]") open(p,'w').write(s) PY python "/tmp/workspace/heartache-audio/src/generate_audio.py" ls -lh "/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Slow.mp3"

python "/tmp/workspace/heartache-audio/src/generate_audio.py"; ls -lh "/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Slow.mp3"

python "/tmp/workspace/heartache-audio/src/generate_audio.py" && ls -lh "/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Slow.mp3"

python - <<'PY' from pathlib import Path p=Path('/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Slow.mp3') print('exists',p.exists(),'size_bytes',p.stat().st_size) print('header',p.read_bytes()[:12]) try: from mutagen.mp3 import MP3 a=MP3(str(p)); print('duration_seconds',round(a.info.length,1),'bitrate',a.info.bitrate) except Exception as e: print('mutagen_check',type(e).__name__,str(e)) print('segments',len(list(Path('/tmp/workspace/heartache-audio/tmp').glob('*.mp3')))) PY

~/heartache-audio

cat > "/tmp/workspace/heartache-audio/src/generate_audio_revised.py" <<'PY' import sys, os, ast, asyncio, shutil from pathlib import Path sys.path.insert(0, '/tmp/workspace/heartache-audio/deps') import edge_tts SRC='/tmp/workspace/esl-vocabulary-handbook/src/create_handbook.py' OUT=Path('/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Alternating_Slow.mp3') TMP=Path('/tmp/workspace/heartache-audio/revised_segments'); TMP.mkdir(exist_ok=True) sets=[] tree=ast.parse(Path(SRC).read_text(encoding='utf-8')) for node in tree.body: if isinstance(node,ast.Assign) and any(isinstance(x,ast.Name) and x.id in {'A','B'} for x in node.targets): sets.extend(ast.literal_eval(node.value)) def eng(s): return s.replace('’', "'").replace('–','-') # Each item follows exactly: English term and meaning, Russian translation, then English/Russian for each example. segments=[('000','en-GB-SoniaNeural','Dear student, are you all set to begin?')] index=1 for n,(term,meaning,russian,examples) in enumerate(sets,1): base=f'{n:02d}' segments += [ (f'{index:03d}', 'en-GB-SoniaNeural', f'{term}. Meaning: {eng(meaning)}'), (f'{index+1:03d}', 'ru-RU-SvetlanaNeural', f'{term}. Перевод: {russian}'), ]; index += 2 for ex_en, ex_ru in examples: segments += [ (f'{index:03d}', 'en-GB-SoniaNeural', eng(ex_en)), (f'{index+1:03d}', 'ru-RU-SvetlanaNeural', ex_ru), ]; index += 2 async def one(num,voice,text,sem): path=TMP/f'{num}.mp3' if path.exists() and path.stat().st_size > 500: return path async with sem: for attempt in range(3): try: await edge_tts.Communicate(text=text,voice=voice,rate='-18%',pitch='+0Hz',volume='+0%').save(str(path)) if path.stat().st_size > 500: return path except Exception: if attempt==2: raise await asyncio.sleep(2*(attempt+1)) return path async def main(): sem=asyncio.Semaphore(12) await asyncio.gather(*(one(*s,sem) for s in segments)) with open(OUT,'wb') as out: for num,voice,text in segments: with open(TMP/f'{num}.mp3','rb') as inp: shutil.copyfileobj(inp,out) print(OUT, len(segments)) asyncio.run(main()) PY python "/tmp/workspace/heartache-audio/src/generate_audio_revised.py" ls -lh "/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Alternating_Slow.mp3"

python - <<'PY' from pathlib import Path from mutagen.mp3 import MP3 p=Path('/tmp/workspace/heartache-audio/output/Can_Science_Cure_Our_Heartache_Vocabulary_EN_RU_Alternating_Slow.mp3') a=MP3(str(p)) print('exists',p.exists(),'bytes',p.stat().st_size,'duration_seconds',round(a.info.length,1),'bitrate',a.info.bitrate) print('header',p.read_bytes()[:4]) seg=list(Path('/tmp/workspace/heartache-audio/revised_segments').glob('*.mp3')) print('segments',len(seg),'min_size',min(x.stat().st_size for x in seg),'max_size',max(x.stat().st_size for x in seg)) PY