FM
для Меня adoc нравится тем, что он более богат на разметку
Size: a a a
2021 August 31
NV
Примеры тащи )
A
нет, не секрет, в основном, нам нужны были две фичи:
- мультирепозитории
- многоуровневая навигация
желательно из коробаса, также более дружелюбный к техписам интерфейс
ещё момент - в будущем понадобится локализация, но не полностью, а частичная, что в сфинксе сделать невозможно
выбирали между хьюго, гэтсби, анторой и ещё что-то было, выбрали антору в итоге
- мультирепозитории
- многоуровневая навигация
желательно из коробаса, также более дружелюбный к техписам интерфейс
ещё момент - в будущем понадобится локализация, но не полностью, а частичная, что в сфинксе сделать невозможно
выбирали между хьюго, гэтсби, анторой и ещё что-то было, выбрали антору в итоге
NV
Частичная это как? Просто часть страниц с переводом и другая часть без него, или что-то иное?
A
в сфинксе это всё тоже можно реализовать, но сложнее
и как там мультирепы делать - я не знаю и не нагуглила особо
и как там мультирепы делать - я не знаю и не нагуглила особо
A
да, англ версия более полная
A
в анторе все сорсы подключаются в одном ямле, а в сфинксе надо пилить сборку под каждую репу
NV
Доки Тарантула собираются сейчас из семи репозиториев, часть исходников генерится из кода. Полёт нормальный :)
FM
rst не православный) и не красивый.
ET
На самом деле сравнение rst и adoc более чем интересно, ибо и то, и другое - сделано для интенсивного использования семантики, но разными людьми и в разных тимах. Первый - в рамках Питона. Второй - для текстовой замены xml-based DocBook.
A
не спорю 😅
но дизайн на сфинксе из коробаса устаревший, плюс если не отследишь локализацию, будет местами торчать нативный язык
но дизайн на сфинксе из коробаса устаревший, плюс если не отследишь локализацию, будет местами торчать нативный язык
NV
Там два варианта: можно каждую репу отдельно, можно просто собрать из одной директории, в которой субмодулями собраны разные репозитории
D
rST к XML ближе некуда
ET
adoc к XML куда ближе, ибо это полный эквивалент DocBook в разрезе семантического словаря.
NV
О да, дизайн дефолтной темы совсем простой. Тема pandas вот хорошая.
NV
Субьективщина )
A
тоже вариант, но нас вот ещё простота в деплое интересовала для не разработчиков
NV
А на локализацию можно (и нужно) тесты сделать.
NV
А что там с деплоем, расскажи?
Вроде же там и там статический сайт.
Вроде же там и там статический сайт.
ET
Но с другой стороны, для linux kernel выбрали именно rst, хотя у них многие ридми были в DocBook.