Предложение - использовать HTML якоря для ссылок #1

Activity

1. codedokode commented on May 17, 2018

   

   codedokode

   on May 17, 2018

   Owner

   More actions

   По якорям - за, при редизайне постараюсь добавить (редизайн, как всегда идет очень не спеша, у меня уже где-то полгода есть адаптивная верстка, которая пока не натянута на учебник).

   Насчет статических генераторов - я бы хотел, но там проблемы с расширением синтаксиса. Мне ведь кроме стандартных абзацев и заголовков нужны доволнительные элементы: предисловия, примечания в сайдбаре, примеры кода, примеры вывода кода, блоки задач. Соответственно, синтаксис должен быть расширяемым. Для картинок иногда нужен флаг, есть у нее рамка или нет.

   HTML/XML расширяется просто и естественно: либо пишем эти блоки с помощью дивов с кастомными классами, либо делаем кастомные теги (это у меня пока не реализовано) + препроцессор для них:

   <code-eval language="php" mode="wide"><!CDATA[
      echo 2 + 2;
   ]]></code-eval>
   
   <problem id="dice-game" name="Задача про кубики">
   <desc>Робот и человек играют в кубики...</desc>
   <require>В коде должны использоваться переменные <var>$human1</var> и <var>$human2</var>...</require>
   ...

   Эти описания задач потом можно парсить для использования в роботе-проверяльщике.

   Как расширять markdown? Там конечно есть возможность писать произвольный HTML, но внутри него нельзя использовать сам markdown. Для кастомных элементов там нет никаких стандартов.

   Я еще смотрел RestructuredText, который используется в мануалах, но там не очень приятный синтаксис, мне не понравился.

   Может, какой-нибудь викитекст использовать?

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