Я был заинтересован в документировании python некоторое время, но я не могу понять, почему @author по умолчанию sytnax в шаблонах python. Почему это не так: автор: (в стиле реструктурированного текста)?Почему Eclipse Pydev использует @author в шаблоне по умолчанию
С какой причине используется синтаксис с @, а не с:
Я хоть что ReStructuredText является наиболее распространенным в мире питона.
Epytext Markup language - это то, что вы ищете. Это язык epydoc.
Он использует префикс @, с такими словами, как param, type, return, raise и т.д.
И epytext настолько распространен, что pydev имеет его как шаблон по умолчанию? И может быть что-то вроде svn или что-то еще? – Karlvonbahnhof
Можете ли вы уточнить? чего вы пытаетесь достичь? Что вы подразумеваете под «не может ли быть» ...? – shx2
Я думал, что, возможно, svn использует эти атрибуты, но это, вероятно, ерунды. – Karlvonbahnhof
Используется ли этот вопрос о языке разметки, или конкретно 'директивы @ author'? – shx2
Я отредактировал вопрос. Может быть, сейчас более конкретный. Мне кажется, что реструктурированный текст наиболее распространен, но в шаблоне используется другой стиль. Боюсь, я пропустил какой-то важный инструмент. – Karlvonbahnhof