mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
Remove misguided recommendation to use emphasis for variables.
This commit is contained in:
parent
5e439cbbb5
commit
61a55f095b
@ -4,16 +4,13 @@ Inline markup
|
||||
=============
|
||||
|
||||
Sphinx uses interpreted text roles to insert semantic markup into documents.
|
||||
|
||||
Variable names are an exception, they should be marked simply with ``*var*``.
|
||||
|
||||
For all other roles, you have to write ``:rolename:`content```.
|
||||
They are written as ``:rolename:`content```.
|
||||
|
||||
.. note::
|
||||
|
||||
The default role (```content```) has no special meaning by default. You are
|
||||
free to use it for anything you like; use the :confval:`default_role` config
|
||||
value to set it to a known role.
|
||||
free to use it for anything you like, e.g. variable names; use the
|
||||
:confval:`default_role` config value to set it to a known role.
|
||||
|
||||
|
||||
.. _xref-syntax:
|
||||
|
Loading…
Reference in New Issue
Block a user