Một chủ đề Hugo đơn giản

Duyệt

Browse là một chủ đề Hugo Hugo có khả năng phản hồi. Đây là một nhánh của chủ đề Hugo Mainroad .

Bản demo • Tài liệu

Đặc trưng:

• Menu chính và phụ
• Thanh bên có tiện ích
• Cài đặt chủ đề có thể định cấu hình (vị trí thanh bên, hộp tác giả, điều hướng bài đăng, màu tô sáng) thông quahugo.toml
• Hỗ trợ Google Fonts tùy chỉnh, MathJax, Mục lục, biểu tượng SVG và nhiều hơn nữa…
• Chế độ tối

Cài đặt

Trước khi bắt đầu, hãy đảm bảo rằng bạn đã cài đặt Hugo và tạo một trang web mới . Sau đó, bạn đã sẵn sàng cài đặt Browse .

Bạn có thể sử dụng các tùy chọn bên dưới.

Lựa chọn 1 (lựa chọn tôi thích nhất)

Tùy chọn này cho phép bạn tải chủ đề duyệt dưới dạng mô-đun hugo. Trước tiên, hãy đảm bảo bạn đã cài đặt gonhị phân trên máy của mình .

$ git clone https://github.com/onweru/browse/
cd browse/exampleSite/
hugo server

Để kéo các bản cập nhật chủ đề, hãy chạy hugo mod get -u ./...từ thư mục chủ đề. Nếu không chắc chắn, hãy tìm hiểu cách cập nhật các mô-đun hugo

{{< tip "warning" >}} 

Theo mặc định, exampleSite sử dụng chủ đề này làm mô-đun hugo.

Nếu bạn chọn Tùy chọn 2 hoặc Tùy chọn 3 bên dưới, hãy đảm bảo bạn chỉnh sửa các dòng này trong tệp hugo.toml theo hướng dẫn trong phần bình luận. Nếu không, bạn sẽ không thể kéo các bản cập nhật chủ đề.

{{< /tip >}}

Tùy chọn 2 (khuyến nghị)

Tạo một trang Hugo mới và thêm chủ đề này dưới dạng một mô-đun con Git bên trong thư mục chủ đề của bạn:

hugo new site yourSiteName
cd yourSiteName
git init
git submodule add https://github.com/onweru/browse/ themes/browse
cp -a themes/browse/exampleSite/* .

Sau đó chạy

Hoan hô!

Tùy chọn 3 (Tuyệt vời để thử nghiệm nhanh)

Bạn có thể chạy trang web của mình trực tiếp từ exampleSite. Để làm như vậy, hãy sử dụng các lệnh sau:

git clone https://github.com/onweru/browse/
cd browse/exampleSite/
hugo server --themesDir ../..

{{<tip >}}

Mặc dù tùy chọn 3 rất tuyệt vời để kiểm tra nhanh, nhưng nó có phần gây ra vấn đề khi bạn muốn cập nhật chủ đề của mình. Bạn sẽ cần phải cẩn thận để không ghi đè lên các thay đổi của mình.

{{< /tip >}}

Sau khi thiết lập xong, hãy chuyển đến tệp hugo.toml và bắt đầu cấu hình trang web của bạn.

Cấu hình

Vui lòng xem các tập tin cấu hình bên trongexampleSite/config/_default

Ghi đè các bộ font-family

fontFamilyPrimary = "'Open Sans', Helvetica, Arial, sans-serif"
fontFamilySecondary = "SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace"

[logo]
image = "img/placeholder.png" # Logo image. Path relative to "static"
title = "Browse" # Logo title, otherwise will use site title
subtitle = "Just another site" # Logo subtitle

[thumbnail]
visibility = ["list", "post"] # Control thumbnail visibility

[sidebar]
home = "right" # Configure layout for home page
list = "left"  # Configure layout for list pages
single = false # Configure layout for single pages
# Enable widgets in given order
widgets = ["search", "recent", "categories", "taglist", "social", "languages"]

[widgets]
recent_num = 5 # Set the number of articles in the "Recent articles" widget
categories_counter = false # Enable counter for each category in "Categories" widget
tags_counter = false # Enable counter for each tag in "Tags" widget

Kích hoạt các phần của tiện ích xã hội

[widgets.social]
facebook = "username"
twitter = "username"
instagram = "username"
linkedin = "username"
telegram = "username"
github = "username"
gitlab = "username"
bitbucket = "username"
email = "example@example.com"

Liên kết xã hội tùy chỉnh

[[widgets.social.custom]]
title = "Youtube"
url = "https://youtube.com/user/username"
icon = "youtube.svg" # Optional. Path relative to "layouts/partials"
rel = "noopener noreferrer" # Set to false to remove the rel attribute

[[widgets.social.custom]]
title = "My Home Page"
url = "https://example.com"

[widgets.search]
url = "https://google.com/search"
[widgets.search.input]
  name = "sitesearch"
  pre = ""

Không sao chép cấu hình ví dụ nguyên trạng . Chỉ sử dụng những tham số bạn cần.

Để biết thêm thông tin về tất cả các cài đặt cấu hình tiêu chuẩn có sẵn, vui lòng đọc Tất cả cài đặt cấu hình Hugo .

Ví dụ về phần đầu

---
# Common-Defined params
title: "Example article title"
date: "2017-08-21"
description: "Example article description"
categories:
  - "Category 1"
  - "Category 2"
tags:
  - "Test"
  - "Another test"
menu: main # Optional, add page to a menu. Options: main, side, footer

# Theme-Defined params
thumbnail: "img/placeholder.png" # Thumbnail image
lead: "Example lead - highlighted near the title" # Lead text
comments: false # Enable Disqus comments for specific page
authorbox: true # Enable authorbox for specific page
pager: true # Enable pager navigation (prev/next) for specific page
toc: true # Enable Table of Contents for specific page
mathjax: true # Enable MathJax for specific page
sidebar: "right" # Enable sidebar (on the right side) per page
widgets: # Enable sidebar widgets in given order per page
  - "search"
  - "recent"
  - "taglist"
---

Để biết thêm thông tin về tất cả các biến tiêu chuẩn có sẵn, vui lòng đọc Hugo Front Matter .

Phân tích trang web Matomo

Nếu bạn muốn sử dụng Matomo Analytics, hãy cấu hình matomo_analyticscác tham số chung trong trang web của bạn như sau.

enableĐể bật tính năng phân tích Matomo, hãy thay đổi thành true.

websiteDomainĐặt tên miền cho trang web của bạn, trong hầu hết các trường hợp phải giống với URL cơ sở, đây là điều bắt buộc.

matomoDomain Đặt thành tên miền Matomo

matomoSiteID Mặc định được đặt thành 1, hãy thay đổi thành siteid đang được theo dõi

Đóng góp

Bạn đã tìm thấy lỗi hoặc có ý tưởng cho tính năng mới chưa? Hãy thoải mái sử dụng trình theo dõi sự cố để cho tôi biết. Hoặc trực tiếp yêu cầu kéo , nhưng vui lòng tôn trọng hướng dẫn đóng góp sau đây .

Giấy phép

Chủ đề này được phát hành theo giấy phép GPLv2 .