docker-compose up
Then, go to http://localhost:1313
cd exampleSite
hugo mod npm pack
npm install
hugo server --buildDrafts
Then, go to http://localhost:1313
ref: https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme
hugo mod init github.com/<your_user>/<your_project>
Add the module theme to your hugo project configuration:
module:
imports:
- path: github.com/gatling/gatling.io-doc-theme
Retrieve the node dependencies:
hugo mod clean
hugo mod get -u
hugo mod npm pack
npm install
Add babel configuration:
module.exports = {
presets: [
[
"@babel/preset-env",
{
targets: {
browsers: [
// Best practice: https://github.com/babel/babel/issues/7789
">=1%",
"not ie 11",
"not op_mini all",
],
},
},
],
"@babel/preset-typescript",
],
};
# Meta Data for SEO
title: "Gatling"
titleSeparator: "-"
description: "Documentation"
## Open Graph + Twitter Cards
images: ["gatling-logo.png"]
twitterSite: "GatlingTool"
twitterCreator: "GatlingTool"
facebookAuthor: "GatlingTool"
facebookPublisher: "GatlingTool"
ogLocale: "en_US"
## JSON-LD
schemaName: "Gatling Corp"
schemaLogo: "gatling-logo.png"
schemaTwitter: "https://twitter.com/GatlingTool"
schemaLinkedIn: "https://www.linkedin.com/company/gatling/"
schemaGitHub: https://github.com/gatling
## Sitelinks Search Box
siteLinksSearchBox: false
## Chrome Browser
themeColor: "#fff"
# Images
quality: 85
bgColor: "#fff"
lqipWidth: "20x"
# Alert
alert: false # show alert text
alertText: "" # alert text displayed before footer
# Footer
footer: "Powered by Hugo, and fork from Doks theme"
# Edit Page
editPage: true # add Github edition links (see editPage requirement)
includeCode:
default: java
labels:
java: Java
kt: Kotlin
scala: Scala
analytics:
universalTrackingId: "UA-XXXXXXXX-X"
globalTrackingId: "G-XXXXXXXXX"
tagManagerTrackingId: "GTM-XXXXXXX"
Enabling search require you to add the following content file at content/search.md
search.md
---
layout: "search"
outputs: ["json"]
noindex: true
---
Enabling edit page require a page parameters docsRepo
with values:
- url: the URL to the content folder of your documentation
- rel: prefix to truncate on the file path
Main
Allow you to specify URL you wan't to add in the top bar menu.
main:
- name: OSS
url: /oss/
weight: 1
Social
social:
- name: Twitter
pre: <i class="fab fa-twitter"></i>
url: 'https://twitter.com/GatlingTool'
weight: 1
Content files tree must match the following description for sidebar menu and pages navigation to works properly.
Every content
folder should define a node _index.md
or a section index.md
with front-matter parameters title
and description
.
structure
content
├── section-1
│ ├── _index.md
│ ├── category-1
│ │ ├── _index.md
│ │ ├── part-1
│ │ │ └── index.md
│ │ └── part-2.md
│ └── category-2
│ │ └── ...
└── section-2
└── ...
Sidebar menu and pages navigation scope the two closest parents pages.