Getting Started link

1. Installing Hugo link

https://gohugo.io/installation/ or WinGet: winget install Hugo.Hugo.Extended

2. Add the FS25 Mod Hugo Theme as a subtree in your Git root link

git subtree add --prefix docs/themes/fs25_mod_hugo_theme --squash https://gitlab.com/StrauntMaunt/fs25_mod_hugo_theme.git master

3. Copy the Example Site link

Copy-Item -Recurse "docs/themes/fs25_mod_hugo_theme/examplesite/*" "docs/"

4. Running the docs link

Set-Location "docs"
hugo server

5. Configure the basic settings in config.toml link

Update the baseurl to https://USERNAME.gitlab.io/PROJECTNAME

6. Activate Gitlab Pages link

Include the pipeline job link

Add a file .gitlab-ci.yml in the root of the project.

include: 'docs/.gitlab-ci.yml'

Push this change so a build can start.

In your Gitlab project configure Deploy/Pages. link

Disable Use unique domain. This should give you a fixed link to your website: https://USERNAME.gitlab.io/PROJECTNAME

Updating FS25 theme in existing Hugo project link

git subtree pull --prefix docs/themes/fs25_mod_hugo_theme --squash https://gitlab.com/StrauntMaunt/fs25_mod_hugo_theme.git master

Example Folder Structure link

• FS25_ModName
  • src
    • ModDesc.xml
    • …
  • docs
    • content/docs
      • page.md
    • themes/fs25_hugo_template/…
    • .gitignore
    • .gitlab-ci.yml
    • go.mod
    • hugo.toml
  • .gitlab-ci.yml