Веб-версияОткрыть в Telegram
FFoliant

Foliant

@foliantdocs · группа · Технологии · в индексе с 2026-07-04
177участников
3 830сообщений в индексе
  1. Ю
    Не указал, через прямой вызов pandoc работает. backend_config: pandoc: params: pdf_engine: xelatex template: custom.latex vars: mainfont: "Liberation Serif" Таким образом тоже игнорирует шаблон
    1. C
      Я запутался, давайте ещё раз. Если делаете сборку в Докере, то шаблон не применяется. Если делаете без Докера, применяется. Это верно?
      1. Ю
        Шаблон применяется, если вызывать чистый pandoc. Если указывать шаблон в foliant.yml и собирать внутри контейнера в CI/CD, то шаблон не применяется, но сборка проходит успешно и без ошибок.
        1. C
          Первое предположение, что custom.latex не попадает в контейнер, надо смотреть на Dockerfile. Второе — то, что вы предположили, что не установлены нужные пакеты для Пандока. В логах совсем ничего нет?
          1. Ю
            Логи совсем пустые. Попробовал явное копирование файла шаблона через COPY ..., результат такой же. Буду пробовать устанавливать используемые в custom.latex пакеты в контейнер явно.
            1. C
              Да, остаётся только это. Странно, что боги пустые... Может, Пандок свои доги тоже куда-то пишет сам?
              1. Ю
                Похоже, проблемы была в том, что в custom.latex использовались конкретные шрифты, которых не было в docker-контейнере. После копирования шрифтов в контейнер шаблон стал применяться. Вероятно, в pandoc была проверка, что, если невозможно применить кастомный шаблон, то использовать шаблон по умолчанию.
        2. D
          Все правильно. В докер не подгружается свой шаблон и применяется дефолтный. Его надо при сборке доложить в папку, указанную в foliant.yml Для этого в Dockerfile после "FROM ...." пропишите такую строку: COPY mytemplate.tex /foliant_stuff/pandoc_templates/tex_templates/mytemplate.tex Пути только проверьте
Вся ветка · 8 ответов →
Ю
Возможно, что в контейнере не хватает пакетов, указанных в custom.latex
Ю
Какая лучшая практика для сборки "мега"-портала (foliant make site) для следующего случая: 1) есть несколько репозиториев со своей документацией. Структура каждого репозитория в общем случае различна; 2) в каждом репозитории есть свой foliant-<name>.yml, в котором указано, какие .md-файлы участвуют в сборке для сайта; 3) требуется запускать одну gitlab job, которая будет смотреть в конкретные репозитории в конкретные ветки, брать каждый раз уникальный foliant-<name>.yml и объединять всё в общий портал MkDocs. Для каждого репозитория в отдельности корректный сайт собирается.
Ю
Если правильно понял описание, то foliantcontrib.multiproject в текущем виде не подходит Limitations: - ❌ directory names of subprojects of the same level should be unique; - ✅ source directories of the multiproject and of all the subprojects should have the same names; - ✅ also they should be located inside the “root” directories of corresponding projects; - ❌ config files of the multiproject and of all the subprojects should have the same names; - ❔ subprojects from remote Git repositories do not need to be newly cloned before each build, but local subprojects are copied into cache before each build; - ✅ it’s undesirable if the path of the “root” directory of the top-level project contains .multiprojectcache directory as its some part.
  1. C
    Я честно не всё понимаю, что написано в доках к multiproject. Но в целом выглядит так, что это ваша самая надёжная ставка, надо идти этим путём. Этот препроцессор создан именно для вашей ситуации: много проектов объединить в один. Я бы посоветовал посмотреть в сторону унификации всех репозиториев. Это должно сильно упростить поддержку и сборку, а сделать это надо только один раз.
  2. C
    В общем, я бы на вашем месте начал экспериментировать с этим препроцессором.
Вся ветка · 2 ответа →
C
Ссылка
нажмите — покажем
Кажется, пора делать новый бекед Zensical, так как автор MkDocs сменил пол и поехал кукухой, и проект катится в бездну: https://fpgmaas.com/blog/collapse-of-mkdocs/ P. S. Эх, помню его на конфе Write the Docs то ли в Праге, то ли в Будапеште. Тогда он был ещё Томом, а MkDocs был свежей новой темой :-)
  1. L
    Фотография
    нажмите — покажем
    О, пропустил вспышку В итоге решили делать? Сегодня утро началось не с кофе
    1. C
      Я не мейнтейню сейчас Фолиант, так что я только вбросил инфу. А что случилось? Уже что-то перестало работать?
      1. L
        Пока нет Просо Material любезно предупреждает об опасности) (ненавязчиво через полный анализ предлагая переезжать на Zensical ;) ) Ну и в коментах к будущему 2.0 мкдокса весело)
Вся ветка · 4 ответа →
V
У нас недавно ломался slate из-за того, что его автор ушел с гитхаба кромко хлопнув дверью в знак протеста против сотрудничества микрософта с трамповским ICE
  1. C
    Вот казалось бы, если не нравится что-то — просто оставь как есть и не трогай, кто-нибудь подхватит. Нет, надо обязательно «в знак протеста» всё сломать всем.
Вся ветка · 2 ответа →
О
Всем привет! Подскажите, кто-нибудь работает с Jinja2 для версионирования документации?

Открытая публичная лента из поискового индекса ChatCrawler — «Google по публичному Telegram»; обновляется по мере обхода площадки. Время — UTC.

Только публичный контент, официальный API Telegram. О проекте · Вопросы · Чего мы не делаем · Убрать страницу из выдачи · Каталог · Поиск · Как мы считаем