w tym treści dynamiczne w dokumentacji wygenerowanej przez python-sphinx

Question

Używam sfinksa do generowania dokumentacji dla mojego projektu i budowania dokumentacji w ramach procesu instalacji produktu. Chciałbym dynamicznie dołączyć nazwę hosta do tekstu i/lub bloków kodu. Nie widziałem żadnych wyjaśnień w dokumentacji jakiegokolwiek narzędzia do włączania wyjścia polecenia powłoki lub czegokolwiek innego niż określone linie z określonego pliku. Czy ta zdolność istnieje?

Answer 1

Oto dwa Sphinx extensions, że może to zrobić:

• autorun: wykonuje kodu Pythona w runblock dyrektyw, oddaje moc i wstawia go do dokumentów.
• programoutput: wykonuje dowolne polecenia przy użyciu dyrektywy program-output i wstawia dane wyjściowe do dokumentów.