Как лучше всего вставить примеры исходного кода в документ Microsoft Word?

Мне нужно написать несколько документов, которые будут включать примеры исходного кода. Некоторые из примеров будут написаны из среды IDE, а другие будут написаны на месте. Мои примеры в основном написаны на Java.

Для человека, привыкшего к LaTeX, делать это в Word крайне болезненно. Однако для этого я привязан к Word. Единственные варианты, которые я видел:

1. Напишите или скопируйте в документ, затем используйте шрифт фиксированного типа, упорядочите форматирование и надейтесь, что Word не прописал вам прописные буквы. Излишне говорить, что это похоже на хрень.
2. Скопируйте и вставьте скриншоты исходного кода из IDE. По крайней мере, я сохраняю цвета. Однако, если я изменю размер шрифта, я облажался. Я также не могу понять границы страницы. И давайте признаем, Word не очень хорош для управления несколькими изображениями в документе.
3. Напишите HTML (здесь не вариант)

Есть ли лучший (и в идеале переносимый) способ сделать это? Есть ли хоть какой-то дословный стиль, похожий на среду LaTeX? Есть ли хоть какой-нибудь симпатичный принтер, который я мог бы скопировать и вставить как RTF?

Я абсолютно ненавижу и презираю бесплатную работу в Microsoft, учитывая, что после всех этих миллиардов долларов они ВСЕ ЕЩЕ не имеют надлежащих руководств по таким вещам со скриншотами на их чертовом веб-сайте.

В любом случае, вот краткое руководство в Word 2010 с использованием Notepad ++ для раскраски синтаксиса и TextBox, которое можно подписать:

1. Выберите Вставка / Текстовое поле / Простое текстовое поле.
   
2. Текстовое поле по умолчанию вставлено
   
3. Переключитесь на NPP, выберите язык для раскраски синтаксиса вашего кода, перейдите в Plugins / NPPExport / Копировать RTF в буфер обмена
   
4. Вернитесь к слову и вставьте в текстовое поле - оно может быть слишком маленьким ...
   
5. ... поэтому вам, возможно, придется изменить его размер
   
6. Выделив текстовое поле, щелкните его правой кнопкой мыши и выберите «Вставить заголовок ...».
   
7. В меню Caption, если у вас его еще нет, нажмите New Label и установите для новой метки значение «Code», нажмите OK ...
   
8. ... затем в диалоговом окне Caption переключите метку на Code и нажмите OK
   
9. Наконец, введите свою подпись во вновь созданном поле для подписи.
   

Недавно я наткнулся на этот пост и нашел несколько полезных советов. Однако в итоге я использовал совершенно другой подход, который соответствовал моим потребностям. Я разделяю подход и свои рассуждения о том, почему я выбрал этот подход. Сообщение длиннее, чем мне бы хотелось, но я считаю, что скриншоты всегда полезны. Надеюсь, ответ будет кому-то полезен.

Мои требования были следующие:

1. Добавляйте фрагменты кода в текстовый документ с подсветкой синтаксиса для упрощения видимости и различения кода и другого текста.
2. Фрагмент кода должен быть встроен в другой текст.
3. Фрагмент кода должен плавно разбиваться по страницам без каких-либо дополнительных усилий.
4. Фрагмент кода должен иметь красивую рамку.
5. Во фрагменте кода должна быть отключена проверка орфографии.

Мой подход приведен ниже:

1. Используйте внешний инструмент для выполнения требования 1 к подсветке синтаксиса выше. Можно использовать блокнот плюс плюс, как описано выше. Однако я использую присутствующий здесь инструмент - http://www.planetb.ca/syntax-highlight-word . Это дает мне возможность использовать номер строки, а также очень красивую подсветку синтаксиса (пожалуйста, используйте Google Chrome для этого шага, потому что подсветка синтаксиса не копируется при использовании Mozilla Firefox, как также указано в нескольких комментариях пользователей). Шаги по выделению синтаксиса перечислены ниже:
   • Откройте указанный выше веб-сайт в Chrome и скопируйте фрагмент кода в текстовую область. Я буду использовать образец XML, чтобы продемонстрировать это (образец XML отсюда - http://www.service-architecture.com/articles/object-oriated-databases/xml_file_for_complex_data.html ).
   • Выберите язык из раскрывающегося меню.
   • Нажмите кнопку «Показать выделенные». Откроется новая вкладка с выделенным синтаксисом фрагментом кода, в данном случае выбранным нами примером XML. См., Например, изображение ниже.
   • Чтобы отключить номера строк, просмотрите страницу в хроме. Затем в разделе стилей отмените выбор свойства «margin» в «.dp-highlighter ol», как показано на изображении ниже. Если вы хотите сохранить номера строк, перейдите к следующему шагу.
   • Выберите выделенный синтаксисом код и нажмите «Копировать». Теперь ваш код готов к вставке в Microsoft Word. Спасибо этому блогу за предоставление этой информации - http://idratherbewriting.com/2013/04/04/adding-syntax-highlighting-to-code-examples-online-and-in-microsoft-word/ .

2. Чтобы выполнить требования 2, 3 и 4 выше, используйте таблицу в Microsoft Word, чтобы вставить фрагмент кода. Шаги перечислены ниже:

   • Вставьте таблицу с одним столбцом.
   • Вставьте скопированный текст из шага 1. в столбец таблицы. Я сохранил номера строк, чтобы показать, насколько хорошо это работает с Microsoft Word.
   • Примените границу, как хотите. Я использовал размер 1pt. В результате появится фрагмент Microsoft Word, как показано на снимке экрана ниже. Обратите внимание, как красиво он разбивается по странице - НИКАКИХ дополнительных усилий не требуется, чтобы управлять этим, с чем вы столкнетесь при вставке объекта «Текст OpenDocument» или при использовании «Простого текстового поля».

3. Чтобы выполнить требование 5, выполните следующие действия:

   • Выделите всю таблицу или текст.
   • Перейдите на вкладку "Обзор". В разделе «Язык» выберите «Язык проверки». Будет представлено новое всплывающее окно.
   • Выберите «Не проверять орфографию и грамматику». Затем нажмите ОК.
   • В полученном тексте отключена проверка орфографии. Окончательный результат показан на изображении ниже и соответствует всем требованиям.

Сообщите, есть ли у вас какие-либо отзывы или улучшения, или если у вас возникли проблемы с этим подходом.

Вам нужно определить стиль в документе Word и использовать его для исходного кода. Обычно у меня есть стиль под названием «Код», в котором есть моноширинный шрифт с мелким шрифтом, табуляция фиксированного размера, одинарный межстрочный интервал, без интервала между абзацами и т. Д. Вам нужно только один раз определить этот стиль, а затем использовать его повторно. Вы вставляете исходный код и применяете к нему стиль «Код».

Обратите внимание, что некоторые редакторы (например, Xcode на Mac) добавляют RTF, а также текст в буфер обмена при копировании / вставке между приложениями - Word распознает RTF и помогает сохранить форматирование, окраску синтаксиса и т. Д.

Исходный код в Xcode:

Скопировано и вставлено в Word:

(Примечание: рекомендуется отключить проверку орфографии в стиле «Код» в Word.)

Это вроде как зависит от IDE. И Visual Studio, и Eclipse , например, позволяют копировать в формате RTF и вставлять в Word, сохраняя все ваше форматирование.

В Notepad ++ есть плагин под названием «NppExport» (поставляется предустановленным), который позволяет копировать в RTF, хотя меня не особо заботит подсветка синтаксиса Notepad ++ (хотя это определенно можно было бы пройти). Что он действительно делает, так это поддерживает десятки языков, тогда как вышеупомянутые IDE ограничены несколькими (без других плагинов).

Это связано с этим ответом: https://stackoverflow.com/a/2653406/931265 Создание объекта решило все мои проблемы.

Вставить> Объект> Текст документа

Это откроет окно документа, вставит ваш текст, отформатирует его, как вы хотите, и закроет его.

Результат - фигура. Щелкните объект правой кнопкой мыши и выберите «Добавить подпись».

Теперь вы можете делать перекрестные ссылки, составлять таблицу рисунков.

На Mac я считаю это решение с vim прекрасным:

https://github.com/zerowidth/vim-copy-as-rtf

Используйте это - http://hilite.me/

hilite.me преобразует ваши фрагменты кода в красиво напечатанный HTML-формат, легко встраиваемый в сообщения блогов, электронные письма и веб-сайты.

Как: просто скопируйте исходный код на левую панель, выберите язык и цветовую схему и нажмите «Выделить!». HTML-код из правой панели теперь можно вставить в ваш блог или электронную почту, внешние файлы CSS или Javascript не требуются.

Для документа Microsoft Word: скопируйте содержимое из раздела предварительного просмотра и вставьте в свой документ Microsoft Word.

3 раздела: исходный код, HTML и предварительный просмотр

Для этого вы можете использовать Open Xml Sdk. Если у вас есть код в html с цветом и форматированием. Вы можете использовать альтернативные блоки, чтобы добавить его в текстовые документы. Ссылка на этот пост Добавить строку HTML в документ OpenXML (* .docx) Надеюсь, это поможет!

Вот что я сделал.

Конечные результаты:

https://stackoverflow.com/a/25092977/1161594

Вы можете использовать выделение синтаксиса плагина в Ms.Word https://store.office.com/syntax-highlighter-WA104315019.aspx?assetid=WA104315019 . я следую этому шагу, и это работает

Если вы все еще ищете простой способ добавить фрагменты кода.

вы можете легко перейти к [Вставить]> [Объект]> [Текст документа]> вставить свой код> Сохранить и закрыть.

Вы также можете поместить это в макрос и добавить на панель быстрого доступа.

ноты:

• Это займет не более одной страницы кода.
• Ваш Код не будет исправлен автоматически .
• Вы можете взаимодействовать с ним, только дважды щелкнув по нему.

В Word можно вставить код, в котором используется цвет, чтобы отличать комментарии от кода, с помощью функции «Вставить исходное форматирование». Однако, если вы используете вставленный код для создания нового стиля, Word автоматически удаляет цветной текст и изменяет его на черный (или любой другой цвет, установленный автоматически по умолчанию). Поскольку применение стиля - лучший способ обеспечить соответствие требованиям формата документа, Word не очень полезен для документирования программ. К сожалению, я не помню, чтобы Open Office был лучше. Лучшее решение - использовать простое текстовое поле по умолчанию.

Я перепробовал все ваши методы, но у меня они не работали, на самом деле я создал более простой метод, используя таблицы MS Word .

Плюсы:

1. Более красивый
2. Легче в управлении и более последовательным
3. Менее склонны к проблемам
4. Нет необходимости во внешних плагинах или микрокодировании MS Word.
5. Легче справиться с простыми пользователями ( такими как я ).

Минусы: он не поддерживает раскраску кода, хотя кто-то может улучшить мой трюк.

шаги:

1. Вставьте таблицу 3x3, в моем случае я всегда делаю общую ширину таблицы равной ширине свободной страницы ( минимум 3 строки для проверки стиля таблиц ).

2. Используйте невидимые границы ( опция « Без границ » ) и активируйте опцию « Просмотр линий сетки ». он должен иметь этот аспект. Помните, что эти строки предназначены для того, чтобы вы видели сетку таблицы, и они не будут напечатаны.

3. Измените расстояние между ячейками и ширину столбцов, чтобы получить желаемый аспект. ( Вам нужно будет войти в « Свойства таблицы » для точной настройки ).

4. Создайте « Стиль абзаца » с именем « Код » только для своих фрагментов кода ( проверьте https://stackoverflow.com/a/25092977/8533804, чтобы понять идею, вам не обязательно следовать всем этим)

5. Создайте еще один « Стиль абзаца » с именем « Code_numberline », который будет основан на ранее созданном стиле.

6. Во вновь созданной « Code_numberline » добавьте стиль нумерации, который вам нравится (это автоматизирует нумерацию строк).

7. Примените « Code_numberline » к первому столбцу и « Code » к столбцу 3.

8. Добавьте заливку в средний столбец.

9. Сохраните этот стиль стола и наслаждайтесь!

Есть простой способ, если вам нужно простое форматирование кода.

1. Откройте слово> вкладка "Вставить"> нажмите "Получить надстройки".
2. ищите "Content Mixer" 3. нажмите "Добавить"

Затем добавление микшера содержимого откроется автоматически, и вы можете скопировать туда свой код и нажать «Вставить», чтобы вставить его в документ Word.

Эти ответы выглядят устаревшими и довольно утомительными по сравнению с решением веб-надстройки; который доступен для продуктов, начиная с Office 2013.

Я использую Easy Code Formatter , который позволяет кодировать текст на месте. Он также дает вам возможности нумерации строк, выделения, различных стилей и стилей с открытым исходным кодом здесь: https://github.com/armhil/easy-code-formatter-styles, чтобы вы могли расширить стиль самостоятельно. Для установки - откройте Microsoft Word, перейдите на вкладку «Вставка» / нажмите «Получить надстройки» и найдите «Easy Code Formatter».