Vec is a minimal, clean and beautiful theme for Hugo.
mkdir themes cd themes git clone https://github.com/IvanChou/hugo-theme-vec vec
See the official docs for more information.
Make sure you have :
- Hugo installed
- Test poject setup with hugo. Instructions on hugo quickstart guide.
- Cloned this repo in the themes folder.
The exampleSite folder contains a sample site to quickly get started.
hugo server --buildDrafts
To create a post use
hugo new post/post-title.md
You should config your site's
config.toml file like:
baseurl = "https://www.example.com" title = "Site.title" theme = "vec" languageCode = "en-us" paginate = 15 # Enable comments by entering your Disqus shortname disqusShortname = "Your Disqus shortname" # Enable analytics by entering your Google Analytics tracking ID googleAnalytics = "Your Google Analytics tracking code" [params] Keywords = "key, 关键字, キーワード" Description = "There are some words to describe your site" Avater = "img/avatar.jpg" SelfIntro = "Just a worm, seek for true, live in shadow, no more..." Email = "firstname.lastname@example.org" GithubID = "Your Github ID" TwitterID = "Your Twitter ID" FacebookID = "Your Facebook ID" LinkedInID = "Your LinkedIn ID" GoogleplusID = "Your Googleplus ID"
If you use
config.yaml, plz reformat them to yaml.
Enable Disqus to your post
- Add your Disqus Shortname to the site config file;
- You can enable Disqus per-post, by adding
comments: true(YAML) or
comments = true(TOML) in the front matter of your post. To disable it, you can either change the value to
falseor just not include
commentsvariable and its value at all.
Enable TOC to your post
If you need show table of contents per-post, adding
toc: true (YAML) or
toc = true (TOML) in the front matter of your post.
Please notice that TOC will be hidden when browser width is less than 920px.
Enable Formspree to your page
If you need a form which allows guests to contact you by email, Formspree maybe a good choice.
Firstly, make sure you have already set a Email in the config.toml. And then add
formspree: true (YAML) or
formspree = true (TOML) in the front matter of your page.
Build your site
theme = "vec" to your
# Build hugo # Run a server hugo server
hugo -t vec hugo server -t vec
Open sourced under MIT license.