2017-09-19 10 views
0

어떻게하면 다음과 같은 결과를 얻을 수 있는지 궁금합니다. 나는 자동 문서화를 생성하기 위해 스핑크스 autodoc과 함께 numpy docstring 스타일을 사용하고있다. 그러나, 나는 출력에 중첩 된 목록을 가지고에 struggeling 해요 :스핑크스와 함께 numst docstring에 중첩리스트를 올바르게 추가하는 방법

Attributes 
---------- 
attribute 1: pandas data frame 
    * `index:` Array-like, integer valued representing 
      days. Has to be sorted and increasing. 
    * `dtype:` float64. Value of temperature. 
    * `columns:` location description, e.g. 'San Diego' 
attribute 2: `int` 
    nice and sunny days in California 

이 문서화 문자열의 출력은 해제 완료입니다.

def generate_temp(self, n, freq, very_long_variable_name, 
        type_temp=None, method=None): 

또한 여기 스핑크스 완전한 기능을 인식하지 않고, 독립적으로 제 라인 처리 :이 함수의 설명은 복수의 라인에 걸쳐 다른 우선 속성 1.

대한리스트를 인식하지 먼저.

내 서식이 잘못 되었습니까?

+0

'sphinx.ext.napoleon' (http://www.sphinx-doc.org/en/stable/ext/napoleon.html)을 사용하고 있습니까? – mzjn

+0

@mzjn 네, 맞습니다. 나폴레옹을 사용하고 있습니다. – math

답변

1

NumPy docstrings in Napoleon을 사용하면 콜론의 양쪽에 공백이 있어야합니다. 이 시도 :

Attributes 
---------- 
attribute 1 : pandas data frame 
    * `index:` Array-like, integer valued representing 
     days. Has to be sorted and increasing. 
    * `dtype:` float64. Value of temperature. 
    * `columns:` location description, e.g. 'San Diego' 
attribute 2 : `int` 
    nice and sunny days in California 

을 그 작동 경우 example NumPy strings는 단락이 지원하고 있음을 나타냅니다으로 나는 모른다. 목록에 대해서는 언급하지 않습니다.

+0

답변 해 주셔서 감사합니다. 불행히도이 방법으로는 문제가 해결되지 않습니다. 나는 정말로 그러한 경우 목록을 포함시킬 수 있는지 궁금합니다 – math

+0

적어도 콜론의 양쪽에 공간을 두 었습니까? 또한 [소스 코드] (https://bitbucket.org/RobRuana/sphinx-contrib/src/a311ef7908cb1cca880dcc32aae89a297ab21e0c/napoleon/sphinxcontrib/napoleon/docstring.py?at=default&fileviewer=file-view-default#docstring)를 살펴 보았습니다. py-28), 글 머리 기호 목록이 지원되는 것으로 보입니다. 나는 첫 번째 항목의 두 번째 줄에 들여 쓰기에 문제가 있다고 생각하는데, 나는 방금 수정하여 수정했다. –