From 3090134068e99e73ca57e8c0b62534c9bc99e93b Mon Sep 17 00:00:00 2001 From: Indrajith K L Date: Fri, 7 Nov 2025 04:55:35 +0530 Subject: Changes Docs Folders --- html_docs/generate.py | 174 -------------------------------------------------- 1 file changed, 174 deletions(-) delete mode 100644 html_docs/generate.py (limited to 'html_docs/generate.py') diff --git a/html_docs/generate.py b/html_docs/generate.py deleted file mode 100644 index 4320bcc..0000000 --- a/html_docs/generate.py +++ /dev/null @@ -1,174 +0,0 @@ -#!/usr/bin/env python3 -"""ReiLua Documentation Generator""" -import os, re -from pathlib import Path - -HTML_TEMPLATE = '''{title} - -

{content}

''' - -def fix_links(t): - t=re.sub(r'$([^)]+)\.md$',r'(manual.html)',t) - t=re.sub(r'$docs/[^)]+\.md$',r'(manual.html)',t) - t=re.sub(r'$\.\.\/docs\/[^)]+\.md$',r'(manual.html)',t) - return t - -def md2html(md): - h=fix_links(md) - - # Protect code blocks by replacing them with placeholders - code_blocks = [] - def save_code(m): - code_blocks.append(m.group(0)) - return f'___CODE_BLOCK_{len(code_blocks)-1}___' - h=re.sub(r'```[^\n]*\n.*?```',save_code,h,flags=re.DOTALL) - - # Now process markdown (code is protected) - # Headers - MUST be before bold/italic to avoid conflicts - h=re.sub(r'^#### (.+)$',r'

\1

',h,flags=re.MULTILINE) - h=re.sub(r'^### (.+)$',r'

\1

',h,flags=re.MULTILINE) - h=re.sub(r'^## (.+)$',r'

\1

',h,flags=re.MULTILINE) - h=re.sub(r'^# (.+)$',r'

\1

',h,flags=re.MULTILINE) - - # Links - h=re.sub(r'\[([^\]]+)\]$([^$]+)\)',r'\1',h) - - # Bold/italic (after headers to avoid **text:** becoming headings) - h=re.sub(r'\*\*([^\*]+)\*\*',r'\1',h) - h=re.sub(r'\*([^\*\n]+)\*',r'\1',h) - - # Inline code - h=re.sub(r'`([^`]+)`',r'\1',h) - - # Restore code blocks - for i, block in enumerate(code_blocks): - content = re.search(r'```[^\n]*\n(.*?)```', block, re.DOTALL).group(1) - h = h.replace(f'___CODE_BLOCK_{i}___', f'

{content}

') - - # Process line by line for paragraphs and lists - lines=h.split('\n') - result=[] - in_ul=False - in_pre=False - para_buffer=[] - - def flush_para(): - if para_buffer: - result.append('

' + ' '.join(para_buffer) + '

') - para_buffer.clear() - - for line in lines: - s=line.strip() - - # Track pre blocks - if '

' in line:
-            flush_para()
-            in_pre=True
-            result.append(line)
-            continue
-        if '

' in line: - in_pre=False - result.append(line) - continue - if in_pre: - result.append(line) - continue - - # Handle list items - if s.startswith(('- ','* ')): - flush_para() - if not in_ul: - result.append('

{item}

') - in_ul=False - - # Handle block elements - if s.startswith('') - - return '\n'.join(result) - -def parse_api(f): - with open(f,'r',encoding='utf-8') as fp: c=fp.read() - secs=[]; cur=None; lines=c.split('\n'); i=0 - while i'): - if not cur: cur={'title':'Definitions','items':[]} - d=s.replace('>','').strip(); desc=[]; i+=1 - while i') or (ns.startswith('##') and not ns.startswith('###')): break - if ns=='---': i+=1; break - desc.append(n); i+=1 - cur['items'].append({'definition':d,'description':'\n'.join(desc).strip()}); continue - i+=1 - if cur and cur.get('items'): secs.append(cur) - return secs - -out=Path(__file__).parent -(out/'index.html').write_text(HTML_TEMPLATE.format(title='ReiLua',content='

ReiLua Enhanced

Lua binding for Raylib.

Documentation

Quick Start

Create main.lua:

function RL.init()\n  RL.SetWindowTitle("Hello")\nend\n\nfunction RL.update(dt)\nend\n\nfunction RL.draw()\n  RL.ClearBackground(RL.RAYWHITE)\n  RL.DrawText("Hello!",190,200,20,RL.BLACK)\nend

Run: ReiLua.exe

'),encoding='utf-8') -print('✓ index.html') - -parts=['

ReiLua Manual

'] -readme=Path('../README.md') -if readme.exists(): - parts.append(md2html(re.sub(r'!\[.*?\]$.*?$','',readme.read_text(encoding='utf-8')))) - parts.append('

') -for fp,t in [('../docs/EMBEDDING.md','Embedding'),('../docs/ASSET_LOADING.md','Asset Loading'),('../docs/SPLASH_SCREENS.md','Splash Screens'),('../docs/BUILD_SCRIPTS.md','Build Scripts'),('../docs/CUSTOMIZATION.md','Customization'),('../docs/ZED_EDITOR_SETUP.md','Editor Setup')]: - p=Path(fp) - if p.exists(): - a=t.lower().replace(' ','-') - parts.append(f'

{t}

') - parts.append(md2html(p.read_text(encoding='utf-8'))) - parts.append('

') -(out/'manual.html').write_text(HTML_TEMPLATE.format(title='Manual',content='\n'.join(parts)),encoding='utf-8') -print('✓ manual.html') - -secs=parse_api(Path('../docs/API.md')) -parts=['

ReiLua API Reference

Complete function reference.

{s["title"]} ({len(s["items"])} items)

') -for s in secs: - a=s['title'].lower().replace(' ','-').replace('/','').replace('.','') - parts.append(f'

{s["title"]}

') - for i in s['items']: - parts.append(f'

{i["definition"]}

') - if i['description']: - parts.append(f'

{md2html(i["description"])}

') -(out/'reference.html').write_text(HTML_TEMPLATE.format(title='API Reference',content='\n'.join(parts)),encoding='utf-8') -print(f'✓ reference.html ({sum(len(s["items"]) for s in secs)} items)') -print('Complete!') -- cgit v1.2.3

\1

\1

\1

\1