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

[kubk]

Якоря позволяют создавать ссылку на определённое место страницы. http://htmlbook.ru/samhtml/yakorya

Например, страница, посвящённая ООП, очень длинная и сейчас нет возможности дать кому-то ссылку на задачу Вектор: https://phpbooktest2.ga/l1/pasta.html

Кстати, есть ли возможность переписать сайт на какой-нибудь генератор статических сайтов из Markdown? Насколько я знаю, там есть возможность использовать свой CSS.

[codedokode]

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

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

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-файлы, хотя он сейчас очень простой и примитивный и содержит лишь шаблоны шапки/подвала и несколько вспомогателбных функций.