Мысли по поводу формата материалов
Для начала, что хочется:
- Формат почти обязан быть текстовым
- Нужно будет собирать итоговые тексты из модулей. Логично будет это делать автоматизированно.
- Процесс, вероятно, такой: имеются исходники и набор патчиков для разных курсов (бо наивно полагать, что модуль везде подойдёт без изменений). На это натравливается make|ant|scons|whatever. На выходе тот же TeX|whatever. Все счастливы.
- Необходимо только форматирование, без вёрстки. Тем не менее, форматирования хочется много:
- Различные стили текста: основной, имя команды, копипатса консоли, исходники, куски текстовых файлов, определения, хоткеи ... (/!\ кстати, неплохо составить полный список)
- Вставка картинок (как минимум, указать, что картинка инплейс/не инплейс). Картинки с подписями и именами, по именам ссылалки
- Примечания и прочие сноски
- Список литературы --- библиография и вообще на тему
- Таблицы. Как минимум, не повредит возможность обозначения заголовков и объединения ячеек
- Ссылки. Вероятно, минимальной единицей, на которую разумно ссылаться, является модуль
- Важно подчеркнуть, что это всё очень хочется на уровне формата, то есть HTML+пачка соглашений тут подойдёт очень плохо, поскольку соглашения надо соблюдать и тратить на это усилия (и ещё больше усилий, когда они не соблюдаются)
- Очень желательно иметь парсер для моина, чтобы можно было виделть результат прямо на вики
- Очень желательно наличие конвертера в что-то, из чего можно сделать PS и HTML book (сиречь, в TeX/Docbook).
Мысли по поводу внешних материалов
- Лучше всего иметь копию на сервере (пара ссылка на файл + метаинформация имхо идеальна)
- То, что из этого берётся в текст модуля, стоит оформлять также, как и основной текст. Отсюда ещё один пункт в оформление: расстановка регионов источников. Идентификацию стоит использовать, вероятно, единую с библиографией.
Что здесь как подходит (подумать)
- HTML
- TeX
- Docbook
- Wiki