Wygeneruj DITA xml z docstring - python, dokumentacja, restructuredextext, dita

Muszę udokumentować mój projekt za pomocą DITA i zastanawiam się, czy mogę użyć konwencji docstring Pythona i reStructuredText stworzyć XML-a DITA.

Jakieś wskazówki?

Odpowiedzi:

Przykro mi, że trochę spóźniłem się na to pytanie, ale wykonałem kilka prac w tym kierunku i umieściłem wynikowy zestaw w tym repozytorium:

https://github.com/donrday/rst2dita

Mam nadzieję, że jest coś, z czego ty lub inni możecie skorzystać.

Myślę, że możesz to zrobić

• Przetwarzasz swoje dokumenty Pythona używając Sfinks i jego autodoc składnia

• Piszesz niestandardowy formatter wyjściowy do Sphinx, który wygeneruje XML DITA zamiast HTML

Niektóre działają, ale wykonalne.