web-dev-qa-db-ja.com

プログラミングワークショップのプレゼンテーションでコードを管理するための良い方法

私は現在プログラミングワークショップを作成しています（実際にはそれはあまりにも多くのものですが、それほど重要ではありません）。

私は主に2種類のリソースを持っています：

  • スライド（html/revile.js）
  • サンプルプロジェクト（Java）

サンプルプロジェクトからの多くの場所では、プレゼンテーションに表示されます。

それを達成するための良い方法は何ですか？

私の要求事項

  • プレゼンテーションで使用されるコードスニペット、および表示される場所を指定する簡単な方法

  • コードの変更は自動的にプレゼンテーションに反映されます（ビルドツールを実行している、手動で切断して貼り付けてください）。

  • リンクが壊れたり、プレゼンテーションで使用されないスニペットを存在したりマーキングしたりするコードスニペットを埋め込もうとするように、警告を作成する必要があります。

  • コードとプレゼンテーション間のリンクを持つためのボーナスポイント

javahtmlpresentationsembedding
2
Jens Schauder

Asciidoctor http://asciidoctor.org/ あなたの要件のほとんどを解決するかもしれません：

  • pLAIN ASCII）を使用してコンテンツを書く
  • 実際のソースコードファイルからコードスニペットを含める
  • 壊れたリンクは出力を作成するときに警告を作成します
  • revect.jsとdeck.jsでプレゼンテーションを作成しました

あなたは https://github.com/asciidoctor/Scridoctor-gradle-examples を見つけるでしょう== grayleでASCIIDOCTORを使用する方法（しかし、他のビルド・ツールも同様に機能します）。

ここでサンプル出力を参照 とdeck.jsとdelect.jsでレンダリングされたプレゼンテーションを見つけることができます（サブチャプター3.4と9.4が「出力」というラベルの付いたもの）。

別のインスピレーションの源は、Dan Allanのデッキのセットになるかもしれません https://github.com/mojavelinux/decks

また、コードからプレゼンテーションへのリンクを求めました。最高のAsciidoctorはあなたにafaikを提供することができますが、コードの中のコードスニペットをマークするために使用したタグが（// tag::XXX[]）もプレゼンテーションのソースに存在する（include::Class.Java[tags=XXX]）

3
ahus1