분류자 | 설명 |
---|---|
빌드 | |
패키지 | |
메타 |
pip
통해 설치 가능한 Hugo 정적 사이트 생성기의 extended
+ withdeploy
버전 용 바이너리
이 프로젝트는 macOS, Linux 및 Windows에서 pip
와 함께 사용할 수 있도록 Hugo용 휠을 제공합니다. Python 3.9 이상용.
메모
최신의 안정적인 EOL Python 버전만 정기적으로 테스트됩니다. 특정 Python 버전의 패키지에 문제가 발생하면 언제든지 문제를 열어주세요.
Hugo는 Go로 작성된 정적 사이트 생성기입니다. 빠르고 유연하게 설계되었으며 많은 사람과 조직에서 웹 사이트, 문서 및 개인 블로그에 사용합니다.
메모
이 Hugo
배포판은 현재 공식 Hugo
프로젝트와 관련이 없습니다. Hugo에 대한 자세한 내용은 Hugo 문서를 참조하세요.
hugo
설치해야 하나요? 이 프로젝트인 hugo
Hugo 릴리스와 함께 버전이 지정되며 SemVer
사용하는 Hugo 자체의 버전과 일치합니다. 그러나 버전 관리 기록을 기반으로 0ver 소프트웨어 표준에 따라 버전이 지정될 가능성이 높습니다.
이러한 휠을 통한 hugo
용 바이너리는 Hugo 버전 0.121.2 이상, PyPI 또는 GitHub 릴리스를 통해 사용할 수 있습니다. 이 패키지를 통해 사용할 수 없는 이전 버전의 hugo
필요한 경우 공식 Hugo 바이너리 사용을 고려해 보세요.
지원되는 플랫폼 및 아키텍처에 사용할 수 있는 휠 목록은 지원되는 플랫폼 섹션을 참조하세요. 그렇다면 빠른 시작 섹션으로 이동하여 시작하세요.
경고
hugo
용 PyPI에서 사용할 수 있는 전체 크기 제한으로 인해 Hugo의 최신 버전만 pip
통해 다운로드할 수 있으며 이러한 휠의 이전 버전은 최신 릴리스를 위한 공간을 확보하기 위해 삭제됩니다. 이전 버전의 Hugo가 필요한 경우 GitHub 릴리스 페이지 또는 공식 Hugo 바이너리에 업로드된 휠을 사용하는 것을 고려해 보십시오. 전자는 .whl
파일을 다운로드하여 pip
통해 수행하거나 URL을 직접 사용하여 pipx
통해 수행할 수 있습니다(권장). 예를 들어 Hugo 0.122.0이 필요한 경우 pipx install "https://github.com/agriyakhetarpal/hugo-python-distributions/releases/download/v0.122.0/hugo-0.122.0-cp311-cp311-win_amd64.whl"
실행할 수 있습니다. pipx install "https://github.com/agriyakhetarpal/hugo-python-distributions/releases/download/v0.122.0/hugo-0.122.0-cp311-cp311-win_amd64.whl"
- Python용 Windows에서 Hugo 0.122.0용 휠을 다운로드하고 설치합니다. 3.11.
가상 환경을 생성하고 패키지를 설치합니다(또는 시스템에 전역으로 설치).
python -m virtualenv venv # (or your preferred method of creating virtual environments)
pip install hugo
이렇게 하면 가상 환경에 실행 파일이 포함된 hugo
설치가 이루어지고 가상 환경의 bin
디렉터리에 진입점이 추가됩니다. 평소와 같이 hugo
명령을 사용할 수 있습니다.
hugo version
hugo env --logLevel info
또는 시스템에 전역적으로 패키지를 설치할 수 있습니다.
python3.X -m pip install hugo # Unix
py -m pip install hugo # Windows
팁
가상 환경을 만들지 않고도 격리된 위치에서 pipx
사용하여 Hugo를 설치하거나 사용하는 것은 좋은 아이디어입니다. 이를 통해 Hugo를 시스템에 전체적으로 설치할 필요 없이 명령줄 도구로 실행할 수 있습니다. 즉,
pipx install hugo # install and run Hugo through pipx
또는
pipx run hugo==0.121.2 # run a specific version of Hugo through pipx, even if a different version is installed in whatever environment you are in
자세한 내용은 pipx
문서를 참조하세요.
그런 다음 평소와 같이 hugo
명령을 사용할 수 있습니다.
hugo version
hugo env --logLevel info
그리고
hugo new site mysite
hugo --printI18nWarnings server
# and so on
...
표준 가상 환경에서는 여러 버전의 Hugo를 나란히 설치하고 사용할 수 있습니다. 특정 버전의 Hugo를 사용하려면 패키지를 설치할 때 버전을 지정할 수 있습니다(자세한 내용은 어떤 버전의 hugo
설치합니까? 섹션을 참조하십시오).
pip install " hugo==0.X.Y "
Hugo 및 해당 명령줄 인터페이스 사용에 대한 자세한 내용은 Hugo 설명서 및 Hugo CLI 설명서를 참조하세요.
Hugo 자체에서 지원하는 플랫폼의 하위 집합은 hugo-python-distributions
통해 hugo
용 휠에서 지원됩니다. 계획은 Python 휠과 플랫폼 태그를 사용하여 최대한 많은 플랫폼을 지원하는 것입니다. 지원되는 플랫폼 및 아키텍처 목록은 다음 표를 참조하십시오.
플랫폼 | 건축학 | 지원하다 |
---|---|---|
macOS | x86_64(인텔) | ✅ macOS 10.13(High Sierra) 이상 |
macOS | arm64 (실리콘) | ✅ macOS 11.0(Big Sur) 이상 |
리눅스 | amd64 | ✅ glibc 2.24 이상 |
리눅스 | arm64 | ✅ glibc 2.24 이상 |
리눅스 | s390x | ✅ glibc 2.17 이상 |
리눅스 | ppc64le | ✅ glibc 2.17 이상 |
윈도우 | x86_64 | ✅ |
윈도우 | arm64 | ✅ 실험적 지원 1 |
윈도우 | x86 | ✅ 실험적 지원 1 |
DragonFlyBSD | amd64 | 지원을 받지 않습니다 2 |
FreeBSD | amd64 | 지원을 받지 않습니다 2 |
오픈BSD | amd64 | 지원을 받지 않습니다 2 |
NetBSD | amd64 | 지원을 받지 않습니다 2 |
솔라리스 | amd64 | 지원을 받지 않습니다 2 |
소스에서 Hugo의 확장 + 배포 버전을 빌드하려면 다음 종속성이 필요합니다.
Windows 사용자는 MinGW 컴파일러를 사용하기 위해 Chocolatey 패키지 관리자를 사용할 수 있습니다. Chocolatey를 설치한 후 관리자 권한 터미널 프롬프트에서 다음 명령을 실행합니다.
choco install mingw
그런 다음 저장소를 복제하고 빌드 스크립트를 실행합니다.
git clone https://github.com/agriyakhetarpal/hugo-python-distributions@main
python -m venv venv
source venv/bin/activate # on Unix-based systems
venv S cripts a ctivate.bat # on Windows
pip install -e . # editable installation
pip install . # regular installation
메모
크로스 컴파일은 실험적이므로 모든 사용 사례에서 안정적이거나 신뢰할 수 없을 수 있습니다. 크로스 컴파일과 관련하여 문제가 발생하면 언제든지 문제를 열어주세요.
본 프로젝트는 다양한 플랫폼과 아키텍처에 대한 Hugo 바이너리의 크로스 컴파일이 가능하며 다음과 같이 사용할 수 있습니다. 크로스 컴파일은 다음 플랫폼에 제공됩니다.
arm64
및 amd64
아키텍처의 경우,arm64
, amd64
, s390x
및 ppc64le
아키텍처의 경우 Zig 툴체인을 통해amd64
, arm64
및 x86
아키텍처용.다양한 아키텍처에 맞게 Hugo를 크로스 컴파일하는 방법에 대한 자세한 내용은 아래 예를 참조하세요.
Intel 기반(x86_64) macOS 시스템에서 다음과 같이 말해보세요.
export GOARCH= " arm64 "
pip install . # or pip install -e .
그러면 Apple Silicon 기반( arm64
) macOS 시스템에서 사용할 수 있는 Hugo의 macOS arm64
바이너리 배포판이 구축됩니다. 호스트 Apple Silicon 기반( arm64
) macOS 머신에서 대상 Intel 기반( x86_64
) macOS 플랫폼에 대한 바이너리 배포판을 빌드하려면 다음 명령을 사용할 수 있습니다.
export GOARCH= " amd64 "
pip install . # or pip install -e .
먼저 Linux 시스템에 Zig를 설치하고 패키지를 설치하기 전에 USE_ZIG
, GOOS
및 GOARCH
환경 변수를 설정하십시오.
amd64
Linux 시스템에서 다음과 같이 말해보세요.
export USE_ZIG= " 1 "
export GOOS= " linux "
export GOARCH= " arm64 "
pip install . # or pip install -e .
대상 arm64 Linux 시스템에서 사용할 수 있는 Hugo의 Linux arm64 바이너리 배포판을 크로스 컴파일합니다. 호스트 arm64
Linux 시스템에서 대상 amd64
Linux 플랫폼에 대한 바이너리 배포판을 빌드하려면 대상을 다르게 설정하십시오.
export USE_ZIG= " 1 "
export GOOS= " linux "
export GOARCH= " amd64 "
pip install . # or pip install -e .
이는 시스템 제공 GLIBC를 사용하여 빌드된 Hugo 바이너리에 대한 동적 연결을 생성합니다. 바이너리를 MUSL과 정적으로 연결하려면 CC
및 CXX
환경 변수를 다음과 같이 변경하세요.
export CC= " zig cc -target x86_64-linux-musl "
export CXX= " zig c++ -target x86_64-linux-musl "
MUSL에 대한 연결은 현재 CI에서 테스트되지 않지만 이론적으로는 작동해야 합니다. 공식 Hugo 바이너리는 바이너리 크기, GLIBC C 표준 라이브러리 및 해당 규칙의 인기를 포함하되 이에 국한되지 않는 다양한 이유로 MUSL과 연결되지 않습니다.
먼저 Windows 시스템에 Zig를 설치하고 패키지를 설치하기 전에 다음 환경 변수를 설정하십시오.
amd64
Windows 시스템에서 다음과 같이 말해보세요.
set USE_ZIG= " 1 "
set GOOS= " windows "
set GOARCH= " arm64 "
pip install . # or pip install -e .
대상 arm64
Windows 시스템에서 사용할 수 있는 Hugo의 Windows arm64
바이너리 배포판을 크로스 컴파일합니다(Windows에서 export
대신 set
사용 참고). x86
아키텍처의 경우:
set USE_ZIG= " 1 "
set GOOS= " windows "
set GOARCH= " 386 "
pip install . # or pip install -e .
Go에 지원되는 배포판 목록을 보려면 시스템에서 go tool dist list
명령을 실행하세요. Zig에 지원되는 대상 목록에 대한 자세한 내용은 Zig 설명서를 참조하거나 시스템에서 zig targets
명령을 실행하세요.
팁
다른 호스트 플랫폼 및 아키텍처에서 대상 플랫폼 및 아키텍처에 대한 크로스 컴파일도 가능하지만 현재로서는 거의 테스트되지 않은 상태입니다. 현재 Zig 컴파일러 툴체인은 크로스 플랫폼, 크로스 아키텍처 컴파일에 작동하는 것으로 알려져 있습니다.
Hugo 정적 사이트 생성기용 바이너리는 Hugo 릴리스 페이지에서 다운로드할 수 있습니다. 이러한 바이너리는 수동으로 다운로드하여 시스템의 적절한 위치에 배치해야 하며 해당 위치를 포함하도록 PATH 환경 변수를 업데이트해야 합니다.
이 프로젝트는 macOS, Linux 및 Windows에서 pip
와 함께 Hugo를 사용할 수 있는 휠을 제공합니다. 이를 통해 Hugo를 가상 환경에 설치하고 사용할 수 있으며, 이를 통해 Hugo를 명령줄 도구로 사용할 수 있는 다양한 가상 환경에서 여러 버전의 Hugo를 나란히 설치하고 사용할 수 있습니다(Python API는 이에 대한 수요가 부족하여 현재로서는 제공되지 않습니다.)
이 프로젝트는 다음 시나리오에서 사용하도록 설계되었습니다.
pip install --upgrade hugo
명령을 사용하여 최신 버전의 Hugo로 쉽게 업데이트할 수 있으며, Poetry 또는 PDM과 같은 패키지 관리자를 사용하여 Python 종속성을 관리하거나 pipx와 같은 도구를 사용하여 관리하는 경우 자동 업데이트도 가능합니다. 명령줄 도구이 프로젝트는 Apache 2.0 라이센스 조건에 따라 라이센스가 부여됩니다. Hugo는 Apache 2.0에서도 사용할 수 있습니다(Hugo 라이센스 참조).
자세한 내용은 이 프로젝트의 보안 정책을 참조하세요.
이 저장소는 배경과 정체성에 관계없이 모든 기여자에게 환영받고 포용적인 환경을 제공하기 위해 노력하는 Hugo 프로젝트를 따르는 것을 목표로 합니다. 이 저장소 및 관련 공간의 모든 상호 작용에 적용되는 자세한 내용은 행동 강령을 참조하십시오. 가이드라인은 기여자 규약(Contributor Covenant)을 따르며 버전 2.1을 준수합니다.
도움을 요청하거나, 버그를 보고하거나, Hugo 기능과 관련된 기능을 요청하려면 Hugo Discourse 포럼을 참조하세요. hugo-python-distributions
에 대한 도움을 요청하려면 이 저장소에서 자유롭게 문제를 열어주세요.
Hugo
패키지 소유자(@nariman)에게 감사의 표시를 전하고 싶습니다. 이런 방식으로 사용자는 공식 Hugo 프로젝트와 동일한 이름을 사용하여 패키지를 설치할 수 있으며, 이는 의심할 여지 없이 이전 패키지 이름과 비교할 때 이 패키지 사용자에게 더 나은 사용자 경험과 편의성을 제공합니다. python-hugo
. LLVM 에코시스템을 사용하는 Zig 컴파일러 도구 체인을 사용하면 Windows에서 32비트(i686) 및 arm64 아키텍처에 대한 지원이 가능해집니다. 이 휠은 크로스 컴파일 사용으로 인해 실험적이며 모든 사용 사례에 대해 안정적이거나 신뢰할 수 없으며 현재 Hugo 프로젝트에서 공식적으로 지원되지 않습니다. 따라서 이는 일반 가용성을 위해 PyPI에 게시되지만 실험적인 것으로 간주됩니다. 이러한 플랫폼 및 아키텍처에 대해 Hugo를 로컬로 빌드하는 방법에 대한 자세한 내용은 소스에서 빌드 섹션을 참조하세요. 이러한 플랫폼에 대한 공식적인 지원이 필요하거나 버그가 있는 경우 [https://github.com/gohugoio/hugo/issues/new](문제 열기)를 통해 Hugo 작성자에게 문의하시기 바랍니다. ↩ ↩ 2
i로 인해 이러한 플랫폼에 대한 지원을 포함할 수 없습니다. 테스트하고 구축할 리소스 부족 ii. Python 패키징 표준 및 도구에서 이러한 플랫폼 사양에 대한 지원이 부족합니다. 이러한 플랫폼에 대한 지원이 필요한 경우 비확장판용 공식 Hugo 바이너리를 다운로드하는 것을 고려해 보십시오. ↩ ↩ 2 ↩ 3 ↩ 4 ↩ 5