███╗ ██╗███╗ ██╗ ██████╗███╗ ███╗███████╗ ███████╗████████╗ █████╗ ██████╗ ████████╗███████╗██████╗
████╗ ██║████╗ ██║ ██╔════╝████╗ ████║██╔════╝ ██╔════╝╚══██╔══╝██╔══██╗██╔══██╗╚══██╔══╝██╔════╝██╔══██╗
██╔██╗ ██║██╔██╗ ██║ ██║ ██╔████╔██║███████╗ ███████╗ ██║ ███████║██████╔╝ ██║ █████╗ ██████╔╝
██║╚██╗██║██║╚██╗██║ ██║ ██║╚██╔╝██║╚════██║ ╚════██║ ██║ ██╔══██║██╔══██╗ ██║ ██╔══╝ ██╔══██╗
██║ ╚████║██║ ╚████║ ╚██████╗██║ ╚═╝ ██║███████║ ███████║ ██║ ██║ ██║██║ ██║ ██║ ███████╗██║ ██║
╚═╝ ╚═══╝╚═╝ ╚═══╝ ╚═════╝╚═╝ ╚═╝╚══════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝
The shared visual settings for this starter live in system/config/site_theme.py. The file is plain Python, and each function returns a value used by the renderer, templates, or directives. You can treat this file as the shared presentation layer for the whole site.
Common customizations are:
- Rename the site by changing site_name() and site_tagline()
- Restyle the site by changing the color functions
- Replace the banner art in banner_text()
- Change the downloads action label if you want something other than "Download"
Currently, site_theme.py controls the following:
Site identity
These values are used in shared page chrome such as the footer and header context.
python
def site_name():
return "NomadNet CMS Starter"
def site_tagline():
return "A reusable NomadNet site starter built from Markdown and Micron."
Global colors
These color functions define the main foreground, secondary foreground, background, and link colors used across the site.
python
def primary_color():
return "f6d"
def secondary_color():
return "b9c"
def primary_background_color():
return "222"
def link_color():
return "4cf"
Code blocks
These values control how fenced code blocks are labeled and styled after Markdown is converted to Micron.
python
def code_block_foreground_color():
return "ddd"
def code_block_label_color():
return secondary_color()
def code_block_background_color():
return "222"
def code_block_indent():
return " "
Downloads directive
These values change the appearance of the downloads table and the action link label.
python
def downloads_name_column_width():
return 28
def downloads_size_column_width():
return 10
def downloads_type_column_width():
return 12
def downloads_action_label():
return "Download"
Embedded images
These values control the default size and collapsed behavior for ASCII image rendering.
python
def ascii_image_default_width():
return 60
def ascii_image_max_width():
return 100
def ascii_image_collapse_mode():
return "threshold" # "never", "always", or "threshold"
def ascii_image_inline_threshold_bytes():
return 4096
def ascii_image_show_fast_label():
return "Show fast"
def ascii_image_show_truecolor_label():
return "Show truecolor"
def ascii_image_truecolor():
return False
Set ascii_image_collapse_mode to control default behavior: never, always, or threshold. In threshold mode, images collapse when rendered output exceeds ascii_image_inline_threshold_bytes.
When ascii_image_truecolor is enabled and an image is collapsed, users get two expand options: one for fast (smaller) palette output and one for full truecolor output.
Some clients/browsers - like NomadNet 0.9.9 - support true color (24 bit) images, which look much better than 256 colour images. If you want to render images in 24 bit detail, set ascii_image_truecolor to True.
Header and footer content
The banner, footer identity line, and last-updated note are also defined in the theme file.
python
def header_alignment():
return "r"
def banner_indent():
return " "
def banner_text():
return """
███╗ ██╗███╗ ██╗ ██████╗███╗ ███╗███████╗ ███████╗████████╗ █████╗ ██████╗ ████████╗███████╗██████╗
████╗ ██║████╗ ██║ ██╔════╝████╗ ████║██╔════╝ ██╔════╝╚══██╔══╝██╔══██╗██╔══██╗╚══██╔══╝██╔════╝██╔══██╗
██╔██╗ ██║██╔██╗ ██║ ██║ ██╔████╔██║███████╗ ███████╗ ██║ ███████║██████╔╝ ██║ █████╗ ██████╔╝
██║╚██╗██║██║╚██╗██║ ██║ ██║╚██╔╝██║╚════██║ ╚════██║ ██║ ██╔══██║██╔══██╗ ██║ ██╔══╝ ██╔══██╗
██║ ╚████║██║ ╚████║ ╚██████╗██║ ╚═╝ ██║███████║ ███████║ ██║ ██║ ██║██║ ██║ ██║ ███████╗██║ ██║
╚═╝ ╚═══╝╚═╝ ╚═══╝ ╚═════╝╚═╝ ╚═╝╚══════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝
"""
def footer_identity():
return f"{site_name()} - {site_tagline()}"
NomadNet CMS Starter - A reusable NomadNet site starter built from Markdown and Micron.
Page last updated 03/06/2026 13:36