"""HTML Generator for LandingForge.""" import html from datetime import date class HTMLGenerator: """Generates all HTML pages for the landing site.""" def __init__(self, config: dict): self.config = config self.site = config["site"] self.keywords = config.get("keywords", {}) self.seo_cfg = config.get("seo", {}) self.languages = config.get("languages", {}) self.design = config.get("design", {}) self.content = config.get("content", {}) self.gdpr = config.get("gdpr", {}) # ── Helpers ────────────────────────────────────────────────────────────── def _primary_keyword(self) -> str: primary = self.keywords.get("primary", [""]) return primary[0] if primary else "" def _all_keywords(self) -> list: kw = [] kw.extend(self.keywords.get("primary", [])) kw.extend(self.keywords.get("secondary", [])) kw.extend(self.keywords.get("long_tail", [])) return kw def _meta_title(self, page: str = "") -> str: brand = self.site["brand_name"] primary = self._primary_keyword() tagline = self.site.get("tagline", "") tpl = self.seo_cfg.get("title_template", "{brand} — {primary_keyword} | {tagline}") title = tpl.format(brand=brand, primary_keyword=primary, tagline=tagline) if page: return f"{page} | {brand}" return title def _meta_description(self, extra: str = "") -> str: brand = self.site["brand_name"] kws = self.keywords.get("primary", []) sec = self.keywords.get("secondary", []) kw_str = ", ".join(kws[:2]) sec_str = sec[0] if sec else "" base = ( f"{brand} — {kws[0] if kws else 'AI solution'}. " f"Powered by {sec_str}. {extra}".strip() ) max_len = self.seo_cfg.get("description_length", 155) return base[:max_len] def _base_url(self) -> str: return f"https://{self.site['domain']}" def _hreflang_links(self, path: str = "") -> str: base = self._base_url() supported = self.languages.get("supported", []) default_lang = self.languages.get("default", "en") lines = [] for lang in supported: code = lang["code"] if code == default_lang: href = f"{base}/{path}" if path else f"{base}/" else: href = f"{base}/lang/{code}/{path}" if path else f"{base}/lang/{code}/" lines.append(f' ') lines.append(f' ') return "\n".join(lines) def _og_tags(self, title: str, description: str, url: str, og_type: str = "website") -> str: og_image = self.seo_cfg.get("og_image", "/assets/images/og-default.jpg") brand = self.site["brand_name"] supported = self.languages.get("supported", []) default_lang = self.languages.get("default", "en") base = self._base_url() full_image = og_image if og_image.startswith("http") else f"{base}{og_image}" lines = [ f' ', f' ', f' ', f' ', f' ', f' ', f' ', ] for lang in supported: if lang["code"] != default_lang: lines.append(f' ') return "\n".join(lines) def _twitter_tags(self, title: str, description: str) -> str: og_image = self.seo_cfg.get("og_image", "/assets/images/og-default.jpg") handle = self.seo_cfg.get("twitter_handle", "") base = self._base_url() full_image = og_image if og_image.startswith("http") else f"{base}{og_image}" lines = [ ' ', f' ', f' ', f' ', ] if handle: lines.append(f' ') return "\n".join(lines) def _json_ld_software_app(self, title: str, description: str) -> str: brand = self.site["brand_name"] domain = self.site["domain"] kws = self._all_keywords() schema_type = self.seo_cfg.get("schema_type", "SoftwareApplication") data = { "@context": "https://schema.org", "@type": schema_type, "name": brand, "description": description, "url": f"https://{domain}/", "applicationCategory": "BusinessApplication", "operatingSystem": "Web", "keywords": ", ".join(kws[:10]), "offers": {"@type": "Offer", "price": "0", "priceCurrency": "USD"}, } import json # noqa: PLC0415 return json.dumps(data, indent=2, ensure_ascii=False) def _json_ld_breadcrumbs(self, crumbs: list) -> str: """crumbs = list of (name, url) tuples""" import json # noqa: PLC0415 items = [] for i, (name, url) in enumerate(crumbs, 1): items.append({"@type": "ListItem", "position": i, "name": name, "item": url}) data = {"@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": items} return json.dumps(data, indent=2, ensure_ascii=False) def _json_ld_faq(self) -> str: import json # noqa: PLC0415 faq_items = self.content.get("faq", {}).get("items", []) brand = self.site["brand_name"] entities = [] for item in faq_items: q = item["question"].replace("{brand_name}", brand) a = item["answer"].replace("{brand_name}", brand) entities.append({ "@type": "Question", "name": q, "acceptedAnswer": {"@type": "Answer", "text": a}, }) data = {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": entities} return json.dumps(data, indent=2, ensure_ascii=False) def _head(self, title: str, description: str, canonical: str, lang: str = "en", extra_schema: list = None, page: str = "") -> str: """Generate the full section.""" brand = self.site["brand_name"] all_kws = self._all_keywords() keywords_meta = ", ".join(all_kws[:15]) hreflang = self._hreflang_links(page) og = self._og_tags(title, description, canonical) tw = self._twitter_tags(title, description) app_schema = self._json_ld_software_app(title, description) year = self.site.get("copyright_year", date.today().year) schema_blocks = [f''] if extra_schema: for schema in extra_schema: schema_blocks.append(f'') schema_html = "\n ".join(schema_blocks) fonts_heading = self.design.get("fonts", {}).get("heading", "Inter") fonts_body = self.design.get("fonts", {}).get("body", "Inter") return f""" {html.escape(title)} {hreflang} {og} {tw} {schema_html} """ def _nav(self, lang: str = "en") -> str: brand = self.site["brand_name"] supported = self.languages.get("supported", []) default_lang = self.languages.get("default", "en") contact_email = self.site.get("contact_email", "") # Build language dropdown entries lang_items = [] for l in supported: code = l["code"] flag = l.get("flag_emoji", "") name = l["name"] if code == default_lang: href = "/" else: href = f"/lang/{code}/" lang_items.append( f' {flag} {name}' ) lang_items_html = "\n".join(lang_items) # Find current language flag/name current = next((l for l in supported if l["code"] == lang), supported[0] if supported else {"flag_emoji": "🌐", "code": lang}) current_flag = current.get("flag_emoji", "🌐") return f""" """ def _hero(self) -> str: hero_cfg = self.content.get("hero", {}) headline = hero_cfg.get("headline", "Transform Your Content with AI") subheadline = hero_cfg.get("subheadline", "") cta_primary_text = hero_cfg.get("cta_primary_text", "Get Started Free") cta_primary_url = hero_cfg.get("cta_primary_url", "#signup") cta_secondary_text = hero_cfg.get("cta_secondary_text", "Watch Demo") cta_secondary_url = hero_cfg.get("cta_secondary_url", "#demo") rotating_texts = hero_cfg.get("rotating_texts", ["Content"]) show_prompt = hero_cfg.get("show_prompt_input", True) brand_logos = hero_cfg.get("brand_logos", []) primary_kw = self._primary_keyword() logos_html = "" if brand_logos: logo_items = "".join( f'{html.escape(l["name"])}' for l in brand_logos ) logos_html = f"""
Trusted by innovative teams
{logo_items}
""" prompt_html = "" if show_prompt: prompt_html = """
""" first_rotating = rotating_texts[0] if rotating_texts else "Content" return f"""
{html.escape(primary_kw)} — Now Live

{html.escape(headline)}
{html.escape(first_rotating)}

{html.escape(subheadline)}

{html.escape(cta_primary_text)} {html.escape(cta_secondary_text)}
{prompt_html} {logos_html}
""" def _features(self) -> str: feat_cfg = self.content.get("features", {}) section_title = feat_cfg.get("section_title", "Powerful Features") section_subtitle = feat_cfg.get("section_subtitle", "") tabs = feat_cfg.get("tabs", []) tab_nav = [] tab_panels = [] for i, tab in enumerate(tabs): active = "active" if i == 0 else "" tab_nav.append( f' ' ) bullets_html = "".join( f"
  • {html.escape(b)}
    • " for b in tab.get("bullets", []) ) img_alt = html.escape(tab.get("image_alt", f"Feature {i + 1}")) tab_panels.append(f"""

    {html.escape(tab.get("heading", ""))}

    {html.escape(tab.get("description", ""))}

    {img_alt}
    """) return f"""

    {html.escape(section_title)}

    {html.escape(section_subtitle)}

    {chr(10).join(tab_nav)}
    {chr(10).join(tab_panels)}
    """ def _how_to(self) -> str: how_cfg = self.content.get("how_to", {}) section_title = how_cfg.get("section_title", "How It Works") section_subtitle = how_cfg.get("section_subtitle", "") steps = how_cfg.get("steps", []) step_cards = [] for i, step in enumerate(steps): num = step.get("number", i + 1) title = step.get("title", f"Step {num}") desc = step.get("description", "") img_alt = html.escape(step.get("image_alt", f"Step {num}")) delay = f"0.{i * 2}s" step_cards.append(f"""

    {html.escape(title)}

    {html.escape(desc)}

    {img_alt}
    """) return f"""

    {html.escape(section_title)}

    {html.escape(section_subtitle)}

    {chr(10).join(step_cards)}
    """ def _faq(self) -> str: faq_cfg = self.content.get("faq", {}) section_title = faq_cfg.get("section_title", "Frequently Asked Questions") items = faq_cfg.get("items", []) brand = self.site["brand_name"] item_blocks = [] for i, item in enumerate(items): q = item["question"].replace("{brand_name}", brand) a = item["answer"].replace("{brand_name}", brand) item_blocks.append(f"""
    {html.escape(a)}
    """) return f"""

    {html.escape(section_title)}

    {chr(10).join(item_blocks)}
    """ def _footer(self, lang: str = "en") -> str: footer_cfg = self.content.get("footer", {}) columns = footer_cfg.get("columns", []) social_links = footer_cfg.get("social_links", []) brand = self.site["brand_name"] primary_kw = self._primary_keyword() year = self.site.get("copyright_year", date.today().year) contact_email = self.site.get("contact_email", "") col_html_parts = [] for col in columns: links_html = "".join( f'
  • {html.escape(l["text"])}
    • ' for l in col.get("links", []) ) col_html_parts.append( f"""
    {html.escape(col["title"])}
    """ ) social_html = "".join( f'' f'' for l in social_links ) supported = self.languages.get("supported", []) default_lang = self.languages.get("default", "en") footer_lang_links = "".join( f'' f'{l.get("flag_emoji", "")} {l["name"]}' for l in supported ) return f"""""" def _cookie_banner(self) -> str: gdpr = self.gdpr if not gdpr.get("cookie_banner", True): return "" message = gdpr.get("cookie_message", "We use cookies to enhance your experience.") privacy_url = gdpr.get("privacy_policy_url", "/privacy.html") categories = gdpr.get("cookie_categories", []) cat_html_parts = [] for cat in categories: required = cat.get("required", False) default_on = cat.get("default", False) or required disabled_attr = ' disabled' if required else '' checked_attr = ' checked' if default_on else '' cat_html_parts.append( f""" """ ) return f"""""" def _back_to_top(self) -> str: return """""" def _scripts(self) -> str: brand = self.site["brand_name"] analytics_id = self.site.get("analytics_id", "") analytics_html = "" if analytics_id: analytics_html = f""" """ return f""" {analytics_html}""" # ── Page generators ──────────────────────────────────────────────────── def generate_index(self, lang: str = "en", is_lang_version: bool = False) -> str: brand = self.site["brand_name"] domain = self.site["domain"] base = f"https://{domain}" primary_kw = self._primary_keyword() title = self._meta_title() description = self._meta_description( extra=self.content.get("hero", {}).get("subheadline", "") ) if is_lang_version: canonical = f"{base}/lang/{lang}/" else: canonical = f"{base}/" extra_schemas = [] if self.seo_cfg.get("generate_breadcrumbs", True): extra_schemas.append( self._json_ld_breadcrumbs([(brand, f"{base}/"), ("Home", f"{base}/")]) ) if self.seo_cfg.get("generate_faq_schema", True): extra_schemas.append(self._json_ld_faq()) head = self._head(title, description, canonical, lang=lang, extra_schema=extra_schemas) nav = self._nav(lang=lang) hero = self._hero() features = self._features() how_to = self._how_to() faq = self._faq() footer = self._footer(lang=lang) cookie = self._cookie_banner() back_to_top = self._back_to_top() scripts = self._scripts() if is_lang_version: lang_note = f"""""" else: lang_note = "" return f"""{head} {lang_note} {nav}
    {hero} {features} {how_to} {faq}
    {footer} {cookie} {back_to_top} {scripts} """ def generate_about(self) -> str: brand = self.site["brand_name"] domain = self.site["domain"] base = f"https://{domain}" title = self._meta_title(page="About") description = self._meta_description(extra=f"Learn more about {brand} and our mission.") canonical = f"{base}/about.html" primary_kw = self._primary_keyword() all_kws = self.keywords.get("secondary", []) extra_schemas = [ self._json_ld_breadcrumbs([ (brand, f"{base}/"), ("About", canonical), ]) ] head = self._head(title, description, canonical, extra_schema=extra_schemas, page="about.html") nav = self._nav() footer = self._footer() scripts = self._scripts() back_to_top = self._back_to_top() body_content = f"""

    About {html.escape(brand)}

    {html.escape(brand)} is a next-generation {html.escape(primary_kw)} platform built for marketers, content creators, and businesses of all sizes. We leverage cutting-edge {html.escape(", ".join(all_kws[:3]))} technology to help you create compelling, SEO-optimized content in seconds.

    Our Mission

    We believe great content should be accessible to everyone, not just large enterprises with dedicated copywriting teams. Our mission is to democratize high-quality content creation through AI.

    Our Technology

    Built on advanced {html.escape(", ".join(all_kws[:4]))} models, {html.escape(brand)} understands context, tone, and SEO best practices to deliver content that resonates with both readers and search engines.

    Back to Home See Features
    """ return f"""{head} {nav} {body_content} {footer} {back_to_top} {scripts} """ def generate_privacy(self) -> str: brand = self.site["brand_name"] domain = self.site["domain"] base = f"https://{domain}" contact_email = self.site.get("contact_email", "") year = self.site.get("copyright_year", date.today().year) title = self._meta_title(page="Privacy Policy") description = f"Privacy Policy for {brand}. Learn how we collect, use, and protect your personal data." canonical = f"{base}/privacy.html" extra_schemas = [ self._json_ld_breadcrumbs([ (brand, f"{base}/"), ("Privacy Policy", canonical), ]) ] head = self._head(title, description, canonical, extra_schema=extra_schemas, page="privacy.html") nav = self._nav() footer = self._footer() scripts = self._scripts() back_to_top = self._back_to_top() body_content = f"""

    Privacy Policy

    Last updated: {date.today().isoformat()}

    1. Information We Collect

    We collect information you provide directly to us, such as when you create an account, use our services, or contact us for support. This may include your name, email address, and usage data.

    2. How We Use Your Information

    We use the information we collect to provide, maintain, and improve our services, process transactions, send you technical notices and support messages, and respond to your comments and questions.

    3. Cookies

    We use cookies and similar tracking technologies to track activity on our service and hold certain information. You can instruct your browser to refuse all cookies or to indicate when a cookie is being sent. See our Cookie Policy for details.

    4. Data Sharing

    We do not sell, trade, or otherwise transfer your personally identifiable information to outside parties without your consent, except as described in this policy.

    5. Data Security

    We implement appropriate technical and organizational measures to protect your personal data against unauthorized access, alteration, disclosure, or destruction.

    6. Your Rights (GDPR)

    If you are located in the European Economic Area, you have certain data protection rights. You may request access to, correction of, or deletion of your personal data by contacting us at {('' + html.escape(contact_email) + '') if contact_email else 'our support email'}.

    7. Contact Us

    If you have any questions about this Privacy Policy, please contact us at {('' + html.escape(contact_email) + '') if contact_email else 'our support email'}.

    Back to Home
    """ return f"""{head} {nav} {body_content} {footer} {back_to_top} {scripts} """ def generate_terms(self) -> str: brand = self.site["brand_name"] domain = self.site["domain"] base = f"https://{domain}" contact_email = self.site.get("contact_email", "") title = self._meta_title(page="Terms of Service") description = f"Terms of Service for {brand}. Read our terms and conditions." canonical = f"{base}/terms.html" extra_schemas = [ self._json_ld_breadcrumbs([ (brand, f"{base}/"), ("Terms of Service", canonical), ]) ] head = self._head(title, description, canonical, extra_schema=extra_schemas, page="terms.html") nav = self._nav() footer = self._footer() scripts = self._scripts() back_to_top = self._back_to_top() body_content = f"""

    Terms of Service

    Last updated: {date.today().isoformat()}

    1. Acceptance of Terms

    By accessing and using {html.escape(brand)}, you accept and agree to be bound by the terms and provisions of this agreement.

    2. Use License

    Permission is granted to temporarily use {html.escape(brand)} for personal, non-commercial transitory viewing only. This is the grant of a license, not a transfer of title.

    3. Disclaimer

    The materials on {html.escape(brand)} are provided on an "as is" basis. {html.escape(brand)} makes no warranties, expressed or implied, and hereby disclaims and negates all other warranties including, without limitation, implied warranties or conditions of merchantability, fitness for a particular purpose.

    4. Limitations

    In no event shall {html.escape(brand)} or its suppliers be liable for any damages arising out of the use or inability to use the materials on {html.escape(brand)}'s website.

    5. Governing Law

    These terms and conditions are governed by and construed in accordance with applicable laws, and you irrevocably submit to the exclusive jurisdiction of the courts in that jurisdiction.

    6. Contact

    Questions about the Terms of Service should be sent to us at {('' + html.escape(contact_email) + '') if contact_email else 'our support email'}.

    Back to Home
    """ return f"""{head} {nav} {body_content} {footer} {back_to_top} {scripts} """ def generate_cookies(self) -> str: brand = self.site["brand_name"] domain = self.site["domain"] base = f"https://{domain}" contact_email = self.site.get("contact_email", "") title = self._meta_title(page="Cookie Policy") description = f"Cookie Policy for {brand}. Learn how we use cookies." canonical = f"{base}/cookies.html" extra_schemas = [ self._json_ld_breadcrumbs([ (brand, f"{base}/"), ("Cookie Policy", canonical), ]) ] head = self._head(title, description, canonical, extra_schema=extra_schemas, page="cookies.html") nav = self._nav() footer = self._footer() scripts = self._scripts() back_to_top = self._back_to_top() body_content = f"""

    Cookie Policy

    Last updated: {date.today().isoformat()}

    What Are Cookies

    Cookies are small text files that are placed on your computer by websites that you visit. They are widely used to make websites work, or work more efficiently, as well as to provide information to the owners of the site.

    How We Use Cookies

    {html.escape(brand)} uses cookies for the following purposes:

    Managing Cookies

    You can control and/or delete cookies as you wish. You can delete all cookies that are already on your computer and you can set most browsers to prevent them from being placed. Use the cookie consent panel at the bottom of this page to manage your preferences.

    Contact

    For questions about our cookie policy, contact us at {('' + html.escape(contact_email) + '') if contact_email else 'our support email'}.

    Back to Home
    """ return f"""{head} {nav} {body_content} {footer} {back_to_top} {scripts} """