DE
rst_epilog который?Вроде нет, увы сейчас не рядом с сорцами, не смогу глянуть, позже
Size: a a a
2019 September 03
DE
Там действительно несколько способов, но корректно заработал только один
DE
Не все можно питоном собирать))
a
В Jekyll классные инклюды, в них можно передавать данные. Типа так:
{% for record in changelog_records %}
{% include changelog content=record %}
{% endfor %}Jekyll вообще классный ;)
NV
Jekyll вообще классный ;)
Нуу, у него есть свои серьёзные ограничения. Например, он однопоточный, и когда собираешь им десятки тысяч страниц, получается долго (у нас было 20-30 минут). Инкрементальная сборка есть, но она бажная: реагирует только на изменения шаблона, но не на изменения данных. В итоге мы используем инкрементальную сборку, но на многих страницах в метаданных проставили
regenerate: trueNV
По сравнению с ним Hugo супербыстрый.
NV
Ещё Jekyll, кажется, не умеет проверять целостность ссылок, хотя бы внутренних. А на большом масштабе это очень нужно.
a
Нуу, у него есть свои серьёзные ограничения. Например, он однопоточный, и когда собираешь им десятки тысяч страниц, получается долго (у нас было 20-30 минут). Инкрементальная сборка есть, но она бажная: реагирует только на изменения шаблона, но не на изменения данных. В итоге мы используем инкрементальную сборку, но на многих страницах в метаданных проставили
regenerate: trueТут кроется суть всех инструментов - для кого-то ограничения, а кому-то они не мешают жить.
a
Ещё Jekyll, кажется, не умеет проверять целостность ссылок, хотя бы внутренних. А на большом масштабе это очень нужно.
Мы после генерации доки проверяем html-proofer'ом, как внешние, так и внутренние. Если плохо, билд валится, ошибки - в лог.
NV
Мы после генерации доки проверяем html-proofer'ом, как внешние, так и внутренние. Если плохо, билд валится, ошибки - в лог.
a
Да
NV
Ну, точнее, поставить рядом в один пайплайн сборки
ID
Привет всем. Расскажите, пожалуйста, где вы держите маппинг при синке markdown из репозиториев в конфлюенс и есть ли какие-нибудь инструменты в опенсорсе?
path/to/file/in/repo.md => confluencePageId
Как маркдаун преобразовать в confluence html формат и залить по апи я разобрался, а вот как удобнее всего хранить маппинг есть сомнения
path/to/file/in/repo.md => confluencePageId
Как маркдаун преобразовать в confluence html формат и залить по апи я разобрался, а вот как удобнее всего хранить маппинг есть сомнения
NV
Привет всем. Расскажите, пожалуйста, где вы держите маппинг при синке markdown из репозиториев в конфлюенс и есть ли какие-нибудь инструменты в опенсорсе?
path/to/file/in/repo.md => confluencePageId
Как маркдаун преобразовать в confluence html формат и залить по апи я разобрался, а вот как удобнее всего хранить маппинг есть сомнения
path/to/file/in/repo.md => confluencePageId
Как маркдаун преобразовать в confluence html формат и залить по апи я разобрался, а вот как удобнее всего хранить маппинг есть сомнения
У меня Sphinx и расширение https://sphinxcontrib-confluencebuilder.readthedocs.io/en/latest/.
Там задаётся только корневой документ и в него пушится всё дерево документов, начиная с index.
Но в Sphinx по умолчанию reStructuredText, хотя можно добавить и markdown с помощью
Там задаётся только корневой документ и в него пушится всё дерево документов, начиная с index.
Но в Sphinx по умолчанию reStructuredText, хотя можно добавить и markdown с помощью
m2rNV
Если придётся пушить несколько отдельных, не связанных иерархически, документов, тогда я буду делать под каждый свой проект (т.е. отдельный
conf.py).NV
@SuckMyNuts ты там недавно писал про MD→Confluence. Пробовал? Можешь что-нибудь ответить на вопрос выше про маппинг?
НН
@SuckMyNuts ты там недавно писал про MD→Confluence. Пробовал? Можешь что-нибудь ответить на вопрос выше про маппинг?
Там было про zendesk вроде, но не, не пробовал
NV
Там было про zendesk вроде, но не, не пробовал
это было про pandoc https://pandoc.org/releases.html
НН
это было про pandoc https://pandoc.org/releases.html
Точняк