# Profiles

HTML: [altophp.com/rst/parsing/profiles](https://altophp.com/rst/parsing/profiles/)

A profile defines the directives, roles, handlers, and extension behavior
available during parsing and later operations.

```php
use Alto\Rst\Rst;

$docutils = Rst::docutils();
$sphinx = Rst::sphinx();
$symfony = Rst::symfony();
```

| Profile | Use for |
| --- | --- |
| [Docutils](profiles/docutils.md) | Portable reStructuredText. |
| [Sphinx](profiles/sphinx.md) | Sphinx roles, directives, and cross-document conventions. |
| [Symfony](profiles/symfony.md) | Symfony documentation and its public extension behavior. |

Choose the narrowest profile that recognizes the source. The selected profile
stays attached to parse, render, lint, fix, format, statistics, and conversion
operations.

`Profile::withExtension()` returns a new profile. Later extensions replace a
handler, pass, rule, or statistics provider with the same normalized name.
Read [Extensions](https://altophp.com/rst/extensions.md) before installing trusted behavior.

---

Previous: [Parsing](https://altophp.com/rst/parsing.md)
Next: [Docutils](https://altophp.com/rst/parsing/profiles/docutils.md)

---

ALTO\RST: [altophp.com/rst](https://altophp.com/rst/)
ALTO(PHP): [altophp.com](https://altophp.com/)