Антора это как пирина для аскидока, а хуго будет как на кариматик прилечь

Ну ок, а на hugo как поднять классный сайт для документации? Причём с учетом версий продукта

о, это прямо очень в тему, как раз такую задачу пытаюсь решить, спасибо

Но советую читнуть базовые доки сначала, а не бежать делать, у них есть клёвый репозиторий-пример, как только уловишь всю концепцию хуги - всё поймешь че куда класть и как конфигурить

Как такое сделать в докси?

глючный этот hugo:
1. постоянно, при правках, надо удалять public
2. импортирование новых shortcodes еще та задача
3. многие js-файлы написаны без соблюдения стандартов разметки

да, в процессе изучения основ сейчас нахожусь

ЛОЛ

1. не нужно, нужно ребилдить командой hugo

2. положить файлы в папку

3. вообще срать, код трогать не надо там

ну и начнём с того, что Hugo — это один бинарник на go без зависимостей, какие ты там темы лепишь уже не пробелмы хуги

Ты даже не уловил концепцию базовую, а уже что-то пытаешься сказать что глючное

1. Сами разработчики говорят обратно - удалять паблик перед ребилдом
2. положить файлы в папку нельзя - если тебе понравились шорткаты на евенты из другой темы, которых нету в твоем теме, ты потраехаешься, чтобы их импортировать
3. код в js трогать надо ,ибо там много из того, чего надо править. Но править то, что написано в 1 строку ...

Итог. Если тебе нужен базовый функционал, когда создал простенькое - хуго крут ,а вот дальше начинается геморой.

Я поднял за вечер сайт и смигрировал весь кастомерский конфлюенс за двое, пусть и потных, суток, попутно разобравшись со структурой и не удаляя никакие папки, не ворочал шорткоды, пушо стандарных хватает, js код трогать не надо, т.к все темплейтные тексты которые нужно менять, лежат в отдельных конфигах.

Класть в соседние папочки версии и в хэдере вместо языков тулить версии

Это первая костыльная мысль что пришла, но в теории проблем не должно быть

я поднял сайт за вечер на теме techdoc, потом мне понадобились шорткады из темы book, а потом в раскрывающихся списках я захотел заменить знаки + и - на треугольники.
И вот тут я прифигел, от того, что творится в кишках hugo