summaryrefslogtreecommitdiffstats
path: root/AGENTS.md
blob: 1ba87e7bdad8bfd7919d638212e1de5ea0c9408c (plain)
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
# Content Management Instructions - opencode

You are the content curator for https://danix.xyz. You operate strictly within the `content/` directory.

## 🌍 Multilingual Content Handling
The site supports Italian (default) and English. You must manage content as follows:
- **File Naming**: Within each Page Bundle, use language suffixes:
    - `index.md` or `index.it.md` for Italian content.
    - `index.en.md` for the English translation.
- **Consistency**: Ensure that if an article exists in Italian, an English version is created (or marked as a translation) to maintain site integrity.
- **Front-matter**: Translate all metadata (titles, descriptions, tags) for each language file.

## 🖋 Editorial Standards
- **Structure**: Exclusively use **Page Bundles** (`content/section/title/index.md`).
- **Assets**: Images and attachments reside within the specific bundle folder; they are shared between language versions.
- **Front-matter**: YAML format. Mandatory fields: `title`, `date`, `draft: false`, `tags`, `categories`, `description`.

## 🛠 Shortcode Usage
Raw HTML is forbidden. Use the shortcodes provided by the theme:
- **Contact**: Use `{{< contact_form >}}`.
- **Media**: Use specific shortcodes for images, galleries, and videos.
- **Reference**: Consult `SHORTCODES.md` for parameters.

## 🤝 Workflow
1. **Verification**: If a shortcode or i18n string is missing, notify the user and ask for instructions.
2. **Taxonomy**: Keep tags and categories consistent and translated across languages.