Когда я это сделал, я широко использовал стили. Это очень помогает.
Что я делаю, так это создаю стиль абзаца (возможно, называемый "Code Example
" или что-то в этом роде), в котором используется моноширинный шрифт, тщательно выбранные вкладки, очень светло-серый фон, тонкая черная рамка сверху и снизу (это помогает видимость много) и с выключенной орфографией. Я также удостоверяюсь, что межстрочный и меж параграфский интервал установлены правильно. Затем я создаю дополнительные стили символов сверху (например, "Comment
", "String
", "Keyword
", "Function Name Decl
", "Variable Name Decl
"), которые я накладываю сверху; те устанавливают цвет и является ли текст полужирным / курсивом. Тогда довольно просто пройти и пометить вставленный пример как код, чтобы он выглядел действительно хорошо, и это хорошо работает для коротких фрагментов. Длинные куски кода, вероятно, обычно не должны быть в чем-то, что собирается на мертвом дереве. : -)
Преимущество такого способа состоит в том, что его легко адаптировать к любому коду, который вы делаете; вам не нужно полагаться на какую-то IDE, чтобы понять, что происходит для вас. (Основная проблема? Печатные страницы, как правило, не такие широкие, как окна редактора, поэтому обертывание будет отстой ...)