cross-reference
Is there YAML syntax for sharing part of a list or map?
The merge key type is probably what you want. It uses a special << mapping key to indicate merges, allowing an alias to a mapping (or a sequence of such aliases) to be used as an initializer to merge into a single mapping. Additionally, you can still explicitly override values, or add more that weren’t … Read more
How do I make a reference to a figure in markdown using pandoc?
In pandoc you can even do: ![This is the caption\label{mylabel}](/url/of/image.png) See figure \ref{mylabel}.
Link to class method in Python docstring
The solution that works for Sphinx is to prefix the reference with ~. Per the Sphinx documentation on Cross-referencing Syntax, If you prefix the content with ~, the link text will only be the last component of the target. For example, :py:meth:`~Queue.Queue.get` will refer to Queue.Queue.get but only display get as the link text. So … Read more
Adding a cross-reference to a subheading or anchor in another page
The expression “reST/Sphinx” makes the scope of the question unclear. Is it about reStructuredText in general and Sphinx, or only about reStructuredText as used in Sphinx (and not reStructuredText in general)? I’m going to cover both since people using RST are likely to run into both cases at some point: Sphinx Besides the domain-specific directives … Read more
What do the &,
The & marks an alias for the node (in your example &default aliases the development node as “default”) and the * references the aliased node with the name “default”. The <<: inserts the content of that node. Allow me to quote the YAML spec here: Repeated nodes (objects) are first identified by an anchor (marked … Read more