Hugo

[PlushBeaver]

Hugo показал себя неплохим генератором статических сайтов.

Нужно:

• Сделать тему оформления.
• Распилить репозитарий по курсам.
• Перенести/переделать материалы.
• Наладить CI.

Проблемы:

1. Pandoc. Поддержка есть, но отваливается table of contents, например, что как раз очень важно для ЛР и лекций.
   • Отказаться от Pandoc? Минус удобная работа со ссылками, минус готовность сделать из текста ЛР документ Word для пособия (будет заточено под сайт).
   • Перез запуском Hugo преобразовывать из Pandoc Markdown в простой Markdown? Минус подсветка синтаксиса (как минимум), хотя в Hugo есть своя, но тогда надо корежить материалы.
   • Перед запуском Hugo преобразовывать Pandoc Markdown сразу в HTML с шаблоном, повторяющем шаблон сайта. Есть трудности, например, "хлебные крошки", минус простота, минус live preview для материала (только для тех, кто пишет в Pandoc).

[sshaplygin]

@PlushBeaver Привет! У меня сразу возникли вопросы :)

Сделать тему оформления.

Что именно требуется сделать? И как она должна выглядеть?

Распилить репозитарий по курсам.

Сейчас есть следующие репозитарии:

1. OSSC
2. INaT
3. CS
4. IIS

Это вроде бы все курсы ИТ, у которых есть активные авторы, которые хотят их развивать. Или я что-то упустил?🤔

Перенести/переделать материалы.

Кто и что для этого нужно? Настройка Hugo и как должны выглядеть репозитарии, чтобы можно было сказать, что они уже "причесаны"?

Наладить CI.

Для этого выделена отдельная issue#1.
Что-то не хватает из того, что ты уже реализовал?

по поводу проблем. Отказ от pandoc без возможности работы с word - файлами это не очень хорошая идея.

но отваливается table of contents

А если посмотреть исходники pandoc или спросить у ребят, которые его развивают о нашей проблеме ?

[PlushBeaver]

Задачу завел себе для заметок, поэтому формулировки примерные.

Что именно требуется сделать? И как она должна выглядеть?

. Оглавление на десктопе прибито к экрану (position: fixed), а на мобильных уезжает под заголовок и не прибито. Учет мобильных --- важное дело, так как большинство открывает страницы с телефона, даже находясь в аудитории с ПК (мне не понять).

Или я что-то упустил?

Нужно будет (не сейчас) убрать этот код из основного репозитария, например.

Кто и что для этого нужно?

Цель такая, чтобы репозитарии подтягивались субмодулями и Hugo мог отрендерить это без косяков. Точно не знаю, что придется делать --- переименовать пару файлов, ссылки как-нибудь исправить. Техническое. Настройка Hugo сюда же.

Что-то не хватает из того, что ты уже реализовал?

#1 про воспроизведение CI для старого репозитария, для нового все иначе (мы обсуждали схему в переписке).

А если посмотреть исходники pandoc или спросить у ребят, которые его развивают о нашей проблеме?

UPDATE: gohugoio/hugo#5747

Неплохая мысль. Там принципиальная проблема, что когда Hugo отдает рендер стороннему приложению, он не парсит сам Markdown и не знает о структуре страницы, поэтому не генерирует ToC, которое можно было бы использовать в шаблонах. Написать для Pandoc фильтр, который писал бы содержание в отдельный файл, возможно и без переделки исходников, но надо еще править Hugo. Таким образом, можно все сделать на стороне Hugo: фильтр, вызов pandoc с фильтром, забор содержания из файла.

[sshaplygin]

@PlushBeaver Привет! Наконец-то у меня появилось свободное время.
Думаю, что с Hugo я ничем помочь не смогу. Пока ничего не могу придумать, как можно было бы мои ресурсы задействовать.
Могу предложить себя в качестве тестировщика, чтобы проверить и попробовать как все работает.
Так же могу попробовать в отдельной ветки заняться разделением общего проекта на субмодули.