hugo.toml

#
# Global general configuration
#

# Public root of this website. Can be overwritten by hugo --baseURL
baseURL = 'https://docs.plusserver.com/'

# Timout for executing a template to render a page. Default is 30s but within the build pipeline in Hugo actions this does not suffice.
timeout = "120s"

# Generate a robots.txt in the root directory
enableRobotsTXT = true

# Include information from Git to be used when generating this site. Needed for .Lastmod, Commit Hash etc.
enableGitInfo = true

# Language settings
contentDir = "content/en"
languageCode = 'en-GB'
defaultContentLanguage = "en"
defaultContentLanguageInSubdir = true
# Useful when translating.
enableMissingTranslationPlaceholders = true

# Highlighting config
pygmentsCodeFences = true
pygmentsUseClasses = false
# Use the new Chroma Go highlighter in Hugo.
pygmentsUseClassic = false
#pygmentsOptions = "linenos=table"
# See https://help.farbox.com/pygments.html
pygmentsStyle = "tango"



#
# Language configuration
#

[languages]

# English language
[languages.en]
title = "plusserver Documentation"
languageName = "🇬🇧 EN"
languageCode = 'en-GB'
weight = 1
[languages.en.params]
description = "The technical documentation for all plusserver products"
time_format_default = "02.01.2006"
time_format_blog = "02.01.2006"
privacy_policy = "https://www.plusserver.com/en/privacy-policy"

# German language
[languages.de]
title = "plusserver Dokumentation"
languageName = "🇩🇪 DE"
languageCode = 'de-DE'
contentDir = "content/de"
[languages.de.params]
description = "Die technische Dokumentation zu allen plusserver-Produkten"
time_format_default = "02.01.2006"
time_format_blog = "02.01.2006"
privacy_policy = "https://www.plusserver.com/datenschutzerklaerung/"



#
# Markdown rendering settings
#

[markup]
[markup.goldmark]
[markup.goldmark.renderer]
# Allow HTML embedded in markdown (not recommended)
unsafe = true

[markup.highlight]
# Select Code highlighting style. See https://xyproto.github.io/splash/docs/all.html for a list of all available styles
style = "github"
# Uncomment if you want your chosen highlight style used for code blocks without a specified language
guessSyntax = "true"

# Everything below this are Site Params
# Comment out if you don't want the "print entire section" link enabled.
[outputs]
section = ["HTML", "RSS"]
#section = ["HTML", "print", "RSS"]



#
# Image processing configuration.
#

[imaging]
resampleFilter = "CatmullRom" # https://gohugo.io/content-management/image-processing/#resampling-filter
quality = 75
anchor = "smart"

[imaging.exif]
disableDate = false
disableLatLong = true
excludeFields = ''
includeFields = ''



# Privacy settings for embedded templates. Will probably not affect docsy templates.
# https://gohugo.io/about/hugo-and-gdpr/
[privacy]
  [privacy.disqus]
    disable = true
  [privacy.googleAnalytics]
    disable = true
  [privacy.instagram]
    disable = true
  [privacy.twitter]
    disable = true
  [privacy.vimeo]
    disable = true
  [privacy.youtube]
    disable = true



#
# Configure site parameters
#

[params]

# Copyright holder
copyright = "plusserver gmbh"

# GitHub Settings

# Repository configuration (URLs for in-page links to opening issues and suggesting changes)
github_repo = "https://github.com/plusserver/docs"
# An optional link to a related project repo. For example, the sibling repository where your product code lives.
#github_project_repo = "https://github.com/pluscloudopen/docs"

# Specify a value here if your content directory is not in your repo's root directory
# github_subdir = ""

# Uncomment this if your GitHub repo does not have "main" as the default branch,
# or specify a new value if you want to reference another branch in your GitHub links
github_branch = "main"

# Search Settings: Enable Lunr.js offline search
offlineSearch = true

# Enable syntax highlighting and copy buttons on code blocks with Prism
prism_syntax_highlighting = true

# User interface configuration
[params.ui]
# Set to true to disable breadcrumb navigation.
breadcrumb_disable = false
taxonomy_breadcrumb_disable = true
# Set to false to disable the About link in the site footer
footer_about_enable = false
# Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top navbar
navbar_logo = true
# Set to true if you don't want the top navbar to be translucent when over a `block/cover`, like on the homepage.
navbar_translucent_over_cover_disable = false
# Enable to show the side bar menu in its compact state.
sidebar_menu_compact = true
sidebar_menu_foldable = false
# Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled)
sidebar_search_disable = false
ul_show = 2

# Adds a reading time to the top of each doc.
# If you want this feature, but occasionally need to remove the Reading time from a single page,
# add "hide_readingtime: true" to the page's front matter
[params.ui.readingtime]
enable = true



[params.links]

# German links showing up on the left side of the footer
[[languages.en.params.links.user]]
name = "plusserver"
url = "https://www.plusserver.com/en/"
icon = "fa-solid fa-house"
desc = "plusserver homepage"
[[languages.en.params.links.user]]
name = "GitHub"
url = "https://github.com/plusserver"
icon = "fab fa-github"
desc = "Development takes place here!"

# German links showing up on the right side of the footer
[[languages.en.params.links.developer]]
name = "Kontakt"
url = "https://www.plusserver.com/en/support/"
icon = "fa-solid fa-phone"
desc = "plusserver gmbh Kontakt"
[[languages.en.params.links.developer]]
name = "Impressum"
url = "https://www.plusserver.com/impressum/"
icon = "fa-solid fa-gavel"
desc = "plusserver gmbh Impressum"

# English links showing up on the left side of the footer
[[languages.de.params.links.user]]
name = "plusserver"
url = "https://www.plusserver.com/"
icon = "fa-solid fa-house"
desc = "plusserver homepage"
[[languages.de.params.links.user]]
name = "GitHub"
url = "https://github.com/plusserver"
icon = "fab fa-github"
desc = "Development takes place here!"

# English links showing up on the right side of the footer
[[languages.de.params.links.developer]]
name = "Contact"
url = "https://www.plusserver.com/de/support/"
icon = "fa-solid fa-phone"
desc = "plusserver gmbh Contact"
[[languages.de.params.links.developer]]
name = "Imprint"
url = "https://www.plusserver.com/impressum/"
icon = "fa-solid fa-gavel"
desc = "plusserver gmbh Legal notice"



#
# hugo module configuration
#

theme = ["github.com/google/docsy", "github.com/google/docsy/dependencies"]

[module]
proxy = "direct"
# uncomment line below for temporary local development of module
# replacements = "github.com/google/docsy -> ../../docsy"
[module.hugoVersion]
extended = true
min = "0.110.0"
[[module.imports]]
path = "github.com/google/docsy"
disable = false
[[module.imports]]
path = "github.com/google/docsy/dependencies"
disable = false