Self Hosting Traefik Documentation locally

Traefik Traefik v2 (latest)
1

Hello,

I want to self-host Traefik Documentation, so that it is available offline.
I saw this directory on traefik repository: https://github.com/traefik/traefik/tree/master/docs

But there's no straightforward command (mkdocs serve for example),
From the GitHub Actions Workflow -> Update go-acme/lego to v4.13.3 · traefik/traefik@57780d8 · GitHub
I see very complicated workflow task:

 - name: Build documentation
        run: $HOME/bin/structor -o traefik -r traefik --dockerfile-url="https://raw.githubusercontent.com/traefik/traefik/v1.7/docs.Dockerfile" --menu.js-url="https://raw.githubusercontent.com/traefik/structor/master/traefik-menu.js.gotmpl" --rqts-url="https://raw.githubusercontent.com/traefik/structor/master/requirements-override.txt" --force-edit-url --exp-branch=master --debug
        env:
          STRUCTOR_LATEST_TAG: ${{ vars.STRUCTOR_LATEST_TAG }}

So I try the simplest way - Executing RUN command inside https://github.com/traefik/traefik/blob/master/docs/docs.Dockerfile

apk --no-cache --no-progress add py3-pip gcc musl-dev python3-dev \
  && pip3 install --user -r requirements.txt

But I get:

  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Collecting webencodings==0.5.1 (from -r requirements.txt (line 43))
  Using cached webencodings-0.5.1-py2.py3-none-any.whl (11 kB)
Collecting zipp==3.7.0 (from -r requirements.txt (line 44))
  Using cached zipp-3.7.0-py3-none-any.whl (5.3 kB)
INFO: pip is looking at multiple versions of requests to determine which version is compatible with other requirements. This could take a while.
ERROR: Cannot install -r requirements.txt (line 37) and idna==3.2 because these package versions have
conflicting dependencies.

The conflict is caused by:
    The user requested idna==3.2
    requests 2.25.1 depends on idna<3 and >=2.5

To fix this you could try to:
1. loosen the range of package versions you've specified
2. remove package versions to allow pip attempt to solve the dependency conflict

ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts

Inside alpine container, with /docs mounted

Is it even possible to build Traefik documentation?

2

Hello,

But there's no straightforward command (mkdocs serve for example),

Or

with

and

1 Like
3

This topic was automatically closed 3 days after the last reply. New replies are no longer allowed.