MkDocs не работает должным образом с настраиваемым URL-путем

Сейчас использую mkdocs, version 1.0.3 from /usr/local/lib/python2.7/dist-packages/mkdocs (Python 2.7) С темой mkdocs-material-3.0.4.

Я создал статический сайт с помощью команды mkdocs build и попытался его развернуть. Все файлы сайта создаются и используют относительные пути к статическому содержимому (например, js/something.js).

Проблема в том, что мне нужно использовать его с URL-адреса https://internal.domain.com/docs/. Но я не могу найти конфигурацию для указания относительного пути для создания путей с префиксом (например, docs/js/something.js).

На стороне сервера я использую k8s + ingress с правилом перезаписи (с https://internal.domain.com/docs/ на `https: // docs_service /).

Есть предложения, как это исправить?

Вы говорите, что относительные URL-адреса работают нормально. А MkDocs использует относительные URL-адреса, потому что они работают независимо от местоположения. Поэтому я не понимаю, в чем ваша проблема? Измените свой вопрос, включив в него исходный текст Markdown, сгенерированный HTML и ожидаемый HTML.

Waylan 13.09.2018 19:30

Также почему вы используете правило перезаписи, чтобы указать на другой домен? MkDocs - это генератор статических файлов. Вам не нужно использовать прокси с одного сервера на другой. Просто скопируйте сгенерированные файлы в корень публичного сервера. Тем не менее, я надеюсь, что вы не используете включенный в комплект сервер (mkdocs serve) в производстве, поскольку для этой цели предназначен нет.

Waylan 13.09.2018 19:34

Это вообще работает? А если на https://docs_service/ зайти? Я не понимаю, что работает, а что не работает. Вы хотите использовать вход для доступа на основе пути?

Rico 13.09.2018 20:22

@Waylan, @Rico, спасибо за ответы. У меня есть статический контент, развернутый как контейнер с простым веб-сервером внутри, чтобы иметь возможность проксировать трафик на него с входа k8s. https://docs_service/ работает. Сначала проверил =) И уже исправил. Проблема была между клавиатурой и стулом =) Проблема была с косой чертой в конце. Пользователи, которые использовали URL-адрес .../docs, не могли загружать контент, поэтому я добавил принудительное перенаправление на .../docs/.

Hulii Borys 14.09.2018 16:25
Стоит ли изучать PHP в 2023-2024 годах?
Стоит ли изучать PHP в 2023-2024 годах?
Привет всем, сегодня я хочу высказать свои соображения по поводу вопроса, который я уже много раз получал в своем сообществе: "Стоит ли изучать PHP в...
Поведение ключевого слова "this" в стрелочной функции в сравнении с нормальной функцией
Поведение ключевого слова "this" в стрелочной функции в сравнении с нормальной функцией
В JavaScript одним из самых запутанных понятий является поведение ключевого слова "this" в стрелочной и обычной функциях.
Приемы CSS-макетирования - floats и Flexbox
Приемы CSS-макетирования - floats и Flexbox
Здравствуйте, друзья-студенты! Готовы совершенствовать свои навыки веб-дизайна? Сегодня в нашем путешествии мы рассмотрим приемы CSS-верстки - в...
Тестирование функциональных ngrx-эффектов в Angular 16 с помощью Jest
В системе управления состояниями ngrx, совместимой с Angular 16, появились функциональные эффекты. Это здорово и делает код определенно легче для...
Концепция локализации и ее применение в приложениях React ⚡️
Концепция локализации и ее применение в приложениях React ⚡️
Локализация - это процесс адаптации приложения к различным языкам и культурным требованиям. Это позволяет пользователям получить опыт, соответствующий...
Пользовательский скаляр GraphQL
Пользовательский скаляр GraphQL
Листовые узлы системы типов GraphQL называются скалярами. Достигнув скалярного типа, невозможно спуститься дальше по иерархии типов. Скалярный тип...
1
4
930
0

Другие вопросы по теме