vtk-xref 0.1.1

Sphinx extension for linking to VTK class documentation.

vtk-xref is a Sphinx extension for linking directly to VTK’s documentation using the :vtk: reference role.

Installation

1. Add vtk-xref as a project dependency or install it with:

   pip install vtk-xref

2. Add vtk_xref as an extension in your conf.py file used by Sphinx:

extensions = [
    ...,
    'vtk_xref',
]

Usage

• Add links to VTK class documentation with the :vtk: role. For example, write :vtk:`vtkImageData` in docstrings to link directly to the vtkImageData documentation. This will render as vtkImageData.

• Link directly to class members such as methods or enums. For example, write :vtk:`vtkImageData.GetSpacing` to link directly to the GetSpacing method. This will render as vtkImageData.GetSpacing.

• Use ~ to shorten the title for the link and only show the class member after the period. For example, :vtk:`~vtkImageData.GetSpacing` will render as GetSpacing.

• Provide a custom title for the reference. For example, :vtk:`Get Image Spacing <vtkImageData.GetSpacing>` will render as Get Image Spacing

Notes

• The URLs linking to the VTK documentation are checked to ensure they are valid references. A warning is emitted if the reference is invalid, but the role will still try to point to a valid URL where possible. It is recommended to set nitpicky=True in conf.py when using this extension to ensure all links are valid and correct.

• The role does not currently support linking to nested members. For example, linking to an enum member with :vtk:`vtkCommand.EventIds` works, but linking to a specific enum value with :vtk:`vtkCommand.EventIds.PickEvent` does not.