Add Site Studio themes and Theme Manager
Support categorized fragments, theme presets, block widths, and server-backed theme editing with onboarding and preview. Include Site Studio, design sources, specification and verification reports; remove the legacy studio-site example.
This commit is contained in:
@@ -0,0 +1,218 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Offline example renderer (NOT the Site Engine production BuildService).
|
||||
|
||||
Converts the Site Studio demo's YAML/Markdown/Jinja fragments into portable HTML.
|
||||
Needs PyYAML, Jinja2, mistune; no FastAPI, server or external CDN.
|
||||
"""
|
||||
from pathlib import Path
|
||||
import shutil
|
||||
import yaml
|
||||
import mistune
|
||||
from jinja2 import Environment, FileSystemLoader, select_autoescape
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
OUT = ROOT / 'preview-dist'
|
||||
load = lambda path: yaml.safe_load(path.read_text(encoding='utf8'))
|
||||
|
||||
|
||||
def parse_md(path):
|
||||
text = path.read_text(encoding='utf8')
|
||||
if not text.startswith('---\n'):
|
||||
raise ValueError(f'Missing front matter: {path}')
|
||||
raw, body = text[4:].split('\n---\n', 1)
|
||||
return yaml.safe_load(raw), body
|
||||
|
||||
|
||||
def route_path(route):
|
||||
if not isinstance(route, str) or not route.startswith('/') or '..' in Path(route).parts:
|
||||
raise ValueError(f'Unsafe route: {route}')
|
||||
return Path('index.html') if route == '/' else Path(route.strip('/')) / 'index.html'
|
||||
|
||||
|
||||
site = load(ROOT/'site.yaml')
|
||||
theme = load(ROOT/'theme.yaml')
|
||||
company = load(ROOT/'data/company.yaml')
|
||||
menus = {p.stem: load(p)['items'] for p in (ROOT/'menus').glob('*.yaml')}
|
||||
forms = {p.stem: load(p) for p in (ROOT/'forms').glob('*.yaml')}
|
||||
layouts = {d.name: load(d/'layout.yaml') for d in (ROOT/'layouts').iterdir() if d.is_dir()}
|
||||
fragments = {p.parent.name: p.parent.relative_to(ROOT) for p in (ROOT/'fragments').glob('*/*/fragment.yaml')}
|
||||
env = Environment(loader=FileSystemLoader(ROOT), autoescape=select_autoescape(['html','j2']))
|
||||
|
||||
entries = []
|
||||
for file in (ROOT/'content').glob('*/*.md'):
|
||||
data, body = parse_md(file)
|
||||
schema = load(ROOT/'collections'/f'{file.parent.name}.yaml')
|
||||
data.update({'collection': file.parent.name, 'body': body,
|
||||
'url': schema['route'].replace('{slug}', data['slug'])})
|
||||
entries.append(data)
|
||||
entry_by_key = {e['collection']+'/'+e['slug']: e for e in entries}
|
||||
CURRENT = Path('index.html')
|
||||
|
||||
|
||||
def site_link(route):
|
||||
return '../' * len(CURRENT.parent.parts) + route_path(route).as_posix()
|
||||
|
||||
|
||||
def asset_url(path):
|
||||
if not isinstance(path, str) or not path.startswith('assets/') or '..' in Path(path).parts:
|
||||
raise ValueError('Unsafe asset reference '+repr(path))
|
||||
return '../' * len(CURRENT.parent.parts) + path
|
||||
|
||||
|
||||
def read_bind(key, page, entry):
|
||||
parts = key.split('.')
|
||||
value = {'page': page, 'entry': entry or {}, 'data': {'company': company}}.get(parts.pop(0), {})
|
||||
for part in parts:
|
||||
if not isinstance(value, dict): return ''
|
||||
value = value.get(part, '')
|
||||
return value
|
||||
|
||||
|
||||
def resolve(value, page, entry):
|
||||
if isinstance(value, dict):
|
||||
if 'bind' in value: return read_bind(value['bind'], page, entry)
|
||||
return {k: resolve(v, page, entry) for k,v in value.items()}
|
||||
if isinstance(value, list): return [resolve(v, page, entry) for v in value]
|
||||
return value
|
||||
|
||||
|
||||
def query_entries(collection, sort='order', limit=6):
|
||||
schema_file = ROOT/'collections'/f'{collection}.yaml'
|
||||
if not schema_file.is_file() or not load(schema_file).get('enabled', True): return []
|
||||
result = [e for e in entries if e['collection']==collection and e.get('status')=='published']
|
||||
sort = str(sort)
|
||||
reverse = sort.startswith('-')
|
||||
field = sort.lstrip('-')
|
||||
result.sort(key=lambda e: e.get(field, 999) if field=='order' else str(e.get(field,'')), reverse=reverse)
|
||||
return result[:min(int(limit), 30)]
|
||||
|
||||
|
||||
def entry_by_ref(ref):
|
||||
e = entry_by_key.get(ref)
|
||||
return e if e and e.get('status')=='published' else None
|
||||
|
||||
|
||||
def gradients(role):
|
||||
settings = theme.get('overrides', {}).get('gradients', {})
|
||||
if not settings.get('enabled'): return ''
|
||||
definition = settings.get('definitions', {}).get(role)
|
||||
if not definition or definition.get('type') != 'linear': return ''
|
||||
stops = ', '.join(str(s['color'])+' '+str(s['at'])+'%' for s in definition['stops'])
|
||||
return f"linear-gradient({definition['angle']}deg, {stops})"
|
||||
|
||||
|
||||
VALID_CONTAINER_MODES = {'boxed','fluid','full'}
|
||||
|
||||
def get_container_config():
|
||||
raw = theme.get('overrides',{}).get('ui',{}).get('container',1080)
|
||||
if isinstance(raw,(int,float)): raw={'mode':'boxed','max_width':int(raw)}
|
||||
raw = raw if isinstance(raw,dict) else {}
|
||||
mode = raw.get('mode','boxed')
|
||||
max_width = int(raw.get('max_width',1080))
|
||||
gutter = {'desktop':36,'tablet':24,'mobile':16} | (raw.get('gutter',{}) or {})
|
||||
if mode not in VALID_CONTAINER_MODES or not 720 <= max_width <= 1920:
|
||||
raise ValueError('Invalid theme container mode/max_width')
|
||||
if any(not isinstance(x,int) or not 0 <= x <= 96 for x in gutter.values()):
|
||||
raise ValueError('Invalid responsive gutters')
|
||||
return {'mode':mode,'max_width':max_width,'gutter':gutter}
|
||||
|
||||
|
||||
def block_layout(block):
|
||||
raw = block.get('layout') or {}
|
||||
defaults = {'section_width':'full' if block['fragment'] in ('hero','cta_banner','site_header','site_footer') else 'inherit', 'content_width':'inherit'}
|
||||
result = defaults | raw
|
||||
for key in defaults:
|
||||
if result[key] not in VALID_CONTAINER_MODES | {'inherit'}:
|
||||
raise ValueError(f"Invalid {key} for {block.get('id')}")
|
||||
return result
|
||||
|
||||
|
||||
def effective_width(mode):
|
||||
return get_container_config()['mode'] if mode=='inherit' else mode
|
||||
|
||||
|
||||
def theme_style():
|
||||
overrides = theme.get('overrides', {})
|
||||
tokens = []
|
||||
for key, value in overrides.get('colors', {}).items(): tokens.append(('--color-'+key, value))
|
||||
for key, value in overrides.get('custom_colors', {}).items(): tokens.append(('--color-'+key.replace('_','-'), value))
|
||||
ui = overrides.get('ui', {})
|
||||
if 'radius' in ui: tokens.append(('--radius', str(ui['radius'])+'px'))
|
||||
container = get_container_config()
|
||||
tokens.extend([('--container', str(container['max_width'])+'px'),
|
||||
('--container-max',str(container['max_width'])+'px'),
|
||||
('--gutter-desktop',str(container['gutter']['desktop'])+'px'),
|
||||
('--gutter-tablet',str(container['gutter']['tablet'])+'px'),
|
||||
('--gutter-mobile',str(container['gutter']['mobile'])+'px')])
|
||||
typography = overrides.get('type', {})
|
||||
for part in ('heading','body'):
|
||||
if part in typography: tokens.append(('--font-'+part, typography[part]))
|
||||
tokens += [('--hero-gradient', gradients('hero') or '#1e2735'),
|
||||
('--button-gradient', gradients('button') or overrides['colors']['accent']),
|
||||
('--cta-gradient', gradients('cta') or overrides['colors']['secondary'])]
|
||||
# Inputs are trusted example tokens; backend must validate typed values before CSS output.
|
||||
return '<style>:root{'+';'.join(k+':'+str(v) for k,v in tokens)+'}</style>'
|
||||
|
||||
|
||||
def render_fragment(block, page, entry, body):
|
||||
fid = block['fragment']
|
||||
if fid not in fragments: raise ValueError(f'Unknown Fragment: {fid}')
|
||||
if block.get('visible') is False or block.get('hidden'): return ''
|
||||
template = env.get_template(str(fragments[fid]/'template.html.j2'))
|
||||
rendered = template.render(
|
||||
props=resolve(block.get('props', {}), page, entry), block=block, page=page, entry=entry,
|
||||
site=site, company=company, menus=menus, site_link=site_link, asset_url=asset_url,
|
||||
query_entries=query_entries, entry_by_ref=entry_by_ref,
|
||||
render_markdown=lambda value: mistune.create_markdown(escape=True)(value), content_body=body,
|
||||
get_form=forms.get)
|
||||
# Section width and inner content width are independent. No raw CSS from editable content.
|
||||
width = block_layout(block)
|
||||
outer = effective_width(width['section_width'])
|
||||
inner = effective_width(width['content_width'])
|
||||
return f'<div class="block-shell" data-section-width="{outer}" data-content-width="{inner}" data-block="{block["id"]}">{rendered}</div>'
|
||||
|
||||
|
||||
def render_page(page, body, route, entry=None):
|
||||
global CURRENT
|
||||
CURRENT = route_path(route)
|
||||
lid = page['layout']
|
||||
layout = layouts[lid]
|
||||
regions = {r['id']:r for r in layout['regions']}
|
||||
allowed = set(regions['main']['allow'])
|
||||
blocks = page.get('regions',{}).get('main', [])
|
||||
for block in blocks:
|
||||
if block['fragment'] not in allowed:
|
||||
raise ValueError(f"{page['title']}: Fragment {block['fragment']} disallowed in layout {lid}")
|
||||
def render_region(name):
|
||||
region = regions[name]
|
||||
source = blocks if name=='main' else region.get('fixed',[])
|
||||
return '\n'.join(render_fragment(block, page, entry, body) for block in source)
|
||||
layout_html = env.get_template(f'layouts/{lid}/layout.html.j2')
|
||||
html = layout_html.render(page=page, site=site, layout_id=lid, container_mode=get_container_config()['mode'], region=render_region,
|
||||
theme_style=theme_style(), static_css=asset_url('assets/site.css'),
|
||||
static_js=asset_url('assets/site.js'))
|
||||
output = OUT / CURRENT
|
||||
output.parent.mkdir(parents=True, exist_ok=True)
|
||||
output.write_text(html, encoding='utf-8')
|
||||
return output
|
||||
|
||||
|
||||
def main():
|
||||
if OUT.exists(): shutil.rmtree(OUT)
|
||||
OUT.mkdir(parents=True)
|
||||
shutil.copytree(ROOT/'assets', OUT/'assets', ignore=shutil.ignore_patterns('manifest.yaml'))
|
||||
documents = []
|
||||
for f in (ROOT/'pages').rglob('*.md'):
|
||||
page, body = parse_md(f)
|
||||
documents.append(render_page(page, body, page['route']))
|
||||
for entry in entries:
|
||||
if entry['status'] != 'published': continue
|
||||
display = load(ROOT/'display'/f"{entry['collection']}.yaml")
|
||||
page = {'title':entry['title'], 'layout':display['layout'],
|
||||
'seo':{'title':entry['title'], 'description':entry['summary']},
|
||||
'regions':display['regions']}
|
||||
documents.append(render_page(page, entry['body'], entry['url'], entry))
|
||||
print(f'Generated {len(documents)} HTML pages at {OUT}')
|
||||
for d in documents: print(' - '+str(d.relative_to(OUT)))
|
||||
|
||||
if __name__=='__main__': main()
|
||||
Reference in New Issue
Block a user