ソースコードの例を含むドキュメントをいくつか作成する必要があります。いくつかの例はIDEから作成され、他の例は適切に作成されます。私の例は主にJavaにあります。
LaTeXに慣れている人として、Wordでこれを行うのは非常に苦痛です。ただし、これにはWordが必要です。私が見た唯一のオプションは次のとおりです。
これを行うためのより良い(そして理想的にはポータブルな)方法はありますか?少なくとも、LaTeX環境に似た逐語的なスタイルがありますか? RTFとしてコピーアンドペーストできるきれいなプリンターが少なくともありますか?
数十億ドルを費やした後でも、このようなものについての適切なガイドをスクリーンショットで表示することはできません。
とにかく、構文の色付けにNotepad ++を使用し、キャプションを付けることができるTextBoxを使用したWord 2010のクイックガイドを次に示します。
Wordドキュメントでstyleを定義し、それをソースコードに使用する必要があります。通常、「コード」と呼ばれるスタイルがあります。これは、小さなポイントサイズの固定幅フォント、固定サイズのタブ、単一行の間隔、段落の前後の間隔がないなどです。このスタイルを一度定義して再利用するだけです。ソースコードを貼り付けて、「コード」スタイルを適用します。
一部のエディター(MacのXcodeなど)では、アプリケーション間でコピー/貼り付けするときにクリップボードにRTFだけでなくテキストも追加することに注意してください。WordはRTFを認識し、書式設定、構文の色付けを保持しますなど.
Xcodeのソースコード:
Wordにコピーして貼り付けます。
(注:Wordの "コード"スタイルでスペルチェックを無効にすることをお勧めします。)
私は最近この投稿に出会い、いくつかの有用なヒントを見つけました。しかし、私は自分のニーズに合ったまったく異なるアプローチを使用することになりました。私はこのアプローチを選んだ理由とそのアプローチの理由を共有しています。投稿は私が思っていたよりも長いですが、スクリーンショットは常に役立つと思います。うまくいけば、答えは誰かに役立つでしょう。
私の要件は次のとおりです。
私のアプローチは次のとおりです。
上記の要件2、3、4を達成するには、Microsoft Wordの表を使用してコードスニペットを挿入します。手順は次のとおりです。
要件5を達成するには、次の手順に従います。
フィードバックや改善がある場合、またはアプローチに問題がある場合は提供してください。
IDEに依存します。たとえば、Visual Studioと Eclipse の両方を使用すると、RTFとしてコピーしてWordに貼り付け、すべての書式設定を維持できます。
Notepad ++ には、RTPにコピーできる「NppExport」(プリインストール済み)というプラグインがありますが、Notepad ++の構文の強調表示についてはあまり気にしません(ただし、間違いなく合格です)。前述のIDEは少数の言語(他のプラグインなし)に制限されていますが、何十もの言語をサポートしています。
これはこの答えに関連しています: https://stackoverflow.com/a/2653406/931265 オブジェクトを作成することで、すべての問題が解決しました。
挿入>オブジェクト> Opendocument Text
これにより、ドキュメントウィンドウが開き、テキストが貼り付けられ、必要に応じて書式が設定され、閉じられます。
結果は図です。オブジェクトを右クリックし、「キャプションを追加」を選択します。
相互参照を作成し、図表を作成できるようになりました。
Macでは、vimを使用したこのソリューションは素晴らしいと思います。
私はあなたのすべての方法を試しましたが、私にはうまくいきませんでした。実際、MS Word Tablesを使用して簡単な方法を作成しました。
長所:
短所:誰かが私のトリックを改善できるかもしれませんが、コードの色付けは維持されません。
手順:
3x3テーブルを挿入します。私の場合は、テーブルの合計幅を常にフリーページの幅と等しくします(テーブルスタイルをテストするには、3行最小)。
目に見えない境界線を使用( "境界線なし"オプション)、「グリッド線の表示」オプションを有効にしますこの側面が必要です。 これらの行はテーブルのグリッドを見るためのものであり、印刷されないことに注意してください。
セルの間隔と列の幅を調整して、好みのアスペクトを取得します。 (微調整のために「Table Properties」を取得する必要があります)。
「段落スタイル」を「Code」という名前で作成しますあなたのコードスニペットのために(check https://stackoverflow.com/a/25092977/8533804アイデアを得るために、従う必要はありませんそれのすべて)
「Paragraph Style」という名前の別の「Code_numberline」を作成します。以前に作成されたスタイルに基づきます。
新しく作成した「Code_numberline」に、好みの番号付けスタイルを追加します(これにより、行番号付けが自動化されます)。
そのテーブルスタイルを保存してお楽しみください!
Ms.WordでプラグインSyntax Highlightを使用できます https://store.office.com/syntax-highlighter-WA104315019.aspx? assetid = WA104315019 。私はそのステップに従い、それは仕事です
Wordでは、「Paste Keep Source Formatting」を使用して、色を使用してコードとコメントを区別するコードを貼り付けることができます。ただし、貼り付けたコードを使用して新しいスタイルを作成すると、Wordは自動的に色分けされたテキストを削除し、黒(または自動既定色)に変更します。スタイルの適用はドキュメント形式の要件への準拠を保証する最良の方法であるため、Wordはソフトウェアプログラムのドキュメント化にはあまり役立ちません。残念ながら、Open Officeの方が優れていることは思い出せません。最善の回避策は、デフォルトのシンプルなテキストボックスを使用することです。
これにはOpen Xml Sdkを使用できます。 htmlに色と書式が設定されたコードがある場合。 Altchunksを使用して、Word文書に追加できます。この投稿を参照してください OpenXML(* .docx)ドキュメントにHTML文字列を追加 これが役に立てば幸いです!
まだコードスニペットを追加する簡単な方法を探している場合。
[挿入]> [オブジェクト]> [ドキュメントを開く]> [コードを貼り付ける]> [保存して閉じる]に簡単に移動できます。
これをマクロに入れて、簡単なアクセスバーに追加することもできます。
ノート: