Sphinx automatizado de numeração imagem / legendas?

Question

Existe uma maneira para gerar automaticamente uma imagem / figura de legenda usando esfinge?

Eu tenho atualmente arquivos resto-esfinge Estou conversão para HTML e (látex) pdf usando esfinge.

Eu gostaria de uma maneira fácil para os usuários para fazer referência a uma imagem específica nos arquivos html / PDF resultante. Por exemplo, se um usuário está se referindo a documentação em um email: "Em 'Imagem 65' diz XXX, mas isso não funciona para mim".

Eu tentei usar figura onde ele aparece para permitir que você aplique uma legenda a uma imagem, mas isso tem de ser adicionado manualmente. (E eu tenho problemas de fazê-la funcionar com substituição por algum motivo).

Existe um método resto-esfinge Eu estou com vista para que conseguir isso? Ou, se existe uma maneira de modificar / modelos existentes de edição de esfinge para adicionar essa capacidade?

Answer 1

Esfinge consome reStructuredText como templated por Jinja . De acordo com a documentação Sphinx, porém, você tem outras opções de templates .

Você deve ser capaz de usar estruturas de controle de Jinja em um modelo personalizado para obter o efeito que você está depois.