Hugo bắt đầu
Trong hướng dẫn này, bạn sẽ:
- Tạo một trang web
- Thêm nội dung
- Định cấu hình trang web
- Xuất bản trang web
Điều kiện tiên quyết
Trước khi bắt đầu hướng dẫn này, bạn phải:
- Cài đặt Hugo (phiên bản mở rộng, v0.112.0 trở lên)
- Cài đặt Git
Bạn cũng phải thoải mái làm việc từ dòng lệnh.
Tạo một trang web
Lệnh
Xác minh rằng bạn đã cài đặt Hugo v0.112.0 hoặc mới hơn.
Chạy các lệnh này để tạo một trang web Hugo với chủ đề Ananke. Phần tiếp theo cung cấp lời giải thích về từng lệnh.
hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo "theme = 'ananke'" >> hugo.toml hugo server
Xem trang web của bạn tại URL được hiển thị trong thiết bị đầu cuối của bạn. Nhấn để dừng máy chủ phát triển của Hugo.Ctrl + C
Giải thích các lệnh
Tạo cấu trúc thư mục cho dự án của bạn trong thư mục.quickstart
Thay đổi thư mục hiện tại thành thư mục gốc của dự án của bạn.
Khởi tạo một kho lưu trữ Git trống trong thư mục hiện tại.
Sao chép chủ đề Ananke vào thư mục, thêm nó vào dự án của bạn dưới dạng mô-đun con Git.themes
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
Nối thêm một dòng vào tệp cấu hình trang web, cho biết chủ đề hiện tại.
echo "theme = 'ananke'" >> hugo.toml
Khởi động máy chủ phát triển của Hugo để xem trang web.
Nhấn để dừng máy chủ phát triển của Hugo.Ctrl + C
Thêm nội dung
Thêm trang mới vào trang web của bạn.
hugo new content posts/my-first-post.md
Hugo đã tạo tệp trong thư mục. Mở tệp bằng trình chỉnh sửa của bạn.content/posts
+++ title = 'My First Post' date = 2024-01-14T07:07:07+01:00 draft = true +++
Lưu ý giá trị trong vật chất phía trước là . Theo mặc định, Hugo không xuất bản nội dung nháp khi bạn xây dựng trang web. Tìm hiểu thêm về nội dung nháp, nội dung trong tương lai và nội dung đã hết hạn.draft``true
Thêm một số Markdown vào nội dung của bài đăng, nhưng không thay đổi giá trị.draft
+++ title = 'My First Post' date = 2024-01-14T07:07:07+01:00 draft = true +++ ## Introduction This is **bold** text, and this is *emphasized* text. Visit the [Hugo](https://gohugo.io) website!
Lưu tệp, sau đó khởi động máy chủ phát triển của Hugo để xem trang web. Bạn có thể chạy một trong các lệnh sau để bao gồm nội dung nháp.
hugo server --buildDrafts hugo server -D
Xem trang web của bạn tại URL được hiển thị trong thiết bị đầu cuối của bạn. Giữ cho máy chủ phát triển chạy khi bạn tiếp tục thêm và thay đổi nội dung.
Khi hài lòng với nội dung mới của bạn, hãy đặt tham số front matter thành .draft``false
Định cấu hình trang web
Với trình chỉnh sửa của bạn, hãy mở tệp cấu hình trang web () trong thư mục gốc của dự án của bạn.hugo.toml
baseURL = 'https://example.org/' languageCode = 'en-us' title = 'My New Hugo Site' theme = 'ananke'
Thực hiện các thay đổi sau:
-
Đặt cho trang web sản xuất của bạn. Giá trị này phải bắt đầu bằng giao thức và kết thúc bằng dấu gạch chéo, như được hiển thị ở trên.
baseURL -
Đặt thành ngôn ngữ và khu vực của bạn.
languageCode -
Đặt cho trang web sản xuất của bạn.
title
Khởi động máy chủ phát triển của Hugo để xem các thay đổi của bạn, nhớ bao gồm nội dung nháp.
Xuất bản trang web
Trong bước này, bạn sẽ xuất bản trang web của mình, nhưng bạn sẽ không triển khai nó.
Khi bạn xuất bản trang web của mình, Hugo sẽ tạo toàn bộ trang web tĩnh trong thư mục trong thư mục gốc của dự án của b ạn. Điều này bao gồm các tệp HTML và nội dung như hình ảnh, tệp CSS và tệp JavaScript.public
Khi bạn xuất bản trang web của mình, bạn thường không muốn bao gồm nội dung nháp, tương lai hoặc hết hạn. Lệnh rất đơn giản.
Để tìm hiểu cách triển khai trang web của bạn, hãy xem phần lưu trữ và triển khai.
Yêu cầu trợ giúp
Diễn đàn của Hugo là một cộng đồng tích cực gồm người dùng và nhà phát triển, những người trả lời câu hỏi, chia sẻ kiến thức và cung cấp ví dụ. Tìm kiếm nhanh hơn 20.000 chủ đề thường sẽ trả lời câu hỏi của bạn. Hãy chắc chắn đọc về yêu cầu trợ giúp trước khi đặt câu hỏi đầu tiên của bạn.
Các tài nguyên khác
Để biết các tài nguyên khác giúp bạn học Hugo, bao gồm sách và video hướng dẫn, hãy xem trang tài nguyên học tập bên ngoài.