Here are some helpful tips for setting up this theme.
Most of what you’ll want to configure is demonstrated in the exampleSite config.toml
. This is Hugo’s configuration file. You can copy the config.toml
in the exampleSite/
to your site root get started.
baseURL = "https://astroysmr.github.io/homepage/" # Your domain name. Must end with "/"
theme = "introduction"
DefaultContentLanguage = "en" # Default language for multilingual sites
# disqusshortname = "" # https://gohugo.io/content-management/comments
# googleAnalytics = "" # https://gohugo.io/templates/internal/#google-analytics
publishDir = "docs"
canonifyurls = true
[params]
themeStyle = "auto" # Choose "light" or "dark" or "auto"
favicon = "/img/fav.ico" # Path to favicon file
showRSSButton = false # Show rss button in navigation
fadeIn = true # Turn on/off the fade-in effect
fadeInIndex = false # Turn on/off the fade-in effect on the index page even if fade-in was otherwise turned off
dateFormat = "Jan 2, 2006"
email = "astro.yoshimura@gmail.com" # E-mail address for contact section
#customCSS = ["custom.css"] # Include custom css files placed under assets/
# customJS = ["foo.js"] # Include custom JavaScript files placed under assets/
# plausible = true # Use Plausible analytics (requires an account at Plausible.io)
# Configure the home page
[params.home]
introHeight = "fullheight" # Input either "medium" or "large" or "fullheight"
showLatest = true # Show latest blog post summary
showAllPosts = false # Set true to list all posts on home page, or set false to link to separate blog list page
allPostsArchiveFormat = true # show all posts in an archive format
numberOfProjectsToShow = 3 # Maximum number of projects to show on home page. Unset or comment out to show all projects
localTime = true # Show your current local time in contact section
timeZone = "Japan" # Your timezone as in the TZ* column of this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
timeFormat = "en-US" # Language specific format to use
[params.projects]
useTwoColumns = false # Use a layout with two columns instead of three
# Share buttons on blog post pages
[params.share]
twitter = false
facebook = false
pinterest = false
# Social icons appear in introduction and contact section. Add as many more as you like.
# Icon pack "fab" includes social network icons, see: https://fontawesome.com/icons?d=gallery&s=brands&m=free
# Icon pack "fas" includes solid style icons, see: https://fontawesome.com/icons?d=gallery&s=solid&m=free
[[params.social]]
url = "https://github.com/astroysmr"
icon = "github" # icon name without the 'fa-'
icon_pack = "fab"
[[params.social]]
url = "https://twitter.com/astroysmr"
icon = "twitter" # icon name without the 'fa-'
icon_pack = "fab"
[[params.social]]
url = "https://www.facebook.com/yuki.yoshimura.1069/"
icon = "facebook-f" # icon name without the 'fa-'
icon_pack = "fab"
[[params.social]]
url = "astro.yoshimura@gmail.com" # For a direct email link, use "mailto:test@example.org".
icon = "paper-plane" # icon name without the 'fa-'
icon_pack = "fas"
# If you don't want to use the default menu, you can define one by yourself
# [[menu.main]]
# name = "Home"
# url = "/"
# weight = 0
# [[menu.main]]
# name = "Blog"
# url = "/blog/"
# weight = 1
# We only use tag as a taxonomies
# You can add more by yourself
[taxonomies]
tag = "tags"
series = "series"
[markup]
defaultMarkdownHandler = "goldmark"
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true
[markup.highlight]
codeFences = true
guessSyntax = false
hl_Lines = ""
lineNoStart = 1
lineNos = false
lineNumbersInTable = true
noClasses = true
# For styles, see https://xyproto.github.io/splash/docs/longer/all.html
style = "friendly"
tabWidth = 4
[languages]
[languages.en]
languageName = "English"
languageCode = "en-us"
contentDir = "content/en"
weight = 0
title = "Yuki Yoshimura's web page"
[languages.en.params]
description = "Yuki Yoshimura (吉村勇紀)'s webpage: astroysmr, ratio astronomy, astochemistry, the University of Tokyo ALMA NRO JCMT LMT" # Max 160 characters show in search results
# footerText = "" # Text to override default footer text (markdown allowed)
[languages.ja]
languageName = "日本語"
languageCode = "ja"
contentDir = "content/es"
weight = 1
title = "吉村勇紀のホームページ"
[languages.ja.params]
description = "東京大学大学院理学系研究科天文学専攻 博士課程 大学院生/日本学術振興会特別研究員DC1 吉村勇紀のホームページです。"
# footerText = ""
Introduction allows the use of Hugo’s rich built-in syntax highlighting capabilities. See Syntax Highlighting in the Hugo docs.
Below is an example configuration for Highlight. See Highlight in the Hugo docs for more.
[markup]
[markup.highlight]
codeFences = true
guessSyntax = false
hl_Lines = ""
lineNoStart = 1
lineNos = false
lineNumbersInTable = true
noClasses = true
# For styles, see https://xyproto.github.io/splash/docs/longer/all.html
style = "friendly"
tabWidth = 4
Custom shortcodes can be added to a layouts/shortcodes/
directory in your site root. Below, I use two custom shortcodes to display a data file: the current configuration file for this site! See the source for this page to understand how to use shortcodes.
To ensure Hugo renders any HTML that your shortcode or other additions like Font Awesome uses in posts, make sure these lines for the Goldmark renderer are in your config.toml
:
[markup]
defaultMarkdownHandler = "goldmark"
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true