Який найкращий спосіб вставити приклади вихідного коду в документ Microsoft Word?

Я повинен написати деякі документи, які включатимуть приклади вихідного коду. Деякі приклади будуть написані з IDE, а інші - на місці. Мої приклади передусім на Java.

Як хтось, хто звик до LaTeX, робити це в Word надзвичайно болісно. Однак я для цього зобов'язаний Word. Єдині варіанти, які я бачив:

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

Чи є якийсь кращий (і в ідеалі портативний) спосіб зробити це? Чи є хоч якийсь дослівний стиль, подібний до середовища LaTeX? Чи є хоч якийсь гарний принтер, який я можу скопіювати та вставити як RTF?

Я абсолютно ненавиджу і зневажаю, що працюю безкоштовно для Microsoft, враховуючи, що після всіх цих мільярдів доларів вони НЕ ВІДБУДУЮТЬсь, щоб не мати належних посібників щодо подібних матеріалів із скріншотами на своєму проклятому веб-сайті.

У будь-якому випадку, ось короткий посібник у Word 2010, використовуючи «Блокнот ++» для фарбування синтаксису та TextBox:

1. Виберіть Вставка / Текстове поле / Просте текстове поле
   
2. Введено текстове поле за замовчуванням
   
3. Перейдіть на NPP, виберіть мову для синтаксичного забарвлення коду, перейдіть до плагінів / NPPExport / Скопіюйте RTF у буфер обміну
   
4. Переключіться на слово і вставте в текстове поле - воно може бути занадто малим ...
   
5. ... тож вам може знадобитися змінити його розмір
   
6. Вибравши текстове поле, клацніть правою кнопкою миші на ньому, а потім виберіть Вставити підпис ...
   
7. У меню підписів, якщо у вас його ще немає, натисніть кнопку "Нова мітка" та встановіть нову мітку на "Код", натисніть кнопку ОК ...
   
8. ... потім у діалоговому вікні Caption переключіть мітку на Code і натисніть кнопку ОК
   
9. Нарешті, введіть підпис у новоствореному полі підписів
   

Нещодавно я натрапив на цей пост і знайшов корисні підказки. Однак я закінчив використовувати зовсім інший підхід, який відповідав моїм потребам. Я ділюсь підходом і моїми міркуваннями, чому я обрав саме такий підхід. Пост довший, ніж мені хотілося б, але я вважаю, що скріншоти завжди корисні. Сподіваємось, відповідь комусь буде корисна.

Мої вимоги були такими:

1. Додайте фрагменти коду до документа з текстом із виділенням синтаксису для полегшення видимості та диференціації коду та іншого тексту.
2. Фрагмент коду повинен відповідати іншому тексту.
3. Фрагмент коду повинен плавно розбиватися на сторінки без зайвих зусиль.
4. Фрагмент коду повинен мати чітку межу.
5. У фрагменті коду має бути відключена перевірка орфографії.

Мій підхід наведений нижче:

1. Використовуйте зовнішній інструмент для досягнення вимоги до виділення синтаксису 1 вище. Можна використовувати блокнот плюс плюс, як описано вище. Однак я використовую присутній тут інструмент - http://www.planetb.ca/syntax-highlight-word . Це дає мені можливість використовувати номер рядка, а також дуже приємне підсвічування синтаксису (Будь ласка, використовуйте Google Chrome для цього кроку, оскільки підсвітка синтаксису не скопіюється під час використання Mozilla Firefox, на що також вказували пару коментарів користувачів). Кроки для виділення синтаксису наведені нижче:
   • Відкрийте веб-сайт, вказаний вище, у хромі та скопіюйте фрагмент коду в текстову область. Я буду використовувати зразок XML, щоб продемонструвати це (зразок XML звідси - http://www.service-architecture.com/articles/object-oriented-databases/xml_file_for_complex_data.html ).
   • Виберіть мову зі спадного меню.
   • Натисніть кнопку "Показати виділене". Це відкриє нову вкладку із виділеним синтаксисом фрагментом коду, в цьому випадку обраний нами XML. Наприклад, дивіться зображення нижче.
   • Щоб вимкнути номери рядків, огляньте сторінку в хромі. Потім під стилями зніміть позначку властивості "margin" у ".dp-маркері ol", як показано на зображенні нижче. Якщо ви хочете зберегти номери рядків, перейдіть до наступного кроку.
   • Виберіть код, виділений синтаксисом, та натисніть копію. Тепер ваш код готовий вставити в слово Microsoft. Завдяки цьому блогу за надання такої інформації - 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.
   • Застосовуйте кордон, як вам подобається. Я використав розмір 1pt. Отриманий фрагмент слова Microsoft з’явиться, як показано на скріншоті нижче. Зверніть увагу на те, як красиво вона розбивається по всій сторінці - НЕ зайвих зусиль, необхідних для управління цим, з якими ви зіткнулися б, якщо вставити об’єкт "OpenDocument Text" або використовувати "Simple TextBox".

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

Для цього можна використовувати Open Xml Sdk. Якщо у вас є код у HTML з кольором та форматуванням. Ви можете використовувати altchunks, щоб додати їх до документів word. Перегляньте цю публікацію Додати HTML-рядок до документа OpenXML (* .docx) Сподіваюся, що це допоможе!

Це те, що я зробив.

Кінцеві результати:

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

Ви можете використовувати синтаксис Plugin Highlight у Ms.Word https://store.office.com/syntax-highlighter-WA104315019.aspx?assetid=WA104315019 . я дотримуюся цього кроку, і це працює

Якщо ви все ще шукаєте простий спосіб додати фрагменти коду.

ви можете легко перейти до [Вставити]> [Об'єкт]> [Текст документа]> вставити код> Зберегти та закрити.

Ви також можете помістити це в макрос і додати його до своєї простої панелі доступу.

примітки:

• Це займе лише одну сторінку коду.
• Ваш код не буде автоматично виправлено .
• Ви можете взаємодіяти з ним лише двічі клацнувши по ньому.

У Word можливо вставити код, який використовує колір, щоб відмежувати коментарі від коду, використовуючи "Вставити формат збереження джерела". Однак якщо ви використовуєте вставлений код для створення нового стилю, Word автоматично знімає кольоровий текст і змінює їх на чорний (або будь-який колір автоматичного за замовчуванням). Оскільки застосування стилю - найкращий спосіб забезпечити відповідність вимогам формату документа, Word не дуже корисний для документування програмних програм. На жаль, я не пам'ятаю, щоб Open Office був кращим. Найкраща робота - використовувати просте текстове поле за замовчуванням.

Я спробував всі ваші методи, але вони не спрацювали для мене, адже я створив простіший метод, використовуючи MS Word Tables .

Плюси:

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

Мінуси: забарвлення коду не підтримуватиме, хоча хтось може покращити мою хитрість.

Кроки:

1. Вставте таблицю 3х3, у моєму випадку я завжди роблю загальну ширину таблиці рівною вільній ширині сторінки ( мінімум 3 рядки для тестування стилю таблиць ).

2. Використовуйте невидимі межі ( опція " Без кордонів " ) та активуйте опцію " Переглянути сітки ". він повинен мати цей аспект. Майте на увазі, що ці рядки призначені для того, щоб побачити сітку таблиці, і не буде надруковано.

3. Внесіть налаштування між проміжками та шириною стовпців, щоб отримати потрібний вам аспект. ( Вам потрібно буде потрапити в " Властивості таблиці " для тонкої настройки ).

4. Створіть " Стиль абзацу " з назвою " Код " лише для фрагментів коду ( перевірте https://stackoverflow.com/a/25092977/8533804, щоб отримати ідею, вам не потрібно буде дотримуватися її)

5. Створіть ще один " Стиль абзацу " з назвою " Code_numberline ", який базуватиметься на попередньому створеному стилі.

6. У новостворений " Code_numberline " додайте стиль нумерації, який вам подобається (це автоматизує нумерацію рядків).

7. Застосувати " Code_numberline " до першого стовпця та " Code " до 3-го стовпця.

8. Додайте заливку в середній стовпчик.

9. Збережіть стиль таблиці та насолоджуйтесь!

Використовуйте це - http://hilite.me/

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

Як: Просто скопіюйте вихідний код на ліву панель, виберіть мову та колірну схему та натисніть «Виділити!». HTML з правої панелі тепер можна вставити у ваш блог чи електронну пошту, жодні зовнішні файли CSS або Javascript не потрібні.

Для документа Microsoft Word: Скопіюйте вміст із розділу « Попередній перегляд» та вставте у документ Microsoft Word.

3 розділи: Вихідний код, HTML та попередній перегляд

Існує простий спосіб, якщо ви хочете просте форматування коду.

1. Відкрийте слово> вкладка Вставка> натисніть "Отримати надбудови"
2. шукайте "Змішувач вмісту" 3. натисніть "Додати"

Тоді додавання змішувача вмісту відкриється автоматично, і ви можете скопіювати вставити свій код туди і натиснути «Вставити», щоб вставити його у word doc.

Ці відповіді виглядають застарілими та досить стомлюючими порівняно з веб-додатком; який доступний для продуктів з Office 2013.

Я використовую Easy Code Formatter , який дозволяє кодувати текст на місці. Тут також надаються параметри нумерації рядків, виділення, різні стилі та стилі, відкриті тут: https://github.com/armhil/easy-code-formatter-styles, щоб ви могли продовжити стилізацію самостійно. Щоб встановити - відкрийте Microsoft Word, перейдіть на вкладку Вставити / натисніть "Отримати надбудови" та знайдіть "Легкий формат коду"