pandorga 1.2.1

data/templates/cv/studio.yml

@@ -0,0 +1,200 @@
+# Studio fragment for the CV template (jobs, products, profile data).
+# Refs: PLT-AC-3, docs/spec.md §5.5
+group: curriculum
+group_label: Curriculum
+needs_media: false
+collections:
+  jobs:
+    label: Jobs
+    type: collection
+    format: yaml-frontmatter
+    filename: "{primary}.md"
+    operations:
+      delete: false
+    view:
+      primary: position
+      fields: [company, position, department, engagement, start, end]
+      list_meta_fields: [company, engagement, start, end]
+    fields:
+      - name: position
+        label: Position
+        type: string
+        required: true
+      - name: company
+        label: Company
+        type: string
+        required: true
+      - name: location
+        label: Location
+        type: string
+      - name: start
+        label: Start
+        type: string
+      - name: end
+        label: End
+        type: string
+      - name: department
+        label: Department
+        type: string
+      - name: engagement
+        label: Engagement
+        type: select
+        required: true
+        options:
+          values: [permanent, fixed_term, founding, internship, research]
+      - name: products
+        label: Products
+        type: reference
+        description: "Products listed under this job."
+        options:
+          collection: products
+          multiple: true
+          search: "product,title,company"
+          value: "{primary}"
+          label: "{product} ({company})"
+      - name: body_public
+        component: markdown_body
+        label: Public body
+        description: "The only body that reaches the public CV page."
+      - name: body_extended
+        component: markdown_body
+        label: Extended body
+        description: "Extended CV only; not exported to the public site."
+  products:
+    label: Products
+    type: collection
+    format: yaml-frontmatter
+    filename: "{key}.md"
+    operations:
+      delete: false
+    view:
+      primary: product
+      fields: [company, product, start_date, end_date, key]
+      list_meta_fields: [company, start_date, end_date]
+    fields:
+      - name: layout
+        label: Layout
+        type: string
+        hidden: true
+        default: product
+      - name: key
+        label: Key
+        type: string
+        required: true
+        description: "URL slug (/products/key/) and citation handle."
+      - name: title
+        label: Title
+        type: string
+        required: true
+      - name: product
+        label: Product name
+        type: string
+        required: true
+      - name: company
+        label: Company
+        type: string
+        required: true
+      - name: start_date
+        label: Start date
+        type: string
+      - name: end_date
+        label: End date
+        type: string
+      - name: external_url
+        label: External URL
+        type: string
+      - name: redirects
+        label: Redirects
+        type: string
+        list: true
+      - name: body
+        component: markdown_body
+profile:
+  group: profile
+  group_label: Profile
+  files:
+    - name: contacts
+      label: Contact
+      type: file
+      path: content/collections/data/contacts.yml
+      format: yaml
+      list: true
+      fields:
+        - name: name
+          label: Name
+          type: string
+          required: true
+        - name: badge
+          label: Badge
+          type: string
+        - name: href
+          label: Link
+          type: string
+          required: true
+          description: "Full URL, or mailto:… for an address."
+        - name: icon
+          label: Icon
+          type: string
+    - name: education
+      label: Education
+      type: file
+      path: content/collections/data/education.yml
+      format: yaml
+      list: true
+      fields:
+        - name: degree
+          label: Degree
+          type: string
+          required: true
+        - name: institution
+          label: Institution
+          type: string
+          required: true
+        - name: location
+          label: Location
+          type: string
+        - name: start
+          label: Start
+          type: string
+        - name: end
+          label: End
+          type: string
+        - name: detail
+          label: Detail
+          type: text
+    - name: languages
+      label: Languages
+      type: file
+      path: content/collections/data/languages.yml
+      format: yaml
+      list: true
+      fields:
+        - name: name
+          label: Name
+          type: string
+          required: true
+        - name: level
+          label: Level
+          type: string
+    - name: skills
+      label: Skills
+      type: file
+      path: content/collections/data/skills.yml
+      format: yaml
+      fields:
+        - name: leadership
+          label: Leadership
+          type: string
+          list: true
+        - name: technical
+          label: Technical
+          type: object
+          list: true
+          fields:
+            - name: group
+              label: Group
+              type: string
+            - name: skills
+              label: Skills
+              type: string
+              list: true

data/templates/cv/template.yml

@@ -0,0 +1,25 @@
+name: cv
+collection_slots:
+  - name: jobs
+    required: true
+    contract: job
+  - name: products
+    required: true
+    contract: product
+  - name: profile
+    required: false
+    contract: data
+nav:
+  group: Profile
+home:
+  band: hero
+export_fields:
+  - title
+  - key
+  - company
+  - role
+  - start
+  - end
+  - location
+  - summary
+  - body_public

data/templates/media/README.md

@@ -0,0 +1,38 @@
+# Template: media
+
+Catalogue of external sources and media links (the site label is often
+Sources). One collection of resource entries; detail is query-based
+(`?resource=`).
+
+## Required registry keys
+
+| Key | Role |
+|---|---|
+| `key` | Page id |
+| `template` | Must be `media` |
+| `collection` | Resources folder under `content/collections/` |
+| `path` | Listing URL |
+
+Optional: `title`, `nav`, `home` (default is a references index panel).
+
+## Collection contract
+
+`title`, `key`, `link`, `medium`, `category`, optional body.
+
+## Configuration
+
+```yaml
+- key: resources
+  template: media
+  title: Sources
+  collection: resources
+  path: /pages/sources/
+  nav: { group: References, icon: media_link }
+  home: { band: index, group: references }
+```
+
+## Package layout
+
+- `template.yml` — slots and home defaults
+- `fixtures/` — minimal sample front matter
+- `screenshots/` — capture notes (manual or CI later)

data/templates/media/fixtures/resource.md

@@ -0,0 +1,7 @@
+---
+title: Example Style Guide
+key: style-guide
+link: https://example.org/style
+medium: web
+category: reference
+---

data/templates/media/screenshots/README.md

@@ -0,0 +1,6 @@
+# Screenshots
+
+Capture the media / sources listing manually or in CI visual inspection.
+PLT-AC-4 requires a screenshot for this template; place PNG or WebP files
+here when available. This directory fulfills the package contract until
+automated capture lands.

data/templates/media/studio.yml

@@ -0,0 +1,58 @@
+# Studio fragment for the media (sources) template.
+# Refs: PLT-AC-3, docs/spec.md §5.5
+group: references
+group_label: References
+needs_media: true
+collection:
+  label: Sources
+  type: collection
+  format: yaml-frontmatter
+  filename: "{primary}.md"
+  operations:
+    delete: false
+  view:
+    primary: name
+    fields: [name, category, type, language]
+    list_meta_fields: [category, type, language]
+  fields:
+    - name: key
+      label: Citation key
+      type: string
+      description: "Only when writing cites this source."
+    - name: name
+      label: Name
+      type: string
+      required: true
+    - name: link
+      label: Link
+      type: string
+      required: true
+      description: "Public URL for the source."
+    - name: category
+      label: Category
+      type: select
+      options:
+        values: [Academic, Communication, Humor, Music, Professional]
+    - name: type
+      label: Type
+      type: select
+      options:
+        values: [document, podcast, website, youtube]
+    - name: language
+      label: Language
+      type: select
+      description: "Studio sorting only."
+      options:
+        values: [en_us, en_gb, pt_br, fr_fr]
+    - name: thumbnail
+      label: Thumbnail
+      type: image
+      description: "HTTPS URL or /media/… path."
+      options:
+        media: images
+        path: content/media/images/covers/sources
+        rename: safe
+    - name: description
+      component: markdown_body
+      label: Description
+      required: true

data/templates/media/template.yml

@@ -0,0 +1,17 @@
+name: media
+collection_slots:
+  - name: collection
+    required: true
+    contract: resource
+nav:
+  group: References
+home:
+  band: index
+  group: references
+export_fields:
+  - title
+  - key
+  - link
+  - medium
+  - category
+  - body

data/templates/network/README.md

@@ -0,0 +1,34 @@
+# Template: network
+
+Graph of writing connections derived from other registry pages. No collection
+slot of its own; `sources` lists the page keys (or writing collections) whose
+entries feed the graph.
+
+## Required registry keys
+
+| Key | Role |
+|---|---|
+| `key` | Page id |
+| `template` | Must be `network` |
+| `sources` | Array of page keys or writing collections to read |
+| `path` | Listing URL |
+
+Optional: `title`, `nav`, `home` (default is a references index panel).
+
+## Configuration
+
+```yaml
+- key: network
+  template: network
+  title: Network
+  sources: [articles, blog]
+  path: /pages/network/
+  nav: { group: References, icon: flowchart }
+  home: { band: index, group: references }
+```
+
+## Package layout
+
+- `template.yml` — sources contract and home defaults
+- `fixtures/` — minimal sample JSON describing expected source keys
+- `screenshots/` — capture notes (manual or CI later)

data/templates/network/fixtures/sources.json

@@ -0,0 +1,3 @@
+{
+  "sources": ["articles", "blog"]
+}

data/templates/network/screenshots/README.md

@@ -0,0 +1,6 @@
+# Screenshots
+
+Capture the network graph page manually or in CI visual inspection.
+PLT-AC-4 requires a screenshot for this template; place PNG or WebP files
+here when available. This directory fulfills the package contract until
+automated capture lands.

data/templates/network/studio.yml

@@ -0,0 +1,28 @@
+# Studio fragment for the network template.
+# Network derives from pages listed under `sources`; there is no collection
+# to edit. A page-chrome file keeps Studio aware the page is registered.
+# Refs: PLT-AC-3, docs/spec.md §5.5
+group: pages
+group_label: Pages
+view_only: true
+files:
+  - name: page_network
+    label: Network
+    type: file
+    path: content/pages/headers.yml
+    format: yaml
+    root_key: network
+    description: "Listing page chrome. The graph itself is derived from sources."
+    fields:
+      - name: title
+        label: Title
+        type: string
+      - name: accent
+        label: Accent
+        type: select
+        options:
+          values: [green, ochre, blue, slate]
+      - name: tags
+        label: Tags
+        type: string
+        list: true

data/templates/network/template.yml

@@ -0,0 +1,10 @@
+name: network
+collection_slots: []
+sources:
+  required: true
+  description: Page keys or writing collections that feed the graph
+nav:
+  group: References
+home:
+  band: index
+  group: references

data/templates/portfolio/README.md

@@ -0,0 +1,39 @@
+# Template: portfolio
+
+Project catalogue rendered as a grid of system cards. One collection of
+project entries with optional detail pages.
+
+## Required registry keys
+
+| Key | Role |
+|---|---|
+| `key` | Page id |
+| `template` | Must be `portfolio` |
+| `collection` | Projects folder under `content/collections/` |
+| `path` | Listing URL |
+| `detail` | Detail route pattern, for example `/projects/:slug/` |
+
+Optional: `title`, `nav`, `home` (default limit 4).
+
+## Collection contract
+
+`title`, `key`, `sort_order`, `start_date`, `status`, `tags`, Markdown body.
+
+## Configuration
+
+```yaml
+- key: projects
+  template: portfolio
+  title: Projects
+  collection: projects
+  path: /pages/projects/
+  detail: /projects/:slug/
+  nav: { group: Profile, icon: terminal }
+  home: { limit: 4 }
+```
+
+## Package layout
+
+- `template.yml` — slots, detail route, export fields
+- `fixtures/` — minimal sample front matter
+- `screenshots/` — capture notes (manual or CI later)

data/templates/portfolio/fixtures/project.md

@@ -0,0 +1,10 @@
+---
+title: Demo Kit
+key: demo-kit
+sort_order: 1
+start_date: 2025-01-01
+status: ongoing
+tags: [tools]
+---
+
+A fictional portfolio project for the template fixture.

data/templates/portfolio/screenshots/README.md

@@ -0,0 +1,6 @@
+# Screenshots
+
+Capture the portfolio / projects grid manually or in CI visual inspection.
+PLT-AC-4 requires a screenshot for this template; place PNG or WebP files
+here when available. This directory fulfills the package contract until
+automated capture lands.

data/templates/portfolio/studio.yml

@@ -0,0 +1,89 @@
+# Studio fragment for the portfolio (projects) template.
+# Refs: PLT-AC-3, docs/spec.md §5.5
+group: portfolio
+group_label: Portfolio
+needs_media: true
+collection:
+  label: Projects
+  type: collection
+  format: yaml-frontmatter
+  filename: "{key}.md"
+  operations:
+    delete: false
+  view:
+    primary: project
+    fields: [thumbnail, project, start_date, end_date, icon, key, status, sort_order]
+    list_meta_fields: [status, start_date, end_date]
+  fields:
+    - name: layout
+      label: Layout
+      type: string
+      hidden: true
+      default: project
+    - name: key
+      label: Key
+      type: string
+      required: true
+      description: "URL slug (/projects/key/) and citation handle."
+    - name: title
+      label: Title
+      type: string
+      required: true
+    - name: project
+      label: Project name
+      type: string
+      required: true
+    - name: tagline
+      label: Tagline
+      type: text
+    - name: start_date
+      label: Start date
+      type: string
+    - name: end_date
+      label: End date
+      type: string
+    - name: status
+      label: Status
+      type: select
+      options:
+        values: [ongoing, completed]
+    - name: label
+      label: Label
+      type: string
+      description: "Small caps line above the project name."
+    - name: icon
+      label: Icon
+      type: string
+      description: "Material Symbols name (e.g. memory, forest)."
+    - name: tags
+      label: Tags
+      type: string
+      list: true
+      description: "Chips on the card; free text."
+    - name: thumbnail
+      label: Thumbnail
+      type: image
+      description: "HTTPS URL or /media/… path."
+      options:
+        media: images
+        path: content/media/images/covers/projects
+        rename: safe
+    - name: external_url
+      label: External URL
+      type: string
+    - name: article_url
+      label: Article URL
+      type: string
+    - name: github
+      label: GitHub URL
+      type: string
+    - name: sort_order
+      label: Sort order
+      type: number
+      description: "Lowest first in the listing."
+    - name: redirects
+      label: Redirects
+      type: string
+      list: true
+    - name: body
+      component: markdown_body

data/templates/portfolio/template.yml

@@ -0,0 +1,18 @@
+name: portfolio
+collection_slots:
+  - name: collection
+    required: true
+    contract: project
+detail: /projects/:slug/
+nav:
+  group: Profile
+home:
+  limit: 4
+export_fields:
+  - title
+  - key
+  - sort_order
+  - start_date
+  - status
+  - tags
+  - body