Sphinx: Difference between revisions

From 탱이의 잡동사니
Jump to navigation Jump to search
No edit summary
Line 36: Line 36:
</pre>
</pre>
다음의 캐릭터들들만 tag 에 사용할 수 있다.  [a-z, A-Z, 0-9, _]
다음의 캐릭터들들만 tag 에 사용할 수 있다.  [a-z, A-Z, 0-9, _]
== Errors ==
=== make latexpdf ===
latexpdf 를 만들 때, 다음과 다음과 같은 에러를 만나는 경우가 있다. 단순히 패키지 미설치로 인한 오류이며 해당 패키지를 설치해주면 문제는 해결된다.
<pre>
! LaTeX Error: File `cmap.sty' not found.
or
! Font T1/cmr/m/n/10=ecrm1000 at 10.0pt not loadable: Metric (TFM) file not found.
</pre>
다음의 명령어를 실행하면 된다.
<source lang=bash>
$ sudo apt-get install texlive-latex-recommended
$ sudo apt-get install texlive-fonts-extra
</source>


== See also ==
== See also ==

Revision as of 23:25, 7 July 2016

Overview

Sphinx 사용 법 정리.

Miscellaneous markup

다음의 추가적인 Markup 을 사용 할 수 있다.

Tables

Table 항목에 다음의 속성 항목들을 사용할 수 있다.

tabularcolumns

테이블의 칼럼 속성을 지시할 수 있다. LaTex tabulary package 의 인자값으로 사용된다.

 .. tabularcolumns:: column spec

column spec 값으로는 다음의 값들이 사용 가능하다. Sphinx 에서는 기본값으로 모든 column 에 L 값을 지정한다.

  • L flush left column with automatic width
  • R flush right column with automatic width
  • C centered column with automatic width
  • J justified column with automatic width

다음과 같이 사용된다.

.. tabularcolumns:: |r|l|

Including content based on tags

특정 Tag 가 지정될 때에만 항목을 참조하도록 만들 수 있다.

.. only:: <expression>

만약 반드시 두 개 이상의 tag 가 반드시 설정되어야만 허용되도록 하고 싶다면 다음과 같이 하면 된다. tag 지정시 -t 옵션을 사용하거나 conf.py 파일에 설정하면된다.

.. only:: html and draft

다음의 캐릭터들들만 tag 에 사용할 수 있다. [a-z, A-Z, 0-9, _]

Errors

make latexpdf

latexpdf 를 만들 때, 다음과 다음과 같은 에러를 만나는 경우가 있다. 단순히 패키지 미설치로 인한 오류이며 해당 패키지를 설치해주면 문제는 해결된다.

! LaTeX Error: File `cmap.sty' not found.
or
! Font T1/cmr/m/n/10=ecrm1000 at 10.0pt not loadable: Metric (TFM) file not found.

다음의 명령어를 실행하면 된다. <source lang=bash> $ sudo apt-get install texlive-latex-recommended $ sudo apt-get install texlive-fonts-extra </source>

See also