^ Beyond Linux(r) From Scratch (systemd Edition) - Version 12.1 ^^^
^ Chapter 13. Programming ^^^
|[[.:Python-3.11.1|이전]] | [[.:index|위로]] / [[:start|처음으로]] | [[.:Python Dependencies|다음]]|
|Python-3.11.1 | Python Dependencies|
----
==== Sphinx-7.2.6 ====
=== Sphinx Module 소개 ===
Sphinx 패키지는 일부 구조화된 텍스트 형식을 다양한 형식의 보기 좋은 문서로 변환하기 위한 도구 세트입니다.
이 패키지는 LFS 12.1 플랫폼을 사용하여 빌드하고 제대로 작동하는 것으로 알려져 있습니다.
== 패키지 정보 ==
* 다운로드(HTTP): [[https://files.pythonhosted.org/packages/source/s/sphinx/sphinx-7.2.6.tar.gz|sphinx-7.2.6.tar.gz]]
* MD5: 18971ebdd6ec1b7788ff0898682fe0da
* 다운로드 크기: 6.7 MB
* 필요한 예상 디스크 공간: 45MB(테스트용 35MB 추가)
* 예상 빌드 시간: 0.1 SBU 미만(테스트용 1.3 SBU)
== Sphinx 종속성 ==
== 필수 ==
* [[.:alabaster-0.7.13]]
* [[.:Babel-2.11.0]]
* [[.docutils-0.20.1]]
* [[.:imagesize-1.4.1]]
* [[.:packaging-23.2]]
* [[.:Pygments-2.17.2]]
* [[.:requests-2.31.0]]
* [[.:snowballstemmer-2.2.0]]
* [[.:sphinxcontrib-applehelp-1.0.4]]
* [[.:sphinxcontrib-devhelp-1.0.2]]
* [[.:sphinxcontrib-htmlhelp-2.0.1]]
* [[.:sphinxcontrib-jsmath-1.0.1]]
* [[.:sphinxcontrib-qthelp-1.0.3]]
* [[.:sphinxcontrib-serializinghtml-1.1.9]]
== 선택 사항(테스트용) ==
* [[.:cython-0.29.36]]
* [[.:pytest-8.0.0]]
* [[.:texlive-20230313]]
* [[.:filelock]]
* [[.:html5lib]]
=== Sphinx 설치 ===
모듈을 빌드합니다.
pip3 wheel -w dist --no-build-isolation --no-deps --no-cache-dir $PWD
이제 루트 사용자로
pip3 install --no-index --find-links=dist --no-cache-dir --no-user sphinx
[[.:cython-0.29.36]] 및 [[.:pytest-8.0.0]]이 설치되어 있지만 다른 선택적 종속성은 설치되어 있지 않다고 가정하면 다음 명령으로 설치를 테스트할 수 있습니다:
python3 -m venv --system-site-packages testenv &&
source testenv/bin/activate &&
pip3 install html5lib filelock &&
python3 -m pytest
deactivate
=== 명령어 설명 ===
* //-w dist// \\ 디렉터리 dist에 이 모듈에 적합한 "휠"을 빌드합니다.
* //--no-build-isolation// \\ 임시 빌드 환경을 만드는 대신 시스템 환경에서 빌드를 실행하도록 pip3에 지시합니다.
* //--no-deps// \\ pip3가 프로젝트의 종속성에 대한 휠을 빌드하지 못하게 한다.
* //--no-index// \\ 패키지 인덱스를 무시합니다(대신 --find-links URL만 확인).
* //--find-links dist// \\ 디렉터리 dist에서 휠(.whl) 파일과 같은 아카이브 링크를 찾습니다.
* //--no-cache-dir// \\ 루트 사용자로 설치할 때 경고가 표시되지 않도록 캐시를 비활성화합니다.
* //--no-user// \\ 루트 사용자가 아닌 다른 사용자로 실수로 설치 명령을 실행하는 것을 방지합니다.
* //--upgrade// \\ 패키지를 사용 가능한 최신 버전으로 업그레이드합니다. 이 옵션은 패키지의 버전이 이미 설치되어 있는 경우 설치 명령과 함께 사용됩니다.
* //--force-reinstall// \\ 패키지가 최신 버전인 경우에도 패키지를 다시 설치합니다. 이 옵션은 패키지를 다시 설치하거나 패키지의 이전 버전으로 되돌릴 때 설치 명령과 함께 사용됩니다.
* //--no-deps// \\ 패키지 종속성을 설치하지 않습니다. 이 옵션은 --upgrade 또는 --force-reinstall 옵션과 함께 필요할 수 있습니다.
=== 내용 ===
* **설치된 프로그램:** \\ sphinx-apidoc, sphinx-autogen, sphinx-build 및 sphinx-quickstart
* **설치된 디렉토리** \\ /usr/lib/python3.12/site-packages/sphinx 및 /usr/lib/python3.12/site-packages/sphinx-7.2.6.dist-info
== 간단한 설명 ==
* **sphinx-apidoc** \\ 파이썬 모듈과 패키지에서 reST 파일을 만듭니다.
* **sphinx-autogen** \\ 주어진 입력 파일에 포함된 특수 지시어에서 ReStructuredText를 생성합니다.
* **sphinx-build** \\ ReStructuredText 소스 파일에서 다양한 형식의 문서를 생성합니다.
* sphinx-quickstart \\ 스핑크스 프로젝트에 필요한 파일을 생성합니다.