Symbolic Engineering website

This site is built with Hugo from Org mode content.

Editing content

All page content lives under content/ as .org files:

• content/_index.org is the home page.
• content/about/index.org, content/contact/index.org, and content/use-cases/index.org are standalone pages.
• content/product/_index.org is the product overview.
• content/product/*/index.org are product module pages.
• content/blog/_index.org is the blog index.

The pages use normal Org front matter, for example:

#+TITLE: Page title
#+DESCRIPTION: Search result description.
#+OG_TITLE: Social preview title
#+OG_DESCRIPTION: Social preview description
#+EYEBROW: Page label
#+HEADING: Visible page heading

Use regular Org for copy, headings, emphasis, and links:

#+attr_html: :class lede
This paragraph renders as the opening lede.

* Section heading

Text can link to [[/product/][Product]] and use *strong* or /emphasized/ text.

Use Org special blocks when a section needs a layout class:

* [[/product/model-context-layer/][Model Context Layer]]

The card body remains editable Org.

Keep #+begin_export html blocks small. They are only needed where Org has to hand control to Hugo shortcodes or exact visual markup. Diagrams are inserted with Hugo shortcodes that inline committed SVG assets from img/:

{{< diagram "mark-sm" >}}

{{< diagram "reliability" >}}

*Figure 1* Caption text stays editable as Org.

Blog posts

Create a post with:

hugo new blog/my-post.org

New posts start as drafts from archetypes/blog.org. Remove #+DRAFT: true when the post is ready to publish.

Local development

With Hugo available:

make run

With Nix:

nix run

Both serve the site at http://localhost:1313/.

Build

make
nix build

The deployable artifact is the Nix package output. public/ and resources/ are generated locally and ignored by Git.