1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
#!/usr/bin/env python3
"""ReiLua Documentation Generator"""
import os, re
from pathlib import Path
HTML_TEMPLATE = '''<!DOCTYPE HTML><html><head><title>{title}</title>
<link rel="stylesheet" href="style.css"><meta charset="utf-8"></head><body>
<div class="container"><div class="navigation">
<a href="index.html">home</a> · <a href="manual.html">manual</a> · <a href="reference.html">reference</a>
</div>{content}<div class="footer"><p>ReiLua Enhanced · <a href="https://indrajith.dev">indrajith.dev</a></p></div></div></body></html>'''
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'<h4>\1</h4>',h,flags=re.MULTILINE)
h=re.sub(r'^### (.+)$',r'<h3>\1</h3>',h,flags=re.MULTILINE)
h=re.sub(r'^## (.+)$',r'<h2>\1</h2>',h,flags=re.MULTILINE)
h=re.sub(r'^# (.+)$',r'<h1>\1</h1>',h,flags=re.MULTILINE)
# Links
h=re.sub(r'\[([^\]]+)\]\(([^\)]+)\)',r'<a href="\2">\1</a>',h)
# Bold/italic (after headers to avoid **text:** becoming headings)
h=re.sub(r'\*\*([^\*]+)\*\*',r'<strong>\1</strong>',h)
h=re.sub(r'\*([^\*\n]+)\*',r'<em>\1</em>',h)
# Inline code
h=re.sub(r'`([^`]+)`',r'<code>\1</code>',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'<pre><code>{content}</code></pre>')
# 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('<p>' + ' '.join(para_buffer) + '</p>')
para_buffer.clear()
for line in lines:
s=line.strip()
# Track pre blocks
if '<pre>' in line:
flush_para()
in_pre=True
result.append(line)
continue
if '</pre>' 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('<ul>')
in_ul=True
item=re.sub(r'^[\-\*]\s+','',s)
result.append(f'<li>{item}</li>')
continue
# End list if needed
if in_ul and not s.startswith(('- ','* ')):
result.append('</ul>')
in_ul=False
# Handle block elements
if s.startswith('<h') or s.startswith('<div') or s.startswith('<hr'):
flush_para()
result.append(line)
continue
# Empty line = paragraph break
if not s:
flush_para()
continue
# Accumulate paragraph text
if s and not s.startswith('<'):
para_buffer.append(s)
else:
flush_para()
result.append(line)
# Flush remaining
flush_para()
if in_ul:
result.append('</ul>')
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<len(lines):
l=lines[i]; s=l.strip()
if s.startswith('## ') and not s.startswith('###'):
if cur and cur.get('items'): secs.append(cur)
cur={'title':s.replace('##','').strip(),'items':[]}; i+=1; continue
if s.startswith('>'):
if not cur: cur={'title':'Definitions','items':[]}
d=s.replace('>','').strip(); desc=[]; i+=1
while i<len(lines):
n=lines[i]; ns=n.strip()
if ns.startswith('>') 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='<h1>ReiLua Enhanced</h1><p>Lua binding for Raylib.</p><h2>Documentation</h2><ul><li><a href="manual.html">Manual</a></li><li><a href="reference.html">API Reference</a></li></ul><h2>Quick Start</h2><p>Create <code>main.lua</code>:</p><pre><code>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</code></pre><p>Run: <code>ReiLua.exe</code></p>'),encoding='utf-8')
print('✓ index.html')
parts=['<h1>ReiLua Manual</h1>']
readme=Path('../README.md')
if readme.exists():
parts.append(md2html(re.sub(r'!\[.*?\]\(.*?\)','',readme.read_text(encoding='utf-8'))))
parts.append('<hr>')
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'<h2 id="{a}">{t}</h2>')
parts.append(md2html(p.read_text(encoding='utf-8')))
parts.append('<hr>')
(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=['<h1>ReiLua API Reference</h1><p>Complete function reference.</p><h2>Contents</h2><ul>']
for s in secs:
a=s['title'].lower().replace(' ','-').replace('/','').replace('.','')
parts.append(f'<li><a href="#{a}">{s["title"]}</a> ({len(s["items"])} items)</li>')
parts.append('</ul>')
for s in secs:
a=s['title'].lower().replace(' ','-').replace('/','').replace('.','')
parts.append(f'<h2 id="{a}">{s["title"]}</h2>')
for i in s['items']:
parts.append(f'<div class="apii"><code>{i["definition"]}</code></div>')
if i['description']:
parts.append(f'<div class="apidesc">{md2html(i["description"])}</div>')
(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!')
|
