Update app.py

app.py

@@ -22,14 +22,17 @@ from pypdf import PdfReader, PdfWriter
 from pypdf.annotations import Link
 from pypdf.generic import Fit
 
+# 🌟 1. Set the stage for a wide, welcoming app - wisdom: A broad canvas invites creativity, like a galaxy awaiting stars!
 st.set_page_config(layout="wide", initial_sidebar_state="expanded")
 
-# Existing functions (unchanged)
+# Functions
+# ⏰ 2. Timestamp generator - wisdom: Time stamps your work like a cosmic signature, grounding chaos in order!
 def get_timestamp_prefix():
     central = pytz.timezone("US/Central")
     now = datetime.now(central)
     return now.strftime("%a %m%d %I%M%p").upper()
 
+# 🧹 3. Text cleaner for speech - wisdom: Strip away emojis to let words sing clear, like a bard sans distractions!
 def clean_for_speech(text):
     text = text.replace("#", "")
     emoji_pattern = re.compile(
@@ -47,6 +50,7 @@ def clean_for_speech(text):
     text = emoji_pattern.sub('', text)
     return text
 
+# ✂️ 4. Emoji trimmer - wisdom: Keep numbered lines sacred; prune emojis elsewhere to focus the tale!
 def trim_emojis_except_numbered(markdown_text):
     emoji_pattern = re.compile(
         r"[\U0001F300-\U0001F5FF"
@@ -74,17 +78,16 @@ def trim_emojis_except_numbered(markdown_text):
     
     return '\n'.join(processed_lines)
 
+# 🎙️ 5. Audio generator - wisdom: Give voice to text, like a storyteller breathing life into ancient scrolls!
 async def generate_audio(text, voice, filename):
     communicate = edge_tts.Communicate(text, voice)
     await communicate.save(filename)
     return filename
 
+# 🔗 6. Link converter - wisdom: Transform raw URLs into clickable paths, guiding readers like stars in the night!
 def detect_and_convert_links(text):
-    # Convert Markdown links [text](url) to HTML <a> tags
     md_link_pattern = re.compile(r'\[(.*?)\]\((https?://[^\s\[\]()<>{}]+)\)')
     text = md_link_pattern.sub(r'<a href="\2" color="blue">\1</a>', text)
-    
-    # Convert plain URLs to HTML <a> tags, avoiding already tagged links
     url_pattern = re.compile(
         r'(?<!href=")(https?://[^\s<>{}]+)',
         re.IGNORECASE
@@ -92,13 +95,11 @@ def detect_and_convert_links(text):
     text = url_pattern.sub(r'<a href="\1" color="blue">\1</a>', text)
     return text
 
+# 😊 7. Emoji font applicator - wisdom: Dress emojis in bold fonts, letting them shine like jewels in a crown!
 def apply_emoji_font(text, emoji_font):
-    # Protect existing tags
     tag_pattern = re.compile(r'(<[^>]+>)')
     segments = tag_pattern.split(text)
     result = []
-    
-    # Apply emoji font only to emojis, use DejaVuSans for other text
     emoji_pattern = re.compile(
         r"([\U0001F300-\U0001F5FF"
         r"\U0001F600-\U0001F64F"
@@ -121,10 +122,8 @@ def apply_emoji_font(text, emoji_font):
     
     for segment in segments:
         if tag_pattern.match(segment):
-            # Keep tags unchanged
             result.append(segment)
         else:
-            # Apply DejaVuSans to non-emoji text, emoji_font to emojis
             parts = []
             last_pos = 0
             for match in emoji_pattern.finditer(segment):
@@ -139,6 +138,7 @@ def apply_emoji_font(text, emoji_font):
     
     return ''.join(result)
 
+# 📝 8. Markdown to PDF content - wisdom: Parse markdown like a sage, crafting content that flows like a river!
 def markdown_to_pdf_content(markdown_text, add_space_before_numbered, headings_to_fonts):
     lines = markdown_text.strip().split('\n')
     pdf_content = []
@@ -169,8 +169,6 @@ def markdown_to_pdf_content(markdown_text, add_space_before_numbered, headings_t
                 first_numbered_seen = True
         
         line = detect_and_convert_links(line)
-        
-        # Preserve bold and emphasis formatting
         line = re.sub(r'\*\*(.+?)\*\*', r'<b>\1</b>', line)
         line = re.sub(r'\*([^*]+?)\*', r'<b>\1</b>', line)
                 
@@ -178,9 +176,10 @@ def markdown_to_pdf_content(markdown_text, add_space_before_numbered, headings_t
     total_lines = len(pdf_content)
     return pdf_content, total_lines
 
+# 📄 9. PDF creator - wisdom: Weave text into PDFs, like an alchemist turning words into eternal pages!
 def create_pdf(markdown_text, base_font_size, num_columns, add_space_before_numbered, headings_to_fonts, doc_title, longest_line_words, total_lines):
     if not markdown_text.strip():
-        return None  # Handle empty markdown gracefully
+        return None
     buffer = io.BytesIO()
     page_width = A4[0] * 2
     page_height = A4[1]
@@ -218,7 +217,7 @@ def create_pdf(markdown_text, base_font_size, num_columns, add_space_before_numb
     suggested_columns = max(2, min(4, int(total_lines / ideal_lines_per_col) + 1))
     num_columns = num_columns if num_columns != 0 else suggested_columns
     col_width = usable_width / num_columns
-    min_font_size = 5  # Reduced to allow tighter fit
+    min_font_size = 5
     max_font_size = 16
     lines_per_col = total_lines / num_columns if num_columns > 0 else total_lines
     target_height_per_line = usable_height / lines_per_col if lines_per_col > 0 else usable_height
@@ -228,7 +227,6 @@ def create_pdf(markdown_text, base_font_size, num_columns, add_space_before_numb
         adjusted_font_size = int(col_width / (avg_line_chars / 10))
         adjusted_font_size = max(min_font_size, adjusted_font_size)
     
-    # Enhanced font size scaling for one-page fit
     if longest_line_words > 17 or lines_per_col > 20:
         font_scale = min(17 / max(longest_line_words, 17), 60 / max(lines_per_col, 20))
         adjusted_font_size = max(min_font_size, int(base_font_size * font_scale))
@@ -310,6 +308,7 @@ def create_pdf(markdown_text, base_font_size, num_columns, add_space_before_numb
     buffer.seek(0)
     return buffer.getvalue()
 
+# 🖼️ 10. PDF to image converter - wisdom: Turn PDFs into images, like painting a story for eager eyes!
 def pdf_to_image(pdf_bytes):
     if pdf_bytes is None:
         return None
@@ -332,8 +331,10 @@ WORDS_24 = ["one", "two", "three", "four", "five", "six", "seven", "eight", "nin
             "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen", "nineteen", "twenty",
             "twenty-one", "twenty-two", "twenty-three", "twenty-four"]
 
+# 🔗 11. Cross-file PDF linker - wisdom: Connect PDFs like bridges between islands, uniting stories!
 def create_crossfile_pdfs(source_pdf="TestSource.pdf", target_pdf="TestTarget.pdf"):
     """Create two PDFs with cross-file linking."""
+    # 📜 11.1 Base PDF creator - wisdom: Lay the foundation with words, like carving runes on stone!
     def create_base_pdf(filename):
         buffer = io.BytesIO()
         c = canvas.Canvas(buffer)
@@ -348,6 +349,7 @@ def create_crossfile_pdfs(source_pdf="TestSource.pdf", target_pdf="TestTarget.pd
             f.write(buffer.getvalue())
         buffer.close()
 
+    # 📑 11.2 Bookmark adder - wisdom: Mark the path to seven, like a beacon in the fog!
     def add_bookmark_to_seven(pdf_file):
         reader = PdfReader(pdf_file)
         writer = PdfWriter()
@@ -360,6 +362,7 @@ def create_crossfile_pdfs(source_pdf="TestSource.pdf", target_pdf="TestTarget.pd
         with open(pdf_file, "wb") as f:
             writer.write(f)
 
+    # 🌉 11.3 Source PDF modifier - wisdom: Forge links between files, like threads in a tapestry!
     def modify_source_pdf(source, target):
         reader = PdfReader(source)
         writer = PdfWriter()
@@ -385,6 +388,7 @@ def create_crossfile_pdfs(source_pdf="TestSource.pdf", target_pdf="TestTarget.pd
             writer.write(f)
         buffer.close()
 
+    # 🛤️ 11.4 Internal link adder - wisdom: Guide readers within, like a map to hidden treasure!
     def add_internal_link(pdf_file):
         reader = PdfReader(pdf_file)
         writer = PdfWriter()
@@ -409,12 +413,11 @@ def create_crossfile_pdfs(source_pdf="TestSource.pdf", target_pdf="TestTarget.pd
     add_internal_link(target_pdf)
     return source_pdf, target_pdf
 
+# 📘 12. Self-linking PDF creator - wisdom: Build a PDF that guides itself, like a book with its own compass!
 def create_selflinking_pdf(pdf_file="SelfLinking.pdf"):
     """Create a PDF with a TOC on page 1 linking to a 1-24 list starting on page 2."""
     buffer = io.BytesIO()
     c = canvas.Canvas(buffer)
-    
-    # Page 1: Table of Contents
     c.setFont("Helvetica", 14)
     c.drawString(50, 800, "Table of Contents")
     c.setFont("Helvetica", 12)
@@ -424,8 +427,6 @@ def create_selflinking_pdf(pdf_file="SelfLinking.pdf"):
         c.drawString(50, y, f"{word}")
         toc_y_positions.append(y)
     c.showPage()
-    
-    # Page 2: Numbered list 1-24
     c.setFont("Helvetica", 12)
     list_y_positions = []
     for i, word in enumerate(WORDS_24, 1):
@@ -433,29 +434,21 @@ def create_selflinking_pdf(pdf_file="SelfLinking.pdf"):
         c.drawString(50, y, f"{i}. {word}")
         list_y_positions.append(y)
     c.showPage()
-    
-    # Save the initial PDF
     c.save()
     buffer.seek(0)
     with open(pdf_file, "wb") as f:
         f.write(buffer.getvalue())
     buffer.close()
-
-    # Add outlines and links
     reader = PdfReader(pdf_file)
     writer = PdfWriter()
     for page in reader.pages:
         writer.add_page(page)
-
-    # Add outline entries
     toc_page = writer.pages[0]
     list_page = writer.pages[1]
     writer.add_outline_item("Table of Contents", 0, fit=Fit(fit_type="/Fit"))
     for i, word in enumerate(WORDS_12, 1):
         y = list_y_positions[i-1]
         writer.add_outline_item(word, 1, fit=Fit(fit_type="/XYZ", fit_args=[50, y, 0]))
-
-    # Add TOC links from page 1 to page 2
     for i, word in enumerate(WORDS_12):
         toc_y = toc_y_positions[i]
         list_y = list_y_positions[i]
@@ -465,45 +458,29 @@ def create_selflinking_pdf(pdf_file="SelfLinking.pdf"):
             fit=Fit(fit_type="/XYZ", fit_args=[50, list_y, 0])
         )
         writer.add_annotation(page_number=0, annotation=link)
-
-    # Save the modified PDF
     with open(pdf_file, "wb") as f:
         writer.write(f)
-
     return pdf_file
 
+# 🖼️ 13. Image-linked PDF creator - wisdom: Link images to text, like windows opening to new worlds!
 def create_pdf_with_images(source_pdf_bytes, output_pdf="ImageLinked.pdf"):
     """Create a PDF with links to images on numbered items 1-12."""
-    # Get all PNG files in the project directory, sorted by name
     image_files = sorted(glob.glob("*.png"))
-    
     if not source_pdf_bytes:
         st.error("No source PDF provided.")
         return None
-
-    # Read the source PDF
     reader = PdfReader(io.BytesIO(source_pdf_bytes))
     writer = PdfWriter()
-
-    # Copy all pages from source PDF
     for page in reader.pages:
         writer.add_page(page)
-
-    # Only process the first page for links
     page = writer.pages[0]
     number_pattern = re.compile(r'^\d+\.\s')
-
-    # Find numbered items 1-12 on the page
     y_positions = []
-    # Assuming the PDF was generated with numbered items at predictable y-coordinates
-    for i in range(1, 13):  # 1 to 12
-        y = 800 - (i * 20)  # Adjust based on create_pdf layout
+    for i in range(1, 13):
+        y = 800 - (i * 20)
         y_positions.append(y)
-
-    # Add links to images
     for idx, (y, image_file) in enumerate(zip(y_positions, image_files[:12])):
         if os.path.exists(image_file):
-            # Add "link" text next to numbered item
             buffer = io.BytesIO()
             c = canvas.Canvas(buffer)
             c.setFont("Helvetica", 8)
@@ -513,29 +490,25 @@ def create_pdf_with_images(source_pdf_bytes, output_pdf="ImageLinked.pdf"):
             buffer.seek(0)
             text_pdf = PdfReader(buffer)
             page.merge_page(text_pdf.pages[0])
-            
-            # Add link annotation
             link = Link(
                 rect=(90, y - 10, 150, y + 10),
                 url=f"file://{os.path.abspath(image_file)}"
             )
             writer.add_annotation(page_number=0, annotation=link)
             buffer.close()
-
-    # Save the modified PDF
     output_buffer = io.BytesIO()
     writer.write(output_buffer)
     output_buffer.seek(0)
     with open(output_pdf, "wb") as f:
         f.write(output_buffer.getvalue())
-    
     return output_buffer.getvalue()
 
-# Streamlit UI
+# 🎨 14. Streamlit UI - wisdom: Craft an interface like a garden, where users bloom with possibilities!
 md_files = [f for f in glob.glob("*.md") if os.path.basename(f) != "README.md"]
 md_options = [os.path.splitext(os.path.basename(f))[0] for f in md_files]
 
 with st.sidebar:
+    # 📚 14.1 Markdown selector - wisdom: Offer choices like a librarian, guiding users to their story!
     st.markdown("### 📄 PDF Options")
     if md_options:
         selected_md = st.selectbox("Select Markdown File", options=md_options, index=0)
@@ -546,6 +519,7 @@ with st.sidebar:
         selected_md = None
         st.session_state.markdown_content = ""
     
+    # 🔠 14.2 Font selector - wisdom: Choose fonts like a painter picks colors, shaping the mood!
     available_font_files = {os.path.splitext(os.path.basename(f))[0]: f for f in glob.glob("*.ttf")}
     selected_font_name = st.selectbox(
         "Select Emoji Font",
@@ -554,6 +528,7 @@ with st.sidebar:
     )
     base_font_size = st.slider("Font Size (points)", min_value=6, max_value=16, value=8, step=1)
     
+    # 📏 14.3 Layout options - wisdom: Space and style are the frame of your masterpiece!
     add_space_before_numbered = st.checkbox("Add Space Ahead of Numbered Lines", value=True)
     headings_to_fonts = st.checkbox(
         "Headings to Fonts",
@@ -562,7 +537,10 @@ with st.sidebar:
     )
     auto_columns = st.checkbox("AutoColumns", value=True)
     
-    # Calculate document stats
+    # 📊 14.4 Document stats - wisdom: Know your text’s pulse, like a doctor checking its heartbeat!
+    column_options = [2, 3, 4]
+    num_columns = 3
+    recommended_columns = 3
     longest_line_words = 0
     total_lines = 0
     adjusted_font_size_display = base_font_size
@@ -581,11 +559,8 @@ with st.sidebar:
                 recommended_columns = 4
             else:
                 recommended_columns = 3
-        else:
-            recommended_columns = 3
-        # Adjust font size for one-page fit
-        if longest_line_words > 17 or total_lines / max(num_columns, 1) > 20:
-            font_scale = min(17 / max(longest_line_words, 17), 60 / max(total_lines / max(num_columns, 1), 20))
+        if longest_line_words > 17 or total_lines / max(recommended_columns, 1) > 20:
+            font_scale = min(17 / max(longest_line_words, 17), 60 / max(total_lines / max(recommended_columns, 1), 20))
             adjusted_font_size_display = max(5, int(base_font_size * font_scale))
         st.markdown("**Document Stats**")
         st.write(f"- Longest Line: {longest_line_words} words")
@@ -599,7 +574,7 @@ with st.sidebar:
         st.write("- Recommended Columns: 3")
         st.write(f"- Adjusted Font Size: {base_font_size} points")
     
-    column_options = [2, 3, 4]
+    # 🔢 14.5 Column selector - wisdom: Columns organize chaos, like shelves in a wizard’s library!
     num_columns = st.selectbox(
         "Number of Columns",
         options=column_options,
@@ -607,6 +582,7 @@ with st.sidebar:
     )
     st.info("Font size and columns adjust to fit one page.")
     
+    # ✍️ 14.6 Markdown editor - wisdom: Let users scribe their saga, shaping worlds with words!
     st.markdown("### ✍️ Edit Markdown")
     edited_markdown = st.text_area(
         "Input Markdown",
@@ -615,6 +591,7 @@ with st.sidebar:
         key=f"markdown_{selected_md}_{selected_font_name}_{num_columns}"
     )
     
+    # 💾 14.7 Action buttons - wisdom: Actions spark progress, like flint igniting a fire!
     st.markdown("### 💾 Actions")
     col1, col2 = st.columns(2)
     with col1:
@@ -634,6 +611,7 @@ with st.sidebar:
                     f.write(trimmed_content)
             st.rerun()
     
+    # 📥 14.8 Markdown saver - wisdom: Save your work, like bottling a potion for later!
     prefix = get_timestamp_prefix()
     st.download_button(
         label="💾 Save Markdown",
@@ -642,6 +620,7 @@ with st.sidebar:
         mime="text/markdown"
     )
     
+    # 🔊 14.9 Text-to-speech - wisdom: Let words echo aloud, like a bard’s tale in the hall!
     st.markdown("### 🔊 Text-to-Speech")
     VOICES = ["en-US-AriaNeural", "en-US-JennyNeural", "en-GB-SoniaNeural", "en-US-GuyNeural", "en-US-AnaNeural"]
     selected_voice = st.selectbox("Select Voice for TTS", options=VOICES, index=0)
@@ -659,6 +638,7 @@ with st.sidebar:
             mime="audio/mpeg"
         )
     
+    # 📑 14.10 PDF action buttons - wisdom: Create and link PDFs, like crafting portals to knowledge!
     col1, col2 = st.columns(2)
     with col1:
         if st.button("📑 Create CrossFile PDFs"):
@@ -711,6 +691,7 @@ with st.sidebar:
                     mime="application/pdf"
                 )
 
+# 🖥️ 15. Main PDF generation - wisdom: Spin up the PDF like a weaver at the loom, crafting beauty!
 with st.spinner("Generating PDF..."):
     pdf_bytes = create_pdf(
         st.session_state.markdown_content,
@@ -723,6 +704,7 @@ with st.spinner("Generating PDF..."):
         total_lines=total_lines
     )
 
+# 🖼️ 16. PDF preview - wisdom: Show the masterpiece before it’s framed, delighting the creator!
 with st.container():
     st.markdown("### 📊 PDF Preview")
     pdf_images = pdf_to_image(pdf_bytes)
@@ -732,6 +714,7 @@ with st.container():
     else:
         st.info("Download the PDF to view it locally.")
 
+# 💾 17. PDF saver - wisdom: Offer the final scroll, ready to be shared like wisdom across ages!
 with st.sidebar:
     st.download_button(
         label="💾 Save PDF",