Jaki jest najlepszy sposób wstawiania przykładów kodu źródłowego do dokumentu Microsoft Word?

Muszę napisać kilka dokumentów, które będą zawierać przykłady kodu źródłowego. Niektóre przykłady zostaną napisane w środowisku IDE, a inne na miejscu. Moje przykłady są głównie w Javie.

Dla kogoś, kto jest przyzwyczajony do LaTeX-a, robienie tego w programie Word jest niezwykle bolesne. Jednak jestem zobowiązany do Worda. Jedyne opcje, które widziałem, to:

1. Napisz lub skopiuj do dokumentu, a następnie użyj czcionki o stałym kroju, zaaranżuj formatowanie i miej nadzieję, że Word nie pisał dla Ciebie wielkich liter. Nie trzeba dodawać, że to wygląda na bzdury.
2. Skopiuj i wklej zrzuty ekranu kodu źródłowego z IDE. Przynajmniej zachowuję kolory. Jeśli jednak zmienię rozmiar czcionki, mam przerąbane. Przekraczam też granice stron. I przyznajmy, program Word nie radzi sobie świetnie z zarządzaniem wieloma obrazami w dokumencie.
3. Napisz HTML (nie jest to opcja tutaj)

Czy jest jakiś lepszy (i najlepiej przenośny) sposób na zrobienie tego? Czy jest przynajmniej jakiś styl dosłowny podobny do środowiska LaTeX? Czy jest przynajmniej jakaś ładna drukarka, którą mógłbym skopiować i wkleić w formacie RTF?

Absolutnie nienawidzę i gardzę pracą za darmo dla Microsoftu, biorąc pod uwagę to, że po tych wszystkich miliardach dolarów, NADAL nie mają odpowiednich przewodników o takich rzeczach ze zrzutami ekranu na ich cholernej stronie internetowej.

W każdym razie, oto krótki przewodnik po programie Word 2010, używający Notepad ++ do kolorowania składni i TextBox, który można podpisać:

1. Wybierz Wstaw / Pole tekstowe / Proste pole tekstowe
   
2. Wstawione zostanie domyślne pole tekstowe
   
3. Przełącz na NPP, wybierz język do kolorowania składni kodu, przejdź do Wtyczki / NPP Eksportuj / Kopiuj RTF do schowka
   
4. Wróć do słowa i wklej w polu tekstowym - może być za małe ...
   
5. ... więc być może będziesz musiał zmienić jego rozmiar
   
6. Po zaznaczeniu pola tekstowego kliknij je prawym przyciskiem myszy, a następnie wybierz opcję Wstaw podpis ...
   
7. W menu Podpis, jeśli jeszcze go nie masz, kliknij Nowa etykieta i ustaw nową etykietę na „Kod”, kliknij OK ...
   
8. ... następnie w oknie dialogowym podpisu zmień etykietę na Kod i naciśnij OK
   
9. Na koniec wpisz swój podpis w nowo utworzonym polu podpisu
   

Niedawno natknąłem się na ten post i znalazłem kilka przydatnych wskazówek. Jednak ostatecznie zastosowałem zupełnie inne podejście, które odpowiadało moim potrzebom. Podzielam podejście i moje uzasadnienie, dlaczego wybrałem to podejście. Post jest dłuższy, niż bym chciał, ale uważam, że zrzuty ekranu są zawsze pomocne. Miejmy nadzieję, że odpowiedź komuś się przyda.

Moje wymagania były następujące:

1. Dodaj fragmenty kodu do dokumentu tekstowego, z podświetlaniem składni dla łatwiejszej widoczności i różnicowania kodu i innego tekstu.
2. Fragment kodu powinien być osadzony w innym tekście.
3. Fragment kodu powinien bezproblemowo dzielić się na stronach bez dodatkowego wysiłku.
4. Fragment kodu powinien mieć ładną ramkę.
5. Fragment kodu powinien mieć wyłączone sprawdzanie pisowni.

Moje podejście jest wymienione poniżej:

1. Użyj narzędzia zewnętrznego, aby osiągnąć wymaganie 1 dotyczące podświetlania składni powyżej. Można by użyć notatnika plus plus, jak opisano powyżej. Korzystam jednak z narzędzia obecnego tutaj - http://www.planetb.ca/syntax-highlight-word . Daje mi to możliwość użycia numeru linii, a także bardzo fajnego podświetlania składni (w tym kroku używaj Google Chrome, ponieważ podświetlenie składni nie jest kopiowane podczas korzystania z Mozilla Firefox, na co również wskazuje kilka komentarzy użytkowników). Kroki prowadzące do podświetlenia składni są wymienione poniżej:
   • Otwórz powyższą witrynę w chrome i skopiuj fragment kodu w obszarze tekstowym. Aby to zademonstrować, będę używał przykładowego XML-a (przykład XML stąd - http://www.service-architecture.com/articles/object-oriented-databases/xml_file_for_complex_data.html ).
   • Wybierz język z menu rozwijanego.
   • Kliknij przycisk „Pokaż wyróżnione”. Otworzy się nowa karta z wyróżnionym składniowo fragmentem kodu, w tym przypadku wybranym przez nas przykładem XML. Zobacz na przykład obrazek poniżej.
   • Aby wyłączyć numery wierszy, sprawdź stronę w chrome. Następnie w sekcji style usuń zaznaczenie właściwości „margin” w „.dp-highlighter ol”, jak pokazano na poniższej ilustracji. Jeśli chcesz zachować numery linii, przejdź do następnego kroku.
   • Wybierz kod z podświetleniem składni i kliknij kopiuj. Teraz twój kod jest gotowy do wklejenia do Microsoft Word. Dzięki temu blogowi za udostępnienie tych informacji - http://idratherbewriting.com/2013/04/04/adding-syntax-highlighting-to-code-examples-online-and-in-microsoft-word/ .

2. Aby spełnić wymagania 2, 3 i 4 powyżej, użyj tabeli w programie Microsoft Word, aby wstawić fragment kodu. Kroki są wymienione poniżej:

   • Wstaw tabelę z jedną kolumną.
   • Wklej skopiowany tekst z kroku 1. do kolumny tabeli. Zachowałem numery wierszy, aby pokazać, jak dobrze to działa z Microsoft Word.
   • Zastosuj obramowanie, jak chcesz. Użyłem rozmiaru 1pt. Wynikowy fragment słowa Microsoft pojawi się, jak pokazano na zrzucie ekranu poniżej. Zwróć uwagę, jak ładnie łamie się na całej stronie - nie wymaga dodatkowego wysiłku, aby temu zaradzić, z którym możesz się zmierzyć, wstawiając obiekt „OpenDocument Text” lub używając „Simple TextBox”.

3. Aby spełnić wymaganie 5, wykonaj poniższe czynności:

   • Zaznacz całą tabelę lub tekst.
   • Przejdź do zakładki Recenzja. W sekcji Język wybierz „Sprawdzanie języka”. Zostanie wyświetlone nowe wyskakujące okienko.
   • Wybierz „Nie sprawdzaj pisowni ani gramatyki”. Następnie kliknij OK.
   • W wynikowym tekście sprawdzanie pisowni jest wyłączone. Ostateczny wynik jest pokazany na poniższym obrazku i spełnia wszystkie wymagania.

Podaj, jeśli masz jakieś uwagi lub ulepszenia lub napotkasz jakiekolwiek problemy z podejściem.

Musisz zdefiniować styl w dokumencie programu Word i użyć go w kodzie źródłowym. Zwykle mam styl o nazwie „Kod”, który ma czcionkę o stałej szerokości w małym rozmiarze w punktach, tabulatory o stałym rozmiarze, pojedyncze odstępy między wierszami, brak odstępów między akapitami przed / po itd. Wystarczy tylko raz zdefiniować ten styl i użyć go ponownie. Wklejasz kod źródłowy i stosujesz do niego styl „Kod”.

Zwróć uwagę, że niektóre edytory (np. Xcode na komputerach Mac) dodają RTF, a także tekst do schowka podczas kopiowania / wklejania między aplikacjami - Word rozpoznaje format RTF i pomaga zachować formatowanie, kolorowanie składni itp.

Kod źródłowy w Xcode:

Skopiowano i wklejono do programu Word:

(Uwaga: dobrze jest wyłączyć sprawdzanie pisowni w stylu „Kod” w programie Word).

To trochę zależy od IDE. Na przykład zarówno program Visual Studio, jak i Eclipse umożliwiają kopiowanie w formacie RTF i wklejanie do programu Word, zachowując całe formatowanie.

Notepad ++ ma wtyczkę o nazwie „NppExport” (jest fabrycznie zainstalowana), która umożliwia kopiowanie do formatu RTF, chociaż nie obchodzi mnie zbytnio podświetlanie składni Notepad ++ (chociaż byłoby to z pewnością zadowalające). Obsługuje dziesiątki języków, podczas gdy wspomniane środowiska IDE są ograniczone do kilku (bez innych wtyczek).

Jest to związane z tą odpowiedzią: https://stackoverflow.com/a/2653406/931265 Utworzenie obiektu rozwiązało wszystkie moje problemy.

Wstaw> Obiekt> Tekst dokumentu otwartego

Spowoduje to otwarcie okna dokumentu, wklejenie tekstu, sformatowanie go w dowolny sposób i zamknięcie.

Rezultatem jest liczba. Kliknij obiekt prawym przyciskiem myszy i wybierz opcję „dodaj podpis”.

Możesz teraz tworzyć odsyłacze, tworzyć tabele rysunków.

Na komputerze Mac to rozwiązanie z vimem jest wspaniałe:

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

Użyj tego - http://hilite.me/

hilite.me konwertuje fragmenty kodu do ładnie wydrukowanego formatu HTML, który można łatwo osadzić w postach na blogach, wiadomościach e-mail i witrynach internetowych.

Jak: Po prostu skopiuj kod źródłowy do lewego okienka, wybierz język i schemat kolorów, a następnie kliknij „Podświetl!”. Kod HTML z prawego panelu można teraz wkleić do swojego bloga lub wiadomości e-mail, nie są wymagane żadne zewnętrzne pliki CSS ani JavaScript.

W przypadku dokumentu Microsoft Word: Skopiuj zawartość z sekcji Podgląd i wklej do dokumentu Microsoft Word.

3 sekcje: Kod źródłowy, HTML i Podgląd

Możesz do tego użyć Open Xml Sdk. Jeśli masz kod w html z kolorem i formatowaniem. Możesz użyć altchunks, aby dodać go do dokumentów Word. Odnieś się do tego posta Dodaj ciąg HTML do dokumentu OpenXML (* .docx) Mam nadzieję, że to pomoże!

To właśnie zrobiłem.

Wyniki końcowe:

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

Możesz użyć funkcji Podświetlanie składni wtyczki w Ms.Word https://store.office.com/syntax-highlighter-WA104315019.aspx?assetid=WA104315019 . podążam za tym krokiem i to działa

Jeśli nadal szukasz prostego sposobu na dodanie fragmentów kodu.

możesz łatwo przejść do [Wstaw]> [Obiekt]> [Tekst otwartego dokumentu]> wklej swój kod> Zapisz i zamknij.

Możesz również umieścić to w makrze i dodać do paska łatwego dostępu.

uwagi:

• To zajmie tylko jeden stronę kodu.
• Twój kod nie zostanie automatycznie poprawiony .
• Możesz wejść w interakcję z nim tylko poprzez dwukrotne kliknięcie .

W programie Word można wkleić kod, który używa koloru, aby odróżnić komentarze od kodu za pomocą opcji „Wklej, zachowaj formatowanie źródłowe”. Jeśli jednak użyjesz wklejonego kodu do utworzenia nowego stylu, program Word automatycznie usunie zakodowany kolorem tekst i zmieni go na czarny (lub inny domyślny kolor). Ponieważ stosowanie stylu jest najlepszym sposobem zapewnienia zgodności z wymaganiami dotyczącymi formatu dokumentu, program Word nie jest zbyt przydatny do dokumentowania programów. Niestety, nie przypominam sobie, żeby Open Office był lepszy. Najlepszym rozwiązaniem jest użycie domyślnego prostego pola tekstowego.

Wypróbowałem wszystkie twoje metody, ale nie zadziałały dla mnie, w rzeczywistości stworzyłem łatwiejszą metodę przy użyciu tabel MS Word .

Plusy:

1. Piękniejsza
2. Łatwiejsze w zarządzaniu i bardziej spójne
3. Mają mniejszą skłonność do problemów
4. Nie ma potrzeby stosowania zewnętrznych wtyczek ani mikrododowania MS Word.
5. Łatwiejszy w obsłudze dla prostych użytkowników ( takich jak ja ).

Wady: Nie zachowa kolorowania kodu, chociaż ktoś mógłby ulepszyć moją sztuczkę.

Kroki:

1. Wstaw tabelę 3x3, w moim przypadku zawsze sprawiam, że całkowita szerokość tabeli jest równa szerokości wolnej strony ( minimum 3 wiersze do przetestowania stylu tabel ).

2. Użyj niewidocznych ramek ( opcja „ Bez granic ” ) i aktywuj opcję „ Wyświetl linie siatki ”. powinien mieć ten aspekt. Pamiętaj, że te wiersze służą do wyświetlania siatki tabeli i nie zostaną wydrukowane.

3. Dostosuj odstępy między komórkami i szerokość kolumn, aby uzyskać pożądany wygląd. ( Będziesz musiał wejść w " Właściwości tabeli " w celu dostrojenia ).

4. Utwórz „ Styl akapitu ” z nazwą „ Kod ” tylko dla fragmentów kodu ( sprawdź https://stackoverflow.com/a/25092977/8533804, aby uzyskać pomysł, nie musisz podążać za wszystkimi)

5. Utwórz inny „ Styl akapitu ” o nazwie „ Numer_kodu ”, który będzie oparty na wcześniej utworzonym stylu.

6. W nowo utworzonym „ Code_numberline ” dodaj styl numeracji, który Ci się podoba (to zautomatyzuje numerowanie linii).

7. Zastosuj „ Code_numberline ” do pierwszej kolumny i „ Code ” do trzeciej kolumny.

8. Dodaj wypełnienie w środkowej kolumnie.

9. Zapisz ten styl stołu i ciesz się!

Te odpowiedzi wyglądają na przestarzałe i dość uciążliwe w porównaniu z dodatkami internetowymi; który jest dostępny dla produktów od Office 2013.

Używam Easy Code Formatter , który pozwala zakodować tekst w miejscu. Zapewnia również opcje numerowania linii, podświetlania, różnych stylów, a style są dostępne tutaj: https://github.com/armhil/easy-code-formatter-styles, dzięki czemu możesz samodzielnie rozszerzyć stylizację. Aby zainstalować - otwórz Microsoft Word, przejdź do zakładki Wstaw / kliknij „Pobierz dodatki” i wyszukaj „Easy Code Formatter”

Jest łatwy sposób, jeśli chcesz prostego formatowania kodu.

1. Otwórz słowo> zakładka Wstaw> kliknij „Pobierz dodatki”
2. wyszukaj „Mikser treści” 3. kliknij „Dodaj”

Następnie dodawanie do miksera treści otworzy się automatycznie i możesz skopiować, wkleić tam swój kod i kliknąć „Wstaw”, aby wstawić go do Word doc.