├── .gitignore ├── content ├── about.md ├── docs │ ├── folder │ │ ├── leaf.md │ │ └── _index.md │ ├── first-page.md │ └── _index.md └── _index.md ├── .gitmodules ├── archetypes └── default.md ├── static └── images │ └── logo-k.svg ├── hugo.yaml └── .github └── workflows └── hugo.yaml /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store 2 | .hugo_build.lock 3 | public -------------------------------------------------------------------------------- /content/about.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: About 3 | type: about 4 | --- 5 | 6 | This is the about page. 7 | -------------------------------------------------------------------------------- /.gitmodules: -------------------------------------------------------------------------------- 1 | [submodule "themes/hextra"] 2 | path = themes/hextra 3 | url = https://github.com/imfing/hextra.git -------------------------------------------------------------------------------- /content/docs/folder/leaf.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Leaf Page 3 | type: docs 4 | prev: docs/folder/ 5 | --- 6 | 7 | This page is under a folder. 8 | -------------------------------------------------------------------------------- /archetypes/default.md: -------------------------------------------------------------------------------- 1 | +++ 2 | date = '{{ .Date }}' 3 | draft = true 4 | title = '{{ replace .File.ContentBaseName "-" " " | title }}' 5 | +++ 6 | -------------------------------------------------------------------------------- /content/docs/first-page.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Demo Page 3 | type: docs 4 | prev: / 5 | next: docs/folder/ 6 | --- 7 | 8 | A simple demo page. 9 | 10 | -------------------------------------------------------------------------------- /content/docs/folder/_index.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Folder 3 | type: docs 4 | prev: docs/first-page 5 | next: docs/folder/leaf 6 | sidebar: 7 | open: true 8 | --- 9 | 10 | Pages can be organized into folders. 11 | -------------------------------------------------------------------------------- /content/docs/_index.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Documentation 3 | next: first-page 4 | --- 5 | 6 | This is a demo of the theme's documentation layout. 7 | 8 | ## Hello, World! 9 | 10 | ```go {filename="main.go"} 11 | package main 12 | 13 | import "fmt" 14 | 15 | func main() { 16 | fmt.Println("Hello, World!") 17 | } 18 | ``` 19 | -------------------------------------------------------------------------------- /content/_index.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: My Site 3 | toc: false 4 | --- 5 | 6 | This is the landing page. 7 | 8 | ## Explore 9 | 10 | {{< cards >}} 11 | {{< card link="docs" title="Docs" icon="book-open" >}} 12 | {{< card link="about" title="About" icon="user" >}} 13 | {{< /cards >}} 14 | 15 | ## Documentation 16 | 17 | For more information, visit [Hextra](https://imfing.github.io/hextra). 18 | -------------------------------------------------------------------------------- /static/images/logo-k.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | logo-k 4 | 5 | 6 | 7 | 8 | 9 | 10 | -------------------------------------------------------------------------------- /hugo.yaml: -------------------------------------------------------------------------------- 1 | baseURL: https://docs.preprod.dev.infomaniak.ch/ 2 | languageCode: fr-ch 3 | title: Infomaniak documentation 4 | 5 | theme: hextra 6 | 7 | params: 8 | navbar: 9 | displayTitle: true 10 | displayLogo: true 11 | logo: 12 | path: images/logo-k.svg 13 | dark: images/logo-k.svg 14 | link: / 15 | width: 40 16 | height: 20 17 | theme: 18 | # light | dark | system 19 | default: system 20 | displayToggle: true 21 | page: 22 | width: wide 23 | footer: 24 | displayCopyright: true 25 | displayPoweredBy: true 26 | editURL: 27 | enable: true 28 | base: "https://github.com/Infomaniak/documentation/edit/main/content" 29 | 30 | markup: 31 | # allow raw html 32 | goldmark: 33 | renderer: 34 | unsafe: true 35 | 36 | # enable hextra syntax highlight 37 | highlight: 38 | noClasses: false 39 | 40 | menu: 41 | main: 42 | - name: Documentation 43 | pageRef: /docs 44 | weight: 1 45 | - name: Blog 46 | pageRef: /blog 47 | weight: 2 48 | - name: About 49 | pageRef: /about 50 | weight: 3 51 | - name: Search 52 | weight: 4 53 | params: 54 | type: search 55 | - name: GitHub 56 | weight: 5 57 | url: "https://github.com/imfing/hextra" 58 | params: 59 | icon: github 60 | - name: Twitter 61 | weight: 6 62 | url: "https://twitter.com/" 63 | params: 64 | icon: x-twitter 65 | -------------------------------------------------------------------------------- /.github/workflows/hugo.yaml: -------------------------------------------------------------------------------- 1 | # Sample workflow for building and deploying a Hugo site to GitHub Pages 2 | name: Deploy Hugo site to Pages 3 | 4 | on: 5 | # Runs on pushes targeting the default branch 6 | push: 7 | branches: ["main"] 8 | 9 | # Allows you to run this workflow manually from the Actions tab 10 | workflow_dispatch: 11 | 12 | # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages 13 | permissions: 14 | contents: read 15 | pages: write 16 | id-token: write 17 | 18 | # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued. 19 | # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete. 20 | concurrency: 21 | group: "pages" 22 | cancel-in-progress: false 23 | 24 | # Default to bash 25 | defaults: 26 | run: 27 | shell: bash 28 | 29 | jobs: 30 | # Build job 31 | build: 32 | runs-on: ubuntu-latest 33 | env: 34 | HUGO_VERSION: 0.132.2 35 | steps: 36 | - name: Checkout 37 | uses: actions/checkout@v4 38 | with: 39 | fetch-depth: 0 # fetch all history for .GitInfo and .Lastmod 40 | submodules: recursive 41 | - name: Setup Go 42 | uses: actions/setup-go@v5 43 | with: 44 | go-version: '1.22' 45 | - name: Setup Pages 46 | id: pages 47 | uses: actions/configure-pages@v4 48 | - name: Setup Hugo 49 | run: | 50 | wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \ 51 | && sudo dpkg -i ${{ runner.temp }}/hugo.deb 52 | - name: Build with Hugo 53 | env: 54 | # For maximum backward compatibility with Hugo modules 55 | HUGO_ENVIRONMENT: production 56 | HUGO_ENV: production 57 | run: | 58 | hugo \ 59 | --gc --minify \ 60 | --baseURL "${{ steps.pages.outputs.base_url }}/" 61 | - name: Upload artifact 62 | uses: actions/upload-pages-artifact@v3 63 | with: 64 | path: ./public 65 | 66 | # Deployment job 67 | deploy: 68 | environment: 69 | name: github-pages 70 | url: ${{ steps.deployment.outputs.page_url }} 71 | runs-on: ubuntu-latest 72 | needs: build 73 | steps: 74 | - name: Deploy to GitHub Pages 75 | id: deployment 76 | uses: actions/deploy-pages@v4 77 | --------------------------------------------------------------------------------