# MantisBT Syntax & Formatting Guide

Questa installazione di MantisBT utilizza un plugin di formattazione avanzato che estende la sintassi base e aggiunge funzionalita' specifiche, in particolare per i blocchi di codice. 
Quando viene iniettata un'analisi tecnica o formattata una sezione (in particolare `Steps To Reproduce`), e' di fondamentale importanza utilizzare il dialect corretto.

## 1. Regole Markdown e Compatibilità Standard
- **Intestazioni**: Utilizzare formati standard Markdown (`#`, `##`, `###`).
- **Composizione Base**: Liste puntate (`- `, `* `), liste numerate (`1. `), grassetto (`**bold**`), corsivo (`*italic*`).
- **Fallback Testuali**: A causa della eterogenea renderizzazione di default di Mantis, è storicamente prassi inserire un fallback testuale in grassetto subito sotto certe intestazioni (es. `## Riferimenti tecnici` seguito da `**RIFERIMENTI TECNICI**`), ma il plugin di formattazione moderno gestisce correttamente gran parte del Markdown.

## 2. Blocchi di Codice (Code Blocks)
Il plugin di formattazione offre rendering avanzato:
- Utilizzare SEMPRE i **tripli backtick** (`` ` ` ` ``) per aprire un blocco di codice al posto dei vecchi tag `<pre>`.
- **Specificare sempre la lingua** (es. ````php````, ````sql````, ````cfml````, ````js````) per abilitare l'evidenziazione semantica. MantisBT abilita la visibilità del linguaggio e l'accoppiamento delle parentesi (matching braces).
- **Line numbers**: Vengono generati e mostrati automaticamente grazie alle opzioni attive sul plugin. Mai includere finti numeri di riga nel testo del codice.
- **Evidenziazione estesa Diff**: Per visualizzare modifiche e differenze, si puo' utilizzare la sintassi `diff`. 
  - E' possibile combinare diff e uno specifico linguaggio usando il formato `diff-lingua` (es: ````diff-php````, ````diff-javascript````).
  - All'interno del blocco `diff`, usare i prefissi classici (`+` per aggiunte, `-` per rimozioni). Questo colorera' lo sfondo della riga invece del testo e applichera' l'evidenziazione specifica del linguaggio di base.

Esempio di Diff specializzato:
````text
```diff-php
- $vecchia_variabile = 1;
+ $nuova_variabile = 1;
```
````

## 3. Formattazione di Contenuti Analitici (`mcp-technical-analyst`)
Quando sottometti in `mcp-mantis-ticket-writer` l'output generato da `mcp-technical-analyst`:
1. **Preserva** la struttura Markdown (liste, citazioni, tabelle) dell'analisi in quanto compatibile con MantisBT.
2. Controlla e, se necessario, **avvolgi** eventuali tracce di codice o stacktrace nei tripli backtick dichiarandone esplicitamente la lingua.
3. Se l'analisi presenta una comparazione del codice ("prima e dopo"), sfrutta la funzionalita' `diff-<lingua>` per renderla nativamente intelligibile in Mantis.