Apa cara terbaik untuk memasukkan contoh kode sumber ke dalam dokumen Microsoft Word?


131

Saya harus menulis beberapa dokumen yang akan menyertakan contoh kode sumber. Beberapa contoh akan ditulis dari IDE, dan yang lainnya akan ditulis di tempat. Contoh saya terutama di Jawa.

Sebagai seseorang yang terbiasa dengan LaTeX, melakukan ini di Word sangat menyakitkan. Namun, saya terikat pada Word untuk ini. Satu-satunya opsi yang saya lihat adalah:

  1. Tulis atau salin ke dalam dokumen, kemudian gunakan font tipe tetap, susun pemformatan, dan harap Word tidak menuliskan huruf besar untuk Anda. Tak perlu dikatakan, ini seperti omong kosong.
  2. Salin dan tempel tangkapan layar kode sumber dari IDE. Setidaknya saya menyimpan warna. Namun, jika saya mengubah ukuran font saya, saya kacau. Saya juga mengacaukan batas halaman. Dan akui saja, Word tidak hebat mengelola banyak gambar pada dokumen.
  3. Tulis HTML (bukan opsi di sini)

Apakah ada cara yang lebih baik (dan idealnya portabel) untuk melakukan ini? Apakah setidaknya ada semacam gaya verbatim yang mirip dengan lingkungan LaTeX? Apakah setidaknya ada beberapa printer cantik yang bisa saya salin dan tempel sebagai RTF?


Russel: Tidak yakin saya mengerti.
Uri

2
Saya pikir ini mungkin lebih tepat untuk pengguna super. Hanya karena hal yang Anda masukkan ke dalam dokumen adalah kode tidak menjadikan ini pertanyaan pemrograman.
danben

2
@danben: Saya kira. Saya baru saja membayangkan bahwa contoh kode dalam dokumen kata adalah sesuatu yang sebagian besar programmer lakukan dalam pekerjaan mereka sehari-hari.
Uri

1
Apakah Anda terikat dengan Word-the-program atau Word-the-file-format?
Ken

Jawaban:


186

Saya benar-benar benci dan benci bekerja secara gratis untuk Microsoft, mengingat bagaimana setelah semua miliaran dolar yang mereka MASIH tidak memiliki panduan yang tepat tentang hal-hal seperti ini dengan tangkapan layar di situs web sialan mereka.

Bagaimanapun, berikut ini adalah panduan cepat di Word 2010, menggunakan Notepad ++ untuk pewarnaan sintaks, dan TextBox yang dapat diberi caption:

  1. Pilih Sisipkan / Kotak Teks / Kotak Teks Sederhana
    Kata
  2. Kotak teks standar dimasukkan
    02 kata
  3. Beralih ke NPP, pilih bahasa untuk pewarnaan sintaksis kode Anda, pergi ke Plugins / NPPExport / Copy RTF ke clipboard
    03npp
  4. Beralih kembali ke kata, dan rekatkan ke kotak teks - mungkin terlalu kecil ...
    Kata kata
  5. ... jadi Anda mungkin harus mengubah ukurannya
    Kata
  6. Setelah memilih kotak teks, klik kanan padanya, lalu pilih Sisipkan Keterangan ...
    06 kata
  7. Di menu Keterangan, jika Anda belum memilikinya, klik Label Baru, dan atur label baru menjadi "Kode", klik OK ...
    Kata
  8. ... lalu dalam dialog Caption, alihkan label ke Code, dan tekan OK
    Kata
  9. Terakhir, ketik teks Anda di kotak teks yang baru dibuat
    Kata

Ketika Anda melewati keterangan referensi, ia menyisipkan seluruh kode itu sendiri untuk bagaimana menyelesaikan masalah ini?
MonsterMMORPG

1
Di Word 2013 teksnya adalah kode tempelkan sebagai teks biasa, tidak ada cara untuk mempertahankan format Notepad ++
Jose Nobile

2
@JoseNobile Anda perlu menggunakan plugin NppExport di Notepad ++
NeilenMarais

1
Ini juga berfungsi dengan Android Studio, Visual Studio dan Eclipse.
Teocci

Saya awalnya menggunakan teknik yang sama tetapi sejak itu berubah menjadi menggunakan tabel 1x1 karena saya menemukan bahwa kotak teks adalah rasa sakit untuk posisi. Saya mencoba "atas dan bawah" sehingga teksnya hanya sebelum dan sesudah, dan Word akan secara ajaib menggerakkan kotak ke atas atau ke bawah, kadang-kadang judulnya tidak akan terlihat, ah, sungguh menyebalkan. Mulai menggunakan tabel hari ini berdasarkan SO QA lain, sejauh ini berfungsi dengan baik. Saya membuat label caption tipe baru "Listing".
Oliver

26

Saya baru-baru ini menemukan posting ini dan menemukan beberapa petunjuk yang bermanfaat. Namun, saya akhirnya menggunakan pendekatan yang sama sekali berbeda yang sesuai dengan kebutuhan saya. Saya berbagi pendekatan dan alasan mengapa saya memilih pendekatan ini. Posting ini lebih panjang daripada yang saya inginkan, tetapi saya percaya tangkapan layar selalu membantu. Semoga jawabannya bermanfaat bagi seseorang.

Persyaratan saya adalah sebagai berikut:

  1. Tambahkan potongan kode ke dokumen kata, dengan penyorotan sintaks untuk visibilitas yang lebih mudah dan diferensiasi kode dan teks lainnya.
  2. Cuplikan kode harus segaris dengan teks lainnya.
  3. Cuplikan kode harus melintasi halaman dengan lancar tanpa usaha ekstra.
  4. Cuplikan kode harus memiliki batas yang bagus.
  5. Cuplikan kode harus menonaktifkan pemeriksaan ejaan.

Pendekatan saya adalah sebagaimana tercantum di bawah ini:

  1. Gunakan alat eksternal untuk mencapai persyaratan penyorotan sintaks 1 di atas. Orang dapat menggunakan notepad plus plus seperti yang dijelaskan di atas. Namun, saya menggunakan alat yang ada di sini - http://www.planetb.ca/syntax-highlight-word . Ini memberi saya opsi untuk menggunakan nomor baris, serta penyorotan sintaksis yang sangat bagus (Silakan gunakan Google Chrome untuk langkah ini, karena penyorotan sintaks tidak disalin ketika menggunakan Mozilla Firefox, seperti juga ditunjukkan oleh beberapa komentar pengguna). Langkah-langkah untuk mencapai penyorotan sintaksis tercantum di bawah ini:
  2. Untuk mencapai persyaratan 2, 3 dan 4 di atas, gunakan tabel dalam Microsoft word, untuk memasukkan potongan kode. Langkah-langkahnya tercantum di bawah ini:

    • Sisipkan tabel dengan satu kolom.
    • Rekatkan teks yang disalin dari langkah 1. di kolom tabel. Saya telah menyimpan nomor baris untuk menunjukkan seberapa baik ini bekerja dengan kata Microsoft.
    • Terapkan perbatasan, sesuka Anda. Saya telah menggunakan ukuran 1pt. Cuplikan kata Microsoft yang dihasilkan akan muncul seperti yang ditunjukkan pada tangkapan layar di bawah ini. Perhatikan seberapa baik itu pecah di halaman - TIDAK diperlukan upaya tambahan untuk mengelola ini, yang akan Anda hadapi jika memasukkan objek "OpenDocument Text" atau jika menggunakan "Simple TextBox". Cuplikan kode yang disorot sintaks yang disisipkan di Microsoft Word Table
  3. Untuk mencapai persyaratan 5, ikuti langkah-langkah di bawah ini:

    • Pilih seluruh tabel atau teks.
    • Buka tab Tinjau. Di bawah Bahasa, pilih "Bahasa Pemeriksaan". Munculan baru akan disajikan.
    • Pilih "Jangan periksa ejaan atau tata bahasa". Kemudian, klik OK. Nonaktifkan periksa ejaan
    • Teks yang dihasilkan telah spell-check dinonaktifkan. Hasil akhir ditunjukkan pada gambar di bawah dan memenuhi semua persyaratan. Hasil Akhir - memenuhi semua 5 persyaratan.

Harap berikan jika Anda memiliki umpan balik atau perbaikan atau mengalami masalah dengan pendekatan tersebut.


2
Terima kasih! Tampak hebat ... Saya harus menggunakan Google Chrome karena Mozilla Firefox tidak menyalin penyorotan sintaksis.
loveMeansNothing

Saya pikir ini adalah solusi terbaik. Satu tip lagi: jika Anda tidak ingin periksa ejaan tetapi Anda tidak menulis dalam bahasa Inggris, masukkan kode sebagai objek Teks Dokumen Buka. Pergi ke INSERT - OBJECT - dan pilih OpenDocument Text. Masukkan kode ke dalam dokumen yang dibuka dan kemudian simpan dan tutup. Kode ditampilkan seperti di atas tetapi ejaannya diabaikan sepenuhnya. Satu-satunya kelemahan adalah bahwa nomor tersebut tidak berfungsi dengan benar, jika Anda ingin memasukkannya ke dalam keterangan untuk daftar. Havent memeriksa itu.
user3629892

@ user3629892 Saya pikir dengan Open Document Anda tidak dapat membungkus halaman berbeda dengan baik.
maracuja-jus

Apakah ada kemungkinan untuk mendapatkan perbatasan yang indah itu juga untuk nomor baris sambil menyalin kata.
Paramesh Korrakuti

1
@ Capt.Krusty - Di poin 1, poin 1 dan 5, saya telah menyebutkan untuk menggunakan Chrome. Tapi, saya akan melanjutkan dan menambahkan "Google Chrome" seperti yang Anda dan loveMeansNothing menyarankan.
abhishek

23

Anda perlu mendefinisikan gaya dalam dokumen Word Anda dan menggunakannya untuk kode sumber. Saya biasanya memiliki gaya yang disebut "Kode" yang memiliki font monospace dalam ukuran titik kecil, tab ukuran tetap, spasi baris tunggal, tidak ada spasi sebelum / sesudah paragraf, dll. Anda hanya perlu mendefinisikan gaya ini sekali dan kemudian menggunakannya kembali. Anda menempel di kode sumber Anda dan menerapkan gaya "Kode" untuk itu.

Perhatikan bahwa beberapa editor (mis. Xcode pada Mac) menambahkan RTF serta teks ke clipboard saat menyalin / menempel di antara aplikasi - Word mengenali RTF dan membantu mempertahankan pemformatan, pewarnaan sintaksis, dll.

Kode sumber dalam Xcode:

masukkan deskripsi gambar di sini

Disalin dan ditempel ke Word:

masukkan deskripsi gambar di sini

(Catatan: ide yang baik untuk menonaktifkan pemeriksaan ejaan pada gaya "Kode" di Word.)


Namun ini tidak secara otomatis menambah gaya ke kata kunci, angka, string dll.
Bart

@Bart: secara umum, tidak, tetapi bagi mereka yang menggunakan Xcode (untuk Mac OS X, iOS, dll pengembangan) clipboard berisi RTF dengan semua pewarnaan sintaks dll, dan Word menerima ini. Mungkin saja ada editor lain yang juga memiliki fitur bermanfaat ini, tetapi saya tidak menyadarinya.
Paul R

RTF berfungsi, ya, saya pernah menggunakan ini di masa lalu juga menggunakan Notepad ++ to Word. Namun, akan sangat baik jika ada cara untuk menambahkan gaya kode nyata , yaitu yang melakukan penyorotan sintaksis secara otomatis. Sayang sekali tidak ada yang seperti itu ada. Memang, ada beberapa add-on yang dapat Anda instal yang dapat menyorot berdasarkan permintaan, tetapi saya belum menemukan yang dapat dengan mudah mengubah gaya semua blok kode Anda dengan gaya yang berbeda jika Anda mau.
Bart

Saya tidak berpikir ini mendukung teks bukan?
Oliver

@ Skollii: Saya pikir teks hanya bisa diterapkan ke "objek" di Word. Saya kira Anda bisa meletakkan kode dalam tabel 1x1, yang kemudian akan menjadikannya objek?
Paul R

11

Itu jenis tergantung pada IDE. Visual Studio dan Eclipse , misalnya, akan memungkinkan Anda untuk menyalin sebagai RTF dan menempel ke Word, menjaga semua pemformatan Anda.

Notepad ++ memiliki sebuah plugin yang disebut "NppExport" (sudah diinstal sebelumnya) yang memungkinkan Anda untuk menyalin ke RTF, meskipun saya tidak terlalu peduli dengan penyorotan sintaksis Notepad ++ (itu pasti akan lumayan sih). Apa yang dilakukannya adalah mendukung lusinan bahasa, sedangkan IDE yang disebutkan terbatas pada masing-masing (tanpa plug-in lainnya).


1
Saya beruntung dengan VS dan Eclipse dalam melakukan hal ini - menggunakan editor IDE untuk melakukan pewarnaan sintaks (dan semua format yang saya suka), kemudian memotong dan menempel langsung ke kata. Saya biasanya menindaklanjutinya dengan mengatur font melintasi potongan ke font lebar tetap (tidak selalu menemukan bagi saya)
heckj

3

Ini terkait dengan jawaban ini: https://stackoverflow.com/a/2653406/931265 Membuat objek menyelesaikan semua masalah saya.

Sisipkan> Objek> Teks Dokumen

Ini akan membuka jendela dokumen, rekatkan teks Anda, format sesuai keinginan Anda, dan tutup.

Hasilnya adalah angka. Klik kanan objek, dan pilih 'tambahkan keterangan'.

Anda sekarang dapat membuat referensi silang, membuat tabel angka.


Ketika Anda melewati keterangan referensi, ia memasukkan seluruh kode juga bagaimana menyelesaikan masalah ini?
MonsterMMORPG





1

Jika Anda masih mencari cara sederhana untuk menambahkan potongan kode.

Anda dapat dengan mudah pergi ke [Sisipkan]> [Objek]> [Teks Dokumen]> tempel kode Anda> Simpan dan Tutup.

Anda juga bisa memasukkan ini ke makro dan menambahkannya ke bilah akses mudah Anda.

catatan:

  • Ini hanya akan memakan waktu hingga satu halaman kode.
  • Kode Anda tidak akan dikoreksi secara otomatis .
  • Anda hanya dapat berinteraksi dengannya dengan mengklik dua kali .

1

Di Word, dimungkinkan untuk menempelkan kode yang menggunakan warna untuk membedakan komentar dari kode menggunakan "Tempel Memformat Sumber." Namun, jika Anda menggunakan kode yang disisipkan untuk membuat gaya baru, Word secara otomatis menghapus teks kode warna dan mengubahnya menjadi hitam (atau apa pun warna default otomatisnya). Karena menerapkan gaya adalah cara terbaik untuk memastikan kepatuhan dengan persyaratan format dokumen, Word tidak terlalu berguna untuk mendokumentasikan program perangkat lunak. Sayangnya, saya tidak ingat Open Office menjadi lebih baik. Solusi terbaik adalah menggunakan kotak teks sederhana default.


1

Saya telah mencoba semua metode Anda, tetapi mereka tidak berhasil untuk saya, bahkan saya telah membuat metode yang lebih mudah digunakan Tabel MS Word .

Pro:

  1. Lebih indah
  2. Lebih mudah dikelola & lebih konsisten
  3. Tidak terlalu rentan terhadap masalah
  4. Tidak perlu untuk plugin eksternal atau MS Word micro coding.
  5. Lebih mudah ditangani oleh pengguna sederhana ( seperti saya ).

Cons: Tidak akan mempertahankan pewarnaan kode meskipun seseorang dapat meningkatkan trik saya.

Langkah:

  1. Masukkan tabel 3x3, dalam kasus saya, saya selalu membuat lebar total tabel sama dengan lebar halaman gratis ( minimum 3 baris untuk menguji gaya tabel ).

  2. Gunakan batas yang tidak terlihat ( opsi " Tanpa Batas " ), dan aktifkan opsi " Lihat Garis Petak ". harus memiliki aspek ini. Pastikan bahwa garis-garis itu bagi Anda untuk melihat kisi-kisi tabel, dan tidak akan dicetak.

masukkan deskripsi gambar di sini

  1. Buat penyesuaian jarak sel dan kolom untuk mendapatkan aspek yang Anda suka. ( Anda harus masuk ke " Tabel Properties " untuk fine tuning ). masukkan deskripsi gambar di sini

  2. Buat " Gaya Paragraf " dengan nama " Kode " hanya untuk cuplikan kode Anda ( periksa https://stackoverflow.com/a/25092977/8533804 untuk mendapatkan ide, Anda tidak harus mengikuti semua itu)

  3. Buat " Gaya Paragraf " lain dengan nama " Code_numberline " yang akan didasarkan pada gaya yang dibuat sebelumnya. masukkan deskripsi gambar di sini

  4. Dalam " Code_numberline " yang baru dibuat, tambahkan gaya penomoran yang Anda suka (ini akan mengotomatiskan penomoran baris). masukkan deskripsi gambar di sini

  5. Terapkan " Code_numberline " ke kolom pertama, dan " Code " ke kolom 3. masukkan deskripsi gambar di sini

  6. Tambahkan isian di kolom tengah. masukkan deskripsi gambar di sini

  7. Simpan gaya meja itu dan nikmatilah!


Hebat sampai, Anda mengatakan Simpan gaya tabel itu .
Martin of Hessle

@ MartinofHessle, baik untuk dokumen yang diperluas di mana Anda akan mengisinya dengan potongan kode di banyak tempat, pilihan untuk menyimpan gaya tabel ini adalah penghemat waktu, selain itu memungkinkan Anda untuk mengubah gaya tabel sepanjang kerumitan dokumen bebas, seperti dalam kasus saya di mana saya memiliki gaya untuk IDE dan IDLE ... di sisi lain, jika Anda hanya menggunakan satu tabel, maka Anda dapat menghilangkan langkah terakhir
Nader Belal

Saya setuju dengan alasannya. Itu adalah cara mengatakannya secara normal. Jangan membuatnya tetap ada yang akan menjadi tambahan yang berguna. Saya menemukan jawabannya tetapi tidak jelas.
Martin dari Hessle

@ MartinofHessle maafkan saya, tapi saya tidak mengerti pernyataan terakhir Anda. Bisakah Anda mengulanginya lagi dengan istilah yang lebih sederhana?
Nader Belal

1
Maaf kesalahan ketik, seharusnya cara menyimpannya ke normal.dot .
Martin dari Hessle

1

Gunakan ini - http://hilite.me/

hilite.me mengubah cuplikan kode Anda ke dalam format HTML yang tercetak cantik, mudah disematkan ke dalam posting blog, email, dan situs web.

Caranya: Cukup salin kode sumber ke panel kiri, pilih bahasa dan skema warna, dan klik "Sorot!". HTML dari panel kanan sekarang dapat ditempelkan ke blog atau email Anda, tidak diperlukan file CSS atau Javascript eksternal.

Untuk dokumen Microsoft Word: Salin konten dari bagian Pratinjau dan tempel ke dokumen Microsoft Word Anda.

3 bagian: Kode Sumber, HTML dan Pratinjau


0

Ada cara mudah jika Anda ingin pemformatan kode sederhana.

  1. Buka kata> Sisipkan tab> klik "Dapatkan Add-in"
  2. cari "Pencampur konten" 3. klik "Tambah"

Kemudian content mixer add akan terbuka secara otomatis dan Anda dapat menyalin paste kode Anda di sana dan klik "Sisipkan" untuk memasukkannya ke dalam kata doc.


0

Jawaban ini terlihat usang dan cukup membosankan dibandingkan dengan solusi tambahan web; yang tersedia untuk produk sejak Office 2013.

Saya menggunakan Easy Code Formatter , yang memungkinkan Anda untuk mengodifikasi teks di tempat. Ini juga memberi Anda opsi penomoran baris, penyorotan, gaya yang berbeda, dan gaya tersebut bersumber terbuka di sini: https://github.com/armhil/easy-code-formatter-styles sehingga Anda dapat memperpanjang penataan sendiri. Untuk menginstal - membuka Microsoft Word, buka Sisipkan Tab / klik "Dapatkan Add-in" dan cari "Easy Code Formatter"

masukkan deskripsi gambar di sini masukkan deskripsi gambar di sini masukkan deskripsi gambar di sini

Dengan menggunakan situs kami, Anda mengakui telah membaca dan memahami Kebijakan Cookie dan Kebijakan Privasi kami.
Licensed under cc by-sa 3.0 with attribution required.