이미지, 동영상, 오디오, 다운로드¶
자원은 이를 설명하는 문서 가까이에 두세요. 상대 경로를 쓰거나 /로 시작해 소스 루트를 기준으로 지정하세요. Guidedog는 문서에서 쓰는 자원을 복사합니다. 동영상은 웹에서 재생되며 PDF에는 녹화 내용을 표시합니다.
이미지¶
.. image:: diagrams/pipeline.png
:alt: The build pipeline
:width: 480px
.. figure:: /screenshots/search.png
Searching the site.
페이지는 이미지를 _images로 복사하고 책은 포함합니다. PNG, JPEG, GIF, SVG, WebP는 둘 다 지원합니다. 이미지가 없으면 경고하며, 페이지는 대체 텍스트를 남기고 책은 이미지를 제외합니다.
동영상과 오디오¶
동영상(.mp4, .webm, .ogv, .mov, .m4v) 또는 오디오(.mp3, .ogg, .oga, .m4a, .opus, .wav, .flac, .aac)를 지정한 image나 figure는 미디어를 재생합니다. Docutils의 동영상 처리와 같은 방식입니다.
.. figure:: media/tour.mp4
:alt: A tour of the site
:width: 640
The two-minute tour.
.. image:: media/pronunciation.mp3
페이지는 브라우저 플레이어와 재생하지 못하는 브라우저용 파일 링크를 표시합니다. 책은 미디어를 재생할 수 없으므로 플레이어 자리의 상자에 녹화·녹음을 표시합니다. 텍스트 출력은 [video: ...] 또는 [audio: ...]를 씁니다.
다운로드¶
download 역할은 어떤 파일이든 연결하고 _downloads로 복사합니다.
Get :download:`the example project <examples/project.zip>`.
테마 파일¶
_static에는 테마의 스타일시트, 스크립트, 글꼴, 로고를 두며 사이트의 _static으로 그대로 복사합니다. html_static_path로 디렉터리를 지정하고, html_css_files, html_js_files, html_logo, html_favicon으로 파일을 지정합니다. 콘텐츠 미디어는 문서와 함께 두어 같이 이동해도 링크가 유지되게 하세요.