Написание книги для печати и HTML, которая может включать примеры кода

Question

Я хочу написать книгу по программированию. Мне нужно ориентироваться как на печать, так и на HTML.

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

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

Каким опытом вы хотите поделиться?

Answer 1

Во-первых, не выбрасывайте LaTeX слишком быстро.Хотя это может быть немного болезненно для проверки орфографии, но все же вполне выполнимо с помощью таких инструментов, как aspell .

При этом я настоятельно рекомендую использовать emacs ' org-mode .Он предоставит вам приятный складной обзор структуры вашей книги и гораздо более читабелен в простом тексте, чем LaTeX.Кроме того, поскольку он использует подсветку синтаксиса в emacs при экспорте (в HTML, LaTeX, PDF и т. Д.), Вы сможете писать встроенный код (между тегами # + begin_src) и получать гораздо более точное представление WYSIWYGвключенные фрагменты кода.

Поскольку emacs будет работать с aspell из коробки, вы все равно сможете проверять орфографию во время работы.Кроме того, он использует LaTeX в качестве формата экспорта, что означает, что вы можете получить тот же профессиональный / технический вид, который предоставляет LaTeX.

Answer 2

Важно отметить, что, начиная с Txt2Tags , вы сможете экспортировать свои документы в LaTex . Насколько мне известно, это улица с односторонним движением, поэтому, начав с Txt2tags, вы все равно можете иметь гибкость LaTex, но, перейдя с LaTex, вы не получите преимуществ от Txt2tags.

Answer 3

Я вижу, что на домашней странице text2tag сообщается, что она отсутствует как функция ...