hugo python distributions
v0.140.2
| ตัวแยกประเภท | คำอธิบาย |
|---|---|
| งานสร้าง | |
| บรรจุุภัณฑ์ | |
| เมตา |
ไบนารีสำหรับตัวสร้างไซต์คงที่ Hugo extended + withdeploy ซึ่งสามารถติดตั้งได้ผ่าน pip
โปรเจ็กต์นี้จัดเตรียมวงล้อสำหรับ Hugo เพื่อให้สามารถใช้กับ pip บน macOS, Linux และ Windows สำหรับ Python 3.9 และใหม่กว่า
บันทึก
เฉพาะเวอร์ชัน EOL Python เวอร์ชันล่าสุด เสถียร และจะเป็น EOL เท่านั้นที่ได้รับการทดสอบเป็นประจำ หากคุณพบปัญหาใดๆ กับแพ็คเกจในเวอร์ชัน Python เฉพาะ โปรดอย่าลังเลที่จะเปิดปัญหา
Hugo เป็นตัวสร้างไซต์แบบสแตติกที่เขียนด้วยภาษา Go ได้รับการออกแบบมาให้รวดเร็วและยืดหยุ่น และผู้คนและองค์กรจำนวนมากนำไปใช้สำหรับเว็บไซต์ เอกสาร และบล็อกส่วนตัว
บันทึก
ปัจจุบันการจำหน่าย Hugo นี้ไม่มีส่วนเกี่ยวข้องกับโครงการ Hugo อย่างเป็นทางการ โปรดดูเอกสารประกอบของ Hugo สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ Hugo
hugo เวอร์ชันใด โปรเจ็กต์นี้ hugo ได้รับเวอร์ชันควบคู่ไปกับ Hugo และสอดคล้องกับเวอร์ชันของ Hugo เอง ซึ่งใช้ SemVer – แต่มีแนวโน้มว่าจะมีเวอร์ชันตามมาตรฐานซอฟต์แวร์ 0ver โดยอิงตามประวัติเวอร์ชัน
ไบนารีสำหรับ hugo ผ่านวงล้อเหล่านี้พร้อมใช้งานสำหรับ Hugo เวอร์ชัน 0.121.2 ขึ้นไป ผ่าน PyPI หรือผ่านการเผยแพร่บน GitHub หากคุณต้องการ hugo เวอร์ชันเก่าที่ไม่มีในแพ็คเกจนี้ โปรดพิจารณาใช้ไบนารี Hugo อย่างเป็นทางการ
โปรดดูส่วนแพลตฟอร์มที่รองรับสำหรับรายการล้อที่พร้อมใช้งานสำหรับแพลตฟอร์มและสถาปัตยกรรมที่รองรับ หากเป็นเช่นนั้น ให้ข้ามไปที่ส่วน Quickstart เพื่อเริ่มต้น
คำเตือน
เนื่องจากข้อจำกัดของขนาดโดยรวมที่มีบน PyPI สำหรับ hugo เฉพาะ Hugo เวอร์ชันล่าสุดเท่านั้นที่พร้อมให้ดาวน์โหลดผ่าน pip และวงล้อเวอร์ชันเก่าเหล่านี้จะถูกลบออกเพื่อให้มีที่ว่างสำหรับรุ่นที่ใหม่กว่า หากคุณต้องการ Hugo เวอร์ชันเก่า โปรดพิจารณาใช้วงล้อที่อัปโหลดไปยังหน้าเผยแพร่ GitHub หรือไบนารี Hugo อย่างเป็นทางการ แบบแรกสามารถทำได้ผ่าน pip โดยการดาวน์โหลดไฟล์ .whl หรือผ่าน pipx โดยใช้ URL โดยตรง (แนะนำ) ตัวอย่างเช่น หากคุณต้องการ 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" เพื่อดาวน์โหลดและติดตั้งวงล้อสำหรับ Hugo 0.122.0 บน Windows สำหรับ หลาม 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 ผ่านทาง hugo-python-distributions แผนนี้คือการสนับสนุนแพลตฟอร์มให้ได้มากที่สุดด้วยวงล้อ Python และแท็กแพลตฟอร์ม โปรดดูตารางต่อไปนี้สำหรับรายการแพลตฟอร์มและสถาปัตยกรรมที่รองรับ:
| แพลตฟอร์ม | สถาปัตยกรรม | สนับสนุน |
|---|---|---|
| ระบบปฏิบัติการ macOS | x86_64 (อินเทล) | ✅ macOS 10.13 (High Sierra) และใหม่กว่า |
| ระบบปฏิบัติการ macOS | arm64 (ซิลิคอน) | ✅ macOS 11.0 (Big Sur) และใหม่กว่า |
| ลินุกซ์ | amd64 | ✅ glibc 2.24 และใหม่กว่า |
| ลินุกซ์ | อาร์ม64 | ✅ glibc 2.24 และใหม่กว่า |
| ลินุกซ์ | s390x | ✅ glibc 2.17 และใหม่กว่า |
| ลินุกซ์ | ppc64le | ✅ glibc 2.17 และใหม่กว่า |
| หน้าต่าง | x86_64 | |
| หน้าต่าง | อาร์ม64 | ✅ การสนับสนุนการทดลอง 1 |
| หน้าต่าง | x86 | ✅ การสนับสนุนการทดลอง 1 |
| ดราก้อนฟลายBSD | amd64 | จะไม่ได้รับการสนับสนุน 2 |
| ฟรีBSD | amd64 | จะไม่ได้รับการสนับสนุน 2 |
| OpenBSD | amd64 | จะไม่ได้รับการสนับสนุน 2 |
| เน็ตบีเอสดี | amd64 | จะไม่ได้รับการสนับสนุน 2 |
| โซลาริส | amd64 | จะไม่ได้รับการสนับสนุน 2 |
การสร้าง Hugo รุ่นขยาย + พร้อมปรับใช้จากแหล่งที่มาจำเป็นต้องอาศัยการขึ้นต่อกันดังต่อไปนี้:
ผู้ใช้ Windows สามารถใช้ตัวจัดการแพ็คเกจ Chocolatey เพื่อใช้คอมไพเลอร์ MinGW หลังจากติดตั้ง 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 ผ่านทาง Xcode toolchainarm64 , amd64 , s390x และ ppc64le ผ่านทาง Zig toolchain และamd64 , arm64 และ x86 ผ่านทาง Zig toolchainโปรดดูตัวอย่างด้านล่างสำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการคอมไพล์ Hugo สำหรับสถาปัตยกรรมที่แตกต่างกัน:
พูดบนเครื่อง macOS ที่ใช้ Intel (x86_64):
export GOARCH= " arm64 "
pip install . # or pip install -e . สิ่งนี้จะสร้างการกระจายไบนารี macOS arm64 ของ Hugo ที่สามารถใช้กับเครื่อง macOS ที่ใช้ Apple Silicon ( arm64 ) หากต้องการสร้างการแจกแจงแบบไบนารีสำหรับแพลตฟอร์ม macOS ที่ใช้ Intel ( x86_64 ) เป้าหมาย บน โฮสต์ เครื่อง macOS ที่ใช้ Apple Silicon ( arm64 ) คุณสามารถใช้คำสั่งต่อไปนี้:
export GOARCH= " amd64 "
pip install . # or pip install -e . ขั้นแรก ติดตั้ง Zig บนเครื่อง Linux ของคุณและตั้งค่าตัวแปรสภาพแวดล้อม USE_ZIG , GOOS และ GOARCH ก่อนที่จะติดตั้งแพ็คเกจ:
พูดบนเครื่อง amd64 Linux:
export USE_ZIG= " 1 "
export GOOS= " linux "
export GOARCH= " arm64 "
pip install . # or pip install -e . จะคอมไพล์ข้ามการกระจายไบนารี Linux arm64 ของ Hugo ที่สามารถใช้กับเครื่อง Linux arm64 เป้าหมาย หากต้องการสร้างการแจกแจงแบบไบนารีสำหรับแพลตฟอร์ม amd64 Linux เป้าหมาย บนเครื่อง โฮสต์ arm64 Linux ให้กำหนดเป้าหมายแตกต่างออกไป:
export USE_ZIG= " 1 "
export GOOS= " linux "
export GOARCH= " amd64 "
pip install . # or pip install -e . สิ่งนี้จะสร้างการเชื่อมโยงแบบไดนามิกสำหรับไบนารี Hugo ที่สร้างขึ้นด้วย GLIBC ที่ระบบจัดเตรียมไว้ให้ หากคุณต้องการเชื่อมโยงไบนารีกับ MUSL แบบคงที่ ให้เปลี่ยนตัวแปรสภาพแวดล้อม CC และ CXX ดังนี้:
export CC= " zig cc -target x86_64-linux-musl "
export CXX= " zig c++ -target x86_64-linux-musl "การเชื่อมโยงกับ MUSL ไม่ได้รับการทดสอบใน CI ในขณะนี้ แต่ควรจะได้ผลในทางทฤษฎี ไบนารี Hugo อย่างเป็นทางการไม่ได้เชื่อมโยงกับ MUSL ด้วยเหตุผลหลายประการ รวมถึงแต่ไม่จำกัดเพียงขนาดของไบนารีและความนิยมของไลบรารีมาตรฐาน GLIBC C และแบบแผน
ขั้นแรก ติดตั้ง Zig บนเครื่อง Windows ของคุณ และตั้งค่าตัวแปรสภาพแวดล้อมเหล่านี้ก่อนที่จะติดตั้งแพ็คเกจ:
พูดบนเครื่อง Windows amd64 :
set USE_ZIG= " 1 "
set GOOS= " windows "
set GOARCH= " arm64 "
pip install . # or pip install -e . จะคอมไพล์ข้ามการกระจายไบนารี Windows arm64 ของ Hugo ที่สามารถใช้กับเครื่อง Windows arm64 เป้าหมาย (สังเกตการใช้ set แทน export บน Windows) และอื่น ๆ สำหรับสถาปัตยกรรม 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 บนระบบของคุณ
เคล็ดลับ
การคอมไพล์ข้ามแพลตฟอร์มและสถาปัตยกรรมเป้าหมายจากแพลตฟอร์มโฮสต์และสถาปัตยกรรมที่แตกต่างกันก็เป็นไปได้เช่นกัน แต่ส่วนใหญ่ยังคงไม่ได้รับการทดสอบในขณะนี้ ปัจจุบัน Toolchain ของคอมไพเลอร์ Zig เป็นที่รู้กันว่าทำงานสำหรับการคอมไพล์ข้ามแพลตฟอร์มและข้ามสถาปัตยกรรม
ไบนารีสำหรับตัวสร้างไซต์คงที่ Hugo พร้อมให้ดาวน์โหลดจากหน้าเผยแพร่ Hugo จะต้องดาวน์โหลดไบนารีเหล่านี้และวางในตำแหน่งที่เหมาะสมบนระบบด้วยตนเอง และต้องอัปเดตตัวแปรสภาพแวดล้อม PATH เพื่อรวมตำแหน่งดังกล่าว
โปรเจ็กต์นี้จัดเตรียมวงล้อสำหรับ Hugo เพื่อใช้กับ pip บน macOS, Linux และ Windows สิ่งนี้ทำให้สามารถติดตั้งและใช้งาน Hugo ในสภาพแวดล้อมเสมือนได้ ซึ่งช่วยให้สามารถติดตั้งและใช้งาน Hugo หลายเวอร์ชันควบคู่กันในสภาพแวดล้อมเสมือนที่แตกต่างกันได้ โดยที่ Hugo สามารถใช้เป็นเครื่องมือบรรทัดคำสั่งได้ (Python API คือ ไม่ได้ระบุไว้ในขณะนี้ เนื่องจากขาดความต้องการดังกล่าว)
โครงการนี้ได้รับการออกแบบเพื่อใช้ในสถานการณ์ต่อไปนี้:
pip install --upgrade hugo และสามารถอัปเดตอัตโนมัติได้เช่นกันหากคุณใช้ตัวจัดการแพ็คเกจเช่น Poetry หรือ PDM เพื่อจัดการการพึ่งพา Python ของคุณหรือเครื่องมือเช่น pipx ในการจัดการ เครื่องมือบรรทัดคำสั่งของคุณโครงการนี้ได้รับอนุญาตภายใต้เงื่อนไขของใบอนุญาต Apache 2.0 Hugo มีให้บริการภายใต้ Apache 2.0 (ดูใบอนุญาต Hugo) เช่นกัน
โปรดดูนโยบายความปลอดภัยสำหรับโครงการนี้สำหรับข้อมูลเพิ่มเติม
พื้นที่เก็บข้อมูลนี้มีจุดมุ่งหมายเพื่อปฏิบัติตามโครงการ Hugo ในการมุ่งมั่นที่จะจัดเตรียมสภาพแวดล้อมที่เป็นมิตรและครอบคลุมสำหรับผู้มีส่วนร่วมทุกคน โดยไม่คำนึงถึงภูมิหลังและอัตลักษณ์ของพวกเขา โปรดดูหลักจรรยาบรรณสำหรับข้อมูลเพิ่มเติมที่ใช้กับการโต้ตอบทั้งหมดในพื้นที่เก็บข้อมูลนี้และพื้นที่ที่เกี่ยวข้อง ขึ้นอยู่กับแนวทางปฏิบัติของผู้ร่วมให้ข้อมูลและสอดคล้องกับเวอร์ชัน 2.1
สำหรับการขอความช่วยเหลือ รายงานจุดบกพร่อง หรือการร้องขอคุณสมบัติเฉพาะสำหรับฟังก์ชันการทำงานของ Hugo โปรดดูที่ฟอรั่ม Hugo Discourse สำหรับการขอความช่วยเหลือสำหรับ hugo-python-distributions โปรดเปิดปัญหาในพื้นที่เก็บข้อมูลนี้
Hugo บน PyPI (@nariman) สำหรับการแสดงท่าทางใจดีในการให้สิทธิ์เข้าถึงเพื่อเข้าครอบครองชื่อแพ็คเกจด้วยข้อกำหนดพื้นฐานของ PEP 541 ด้วยวิธีนี้ ผู้ใช้สามารถติดตั้งแพ็คเกจโดยใช้ชื่อเดียวกับโครงการ Hugo อย่างเป็นทางการ ซึ่งมอบประสบการณ์การใช้งานที่ดีขึ้นและความสะดวกสบายให้กับผู้ใช้แพ็คเกจนี้อย่างไม่ต้องสงสัย เมื่อเปรียบเทียบกับชื่อแพ็คเกจก่อนหน้า python-hugo การสนับสนุนสถาปัตยกรรม 32 บิต (i686) และ arm64 บน Windows เกิดขึ้นได้โดยใช้ชุดเครื่องมือคอมไพเลอร์ Zig ที่ใช้ระบบนิเวศ LLVM ล้อเหล่านี้เป็นการทดลองเนื่องจากการใช้การคอมไพล์ข้าม และอาจไม่เสถียรหรือเชื่อถือได้สำหรับทุกกรณีการใช้งาน และยังไม่ได้รับการสนับสนุนอย่างเป็นทางการจากโครงการ Hugo ในขณะนี้ ดังนั้น แม้ว่าสิ่งเหล่านี้จะถูกเผยแพร่ไปยัง PyPI เพื่อความพร้อมใช้งานทั่วไป แต่ก็ถือว่าเป็นการทดลอง โปรดดูส่วนการสร้างจากแหล่งที่มาสำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการสร้าง Hugo สำหรับแพลตฟอร์มและสถาปัตยกรรมเหล่านี้ภายในเครื่อง หากคุณต้องการการสนับสนุนอย่างเป็นทางการสำหรับแพลตฟอร์มเหล่านี้หรือเผชิญกับข้อบกพร่องใด ๆ โปรดติดต่อผู้เขียน Hugo โดย [https://github.com/gohugoio/hugo/issues/new](เปิดปัญหา) ↩ ↩ 2
ไม่สามารถรวมการสนับสนุนสำหรับแพลตฟอร์มเหล่านี้ได้เนื่องจาก i การขาดทรัพยากรในการทดสอบและสร้างให้พวกเขา และ ii. ขาดการสนับสนุนข้อกำหนดแพลตฟอร์มเหล่านี้ในมาตรฐานบรรจุภัณฑ์และเครื่องมือของ Python หากคุณต้องการการสนับสนุนสำหรับแพลตฟอร์มเหล่านี้ โปรดพิจารณาดาวน์โหลดไบนารี Hugo อย่างเป็นทางการสำหรับรุ่นที่ไม่มีส่วนขยาย ↩ ↩ 2 ↩ 3 ↩ 4 ↩ 5
